ここに表示されているのは Apigee Edge のドキュメントです。
Go to the
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 のインストールに接続する場合は、 バージョン 4.15.07.00 以降に接続して、すべての SmartDocs 機能が サポートされるようにする必要があります。詳細については、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 の dev 環境または test 環境で 15.05.27 リリースを更新してテストします。
- 新しいモデルを作成して、これまで使用していた既存の API モデルを置き換えます。
- Swagger ドキュメントまたは WADL ドキュメントをインポートしていた場合は、新しい リビジョンに再度インポートします。
- SmartDocs モジュールを使用して API モデルを維持していた場合は、 SmartDocs JSON としてエクスポートし、ファイルの添付を使用して新しいモデルにインポートします。
- モデルのリビジョンのセキュリティ プロパティを設定します。[Content >
SmartDocs > model] ページで、[Security Settings] を選択します。
- モデル設定ページ（[Content >
SmartDocs]）で、[Operations] 列の [Settings] をクリックして、事前構成済みの認証を確認します。
- カスタム テンプレートを更新して、CSS アセットと JS アセットの v6 を使用します。また、 authSchemes や apiSchema などの新しいオブジェクト名を反映するように変更します。SmartDocs テンプレートの更新については、SmartDocs を使用した API のドキュメント化をご覧ください。
- モデルのリビジョンを再レンダリングして公開します。
- 新しいドキュメントを検証したら、本番環境 ポータルを 15.05.27 リリースに更新します。
Edge Enterprise のお客様で、アップグレード プロセスについてご質問やご不明な点がございましたら、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 | [Modules] リストに [DevConnect Mint] が 2 回表示される [Modules] に [Dev Connect Mint] が 2 回表示されていました。この問題は解決しました。 |
| DEVSOL-1313 | Swagger と WADL の両方で JSON/YAML ファイルまたは URL のインポートをサポートする WADL ファイルを URL 経由でインポートできるようになり、Swagger ファイルをアップロードできるようになりました。 |
| DEVSOL-1339 | SmartDocs 管理メニューの場所を変更する SmartDocs は [Content] メニューに移動し、SmartDocs の設定は [Settings] 管理メニューに移動しました。 |
| DEVSOL-1340 | 一般提供に移行する際にベータ版を削除する |
| DEVSOL-1390 |
PHP SDK Edge ライブラリが更新され、
__toString() Fatal error: Call to a member function format() on a non-object in /Applications/MAMP/htdocs/ordnance/docroot/profiles/apigee/libraries/mgmt-api-php-sdk/Apigee/Mint/DeveloperRatePlan.php on line 221 これは、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 Developer Apps モジュールにフックを追加して、
分析データを変更できるようにする # 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**] **メニュー リンクと対応するビューを作成する** デベロッパー ポータルの 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 の [sample] フィールドを編集する方法がない SmartDocs ページを編集するときに、[Body MIME タイプ]、[Body documentation]、[Body sample] を設定できるようになりました。 |
| DEVSOL-1534 | SmartDocs の出力で Content-type が設定されない SmartDocs メソッド ページで Content-type が設定されるようになりました。 |
| DEVSOL-1554 | Monetization での日付の比較が無効 収益化が有効になっているデベロッパー ポータルの購入済みプランのタブで、[キャンセル] ボタンが 開始日が未来のプランに対して表示されませんでした。 |
| DEVSOL-1556 | 古いバージョンの Drupal モジュールが提供されている media_youtube モジュールと features モジュールが最新バージョンに更新されました。 |
| DEVSOL-1558 | SmartDocs メソッド ページが PetStore の例でレンダリングされない 新規インストールでは、SmartDocs PetStore のメソッドの例が正しくレンダリングされるようになりました。 |
| DEVSOL-1562 | SmartDocs モデルごとにビューを生成する 新しいモデルを作成すると、そのモデルの新しいビューがデフォルトで作成されます。 |
| DEVSOL-1565 | SmartDocs メソッドを編集すると致命的なエラーが発生する SmartDocs メソッドの編集時にエラーが発生することがある問題を修正しました。 |
| DEVSOL-1567 | [Add model] が上部の管理メニューに表示される [Add model] メニュー項目が上部の管理メニューに表示される問題を修正しました。 |
| DEVSOL-1576 | API ドキュメント ビューに表示名ではなくモデル名が表示される メニューの [APIs] をクリックしたときに表示される API ドキュメント ページに、表示名ではなくモデルの内部名が表示されていました。このリリースに更新してこのビューを変更した場合は、次の手順でビューを元に戻して変更を確認する必要があります。# 管理者としてログインする # [Structure] > [Views] に移動する # [SmartDocs Models] の [Edit] の横にあるプルダウンをクリックして、すべての操作を表示する。# "revert" が表示されている場合は、コードを独自の変更で上書きしています。[revert] をクリックして、ビューを デフォルトの状態に戻します。このビューに加えた変更はすべて削除されます。 |
| DEVSOL-1578 | サイトのインストール時に天気モデルと 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 のバージョンを上げて、重大なセキュリティ修正を適用する
|