カスタムインテグレーションのテスト
非本番環境でカスタムインテグレーションをテストするには、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 ファイルをダウンロードします。