教程:创建连接,将 Salesforce 作为 API 目标 - Amazon EventBridge
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

教程:创建连接,将 Salesforce 作为 API 目标

您可以使用 EventBridge 将事件路由到第三方服务,例如Salesforce

在本教程中,您将使用 EventBridge 控制台创建指向的连接Salesforce、指向Salesforce的 API 目标以及将事件路由到的规则Salesforce。

先决条件

完成本教程需要以下资源:

步骤 1:创建连接

要向 Salesforce 发送事件,您必须先与 Salesforce API 建立连接。

创建连接
  1. 打开亚马逊 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. 打开亚马逊 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. 打开亚马逊 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:清理资源

除非您想要保留为本教程创建的资源,否则可立即将其删除。通过删除不再使用的 Amazon 资源,可以防止向您的 Amazon 账户收取不必要的费用。

删除 EventBridge 连接
  1. 打开 EventBridge 控制台的 API 目标页面

  2. 选择连接选项卡。

  3. 选择您创建的连接。

  4. 选择 Delete (删除)

  5. 输入连接的名称,然后选择删除

删除 EventBridge API 目的地
  1. 打开 EventBridge 控制台的 API 目标页面

  2. 选择您创建的 API 目标。

  3. 选择 Delete (删除)

  4. 输入 API 目标的名称,然后选择删除

删除 EventBridge 规则
  1. 打开 EventBridge 控制台的 “规则” 页面

  2. 选择您创建的规则。

  3. 选择 Delete

  4. 选择 删除