tSalesforceOutputの標準プロパティ
これらのプロパティは、標準ジョブのフレームワークで実行されているtSalesforceOutputを設定するために使われます。
標準のtSalesforceOutputコンポーネントは、ビジネスファミリーとCloudファミリーに属しています。
このフレームワーク内のコンポーネントは、すべてのTalend製品で利用できます。
基本設定
[Property Type] (プロパティタイプ) |
接続の詳細を設定する方法を選択します。
[Connection Component] (接続コンポーネント)ドロップダウンリストから、他の接続コンポーネントを選択した場合、このプロパティは、利用できません。 |
[Connection Component] (接続コンポーネント) |
このコンポーネントで再利用するデータベース接続を開くコンポーネントを選択します。 |
[Connection type] (接続タイプ) |
ドロップダウンリストから、接続のタイプを選択します。接続のプロパティは、選択した接続タイプによって異なります。
|
[User Id] (ユーザーID) |
Salesforceのユーザー名。 このプロパティは、[Basic] (基本)接続タイプが選択されている場合のみ利用できます。 |
[Password] (パスワード) |
ユーザー名に関連付けられたSalesforceのパスワード。 このプロパティは、[Basic] (基本)接続タイプが選択されている場合のみ利用できます。 |
[Security Token] (セキュリティトークン) |
Salesforceのセキュリティトークン。詳細は、セキュリティトークンのリセット (英語のみ)をご覧ください。 このプロパティは、[Basic] (基本)接続タイプが選択されている場合のみ利用できます。 |
[Mutual authentication] (相互認証) |
このオプションを選択すると、Salesforceへの接続を確立するための相互認証を有効にできます。 このオプションは、[Connection type] (接続タイプ)ドロップダウンリストから、[Basic] (基本)を選択した場合に利用できます。 デフォルトでは、このオプションは選択されていません。 情報メモ注: このオプションは、TalendのR2021-04以降のStudioマンスリーアップデートをインストールした時のみ利用できます。詳細は管理者にお問い合わせください。
|
[Mutual auth keystore] (相互認証キーストア) |
相互認証Keystoreファイル(キーと証明書を含むパスワードで保護されたファイル)へのパスを入力します。 このオプションは、[Mutual authentication] (相互認証)が選択されている場合に使用できます。 情報メモ注: このオプションは、TalendのR2021-04以降のStudioマンスリーアップデートをインストールした時のみ利用できます。詳細は管理者にお問い合わせください。
|
[Mutual auth keystore password] (相互認証キーストアパスワード) |
相互認証Keystoreファイルのパスワードを入力します。 このオプションは、[Mutual authentication] (相互認証)が選択されている場合に使用できます。 情報メモ注: このオプションは、TalendのR2021-04以降のStudioマンスリーアップデートをインストールした時のみ利用できます。詳細は管理者にお問い合わせください。
|
[Issuer] (発行者) |
接続アプリケーションが作成され、Salesforceの接続アプリケーションの詳細ページに表示される時に生成されるOAuthコンシューマーキー。詳細は、接続アプリケーションを作成 (英語のみ)をご覧ください。 このプロパティは、[Json Web Token Flow] (Json Webトークンフロー)タイプが選択されている場合のみ利用できます。 |
[Subject] (件名) |
Salesforceのユーザー名。 このプロパティは、[Json Web Token Flow] (Json Webトークンフロー)タイプが選択されている場合のみ利用できます。 |
[Audience] (オーディエンス) |
Json Webトークンのオーディエンス。 独自のJson Webトークンオーディエンスを設定できます。 このプロパティは、[Connection type] (接続タイプ)ドロップダウンリストから、[OAuth]が、[Oauth2 flow type] (Oauth2フロータイプ)ドロップダウンリストから、[Json Web Token Flow] (Json Webトークンフロー)が選択されている場合のみ利用できます。 |
[Expiration time (in seconds)] (有効期限(秒)) |
5分以内のアサーションの有効期限(秒)。 このプロパティは、[Json Web Token Flow] (Json Webトークンフロー)タイプが選択されている場合のみ利用できます。 |
[Key store] (キーストア) |
Java KeyStore (JKS)形式のキーストアファイルへのパス。 Keystoreファイルは、Salesforceによって署名された証明書を作成し、それをKeystoreにエクスポートすることで生成できます。詳細は、自己署名証明書の生成 (英語のみ)をご覧ください。 このプロパティは、[Json Web Token Flow] (Json Webトークンフロー)タイプが選択されている場合のみ利用できます。 |
[KeyStore password] (KeyStoreパスワード) |
Keystoreのパスワード。 このプロパティは、[Json Web Token Flow] (Json Webトークンフロー)タイプが選択されている場合のみ利用できます。 |
[Certificate alias] (証明書の別名) |
Salesforceによって署名された証明書の一意の名前。 このプロパティは、[Json Web Token Flow] (Json Webトークンフロー)タイプが選択されている場合のみ利用できます。 |
[Client Id] (クライアントID) |
接続アプリケーションが作成され、Salesforceの接続アプリケーションの詳細ページに表示される時に生成されるOAuthコンシューマーキー。詳細は、接続アプリケーションを作成 (英語のみ)をご覧ください。 このプロパティは、[Implicit Flow] (Implicitフロー)タイプが選択されている場合のみ利用できます。 |
[Client Secret] (クライアントシークレット) |
接続アプリケーションが作成され、Salesforceの接続アプリケーションの詳細ページに表示される時に生成されるOAuthコンシューマーシークレット。詳細は、接続アプリケーションを作成 (英語のみ)をご覧ください。 このプロパティは、[Implicit Flow] (Implicitフロー)タイプが選択されている場合のみ利用できます。 |
[Callback Host] (コールバックホスト) |
接続アプリケーションの作成中に定義され、Salesforceの接続アプリケーション詳細ページのAPI (OAuth設定の有効化)エリアに表示されるOAuth認証コールバックURLのホスト値。 このプロパティは、[Implicit Flow] (Implicitフロー)タイプが選択されている場合のみ利用できます。 |
[Callback Port] (コールバックポート) |
接続アプリケーションの作成中に定義され、Salesforceの接続アプリケーション詳細ページのAPI (OAuth設定の有効化)エリアに表示されるOAuth認証コールバックURLのポート値。 このプロパティは、[Implicit Flow] (Implicitフロー)タイプが選択されている場合のみ利用できます。 |
[Token File] (トークンファイル) |
認証なしでのアクセストークンの取得に使う更新トークンを保管するトークンファイルへのパス。 このプロパティは、[Implicit Flow] (Implicitフロー)タイプが選択されている場合のみ利用できます。 |
[Module Name] (モジュール名) |
フィールドの横にある[...]ボタンをクリックし、表示されたダイアログボックスで、使われるモジュールを選択します。または、[Use custom object] (カスタムオブジェクトの使用)チェックボックスをオンにして、[Object Name] (オブジェクト名)フィールドにモジュール名を指定します。 |
[Schema] (スキーマ)と[Edit schema] (スキーマを編集) |
スキーマとは行の説明のことです。処理して次のコンポーネントに渡すフィールド(カラム)数を定義します。Sparkジョブを作成する場合、フィールドの命名時は予約語のlineを避けます。 スキーマを変更するには[Edit schema] (スキーマを編集)をクリックします。現在のスキーマがリポジトリータイプの場合は、3つのオプションを利用できます。
ジョブで接続している先行コンポーネントからスキーマを取得するためには、[Sync columns] (カラムを同期)をクリックします。 このコンポーネントは、ダイナミックスキーマ機能の利点を備えているので、ソースファイルから不明なカラムを取得したり、各カラムを個別にマッピングしなくてもソースからカラムを一括してコピーしたりできます。ダイナミックスキーマの詳細は、Talend Studioユーザーガイドをご覧ください。 ダイナミックスキーマ機能は、モジュールの不明なカラムを取得するしくみになっており、その他の目的には使用しないことをお勧めします。モジュールの作成には推奨しません。 |
[Output Action] (出力アクション) |
ドロップダウンリストから、実行する次のいずれかの操作を選択します。
|
詳細設定
Salesforce URL |
Salesforceへの接続に必要なWebService URL。 |
[API version] (APIバージョン) |
Salesforce APIバージョン。 このプロパティは、OAuth接続タイプが選択されている場合のみ利用できます。 |
[Use or save the connection session] (接続セッションを使用または保存) |
このチェックボックスをオンにして、[Session directory] (セッションディレクトリー)フィールドが表示されたら、保存または使用する接続セッションファイルへのパスを指定します。 このセッションファイルは、コンポーネントによって正しいユーザーIDが提供されている限り、異なる複数のジョブが共有して接続セッションを取得できます。このため、セッションを取得するためにサーバーに接続する必要はありません。 期限切れのセッションが検出された場合は、正しい接続情報(ユーザーID、パスワード、セキュリティキー)を入力すれば、コンポーネントは、サーバーに接続して新しいセッション情報を取得し、接続セッションファイルをアップデートします。 このプロパティは、[Basic] (基本)接続タイプが選択されている場合のみ利用できます。 |
[Need compression] (圧縮が必要) |
SOAPメッセージ圧縮を有効にする場合は、このチェックボックスを選択します。これにより、パフォーマンスが向上する場合があります。 |
[Use Http Chunked] (HTTP Chunkedを使用) |
HTTP Chunkedデータ転送メカニズムを使う場合は、このチェックボックスを選択します。 |
[Client Id] (クライアントID) |
Salesforce Webサイトへのアクセスに同じアカウントとパスワードを使うユーザーを区別するには、実際のユーザーのIDを入力します。 |
[Timeout] (タイムアウト) |
Salesforceでクエリータイムアウトの予定数をミリ秒で入力します。 |
[Use Proxy] (プロキシを使用) |
SOCKSプロキシサーバーを使う場合は、このチェックボックスをオンにして、表示された[Host] (ホスト)、[Port] (ポート)、[User Id] (ユーザーID)、[Password] (パスワード)フィールドで、SOCKSプロキシサーバーの接続パラメーターを指定します。 情報メモ注: 許可されているタイプのプロキシ(HTTPプロキシ、HTTPSプロキシ、SOCKSプロキシ、FTPプロキシを含む)を使用するには、tSetProxyコンポーネントを使用します。
|
[Relationship mapping for upsert] (リレーションシップマッピングのUPSERT) |
[+]ボタンをクリックして、必要に応じて行を追加し、入力フローの外部IDフィールド、アップサートモジュールのルックアップリレーションシップフィールド、ルックアップモジュール、ルックアップモジュールの外部IDフィールドを指定します。
このプロパティは、[Output Action] (出力アクション)ドロップダウンリストから、[UPSERT] (アップサート)が選択されている場合のみ利用できます。 |
[Extend Insert] (挿入を延長) |
出力データをバッチで転送するには、このチェックボックスを選択します。表示される[Commit Level] (コミットレベル)フィールドで、バッチごとの行数を指定します。 |
[Die on error] (エラー発生時に強制終了) |
このチェックボックスを選択すると、エラー発生時にジョブの実行が停止されます。 このチェックボックスはデフォルトでオフになっています。すなわち、エラーが発生した行をスキップし、エラーが発生していない行のプロセスを完了させます。 |
IDの取得 |
このチェックボックスを選択すると、挿入またはアップデートされたレコードのSalesforce IDがSalesforceから返されます。 このチェックボックスは、Output ActionドロップダウンリストでINSERTまたはUPSERTが選択されていて、[Extend Insert] (挿入を延長)チェックボックスがオフの場合にのみ使えます。 このチェックボックスがオンで、tSalesforceOutputコンポーネントが 接続を介して別のコンポーネントにリンクされている場合、次のカラムがデータフローのスキーマに追加されます。
|
[Ignore Null] (Nullを無視) |
NULL値を無視するには、このチェックボックスを選択します。 このプロパティは、[Output Action] (出力アクション)ドロップダウンリストから、[UPDATE] (アップデート)または[UPSERT] (アップサート)が選択されている場合のみ利用できます。 |
ログファイル名 |
すべてのエラーログを保持するログファイルへのパスを指定します。 |
[Use UTC time for datetime] (datetimeにUTC時間を使用) |
datetime型のデータにUTC時間を使用する場合は、このオプションを選択します。このオプションが選択されていない場合はローカルタイムが使用されます。 情報メモ注: このオプションは、TalendのR2021-10以降のStudioマンスリーアップデートをインストール済みである場合のみ利用できます。詳細は管理者にお問い合わせください。
|
[tStatCatcher Statistics] (tStatCatcher統計) |
このチェックボックスを選択すると、ジョブレベルおよび各コンポーネントレベルでジョブ処理メタデータが収集されます。 |
グローバル変数
NB_LINE |
処理された行数。これはAfter変数で、整数を返します。 |
NB_SUCCESS |
正しく処理された行数。これはAfter変数で、整数を返します。 |
NB_REJECT |
リジェクトされた行数。これはAfter変数で、整数を返します。 |
ERROR_MESSAGE |
エラー発生時にコンポーネントによって生成されるエラーメッセージ。これはAfter変数で、文字列を返します。 |
使用方法
使用ルール |
このコンポーネントは、終了コンポーネントまたはジョブまたはサブジョブの中間コンポーネントとして使え、常に入力リンクが必要です。 |