項目名 |
必須/省略可 |
変数の使用 |
説明 |
備考 |
接続先 |
必須 |
使用不可 |
グローバルリソースを選択します。
グローバルリソースの設定方法については、「グローバルリソースのプロパティ」を参照してください。
- [追加]:
新規にグローバルリソースを追加します。
- [一覧の編集]:
「リソース一覧の編集」画面にて、グローバルリソースの設定を編集することができます。
|
|
テーブル名 |
必須 |
使用不可 |
Salesforceのテーブル名を選択します。 |
|
スキーマ定義 |
必須 |
- |
Salesforceに対して書き込みを行う項目を設定します。 |
Salesforceに対して書き込みが必要な項目に限定(不要な項目をスキーマ定義から除く)することにより、処理効率が向上します。
|
スキーマ定義/ラベル |
必須 |
使用不可 |
[テーブル名]で指定したテーブルの列のラベル名を表示します。 |
|
スキーマ定義/API |
必須 |
使用不可 |
[テーブル名]で指定したテーブルの列のAPI名を表示します。 |
|
スキーマ定義/型 |
必須 |
使用不可 |
[テーブル名]で指定したテーブルの列のデータ型を表示します。 |
|
リレーションシップ項目定義 |
省略可 |
- |
スキーマ定義にリレーション項目が存在する場合、外部キーによる更新を行うための項目を設定します。
リレーション先オブジェクトの外部キー項目を選択することにより、リレーション関係を持たせたデータの受け渡しが可能となります。 |
API 14.0以降で使用可能です。API 7.0では使用できません。
詳細については、「リレーションシップ項目定義」を参照してください。
|
リレーションシップ項目定義/元項目API名 |
必須 |
使用不可 |
[テーブル名]で指定したテーブルのリレーション項目の列のAPI名を表示します。 |
|
リレーションシップ項目定義/リレーションシップ名 |
必須 |
使用不可 |
[テーブル名]で指定したテーブルのリレーション項目の列のリレーションシップ名を表示します。 |
|
リレーションシップ項目定義/オブジェクトAPI名 |
省略可 |
使用不可 |
[テーブル名]で指定したテーブルのリレーション項目の列のリレーション先のオブジェクトのAPI名を選択します。 |
|
リレーションシップ項目定義/リレーション用カラムAPI名 |
省略可 |
使用不可 |
[テーブル名]で指定したテーブルのリレーション項目の列のリレーション先オブジェクトの外部キー項目を選択します。 |
- 省略した場合、リレーション先オブジェクトの該当レコードのIDを受け渡す仕様となります。
|
項目名 |
必須/省略可 |
変数の使用 |
説明 |
備考 |
カラム名タイプ |
必須 |
使用不可 |
マッピングでスキーマを表示する際のカラム名の表示タイプを選択します。
- [ラベル]:
Salesforceで定義されたラベル名(項目名)で表示します。
- [API]:(デフォルト)
Salesforceで定義されたAPI参照名で表示します。
|
|
バッチサイズ |
必須 |
使用可 |
Salesforceに対してデータ書き込み処理を行う際のバッチサイズを入力します。 |
- デフォルト値は「200」です。
- 「1」以上「200」以下の値が指定できます。範囲以外の値が指定された場合、エラーが発生します。
- 使用環境によりますが、一般的にバッチサイズを大きくすることにより、データの書き込み効率は向上します。
Salesforceアダプタの仕様として、10,000件のデータを書き込むケースで、バッチサイズを200と設定した場合、書き込み処理を50回に分けて実行します。
|
挿入結果取得有無 |
必須 |
使用不可 |
Salesforceに対してデータ書き込み処理を行った結果を取得するかどうかを指定します。
- [取得する]:(デフォルト)
データ書き込み処理を行った結果を取得します。
- [取得しない]:
データ書き込み処理を行った結果を取得しません。
|
- [取得する]を選択した場合、スキーマ定義に指定した項目および結果情報の項目をテーブルモデル型のデータとして後続に受け渡すことができます。
取得する情報については、「スキーマ」を参照してください。
使用例については、「結果取得使用例」を参照してください。
|
Base64項目入力形式 |
必須 |
使用不可 |
データ型がBase64である項目に対しての入力データ形式を指定します。
- [Base64データ]:(デフォルト)
Base64データを入力します。
- [ファイルパス]:
ファイルパスを入力します。
|
|
要素名 |
列名(ラベル/API) |
説明 |
備考 |
row |
- |
入力スキーマに渡されたデータ件数分繰り返します。 |
- [挿入結果取得有無]を[取得しない]とした場合、0件となります。
データ型の不一致など不整合なデータが存在した場合、入力データ順と出力データ順は必ずしも一致しません。[挿入結果_行番号/insert_result_row_number]を順序条件とすることで、後続のMapperで入力データ順にソートすることができます。
|
column |
挿入結果_ID/insert_result_id |
SalesforceのIDを出力します。 |
|
挿入結果_成功フラグ/insert_result_is_success |
成功フラグを出力します。
- [true]:処理に成功しました。
- [false]:処理に失敗しました。[挿入結果_エラーステータスコード/insert_result_error_status_code]および[挿入結果_エラーメッセージ/insert_result_error_message]を確認してください。
|
|
挿入結果_エラーステータスコード/insert_result_error_status_code |
SalesforceのAPIが返すステータスコードを出力します。 |
|
挿入結果_エラーメッセージ/insert_result_error_message |
SalesforceのAPIが返すメッセージを出力します。 |
|
挿入結果_行番号/insert_result_row_number |
入力スキーマに渡されたデータ内のノードの位置に基づいて番号を出力します。 |
|
コンポーネント変数名 |
説明 |
備考 |
insert_count |
追加処理に成功したデータの件数が格納されます。 |
|
error_count |
追加処理に失敗したデータの件数が格納されます。 |
- デフォルト値はnullです。
- 1件のデータに対して複数のエラーメッセージがAPIより返された場合、1件とカウントします。
|
read_count |
入力データの件数が格納されます。 |
|
server_url |
ログイン後のエンドポイントURLが格納されます。 |
|
session_id |
セッションIDが格納されます。 |
|
message_category |
エラー発生時、発生したエラーに対応するメッセージコードのカテゴリが格納されます。 |
|
message_code |
エラー発生時、発生したエラーに対応するメッセージコードのコードが格納されます。 |
|
message_level |
エラー発生時、発生したエラーに対応するメッセージコードの重要度が格納されます。 |
|
operation_api_exception_code |
APIエラー発生時、発生したエラーのExceptionCodeが格納されます。 |
- デフォルト値はnullです。
- APIエラー以外のエラー発生時は、値が格納されません。
DataSpider Cloudのバージョンにより、格納される内容が変わる可能性があります。
|
operation_error_message |
エラー発生時、発生したエラーのメッセージが格納されます。 |
- デフォルト値はnullです。
DataSpider Cloudのバージョンにより、格納される内容が変わる可能性があります。
|
operation_error_trace |
エラー発生時、発生したエラーのトレース情報が格納されます。 |
- デフォルト値はnullです。
DataSpider Cloudのバージョンにより、格納される内容が変わる可能性があります。
|
例外名 |
原因 |
対策 |
ResourceNotFoundException リソース定義が見つかりませんでした。名前:[] |
[接続先]が指定されていません。 |
[接続先]を指定してください。 |
ResourceNotFoundException リソース定義が見つかりませんでした。名前:[<グローバルリソース名>] |
[接続先]で選択されたリソース定義が見つかりません。 |
[接続先]で指定したグローバルリソースを確認してください。 |
java.net.UnknownHostException |
グローバルリソースで指定したPROXYサーバが見つからない例外です。 |
PROXYサーバの状態を確認して下さい。または、[接続先]で指定したグローバルリソースの[Proxyホスト]を確認してください。 |
java.net.SocketTimeoutException connect timed out
|
Salesforceに接続中にタイムアウトが発生しました。 |
ネットワークの状態、Salesforceのサーバの状態を確認してください。または、[接続先]で指定したグローバルリソースの[Connectionタイムアウト(秒)]を確認してください。 |
java.net.SocketTimeoutException Read timed out
|
Salesforceに接続後、サーバからの応答までにタイムアウトが発生しました。 |
ネットワークの状態、Salesforceのサーバの状態を確認してください。または、[接続先]で指定したグローバルリソースの[タイムアウト(秒)]を確認してください。 |
jp.co.headsol.salesforce.adapter.exception.SalesforceAdapterIllegalArgumentException |
Salesforceアダプタのプロパティの設定値が不正です。 |
エラーメッセージを確認し、設定内容をご確認ください。 |
com.sforce.soap.partner.fault.LoginFault |
Salesforceへのログインに失敗しました。 |
ExceptionCodeまたは、エラーメッセージを確認し、Salesforceの関連ドキュメントなどに対象のエラーに関する情報がないか確認してください。 |
com.sforce.soap.partner.fault.UnexpectedErrorFault |
Salesforceへの処理実行中に、予期しない例外が発生しました。 |
ExceptionCodeまたは、エラーメッセージを確認し、Salesforceの関連ドキュメントなどに対象のエラーに関する情報がないか確認してください。 |