自动分配 Salesforce 支持请求路由

---

本教程介绍了一个用例，展示了如何使用应用集成来自动执行路由和分配 Salesforce 客户支持请求的业务流程。

概览

在本教程中，您将创建一个集成，以使用 Salesforce 触发器在 Salesforce 中订阅支持请求渠道。Salesforce 中的一个新支持请求会调用该集成，该集成会提取支持请求 ID 和支持请求类型。系统会分别在 Jira Cloud 或 ServiceNow 中创建一个新问题或突发事件，具体取决于支持请求类型。

目标

本教程介绍了如何在集成中完成以下任务：

• 设置 Salesforce 触发器以调用您的集成。
• 为 Salesforce、Jira Cloud 和 ServiceNow 连接添加和配置 Connectors 任务。
• 添加和配置数据映射任务，以提取和映射支持请求详细信息。

费用

在本教程中，您将使用 Google Cloud 的以下收费组件：

• Application Integration
• 集成连接器
• Secret Manager

本教程中的说明旨在将您的资源使用量保持在 Google Cloud 的始终免费层级的限制范围内。

完成本文档中描述的任务后，您可以通过删除所创建的资源来避免继续计费。如需了解详情，请参阅清理。

准备工作

1. 登录您的 Google Cloud 账号。如果您是 Google Cloud 新手，请创建一个账号来评估我们的产品在实际场景中的表现。新客户还可获享 $300 赠金，用于运行、测试和部署工作负载。

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. 确保您的 Google Cloud 项目已启用结算功能。

4. Create a service account:

   1. In the Google Cloud console, go to the Create service account page.

      Go to Create service account
   2. Select your project.

   3. In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.

      In the Service account description field, enter a description. For example, Service account for quickstart.

   4. Click Create and continue.

   5. Grant the following roles to the service account: Secret Manager Viewer (roles/secretmanager.viewer), Secret Manager Secret Accessor (roles/secretmanager).

      To grant a role, find the Select a role list, then select the role.

      To grant additional roles, click Add another role and add each additional role.

      Note: The Role field affects which resources the service account can access in your project. You can revoke these roles or grant additional roles later. In production environments, do not grant the Owner, Editor, or Viewer roles. Instead, grant a predefined role or custom role that meets your needs.
   6. Click Continue.

   7. Click Done to finish creating the service account.

5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

6. 确保您的 Google Cloud 项目已启用结算功能。

7. Create a service account:

   1. In the Google Cloud console, go to the Create service account page.

      Go to Create service account
   2. Select your project.

   3. In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.

      In the Service account description field, enter a description. For example, Service account for quickstart.

   4. Click Create and continue.

   5. Grant the following roles to the service account: Secret Manager Viewer (roles/secretmanager.viewer), Secret Manager Secret Accessor (roles/secretmanager).

      To grant a role, find the Select a role list, then select the role.

      To grant additional roles, click Add another role and add each additional role.

      Note: The Role field affects which resources the service account can access in your project. You can revoke these roles or grant additional roles later. In production environments, do not grant the Owner, Editor, or Viewer roles. Instead, grant a predefined role or custom role that meets your needs.
   6. Click Continue.

   7. Click Done to finish creating the service account.

注意：在 Application Integration 设置期间，所有其他必需的 Google Cloud API（例如 Application Integration API、Secret Manager API 和 Connectors API）均处于启用状态。如需了解详情，请参阅设置 Application Integration。

准备环境

验证 Salesforce 用户设置

本教程假定您已有 Salesforce 开发者账号，并且已设置所需的用户设置和权限。确认您的账号已启用变更数据捕获 (CDC)。如需了解如何创建新账号，请参阅设置集成用户。

验证 Jira Cloud 账号

本教程使用 Jira Cloud。您可以使用现有的 Jira Cloud 账号，也可以创建一个新账号。验证您的 Jira Cloud 项目和板级是否已设置。如需详细了解 Jira Cloud，请参阅 Jira 软件文档。

验证 ServiceNow 实例

本教程使用 ServiceNow 免费的个人开发者实例 (PDI)。您可以使用现有的 ServiceNow 实例，也可以创建一个新实例。验证您的实例是否处于活跃状态，并记下其实例网址。如需详细了解 PDI，请参阅 ServiceNow PDI 文档。

配置连接

在本教程中，您必须在集成连接器中配置以下连接：

提示：我们建议您在 us-central1(lowa) 区域中创建以下连接。

