構成品目のペイロードの構成

ConfiguredItemService webサービスをコールするときにペイロードを構成します。

使用する階層は次のとおりです。

1 findCriteria オブジェクトおよび属性フィルタ基準全体を含む構造。
- 「1.1 fetchStartおよびfetchSize」. 必須。結果セットの行数を指定し、開始する行を指定します。
  - 1.1.1 fetchStart 開始点として使用する行。デフォルトは0です。値を0に設定すると、結果セットはデータセットの最初の行から始まります。値を99に設定すると、結果セットはデータセットの100番目の行から始まります。
    
    ノート: 注意: findCtoItemStructureを使用し、fetchStartを0以外の値に設定した場合は、findCtoItemStructureを使用する前にrefreshConfigStructureを使用する必要があります。 webサービスは、構成済品目が展開リポジトリで使用可能であると想定し、開始ポイントから始まるレコードを取得します。 refreshConfigStructureを使用すると、開始点に値が含まれていることを確認します。
  - 1.1.2 fetchSize 取得する行の最大数。 fetchSizeを -1 (負の1つ)に設定すると、検索では、fetchStartで指定された行から、検出されたすべての行が取得されます。
    
    fetchSizeが残りの行数より大きい場合、検索は残りの行数のみを返します。事前定義された最大fetchSizeは500です。単一の問合せではそれを超えることはできません。 fetchSizeを500を超える値または -1に設定し、500を超えるレコードが検索基準に一致する場合、webサービスによって例外が作成されます。
- 「1.2 フィルタ」. 実行時検索条件を含む構造。ビュー基準によって、問合せで返されるデータが、指定したフィルタに一致する行に制限されます。ビュー基準が存在しない場合、webサービスはリクエストの処理時にフィルタを適用しません。
  
  ビュー基準は、ビュー・オブジェクトのデータ・フィルタを定義する1つ以上の例による問合せ(QBE)行のコレクションと考えてください。 webサービスは、ビュー基準をSQLのWHERE句に変換します。
  - 1.2.1 conjunction 相互に関連する検索条件の評価方法を指定します。たとえば、And、Or、Not、AndNotおよびOrNotです。
    
    値を指定しない場合、webサービスではANDが使用されます。動作は、ビュー基準と前のビュー基準の間に結合が存在する場合のOracle Application Development Frameworkの動作に似ています。
    
    結合では大文字と小文字が区別されます。
  - 「1.2.2 1つ以上の属性に対する一連の実行時フィルタ条件を含む構造」. 動作は、Oracle Application Development Frameworkがビュー基準行のリストを処理する方法に似ており、各行は1つのビュー基準を定義します。
    - 1.2.2.1 conjunction レベル1.2.1を参照してください。
    - 「1.2.2.2 品目」. 属性の1つの実行時検索条件を含む構造。
      - 1.2.2.2.1 conjunction レベル1.2.1を参照してください。
      - 1.2.2.2.2 upperCaseCompare 検索で返される属性値を大文字に変換するかどうかを指定するブール値。変換はフィルタリングの前に行われます。
      - 「1.2.2.2.3 属性」. 詳細は、次の属性サブ・トピックを参照してください。
      - 「1.2.2.2.4 オペレータ」. 詳細は、次の演算子サブ・トピックを参照してください。
      - 「1.2.2.2.5 値」. webサービスが属性を検索するときに使用するフィルタ基準。ワイルドカードとして%を使用できますが、最初の文字として%を使用することはできません。たとえば、MySearch%を使用できますが、%MySearchは使用できません。
- 1.3 sortOrder 結果セットを昇順または降順にソートします。
- 1.4 findAttribute webサービスがフィルタ基準を適用した後に取得する属性。属性xを指定すると、webサービスは属性xの値のみを取得します。値を指定しない場合、webサービスはすべての属性を取得します。子オブジェクトは、親オブジェクトの属性です。
- 1.5 excludeAttribute ブール値。 Trueの場合、findAttributeで指定した属性以外のすべての属性を取得します。 Falseの場合、findAttributeで指定する属性を取得します。
2 findControl 存在する属性のすべての翻訳を取得します。このパラメータは、結果セット全体に影響します。

1.2.2.2.3 属性

フィルタする属性の名前を大文字と小文字を区別して指定します。子オブジェクトのルート・ノードは、親オブジェクトの属性です。

使用できる属性は次のとおりです。少なくとも1つを使用する必要があります。そうしないと、webサービスでエラーが発生します。

属性	タイプ	説明
ConfigItemId	Long	構成品目を識別する値です。
ConfigItemNumber	文字列	構成品目の名前。
BaseModelId	Long	オーダー組立モデルを識別する値。
BaseModelItemNumber	文字列	オーダー組立モデルの名前。
CreationDate	日付	フローが構成品目を作成した日付。

必要に応じて、これらの属性のいずれかを含めることもできます。

属性	タイプ	説明
OrganizationId	大きい小数	構成品目に関連付ける組織を識別する値です。
OrganizationCode	文字列	組織を識別する略称です。
EffectiveAsOfDate	日付	構成品目が有効になる日付。
RefreshStructure	Boolean	Contains. True. webサービスが検索を実行する前に、展開リポジトリの構造をリフレッシュします。 False. Don't refresh. デフォルト値はfalseです。

1.2.2.2.4 演算子

ノート

=、>=、<=, >、<,<>、ISBLANK、ISNOTBLANK、CONTAINS、STARTSWITH、AFTER、ONORAFTER、BEFORE、ONORBEFORE、BETWEENまたはNOTBETWEENのいずれかを使用します。
一部の演算子は、文字列、整数、日付など、すべての属性タイプでは機能しません。
通常、文字列属性には=や<などの数値演算子を使用します。
各テキスト演算子では大文字と小文字が区別されます。たとえば、ISBLANKはテキスト演算子であり、大/小文字が区別されます。

findCtoItemStructureを使用するときに必要な属性の検索に使用できる演算子を次に示します。他の演算子を使用した場合、webサービスはエラーを作成します。

属性	演算子
ConfigItemId	=
ConfigItemNumber	=
BaseModelId	=
BaseModelItemNumber	=
CreationDate	BETWEEN

findCtoSalesStructureまたはfindCtoItemStructureを使用する場合、必須ではない属性に対して任意の演算子を使用できます。