将应用程序与 Fuse 在线集成

1. 创建到您要集成的每个应用程序的连接。

2. 选择启动连接。此连接是包含您要与其他应用程序共享的数据的应用程序。

   或者，您可以启动与接受 HTTP 请求的计时器或 Webhook 集成。

3. 选择完成连接。此连接是从开始连接接收数据的应用程序，并完成集成。
4. 在完成连接中映射开始连接中的数据字段。
5. 为集成指定一个名称。
6. 点 Publish 开始运行集成。

流程概述

1. 在 Fuse Online OAuth Application Management 页面中，展开您要注册 Fuse Online 的应用条目。这将显示客户端 ID 和客户端 secret 字段。
2. 在您 注册期间看到的 OAuth 应用程序管理 页面的顶部附近，输入此回调 URL：，将该 URL 复制到剪贴板。
3. 在另一个浏览器标签页中，进入您要注册的应用程序的网站，并执行获取客户端 ID 和 secret 所需的步骤。这些步骤之一要求您输入 Fuse Online 环境的回调 URL。粘贴您在第二个步骤中复制到剪贴板的 URL。
4. 在 Fuse Online 中，在 Settings 页面中，粘贴客户端 ID 和客户端机密并保存设置。

1. 在左侧面板中，单击 Connections。
2. 点击您要验证或要获取新访问令牌的连接。
3. 在连接的详情页面中，点 Validate 或点 Reconnect。

1. 确定您要连接的应用程序是否使用 OAuth 协议。对于使用 OAuth 的每个应用程序，将 Fuse Online 注册为有权访问该应用程序的客户端。使用 OAuth 协议的应用程序包括：

   • Dropbox
   • Google 应用程序(Gmail、Calendar 和 Sheets)
   • Salesforce
   • SAP Concur
   • Twitter
2. 确定您要连接的应用程序是否使用 HTTP 基本身份验证。对于每个操作的应用程序，标识用于访问该应用程序的用户名和密码。创建连接时需要提供此信息。
3. 对于您要集成的每个应用程序，请创建一个连接。

流程

1. 在 Fuse Online 左侧面板中，单击 Integrations。
2. 点 Create Integration。

3. 选择并配置启动连接：

   1. 在 Choose a connection 页面上，单击您要用来启动集成的连接。当此集成运行时，Fuse Online 将连接到此应用程序，并获取您希望集成运行的数据。
   2. 在 Choose an action 页面中，选择您希望此连接执行的操作。每个连接都有可用的操作会有所不同。
   3. 在用于配置操作的页面中，在字段中输入值。
   4. 另外，如果连接需要数据类型规格，Fuse Online 会提示您点 Next 来指定操作的输入和输出类型。
   5. 点 Next 添加启动连接。

   作为连接到应用程序的替代选择，启动连接可以是计时器，可按照您指定的间隔触发集成执行，或者可以是接受 HTTP 请求的 webhook。

   + 在选择并配置启动连接后，Fuse Online 会提示您选择完成连接。

4. 选择并配置完成连接：

   1. 在 Choose a connection 页面上，点击您要用来完成集成的连接。当此集成运行时，Fuse Online 将与集成所操作的数据连接到此应用程序。
   2. 在 Choose an action 页面中，选择您希望此连接执行的操作。每个连接都有可用的操作会有所不同。
   3. 在用于配置操作的页面中，在字段中输入值。
   4. 另外，如果连接需要数据类型规格，Fuse Online 会提示您点 Next 来指定操作的输入和输出类型。
   5. 点 Next 添加完成连接。

   作为连接到应用程序的替代选择，结束连接可以向集成处理的消息发送信息。为此，请选择 Log when Fuse Online 提示您选择完成连接。

5. （可选）在启动连接和完成连接之间添加一个或多个连接。对于每个连接，选择其操作并输入任何所需的配置详情。
6. 另外，还可添加对连接之间的集成数据操作的一个或多个步骤。请参阅关于在连接之间添加步骤。
7. 在集成视觉化中，查找任何 图标。这些警告表示在此连接前需要数据映射程序步骤。添加所需的数据映射程序步骤。
8. 当集成包含所有必要的步骤时，根据您要开始运行集成，点 Save 或 Publish。
9. 在 Name 字段中输入可区分此集成的名称。
10. （可选）在 Description 字段中输入描述信息，例如，您可以指示这个集成的作用。

