Salesforce データソースに接続する - Amazon Managed Grafana

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Salesforce データソースに接続する

注記

このデータソースは Grafana Enterprise 専用です。詳細については、「Enterprise プラグインへのアクセスを管理する」を参照してください。

さらに、バージョン 9 以降をサポートするワークスペースでは、このデータソースで適切なプラグインのインストールが必要になる場合があります。詳細については、「プラグインを使用してワークスペースを拡張する」を参照してください。

Salesforce データソースを使用すると、Amazon Managed Grafana 内で Salesforce からのデータを視覚化できます。

このデータソースを使用するには、Salesforce アカウントと Salesforce 接続アプリケーション が必要です。

既知の制限事項

  • アドホックフィルターはまだサポートされていません。

  • 現在、SOQL クエリと SOQL 経由でアクセスできるデータのみがサポートされています。SOSL および SAQL クエリ形式はまだサポートされていません。

必須の設定

以下の設定が必要です。

注記

プラグインは現在、OAuth 2.0 ユーザー名/パスワードフローを使用しています。接続されたアプリで必要なコールバック URL は使用されません。したがって、任意の有効な URL に設定できます。

名前 説明
Enable OAuth settings OAuth を有効にするには、これをチェックする必要があります。
Callback URL このプラグインでは使用されないため、有効な URL を指定できます。
Selected OAuth Scopes (minimum requirements) データ (api) にアクセスして管理します。
Require Secret for Refresh Token Flow これを有効または無効にすることができます。

データソースの追加

  1. Amazon Managed Grafana ワークスペースで Grafana コンソールを開き、ログインしていることを確認します。

  2. 設定 (歯車アイコン) のサイドメニューで、データソース を選択します。

  3. [データソースを追加する] を選択する。

    注記

    サイドメニューにデータソースリンクが表示されない場合は、現在のユーザーに Adminロールがないことを意味します。

  4. データソースのリストから Salesforce を選択します。

  5. 次の情報を入力します。

    • ユーザー名 には、Salesforce の接続とクエリに使用する Salesforce アカウントのユーザー名を入力します。

    • パスワード には、そのユーザーのパスワードを入力します。

    • セキュリティトークン には、そのユーザーのセキュリティトークンを入力します。

    • コンシューマーキー には、Salesforce に接続するためのコンシューマーキーを入力します。これは、Salesforce 接続アプリケーションから取得できます。

    • コンシューマーシークレット には、Salesforce に接続するコンシューマーシークレットを入力します。これは、Salesforce 接続アプリケーションから取得できます。

    • サンドボックスを使用する で、Salesforce サンドボックスを使用する場合は、これを選択します。

Salesforce データソースをクエリする

クエリエディタは、クエリビルダーと SOQL エディタのモードをサポートしています。SOQL は Salesforce Object Query Language の略です。

クエリビルダー (SOQL ビルダー)

Query Builder は、SOQL クエリを構築するための使いやすいインターフェイスです。SOQL クエリの作成に慣れていない場合は、このモードを使用して SOQL を構築し、Salesforce オブジェクトをクエリできます。クエリビルダーの FROM フィールドは、Salesforce のエンティティを参照します。クエリビルダーの他のオペレーションの前に、FROM フィールドを選択する必要があります。FROM フィールドを選択したら、ビルダーモードを選択する必要があります。SOQL Builder は現在、次のモードをサポートしています。

  • List— 選択したテーブル/セールスフォースのフィールドを含む項目を一覧表示します。このモードを使用して、「この四半期に作成された機会のリストを名前、価値、ステージとともに表示」などの結果を取得します。

  • Aggregate— エンティティ内の項目を集約します。このモードを使用して、「先月に作成されたオポチュニティをカウントする」などの結果を取得します。または「ステージ名でグループ化された機会の合計値は何ですか?」

  • Trend— 集計結果を経時的に表示します。このモードを使用して、「機会の数を でカウントする」などの結果を取得します CreatedDate。または「オポチュニティの終了日別にグループ化された合計値」。

クエリエディタで Entity/FROMモードを選択したら、次のオプションを使用してクエリを構築します。

フィールド に適用可能 説明
SELECT すべて 表示するフィールドのリストを選択します。集計ビューまたはトレンドビューでは、値を集計する方法も選択します。
WHERE すべて (オプション) フィルター条件を指定します。結果は、選択した条件に基づいてフィルタリングされます。
ORDER BY LIST、集計 (オプション) 結果に使用するフィールド名とソート順序を選択します。
LIMIT LIST、集計 (オプション) 返される結果の数を制限します。デフォルトは 100 です。
GROUP BY AGGREGATE (オプション) 集計値を特定のフィールドで分割する場合は、 フィールドを選択します。
時間フィールド トレンド 結果をグループ化する日付フィールドを指定します。結果は Grafana のタイムピッカー範囲に基づいてフィルタリングされます。

クエリエディタで前述のフィールドを設定すると、クエリエディタの下に生成された SOQL のプレビューも表示されます。クエリビルダーの制限でブロックされている場合は、SOQL エディタに安全に切り替えることができます。SOQL エディタでは、生成された SOQL クエリをカスタマイズできます。

SOQL エディタ

raw SOQL エディタには、raw SOQL クエリを介して Salesforce オブジェクトをクエリするオプションがあります。SOQL エディタは、テーブルごとに使用可能なエンティティや対応するフィールドなど、オートコンプリート候補を提供します。テーブルごとに使用可能なエンティティを表示するには、SELECT または WHERE の後に Ctrl+Space を使用します。エンティティ名の後にドットを入力すると、使用可能なフィールドが表示されます。

ショートカット

CTRL + SPACE を使用して、使用可能なコンテキストオプションを示すコード補完を表示します。

CMD + S はクエリを実行します。

時系列としてのクエリ

日付フィールドをエイリアスし、メトリクスフィールドをメトリクスにエイリアスして時系列クエリを行い、メトリクスと日付でグループ化します。以下に例を示します。

SELECT sum(Amount) amount, CloseDate time, Type metric from Opportunity group by Type, CloseDate

マクロ

ダッシュボードの時間範囲でフィルタリングするには、SOQL クエリでマクロを使用できます。

  • $__timeFrom— データtime型に変換された現在アクティブな時間選択の開始に置き換えられます。

  • $__timeTo— データtime型に変換された現在アクティブな時間選択の終了に置き換えられます。

  • $__quarterStart— 会計四半期の開始 ( SalesForce 事業年設定から派生)。

  • $__quarterEnd— 会計四半期の終了 ( SalesForce 事業年設定から派生)。

SELECT UserId, LoginTime from LoginHistory where LoginTime > $__timeFrom

テンプレートと変数

新しい Salesforce クエリ変数を追加するには、「」を参照してくださいクエリ変数の追加。Salesforce データソースをデータソースとして使用します。任意の SOQL クエリをここで使用できます。

ユーザー ID やユーザー名など、名前と値のペアを使用する場合は、SOQL クエリから 2 つのフィールドを返します。最初のフィールドが ID として使用されます。これは、クエリエディタ SOQL でキー (ID など) でフィルタリングする場合に行います。

変数構文を使用して、SOQL クエリで 変数を使用します。詳細については、「変数構文」を参照してください。