ビジネスエンティティサービスガイド

10.3 HotFix 1
- 10.4 HotFix 3
- 10.4 HotFix 2
- 10.4
- 10.3
- 10.2 HotFix 2
- 10.2 HotFix 1
- 10.2

前へ次へ

クエリパラメータ

フィールドと値のペアのリストとして、クエリを定義します。

次の表に、URLに使用できるクエリパラメータを示します。

パラメータ	説明
action	必須。クエリ結果に、指定したビジネスエンティティタイプのすべてのレコードを返します。 query に設定し、 filter パラメータを設定してこのパラメータを使用します。 filter パラメータを指定せずに使用すると、指定したビジネスエンティティタイプのすべてのレコードがクエリによって検索されます。例えば、次のクエリを使用すると、すべてのPersonビジネスエンティティレコードが検索されます。 Person?action=query
filter	必須。演算子で区切られた、フィールド値ペアのリストを指定します。有効な演算子はAND、IN、およびRangeです。例えば、次のクエリを使用すると、名がSTEVEで姓がSMITHのPersonレコードが検索されます。 Person?action=query&filter=firstName='STEVE' AND lastName='SMITH'
depth	返す子レコードレベルの数を指定します。例えば、以下のレベルを指定できます。 1. ルートレコードを返します。 2. ルートレコードと、その直接の子レコードを返します。 3. ルートレコード、直接の子レコード、および孫レコードを返します。例えば、次のクエリを使用すると、名がSTEVEのレコードが検索され、ルートレコードとその直接の子レコードに関する情報が返されます。 Person?action=query&filter=firstName='STEVE' AND lastName='SMITH'&depth=2
suppressLinks	API応答に親と子のリンクを含めるかどうかを示します。応答に親と子のリンクをいっさい含めない場合は、このパラメータをtrueに設定します。デフォルトはfalseです。例えば、次のクエリを使用すると、名がSTEVEのレコードが検索され、親と子のリンクが表示されない応答が返されます。 Person?action=query&filter=firstName='STEVE'&suppressLinks=true
readSystemFields	結果でシステムフィールドを返すかどうかを示します。デフォルトはfalseです。
fields	クエリ結果に表示するフィールドを指定します。
outputView	クエリ結果を表示するために使用するビジネスエンティティビューを指定します。クエリ結果のビジネスエンティティビューを設定する場合は、クエリ結果に表示するフィールドを含めます。
順序	クエリ結果のソート順を指定します。プラス（+）文字をプレフィックスとして使用すると昇順、マイナス（-）文字をプレフィックスとして使用すると降順でソートされます。デフォルトでは、クエリ結果は昇順になります。複数のパラメータを指定した場合、結果セットは、指定した最初のパラメータでまずソートされてから、次のパラメータでソートされます。

フィルタパラメータ内で次の演算子を使用できます。

AND: フィルタパラメータのリストに含まれるすべてのフィールド値を持つレコードが検索されます。; 例えば、次のクエリを使用すると、名がSTEVEで姓がSMITHのレコードが検索されます。
Person?action=query&filter=firstName='STEVE' AND lastName='SMITH'
IN: フィルタパラメータのリストに含まれる値のいずれかを持つレコードが検索されます。; 例えば、次のクエリを使用すると、名がSTEVEまたはJOHNのレコードが検索されます。
Person?action=query&filter=firstName IN [STEVE,JOHN]
範囲: 指定した範囲内のレコードが検索されます。数値および日付のデータ型のフィールドに範囲を指定できます。; 整数データ型では、次の形式を使用します。
<business entity field name>=[fromValue,toValue]
範囲は、fromValueからtoValueです。fromValueがtoValueよりも小さいことを確認してください。; 例えば、次のクエリを使用すると、年齢グループが35から45のレコードが検索されます。
Person?action=query&filter=firstName IN [STEVE,JOHN] AND age=[35,45]; 日付データ型では、次の形式を使用します。
<business entity field name>=[fromDate,toDate]
範囲は、fromDateからtoDateです。; 例えば、次のクエリを使用すると、誕生日が2000年6月12日から2015年6月12日のレコードが検索されます。
Person?action=query&filter=birthDate=[2000-06-12T12:30:00Z,2015-06-12T12:30:00Z]

SearchQuery

ガイドをダウンロード

ページをウォッチ

フィードバックを送信

コミュニティ

Knowledge Base

Success Portal

Rename Saved Search

目次

ビジネスエンティティサービスガイド

ビジネスエンティティサービスガイド

クエリパラメータ

クエリパラメータ