11. 另外，从您导入的库扩展列表中，您可以选择一个或多个库扩展来与集成关联。请注意，如果想要显示在此列表中，则必须已经将库 .jar 文件导入为 Fuse Online 扩展，以便您可以选择它。

    有关库扩展的更多信息，请参阅如何开发库扩展。

12. 如果您准备开始运行集成，请单击 Save 并发布。

    Fuse Online 显示集成摘要。您可以看到 Fuse Online 正在发布它。可能需要稍等片刻，集成的状态才会变为 Running。

    如果您不想发布集成，请单击 Save。Fuse Online 保存集成并显示其流视觉化。您可以继续编辑它。或者，在页面顶部的面包屑导航栏中，单击 Integrations 以显示集成列表。如果您保存但没有发布集成，则 Stopped 会出现在集成的条目中。

流程

1. 在 Fuse Online 中，单击左侧的 Integrations。
2. 点 Create Integration。

3. 在 Choose a connection 页面上，单击 Timer。

   Fuse Online 提供了一个 Timer 连接；您不需要创建计时器连接。

4. 在 Choose an action 页面上，选择 Cron 或 Simple。

   • cron 计时器需要一个 cron 表达式，用于指定触发集成执行的调度。
   • 一个简单的计时器会提示您输入一个句点及其时间单位，例如 5 秒、1 小时。可用的单位为毫秒、秒、分钟、小时、天。
5. 根据您要添加的计时器类型，输入 cron 表达式或带有所选时间单位的句点。
6. 点 Next 将 Timer 连接添加为集成的启动连接。

流程

1. 在您要添加数据映射程序步骤的流视觉化中，点 。
2. 单击 Data Mapper，以显示数据映射器中的源和目标字段。

流程

1. 在您要添加过滤器步骤的流视觉化中，点 。
2. 单击 Basic Filter。

3. 在 Configure Basic Filter Step 页面中，只有在传入的数据匹配字段时才会在 Continue 中：

   • 接受必须满足所有定义的规则的默认值。
   • 或者，选择 以下 ANY 来指示必须满足一个规则。

4. 定义过滤器规则：

   1. 在 Property Name 字段中，输入或选择包含您要过滤器评估内容的字段名称。例如，假设进入步骤的数据由指出 Twitter 处理的 tweets 组成。只有在 tweet 包含某些内容时才会继续执行。tweet 位于名为 text 的字段中，因此您可以在属性名称字段中输入或选择文本作为值。

      您可以使用以下方法定义属性名称：

      • 开始键入：该字段具有 typeahead 功能，可在弹出窗口中为您提供可能完成的列表。从框中选择正确的。
      • 点字段。此时会出现一个可用属性列表的下拉菜单。从列表中选择感兴趣的属性。
   2. 在 Operator 字段中，从下拉菜单中选择一个 operator。设置默认为 Contains 。要继续执行，您在此字段中选择的条件必须在 Keywords 字段中输入的值评估为 true。
   3. 在 Keywords 字段中，输入要过滤的值。例如，假设您接受默认的 Contains 操作器，并且仅在传入的文本提到某个产品时继续集成执行。您可以在此处输入产品名称。

5. （可选）点 + Add another rule 并定义另一个规则。

   您可以通过单击规则条目右上角的垃圾箱图标来删除规则。

6. 过滤器步骤完成后，点 Done 将其添加到流中。

流程

1. 在流视觉化中，您要在流中添加高级过滤器步骤，点 。
2. 单击 Advanced Filter。

3. 在编辑框中，使用 Camel Simple Language 指定一个过滤器表达式。例如，当消息标头的 type 字段设置为 widget 时，以下表达式评估为 true ：

   ${in.header.type} == 'widget'

   在以下示例中，当消息的正文包含 title 字段时，表达式评估为 true：

   ${in.body.title}

4. 点 Next 将高级过滤器步骤添加到流中。

流程

1. 在流视觉化中，点您要添加模板步骤的 。
2. 单击 Template。此时会打开 Upload Template 页面。
3. 指定模板类型，即 Freemarker、M Mustache 或 Velocity。

4. 要定义模板，请执行以下操作之一：

   • 将模板文件或包含您要修改的文本的文件拖放到模板编辑器中。
   • 单击 浏览以上传，导航到文件并上传该文件。
   • 在模板编辑器中，开始键入 以定义模板。