Salesforce 连接

在 Integration Connectors 中配置 Salesforce 连接。如需了解如何配置 Salesforce 连接器，请参阅 Salesforce 连接器。

Jira Cloud 连接

在“集成连接器”中使用项目网址配置 Jira Cloud 连接，以便在项目中创建 Jira 问题。请务必记下项目 ID 和问题 ID。如需了解如何配置 Jira Cloud 连接器，请参阅 Jira Cloud 连接器。

ServiceNow 连接

使用实例网址在集成连接器中配置 ServiceNow 连接，以便在 ServiceNow 中创建工单。如需了解如何配置 ServiceNow 连接器，请参阅 ServiceNow 连接器。

创建集成

如需创建新的集成，请执行以下步骤：

1. 在 Google Cloud 控制台中，前往 Application Integration 页面。

   转到 Application Integration

2. 在导航菜单中，点击集成。随即会出现集成列表页面。
3. 点击 创建集成，然后在创建集成页面中提供以下详细信息：
   1. Integration name（集成名称）：输入 salesforce-case-integration。
   2. 说明：输入 Demo integration created for tutorial。
   3. 区域：从支持的区域列表中选择 us-central1。
   4. 点击创建以打开集成编辑器。

设置集成触发器

成功创建集成后，您可以添加和配置集成触发器，以便针对已识别的事件调用集成。

在本教程中，我们将使用 Salesforce 触发器为在 Salesforce 中创建的每个新支持请求调用集成。如需在 salesforce-case-integration 集成中添加和配置 Salesforce 触发器，请执行以下操作：

1. 在集成编辑器中，点击触发器以显示可用触发器的列表。
2. 点击 Salesforce 触发器元素并将其放置到集成编辑器中。
3. 在设计人员画布上选择 Salesforce 触发器元素，以打开 Salesforce 触发器配置窗格。
4. 在触发器输入下，配置以下字段：
   1. 事件类型：从下拉列表中选择更改数据捕获 (CDC)。
   2. Salesforce 实例配置：点击 + 添加新的 Salesforce 实例配置选项。

      在添加 Salesforce 实例配置对话框中，执行以下操作：

      • Salesforce 实例连接名称：输入 Salesforce 实例的连接名称。例如 test。
      • Salesforce 网域：输入您的 Salesforce 域名。您可以在以下位置找到此信息：Salesforce 账号 >查看个人资料页面。
      • 身份验证配置文件：选择身份验证配置文件。 如果您没有身份验证配置文件，请创建新的配置文件。 如需了解相关信息，请参阅创建新的身份验证配置文件。
      • 点击添加。
   3. Salesforce 渠道配置：点击下拉列表中的 + 添加新的 Salesforce 渠道配置选项。

      在添加 Salesforce 渠道对话框中，执行以下操作：

      • Salesforce 对象名称：输入 Case。
      • 点击添加。
   4. 操作：从下拉列表中选择创建

   系统会自动保存对属性的更改。

将触发器载荷映射到 Salesforce 连接器

使用 Salesforce 触发器调用集成时，您需要提取支持请求 ID 并将其映射到 Salesforce 连接器，以检索该支持请求的其他详细信息。

关联 Salesforce 账号

请按照以下步骤添加和配置连接器任务，以使用 Salesforce 连接检索支持请求详细信息：

1. 在集成编辑器中，点击 Tasks 以显示可用任务的列表。
2. 点击连接器元素，并将其放置到集成编辑器中。
3. 在设计器上选择连接器任务元素，以查看连接器任务 配置窗格。
4. 点击 ，然后将连接器标签重命名为 Fetch Salesforce Data。
5. 点击配置连接器。
6. 在连接器任务编辑器页面中，执行以下操作：
   1. 在选择连接下，选择 us-central1 区域。
   2. 从可用连接列表中选择您的 Salesforce 连接。
   3. 点击下一步。
   4. 在类型下，选择实体。
   5. 在设置实体/操作下，从可用实体列表中选择支持请求，然后选择Get 作为操作。
   6. 点击完成以完成连接配置并关闭窗格。

提取和映射支持请求 ID

数据映射任务用于在 Salesforce 触发器和 Salesforce 连接器之间映射和提取支持请求详细信息。

如需在您的集成中添加和配置数据映射，请执行以下操作：

