4.15.07.00 - Apigee Developer Services ポータル リリースノート

現在、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 ベータ版から一般提供版にアップグレードするには

  1. Pantheon の dev または test 環境で 15.05.27 リリースを更新してテストします。
  2. 新しいモデルを作成して、使用している既存の API モデルと置き換えます。
    • Swagger ドキュメントまたは WADL ドキュメントをインポートしている場合は、新しいリビジョンに再度インポートします。
    • SmartDocs モジュールを使用して API モデルを保守している場合は、SmartDocs JSON としてエクスポートし、添付ファイルを使用して新しいモデルにインポートします。
  3. モデルのリビジョンのセキュリティ プロパティを設定します。[Content] > [SmartDocs] > [model] ページで、[Security Settings] を選択します。
  4. モデルの設定ページ([Content] > [SmartDocs])で事前構成済みの認証を確認します。それには、[Operations] 列の [設定] をクリックします。
  5. CSS アセットと JS アセットの v6 を使用するようにカスタム テンプレートを更新し、authSchemes や apiSchema などの新しいオブジェクト名を反映するように変更を加えます。SmartDocs テンプレートの更新については、SmartDocs を使用した API のドキュメント化をご覧ください。
  6. モデル リビジョンを再レンダリングして公開します。
  7. 新しいドキュメントを検証したら、本番環境ポータルを 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 ライブラリが更新されました
PHP SDK Edge ライブラリが更新され、DeveloperRatePlan オブジェクトで __toString() を呼び出して次のエラーが発生する問題が修正されています。

致命的なエラー: /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 モジュールにフックを追加して、分析データを変更できるようにする
devconnect_developer_apps モジュールに次の 3 つの新しいフックが提供されるようになりました。

# 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

https://www.drupal.org/project/features

DEVSOL-1648 reCAPTCHA の破損を防ぐために、arg_separator.output が「&」になっていることを確認してください
Google reCAPTCHA の使用ができないプラットフォーム関連の問題が修正されました。
DEVSOL-1651 smartdocs モジュールが有効になっていない場合、Apigee Base テーマが失敗する
apigee_base テーマが、SmartDocs モジュールの有効化に依存しなくなりました。
DEVSOL-1654

admin_views のバージョンをバンプして、重要なセキュリティ修正を適用する
次の contrib モジュールが更新されました。

  • 管理ビュー
  • 移行
  • リダイレクト
  • Redis
  • 一括操作の表示