5. 在模板编辑器中，确保模板对 Fuse Online 有效。此流程后，有效模板的示例为。Fuse Online 在一行的左侧显示 ，其中包含语法错误。将鼠标悬停在语法错误指示器上会显示关于如何解决错误的提示。

6. 点 Done 将模板步骤添加到流中。

   如果没有启用 Done 按钮，则至少有一个语法错误必须正确。

   到模板步骤的输入必须采用 JSON 对象的形式。因此，您必须在模板步骤前添加数据映射步骤。

7. 要在模板步骤前添加数据映射程序步骤：

   1. 在流视觉化中，点您刚刚添加的模板步骤前的 。
   2. 单击 Data Mapper。

   3. 在数据映射器中，将 source 字段映射到每个模板占位符字段。

      例如，使用此流程后的示例模板，将 source 字段映射到每个模板字段：

      • time
      • name
      • text
   4. 在右上角，点 Done 将数据映射程序步骤添加到流中。

   模板步骤的输出始终是一个 JSON 对象。因此，您必须在模板步骤后添加数据映射程序步骤。

8. 在模板步骤后添加数据映射程序步骤：

   1. 在流视觉化中，点您刚刚添加的模板步骤后立即使用 。
   2. 单击 Data Mapper。
   3. 在数据映射器中，将模板的 消息字段 映射，该字段始终包含将源字段插入到模板中的结果到目标字段。例如，假设 Gmail 连接在流中下一步，您想要发送模板步骤的结果作为 Gmail 消息的内容。为此，您要将 message source 字段映射到 文本 目标字段。
   4. 在右上角，单击 Done。

流程

1. 在您要添加自定义步骤的流视觉化中，点 。

2. 点您要添加的自定义步骤。

   可用步骤包括上传至 Fuse Online 环境的扩展中定义的任何自定义步骤。

3. 响应 以提示输入执行步骤所需的任何信息。此信息因每个自定义步骤而异。

流程

1. 在 Fuse Online 中，在左侧导航面板中，单击 Integrations。
2. 点 Create Integration。
3. 在 Choose a connection 页面上，单击 API Provider。

4. 在 Start 与 API 调用页面集成 ：

   • 如果您有定义 REST API 操作的 OpenAPI 文档，请上传 OpenAPI 文档。
   • 如果您需要定义 OpenAPI 文档，请选择 Create a new OpenAPI 3.x document 或 Create a new OpenAPI 2.x 文档。

5. 点击 Next。

   • 如果您上传了一个文档，请查看或编辑它：

     1. 点 Review/Edit 以打开 API Designer 编辑器。

     2. 根据需要查看和编辑。

        另外，如果您的文档使用 OpenAPI 2 规格，如果您希望 API Designer 转换您的文档以符合 OpenAPI 3 规格，您可以点 Convert to OpenAPI 3。

     3. 在右上角，单击 Save 或 Cancel 以关闭编辑器。
     4. 点击 Next。

   • 如果您要创建文档，则在 Fuse Online 的 API Designer 编辑器中打开：

     1. 定义 OpenAPI 文档，如使用 API Designer 设计和开发 API 定义 中所述。
     2. 在右上角，单击 Save，这将关闭编辑器。
     3. 点击 Next。

流程

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。

流程

1. 导入任务 API 快速启动集成：

   1. 进入 https://github.com/syndesisio/syndesis-quickstarts/tree/1.11/api-provider 并下载 TaskAPI-export.zip。
   2. 在 Fuse Online 中，在左侧导航面板中，单击 Integrations。
   3. 在右上角，单击 Import。
   4. 将您下载的 TaskAPI-export.zip 文件拖到 Import 页面中。Fuse Online 表示它已成功导入该文件。
   5. 在左侧导航面板中，点 Integrations 查看您刚才导入 的任务 API 集成的条目。虽然该条目表示需要配置，但此集成已准备好发布。
2. 点 Edit Integration 查看此 API 提供的操作列表。

