Salesforce 出力接続

メモ

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 アクセスの管理」を参照してください。

Salesforce 外部接続を使用して、別の Salesforce 組織から CRM Analytics にデータを同期します。

出力ノードを備えた Salesforce 出力コネクタの仕組み

CRM Analytics Salesforce 出力コネクタを使用すると、レシピの結果を任意の Salesforce 組織に書き込んで、詳細な分析を行ったり、ビジネスの自動化で使用したり、アクセスを拡張したりできます。Salesforce 組織への出力コネクタを設定したら、データプレップを使用してレシピを作成します。出力ノードをレシピに追加し、Salesforce 出力接続を選択し、ノードでオブジェクト、対応付け、その他の設定を行います。レシピが実行されると、CRM Analytics は現在サポートされているオブジェクトへの出力データセットを挿入、更新、または更新/挿入できます。

OAuth 用の外部クライアントアプリケーションの設定

外部クライアントアプリケーション (ECA) はシングルサインオン (SSO) を提供し、OAuth プロトコルを使用して外部接続を承認します。

メモ

接続を設定するユーザーに割り当てられていない別の Salesforce ユーザーアカウントを作成することをお勧めします。ユーザーのアカウントは、ユーザーが組織を離れたときに無効化され、そのアカウントで作成された接続が機能しなくなる可能性があります。

1. 組織の ECA を作成するには、Salesforce の [設定] ページから、[クイック検索] ボックスに「外部」と入力し、[外部クライアントアプリケーションマネージャー] を選択します。
2. [新規外部クライアントアプリケーション] をクリックします。
3. 基本情報を入力します。
   1. 外部クライアントアプリケーションマネージャーに表示する ECA の名前を入力します。
   2. プログラムからアプリケーションを参照するときに使用する API 参照名を入力します。この項目のデフォルトは、スペースの代わりにアンダースコアを使用したアプリケーション名のバージョンです。
   3. Salesforce がアプリケーション提供者またはそのサポートチームへの連絡時に使用する連絡先メールを入力します。
   4. [配信状態] で [ローカル] を選択します。
4. ［Enable OAuth］ をクリックして、OAuth ポリシーを設定します。
5. アプリケーション設定を入力します。
   1. コールバック URL を入力します。コールバック URL は、コードを埋め込むアプリケーション URL であり、この URL で Salesforce ECA から返された認証を受け入れることができます。コールバック URL の例として、https://<3p-domain>/callback.html があります。
   2. [OAUTH 範囲] で、[Manage user data via APIs (api) (APIS を使用してユーザーデータを管理 (api))] と [Access Analytics REST API resources (wave_api)] を選択します。他の OAuth が必要な場合は、必要に応じて他の範囲を選択します。詳細は、「OAuth トークンおよび範囲」を参照してください。
6. [フローの有効化] で、[クライアントログイン情報フローを有効化] を選択します。このフローでは、サーバー間のやりとりが可能です。詳細は、「サーバー間インテグレーションの OAuth 2.0 クライアントログイン情報フロー」を参照してください。
7. [セキュリティ] で、[サポートされる認証フローの Require Proof Key for Code Exchange (PKCE) extension (コード交換の証明キー (PKCE) 拡張機能が必要)] を無効にします。
8. [作成] をクリックします。
9. [ポリシー] タブで、[編集] をクリックします。OAuth フローと外部クライアントアプリケーションの機能強化の場合、[Enable Client Credentials Flow (クライアントログイン情報フローを有効化)] が有効になっていることを確認します。[別のユーザーとして実行] のユーザーメールを入力します。このユーザーは有効な実行ユーザーである必要があります。
10. [設定] タブで、[コンシューマー鍵と秘密] をクリックして値をコピーして保存します。クライアント ID にはコンシューマー鍵の値、クライアントの秘密にはコンシューマーの秘密の値が必要です。

Salesforce 出力コネクタの有効化と追加

1. [設定] から、[クイック検索] ボックスに「Analytics」と入力し、[Analytics] を選択して [設定] を選択します。
2. [Salesforce 出力接続を有効化] を選択して、変更内容を保存します。
3. データマネージャーで、[接続] タブをクリックします。
4. [新しい接続] をクリックします。
5. [出力] をクリックします。
6. [Salesforce 出力コネクタ] を選択します。
7. 接続設定を入力します。
8. [保存 & テスト] をクリックします。[保存 & テスト] をクリックすると、ソースへの接続が試行されて設定が検証されます。接続に失敗すると、考えられる理由が CRM Analytics に表示されます。

