Data Foundation 向け Salesforce アクセス
Data Foundationは、接続したすべてのシステムのデータを、インスタンスの数に関係なく、1 つの Common Finance Model に集約します。Salesforce は、Data Foundation が直接読み取るシステムの 1 つです。Salesforce は元帳ではなく CRM ソースであり、顧客、製品、営業パイプラインを提供しますが、総勘定元帳の仕訳は提供しません。このページは、アクセスを設定する Salesforce 管理者と、管理者に依頼する PlaidCloud ユーザーを対象としています。
PlaidCloud はデータを読み取るだけです。パスワードやセキュリティトークンをメールで送らないでください。
アクセス依頼を送信する
Section titled “アクセス依頼を送信する”プロジェクトの Foundation タブで、新しい接続を作成を選択し、Salesforce を選びます。フォームに依頼内容の全文が表示されます。リクエストをコピーをクリックして自分のメッセージに貼り付けるか、リクエストをメールで送信をクリックして、件名「Read-only Salesforce access for PlaidCloud (OAuth 2.0 client credentials)」でメールプログラムに開きます。
Salesforce 管理者が設定する内容
Section titled “Salesforce 管理者が設定する内容”-
Setup > Apps > External Client Apps > New で External Client App を作成します。組織にまだ Connected App がある場合は、Connected App でも構いません。
- OAuth 設定を有効にし、Enable Client Credentials Flow のみにチェックを入れます（認可コードフローとパスワードフローは使用しません）。
- OAuth scope: Manage user data via APIs (
api) - Run As: 専用の統合ユーザー（手順 2）
-
次の内容を持つプロファイルまたは権限セットを統合ユーザーに付与します。
- API Enabled
- Account（Account Number フィールドを含む）、Product2、Opportunity、OpportunityLineItem、Organization（デフォルト通貨用）への Read
- View All Data、またはレポート対象のすべての商談を参照できる共有設定
PlaidCloud が読み取れるすべての行とフィールドは、このユーザーが参照できる範囲に Salesforce によって制限されます。
-
アプリから Consumer Key（クライアント ID）と Consumer Secret を、組織の My Domain URL（例:
https://yourcompany.my.salesforce.com）とともにコピーします。
返送する情報
Section titled “返送する情報”| 管理者が送る情報 | PlaidCloud での入力先 |
|---|---|
| My Domain URL | My Domain URL |
| クライアント ID（Consumer Key） | クライアントID |
| クライアントシークレット（Consumer Secret）。メールではなく、セキュアな接続フォーム経由 | クライアントシークレット |
エンティティの名前には、その Salesforce 組織のパイプラインが属するエンティティを入力します。組織には一覧表示できるエンティティがありません。1 つの組織は 1 つのエンティティなので、2 つの組織は 2 つの接続になります。
アクセスを確認する
Section titled “アクセスを確認する”PlaidCloud に戻って、接続をテストをクリックします。各データセットは、読み取り可能、権限が不足しています、エラーのいずれかで表示されます。
| データセット | Salesforce で読み取る内容 |
|---|---|
| 顧客 | Account |
| 製品 | Product2 |
| パイプライン | Opportunity と OpportunityLineItem（アカウント番号を含む） |
3 つとも省略可能です。いずれかが権限が不足していますと表示された場合は、管理者に、そのオブジェクトの読み取りアクセスを統合ユーザーに追加するよう依頼して、もう一度テストしてください。
パイプラインの金額は、商談の通貨で表されます。通貨を 1 つだけ使用している組織にはそのようなフィールドがないため、PlaidCloud は Organization のデフォルト通貨を使用し、それがない場合はエンティティの通貨を使用します。