3. 检查每个操作的流：

   1. 点击 Edit flow 按钮，以显示该流的视觉化。

      每个流已经有一个数据库连接、一个或多个数据映射程序步骤，以及完成流的 Provided API 返回路径 步骤。

   2. 对于 Invoke SQL 步骤，单击 Configure 以查看连接执行的 SQL 语句。然后单击 Cancel 以返回到该操作的视觉化流。
   3. 对于数据映射程序步骤，点 Configure 以查看映射程序。然后单击 Cancel 以返回到视觉化。
   4. 对于 Provided API return Path 步骤，这是每个操作流中的最后一步，点 Configure 以查看操作可能会发送到调用者的 HTTP 返回代码。点 Cancel 返回视觉化。
   5. 检查一个操作流后，点 Integrations> Task API> Operation 下拉菜单，然后选择另一个操作。
   6. 重复这一部分步骤，以检查每个流。
4. 如果需要，点 Save 并编辑集成名称。

5. 单击 Save and Publish。

   集成摘要页面会在编译、构建、部署和启动集成时显示发布进度。

6. 当 Task API 集成摘要页面显示 Running 时，Fuse Online 会显示 Task API 服务的外部 URL。它类似如下：

   https://i-task-api-fuseonline.apps.openshift.com/

   这是 Fuse Online 使 Task API 服务可用的地方。REST API 调用指定以这个基本 URL 开头的 URL。

   如果您在 OpenShift Container Platform 上使用 Fuse Online，如果外部 URL 不在集成概述页面中，则管理员启用了 Red Hat 3scale 发现功能。这意味着 Red Hat 3scale 控制对集成的 API 的访问，并发布您的 API 供应商集成。要测试集成，请打开 3scale 仪表板来获取集成的 URL。

   如果您不希望 Red Hat 3scale 控制对集成 API 的访问，您可以禁用发现。通过查看集成摘要页面，在 Fuse Online 中执行此操作。在此页面上，单击 Disable discovery。Fuse 在线重新发布集成并提供外部 URL 来调用集成执行。

   您可以为每个 API 供应商集成启用或禁用发现。

流程

1. 在 Fuse Online 中，在左侧导航面板中，单击 Integrations。
2. 在 Task API 集成条目中，单击 View 以显示集成摘要。
3. 复制集成的外部 URL。

4. 在终端中，调用如下命令，将集成的外部 URL 分配给 externalURL 环境变量。务必将这个示例命令中的 URL 替换为您复制的 URL。

   export externalURL="https://i-task-api-fuseonline.apps.openshift.com"

5. 调用 curl 命令，该命令会触发 Create new task 操作的流执行：

   curl -k --header "Content-Type: application/json" --request POST --data '{"id":1, "task":"my first task :)!"}' $externalURL

   • -k 允许 curl 在出现其他被视为不安全的服务器连接时继续和操作。
   • --header 表示命令正在发送 JSON 格式数据。
   • --request 指定存储数据的 HTTP POST 命令。
   • --data 指定要存储的 JSON 格式内容。在本例中，内容为 {"id":1, "task":"my new task!"}。请注意，不需要 完成 的字段。
   • $externalURL 是要调用的 URL。

   此命令将 HTTP POST 请求发送到 Task API 服务，该服务会触发 Create new task 操作流的执行。流执行向示例数据库添加新任务，并返回类似以下内容的消息，以指示它的功能：

   +

   {"completed":null,"id":1,"task":"my new task!"}

6. 调用以下 curl 命令以创建另外两个任务：

   curl -k --header "Content-Type: application/json" --request POST --data '{"id":2, "task":"my second task :|"}' $externalURL
   
   curl -k --header "Content-Type: application/json" --request POST --data '{"id":3, "task":"my third task :("}' $externalURL

7. 调用 curl 命令，它根据 ID 操作触发 Fetch 任务的执行 流：

   curl -k $externalURL/1

   要获取任务，curl 命令只需要指定 URL。HTTP GET 命令是默认请求。URL 的最后一部分指定要获取的任务 ID。

8. 调用以下 curl 命令，该命令触发 Fetch 所有任务操作 的流执行：

   curl -k $externalURL

9. 另外，还可调用 curl 命令，该命令触发对 ID 操作的 Delete 任务执行流：

   curl -k -X DELETE $externalURL/3

   此命令调用 HTTP DELETE 命令，其 URL 与通过 ID 获取任务的命令相同。

1. 决定是否要将 GET 或 POST 请求发送到 Fuse Online。
2. 规划您的集成以处理此请求。

3. 创建完成集成的连接。

   Fuse Online 提供了一个 Webhook 连接，用作启动连接。

