5.4. 为 API 供应商集成定义操作流

流程

1. 在 Operations 列表页面中，针对您要定义的流的操作，单击 Create flow。

2. 对于您要添加到此流的每个连接：

   1. 在流视觉化中，点加号在那个位置添加连接。
   2. 点您要添加的连接。
   3. 选择您希望此连接执行的操作。
   4. 通过在带标签的字段中输入数据来配置操作。
   5. 点击 Next。

   在继续操作前，将所有必需的连接添加到流。

3. 在这个操作流程中，要处理连接间的数据：

   1. 在流视觉化中，点您要添加步骤的加号。
   2. 点击您要添加的步骤。
   3. 通过在带标签的字段中输入数据来配置步骤。

   4. 点击 Next。

      如需帮助，请参阅 连接间的添加步骤。

   如果您要添加在连接间处理数据的另一个步骤，请重复这一指令子集。

4. 将数据映射到下一个连接中的字段：

   1. 在流视觉化中，检查数据类型不匹配 图标，这表示连接无法处理传入的数据。您需要在此处添加数据映射程序步骤。

   2. 对于流视觉化中的每个数据不匹配图标：

      1. 点击刚才在这一步前的加号。
      2. 点 Data Mapper。
      3. 定义所需的映射。如需更多信息，请参阅 在下一个连接 中将集成数据映射到字段。
      4. 点击 完成 将 data mapper 步骤添加到流程中。

5. 在流视觉化中，在 Provided API return Path 步骤中，点 Configure。

   每个 API 供应商集成都通过向负责执行操作流的 REST API 调用者发送响应来完成每个操作流的流。响应包含用于完成操作流的 Provided API return Path 步骤配置的返回代码之一。配置返回路径步骤，如下所示：

   1. 在 Default Response 下，在 return Code 字段中接受 Fuse Online 显示的默认响应，或者点击 care caret 并滚动来选择您想要的默认响应。在执行操作流时，流程不会返回任何配置的错误响应。通常，默认响应返回代码表示成功操作。

   2. 在 Error Handling 下，指明是否要在返回邮件正文中包含错误消息。

      在开发过程中，您通常要返回错误消息。但是，在生产环境中，如果包含敏感或专有信息，您可能希望隐藏错误消息。错误消息是一个 JSON 格式的字符串，其中包含 响应代码、类别、消息 和错误元素，例如：

         {
            responseCode: 404,
            category:  "ENTITY_NOT_FOUND_ERROR",
            message: "SQL SELECT did not SELECT any records"
            error: SYNDESIS_CONNECTION_ERROR
          }

      Copy to Clipboard Toggle word wrap

      请注意，在开发过程中，知道发生错误的最可靠方法是检查对调用者的响应中的 HTTP_RESPONSE STATUS 标头。您还可以检查集成 Pod 的日志 INFO 消息。该集成的活动日志显示成功交换，且错误始终不会在 Activity 日志中显示。

   3. 在 Error Response Code 下，Fuse Online 显示为流中连接可能会返回的每个错误的条目。对于每个错误，接受 200 All is good default 返回代码，或者点击 以选择另一个 HTTP 状态返回代码。

      您可以从中选择的返回代码是 OpenAPI 文档为这个流程执行的操作定义的返回代码。如果 Fuse Online 没有显示您需要的返回代码，您可以编辑 OpenAPI 文档来添加它。

      为此，请单击右上角的 View/Edit API Definition。根据需要编辑 OpenAPI 文档。完成后，保存 OpenAPI 文档。Fuse Online 返回编辑 Provided API return Path 并反映了您保存的任何更改。

   4. 点击 Next 以完成返回路径的配置。

6. 如果这个流程都有所有必需的连接和步骤，且不存在数据不匹配图标，或者如果不再需要编辑流，请执行以下操作之一：

   • 发布 时间为：在右上角开始运行集成，单击 Publish。这会构建集成，将 REST API 服务部署到 OpenShift，并使集成能够执行。每次您完成操作流的创建时，或每次编辑操作流时，您可以发布集成。
   • 保存 InventoryService-latexTo 显示操作列表（在右上角），单击 Save。