概念: WQL の関連ビジネス オブジェクト
"" の関連ビジネス オブジェクト (RBO) からフィールドにアクセスできます。
SELECT
中かっこを使用した句 {}
の注記。レポート フィールドを使用して、RBO フィールドでクエリー結果をフィルタすることもできます。
WHERE ON
句。開始 WHERE ON
句、中かっこを省略します。 {}
RBO フィールドの注記。以下のエンドポイントからの応答では、各フィールドの関連ビジネス オブジェクトが返されるようになります。
- GET /dataSources/{ID}/fields
- GET /dataSources/{ID}/dataSourceFilters/{subresourceID}
構文
SELECTfield1{relatedBusinessObjectField1, relatedBusinessObjectField2} FROMdataSource
例:
SELECT dependents{age} FROM allWorkers
RBO フィールドから、カンマで区切られた単一フィールドまたは複数のフィールドを参照できます。
カスタムの別名を RBO フィールドに割り当てることもできます。例:
dependents{age} as DependentsAge
例
扶養家族
RBO から従業員と複数のフィールドを 1 つのグループで返します。SELECT worker, dependents{legalName_FirstName, legalName_LastName, age} FROM allWorkers
"扶養家族"
RBO から従業員と複数のフィールドを個別のグループとして返します。SELECT worker, dependents{legalName_FirstName} as FirstName, dependents{legalName_LastName} as LastName, dependents{age} as Age FROM allWorkers
同じルックアップ フィールドから複数のフィールドを別々に呼び出す場合は、一意のフィールド別名を使用してください。
制限事項
RBO のルックアップ フィールドが複数インスタンスの場合、RBO フィールドでサポートされる値は 500 までです。例: 従業員を主ビジネス オブジェクトとして指定し、従業員の扶養家族を RBO として指定します。クエリーによって返される従業員の扶養家族が 500 を超える場合、WQL にはエラーが表示されます。代わりに、"依存" データ ソースに基づくデータ ソースの使用を検討してください。
以下の場合、RBO からフィールドにアクセスできません。
- "" を使用するクエリー内GROUP BY句。
- の範囲外SELECTおよびWHERE ON句。
サードパーティの API クライアントを使用する場合は、最初にクエリーをエンコードする必要がある場合があります。一部のサードパーティ クライアントでは、中かっこが処理されません
{}
の注記。エンコード前のクエリーの例:
SELECT worker, dependents{legalName_FirstName} as FirstName FROM allWorkers
エンコード後のクエリーの例:
SELECT%20worker%2C%20dependents%7BlegalName_FirstName%7D%20as%20FirstName%20FROM%20allWorkers