4. 创建您要添加到集成的任何其他连接。

5. 创建集成：

   1. 添加 Webhook 连接作为启动连接。

   2. 添加完成连接，然后集成所需的任何其他连接。完成连接以及任何中间连接处理 HTTP 请求，该请求会触发对集成的执行。您可以选择并指定最合适的 HTTP 请求来完成您的目标。请记住：

      • 向应用程序添加连接，其中包含您要获取或包含您要更新的数据的数据。
      • GET 请求仅限于键/值参数规格。
      • POST 请求可以提供任意正文，如 XML 或 JSON 实例。
      • Fuse Online 仅返回 HTTP 状态标头，且不会返回任何数据。因此，您可以定义由 GET 请求触发的集成，以及更新数据而不是获取数据。同样，您可以定义由 POST 请求触发的集成，并获取数据而不是更新数据。

   3. 在 Webhook 连接后添加数据映射程序步骤。

      对于 GET 请求，将 HTTP 请求中的参数字段映射到下一次连接中的 data 字段。

      对于 POST 请求，您可能会通过传递 JSON 实例、JSON 模式、XML 实例或 XML 模式来指定请求中的输出数据。如果没有，那么当您将 Webhook 连接添加为集成启动连接时，Fuse Online 会提示您指定输出数据类型。如果没有，则默认的 Webhook 连接输出数据类型采用 JSON 格式。

   4. 添加集成需要的任何其他步骤。
6. 发布集成并等待它变为 Running。
7. 进入集成摘要页面，再复制 Fuse Online 提供的外部 URL。
8. 修改此外部 URL 以构造 GET 或 POST 请求。
9. 实施将 HTTP GET 或 POST 请求发送到 Fuse Online 的应用。

流程

1. 在左侧的 Fuse Online 面板中，单击 Integrations。
2. 点 Create Integration。
3. 在 Choose a connection 页面上，单击 Webhook 连接。

4. 在 Choose an action 页面中，选择 Incoming Webhook 操作。

   在 Webhook Configuration 页面中，Fuse Online 显示 Fuse Online 为此集成的 webhook 令牌。

   当您构建 HTTP 请求时，此令牌是 URL 的最后一部分。发布此集成并正在运行后，Fuse Online 会显示 Fuse Online 外部 URL，该 URL 的末尾有此令牌。

   Webhook 配置页面 还包括 Default Response 和 Error Handling 部分。Webhook 步骤向调用它的 HTTP 客户端发送响应。响应包含一个返回代码，默认情况下，返回消息正文中的错误消息。

5. 在 Default Response 下，在 return Code 字段中接受 Fuse Online 显示的默认响应，或使用下拉列表选择您想要的默认响应。当执行操作流时，流不会返回任何配置的错误响应，流会发送此响应。通常，默认响应返回代码表示操作成功。

6. 在 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 日志中可见。

7. 对于 Webhook 步骤可能会返回的每个错误，接受默认的返回代码，或使用下拉列表选择另一个 HTTP 状态返回代码。
8. 点击 Next。

9. 在 Specify Output Data Type 页面中：

   1. 单击 Select Type 字段，然后选择 JSON 模式。
   2. 在 Definition 字段中，粘贴用于定义 HTTP 请求中参数的数据类型的 JSON 模式。请参阅关于 JSON 模式以指定请求参数。
   3. 在 Data Type Name 字段中，指定此数据类型的名称。虽然这是可选的，但如果您指定了名称，它会出现在 data mapper Sources 列表中，这样可方便正确映射字段。
   4. 另外，在 Data Type Description 字段中，提供一些可帮助您区分此数据类型的信息。
   5. 点击 Next。
10. 将完成连接添加到集成。
11. 添加任何其他所需连接。
12. 添加任何其他必要的步骤。
13. 在启动连接后立即添加数据映射程序步骤。
14. 单击 Publish，为集成提供名称和可选的描述，然后单击保存并发布。

流程

1. 要查看映射的表视图，请点 。
2. 要忽略映射的表视图，并重新显示源和目标字段，请点 。

流程

1. 在流视觉化中，查找任何 图标。
2. 点图标查看 Data Type Mismatch 通知。
3. 在消息中，单击 Add a data mapping step，其中显示数据映射器。

流程

