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

オペレーション名

データ書き込み(DELETE)

機能概要

SOAP API の delete() を使用してデータを削除します。

 

delete() では、対象となる各レコードの ID を指定する必要があります。

ただし、本コンポーネントでは ID 以外の項目をキーとして指定することができます。この場合、ID を取得するため入力データの値をもとに query() が実行されます。

 

入力データに対するレコードごとの結果は出力スキーマから受け取ることができます。

 

= 備考 =

本オペレーションが使用するAPI仕様については、コネクションリソースで選択したバージョンのAPIドキュメントを以下のリンク先ページより参照してください。

  • 「Salesforce Developer Documentation」-(https://developer.salesforce.com/docs)

    • SOAP API Developer's Guide

データモデル

本コンポーネントのデータモデルはテーブルモデル型です。

プロパティ

= 備考 =

変数の使用については、「変数」を参照してください。

基本設定

項目名

必須/省略可

変数の使用

説明

備考

名前

必須

使用不可

スクリプトキャンバス上での名前を入力します。

 

入力データ

必須

使用不可

スクリプトキャンバス上にあるコンポーネントを選択します。

 

必須設定

項目名

必須/省略可

変数の使用

説明

備考

接続先

必須

使用不可

コネクションリソースを選択します。

[追加]

新規にコネクションリソースを追加します。

[一覧の編集]

> HULFT INTEGRATE > コネクションで、コネクションリソースの設定を編集することができます。

 

テーブル名

必須

使用不可

Salesforceのテーブル名を選択します。

 

ソート

必須

使用不可

項目一覧を選択した方法で並び替えます。

[選択昇順]
[選択降順]
[ラベル昇順]
[ラベル降順]
[API昇順]

(デフォルト)

[API降順]
[型昇順]
[型降順]

 

項目一覧

必須

-

[テーブル名]で選択したSalesforceテーブル内の項目一覧を表示します。

追加可能な項目のみ表示されます。

項目一覧/選択

省略可

使用不可

[スキーマ定義]として選択する列のチェックボックスにチェックを入れます。

 

項目一覧/ラベル

必須

使用不可

[テーブル名]で選択したテーブルの列のラベル名を表示します。

 

項目一覧/API

必須

使用不可

[テーブル名]で選択したテーブルの列のAPI名を表示します。

 

項目一覧/型

必須

使用不可

[テーブル名]で選択したテーブルの列のデータ型を表示します。

 

スキーマ定義

必須

-

スキーマ定義として選択したテーブルの列の一覧が表示されます。

 

スキーマ定義/ラベル

必須

使用不可

スキーマ定義として選択したテーブルの列のラベル名を表示します。

 

スキーマ定義/API

必須

使用不可

スキーマ定義として選択したテーブルの列のAPI名を表示します。

 

スキーマ定義/型

必須

使用不可

スキーマ定義として選択したテーブルの列のデータ型を表示します。

 

プロパティアクション

項目名

説明

備考

↓選択

[項目一覧/選択]列にチェックがある項目を[スキーマ定義]に設定します。

 

オプション設定

項目名

必須/省略可

変数の使用

説明

備考

カラム名タイプ

必須

使用不可

マッピングでスキーマを表示する際のカラム名の表示タイプを選択します。

[ラベル]

Salesforceで定義されたラベル名(項目名)で表示します。

[API]

(デフォルト)

Salesforceで定義されたAPI参照名で表示します。

 

バッチサイズ

必須

使用可

Salesforceに対してデータ書き込み処理を行う際のバッチサイズを入力します。

  • デフォルト値は「200」です。

  • 「1」以上「200」以下が値が指定できます。範囲以外の値が指定された場合、エラーが発生します。

  • 使用環境によりますが、一般的にバッチサイズを大きくすることにより、データの書き込み効率は向上します。

注意

Salesforceコネクターの仕様として、1,000件のデータを書き込むケースで、バッチサイズを200と設定した場合、書き込み処理を5回に分けて実行します。

削除結果取得有無

必須

使用不可

Salesforceに対してデータ書き込み処理を行った結果を取得するかどうかを指定します。

[取得する]

(デフォルト)

データ書き込み処理を行った結果を取得します。

[取得しない]

データ書き込み処理を行った結果を取得しません。

  • [取得する]を選択した場合、スキーマ定義に指定した項目および結果情報の項目をテーブルモデル型のデータとして後続の処理に受け渡すことができます。

  • 取得する情報については、「スキーマ」を参照してください。

コメント

項目名

必須/省略可

変数の使用

説明

備考

コメント

省略可

使用不可

このコネクターの簡単な説明を記述することができます。

 

スキーマ

入力スキーマ

[スキーマ定義]の設定により、カラム数が異なります。

= 備考 =

スキーマ構造については、「テーブルモデル型 」を参照してください。

出力スキーマ

[スキーマ定義]で設定されたカラムに、削除結果の情報が付与されます。

(以下、「ラベル/API」という形式で表記)

<?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>

要素名

列名(ラベル/API)

説明

備考

row

-

入力スキーマに渡されたデータを元に処理されたデータ件数分繰り返します。

例えば、1件の入力データから2件のレコードを削除した場合、2回繰り返します。

  • [削除結果取得有無][取得しない]とした場合、0件となります。

注意

データ型の不一致など不整合なデータが存在した場合、入力データ順と出力データ順は必ずしも一致しません。[削除結果_行番号/delete_result_row_number]を順序条件とすることで、後続のMapperで入力データ順にソートすることができます。

column

削除結果_ID/delete_result_id

SalesforceのIDを出力します。

 

削除結果_成功フラグ/delete_result_is_success

成功フラグを出力します。

  • [true]:処理に成功しました。

  • [false]:処理に失敗しました。[削除結果_エラーステータスコード/delete_result_error_status_code]および[削除結果_エラーメッセージ/delete_result_error_message]を確認してください。

 

削除結果_エラーステータスコード/delete_result_error_status_code

SalesforceのAPIが返すステータスコードを出力します。

  • 以下の場合はSalesforceコネクターがコードおよびメッセージを出力します。

    • 「SALESFORCE_ADAPTER_ILLEGAL_DATA_TYPE」

      コネクションリソースの種類がAPI 23.0以前の場合、定義された項目の属性と入力データ型が一致しない場合に設定されます。たとえば、「double」と定義された項目に対し数値以外の文字列が入力された場合などです。

    • 「SALESFORCE_ADAPTER_DATA_NOT_FOUND」

      [スキーマ定義][キー]にID以外の項目を含む場合において、Salesforceへ検索を行ったが対象データが存在しなかった場合に設定されます。

削除結果_エラーメッセージ/delete_result_error_message

SalesforceのAPIが返すメッセージを出力します。

削除結果_行番号/delete_result_row_number

入力スキーマに渡されたデータ内のノードの位置に基づいて番号を出力します。

 

Mapperでのスキーマ読み込み

スキーマは自動で読み込まれます。

= 備考 =

詳細については、「スキーマ編集」を参照してください。

大容量データ処理

大容量データ処理に対応していません。

トランザクション

トランザクションはサポートしていません。

PSPでの使用について

PSPでは使用できません。

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

コンポーネント変数名

説明

備考

delete_count

削除処理に成功したデータの件数が格納されます。

  • デフォルト値はnullです。

error_count

削除処理に失敗したデータの件数が格納されます。

  • デフォルト値はnullです。

read_count

入力データの件数が格納されます。

  • デフォルト値はnullです。

not_exist_count

削除対象のデータが存在しなかった入力データの件数が格納されます。

  • デフォルト値はnullです。

  • 以下の条件に該当しなかった場合、値が格納されません。

    • [削除結果取得有無][取得する]を選択している

    • [スキーマ定義]にて選択した項目(キー)にID以外の項目を含んでいる

server_url

ログイン後のエンドポイントURLが格納されます。

  • デフォルト値はnullです。

session_id

セッションIDが格納されます。

  • デフォルト値はnullです。

message_category

エラー発生時、発生したエラーに対応するメッセージコードのカテゴリが格納されます。

  • デフォルト値はnullです。

message_code

エラー発生時、発生したエラーに対応するメッセージコードのコードが格納されます。

  • デフォルト値はnullです。

message_level

エラー発生時、発生したエラーに対応するメッセージコードの重要度が格納されます。

  • デフォルト値はnullです。

operation_api_exception_code

APIエラー発生時、発生したエラーのExceptionCodeが格納されます。

  • デフォルト値はnullです。

  • APIエラー以外のエラー発生時は、値が格納されません。

operation_error_message

エラー発生時、発生したエラーのメッセージが格納されます。

  • デフォルト値はnullです。

operation_error_trace

エラー発生時、発生したエラーのトレース情報が格納されます。

  • デフォルト値はnullです。

メッセージコード、例外メッセージ、制限事項

コネクター

メッセージコード

エラーメッセージ

制限事項

Salesforce(旧) コネクターのメッセージおよび制限事項

check

check

check