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. 点 Done 将数据映射程序步骤添加到流中。

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

   每个 API 提供程序集成通过向触发操作流执行的 REST API 调用者发送响应来完成每个操作流。响应包含您为用来完成操作流的 Provided API 返回路径 步骤配置的返回代码之一。配置返回路径步骤，如下所示：

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

   2. 在 Error Handling 下，指示您是否要在返回消息的正文中包含错误消息。

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

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

      请注意，在开发过程中，了解出错的最可靠方法是检查对调用者的响应中的 HTTP_RESPONSE STATUS 标头。您还可以检查集成 pod 的日志中的 INFO 信息。集成的 Activity 日志显示成功的交换，错误并不总是在 Activity 日志中可见。

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

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

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

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

6. 当此流具有所有必需的连接和步骤，且没有数据不匹配图标时，或者您现在不再需要编辑流，请执行以下操作之一：

   • 发布 criu-wagonTo 开始运行集成，在右上角点 Publish。这会构建集成，将 REST API 服务部署到 OpenShift，并使集成可用。每次完成操作流创建或每次编辑操作流时，您可以发布集成。
   • 保存 mvapich-wagonTo 显示右上角的操作列表，点 Save。