Force.com ワークブック
jステップ 3: レポートデータを絞り込む
レポートは、検索条件を使用して返されるデータを絞り込むときに最も役立ちます。
「レポートを作成する」では、標準 Web インターフェイスを使用してその場で検索条件を設定する方法について学習しました。API でレポートを絞り込むこともできます。API には検索条件を追加、編集、または削除するコマンドがあります。
たとえば、12 個を超える項目のみを表示するように条件設定済みの保存されたレポートを実行したとします。そして、次に保存されたレポートを変更することなく、さらに数量を絞リ込む必要があるとします。これを実行するには、編集した検索条件を指定してレポートのメタデータオブジェクトを送信します。
-
レポート実行が返す可能性がある一般的なメタデータをいくつか次に示します。
1'{reportMetadata":{"name":"MerchandiseReport","id":"00OD0000001ZbP7MAK","developerName":"MerchandiseReport","reportType":{"type":"MerchandiseList","label":"Merchandise"},"reportFormat":"MATRIX","reportBooleanFilter":null,"reportFilters":[{"column": "QUANTITY", "operator":"greaterThan", "value":"12"}],"detailColumns":["MERCHANDISE.NAME","CREATED_DATE","QUANTITY"],"currency":null,"aggregates":["RowCount"],"groupingsDown":[{"name":"CONTACT2.COUNTRY_CODE","sortOrder":"Asc","dateGranularity":"None"}],"groupingsAcross":[{"name":"OWNER","sortOrder":"Asc","dateGranularity":"None"}]}}' -
検索条件を変更して、レポートを実行します。コードは次のようになります。編集した検索条件は太字で示されています (この例は同期ですが、非同期実行でも同様に実行されます)。
1curl -s -H 'Authorization: OAuth token ...' https://na1.salesforce.com/services/data/v29.0/analytics/reports/00OD0000001ZbP7MAK -X POST -d '{reportMetadata":{"name":"MerchandiseReport","id":"00OD0000001ZbP7MAK","developerName":"MerchandiseReport","reportType":{"type":"CaseList","label":"Cases"},"reportFormat":"MATRIX","reportBooleanFilter":null,"reportFilters":[{"column": "QUANTITY", "operator":"lessThan", "value":"12"}],"detailColumns":["MERCHANDISE.NAME","CREATED_DATE","QUANTITY"],"currency":null,"aggregates":["RowCount"],"groupingsDown":[{"name":"CONTACT2.COUNTRY_CODE","sortOrder":"Asc","dateGranularity":"None"}],"groupingsAcross":[{"name":"OWNER","sortOrder":"Asc","dateGranularity":"None"}]}}'
これで、条件設定済みレポートを実行し、データを取得できました。今後は、この便利な方法で実践できます。いくつかのアイデア、および完全な手順と詳細なリファレンスについては、『Salesforce1 Reporting REST API Developer Guide (Salesforce1 レポート REST API 開発者ガイド)』を参照してください。