1. 在 Sources 面板中：

   1. 如有必要，扩展步骤以查看它提供的数据字段。

      当有很多源字段时，您可以通过点 并在搜索字段中输入 data 字段来搜索感兴趣的字段。

   2. 点击您要从中映射的数据字段，然后点 。此时会打开 Mapping Details 面板。

2. 在 Target 面板中，找到您要映射到的数据字段，然后点 。

   数据映射器显示连接您选择的两个字段的行。

3. （可选）预览数据映射结果。当您向映射添加转换或映射需要类型转换时，这个选项很有用。

   1. 在数据映射程序的右上角，点 在 source 字段中显示文本输入字段，在 target 字段中显示只读结果字段。
   2. 在 source 字段的数据输入字段中，输入示例输入值。映射结果会出现在 target 字段中的 read-only 字段中。
   3. 另外，要查看转换的结果，请在 Mapping Details 面板中添加一个转换。
   4. 要隐藏预览字段，请再次点 。

4. 另外，要确认定义了映射，请点击 以显示定义的映射。

   您也可以预览数据映射结果（在此视图中）。如果预览字段不可见，点 。按照上一步中所述输入数据。

   + 在定义的映射表中，preview 字段仅显示所选映射。

   1. 要查看另一个映射的预览字段，请选择它。
   2. 再次点击 以显示数据字段面板。
5. 在右上角，点 Done 将数据映射程序步骤添加到集成。

流程

1. 在 Target 面板中，点您要将多个源字段映射到的字段，然后点 。此时会打开 Mapping Details 面板。

2. 在 Mapping Details 面板中，从 Source 下拉列表中选择您要映射到的一个或多个数据字段。

   完成后，您应该从每个 source 字段看到一行到 target 字段。

   在 Mapping Details 面板中，Data mapper 会显示默认的多重性转换，即 Concatenate。这表示映射的执行将 Concatenate 转换应用到所选源字段中的值，并将串联值映射到所选目标字段。

   注意

   有关您可以应用到多个源值的其他转换的详情，请参考

3. 在 Mapping Details 面板中，配置映射，如下所示：

   1. 在 Sources 下，在 Delimiter 字段中，接受或选择不同源字段的内容在 target 字段中插入的字符。默认为一个空格。
   2. 另外，在每个 source 字段条目中，您可以在映射到 target 字段前点 将转换应用到 source 字段值。

   3. 在 Sources 下，检查您选择的 source 字段条目的顺序。条目必须与 compound 目标字段中的对应内容相同。

      如果条目没有正确顺序，请更改字段条目的索引号，以实现相同的顺序。

      如果您将 source 字段映射到 compound target 字段的每个部分，请跳过下一步。

   4. 对于没有与 target 字段中对应数据相同的索引的每个 source 字段条目，请将索引编辑为相同。每个 source 字段条目都必须具有与 target 字段中对应数据相同的索引。数据映射程序根据需要自动添加 padding 字段来指示缺少数据。

      如果您意外创建太多 padding 字段，请为每个额外的 padding 字段点 来删除它。

   5. （可选）在 Targets 下，点 将内容映射到目标字段，然后应用转换，如 转换源或目标数据 中所述。

4. 另外，还可预览数据映射结果：

   1. 点 在当前所选映射的每个源字段中显示一个文本输入字段，在当前所选映射的目标字段中显示一个只读结果字段。

   2. 在源数据输入字段中，输入示例值。

      如果您重新排序源字段或向映射添加转换，则 target 字段中的 result 字段会显示它。如果数据映射器检测到任何错误，它会在 Mapping Details 面板的顶部显示信息信息。

   3. 再次单击 来隐藏预览字段。

      如果您重新显示 preview 字段，您输入的任何数据仍会存在，且会一直存在，直到您退出数据映射程序。

5. 要确认正确定义了映射，点 显示（表格式）在此步骤中定义的映射。将多个 source 字段的值合并到一个 target 字段中的映射如下所示： 。

   您还可以在此视图中预览映射结果。点 ，然后输入文本，如上一步中所述。Preview 字段仅显示所选映射。点表中的另一个映射查看预览字段。

流程

1. 在 Sources 面板中，点您要独立内容的字段，然后点 。