特に明記されていない限り、すべての設定で値が必要です。

https://mycompany.my.salesforce.com/services/Soap/u/34.0

Salesforce データの転送

Salesforce 出力コネクタを設定してから、Salesforce 組織に転送するデータをマージして変換するためのデータプレップレシピを作成します組織。出力ノードを追加して、Salesforce 出力コネクタを使用するように設定します。

1. [出力接続] への書き込みを選択します (1)。
2. 作成した Salesforce 出力接続の接続名を選択します (2)。
3. 対象 Salesforce オブジェクトを選択します (3)。コネクタの設定に使用するユーザー ID で使用できるオブジェクトのリストが表示されます。サポートされるオブジェクトは、考慮事項に記載されています。
4. 挿入 (新規レコードを追加)、更新 (既存のレコードのデータを変更)、更新/挿入 (新規レコードを追加して既存のレコードを更新) のいずれかを選択します。(4)
5. 更新/挿入する場合は、外部 ID が一意のレコード識別子として機能する項目を対象オブジェクトから選択します。(5) デフォルトの外部 ID は、接続済みオブジェクトの ID 項目です。
6. レシピ列を対応する Salesforce オブジェクト列に対応付けます。(6) 出力ノードを適用するには、すべての列が対応付けられている必要があります。ID は更新と更新/挿入の場合にのみ対応付けられます。
7. [適用] を選択します。
8. レシピを保存します。

Salesforce 出力コネクタの考慮事項

Salesforce 出力コネクタやデータプレップレシピの出力ノードを使用する場合は、次の点に注意してください。

• 失敗した実行または部分的な失敗の実行をトラブルシューティングするには、「Investigate Unsuccessful Salesforce Output Connector Runs (失敗した Salesforce 出力コネクタの実行の調査)」を参照してください。
• 出力接続はレシピごとに複数回使用できますが、各出力ノードでは異なるオブジェクトを使用する必要があります。各出力ノードでは、コネクタの実行あたりの制限まで個別に使用できますが、24 時間周期の制限の対象にはなります。
• 出力接続は、データプレップで作成されたレシピでのみ使用できます。
• このコネクタでは、親-子リレーションの親または子であるオブジェクトはサポートされていません。連動関係のある 2 つのカスタムオブジェクトがある場合は、ヘッダーレコードを手動で挿入し、ヘッダー ID を取得してから、取得した情報を使用して詳細レコードを挿入します。
• 共有記述子は、レコードへのアクセス権を持つ任意のユーザーまたはグループの ID です。リリース元組織からリリース先組織への出力には含まれていません。
• このコネクタでは、次の目的での挿入、更新、更新/挿入がサポートされます。
  • カスタムオブジェクト
  • Salesforce オブジェクト:
    • Account
    • AccountContactRelationship
    • AccountForecast
    • AccountProductForecast
    • AccountProductPeriodForecast
    • AccountForecastPeriodMetrics
    • AccountTeamMember
    • Activities
    • AdvAccountForecastFact
    • AdvAccountForecastSetPartner
    • Asset
    • Campaign
    • CampaignMember
    • Cases
    • ContactPointAddress
    • ContactPointEmail
    • ContactPointPhone
    • Contacts
    • CurrencyType
    • Event
    • Leads
    • ObjectTerritory2Association
    • Opportunity
    • OpportunityLineItem
    • OpportunityLineItemSchedule
    • OpportunityTeamMember
    • Order
    • OrderItem
    • Product2
    • ProgramRebateTypPayoutSrc
    • RebateMemberProductAggregate
    • RebateProgramMemberPayout
    • RebateProgramPayoutPeriod
    • Task
    • TransactionJournal
  • Salesforce Industries オブジェクト:
    • AccountServicePreference (Health Cloud)
    • Claim (Automotive Cloud、Financial Services Cloud、Manufacturing Cloud)
    • ClaimItem (Automotive Cloud、Financial Services Cloud、Manufacturing Cloud)
    • QuoteLineItem (Commerce Cloud)
    • SalesAgreement (Manufacturing Cloud)
    • Visit (Consumer Goods Cloud)
• null 基準値を Salesforce に出力するには、「null 基準の処理の有効化」を参照してください。null ディメンション値を出力するには、null が含まれるディメンション列ごとにバケット変換を追加し、[null 値をバケット化] を選択して値を [なし] に設定します。