第二世代管理パッケージ開発者ガイド
jカスタムインテグレーションのテスト
非本番環境でカスタムインテグレーションをテストするには、AppExchange の App Analytics のシミュレーションモードを使用します。App Analytics クエリ要求を送信し、サンプルの利用状況データを受信します。
| 必要なユーザー権限 | |
|---|---|
| シミュレーションモードを有効化する | ModifyMetadata |
サンプルの利用状況データを受信するには、シミュレーションモードを有効にしてから、シミュレーションモードのパッケージ ID を含むクエリ要求を送信します。
- テスト組織で Metadata API AppAnalyticsSettings の enableSimulationMode 組織設定を使用して、シミュレーションモードを有効にします。
-
パッケージ利用状況ログ、利用状況概要、または登録者のスナップショットのダウンロードをシミュレーションするには、SOAP API AppAnalyticsQueryRequest の必須項目を入力します。DataType は指定し、OrganizationIDs は空白のままにします。PackageIDs には、テストするシナリオに一致するシミュレーションモードのパッケージ ID を 1 つ以上指定します。
パッケージデータセット シミュレーションモードのパッケージ ID 説明 少量のデータセット 033xx00SIMsmall 少量のデータが含まれています。すべてのクエリ種別で使用できます。このパッケージ ID を使用して、クエリで許可された期間のデータをダウンロードします。 大量のデータセット 033xx00SIMlarge 2 つの組織 ID (00Dxx00SIM00foo および 00Dxx00SIM00bar) のデータが大量に含まれています。パッケージ利用状況ログクエリでのみ使用できます。 空のデータセット 033xx00SIM のプレフィックスが付いているその他の任意の 15 文字のパッケージ ID を使用します。 例:
- 033xx00SIMempty
- 033xx00SIM44444
データは含まれていません。すべてのクエリ種別で使用できます。これらのパッケージ ID のいずれかを使用すると、空のデータセットが返されます。 - クエリを送信します。
-
API 要求の確認。
- 成功した場合は、API 要求で作成された App Analytics クエリ要求オブジェクトを取得します。要求が完了すると、DownloadURL 項目が入力されます。
- エラーが発生した場合は、クエリを編集します。使用する時間枠を短くするか (14 日など)、1 つの組織 ID を指定します。次にクエリを再送信します。
- App Analytics クエリ要求オブジェクトの DownloadURL 項目から、サンプルの利用状況データを含むカンマ区切り値 (.csv) ファイルをダウンロードします。