Connect 至銷售資料來源 - Amazon Managed Grafana
已知限制必要的設定新增資料來源查詢銷售資料來源模板和變量

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

Connect 至銷售資料來源

注意

此資料來源僅適用於 Grafana 企業版。如需詳細資訊，請參閱 管理企業外掛程式的存取。

此外，在支援版本 9 或更新版本的工作區中，此資料來源可能需要您安裝適當的外掛程式。如需詳細資訊，請參閱 使用外掛程式擴充工作區。

Salesforce 資料來源可讓您在 Amazon 受管的 Grafana 內將 Salesforce 資料視覺化。

若要使用此資料來源，您必須擁有 Salesforce 帳戶和 S alesforce 連線的應用程式。

已知限制

  • 臨機操作過濾器尚不受支持。

  • 目前只支援 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 受管的 Grafana 工作區中開啟 Grafana 主控台，並確認您已登入。

  2. 在 [設定] 下方的側邊功能表 (齒輪圖示) 中，選擇 [資料來源]。

  3. 選擇新增資料來源。

    注意

    如果您在側邊功能表中沒有看到 [資料來源] 連結，表示您目前的使用者沒有該Admin角色。

  4. 從資料來源清單中選取「銷售力量」。

  5. 輸入下列資訊：

    • 在「使用者名稱」中，輸入您要用來連線和查詢 Salesforce 之 Salesforce 帳戶的使用者名稱。

    • 在「密碼」中，輸入該使用者的密碼。

    • 在安全性權杖中，輸入該使用者的安全性權杖。

    • 對於消費者金鑰，請輸入取用者金鑰以連線到 Salesforce。您可以從您的 Salesforce 連線應用程式取得此功能。

    • 針對「消費者密碼」，請輸入「取用者密碼」以連線至 Salesforce。您可以從您的 Salesforce 連線應用程式取得此功能。

    • 針對「使用沙箱」，如果您要使用 Salesforce 沙箱，請選取此選項。

查詢銷售資料來源

查詢編輯器支援「查詢建構器」和「SOQL 編輯器」模式。SOQL 代表銷售對象查詢語言。

查詢建置器 (SOQL 產生器)

查詢生成器是用於構建 SOQL 查詢的用戶友好界面。如果您不熟悉撰寫 SOQL 查詢，您可以使用此模式來建置 SOQL 來查詢 Salesforce 物件。查詢建構器中的「來源」欄位是指 Salesforce 中的一個或多個實體。您需要在查詢生成器中進行任何其他操作之前選擇 FROM 字段。選擇 F ROM 字段後，您需要選擇構建器模式。SOQL 生成器目前支持以下模式。

  • List— 從選定的表/銷售力量列出項目及其字段。使用此模式可取得結果，例如：「顯示在本會計季度建立的商機清單及其名稱、值和階段」。

  • Aggregate— 彙總實體中的項目。使用此模式可取得結果，例如：「計算上個月所建立的商機」。或「按照他們的階段名稱分組的商機總價值是多少？」

  • Trend— 顯示一段時間內的彙總結果。使用此模式可取得結果，例如「計算商機數目依據」 CreatedDate。或「按機會關閉日期分組的總價值總和是多少。」

在查詢編輯器中選擇Entity/FROM和模式之後，請使用下列選項建立查詢。

欄位 可應用於 描述
SELECT ALL 選取您要查看的欄位清單。對於彙總或趨勢檢視，也請選取您想要彙總值的方式。
WHERE ALL (選擇性) 指定篩選條件。系統會根據您選取的條件篩選結果。
ORDER BY 清單，彙總 (選擇性) 選取您要用於結果的欄位名稱和排序順序。
LIMIT 清單，彙總 (選擇性) 限制傳回的結果數目。預設為 100。
GROUP BY AGGREGATE (選擇性) 如果您要依任何特定欄位分割彙總值，請選取該欄位。
時間欄位 趨勢 指定您要將結果分組依據的日期欄位。結果會根據 Grafana 的時間選擇器範圍進行篩選。

如果您在查詢編輯器中配置前面的字段，您還將在查詢編輯器下看到生成的 SOQL 的預覽。如果您在查詢生成器中有任何限制而被阻止，則可以安全地切換到 SOQL 編輯器，您可以在其中自定義生成的 SOQL 查詢。

SOQL 编辑器

原始 SOQL 編輯器提供了通過原始 SOQL 查詢查詢銷售力對象的選項。SOQL 編輯器提供自動完成建議，例如每個資料表和對應欄位的可用實體。在選取之後使用 Ctrl+ 空格鍵，或在何處查看每個表格的可用實體。如果您在實體名稱後輸入一個點，則可以看到可用的欄位。

快捷鍵

使用 CTRL + SPACE 來顯示程式碼自動完成，其中會顯示可用的內容選項。

CMD + S 運行查詢。

查詢為時間序列

建立時間序列查詢，方法是將日期欄位與時間別名，然後將度量欄位與量度分組，然後依量度和日期進行分組。以下是範例：

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

巨集

要按儀表板時間範圍進行篩選，您可以在 SOQL 查詢中使用 Macros：

  • $__timeFrom— 將被轉換為time數據類型的當前活動時間選擇的開始替換。

  • $__timeTo— 將被轉換為time數據類型的當前活動時間選擇的結束替換。

  • $__quarterStart— 會計季度的開始 (衍生自 SalesForce 會計年度設定)。

  • $__quarterEnd— 會計季度結束時間 (衍生自 SalesForce 會計年度設定)。

SELECT UserId, LoginTime from LoginHistory where LoginTime > $__timeFrom

模板和變量

若要新增 Salesforce 查詢變數，請參閱新增查詢變數。使用您的 Salesforce 資料來源做為資料來源。您可以在這裡使用任何 SOQL 查詢。

如果您想要使用名稱/值組 (例如使用者 ID 和使用者名稱)，請從 SOQL 查詢傳回兩個欄位。第一個欄位將用作 ID。當您想在查詢編輯器 SOQL 中按密鑰（ID 等）進行過濾時，請執行此操作。

使用變數語法在 SOQL 查詢中使用變數。如需更多詳細資訊，請參閱 變數語法。