1. 在集成编辑器中，点击 Tasks 以显示可用任务的列表。
2. 点击数据映射元素，并将其放置到集成编辑器中。
3. 选择设计器上的数据映射元素以查看任务配置窗格。
4. 点击 ，然后将数据映射任务重命名为 Get Case ID。
5. 点击打开数据映射编辑器。

   借助数据映射编辑器，您可以将输入变量映射到所需的输出变量， 使用可用的转换函数。然后，输出可用作任何其他集成任务或触发器的变量。如需详细了解如何映射变量，请参阅添加映射。

6. 将触发器 - SalesforceTriggerCdcRecordID - 输出变量映射到自动生成的连接器 - entityId(Fetch Salesforce Data) - 输入变量。

   映射完成后，关闭窗格。 所有更改都将自动保存。

7. 添加边缘连接（从 Salesforce 触发器）到获取支持请求 ID 任务。
8. 从“获取支持请求 ID”任务到“提取 Salesforce 数据”连接器添加边缘连接。

提取支持请求类型

从 Salesforce 连接器中检索到所有支持请求的详细信息后，您可以提取支持请求类型，并将其路由到 Jira Cloud 或 ServiceNow 应用。

如需提取 Salesforce 支持请求类型，请执行以下操作：

1. 在集成编辑器中，点击 Tasks 以显示可用任务的列表。
2. 点击数据映射元素，并将其放置到集成编辑器中。
3. 点击设计器上的数据映射元素以查看任务配置窗格。
4. 点击 ，然后将数据映射任务重命名为 Get case type。
5. 点击 Open Data Mapping Editor。
6. 点击 + 添加新变量，然后创建以下输出变量：

   输出变量名称	数据类型
   sf_case_type	STRING

7. 在 Salesforce 连接器载荷变量和局部变量之间创建以下映射：

   输入	输出
   connectorOutputPayload (Fetch Salesforce Data) .GET_PROPERTY("Type")	sf_case_type

   映射完成后，关闭窗格。 所有更改都将自动保存。

8. 将“提取 Salesforce 数据”连接器中的边缘连接添加到获取支持请求类型任务。

提出新的 Jira 问题

提取 Salesforce 支持请求类型后，如果支持请求类型为“Engineering”，请将其作为新问题传送至 Jira Cloud。

连接到 Jira 项目

请按照以下步骤配置连接器任务，以在 Jira 项目中创建新问题：

1. 在集成编辑器中，点击 Tasks 以显示可用任务的列表。
2. 点击连接器元素，并将其放置到集成编辑器中。
3. 点击设计器上的连接器任务元素，以查看连接器任务配置窗格。
4. 点击 ，然后将连接器重命名为 Create issue in Jira。
5. 点击配置连接器。
6. 在连接器任务编辑器页面中执行以下操作：
   1. 在选择连接下，选择 us-central1 区域。
   2. 从可用连接列表中选择您的 Jira Cloud 连接。
   3. 点击下一步。
   4. 在类型下，选择实体。
   5. 在设置实体/操作下，从可用实体列表中选择问题，然后选择创建作为操作。
   6. 点击完成以完成连接配置并关闭窗格。

转换和映射问题详情

如需转换支持请求详细信息并将其映射到 Jira 问题，请执行以下操作：

1. 在集成编辑器中，点击 Tasks 以显示可用任务的列表。
2. 点击数据映射元素，并将其放置到集成编辑器中。
3. 点击设计器上的数据映射元素以查看任务配置窗格。
4. 点击 ，然后将数据映射任务重命名为 Mapping for issue creation。
5. 点击打开数据映射编辑器。
6. 点击 + 添加新变量，然后创建以下变量：

   变量名称	数据类型	默认值
   jira_project-id	STRING	JIRA_PROJECT_ID 将 JIRA_PROJECT_ID 替换为您的 Jira 项目 ID。
   jira_issue_type_id	STRING	JIRA_ISSUE_TYPE_ID 将 JIRA_ISSUE_TYPE_ID 替换为以下任意问题类型 ID： 1000 - 用于 Epic 1001 - 用于短片故事 1002 - 针对 Task 1003 - 针对子任务 1004 - 针对错误

7. 创建以下映射：

   输入	输出
   "{ "IssueTypeId": jira_issue_type_id, "ProjectId": jira_project_id }" .TO_JSON() .SET_PROPERTY( connectorOutputPayload.Description (Fetch Salesforce Data), "Description" ) .SET_PROPERTY( connectorOutputPayload.Subject (Fetch Salesforce Data), "Summary" )	connectorInputPayload (Create issue in Jira)

   映射完成后，关闭窗格。 系统会自动保存所有更改。

