教學課程:建立與 Salesforce 的連線,作為 API 目的地 - Amazon EventBridge

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

教學課程:建立與 Salesforce 的連線,作為 API 目的地

您可以使用 EventBridge 將事件路由至第三方服務,例如Salesforce

在本教學課程中,您將使用 EventBridge 主控台建立連線Salesforce、指向的 API 目的地Salesforce,以及將事件路由到的規則Salesforce。

必要條件

教學課程需要使用以下項目:

步驟 1:建立連線

若要將事件傳送至 Salesforce,您必須先建立與 Salesforce API 的連線。

建立連線
  1. 在以下位置打開 Amazon EventBridge 控制台 https://console.aws.amazon.com/events/

  2. 在導覽窗格中,選擇 API 目的地

  3. 選擇連線標籤,然後選擇建立連線

  4. 輸入連線的名稱和描述。例如,輸入 Salesforce 作為名稱並輸入 Salesforce API Connection 作為描述。

  5. 對于目的地類型,請選擇合作伙伴,針對合作伙伴目的地,從下拉式清單中選取 Salesforce。

  6. 針對授權端點,輸入下列其中一個:

    • 如果您使用的是生產組織,請輸入 https://MyDomainName.my.salesforce.com./services/oauth2/token

    • 如果您使用的沙盒沒有增強網域,請輸入 https://MyDomainName--SandboxName.my. salesforce.com/services /oauth2/token

    • 如果您使用具有增強網域的沙盒,請輸入 https://MyDomainName-- SandboxName.sandbox.my.salesforce.com/services/oauth2/token

  7. 針對 HTTP 方法,請從下拉式清單中選擇 POST

  8. 針對用戶端 ID,請從 Salesforce 連線應用程式輸入用戶端 ID。

  9. 針對用戶端密碼,請從 Salesforce 連線應用程式輸入用戶端密碼。

  10. 針對 OAuth HTTP 參數,請輸入下列索引鍵/值組:

    索引鍵

    grant_type

    client_credentials

  11. 選擇建立

步驟 2:建立 API 目的地

由於您已建立連線,接下來您將建立要用作規則目標的 API 目的地。

建立 API 目的地
  1. 在以下位置打開 Amazon EventBridge 控制台 https://console.aws.amazon.com/events/

  2. 在導覽窗格中,選擇 API 目的地

  3. 選擇建立 API 目的地

  4. 針對 API 目的地,輸入名稱和描述。例如,請輸入 SalesforceAD 作為名稱,Salesforce API Destination 作為描述。

  5. 針對 API 目的地端點,請輸入 https://MyDomainName.my.salesforce.com/services/data/v54.0/sobjects/MyEvent__e,其中 MyEvent__e 是您要在其中傳送資訊的平台事件。

  6. 針對 HTTP 方法,請從下拉式清單中選擇 POST

  7. 針對調用率限制,请輸入 300

  8. 針對連線,選擇使用現有連線並選擇您在步驟 1 中建立的 Salesforce 連線。

  9. 選擇建立

步驟 3:建立規則

接下來,您將建立一個規則,在建立 Amazon S3 物件時,將事件傳送至 Salesforce。

建立規則
  1. 在以下位置打開 Amazon EventBridge 控制台 https://console.aws.amazon.com/events/

  2. 在導覽窗格中,選擇規則

  3. 選擇建立規則

  4. 輸入規則的名稱和描述。例如,輸入 SalesforceRule 作為名稱,Rule to send events to Salesforce for S3 object creation 作為描述。

  5. 針對事件匯流排選擇預設值

  6. 針對規則類型選擇具有事件模式的規則

  7. 選擇下一步

  8. 事件來源中,選擇其他

  9. 針對事件模式,請輸入:

    { "source": ["aws.s3"] }
  10. 選擇下一步

  11. 針對「目標類型」,選擇「EventBridge API 目標」。

  12. 針對 API 目的地,請選擇使用現有的 API 目的地,然後選擇您在步驟 2 中建立的 SalesforceAD 目的地。

  13. 針對執行角色,請選擇為此特定資源建立新角色

  14. 針對其他設定,請執行下列動作:

    1. 針對設定目標輸入,請從下拉式清單中選擇輸入轉換器

    2. 選擇設定輸入轉換器

    3. 針對範例事件,請輸入以下內容:

      { "detail":[] }
    4. 針對目標輸入轉換器,請執行下列動作:

      1. 針對輸入路徑,請輸入以下內容:

        {"detail":"$.detail"}
      2. 針對輸入範本,請輸入以下內容:

        {"message": <detail>}
    5. 選擇確認

  15. 選擇下一步

  16. 選擇下一步

  17. 檢閱規則的詳細資訊,然後選擇建立規則

步驟 4:測試規則

若要測試您的規則,請將檔案上傳到 EventBridge已啟用的儲存貯體,以建立 Amazon S3 物件。有關建立物件的信息將被發送到 Salesforce 平台事件。

步驟 5:清除您的資源

除非您想要保留為此教學課程建立的資源,否則您現在便可刪除。刪除不再使用的 AWS 資源,即可避免 AWS 帳戶不必要的費用。

若要刪除 EventBridge 連線
  1. 開啟主 EventBridge 控台的 API 目的地頁面

  2. 選擇 Connections (連線) 索引標籤。

  3. 選取您建立的連線。

  4. 選擇刪除

  5. 輸入連線名稱並選擇刪除

若要刪除 EventBridge API 目的地
  1. 開啟主 EventBridge 控台的 API 目的地頁面

  2. 選取您建立的 API 目的地。

  3. 選擇刪除

  4. 輸入 API 目的地的名稱並選擇刪除

若要刪除 EventBridge 規則
  1. 開啟主 EventBridge 控台的 [規則] 頁面

  2. 選取您建立的規則。

  3. 選擇刪除

  4. 選擇刪除