tSalesforceConnectionの標準プロパティ - Cloud - 8.0

Salesforce

Version
Cloud
8.0
Language
日本語
Product
Talend Big Data
Talend Big Data Platform
Talend Data Fabric
Talend Data Integration
Talend Data Management Platform
Talend Data Services Platform
Talend ESB
Talend MDM Platform
Talend Real-Time Big Data Platform
Module
Talend Studio
Content
ジョブデザインと開発 > サードパーティーシステム > ビジネスアプリケーション > Salesforce
データガバナンス > サードパーティーシステム > ビジネスアプリケーション > Salesforce
データクオリティとプレパレーション > サードパーティーシステム > ビジネスアプリケーション > Salesforce
Last publication date
2024-04-15

これらのプロパティは、標準ジョブのフレームワークで実行されているtSalesforceConnectionを設定するために使われます。

標準tSalesforceConnectionコンポーネントは、ビジネスファミリーとCloudファミリーに属しています。

このフレームワーク内のコンポーネントは、すべてのTalend製品で使用できます。

基本設定

[Property Type] (プロパティタイプ)

接続の詳細を設定する方法を選択します。

  • [Built-In] (組み込み): このコンポーネントの接続の詳細がローカルに設定されます。関連するすべての接続のプロパティ値を手動で指定する必要があります。

  • [Repository] (リポジトリー): [Repository] (リポジトリー) > [Metadata] (メタデータ)で一元的に保存された接続の詳細が、このコンポーネントによって再使用されます。

    このチェックボックスの横にある [...] ボタンをクリックし、表示された [Repository Content] (リポジトリーのコンテンツ)ダイアログボックスで、再使用する接続の詳細を選択すると、関連するすべての接続のプロパティに値が自動的に入力されます。

[Connection type] (接続タイプ)

ドロップダウンリストから、接続のタイプを選択します。接続のプロパティは、選択した接続タイプによって異なります。

  • [Basic] (基本): Salesforceのユーザー名とパスワードを入力してSalesforceにアクセスするには、このオプションを選択します。

  • OAuth: OAuth (Open Authorization) 2.0プロトコルを使ってSalesforceにアクセスし、OAuth 2.0認証フロータイプとして[Json Web Token Flow] (Json Webトークンフロー)を使ってユーザーを認証するには、このオプションを選択します。このオプションを使用するためには、Salesforceで接続アプリケーションを作成し、Salesforce認証プロバイダーを設定する必要があります。

    OAuth認証フローの詳細は、Authenticate Apps with OAuthをご覧ください。

    Salesforceで接続アプリケーションを作成する方法は、接続アプリケーションを作成をご覧ください。

[User Id] (ユーザーID)

Salesforceのユーザー名。

このプロパティは、[Basic] (基本)接続タイプが選択されている場合のみ利用できます。

[Password] (パスワード)

ユーザー名に関連付けられたSalesforceのパスワード。

このプロパティは、[Basic] (基本)接続タイプが選択されている場合のみ利用できます。

[Security Token] (セキュリティトークン)

Salesforceのセキュリティトークン。詳細は、セキュリティトークンのリセットをご覧ください。

このプロパティは、[Basic] (基本)接続タイプが選択されている場合のみ利用できます。

[Issuer] (発行者)

接続アプリケーションが作成され、Salesforceの接続アプリケーションの詳細ページに表示される時に生成されるOAuthコンシューマーキー。詳細は、接続アプリケーションを作成をご覧ください。

このプロパティは、OAuth接続タイプが選択されている場合のみ利用できます。

[Subject] (件名)

Salesforceのユーザー名。

このプロパティは、OAuth接続タイプが選択されている場合のみ利用できます。

[Audience] (オーディエンス)

Json Webトークンのオーディエンス。

独自のJson Webトークンオーディエンスを設定できます。

このプロパティは、OAuth接続タイプが選択されている場合のみ利用できます。

[Expiration time (in seconds)] (有効期限(秒))

5分以内のアサーションの有効期限(秒)。

このプロパティは、OAuth接続タイプが選択されている場合のみ利用できます。

[Key store] (キーストア)

Java KeyStore (JKS)形式のキーストアファイルへのパス。

Keystoreファイルは、Salesforceによって署名された証明書を作成し、それをKeystoreにエクスポートすることで生成できます。詳細は、自己署名証明書の生成をご覧ください。

このプロパティは、OAuth接続タイプが選択されている場合のみ利用できます。

[KeyStore password] (KeyStoreパスワード)

Keystoreのパスワード。

このプロパティは、OAuth接続タイプが選択されている場合のみ利用できます。

[Certificate alias] (証明書の別名)

Salesforceによって署名された証明書の一意の名前。

このプロパティは、OAuth接続タイプが選択されている場合のみ利用できます。

