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

オペレーション名

機能概要

• 「Salesforce Developer Documentation」-(https://developer.salesforce.com/docs)
  • SOAP API Developer's Guide

データモデル

プロパティ

基本設定

必須設定

項目名	必須/省略可	変数の使用	説明	備考
接続先	必須	使用不可	グローバルリソースを選択します。 グローバルリソースの設定方法については、「グローバルリソースのプロパティ」を参照してください。 [追加]: 新規にグローバルリソースを追加します。 [一覧の編集]: 「リソース一覧の編集」画面にて、グローバルリソースの設定を編集することができます。
テーブル名	必須	使用不可	Salesforceのテーブル名を選択します。
スキーマ定義	必須	-	Salesforceのデータを削除する際のキーとなる項目を設定します。	詳細については、「削除時のキー指定」を参照してください。
スキーマ定義/ラベル	必須	使用不可	[テーブル名]で指定したテーブルの列のラベル名を表示します。
スキーマ定義/API	必須	使用不可	[テーブル名]で指定したテーブルの列のAPI名を表示します。
スキーマ定義/型	必須	使用不可	[テーブル名]で指定したテーブルの列のデータ型を表示します。

プロパティアクション

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

オプション設定

プロパティアクション

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

データ処理方式

コメント

スキーマ

入力スキーマ

出力スキーマ

<?xml version="1.0" encoding="UTF-8" ?>
<table>
  <row>
    <column>[スキーマ定義]で設定されたラベル/API</column>
       :
    <column>削除結果_ID/delete_result_id</column>
    <column>削除結果_成功フラグ/delete_result_is_success</column>
    <column>削除結果_エラーステータスコード/delete_result_error_status_code</column>
    <column>削除結果_エラーメッセージ/delete_result_error_message</column>
    <column>削除結果_行番号/delete_result_row_number</column>
  </row>
  <row>
    :
  </row>
</table>

Mapperでのスキーマ読み込み

大容量データ処理

トランザクション

PSPでの使用について

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

削除時のキー指定

• [スキーマ定義]でIDのみを選択した場合
  入力データのIDを元にDELETEを行います。IDは対象のオブジェクトを問い合わせて取得することができます。


• [スキーマ定義]でID以外の項目を選択した場合
  入力データの値が一致する行からIDを取得するため、Salesforceに対してクエリー検索を行います。
  クエリー検索で取得したIDを元にDELETEを行います。
  存在しない場合、DELETEは行われません。
  クエリー検索は、入力データの値をもとに作成したSOQLがSalesforceによるSOQLの文字数制限を超えると、複数回に分けて行います。

結果取得使用例

• 例:「取引先(Account)」へのデータ書き込み(UPSERT)の更新結果をCSVファイルに出力します。
  
  
  
  

  画像内の番号	名称	説明	備考
  (1)	入力データイメージ	取引先(Account)へ更新するための入力データイメージです。 ここでは、[外部キー]は「AccountCode__c」とします。
  (2)	取引先(Account)への更新の設定	ここでは、データ書き込み(UPSERT)のアイコンにて設定を行います。
  (3)	処理結果のデータ取得有無の設定	ここでは、[オプション設定]タブの[更新結果取得有無]にて「取得する」を選択します。
  (4)	スクリプトイメージ	本説明のスクリプト実装イメージです。
  (5)	結果データイメージ	取引先(Account)へ更新した際の結果データを取得してCSVファイル出力した結果データイメージです。

スキーマの作成

テーブル情報の表示

仕様制限

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


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


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

主な例外

注意事項

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


• 次の API バージョンにおいて、[書き込み方法]を[更新]とし、[スキーマ定義/キー]でID以外にtrueとした項目がある場合、または[書き込み方法]を[更新と追加]とした場合に、 キーとして指定した項目に java の Integer 型の精度を超える数値を入力すると、データの検索実行時に[MALFORMED_QUERY]エラーが発生します。
  
  • API 7.0
  • API 14.0
  • API 18.0
  • API 23.0
  
  キーを異なる項目とするか、上記より新しい API バージョンを使用してください。
  


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