項目名 |
必須/省略可 |
変数の使用 |
説明 |
備考 |
接続先 |
必須 |
使用不可 |
グローバルリソースを選択します。
グローバルリソースの設定方法については、「グローバルリソースのプロパティ」を参照してください。
- [追加]:
新規にグローバルリソースを追加します。
- [一覧の編集]:
「リソース一覧の編集」画面にて、グローバルリソースの設定を編集することができます。
|
|
テーブル名 |
必須 |
使用不可 |
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が返すステータスコードを出力します。 |
- 以下の場合はSalesforceアダプタがコードおよびメッセージを出力します。
- 「SALESFORCE_ADAPTER_ILLEGAL_DATA_TYPE」
定義された項目の属性と入力データ型が一致しない場合に設定されます。たとえば、「double」と定義された項目に対し数値以外の文字列が入力された場合などです。
|
挿入結果_エラーメッセージ/insert_result_error_message |
SalesforceのAPIが返すメッセージを出力します。 |
挿入結果_行番号/insert_result_row_number |
入力スキーマに渡されたデータ内のノードの位置に基づいて番号を出力します。 |
|
コンポーネント変数名 |
説明 |
備考 |
insert_count |
追加処理に成功したデータの件数が格納されます。 |
|
error_count |
追加処理に失敗したデータの件数が格納されます。 |
|
read_count |
入力データの件数が格納されます。 |
|
server_url |
ログイン後のエンドポイントURLが格納されます。 |
|
session_id |
セッションIDが格納されます。 |
|
message_category |
エラー発生時、発生したエラーに対応するメッセージコードのカテゴリが格納されます。 |
|
message_code |
エラー発生時、発生したエラーに対応するメッセージコードのコードが格納されます。 |
|
message_level |
エラー発生時、発生したエラーに対応するメッセージコードの重要度が格納されます。 |
|
operation_api_exception_code |
APIエラー発生時、発生したエラーのExceptionCodeが格納されます。 |
- デフォルト値はnullです。
- APIエラー以外のエラー発生時は、値が格納されません。
- DataSpider Servistaのバージョンにより、格納される内容が変わる可能性があります。
|
operation_error_message |
エラー発生時、発生したエラーのメッセージが格納されます。 |
- デフォルト値はnullです。
- DataSpider Servistaのバージョンにより、格納される内容が変わる可能性があります。
|
operation_error_trace |
エラー発生時、発生したエラーのトレース情報が格納されます。 |
- デフォルト値はnullです。
- DataSpider Servistaのバージョンにより、格納される内容が変わる可能性があります。
|
例外名 |
原因 |
対策 |
ResourceNotFoundException リソース定義が見つかりませんでした。名前:[] |
[接続先]が指定されていません。 |
[接続先]を指定してください。 |
ResourceNotFoundException リソース定義が見つかりませんでした。名前:[<グローバルリソース名>] |
[接続先]で選択されたリソース定義が見つかりません。 |
[接続先]で指定したグローバルリソースを確認してください。 |
java.net.UnknownHostException |
グローバルリソースで指定したPROXYサーバが見つからない例外です。 |
PROXYサーバの状態を確認して下さい。または、[接続先]で指定したグローバルリソースの[Proxyホスト]を確認してください。 |
org.apache.commons.httpclient.HttpConnection$ConnectionTimeoutException |
Salesforceに接続中にタイムアウトが発生しました。 |
ネットワークの状態、Salesforceのサーバの状態を確認してください。または、[接続先]で指定したグローバルリソースの[Connectionタイムアウト(秒)]を確認してください。 |
org.apache.commons.httpclient.HttpRecoverableException 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の関連ドキュメントなどに対象のエラーに関する情報がないか確認してください。 |