2. 在 Mapping Details 面板中，从 Target 下拉列表中选择您要映射到的数据字段。

   选择目标字段后，您应该看到 source 字段中的行到您选择的每个目标字段。

   在 Mapping Details 面板的顶部，数据映射器会显示 Split 来指示映射的执行分割源字段值并将其映射到多个目标字段。* 在 Targets 下，您选择的每个目标字段都有一个条目。

3. 在 Mapping Details 面板中，配置映射，如下所示：

   1. 在 Sources 下，在 Delimiter 字段中接受或选择 source 字段中的字符，指示 source 字段值分开的位置。默认为一个空格。
   2. （可选）点 将转换应用到 source 字段值，然后再映射到 target 字段。

   3. 在 Targets 下，检查您选择的目标字段条目的顺序。条目必须与 compound source 字段中对应的内容相同。在 source 字段中，您没有为一个或多个部分指定 target 字段无关紧要。

      如果条目没有正确顺序，请更改字段条目的索引号，以实现相同的顺序。

      如果您将 compound source 字段的每个部分映射到 target 字段，则跳至下一步。

   4. 如果 source 字段包含您不需要的数据，然后在 Mapping Details 面板中编辑每个目标字段的索引，它们没有与 source 字段中对应的数据相同的索引。每个目标字段条目都必须具有与 source 字段中对应数据相同的索引。数据映射程序根据需要自动添加 padding 字段，以指示不需要的数据。

      请参阅此流程末尾的示例。

   5. （可选）点 将内容映射到目标字段，然后应用转换，如 转换源或目标数据 中所述。

4. 另外，还可预览数据映射结果：

   1. 点击 在源字段中显示一个文本输入字段，在每个 target 字段中显示只读结果字段。

   2. 在 source 字段的数据输入字段中，输入 smaple 值。务必在字段的部分之间输入分隔符字符。映射结果会出现在目标字段的只读字段中。

      如果您重新排序目标字段或向目标字段添加转换，则目标字段上的结果字段反映了这种情况。如果数据映射器检测到任何错误，它会在 Mapping Details 面板的顶部显示信息信息。

   3. 再次单击 来隐藏预览字段。

      如果您重新显示 preview 字段，您输入的任何数据仍会存在，且会一直存在，直到您退出数据映射程序。

5. 要确认正确定义了映射，点 显示此步骤中定义的映射。将 source 字段的值分隔到多个目标字段的映射如下所示： 。

   您还可以在此视图中预览映射结果。点 ，然后键入文本，如上一步中所述。Preview 字段仅显示所选映射。点表中的另一个映射查看预览字段。

流程

1. 映射字段。这可以是一对一的映射、组合映射或分离映射。
2. 在 Mapping Details 面板中，在 Sources 或 Targets 下，在您要转换的字段的框中，点 。这个选项显示可用转换的下拉列表。
3. 选择您要执行数据映射程序的转换。
4. 如果转换需要任何输入参数，请在适当的输入字段中指定它们。
5. 要添加另一个转换，请再次点 。

流程

1. 如果数据类型还没有可见，点 来显示它们。

   虽然这不是指定条件的要求，但查看数据类型会很有帮助。

2. 创建您要对其应用条件的映射，或者确保当前选择的映射是您要将条件应用到的映射。例如，考虑这个映射：

   

3. 在左上角，点 以显示条件表达式输入字段。

   在 expression 字段中，数据映射器会自动显示当前映射中的 source 字段的名称。例如：

   

   在表达式输入字段中，源字段的顺序是您创建映射时选择的顺序。这很重要，因为默认映射行为是数据映射程序串联字段值，以便在 target 字段中插入结果。在本例中，要创建此映射，首先选择 lastName，然后选择 firstName。

4. 编辑 expression 输入字段，以指定您希望数据映射程序应用到映射的条件表达式。有关支持的条件表达式的详情，请遵循此流程。

   如果要在条件映射中包含转换，您必须将转换添加到条件表达式中。

   在指定表达式时，您可以键入 @ 和 start 来键入字段的名称。数据映射器显示与您输入的字段列表。选择您要在表达式中指定的字段。

   当您向表达式中添加字段名称时，data mapper 会将该字段添加到映射中。例如，考虑这个条件表达式：

   

   在执行过程中，如果数据映射器决定 lastName 字段为空，它将 firstName 字段映射到目标 customerName 字段。如果 lastName 字段包含一个值，即不是空的，则 data mapper 会串联 source orderId 和 phone 字段中的值，并在 customerName 字段中插入结果。（本示例展示了逻辑的工作方式，但可能不是有用的示例，因为 lastName 字段中有一个值时，您很可能希望数据映射程序只执行映射，而不是将一些其他值映射到目标。）

   在本例中，输入表达式后，数据映射为：

   

   在条件表达式中，如果您删除表达式应用到的映射中的字段名称，则数据映射程序会从映射中删除该字段。换句话说，映射中的每个字段名称都必须在条件表达式中。

