Upsert対応のSalesforceコネクター

はじめに

Domo SalesforceコネクターはDomoとSalesforceを統合し、APIが有効なSalesforceのバージョン（現在はEnterpriseとUnlimited）からデータを抽出します。DomoとSalesforceの間で接続を確立するには、APIが有効になっているユーザーが、まずSalesforceで認証し、それからDomoにデータへのアクセスを許可する必要があります。その後、Salesforceのデータにもとづいたレポートを編集できるようになります。SalesforceのUpsertコネクターは、DataSetのスケジュールを設定するためにUpsertモードとAppend/Replaceモードをサポートします。Salesforce APIの詳細については、以下のいずれかを参照してください。

Upsert対応のSalesforceコネクターは「クラウドApp」コネクターです。つまり、クラウドに保管されたデータを取得できます。Data Centerでウィンドウ上部のツールバーで［クラウドApp］をクリックすると、これを含むほかのクラウドAppコネクターのページにアクセスできます。

Salesforce のアカウントには、データセンターから接続します。このトピックでは、Upsert対応のSalesforceコネクターのユーザーインターフェースに固有のフィールドとメニューについて説明します。DataSetの追加、更新スケジュールの設定およびDataSet情報の編集に関する一般的な情報は、「データコネクターを使用してDataSetを追加する」に記載があります。

主な使用事例	このコネクターはSalesforceのAPI対応版からのリード、パイプラインのアクティビティといったデータの取り込みに適しています。
主なメトリクス	リードの数パイプラインの量帳簿類ケースミーティングポートフォリオのアクティビティ
社内における主な権限	Salesforceには幅広い機能があり、営業、マーケティング、人事、事務、財務、ITをはじめとする多くの部門、そして、アナリスト、営業担当、マネージャー、VPなどといった多様な職務で活用できます。すべてSalesforceの実装方法、作成するオブジェクトやモジュールによって異なります。
平均導入時間	オブジェクト、レポート、データサイズによって異なりますが、Salesforceの導入は非常に迅速に完了します。必要な項目を特定したら、数分でデータを取り込むことができます。数百万行もあるような非常に大規模なデータの取り込みには、約1時間かかります。
使いやすさ（1～10 の段階。1 が「最も使いやすい」）	4

ベストプラクティス

［オブジェクトブラウザー］モードでは、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コネクターパッケージ」を検索してクリックします。

またはhttps://appexchange.salesforce.com/a...A00000EcrsyUABに直接移動することもできます。
［今すぐ取得］をクリックします。
インストール先として本番環境かサンドボックスを選択します。
「利用規約を読み終え、利用規約に合意します」というボックスにチェックを入れます。
［確認してインストール］をクリックします。
［すべてのユーザーに対してインストール］タイルをクリックします。

詳細については、Salesforceのドキュメント（https://help.salesforce.com/articleV...ges.htm&type=5）を参照してください。

インストールを確認する

DomoのSalesforce管理パッケージ検証ツールを使い、Salesforce管理パッケージが正しくインストールされていることを確認します。

インストールを確認するには

DomoのData CenterまたはAppStoreの［コネクター］ページで「Salesforce管理パッケージ」を検索し、アイコンをダブルクリックします。
［データを取得］をクリックします。
［認証情報］でSalesforceのアカウント名を選択し、［次へ］をクリックします。
［詳細］で［次へ］をクリックします。
［更新］メニューで［手動］を選択し、［次へ］をクリックします。
DataSetに名前をつけて、［保存］をクリックします。

これでDataSetが実行します。すべて正しく設定できていれば、このまま正常に実行でき、「検証完了：Salesforce管理パッケージが適切に設定されました」というメッセージが表示されます。

セットアップに不備があった場合はDataSetが失敗し、本記事へのヘルプリンクとともに、「SalesforceのDomoコネクターパッケージのインストールは完了していません」というメッセージが表示されます。

Salesforceアカウントに接続する

このセクションではUpsert対応のSalesforceコネクターページの［認証情報］と［データの選択］ペインのオプションについて説明します。このページの他のペインの項目である［スケジュール設定］や［DataSetに名前を付け、説明を入力］に関しては、ほとんどのタイプのコネクターで共通しています。詳細については「データコネクターを使用してDataSetを追加する」を参照してください。

［認証情報］ペイン

