はじめに
Domo SalesforceコネクターはDomoとSalesforceを統合し、APIが有効なSalesforceのバージョン（現在はEnterpriseとUnlimited）からデータを抽出します。DomoとSalesforceの間で接続を確立するには、APIが有効になっているユーザーが、まずSalesforceで認証し、それからDomoにデータへのアクセスを許可する必要があります。その後、Salesforceのデータにもとづいたレポートを編集できるようになります。SalesforceのUpsertコネクターは、DataSetのスケジュールを設定するためにUpsertモードとAppend/Replaceモードをサポートします。Salesforce APIの詳細については、以下のいずれかを参照してください。- https://www.salesforce.com/developer/docs/api/
- http://resources.docs.salesforce.com…_reference.pdf
- https://developer.salesforce.com/doc…data_model.htm
| 主な使用事例 | このコネクターはSalesforceのAPI対応版からのリード、パイプラインのアクティビティといったデータの取り込みに適しています。 |
| 主なメトリクス |
|
| 社内における主な権限 | Salesforceには幅広い機能があり、営業、マーケティング、人事、事務、財務、ITをはじめとする多くの部門、そして、アナリスト、営業担当、マネージャー、VPなどといった多様な職務で活用できます。すべてSalesforceの実装方法、作成するオブジェクトやモジュールによって異なります。 |
| 平均導入時間 | オブジェクト、レポート、データサイズによって異なりますが、Salesforceの導入は非常に迅速に完了します。必要な項目を特定したら、数分でデータを取り込むことができます。数百万行もあるような非常に大規模なデータの取り込みには、約1時間かかります。 |
| 使いやすさ（1～10の段階。1が「最も使いやすい」） | 4 |
ベストプラクティス
［Object Browser］モードでは、Salesforceが関連オブジェクト（オポチュニティー、取引先など）を含むため、各関連オブジェクトのフィールドを同じDataSetに持ち込むことができます。この結果、事あるごとに様々なオブジェクト（オポチュニティーオブジェクトと取引先オブジェクトという別々のオブジェクト）を個別に取り込み、DataFlowに結合するという必要がなくなります。必要条件
Salesforceアカウントに接続してDataSetを作成するには、以下が必要です。- Salesforceアカウントのユーザー名とパスワード
- Salesforce AppExchangeからインストールしたDomoコネクターパッケージ（2018年8月1日以降は必須。インストール手順については次のセクションを参照）
Domoコネクターパッケージをインストールする
Salesforce AppExchangeにある「Domoコネクターパッケージ」を使用して、Salesforceユーザーは、SalesforceのデータをDomoにインポートできます。この手順に沿ってAppExchangeからコネクターパッケージをダウンロードし、インストールします。 DomoのSalesforce管理パッケージをインストールするには：- Salesforceにログインします。
-
Salesforce AppExchange（ https://appexchange.salesforce.com ）に移動し、「Domo Connector Package」を検索してクリックします。
- お客様は、次のリンクを使用して直接パッケージにアクセスできます。 https://login.salesforce.com/packaging/installPackage.apexp?p0=04t1I000001ymKN
- サンドボックス組織にインストールする場合は、URLの最初の部分を http://test.salesforce.com に置き換える必要があります。または、 https://appexchange.salesforce.com/a…A00000EcrsyUAB に直接移動することもできます。
-
［Get It Now］ をクリックします。
-
インストール先として実稼働環境かサンドボックスを選択します。
- 「I have read and agree to the terms and conditions.」というチェックボックスをオンにします。
-
［Confirm and Install］ をクリックします。
-
［Install for All Users］ タイルをクリックします。
インストールを確認する
DomoのSalesforce管理パッケージ検証ツールを使い、Salesforce管理パッケージが正しくインストールされていることを確認します。 インストールを確認するには：- DomoのData CenterまたはAppstoreのコネクターページで「Salesforce Managed Package」を検索し、アイコンをダブルクリックします。
- お客様は、次のリンクを使用して直接パッケージにアクセスできます。 https://login.salesforce.com/packaging/installPackage.apexp?p0=04t1I000001ymKN
-
サンドボックス組織にインストールする場合は、URLの最初の部分を http://test.salesforce.com に置き換える必要があります。
-
［Get the Data］ をクリックします。
-
［認証情報］ でSalesforceのアカウント名を選択し、 ［Next］ をクリックします。
-
［詳細］ で ［Next］ をクリックします。
-
［Update］ メニューで ［Manually］ を選択し、 ［Next］ をクリックします。
-
DataSetに名前をつけて、［Save］ をクリックします。
Salesforceアカウントに接続する
このセクションではUpsert対応のSalesforceコネクターページの［認証情報］と［Data Selection］ペインのオプションについて説明します。このページのほかのペインの項目である ［スケジュール設定］ や ［DataSetに名前を付け、説明を入力］ に関しては、ほとんどのタイプのコネクターで共通しています。詳細については、「 コネクターを使用してDataSetを追加する 」を参照してください。［認証情報］ペイン
Upsert対応のDomo Salesforceコネクターは、接続にOAuthを使用しており、Domo内で認証情報を入力する必要はありません。［Salesforce環境］メニューで環境を選択し、［接続］をクリックしてSalesforceのログイン画面を開きます。ここで、Salesforceのユーザー名とパスワードを入力できます。有効なSalesforceの認証情報を一度入力しておくと、随時同じアカウントを利用して新しいSalesforce Upsert DataSetを作成できます。コネクターのアカウントはData Centerの ［アカウント］ タブで管理できます。このタブの詳細については、「 コネクターのユーザーアカウントを管理する 」を参照してください。［Data Selection］ペイン
このペインには、メインメニュー ［How Do You Want to Select Your Salesforce Data］ のほかにも様々なメニューがあり、選択したレポートタイプに応じて表示されたりされなかったりします。メニュー | 説明 |
|---|---|
How Do You Want to Select Your Salesforce Data? | Salesforceからデータを引き出すとき使う方法を選択します。以下の方法があります。
|
| Type of Records to Retrieve | 検索対象をアクティブなレコードのみに絞るか、削除済みレコードも含めるかを選択します。 |
| Unique Field to Retrieve More Than 2000 Rows | レポートの各行にユニーク値を含むフィールドを選択します。2,000行を超えるデータを取得するために使用されます。 |
Query Option | 定義済みクエリ（ ［Sales Performance］ または ［User Images］ ）を選択するか、自分自身のクエリを作成します（ ［Custom］ ）。 |
Query | ここにはSalesforceのSOQLクエリを入力します。例： SELECT Account FROM Account SOQLクエリ記述の詳細については、 http://www.salesforce.com/us/developer/docs/officetoolkit/Content/sforce_api_calls_soql.htm を参照してください。 |
| Reset Schema | データ内の列をリセットするオプションを選択します。一般的には、選択したフィールドまたはカスタムクエリを変更するときは、2番目のオプションを選択することになります。その後、DataSetを実行し、最初のオプションに切り替えて、以後の実行時にはスキーマを維持し、データタイプで問題が生じないようにすることになります。 |
その他のペイン
スケジュール設定、再試行、更新に関するオプションなど、コネクターインターフェースのその他のペインに表示されるオプションについては、「 コネクターを使用してDataSetを追加する 」を参照してください。トラブルシューティング
Salesforceは全体的には非常に安定したコネクターで、Salesforceに特有の問題はほぼありません。問題の大半は権限不足（オブジェクトとフィールドの両方）が原因です。Salesforceの管理者は、特定のオブジェクトとフィールドをアップグレードできる必要があります。 よくあるエラーとしてもう1つ、「クエリロケーターエラー」というものがあります。Salesforceでは、1人のユーザーに対して同時に維持するクエリロケーターは最大10個であり、最長で15分間しか維持しません。同時に実行するDataSetが多すぎると、一部が失敗します。この問題を防ぐ最善の方法は、DataSetを適量ずつ分散させて実行することです。よくある質問
このコネクターでは、どのバージョンのSalesforce APIが使用されますか？
このコネクターでは、どのバージョンのSalesforce APIが使用されますか？
このコネクターは、Salesforce APIのバージョン46.0（ https://{customer instance}.salesforce.com/services/data/v46.0 ）を使用しています。
各レポートコールによってこのコネクターで呼び出されるのはどのエンドポイントですか？
各レポートコールによってこのコネクターで呼び出されるのはどのエンドポイントですか？
| レポート名 | エンドポイントURL（1つまたは複数） |
|---|---|
| オブジェクトとフィールドを参照 | /query |
| クエリ | /query |
| 表形式のレポート | /analytics/reports/{reportId}/describe |
| 共有ルールと設定 | /knowledgeManagement/settings |
このコネクターを作成するにはどのような認証情報が必要ですか？
このコネクターを作成するにはどのような認証情報が必要ですか？
認証するSalesforce環境とSalesforceアカウントに関連付けられたメールアドレスとパスワードを選択する必要があります。
Salesforceアカウントの認証情報が保護されていることをどのようにして確認できますか？
Salesforceアカウントの認証情報が保護されていることをどのようにして確認できますか？
ログインプロセスではOAuthプロセスが使用されるため、DomoによってSalesforceの認証情報が表示または保存されることはありません。これにより、ログインの安全性が保たれます。Domoのアカウントへのアクセスはいつでも取り消すことができます。
「INVALID\_QUERY\_LOCATOR」エラーが継続的に発生します。どのように修正すればよいですか？
「INVALID\_QUERY\_LOCATOR」エラーが継続的に発生します。どのように修正すればよいですか？
Salesforceでは、ユーザーは一度に最大10個のクエリを実行できます。DataSetの実行が拡大されていることを確認してください。
「QUERY\_TIMEOUT」エラーが継続的に発生します。どのように修正すればよいですか？
「QUERY\_TIMEOUT」エラーが継続的に発生します。どのように修正すればよいですか？
SOQLクエリが2万字の文字数制限を超えているか、スクリプトフィールドが多すぎる場合、このエラーが発生します。この問題を解決するには、クエリを簡略化する必要があります。
レポートのドロップダウンメニューにレポートが表示されないのはなぜですか？
レポートのドロップダウンメニューにレポートが表示されないのはなぜですか？
レポートをコネクターに表示させ、データを取り込む前に、レポートを表フォーマットにして公開する必要があります。
SalesforceコネクターとUpsert対応のSalesforceコネクターの違いは何ですか？
SalesforceコネクターとUpsert対応のSalesforceコネクターの違いは何ですか？
Upsert対応のSalesforceコネクターでは、更新された行をすべて置き換えるMergeモードや、新しい行を追加してDataSetをスケジュールするReplace/Appendモードを使用することができます。