Apigee Edge のドキュメントを表示しています。
Apigee X のドキュメントをご覧ください。 info
2015 年 9 月 8 日(火)に、Apigee Edge Developer Services Portal for Private Cloud の四半期バージョンをリリースしました。
以前のプロダクト名「Apigee Edge On-premises Developer Services Portal」または「OPDK」は、「Apigee Edge Developer Services Portal for Private Cloud」になりました。
ご不明な点がございましたら、Apigee Edge サポートにお問い合わせください。
Apigee Edge のすべてのリリースノートの一覧については、Apigee リリースノートをご覧ください。
ポータルの Apigee Edge の要件
このリリースのポータルを Edge for Private Cloud のインストールに接続する場合は、すべての SmartDocs 機能がサポートされるように、バージョン 4.15.07.00 以降に接続する必要があります。詳細については、4.15.07.00 - Apigee Edge for Private Cloud リリースノートをご覧ください。
新機能
SmartDocs の一般提供
SmartDocs がベータ版から一般提供に移行します。更新情報と新機能は次のとおりです。
- Swagger 2.0 のサポート。ファイルまたは URL によるインポート、カスタム名のセキュリティ オブジェクトのサポートなど。
- SmartDocs を生成するテンプレートのビジュアル デザインが改善されました。
- Drupal の [Content] > [SmartDocs] メニューからアクセスできるデベロッパー ポータルのユーザビリティとワークフローの強化。
- これまで「カスタム トークン」認証と呼ばれていたものが「API キー」と呼ばれるようになりました。
- リビジョン レベルで定義された認証「セキュリティ」オブジェクト。
- テンプレート レベルでのクライアント認証の構成。新しいリビジョンでは、事前構成された SmartDocs クライアント認証情報がリセットされなくなりました。
機能の詳細については、こちらのブログ投稿をご覧ください。
SmartDocs のドキュメントについては、SmartDocs を使用した API のドキュメント化をご覧ください。
SmartDocs のアップグレード プロセス
ベータ版期間中に SmartDocs をすでに使用している場合は、一般提供版の新機能と機能を使用するために、デベロッパー ポータルで SmartDocs をアップグレードする必要があります。
デベロッパー ポータルで公開済みの SmartDocs ページは引き続き機能しますが、既存のページまたは新しいページに変更を加えて編集または公開する前に、更新プロセスを行う必要があります。
デベロッパー ポータル内で SmartDocs をレンダリングして公開できますが、SmartDocs は Apigee の Edge API Management Services 内にある API モデルから生成されることに注意してください。Edge で API モデルに加えた変更は、すべての Pantheon 環境で同じになります(開発者が Pantheon 環境全体に存在する場合と同様です)。
SmartDocs ベータ版から一般提供版にアップグレードするには
- Pantheon の開発環境またはテスト環境で、15.05.27 リリースを更新してテストします。
- 使用している既存の API モデルを置き換える新しいモデルを作成します。
- Swagger ドキュメントまたは WADL ドキュメントをインポートしたことがある場合は、新しいリビジョンに再度インポートします。
- SmartDocs モジュールを使用して API モデルを維持している場合は、SmartDocs JSON としてエクスポートし、ファイル添付を使用して新しいモデルにインポートします。
- モデルのリビジョンのセキュリティ プロパティを設定します。[Content] > [SmartDocs] > [model] ページで、[Security Settings] を選択します。

- [Operations] 列の [Settings] をクリックして、モデル設定ページ([Content] > [SmartDocs])で事前構成済みの認証を確認します。

