詳細情報:
Salesforce 外部接続
Salesforce 外部コネクタを使用して、別の Salesforce 組織からのデータを CRM Analytics に同期します。外部コネクタでは、サーバー間の通信に OAuth 2.0 が必要です。
Summer '27 以降、SOAP API バージョン 31.0 ～ 64.0 の SOAP API login() コールはサポートされなくなり、使用できなくなります。詳細は、「SOAP API バージョン 31.0 ~ 64.0 での SOAP API login（） コールの廃止」を参照してください。
Summer '26 以降、SOAP は外部コネクタでサポートされなくなります。
すべての新しい外部コネクタでは、認証に [クライアント ID] と [クライアントの秘密] を使用した OAuth 設定を使用する必要があります。ユーザー名とパスワードの設定は使用されなくなりました。組織権限で SOAP API login() が有効になっている場合、これらの設定を持つ既存の接続子を使用できます。既存のコネクタを SOAP から OAuth に更新することはできません。新しい接続を作成する必要があります。
制限された API アクセスは、Salesforce 出力コネクタおよび外部コネクタではサポートされていません。コネクタを作成したユーザーに対して「任意の API クライアントを使用」権限を有効にしてください。詳細は、「API アクセスの管理」を参照してください。
CRM Analytics から Salesforce 組織にデータを転送するには、Salesforce 出力接続を使用します。
OAuth 用の外部クライアントアプリケーションの設定
外部クライアントアプリケーション (ECA) はシングルサインオン (SSO) を提供し、OAuth プロトコルを使用して外部接続を承認します。
- 組織の ECA を作成するには、Salesforce の [設定] ページから、[クイック検索] ボックスに「外部」と入力し、[外部クライアントアプリケーションマネージャー] を選択します。
- [新規外部クライアントアプリケーション] をクリックします。
- 基本情報を入力します。
- 外部クライアントアプリケーションマネージャーに表示する ECA の名前を入力します。
- プログラムからアプリケーションを参照するときに使用する API 参照名を入力します。この項目のデフォルトは、スペースの代わりにアンダースコアを使用したアプリケーション名のバージョンです。
- Salesforce がアプリケーション提供者またはそのサポートチームへの連絡時に使用する連絡先メールを入力します。
- [配信状態] で [ローカル] を選択します。
- ［Enable OAuth］ をクリックして、OAuth ポリシーを設定します。
- アプリケーション設定を入力します。
- コールバック URL を入力します。コールバック URL は、コードを埋め込むアプリケーション URL であり、この URL で Salesforce ECA から返された認証を受け入れることができます。コールバック URL の例として、
https://<3p-domain>/callback.htmlがあります。 - [OAUTH 範囲] で、[Manage user data via APIs (api) (APIS を使用してユーザーデータを管理 (api))] と [Access Analytics REST API resources (wave_api)] を選択します。他の OAuth が必要な場合は、必要に応じて他の範囲を選択します。詳細は、「OAuth トークンおよび範囲」を参照してください。
- コールバック URL を入力します。コールバック URL は、コードを埋め込むアプリケーション URL であり、この URL で Salesforce ECA から返された認証を受け入れることができます。コールバック URL の例として、
- [フローの有効化] で、[クライアントログイン情報フローを有効化] を選択します。このフローでは、サーバー間のやりとりが可能です。詳細は、「サーバー間インテグレーションの OAuth 2.0 クライアントログイン情報フロー」を参照してください。
- [セキュリティ] で、[サポートされる認証フローの Require Proof Key for Code Exchange (PKCE) extension (コード交換の証明キー (PKCE) 拡張機能が必要)] を無効にします。
- [作成] をクリックします。
- [ポリシー] タブで、[編集] をクリックします。OAuth フローと外部クライアントアプリケーションの機能強化の場合、[Enable Client Credentials Flow (クライアントログイン情報フローを有効化)] が有効になっていることを確認します。[別のユーザーとして実行] のユーザーメールを入力します。このユーザーは有効な実行ユーザーである必要があります。
- [設定] タブで、[コンシューマー鍵と秘密] をクリックして値をコピーして保存します。クライアント ID にはコンシューマー鍵の値、クライアントの秘密にはコンシューマーの秘密の値が必要です。
接続の作成
- [データマネージャー接続] タブで、[新しい接続] をクリックします。
- [Salesforce External Connector]を選択し、[Next]をクリックします。
- コネクタ設定を入力します。
- 設定を確認するには、[Save & Test (保存 & テスト)] をクリックします。接続に失敗すると、考えられる理由が CRM Analytics に表示されます。
特に明記されていない限り、すべての設定で値が必要です。
| 接続設定 | 説明 |
|---|---|
| 接続名 | 異なる接続を区別しやすい規則を使用します。 |
| API 参照名 | 接続の API 参照名。この名前にスペースを含めることはできません。API 参照名は、この接続を介して抽出されたデータをレシピで参照するために使用します。接続の作成後に API 参照名を変更することはできません。 |
| 説明 | コネクタの説明。 |
| 認証種別 | サポートされる認証種別。有効な値は OAuth です。 |
| ユーザー名 | Summer '26 以降サポートされなくなりました。 外部 Salesforce 組織への接続に使用するユーザー名。 認証種別が [パスワード] の場合は必須です。 |
| Password (パスワード) | Summer '26 以降サポートされなくなりました。 [ユーザー名] で指定したユーザーのパスワード。セキュリティ設定に応じて、パスワードの最後にユーザーのセキュリティトークンを追加します。セキュリティトークンの取得についての詳細は、「セキュリティトークンのリセット」を参照してください。 認証種別が [パスワード] の場合は必須です。 |
| クライアント ID | OAuth 接続に必要なクライアント ID。 この値は、外部クライアントアプリケーションのコンシューマー鍵です。 |
| クライアントの秘密 | OAuth 接続に必要なクライアントの秘密。 この値は、外部クライアントアプリケーションのコンシューマーの秘密です。 |
| API Type (API 種別) | 使用する API。オプションは、SOAP API の場合は SOAP、Salesforce Bulk API 2.0 の場合は BULKV2 (デフォルト) です。SOAP API で大きなデータオブジェクトがタイムアウトする問題が発生した場合は、Salesforce Bulk API 2.0 を使用してください。 |
| Service URL (サービス URL) | Summer '26 以降サポートされなくなりました。 外部組織のログイン URL。デフォルト値では、組織の一般的な Salesforce ログイン URL が使用されます。セキュリティレイヤーを追加した場合は、この項目を更新して、組織の [私のドメイン] ログイン URL を使用するようにします。本番組織では、https://<MyDomainName.my .salesforce.com/services/Soap/Identifier/VersionNumber.0 の形式を使用します。 次に例を示します。 |
| ドメインの URL | 外部 Salesforce 組織に必要な [私のドメイン] の URL。外部 Salesforce 組織で、[設定] の [私のドメイン] に移動します。URL 形式は https://*.salesforce.com である必要があります |
CRM Analytics に同期するデータの絞り込み
検索条件を使用して、CRM Analytics 検索条件との同期から不要なデータや機密データを除外します。検索条件では、必要なデータのみを CRM Analytics に取り込むことで、データ同期を高速化します。
- データマネージャーから、[接続] タブをクリックします。
- 絞り込むオブジェクトに関連付けられた接続を選択します。
- 絞り込むオブジェクトの名前をクリックします。
- [データ同期検索条件] をクリックします。
- 検索条件を入力します。
- [保存] をクリックします。
Salesforce 外部コネクタの場合、『SOQL および SOSL リファレンス』の説明に従って、SOQL WHERE 句式を使用して検索条件を入力します。たとえば、"(FiscalQuarter = 2 OR
FiscalQuarter = 3) AND Amount > 1000 AND Amount <= 20000" です。
Salesforce 外部コネクタの考慮事項
Salesforce 外部コネクタを使用するときは、次の点に留意してください。
- 接続済みオブジェクト名は、先頭が文字で、文字、数字、またはアンダースコアのみが含まれている必要があります。名前の末尾をアンダースコアにすることはできません。
- 項目名に使用できるのは、英数字、ドット、アンダースコア、またはダッシュのみです。項目名にスペースや括弧などの他の文字が含まれていると、同期に失敗します。
- コネクタは、デフォルトでオブジェクトあたり最大 1 億行または 50 GB のいずれか先に制限に達したものを同期できます。この制限は、Salesforce サポートへの要求に応じて最大 2000 万行または 1000 GB まで増やすことができます。コネクタを使用する場合、Salesforce Government Cloud組織のデータは高度な暗号化を使用して転送中に保護され、接続済みオブジェクトごとに最大1,000万行または5 GBのいずれか先に制限に達したものを同期できます。
- データ同期時間を短縮するには、増分同期 (ベータ) を使用します。
- 接続に使用するユーザーのセキュリティ設定によって、外部組織で同期できるオブジェクトと項目が決まります。
- API バージョン 34.0 以降で使用可能な標準オブジェクトを同期できます。
- API 種別 BULKV2 は、API バージョン 50.0 以降でのみ使用できます。
- Salesforce 組織間の接続の問題をトラブルシューティングするには、組織の IP アドレスの制限を確認し、両方の組織で [セッションをその接続元の IP アドレスにロック] 設定を無効にすることを検討してください。Knowledge記事や既知の問題を検索して詳細を確認することもできます。
- 通貨を含む項目をインポートする場合、インポートした値は変換されません。米国ドルの値を記録するローカル組織にインポートする英国ポンドの値を記録する組織の例を見てみましょう。10 (GBP) の値は、10 の値としてローカル組織にインポートされます。