Upsert対応のDomo Salesforceコネクターは、接続にOAuthを使用しており、Domo内で認証情報を入力する必要はありません。［Salesforce環境］メニューで環境を選択し、［接続］をクリックしてSalesforceのログイン画面を開きます。ここで、Salesforceのユーザー名とパスワードを入力できます。有効なSalesforceの認証情報を一度入力しておくと、随時同じアカウントを利用して新しいSalesforce Upsert DataSetを作成できます。コネクターのアカウントはData Centerの［アカウント］タブで管理できます。このタブの詳細については「コネクターのユーザーアカウントを管理する」を参照してください。

［データの選択］ペイン

このペインには、メインメニュー［Salesforceデータの選択方法］のほかにも様々なメニューがあり、選択したレポートタイプに応じて表示されたりされなかったりします。

メニュー	説明
Salesforceデータの選択方法	Salesforceからデータを引き出すとき使う方法を選択します。以下の方法があります。オブジェクトとフィールドを参照する - 関連するフィールドやリレーションシップごとSalesforceのオブジェクトを選択できます。候補リストを参照する - Salesforceで利用可能なドロップダウンリストを参照できます。削除済みオブジェクト - 削除済みのSalesforceオブジェクトを選択できます。15日以上前に削除されたオブジェクトのみ選択できます。クエリ - SOQLクエリを入力してデータを取得できます。レポート - Salesforce内にある表形式レポートを取得できます。
取得するレコードのタイプ	検索対象をアクティブなレコードのみに絞るか、削除済みレコードも含めるかを選択します。
2,000行を超える行を取得するためのユニークフィールド	レポートの各行にユニーク値を含むフィールドを選択します。2,000行を超えるデータを取得するために使用されます。
クエリオプション	定義済みクエリ（［営業成績］または［ユーザー画像］）を選択するか、自分自身のクエリを作成します（［カスタム］）。
クエリ	SalesforceのSOQLクエリをここで入力します。例： SELECT Account FROM Account SOQLクエリ記述に関する詳細は、http://www.salesforce.com/us/developer/docs/officetoolkit/Content/sforce_api_calls_soql.htmを参照してください。
スキーマをリセット	データ内の列をリセットするオプションを選択します。一般的には、選択したフィールドまたはカスタムクエリを変更するときは、2番目のオプションを選択することになります。その後、DataSetを実行し、最初のオプションに切り替えて、以後の実行時にはスキーマを維持し、データタイプで問題が生じないようにすることになります。

その他のペイン

スケジュール設定、再試行、オプションの更新など、このページにないセクションに記載のコネクターのインターフェースについては、「データコネクターを使用してDataSetを追加する」を参照してください。

トラブルシューティング

Salesforceは全体的には非常に安定したコネクターで、Salesforceに特有の問題はほぼありません。問題の大半は権限不足（オブジェクトとフィールドの両方）が原因です。Salesforceの管理者は、特定のオブジェクトとフィールドをアップグレードできる必要があります。

よくあるエラーとしてもう一つ、「クエリロケータエラー」というものがあります。Salesforceでは、1人のユーザーに対して同時に維持するクエリロケーターは最大10個であり、最長で15分間しか維持しません。同時に実行するDataSetが多すぎると、一部が失敗します。この問題を防ぐ最善の方法は、DataSetを適量ずつ分散させて実行することです。

よくある質問

このコネクターでは、どのバージョンの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アカウントの認証情報が保護されていることをどのようにして確認できますか？

ログインプロセスではOAuthプロセスが使用されるため、DomoによってSalesforceの認証情報が表示または保存されることはありません。これにより、ログインの安全性が保たれます。Domoのアカウントへのアクセスはいつでも取り消すことができます。

「INVALID_QUERY_LOCATOR」エラーが継続的に発生します。どのように修正すればよいですか？

Salesforceでは、ユーザーは一度に最大10個のクエリを実行できます。DataSetの実行が拡大されていることを確認してください。

「QUERY_TIMEOUT」エラーが継続的に発生します。どのように修正すればよいですか？

SOQLクエリが2万字の文字数制限を超えているか、スクリプトフィールドが多すぎる場合、このエラーが発生します。この問題を解決するには、クエリを簡略化する必要があります。

レポートのドロップダウンメニューにレポートが表示されないのはなぜですか？

レポートをコネクターに表示させ、データを取り込む前に、レポートを表形式にして公開する必要があります。

SalesforceコネクターとUpsert対応のSalesforceコネクターの違いは何ですか？

Upsert対応のSalesforceコネクターでは、更新された行をすべて置き換えるMergeモードや、新しい行を追加してDataSetをスケジュールするReplace/Appendモードを使用することができます。

Knowledge Base

はじめに

ベストプラクティス