- CSS アセットと JS アセットの v6 を使用するようにカスタム テンプレートを更新し、authSchemes や apiSchema などの新しいオブジェクト名を反映するように変更します。SmartDocs テンプレートの更新については、SmartDocs を使用した API のドキュメント化をご覧ください。
- モデル リビジョンを再レンダリングして公開します。
- 新しいドキュメントを検証したら、本番環境ポータルを 15.05.27 リリースに更新します。
Edge エンタープライズのお客様で、アップグレード プロセスについてご質問やご不明な点がある場合は、marsh@apigee.com と cnovak@apigee.com にメールでお問い合わせください。それ以外の場合は、Apigee コミュニティをご利用ください。
修正済みのバグ
このリリースでは以下のバグが修正されています。
| 問題 ID | 説明 |
|---|---|
| DEVSOL-487 | Monetization の日付形式を管理者が構成できるようにする Monetization の収益化設定で、ヨーロッパと米国の形式の日付形式を構成できるようになりました。 |
| DEVSOL-584 | 初回使用時にパスパラメータが記憶されない 呼び出し時にパスパラメータが常に記憶されるわけではありませんでした。 |
| DEVSOL-603 | 競合するプランのページが正しくフォーマットされていない 既存のプランと重複するプランを購入する際に表示されるページが、ユーザー向けに適切にフォーマットされるようになりました。 |
| DEVSOL-709 | SmartDocs: 空の値でリクエストを送信した後、URL テンプレート パラメータを編集できない メソッドのドキュメントでテンプレート パラメータを削除した後、SmartDocs からリクエストを送信すると、テンプレート パラメータを編集できなくなる問題を修正しました。 |
| DEVSOL-723 | SmartDocs のインポート失敗時にわかりやすいメッセージを表示 |
| DEVSOL-1013 | デベロッパー ポータル ユーザーのメールアドレスを編集可能にする プロフィール編集ページのメールアドレス フィールドが無効にならなくなり、デベロッパーはメールアドレスを変更できるようになります。 |
| DEVSOL-1244 | OPDK リリースで環境インジケーター モジュールを有効にしない |
| DEVSOL-1273 | [モジュール] リストに [DevConnect Mint] が 2 回表示される [モジュール] に [Dev Connect Mint] が 2 回表示されました。この問題は解決しました。 |
| DEVSOL-1313 | Swagger と WADL の両方で JSON/YAML ファイルまたは URL のインポートをサポート WADL ファイルを URL 経由でインポートできるようになり、Swagger ファイルをアップロードできるようになりました。 |
| DEVSOL-1339 | SmartDocs 管理メニューの場所を変更 SmartDocs がコンテンツ メニューに移動し、SmartDocs の設定が設定管理メニューに移動しました。 |
| DEVSOL-1340 | GA に移行する際にベータ版を削除 |
| DEVSOL-1390 |
PHP SDK Edge ライブラリが更新され、__toString() の呼び出しに関する問題が修正されました 致命的なエラー: /Applications/MAMP/htdocs/ordnance/docroot/profiles/apigee/libraries/mgmt-api-php-sdk/Apigee/Mint/DeveloperRatePlan.php の 221 行目で、オブジェクトでないものに対してメンバー関数 format() が呼び出されました これは、toString() メソッドを呼び出すカスタムコードを使用している収益化のお客様にのみ影響するバグです。 |
| DEVSOL-1398 | インストール時にユーザーに確認せずに SmartDocs Petstore モデルをインポート SmartDocs では、サイトのインストール時に、SmartDocs の使用例をより包括的に示すために、天気モデルではなく petstore swagger の例(http://petstore.swagger.io/v2/swagger.json)をインポートするようになりました。 |
| DEVSOL-1407 | 開発者が多いと Cron が失敗する Drupal cron を実行すると、開発者が多い場合にタイムアウトの問題が発生します。組織のユーザー数が 200 人を超える場合、バッチ処理が使用されるようになりました。 |
| DEVSOL-1410 | デベロッパー ポータルのインストール時に接続エラーが明らかにならない Edge 管理接続が機能していない場合に、インストーラにエラー メッセージを追加して、トラブルシューティングの問題を最小限に抑えました。 |
| DEVSOL-1422 | Apigee プロファイルから SMTP 構成フォームを削除 インストール プロセスで SMTP を構成するかどうかを尋ねられなくなりました。代わりに、インストール完了後に、SMTP モジュールを有効にして適切に構成するという Drupal の標準的な方法で構成できます。 |
| DEVSOL-1427 |
Devconnect デベロッパー アプリ モジュールにフックを追加して、分析データの変更を許可 # hook_devconnect_developer_apps_analytics_chart_data_alter() # hook_devconnect_developer_app_analytics_datapoints_params_alter() # hook_devconnect_developer_app_analytics_datapoints_alter() これにより、カスタム モジュールでデベロッパー アプリの分析グラフを変更できます。 |
| DEVSOL-1464 | モデルの認証設定を保存する際に致命的なエラーが発生する セキュリティ スキーマが削除されると、関連するテンプレート認証スキーマも削除する必要があるかどうかを選択するためのチェックボックスが表示されるようになりました。 |
| DEVSOL-1470 | 「APIs」メニュー リンクと対応するビューを作成 Dev Portal SmartDocs には、デフォルトで「APIs」という名前のメインメニューに SmartDocs レンダリング ドキュメントへのリンクが設定されています。このリンクは、公開されたメソッドを含むモデルにリンクされています。 |
| DEVSOL-1486 | SmartDocs 呼び出しは事前定義されたキーで認証できます 事前に指定された API キーとユーザーが指定した API キーの両方で認証を有効にします。 |
| DEVSOL-1499 | SmartDocs のパラメータの説明で HTML コードが解析されない SmartDocs のパラメータの説明で HTML コードが解析されるようになりました。 |
| DEVSOL-1507 | Add Method で API に複数のパラメータを追加できない メソッドの編集時に、SmartDocs API に複数のパラメータを追加できるようになりました。 |
| DEVSOL-1509 | SmartDocs API の「サンプル」フィールドを編集する方法が表示されない SmartDocs ページを編集する際に、「本文の MIME タイプ」、「本文のドキュメント」、「本文のサンプル」を設定できるようになりました。 |
| DEVSOL-1534 | SmartDocs の出力に Content-type が入力されない SmartDocs のメソッド ページに Content-type が入力されるようになりました。 |
| DEVSOL-1554 | 収益化での日付の比較が無効 収益化が有効になっているデベロッパー ポータルの [購入したプラン] タブで、開始日が未来のプランに対して [キャンセル] ボタンが表示されない。 |
| DEVSOL-1556 | 古いバージョンの Drupal モジュールが提供されている media_youtube モジュールと features モジュールが最新バージョンに更新されました。 |
| DEVSOL-1558 | PetStore の例で SmartDocs メソッド ページがレンダリングされない 新規インストールでは、SmartDocs PetStore メソッドの例が正しくレンダリングされるようになりました。 |
| DEVSOL-1562 | 各 SmartDocs モデルのビューを生成する 新しいモデルを作成すると、そのモデルの新しいビューがデフォルトで作成されます。 |
| DEVSOL-1565 | SmartDocs メソッドの編集で致命的なエラーが発生する SmartDocs メソッドの編集でエラーが発生することがある問題を修正しました。 |
| DEVSOL-1567 | 管理メニューの上部に [モデルを追加] が表示される 管理メニューの上部に [モデルを追加] メニュー項目が表示される問題を修正しました。 |
| DEVSOL-1576 | API ドキュメント ビューに表示名ではなくモデル名が表示される メニューの [API] をクリックしたときに表示される API ドキュメント ページに、表示名ではなくモデルの内部名が表示されていました。リリースに更新し、このビューを変更した場合は、次の手順に沿ってビューを元に戻す必要があります。# 管理者としてログインします # [Structure] > [Views] に移動します # [SmartDocs Models] の [Edit] の横にあるプルダウンをクリックして、すべてのオペレーションを表示します。# 「revert」と表示された場合は、コードが独自の変更で上書きされています。[元に戻す] をクリックすると、ビューがデフォルトの状態に戻ります。このビューに加えた変更はすべて削除されます。 |
| DEVSOL-1578 | サイトのインストールで Weather モデルと Petstore モデルの両方をレンダリング 新しいサイトに Petstore と Weather の両方の SmartDocs モデルがインポートされます。 |
| DEVSOL-1584 | プランを購入できない Apigee レスポンシブ テーマまたは Apigee レスポンシブ テーマのサブテーマを使用している場合、クラウド リリース 15.05.27.00 および 15.06.08.00 で収益化プランの購入フォームが送信されない問題を修正しました。 |
| DEVSOL-1597 | デベロッパーのタイムアウト設定を変更できない Edge 接続のタイムアウト設定が正しく適用されないバグを修正しました。 |
| DEVSOL-1620 |
Me、環境インジケーター、機能モジュールのアップグレード https://www.drupal.org/project/me https://www.drupal.org/project/environment_indicator |
| DEVSOL-1648 | reCAPTCHA の破損を防ぐため、arg_separator.output が「&」であることを確認 Google reCAPTCHA の使用が破損していたプラットフォーム関連の問題が修正されました。 |
| DEVSOL-1651 | SmartDocs モジュールが有効になっていない場合、Apigee Base テーマが失敗する apigee_base テーマは、SmartDocs モジュールが有効になっていることに依存しなくなりました。 |
| DEVSOL-1654 |
重大なセキュリティ修正を適用するために admin_views のバージョンを上げました
|