示例：将服务流程迁移到统一目录

通过将 Service Process Studio 中的服务流程定义转换为标准产品记录，简化您管理接收请求的方式。在一个地方一起管理您所有的产品和服务。

所需的 Edition

适用于：Lightning Experience

适用于：具有 Financial Services Cloud 和统一目录的 Enterprise、Unlimited 和 Developer Edition。

开始之前，请确保您拥有最初在 Service Process Studio 中创建的有效“停止检查”付款服务流程。

此任务使用停止检查付款服务流程作为示例，以演示迁移步骤。在这种情况下，原始服务流程定义包含三个属性，例如 Check Number、Check Date 和 Amount，以及相应的 API 名称 Check_Number、Check_Date 和 Amount。按照这些步骤迁移此特定流程，并调整逻辑以迁移自己的服务流程。

在统一目录中创建服务。

统一目录使用 Product2 记录来定义服务。创建此记录，以为服务生成唯一产品 ID。
1. 从应用程序启动程序中，查找并选择统一目录。
2. 在主页上，单击新建，然后选择服务流程。
3. 对于名称，输入停止检查付款，并填写剩余字段。
4. 保存更改。
在统一目录的服务设计器中，执行这些操作。
1. 单击下一步。
2. 在属性步骤中，重新创建原始服务流程定义的属性。
  
  对于检查编号属性，使用文本作为数据类型。对于检查日期属性，使用日期作为数据类型。对于金额属性，使用数字作为数据类型。请参阅配置进程属性。
  
  备注请确保，将每个属性的 API 名称与原始 Service Process Studio 定义中的 API 名称相匹配，以防止接收或履行过程中出现不匹配的错误。
3. 在接收表单步骤中，附加您要与停止检查付款服务关联的接收表单和履行流。请参阅设计请求接收表格。
4. 在履行流步骤中，添加要与停止检查付款服务关联的履行流。请参阅配置请求履行。
5. 在“高级选项”下的“集成”步骤中，添加要与“停止检查付款”服务关联的集成定义。
6. 在此新服务的浏览器 URL 中，复制记录 ID，例如 01tDn00000Wxyz。
  01tDn00000Wxyz 是服务的产品 ID。
保存更改，并激活停止检查付款服务。
创建 Omnistudio 数据映射器转换。

将接收表单数据映射到 CustomAttributes JSON 结构。统一目录连接 API 需要将所有特定于服务的数据封装到名为 CustomAttributes 的特定 JSON 节点中。您现有的 Omniscript 可能以扁平的键值格式存储数据，因此这种转换对于正确构建 API 的有效负载是必要的。
1. 在您创建的数据映射器转换中，转到转换选项卡。
2. 单击管理输入/输出类型。
3. 在编辑输入 JSON 字段中，输入您的输入 JSON。
  输入 JSON 表示的数据与提交服务流程请求之前存在于 Omniscript 中的数据完全相同。
  
  以下是停止检查付款服务流程的输入 JSON 结构示例：
```
        {
        "Check_Number": "1042",
        "Check_Date": "2026-02-15",
        "Amount": "2500"
        }
       
```
4. 在编辑预期 JSON 输出中，输入预期输出 JSON。
  预期输出 JSON 是统一目录连接 API 所需的负载格式。
  
  以下是停止检查付款服务流程的预期输出 JSON 结构示例，其中包含 CustomAttributes 节点：
```
        {
        "CustomAttributes": {
        "checkNumber": "1042",
        "checkDate": "2026-02-15",
        "amount": "2500"
        }
        }
       
```
5. 将 Omniscript 的输入字段映射到 CustomAttributes 节点中的相应输出字段。请参阅映射转换输入和输出。
  
  以下是映射的输入和输出字段的示例。
创建 Omnistudio 集成程序。

配置集成程序，以调用统一目录连接 API 并传递服务流程数据。原始 Service Process Studio 使用 Service Process Connect API 为服务流程请求创建个案。统一目录使用名为 ServiceRequestCaseApiService 的产品驱动 API。此 API 要求您传递 productId，以将新创建的个案链接到目录项目。它还要求您将每个特定的服务属性映射为不同的键值对。这保证了统一目录准确地读取您的接收数据，并为个案记录正确构建它。复制集成程序的名称，以便稍后使用。
1. 在您创建的集成程序中，添加远程操作步骤。
2. 输入 serviceprocess.ServiceRequestCaseApiService 作为远程类。
3. 输入 callServiceRequestApiToCreateCase 作为远程方法。
4. 展开“其他输入”、“其他输出”和“故障响应”部分。
5. 在其他输入部分，添加 productId、svcCatalogItemDefApiName 和 inputToRequestPayloadTransformDataMapper 密钥。
6. 对于 productId 密钥，输入服务的产品 ID。例如，01tDn00000Wxyz。
7. 对于 svcCatalogItemDefApiName 密钥，输入服务名称。例如，停止支票付款。
8. 对于 inputToRequestPayloadTransformDataMapper 密钥，输入您创建的数据映射器转换的 API 名称。
9. 在相同“其他输入”部分，将服务流程的每个属性添加为新键值对。例如，将密钥设置为金额，并将值从 Omniscript 映射到集成程序。
  
  以下是停止检查付款服务流程的集成程序的示例输入。
保存并激活集成程序。
更新停止检查付款服务流程的接收 Omniscript。
1. 创建现有 Omniscript 的版本。
2. 查找并选择创建服务流程请求的个案的 CreateCase 步骤。
3. 在集成程序操作属性的集成程序字段中，添加您创建的集成程序的名称。
4. 在“额外有效载荷”部分，将服务流程的所有属性添加为键值对。
激活 Omniscript。