バッチ作成処理

オペレーション名

機能概要

• 「Salesforce Developer Documentation」-(https://developer.salesforce.com/docs)
  • Bulk API 2.0 and Bulk API Developer Guide

データモデル

プロパティ

基本設定

必須設定

項目名	必須/省略可	変数の使用	説明	備考
接続先	必須	使用不可	グローバルリソースを選択します。 グローバルリソースの設定方法については、「グローバルリソースのプロパティ」を参照してください。 [追加]: 新規にグローバルリソースを追加します。 [一覧の編集]: 「リソース一覧の編集」画面にて、グローバルリソースの設定を編集することができます。
ジョブID	必須	使用可	バッチを作成するジョブのIDを入力します。
テーブル名	必須	使用不可	指定したジョブのオブジェクトに対応したSalesforceのテーブル名を選択します。
スキーマ定義	必須	-	バッチに登録するCSVデータのヘッダ行とする項目を設定します。	ジョブのオペレーション種類によって必要な項目が異なります。 「UPDATE」の場合、「Id」を含む必要があります。 「UPSERT」の場合、ジョブに指定されている「外部ID項目」を含む必要があります。 「DELETE」の場合、「Id」のみとします。 Salesforceに対して書き込みが必要な項目に限定(不要な項目をスキーマ定義から除く)することにより、処理効率が向上します。 データ型が「base64」と定義された項目を扱うことはできません。このような項目が選択されている場合、エラーが発生します。
スキーマ定義/ラベル	必須	使用不可	[テーブル名]で指定したテーブルの列のラベル名を表示します。
スキーマ定義/API	必須	使用不可	[テーブル名]で指定したテーブルの列のAPI名を表示します。
スキーマ定義/型	必須	使用不可	[テーブル名]で指定したテーブルの列のデータ型を表示します。
スキーマ定義/Null設定	省略可	使用不可	入力データがnullまたは空文字であった場合、文字列「#N/A」に置き換えるかどうかを項目単位に選択します。 [チェックあり]: この項目の置き換えを行います。 [チェックなし]: この項目の置き換えを行いません。	[項目単位に設定する]で[チェックあり]にした場合、有効になります。
リレーションシップ項目定義	省略可	-	スキーマ定義にリレーション項目が存在する場合、外部キーによる更新を行うための項目を設定します。	リレーション先オブジェクトの外部キー項目を選択することにより、リレーション関係を持たせたデータの受け渡しが可能となります。 詳細については、「リレーションシップ項目定義」を参照してください。 API 43.0以降のグローバルリソースを選択している場合、多態的な項目による更新が可能となります。 多態的な項目は、[リレーション用カラムAPI名]で指定します。 多態的な項目の詳細はSalesforceのドキュメントをご確認ください。
リレーションシップ項目定義/元項目API名	必須	使用不可	[テーブル名]で指定したテーブルのリレーション項目の列のAPI名を表示します。
リレーションシップ項目定義/リレーションシップ名	必須	使用不可	[テーブル名]で指定したテーブルのリレーション項目の列のリレーションシップ名を表示します。
リレーションシップ項目定義/オブジェクトAPI名	省略可	使用不可	[テーブル名]で指定したテーブルのリレーション項目の列のリレーション先のオブジェクトのAPI名を選択します。
リレーションシップ項目定義/リレーション用カラムAPI名	省略可	使用不可	[テーブル名]で指定したテーブルのリレーション項目の列のリレーション先オブジェクトの外部キー項目を選択します。	省略した場合、リレーション先オブジェクトの該当レコードのIDを受け渡す仕様となります。

プロパティアクション

項目名	説明	備考
スキーマの作成	バッチに登録するCSVデータのヘッダ行の追加・削除を行うことができます。 設定方法については、「スキーマの作成」を参照してください。

オプション設定

プロパティアクション

項目名	説明	備考
テーブル情報の表示	操作を行っているオブジェクトのテーブル構造を確認できます。 テーブル構造の参照方法については、「テーブル情報の表示」を参照してください。	他のオブジェクトのテーブル構造を確認したい場合、[全テーブル情報の読み込み]をクリックしてください。
全テーブル情報の読み込み	取得可能なすべてのテーブル構造を取得します。 実行後に、[テーブル情報の表示]から取得した内容を確認することができます。
ファイルからスキーマ定義を読み取り	ファイルチューザでファイルを選択して、そのファイルの1行目にカンマ区切りで指定された項目(API)を読み取り、スキーマ定義として設定します。	選択するファイルのエンコードは「UTF-8」を指定してください。
スキーマ定義をファイルへ出力	ファイルチューザで指定したファイルの1行目に、[スキーマ定義/API]の項目をカンマ区切りで出力します。	API 53.0以降のグローバルリソースを選択している場合のみ有効になります。 [スキーマ定義/API]以外の項目は出力しません。 指定したファイルのエンコードは「UTF-8」になります。 指定したファイルが存在する場合、上書きされます。 ファイルパスはDataSpiderファイルシステムの絶対パスで指定してください。 パス区切り文字「/」以外のDataSpiderファイルシステムの使用禁止文字は使用できません。 本プロパティアクションで出力したファイルを[ファイルからスキーマ定義を読み取り]で読み取ることができます。

データ処理方式

コメント

スキーマ

入力スキーマ

出力スキーマ

<?xml version="1.0" encoding="UTF-8" ?>
<table>
  <row>
    <column>バッチID/batchId</column>
    <column>状況/state</column>
    <column>状態メッセージ/stateMessage</column>
    <column>開始時刻/createdDate</column>
    <column>投入レコード件数/inputRecordCount</column>
  </row>
  <row>
    :
  </row>
</table>

Mapperでのスキーマ読み込み

大容量データ処理

トランザクション

PSPでの使用について

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

リレーションシップ項目定義

• 例: 取引先責任者(Contact)への更新(INSERT,UPDATE,UPSERT)
  
  
  • 例の詳細
    

    種類	説明	備考
    要件仕様	取引先責任者(Contact)の更新処理にて、取引先IDの項目(参照項目)に参照先のオブジェクトのIDを設定したい。 参照先となる取引先(Account)の関連は、入力データの取引先コードに対応するレコードと紐付けたい。
    設定方法	取引先責任者(Contact)への更新にて、取引先IDの項目(参照項目)へ参照先オブジェクトとなる取引先(Account)の 取引先コード(あらかじめ作成した外部キー項目:AccountCode__c)の値をMapperに受け渡す事により 更新時に対応する参照先オブジェクトのIDを自動で取得してリレーション関係を設定します。	本説明にて使用している項目や一部の設定は使用例となります。 使用しているSalesforce組織に必ず存在するものではありません。 各種設定を行った上で本機能を使用してください。

  
  
  • 連携イメージ
    
    
    

    画像内の番号	名称	説明	備考
    (1)	取引先(Account)のデータイメージ	取引先責任者(Contact)から参照されるオブジェクトのデータイメージです。
    (2)	取引先(Account)の外部キー項目	あらかじめ「取引先コード(AccountCode__c)」外部キーとして設定しておきます。
    (3)	入力データイメージ	取引先責任者(Contact)へ更新するための入力データイメージです。	「取引先コード」を保持したデータです。
    (4)	取引先責任者(Contact)への更新(INSERT,UPDATE,UPSERT)の設定	ここでは、「取引先ID」,「姓」,「名」,「電子メール」の4項目を更新対象とします。
    (5)	リレーションシップ項目定義の設定	「リレーション用カラムAPI名」にて参照先オブジェクトの外部キー項目を選択します。ここでは、リレーション関係を設定するためのキー項目として、参照先オブジェクトの外部キー「Account.AccountCode__c」を選択します。	選択値が無しの場合、参照先のオブジェクトの該当レコードのIDをMapperに受け渡す仕様となります。
    (6)	取引先責任者(Contact)の更新結果データイメージ	取引先責任者(Contact)の更新結果データイメージです。	「取引先コード」に対応したレコードとのリレーション関係が正しく設定されています。

スキーマの作成

テーブル情報の表示

仕様制限

• 本アダプタによるデータ読み取り・書き込みの操作を行うには、Salesforceの組織がAPIを公開している必要があります。


• 各テーブルに対するデータ読み取り・書き込みなどの操作権限、およびデータのアクセスコントロールは、すべてSalesforce側のプロファイル、共有ルールの設定、およびAPI仕様に依存します。


• API バージョンによって扱うことができるオブジェクトや項目は異なります。詳細はSalesforceのドキュメントをご確認ください。


• 本コンポーネントではデータ型が「base64」の項目を扱うことはできません。


• 本アダプタではジョブのコンテンツタイプは「CSV」を使用します。
  他のコンテンツタイプのジョブを作成、または他のコンテンツタイプのジョブに対してバッチを作成することはできません。


• API 50.0以降かつ、[API種別]が[Bulk API 2.0]のグローバルリソースを選択した以下のコンポーネントからフローを引いて使用することはできません。
• Bulkデータ書き込み(INSERT)
• Bulkデータ書き込み(UPDATE)
• Bulkデータ書き込み(DELETE)
• Bulkデータ書き込み(UPSERT)
• Bulkデータ読み取り(QUERY)

主な例外

注意事項

• オブジェクトの項目にはデータ型が定義されています。APIでは定義されたデータ型の形式ルールに従いデータを送受信しますが、本アダプタでは一部のデータ型においてルールを拡張しています。
  詳細については、「データ型の形式」を参照してください。