1. クエリ

ジェネリック プロパティ

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

エンティティは、既知のデータ型の汎用プロパティでクエリを実行できます。

これを行うには、次のコンストラクトを使用します。

DATATYPE('PropertyName') OPERATOR PropertyValue

糸

たとえば、特定のTitleを持つすべてのエンティティをクエリするには、次のようにします。

GET http://<HOSTNAME>/api/entities/query?query=String('Title')=='title'

空の文字列を検索することもできます。

/api/entities/query?query=String('Title')==""

これは、多言語クエリ にも使用できます。

/api/entities/query?query=String('Title', 'en-US')==""
メモ

プロパティ値は、最初はnull値を持ちます。値が追加されてから削除された場合にのみ、空の文字列になります。

整数

たとえば、特定のIntPropertyを持つすべてのエンティティをクエリするには、次のようにします。

GET http://<HOSTNAME>/api/entities/query?query=Int('IntProperty')==1

長い

たとえば、特定のLongPropertyを持つすべてのエンティティをクエリするには、次のようにします。

GET http://<HOSTNAME>/api/entities/query?query=Long('LongProperty')==5000000000

小数

たとえば、特定のDecimalPropertyを持つすべてのエンティティをクエリするには、次のようにします。

GET http://<HOSTNAME>/api/entities/query?query=Decimal('DecimalProperty')==1.5

浮く

たとえば、特定のFloatPropertyを持つすべてのエンティティをクエリするには、次のようにします。

GET http://<HOSTNAME>/api/entities/query?query=Float('FloatProperty')==1.5

日時

たとえば、特定の日付以降に作成されたすべてのエンティティをクエリするには、次のようにします。

GET http://<HOSTNAME>/api/entities/query?query=DateTime('CreatedOn') gte 20141213

DateTime表現は、日付と時刻に関連するデータの交換をカバーする国際標準ISO8601に準拠しています。

REST API自体から利用できる形式は、YYYYMMDDとYYYYMMDDTHHMMSSの2つです。

クエリAPIでは、次の形式を使用できます。

基本フォーマット

  • yyyyMMdd

  • yyyyMMddTHHmmsszzz

  • yyyyMMddTHHmmsszz

  • yyyyMMddTHHmmssZ

  • yyyyMMddTHHmmss

  • yyyy-MM-ddTHHmmss

拡張フォーマット

  • yyyy-MM-ddTHH:mm:sszzz

  • yyyy-MM-ddTHH:mm:sszz

  • yyyy-MM-ddTHH:mm:ssZ

上記のすべてに精度が落ちています

  • yyyyMMddTHHmmzzz

  • yyyyMMddTHHmmzz

  • yyyyMMddTHHmmZ

  • yyyy-MM-ddTHH:mmzzz

  • yyyy-MM-ddTHH:mmzz

  • yyyy-MM-ddTHH:mmZ

精度を数時間に短縮

  • yyyyMMddTHHzzz

  • yyyyMMddTHHzz

  • yyyyMMddTHHZ

  • yyyy-MM-ddTHHzzz

  • yyyy-MM-ddTHHzz

  • yyyy-MM-ddTHHZ

ブーリアン

ブール値は演算子をサポートしていませんが、否定することができます。

たとえば、すべてのドラフトエンティティをクエリするには、次のようにします。

GET http://<hostname>/api/entities/query?query=Bool('IsDraft')

多言語プロパティ

エンティティのクエリを実行するときに多言語プロパティを使用するには、フィルター処理するカルチャを指定します。

たとえば、fruitful Brandlabelを持つすべてのM.Brandエンティティをen-USでフェッチするには、次のようにします。

GET http://<HOSTNAME>/api/entities/query?query=Definition.Name == "M.Brand" AND String("BrandLabel", "en-US") == "Fruitful"
この記事を改善するための提案がある場合は、 お知らせください!