現在、Apigee Edge のドキュメントを表示しています。
Apigee X のドキュメントをご確認ください。 情報
2015 年 9 月 8 日（火）、Private Cloud 用の Apigee Edge デベロッパー サービス ポータルの四半期バージョンをリリースしました。
以前のプロダクト名「Apigee Edge On-Prem Developer Services Portal」または「OPDK」は、現在「Apigee Edge Developer Services Portal for Private Cloud」です。
ご不明な点がございましたら、Apigee カスタマー サポートまでお問い合わせください。
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 キー」に名称変更されました。
- リビジョン レベルで定義されている認証「security」オブジェクト。
- テンプレート レベルでのクライアント認証の構成。新しいリビジョンで、事前構成された 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] 列の [設定] をクリックします。
- CSS アセットと JS アセットの v6 を使用するようにカスタム テンプレートを更新し、authSchemes や apiSchema などの新しいオブジェクト名を反映するように変更を加えます。SmartDocs テンプレートの更新については、SmartDocs を使用した API のドキュメント化をご覧ください。
- モデル リビジョンを再レンダリングして公開します。
- 新しいドキュメントを検証したら、本番環境ポータルを 15.05.27 リリースに更新します。
Edge Enterprise をご利用で、アップグレード プロセスについて質問や不明点がある場合は、marsh@apigee.com または cnovak@apigee.com にメールでお問い合わせください。それ以外の場合は、Apigee コミュニティをご利用ください。
修正済みのバグ
以下のバグはこのリリースで修正されています。
| 問題 ID | 説明 |
|---|---|
| DEVSOL-487 | 収益化サービスの日の形式を管理者が設定可能に 収益化の [収益化] 設定で、欧州と米国で日付形式を設定できるようになりました。 |
| 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 Admin] メニューの場所を変更する SmartDocs がコンテンツ メニューの下に、smartdocs 設定が設定管理メニューの下にあります。 |
| DEVSOL-1340 | 一般提供開始時にベータ版を削除する |
| DEVSOL-1390 |
__toString() の呼び出しの問題を修正するため PHP SDK Edge ライブラリが更新されました 致命的なエラー: /Applications/MAMP/htdocs/ordnance/docroot/profiles/apigee/libraries/mgmt-api-php-sdk/Apigee/Mint/DeveloperRatePlan.php の 221 行目の非オブジェクトに対するメンバー関数 format() の呼び出し これは、toString() メソッドを呼び出すカスタムコードを使用する Monetization のお客様にのみ影響するバグです。 |
| DEVSOL-1398 | SmartDocs Petstore Model がインストール時にユーザーにプロンプトが表示されることなくインポートされる 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 | [API] メニューリンクと対応するビューの作成 デベロッパー ポータルの SmartDocs には、メインメニューの [APIs] に SmartDocs でレンダリングされたドキュメントへのリンクがデフォルトで表示されるようになりました。これにより、公開済みのメソッドを持つすべてのモデルにリンクされます。 |
| DEVSOL-1486 | SmartDocs の呼び出しでは、事前定義されたキーを使用して認証を行うことができます。 事前指定された API キーとユーザーが提供した API キーの両方で認証を有効にします。 |
| DEVSOL-1499 | SmartDocs パラメータの説明で HTML コードが解析されない HTML コードが SmartDocs パラメータの説明で解析されるようになりました。 |
| DEVSOL-1507 | メソッドの追加を使用して API に複数のパラメータを追加できない メソッドの編集時に SmartDocs API に複数のパラメータを追加できるようになりました。 |
| DEVSOL-1509 | SmartDocs API の [sample] フィールドを編集する方法が表示されない SmartDocs ページを編集する際に、[Body MIME タイプ]、[Body document]、[Body sample] を設定できるようになりました。 |
| DEVSOL-1534 | Content-type が SmartDocs の出力に入力されない Content-type が SmartDocs メソッドページで入力されるようになりました。 |
| 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 ドキュメント ページに、表示名ではなくモデルの内部名が表示されていました。リリースに更新していて、このビューを変更した場合は、以下の手順でビューを元に戻す必要があります。 管理者としてログイン # ストラクチャ > ビュー # 「SmartDocs モデル」の [編集] の横にあるプルダウンをクリックして、すべてのオペレーションを表示します。# 「revert」と表示される場合は、コードが自分で変更され、上書きされています。[元に戻す] をクリックすると、ビューがデフォルトの状態に戻ります。この操作により、このビューに加えた変更がすべて削除されることに注意してください。 |
| DEVSOL-1578 | サイト インストールで Weather モデルと Petstore モデルの両方をレンダリングする Petstore モデルと Weather SmartDocs モデルの両方が新しいサイトにインポートされます。 |
| DEVSOL-1584 | プランを購入できない Apigee レスポンシブ広告のテーマまたは Apigee レスポンシブ広告のテーマのサブテーマを使用している場合に、Cloud リリース 15.05.27.00 および 15.06.08.00 に対して収益化プランの購入フォームを送信できない問題を修正しました。 |
| DEVSOL-1597 | デベロッパーのタイムアウト設定を変更できない Edge 接続タイムアウトの設定が適切に適用されないバグが修正されました。 |
| DEVSOL-1620 |
自分、環境インジケーター、機能モジュールのアップグレード 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 のバージョンをバンプして、重要なセキュリティ修正を適用する
|