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

オペレーション名

機能概要

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


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


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

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

データモデル

プロパティ

基本設定

必須設定

項目名	必須/省略可	変数の使用	説明	補足
接続先	必須	使用不可	グローバルリソースを選択します。 グローバルリソースの設定方法については「グローバルリソースのプロパティ」を参照してください。 [追加]: 新規にグローバルリソースを追加します。 [一覧の編集]: 「リソース一覧の編集」プロパティにて、グローバルリソースの設定を編集することができます。	以下のAPIが使用可能です。 API7.0 API14.0 API18.0
テーブル名	必須	使用不可	Salesforceのテーブル名を選択します。
スキーマ定義	必須	-	Salesforceに対して書き込みを行う項目を設定します。	Salesforceに対して書き込みが必要な項目に限定(不要な項目をスキーマ定義から除く)することにより、処理効率が向上します。
スキーマ定義/ラベル	必須	使用不可	[テーブル名]で指定したテーブルの列のラベル名を表示します。
スキーマ定義/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/insert_result_id</column>
     <column>挿入結果_成功フラグ/insert_result_is_success</column>
     <column>挿入結果_エラーステータスコード/insert_result_error_status_code</column>
     <column>挿入結果_エラーメッセージ/insert_result_error_message</column>
     <column>挿入結果_行番号/insert_result_row_number</column>
   </row>
   <row>
     :
   </row>
</table>
		

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

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

トランザクション

結果取得使用例

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

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

• 使用例:
  

スキーマの作成

テーブル情報の表示

注意事項

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