データ書き込み(UPSERT)処理

オペレーション名

機能概要

• 「Salesforce API 7.0」-「upsert」(http://www.sforce.com/us/docs/sforce70/sforce_API_calls_upsert.html)


• 「Salesforce API 14.0」-「upsert()」(http://www.salesforce.com/us/developer/docs/api140/Content/sforce_api_calls_upsert.htm)


• 「Salesforce API 18.0」-「upsert()」(http://www.salesforce.com/us/developer/docs/api180/Content/sforce_api_calls_upsert.htm)

Standalone版では使用できません。

データモデル

プロパティ

基本設定

必須設定

項目名	必須/省略可	変数の使用	説明	補足
接続先	必須	使用不可	グローバルリソースを選択します。 グローバルリソースの設定方法については「グローバルリソースのプロパティ」を参照してください。 [追加]: 新規にグローバルリソースを追加します。 [一覧の編集]: 「リソース一覧の編集」プロパティにて、グローバルリソースの設定を編集することができます。	以下のAPIが使用可能です。 API7.0 API14.0 API18.0
テーブル名	必須	使用不可	Salesforceのテーブル名を選択します。
更新時Null設定	必須	使用不可	更新対象フィールドに対する入力データがnullであった場合、nullで上書きするか、該当項目の更新をスキップするかを選択します。 [読み込みデータで常に上書き]:(デフォルト) 入力データがnullの場合、更新対象フィールドをnullで上書きします。 [読み込みデータをスキップ]: 入力データがnullの場合、更新対象フィールドの更新をスキップし、更新前の状態を維持します。 入力データがnull以外の場合、更新対象フィールドは入力データで上書きします。
スキーマ定義	必須	-	Salesforceに対して書き込みを行う項目を設定します。	Salesforceに外部ID(またはID)が未設定の場合、または、外部ID(またはID)と異なる項目を外部キーと指定した場合、本オペレーション実行時に例外がスローされます。 Salesforceに対して書き込みが必要な項目に限定(不要な項目をスキーマ定義から除く)することにより、処理効率が向上します。
スキーマ定義/外部キー	必須	使用不可	[テーブル名]で指定したテーブルの該当の列が更新のキー項目かどうかを選択します。 [true]:更新のキー項目に指定します。 [false]:更新のキー項目に指定しません。
スキーマ定義/ラベル	必須	使用不可	[テーブル名]で指定したテーブルの列のラベル名を表示します。
スキーマ定義/API	必須	使用不可	[テーブル名]で指定したテーブルの列のAPI名を表示します。
スキーマ定義/型	必須	使用不可	[テーブル名]で指定したテーブルの列のデータ型を表示します。
リレーションシップ項目定義	省略可	-	スキーマ定義にリレーション項目が存在する場合、外部キーによる更新を行うための項目を設定します。 リレーション先オブジェクトの外部キー項目を選択することにより、リレーション関係を持たせたデータの受け渡しが可能となります。	API14.0以降で使用可能です。API7.0では使用不可です。 詳細については、「リレーションシップ項目定義」を参照してください。
リレーションシップ項目定義/元項目API名	必須	使用不可	[テーブル名]で指定したテーブルのリレーション項目の列のAPI名を表示します。
リレーションシップ項目定義/リレーションシップ名	必須	使用不可	[テーブル名]で指定したテーブルのリレーション項目の列のリレーションシップ名を表示します。
リレーションシップ項目定義/オブジェクトAPI名	必須	使用不可	[テーブル名]で指定したテーブルのリレーション項目の列のリレーション先のオブジェクトのAPI名を表示します。
リレーションシップ項目定義/リレーション用カラムAPI名	省略可	使用不可	[テーブル名]で指定したテーブルのリレーション項目の列のリレーション先オブジェクトの外部キー項目を選択します。	省略した場合、リレーション先オブジェクトの該当レコードのIDを受け渡す仕様となります。

プロパティアクション

項目名	説明	補足
スキーマの作成	Salesforceに対して書き込みを行う項目の追加・削除を行うことができます。 設定方法については、「スキーマの作成」を参照してください。

オプション設定

プロパティアクション

項目名	説明	補足
テーブル情報の表示	[接続先]で選択されているSalesforceのテーブル構造を確認できます。 テーブル構造の参照方法については、「テーブル情報の表示」を参照してください。

データ処理方式

コメント

スキーマ

入力スキーマ

出力スキーマ

<?xml version="1.0" encoding="UTF-8" ?>
<table>
   <row>
     :  ←[スキーマ定義]で選択したスキーマとなります。
     <column>更新結果_ID/update_result_id</column>
     <column>更新結果_成功フラグ/update_result_is_success</column>
     <column>更新結果_新規作成フラグ/update_result_is_created</column>
     <column>更新結果_エラーステータスコード/update_result_error_status_code</column>
     <column>更新結果_エラーメッセージ/update_result_error_message</column>
     <column>更新結果_行番号/update_result_row_number</column>
   </row>
   <row>
     :
   </row>
</table>
		

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

コンポーネント変数名	説明
insert_count	Salesforceに対して追加処理に成功したデータの件数を返します。
update_count	Salesforceに対して更新処理に成功したデータの件数を返します。
error_count	Salesforceに対して追加・更新処理に失敗したデータの件数を返します。
read_count	他のオペレーションから受け渡された入力データの件数を返します。
operation_api_exception_code	APIエラーが発生したときに、ExceptionCodeを返します。 APIエラー以外のエラーが発生した場合にはnullを返します。 バージョンにより、内容が変わる可能性があります。
operation_error_message	エラーが発生したときのエラーメッセージを返します。 バージョンにより、内容が変わる可能性があります。
operation_error_trace	エラーが発生したときのトレース情報を返します。 バージョンにより、内容が変わる可能性があります。

更新時のキー指定

結果取得使用例

• 使用例:「取引先」へのデータ書き込み(UPSERT)結果をCSVに出力します。
  
  

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

• 使用例:
  

スキーマの作成

テーブル情報の表示

トランザクション

注意事項

• 本オペレーションでは、データベースアダプタなどとは異なり、エラー発生時にロールバックすることができません。そのため、正常データは更新し、エラーデータは更新せずその情報をWARNレベルのログとして出力します。
  よって、データ単位でのエラー(制約違反や設定値不正など)が存在する場合、スクリプト内で例外監視処理によるエラーの検出を行なうことはできません。
  データ単位でのエラー情報を処理の中でデータとして使用したい場合、[削除結果取得有無]で[取得する]を選択し、後続の処理で結果データをエラーの検出などのハンドリングに使用してください。