5. 如果映射预览字段尚未可见，点 来显示它们。
6. 在源预览输入字段中键入示例数据，以确保 target 字段或目标字段获得正确的值。
7. 根据需要编辑条件表达式，以获取所需的结果。

流程

1. 在流视觉化中，点您要添加日志步骤的加号。如果 Fuse Online 正在提示您选择完成连接，请跳过这一步。
2. 单击 Log。

3. 在 Configure Log Step 页面中，选择您要记录的内容。如果您选择 Custom Text，然后在文本输入字段中输入以下之一：

   • 要记录的文本
   • Camel Simple 语言表达式

   如果您输入表达式，Fuse Online 将解析表达式并记录生成的文本。

4. 日志步骤配置完成后，点 Next 将步骤添加到流中。

流程

1. 了解如何将集成复制到另一个环境。
2. 从开发环境导出集成。请参阅 导出集成。
3. 将集成导入到测试环境中。请参阅 导入集成。

1. 在左侧面板中，单击 Integrations。
2. 在集成列表中，单击停止正在运行的集成条目，单击 View。

3. 在集成摘要页面中，在流视觉化中，点击您要重新连接的应用程序的图标。

   如果这是 API 提供程序集成，则在集成的摘要页面中，单击其流图标以显示操作列表。然后，点击路径包含失败的连接的操作，然后在操作的路径视觉化中点失败的连接。

4. 在连接的详情页面中，点 Reconnect。

5. 响应该应用程序的 OAuth 工作流提示。

   Fuse Online 显示一条消息，以指示其对应用程序的访问权限已被授权。对于某些应用程序，这需要几秒钟，但其他应用程序可能需要更长的时间。

6. 重新连接到应用程序后，启动集成。

1. 重新注册 Fuse Online 作为应用程序的客户端。有关获取授权的信息，请参阅常规流程。
2. 创建新连接。

3. 编辑使用旧连接的每个集成：

   1. 删除旧的连接。
   2. 使用新连接替换它。
4. 发布每个更新的集成。

流程

1. 在左侧 Fuse Online 面板中，单击 Integrations。
2. 在集成列表中，点您要更新的集成的 View。

3. 在集成摘要页面中，单击右上角的 Edit Integration。

   如果这是简单的集成，Fuse Online 会显示集成流。如果这是 API 供应商集成，Fuse Online 会显示操作列表。要更新特定操作的流，请点击该操作右侧的 Edit flow 来显示其流。

4. 根据需要更新流：

   • 要添加步骤，在流视觉化中点您要添加步骤的加号。然后，点击代表您要添加步骤的卡。
   • 要删除步骤，在流视觉化中点您要删除的步骤 。
   • 要更改步骤的配置，请在流视觉化中点击您要更新的步骤的 Configure。在配置页面中，根据需要更新参数设置。

流程

1. 使用具有包含 Fuse Online 集成的 OpenShift 项目的 admin 权限的帐户登录 OpenShift。例如：

   oc login -u admin -p admin

2. 切换到包含 Fuse Online 集成的项目。例如：

   oc project my-fuse-online-project

3. 编辑集成的部署配置对象：

   1. 输入以下命令，这通常会在编辑器中打开资源：

      oc edit deploymentconfig <i-integration-name>

      例如，如果集成的名称是 my-integration，请输入这个命令：

      oc edit deploymentconfig i-my-integration

   2. 通过设置 spec.containers.resources 来编辑配置，以指定 CPU 和内存的值，如下例所示：

      spec:
        containers:
          resources:
            limits:
              cpu: 350m
          requests:
              memory: 350Mi

   3. 保存配置。

流程

1. 在左侧 Fuse Online 面板中，单击 Integrations。
2. 在集成列表中，在您要删除的集成的条目右侧，点 并选择 Delete。
3. 在弹出窗口中，单击 OK 以确认要删除该集成。