検索パラメータ形成処理

オペレーション名

機能概要

データモデル

プロパティ

基本設定

必須設定

項目名	必須/省略可	変数の使用	説明	備考
接続先	必須	使用不可	グローバルリソースを選択します。 グローバルリソースの設定方法については、「グローバルリソースのプロパティ」を参照してください。 [追加]: 新規にグローバルリソースを追加します。 [一覧の編集]: 「リソース一覧の編集」画面にて、グローバルリソースの設定を編集することができます。
テーブル名	必須	使用不可	Salesforceのテーブル名を選択します。
パラメータタイプ	必須	使用不可	形成する構文の種類を選択します。 [IN句のパラメータ]:(デフォルト) IN句のパラメータを形成します。 例: Name IN('AAA','BBB','CCC',,,) [AND,ORの繰り返し]: ANDやORの組み合わせを繰り返す条件式を形成します。 例: (Name = 'AAA') OR (Name = 'BBB') OR (Name = 'CCC'),,,
折り返し文字数	必須	使用可	1件の形成文字列の文字数上限を設定します。 文字数が上限を超える場合、複数件の結果を出力します。	デフォルト値は「99500」です。 「20」以上「99950」以下の値が指定できます。範囲以外の値が指定された場合、エラーが発生します。 Salesforceの仕様により、SOQLの文字数上限は100,000文字となっています。
条件項目名の指定方法	必須	使用不可	条件で使用する項目名の指定方法を選択します。 [選択する]:(デフォルト) 選択リストより選択します。 [直接入力する]: テキストフィールドに直接入力します。	[選択する]を選択した場合、実行時に選択した項目の存在チェックが行われます。 [直接入力する]を選択した場合、実行時に入力した項目の存在チェックは行われません。 選択リストに表示されない項目を条件指定したい場合、[直接入力する]を選択することで、自由に入力指定することができます。

プロパティアクション

項目名	説明	備考
テーブル情報の表示	操作を行っているオブジェクトのテーブル構造を確認できます。 テーブル構造の参照方法については、「テーブル情報の表示」を参照してください。	他のオブジェクトのテーブル構造を確認したい場合、[全テーブル情報の読み込み]をクリックしてください。
全テーブル情報の読み込み	取得可能なすべてのテーブル構造を取得します。 実行後に、[テーブル情報の表示]から取得した内容を確認することができます。

IN句のパラメータ

AND,ORの繰り返し

プロパティアクション

データ処理方式

コメント

スキーマ

入力スキーマ

• [IN句のパラメータ]を選択した場合
  
  

  <?xml version="1.0" encoding="UTF-8" ?>
  <table>
    <row>
      <column>in_parameter</column>
    </row>
    <row>
      :
    </row>
  </table>

  
  

  要素名	列名(ラベル/API)	説明	備考
  row	-	受け取るデータ行数分繰り返します。
  column	in_parameter	IN句に指定する値を渡します。



• [AND,ORの繰り返し]を選択した場合
  
  [条件式]の設定により、カラム数が異なります。
  スキーマ構造については、「テーブルモデル型のスキーマ」を参照してください。

出力スキーマ

<?xml version="1.0" encoding="UTF-8" ?>
<table>
  <row>
    <column>formed_parameter</column>
  </row>
  <row>
    :
  </row>
</table>

Mapperでのスキーマ読み込み

大容量データ処理

トランザクション

PSPでの使用について

使用できるコンポーネント変数

検索パラメータ形成使用例

• 例:CSVファイルに登録されている「取引先名」から、IN句を使用した検索条件文字列を作成し、[データ読み取り(クエリー)]処理を使用して「取引先(Account)」を読み取ります。
  
  
  
  

  画像内の番号	名称	説明	備考
  (1)	入力データイメージ	検索パラメータを形成するための入力データイメージです。 ここでは3,000件のデータが登録されているものとします。
  (2)	検索パラメータ形成の設定	[検索パラメータ形成]処理の設定イメージです。 [折り返し文字数]にはSOQLの文字数制限を考慮し、検索条件(WHERE)以外の文字列バッファを確保するため「9500」を指定します。
  (3)	スクリプトイメージ	本説明のスクリプト実装イメージです。 形成されたパラメータの件数分、[データ読み取り(クエリ)]処理を実行します。 読み取ったデータはCSVファイルに追加書き込みで出力します。
  (4)	検索パラメータ形成出力結果	[検索パラメータ形成]処理の後続に渡されるデータイメージです。 [折り返し文字数]に「9500」と指定したため、9,500文字以内の形成文字列が複数件出力されます。
  (5)	変数代入イメージ	スクリプト変数「formed_parameter」に、形成文字列を代入するマッピングイメージです。
  (6)	データ読み取り(クエリ)の設定	[データ読み取り(クエリ)]処理の[SOQL(検索条件)]に、スクリプト変数「formed_parameter」の値を代入指定します。

テーブル情報の表示

主な例外

注意事項

• 入力データがSOQLの条件値として正しいフォーマットであるかどうかは検証されません。