Salesforce Bulk クラウドデータソース

Salesforce Bulk クラウドデータソースは現在アーリーアクセス中で、選ばれた顧客のみが利用可能です。Salesforce Bulkを始めるには、Tealiumサポートに連絡してください。

クラウドデータソースの構成の一般的な概要については、クラウドデータソースの管理を参照してください。

動作原理

Salesforce Bulk クラウドデータソースは、Salesforce Bulk API 2.0を使用して、Salesforce組織からデータを読み取ります。

Salesforceは、SQLデータベースではなく、オブジェクトとフィールドとしてデータを整理するクラウドデータソースです。Salesforceからデータをインポートするとき、Tealiumは選択したオブジェクトからの各レコードをイベントとして処理します。

Salesforce Bulk データソースは、スケジュールされたバッチモデルを使用します：

• スケジュール頻度：時刻、日次、週次のスケジューリングをサポートします。
• 自動データ読み取り：各スケジュール実行は、前回の実行以降のすべての新しいデータを読み取ります。

データタイプ

データが正しくインポートされるように、以下のガイドラインに従ってSalesforceフィールドタイプをマッピングしてください：

Salesforceフィールドタイプの詳細については、Salesforce: カスタムフィールドタイプを参照してください。

接続の作成

Salesforceに接続するには、再利用可能な接続構成を作成します。接続構成には、名前と選択した認証方法に依存する認証フィールドが含まれます。

次の OAuth 2.0 認証方法が利用可能です。

キーペア

サーバー間通信にキーペア方法を使用します。このフローでは、認証リクエストに署名するために証明書を使用し、ユーザーのログインは必要ありませんが、接続されたアプリの事前承認が必要です。Tealiumはキーペアを生成し、認証リクエストにプライベートキーを使用して署名します。対応する証明書をSalesforce Connected Appにアップロードします。アプリは署名されたJWTをSalesforceトークンエンドポイントに送信します。Salesforceは署名を検証し、アプリが事前に承認されている場合、アクセストークンを発行します。詳細については、Salesforce: OAuth 2.0 JWT bearer flowを参照してください。

キーペアを使用して接続を作成するには：

1. 認証方法としてキーペアを選択します。
2. コンシューマーキーフィールドに、証明書を登録した接続アプリのコンシューマーキーを入力します。
3. ユーザー名フィールドに、あなたのSalesforceユーザー名を入力します。
4. キーペア追加をクリックし、キーペア生成を選択します。既存のキーペアを再利用するか、プライベートキーファイルをアップロードすることもできます。
5. 生成されたキーペア証明書ファイルをダウンロードします。
6. ダウンロードした証明書を接続アプリに適用します。
7. 完了をクリックして接続を保存します。

Salesforce OAuth

統合サーバーが秘密を安全に保管できる場合は、Salesforce OAuth方法を使用します。ユーザーがアクセスを承認し、サーバーは認証コードとトークンを交換します。詳細については、Salesforce: OAuth 2.0 web server flowを参照してください。

Salesforce OAuthを使用して接続を作成するには：

1. 認証方法としてSalesforce OAuthを選択します。
2. アカウントタイプを選択して、接続に使用するSalesforceエンドポイントを指定します。
3. 接続確立をクリックします。
4. 開いたSalesforceログイン画面で、ユーザー名とパスワードを入力します。
5. ログインに成功すると、承認ページにリダイレクトされます。Tealiumアプリへのアクセスを許可します。
6. 完了をクリックして接続を保存します。

OAuth

ユーザーログインが不要なサーバー間統合には、OAuth方法を使用します。Tealiumは消費者キーと秘密をSalesforce OAuthトークンエンドポイントに送信します。Salesforceは資格情報を検証し、割り当てられた統合ユーザーの代わりにアクセストークンを返します。Tealiumはこのトークンを使用してSalesforce APIを呼び出します。詳細については、Salesforce: OAuth 2.0 client credentials flowを参照してください。

OAuthを使用して接続を作成するには：

1. 認証方法としてOAuthを選択します。
2. ベースURLフィールドに、SalesforceホストURLを入力します。
3. コンシューマーキーフィールドに、外部クライアントアプリのコンシューマーキーを入力します。
4. コンシューマーシークレットフィールドに、外部クライアントアプリのコンシューマーシークレットを入力します。
5. 完了をクリックして接続を保存します。

クエリ構成

一般的な概要については、クラウドデータソースについてを参照してください。

Salesforce Bulkデータソースについては、以下の点に注意してください：

• インクリメンティング、タイムスタンプ + インクリメンティング、およびタイムスタンプクエリモード：これらのクエリモードはサポートされていません。代わりにオフセットカラムを指定してください。オフセットカラムは、単調に増加する値を持つ日付または日時フィールド（例：CreatedDateまたはLastModifiedDate）でなければなりません。コネクタはこのカラムを使用して進行状況を追跡し、重複読み取りを避けます。
• 高度なクエリモード：SQLではなく、Salesforce Object Query Language (SOQL)を使用してクエリを記述します。

許可するIPアドレス

Salesforce組織がIPアドレスによるAPIアクセスを制限している場合は、Tealium IPアドレスをSalesforceの信頼できるIP範囲に追加してください。