[Mutual authentication] (相互認証)

このオプションを選択すると、Salesforceへの接続を確立するための相互認証を有効にできます。Salesforceでの相互認証の詳細は、Set Up a Mutual Authentication Certificateをご覧ください。

このオプションを使用する場合:

  • コンポーネント側でtSetKeystoreコンポーネントを使い、相互認証キーストアとキーストアパスワードを提供します。

  • メタデータ側で[Window] (ウィンドウ) > [Preferences] (基本設定) > Talend > [Security] (セキュリティ) > SSLと進み、対応するキーストア構成を設定します。

デフォルトでは、このオプションは選択されていません。

[Mutual auth keystore] (相互認証キーストア) (非推奨)

相互認証Keystoreファイル(キーと証明書を含むパスワードで保護されたファイル)へのパスを入力します。

このオプションは非推奨です。tSetKeystoreコンポーネントを使って相互認証キーストアとキーストアパスワードを提供することをお勧めします。

このオプションは、接続タイプが[Basic] (基本)で、[Mutual authentication] (相互認証)チェックボックスがオンになっている時に利用できます。

[Mutual auth keystore password] (相互認証Keystoreパスワード)

相互認証Keystoreファイルのパスワードを入力します。

このオプションは、接続タイプが[Basic] (基本)で、[Mutual authentication] (相互認証)チェックボックスがオンになっている時に利用できます。

詳細設定

Salesforce URL

Salesforceへの接続に必要なWebService URL。

警告: Salesforceの最近のバージョンで行われた大幅な変更のため、相互認証で[Basic] (基本)接続タイプを使用する場合は、ジョブの実行中にエラーが発生しないようエンドポイントを調整する必要があります。例: https://MyDomainName.my.salesforce.com:8443/services/Soap/u/57.0

[API version] (APIバージョン)

Salesforce APIバージョン。

このプロパティは、OAuth接続タイプが選択されている場合のみ利用できます。

[Bulk Connection] (バルク接続)

バルクデータ処理機能を使う必要がある場合は、このチェックボックスを選択します。

[Use or save the connection session] (接続セッションを使用または保存)

このチェックボックスをオンにして、[Session directory] (セッションディレクトリー)フィールドが表示されたら、保存または使用する接続セッションファイルへのパスを指定します。

このセッションファイルは、コンポーネントによって正しいユーザーIDが提供されている限り、異なる複数のジョブが共有して接続セッションを取得できます。このため、セッションを取得するためにサーバーに接続する必要はありません。

期限切れのセッションが検出された場合は、正しい接続情報(ユーザーID、パスワード、セキュリティキー)を入力すれば、コンポーネントはサーバーに接続して新しいセッション情報を取得し、接続セッションファイルをアップデートします。

このプロパティは、[Basic] (基本)接続タイプが選択されている場合のみ利用できます。

圧縮が必要

SOAPメッセージ圧縮を有効にする場合は、このチェックボックスを選択します。これにより、パフォーマンスが向上する場合があります。

[Use Http Chunked] (HTTP Chunkedを使用)

HTTP Chunkedデータ転送メカニズムを使う場合は、このチェックボックスを選択します。

このプロパティは、[Bulk Connection] (バルク接続)チェックボックスがオフの場合のみ利用できます。

[Trace HTTP message] (HTTPメッセージをトレース)

コンソールでのHTTPインタラクションを出力する場合は、このチェックボックスを選択します。

このプロパティは、[Bulk Connection] (バルク接続)チェックボックスがオンの場合のみ利用できます。

[Client Id] (クライアントID)

Salesforce Webサイトへのアクセスに同じアカウントとパスワードを使うユーザーを区別するには、実際のユーザーのIDを入力します。

[Timeout] (タイムアウト)

Salesforceでクエリータイムアウトの予定数をミリ秒で入力します。

[Use Proxy] (プロキシを使用)

SOCKSプロキシサーバーを使う場合は、このチェックボックスをオンにして、表示された[Host] (ホスト)[Port] (ポート)[User Id] (ユーザーID)[Password] (パスワード)フィールドで、SOCKSプロキシサーバーの接続パラメーターを指定します。

注: 許可されているタイプのプロキシ(HTTPプロキシ、HTTPSプロキシ、SOCKSプロキシ、FTPプロキシを含む)を使用するには、tSetProxyコンポーネントを使用します。

[tStatCatcher Statistics] (tStatCatcher統計)

このチェックボックスを選択すると、ジョブレベルおよび各コンポーネントレベルでジョブ処理メタデータが収集されます。

グローバル変数

ERROR_MESSAGE

エラー発生時にコンポーネントによって生成されるエラーメッセージ。これはAfter変数で、文字列を返します。

使用方法

使用ルール

このコンポーネントは、一般的に、他のSalesforceコンポーネントと共に使います。