8. 添加边缘连接（从映射问题创建任务）到在 Jira 中创建问题连接器。

创建新的 ServiceNow 突发事件

如果从 Salesforce 中提取的支持请求的类型为 Sales，则将其作为新工单转送到 ServiceNow。

连接到 ServiceNow

请执行以下步骤，配置连接器任务，为 ServiceNow 实例创建新突发事件：

1. 在集成编辑器中，点击 Tasks 以显示可用任务的列表。
2. 点击连接器元素，并将其放置到集成编辑器中。
3. 点击设计器上的连接器任务元素，以查看连接器任务配置窗格。
4. 点击 ，然后将连接器重命名为 Create incident in ServiceNow。
5. 点击配置连接器。
6. 在连接器任务编辑器页面中执行以下操作：
   1. 在选择连接下，选择 us-central1 区域。
   2. 从可用连接列表中选择您的 ServiceNow 连接。
   3. 点击下一步。
   4. 在类型下，选择实体。
   5. 在设置实体/操作下，从可用实体列表中选择事故，然后选择创建作为操作。
   6. 点击完成以完成连接配置并关闭窗格。

转换并映射突发事件详情

如需转换支持请求详细信息并将其映射到 ServiceNow 突发事件，请执行以下操作：

1. 在集成编辑器中，点击任务以显示可用任务列表。
2. 点击数据映射元素，并将其放置到集成编辑器中。
3. 点击设计器上的数据映射元素以查看任务配置窗格。
4. 点击 ，然后将数据映射任务重命名为 Mapping for incident creation。
5. 点击打开数据映射编辑器。
6. 点击 + 添加新变量，然后创建以下输入变量：
7. 创建以下映射：

   输入	输出
   "{}" .TO_JSON() .SET_PROPERTY( connectorOutputPayload.Description (Fetch Salesforce Data), "description" ) .SET_PROPERTY( connectorOutputPayload.Subject (Fetch Salesforce Data), "short_description" )	connectorInputPayload (Create incident in ServiceNow)

   映射完成后，关闭窗格。 系统会自动保存所有更改。

8. 从映射突发事件创建任务中添加边缘连接到在 ServiceNow 中创建突发事件连接器。

添加边缘条件

边缘条件可让您指定必须满足的条件，集成才能传递到通过边缘连接的任务。现在，您已经添加并配置了所需的任务，接下来可以添加边缘条件来定义集成的流程。

以下边缘条件根据 Salesforce 案例的类型控制集成流程：

1. 使用以下边缘条件将边缘连接从“获取支持请求类型”添加到“问题创建映射”任务：

     $sf_case_type$ = "Engineering"

2. 使用以下边缘条件从获取支持请求类型任务到用于创建突发事件的映射任务添加另一个边缘连接：

     $sf_case_type$ = "Sales"

集成流程示例

下图显示了使用本教程创建的集成的示例布局。

发布并测试集成

要发布集成，请点击集成编辑器工具栏中的发布。

成功发布集成后，您可以查看和检查已发布集成的执行日志。如需查看日志，请点击查看此集成的执行日志。随即会出现执行日志页面。

测试用例 1：检查是否为工程师支持请求创建了 Jira 问题

登录 Salesforce 实例并创建新案例，对集成进行测试。创建支持请求时，您必须在 Type（类型）字段中输入 Engineering。

如需验证集成是否成功，请执行以下操作：

前往您的 Jira Cloud 账号。

• 检查并确认项目中是否创建了包含 Salesforce 支持请求说明和摘要的新问题。

测试用例 2：检查是否为销售案例创建了 ServiceNow 突发事件

登录 Salesforce 实例并创建新案例，对集成进行测试。创建支持请求时，您必须在 Type（类型）字段中输入 Sales。

如需验证集成是否成功，请执行以下操作：

转到 ServiceNow 实例。

• 检查以确认您的实例中是否创建了包含 Salesforce 案例说明和摘要的新突发事件。

清理

为避免系统因本教程中使用的资源向您的 Google Cloud 账号收取费用，请取消发布集成并删除在 Integration Connectors 中创建的连接。

• 如需取消发布此集成，请点击集成编辑器工具栏中的取消发布。如需了解详情，请参阅删除集成。
• 要了解如何删除连接，请参阅管理连接器。