将 Fuse 在线连接到应用程序和服务

Red Hat Fuse 7.6

使用提供的连接器的说明

Red Hat Fuse Documentation Team

摘要

按照创建连接并将其添加到集成的逐步说明。

前言

要集成应用程序,您可以创建一个到您要集成的每个应用程序或服务的连接。然后,创建一个集成,并为您要集成的每个集成或服务添加一个连接。

Fuse Online 支持许多连接器,它们充当创建连接的模板。以下主题提供了创建连接并将其添加到集成的详情:

第 1 章 Fuse Online 支持的连接器

Fuse Online 支持以下连接器:

Name描述

Amazon DynamoDB

在 Amazon DynamoDB 表中获取、添加、更新或删除数据。

Amazon Simple Notification Service (SNS)

发送消息到 Amazon SNS 主题。

Amazon Simple Queue Service (SQS)

从或发送消息到 Amazon SQS 队列。

Amazon Simple Storage Service(S3)

从 Amazon S3 存储桶检索数据,或将数据复制到存储桶中。

AMQ

从 Red Hat AMQ (Apache ActiveMQ)代理获取消息,或向 Red Hat AMQ (Apache ActiveMQ)代理发布消息。

AMQP

从 Advanced Message Queue Protocol 代理获取消息,或向 AMQP 代理发布消息。

box

从 Box 下载文件或将文件上传到 Box。

Dropbox

从 Dropbox 下载文件或上传文件到 Dropbox。

电子邮件服务器

从 IMAP 或 POP3 电子邮件服务器检索电子邮件或连接到 SMTP 电子邮件服务器以发送电子邮件。

FHIR

从 FHIR 服务器获取资源或更新 FHIR 服务器上的资源。

FTP/SFTP

从 FTP 或 SFTP 服务器下载文件,或者上传文件到 FTP 或 SFTP 服务器。

Gmail

获取发送到特定 Gmail 帐户的邮件,并从特定的 Gmail 帐户发送邮件。

Google Calendar

从您指定的 Google Calendar 中指定或添加/更新事件的 Google Calendar 获取事件。

Google Sheets

从您指定的电子表格中获取 Google Sheets 电子表格数据、添加/更新电子表格数据、创建图表,或在您指定的电子表格中创建 pivot 表。

HTTP/HTTPS

连接到 HTTP 或 HTTPS 端点,并执行 GETPUTPOSTDELETEHEADOPTIONSTRACEPATCH 方法。

IRC

接收发送到 IRC 别名或频道的消息,或向特定频道上的 IRC 别名发送消息。

jira

在 JIRA 服务器上获取、创建或更新问题。

Knative 资源

从 Knative 频道、发送消息到 Knative 频道、公开简单的集成作为 Knative 服务或调用 Knative 服务的信息。

Kudu

从 Apache Kudu 数据存储中的表获取记录,或向 Kudu 数据存储中的表中添加记录。

MongoDB

从 MongoDB 数据库获取数据或更新 MongoDB 数据库中的数据。

MQTT

从 MQ 遥测传输代理获取消息,或向 MQTT 代理发布消息。

OData

从 OData 服务或更新、创建或删除由 OData 服务管理的实体获取实体。

REST API

通过上传 OpenAPI 文档创建自定义 REST API 客户端连接器。然后,您可以创建一个与该 REST API 的连接。

通过上传 OpenAPI 文档来定义触发集成执行的操作来创建 REST API 供应商集成。请参阅 Integrating Applications with Fuse Online 中的 创建由 REST API 调用触发的集成

Salesforce

创建、更新、获取或删除 Salesforce 记录。

SAP Concur

执行各种 SAP Concur 操作中的任何一种。

ServiceNow

从或复制记录到 ServiceNow 实例。

Slack

从频道获取信息或发送消息到 Slack 频道或用户。

SQL 数据库

在 Apache Derby、MySQL 或 PostgreSQL 数据库中调用 SQL 语句或 SQL 存储的流程。要连接到其他类型的 SQL 数据库,您可以上传包含该数据库的 JDBC 驱动程序的 Fuse Online 库扩展。

Telegram

使用 Telegram chat bot 从聊天或发送消息到聊天。

Twitter

在涉及您或包含您指定的数据的二十二时触发简单的集成执行。

Webhook

触发简单的与 HTTP GETPOST 请求集成的执行。

如果 Fuse Online 不提供您需要的连接器,经验丰富的开发人员可以创建定义自定义连接器的扩展。有关编码扩展并创建上传到 Fuse Online 的 .jar 文件的详情,请参考:

第 2 章 连接到 Amazon Web Services

Fuse Online 集成可以连接到以下 Amazon Web 服务:

  • DynamoDB
  • 简单通知服务(SNS)
  • 简单队列服务(SQS)
  • 简单存储服务(S3)

在创建与 Amazon Web 服务的连接前,您必须获取 AWS 凭证。详情请查看:

2.1. 获取用于创建到 Amazon 服务的连接的 AWS 凭证

要创建与 Amazon 服务的连接,您必须有一个与 AWS 帐户关联的访问密钥。这是创建或将创建资源的 AWS 帐户,以及您希望 Fuse 在线连接访问的资源。资源可以是 S3 存储桶、SNS 主题或 SQS 队列。

AWS 访问密钥有两个部分:

  • Amazon 访问密钥 ID
  • Amazon secret access key

AWS 使用访问密钥来验证来自 Fuse Online 连接的请求。关于创建和管理访问密钥的信息,还有大量的 AWS 文档。如果您已经创建了 AWS Identity and Access Management (IAM)用户并捕获与该用户关联的访问密钥,您可以指定这些值以创建与 S3、SNS 或 SQS 的 Fuse 在线连接。

如果您需要获取访问密钥,以下步骤是执行它的一种方式。

先决条件

  • 创建您要连接访问的资源的 AWS 帐户的登录凭证。
  • 或者,您要用于连接的 AWS 帐户的登录凭证来创建新资源。

流程

  1. 进入 https://aws.amazon.com/ 并登录到控制台。
  2. 在控制台中,单击用户名旁边的向下箭头,再单击 My Security Credentials
  3. 在弹出对话框中,点 Get Started with IAM Users

    如果没有显示此按钮的弹出窗口,请单击 用户

  4. 添加用户:

    1. Add User
    2. 输入用户名并选择 Programmatic Access
    3. Next: Permissions
    4. 响应提示将新用户添加到组中。
    5. 单击 Next: Tags
    6. 跳过添加标签并点击 Next: Review
    7. Create User.
  5. Download .csv 获取访问密钥的本地副本。下载的文件包含访问密钥 ID 和 secret 访问密钥,您必须指定创建与 Amazon 服务的连接。
  6. 单击 Close

2.2. 连接到 Amazon DynamoDB

集成可以从 Amazon DynamoDB 表中检索数据,将数据添加到 DynamoDB 表中,或者从 DynamoDB 表中删除数据。为此,请创建一个 Amazon DynamoDB 连接,然后将该连接添加到集成流中。

详情请查看:

2.2.1. 创建 Amazon DynamoDB 连接

您必须创建一个 Amazon DynamoDB 连接,然后才能连接到集成中的 Amazon DynamoDB。

先决条件

流程

  1. 在 Fuse Online 中,在左侧面板中,单击 Connections 以显示任何可用连接。
  2. 在右上角,单击 Create Connection 以显示 Fuse Online 连接器。
  3. Amazon DynamoDB 连接器。
  4. Access Key 字段中,输入 Amazon 访问密钥 ID,它是管理您希望连接访问的 DynamoDB 表的 AWS 帐户中的用户访问密钥 ID。
  5. Secret Key 字段中,为您指定的 Amazon 访问密钥 ID 输入 Amazon secret 访问密钥。
  6. Region 字段中,选择 DynamoDB 表所在的 AWS 区域。
  7. Table Name 字段中,输入您希望此连接访问的 DynamoDB 表的名称。
  8. 单击 Validate。Fuse Online 立即尝试验证连接并显示一条消息,指示验证是否成功。如果验证失败,请根据需要重新传输配置详情,然后重试。
  9. 验证成功后,单击 Next
  10. Name 字段中输入您选择的名称,可帮助您将这个连接与任何其他连接区分开来。例如,输入 DynamoDB West
  11. Description 字段中,输入有助于了解此连接的任何信息。例如,输入 Sample DynamoDB 连接,以访问 western 区域中的销售数据。
  12. Save 查看您创建的连接现在可用。如果您输入了示例名称,您会看到 DynamoDB West 显示为一个连接,您可以选择添加到集成。

结果

当 Fuse Online 提示您添加到集成时,它会显示您刚才创建的 DynamoDB 连接。此连接始终,仅访问您在创建连接时指定的 DynamoDB 表。

2.2.2. 从 Amazon DynamoDB 表中获取数据

在集成流中,若要从 Amazon DynamoDB 表中获取项目,请将 Amazon DynamoDB 连接添加到流中间。

DynamoDB 连接无法启动简单的集成。如果要定期从 DynamoDB 表中获取数据,请启动与计时器的简单集成,后跟一个查询表的 DynamoDB 连接。

先决条件

  • 您创建了 Amazon DynamoDB 连接。
  • 您正在创建或编辑流,Fuse Online 会提示您添加到集成。

流程

  1. 在流视觉化中,点您要添加 Amazon DynamoDB 连接的加号。
  2. Choose a connection 页面上,单击 Amazon DynamoDB 连接,该连接配置为访问您要从中获取数据的表。
  3. Choose an action 页面上,选择 Query 操作。
  4. Filter 字段中,指定 JSON 表示法来标识连接应返回的项目的键属性。您可以使用 :# 指定输入参数。例如,要获取具有两个关键属性的项目,规格可能类似如下:

    {"key1":":#PARAM1", "key2":":#PARAM2"}
  5. 可选的。在 Attributes to query 字段中,输入以逗号分隔的属性名称列表,其中包含您要返回的数据。例如:

    key1,key2,attribute3,attribute4,attribute5

    如果没有指定属性,查询会返回 key 属性。

  6. 点击 Next

结果

集成现在有一个 DynamoDB 连接,用于获取数据。在运行时,连接会返回包含查询结果的 JSON 实例文档。

后续步骤

如果您在 Filter 字段中指定了占位符参数,请在此连接前添加数据映射程序步骤。在数据映射程序步骤中,将 source 字段映射到 DynamoDB 连接中的目标占位符字段。

2.2.3. 将数据添加到 Amazon DynamoDB 表中

在流中,或完成简单集成,DynamoDB 连接可以将项目添加到 DynamoDB 表中。为此,请在流的中间或简单集成完成连接中添加 DynamoDB 连接。

注意

在本发行版本中,DynamoDB 连接无法更新 DynamoDB 表中的项目。以后的发行版本中应该会改变。

先决条件

  • 您创建了 Amazon DynamoDB 连接。
  • 您正在创建或编辑简单集成,Fuse Online 会提示您添加到集成或选择完成连接。

流程

  1. Choose a connection 页面上,单击配置为访问您要添加到的表的 Amazon DynamoDB 连接。
  2. Choose an action 页面上,选择 Put Item
  3. element 字段的 JSON 定义中,输入 JSON 表示法来定义要添加的表项。您必须指定项目的 key 属性。允许输入参数占位符,前缀为 : 4.1。确保指定您要存储的所有属性/值。在以下示例中,userID 是密钥:

    {"userID":"aslan","attr1":"some-value","attr2":"another-value"}
  4. 点击 Next

结果

连接会出现在您添加它的位置的集成视觉化中。在执行期间,连接会将定义的 JSON 项添加到连接配置为访问的 DynamoDB 表中。

后续步骤

如果您在项目的 JSON 定义中指定占位符参数,请在此连接前添加数据映射程序步骤。在数据映射程序步骤中,将 source 字段映射到 DynamoDB 连接中的目标占位符字段。

2.2.4. 从 Amazon DynamoDB 表中删除数据

在流的中间或完成简单集成,DynamoDB 连接可以从 DynamoDB 表中删除项目。为此,请在流的中间或简单集成完成连接中添加 DynamoDB 连接。

先决条件

  • 您创建了 Amazon DynamoDB 连接。
  • 您正在创建或编辑简单集成,Fuse Online 会提示您添加到集成或选择完成连接。

流程

  1. Choose a connection 页面上,单击 Amazon DynamoDB 连接,该连接配置为访问包含您要删除的项目的表。
  2. Choose an action 页面上,选择 Remove Item
  3. element 字段的 JSON 过滤器 中,输入 JSON 表示法来标识您要删除的项目。您必须指定项目的 key 属性。允许使用前缀 :# 的输入参数。在以下示例中,userID 是一个关键属性:

    {"userID":"aslan"}
  4. 点击 Next

结果

连接会出现在您添加它的流视觉化中。

后续步骤

如果您在 element 字段的 JSON 过滤器 中指定占位符参数,请在此连接前添加数据映射程序步骤。在数据映射程序步骤中,将 source 字段映射到 DynamoDB 连接中的每个目标占位符字段。

2.3. 连接到 Amazon Simple Notification Service (SNS)

集成可以发送消息到 AWS Simple Notification Service 主题。要做到这一点,创建一个 AWS SNS 连接,然后将该连接添加到集成流中,或者作为简单集成的完成连接。详情请查看:

2.3.1. 创建 Amazon SNS 连接

在向集成中添加 Amazon SNS 连接前,您必须创建 Amazon SNS 连接。

先决条件

  • AWS 访问密钥。请参阅 获取 AWS 凭证
  • 您必须知道 SNS 主题所在的区域。这是您希望创建 SNS 连接来发送消息的主题。

流程

  1. 在 Fuse Online 中,在左侧面板中,单击 Connections 以显示任何可用连接。
  2. 在右上角,单击 Create Connection 以显示 Fuse Online 连接器。
  3. Amazon SNS 连接器。
  4. Access Key 字段中,输入属于 AWS 帐户中的用户访问密钥 ID 的 Amazon 访问密钥 ID,该密钥管理您希望连接发送消息的主题。

    如果您希望连接访问的主题不存在,则 Fuse Online 尝试开始运行集成时,它会使用此访问密钥关联的 AWS 帐户来创建该主题。但是,如果这个主题在某些其他 AWS 帐户中已存在,则连接无法创建该主题,且集成无法启动。

  5. Secret Key 字段中,为您指定的 Amazon 访问密钥 ID 输入 Amazon secret 访问密钥。
  6. Region 字段中,选择该主题所在的 AWS 区域。如果连接创建该主题,它会在所选区域中创建它。
  7. 单击 Validate。Fuse Online 立即尝试验证连接并显示一条消息,指示验证是否成功。如果验证失败,请根据需要重新传输配置详情,然后重试。
  8. 验证成功后,单击 Next
  9. Name 字段中输入您选择的名称,可帮助您将这个连接与任何其他连接区分开来。例如,输入 SNS North
  10. Description 字段中,输入有助于了解此连接的任何信息。例如,输入 Sample SNS connection,将信息发送到我们的北区域主题。
  11. Save 查看您创建的连接现在可用。如果您输入了示例名称,您会看到 SNS North 显示为一个连接,您可以选择添加到集成。

2.3.2. 发送消息到 Amazon SNS

要发送消息到 Amazon SNS 主题,请在流的中间添加 Amazon SNS 连接,或作为简单集成中的完成连接。

先决条件

  • 您创建了 Amazon SNS 连接。
  • Fuse Online 会提示您添加到集成,或者将完成连接添加到简单集成。

流程

  1. Add to Integration 页面上,单击您要添加连接的加号。如果 Fuse Online 正在提示您选择完成连接,请跳过这一步。
  2. 点击您要用来发送消息的 Amazon SNS 连接。
  3. Send Object 操作。
  4. Topic Name 或 Amazon Resource Name 字段中输入 SNS 主题的名称,以将消息发送到或输入主题的 Amazon Resource Name (ARN)。

    如果连接被授权访问的 AWS 帐户或任何其他 AWS 帐户中尚不存在 SNS 主题,连接会在将连接配置为访问权限的 AWS 帐户中创建主题。

  5. Next 将连接添加到集成。

结果

连接会出现在您添加它的集成流中。

2.4. 连接到 Amazon Simple Queue Service (SQS)

集成可以从 Amazon SQS 队列检索消息,或发送消息到 Amazon SQS 队列。为此,请创建一个 Amazon SQS 连接,然后将该连接添加到集成流中。详情请查看:

2.4.1. 创建 Amazon SQS 连接

在向集成中添加 Amazon SQS 连接前,您必须创建一个 Amazon SQS 连接。

先决条件

  • AWS 访问密钥。请参阅 获取 AWS 凭证
  • 您必须知道 SQS 队列所在的区域。这是您希望创建 SQS 连接来发送消息的队列。

流程

  1. 在 Fuse Online 中,在左侧面板中,单击 Connections 以显示任何可用连接。
  2. 在右上角,单击 Create Connection 以显示 Fuse Online 连接器。
  3. Amazon SQS 连接器。
  4. Access Key 字段中,输入作为 AWS 帐户中的用户访问密钥一部分的 Amazon 访问密钥 ID,该密钥管理您希望连接访问的队列。

    如果您希望连接访问的队列尚不存在,则 Fuse Online 尝试开始运行集成时,它将使用此访问密钥关联的 AWS 帐户来创建队列。但是,如果队列已在其他 AWS 帐户中存在,则连接无法创建队列,且集成无法启动。

  5. Secret Key 字段中,为您指定的 Amazon 访问密钥 ID 输入 Amazon secret 访问密钥。
  6. Region 字段中,选择队列所在的 AWS 区域。如果连接创建队列,则它会在所选区域中创建它。
  7. 单击 Validate。Fuse Online 立即尝试验证连接并显示一条消息,指示验证是否成功。如果验证失败,请根据需要重新传输配置详情,然后重试。
  8. 验证成功后,单击 Next
  9. Name 字段中输入您选择的名称,可帮助您将这个连接与任何其他连接区分开来。例如,输入 SQS 南部
  10. Description 字段中,输入有助于了解此连接的任何信息。例如,输入 Sample SQS 连接,将消息发送到我们南部地区队列。
  11. Save 查看您创建的连接现在可用。如果您输入了示例名称,您会看到 SQS South 显示为可以添加到集成的连接。

2.4.2. 从 Amazon SQS 获取消息以触发集成执行

要通过从 Amazon SQS 队列获取消息来启动集成,请将 Amazon SQS 连接添加为简单的集成启动连接。

先决条件

  • 您创建了 Amazon SQS 连接,该连接配置为访问您要获取消息的队列。
  • 您知道希望连接从中获取消息的 SQS 队列的名称。

流程

  1. 在左侧的 Fuse Online 面板中,单击 Integrations
  2. Create Integration
  3. Choose a connection 页面上,单击您要用来启动集成的 Amazon SQS 连接。
  4. Choose an action 页面上,选择 Poll a Amazon SQS Queue 来定期从 SQS 队列检索消息。
  5. 配置此操作:

    1. Delay 字段中,接受默认的 500 毫秒,作为轮询之间经过的时间。或者,要指定不同的轮询间隔,输入数字并选择其时间单位。
    2. Maximum Objects to Retrieve 字段中,输入一次轮询操作可以获取的最大消息数。默认值为 10。

      要对可以获取的消息数量没有限制,请指定 0 或负整数。当 Retrieve 的最大对象 没有限制时,poll 操作会获取 SQS 队列中的所有消息。

    3. Queue Name 或 Amazon Resource Name 字段中,指定要从中检索消息的 SQS 队列的名称,或队列的 ARN。如果具有此名称的队列不存在,连接会创建它。这是唯一必填字段。
    4. 指明您是否希望 获取消息,然后从队列中删除它们。获取消息,然后从队列中删除它们是默认行为。只有在您希望连接检索消息并将其保留在队列中时,取消选择这个选项,这意味着将再次检索消息。
    5. 指明是否 通过 Camel 过滤器获取消息并删除 消息。默认选择这个选项。当您想通过过滤器传递检索到的消息时,保留它,以确定是否将其从队列中删除。您不需要取消选择 Obtain 消息,然后从队列 删除。在选择 Obtain 消息时,Fuse Online 确保了正确的行为,并在通过 Camel 过滤器进行时删除消息
  6. 点击 Next

结果

连接会出现在集成流的开头。

后续步骤

如果您选择了 Obtain 消息并删除其通过 Camel 过滤器进行的操作, 那么您需要在此 SQS 连接后添加过滤器步骤。在 SQS 连接后,过滤器步骤不需要立即生效。添加所有连接到集成,然后添加过滤器步骤。在执行期间,如果存在通过过滤器的消息,Fuse Online 会使用同一个连接(SQS 启动连接)从队列中删除这些消息。

2.4.3. 将消息发送到 Amazon SQS 队列

在流中,或完成简单集成,您可以将消息发送到 Amazon SQS 队列。

先决条件

  • 您创建了 Amazon SQS 连接,该连接配置为访问要发送消息的队列。
  • 您知道您希望连接将消息发送到的 SQS 队列的名称。
  • Fuse Online 会提示您添加到集成,或者选择完成连接以进行简单集成。

流程

  1. Add to Integration 页面上,单击您要添加连接的加号。如果 Fuse Online 正在提示您选择完成连接,请跳过这一步。
  2. 点击您要用来发送消息的 Amazon SQS 连接。
  3. 选择您要连接执行的操作:

    • 发送对象 向队列发送一条消息。
    • 发送批处理 对象将批处理消息发送到队列。
  4. Message group ID 策略 字段中,对于 first-in, first-out (FIFO)队列,接受 ConstantMessageGroupIdStrategy 或点击字段中并选择不同的策略。

    此参数的设置对简单队列没有影响。消息组 ID 标识消息所属的组。属于同一消息组的消息始终逐一处理,其严格顺序相对于消息组。消息组 ID 策略决定了连接如何为消息分配组 ID。这些选项是:

    • ConstantMessageGroupIdStrategy mvapich-wagonThe 连接使用恒定来对消息进行分组。
    • ExchangeIdMessageGroupIdStrategy criu-wagonThe 连接使用交换 ID (位于每个消息中)来对消息进行分组。
    • PropertyValueMessageGroupIdStrategy mvapich-wagonThe 连接使用 internal 属性的值来对消息进行分组。

    FIFO 队列旨在确保信息被严格保留和接收的顺序,并且每个消息都完全被处理一次。FIFO 队列名称具有 .fifo 作为后缀。

  5. Message deduplication ID 策略 字段中,对于 FIFO 队列,接受 NullMessageDeduplicationIdStrategy 或点击字段中以选择 ExchangeIdMessageDeduplicationIdStrategy

    此参数的设置对简单队列没有影响。对于 FIFO 队列,连接使用所选策略来确保它不会向队列发送重复消息。

    • NullMessageDeduplicationIdStrategy 使用消息正文作为 deduplication 元素。换句话说,连接比较了消息正文以识别重复消息。
    • ExchangeIdMessageDeduplicationIdStrategy 使用消息的交换 ID 作为 deduplication 元素。换句话说,连接比较交换 ID 以识别重复消息。
  6. Queue Name 或 Amazon Resource Name 字段中输入要发送消息的队列名称。如果队列不存在,连接会创建它。
  7. Delay 字段中,接受默认值,即 0 代表没有延迟。或者,要添加延迟,请指定一个数字。集成会在发送消息前等待这个秒数。当消息消费者可能不会立即准备好连接发送的消息时,这非常有用。
  8. 点击 Next

结果

连接会出现在您添加它的集成流中。

2.5. 连接到 Amazon Simple Storage Service (S3)

集成可以从 Amazon S3 存储桶检索数据,或者将数据复制到 Amazon S3 存储桶中。为此,请创建一个 Amazon S3 连接,然后将该连接添加到集成流中。详情请查看:

2.5.1. 创建 Amazon S3 连接

在向集成中添加 Amazon S3 连接前,您必须创建 Amazon S3 连接。

先决条件

  • AWS 访问密钥。请参阅 获取 AWS 凭证
  • 如果您希望连接访问的存储桶已经存在,您必须知道:

    • bucket 所在的区域。
    • bucket 名称或 Amazon 资源名称(ARN)。

流程

  1. 在 Fuse Online 中,在左侧面板中,单击 Connections 以显示任何可用连接。
  2. 在右上角,单击 Create Connection 以显示 Fuse Online 连接器。
  3. Amazon S3 连接器。
  4. Access Key 字段中,输入属于 AWS 帐户中的用户访问密钥 ID 的 Amazon 访问密钥 ID,该密钥管理您希望连接访问的存储桶。

    如果您希望连接访问的存储桶不存在,则 Fuse Online 尝试开始运行集成时,它会使用此访问密钥关联的 AWS 帐户来创建存储桶。但是,如果存储桶已在其他 AWS 帐户中存在,则连接无法创建存储桶,且集成无法启动。

  5. Secret Key 字段中,为您指定的 Amazon 访问密钥 ID 输入 Amazon secret 访问密钥。
  6. Region 字段中,选择存储桶所在的 AWS 区域。如果连接创建存储桶,它会在所选区域中创建存储桶。
  7. Bucket Name 或 Amazon Resource Name 字段中输入您要此连接的存储桶名称,或者输入存储桶的 ARN。

    如果您指定的存储桶尚不存在,则连接会尝试创建带有您指定的名称的存储桶。由于 S3 允许将存储桶用作可公开访问的 URL,所以您指定的存储桶名称必须全局唯一。另外,它必须满足 S3 存储桶命名要求

  8. 单击 Validate。Fuse Online 立即尝试验证连接并显示一条消息,指示验证是否成功。如果验证失败,请根据需要重新传输配置详情,然后重试。
  9. 验证成功后,单击 Next
  10. Name 字段中输入您选择的名称,可帮助您将这个连接与任何其他连接区分开来。例如,输入 Obtain S3 Data
  11. Description 字段中,输入有助于了解此连接的任何信息。例如,输入 Sample S3 连接,该连接从 northeast bucket 获取数据。
  12. Save 查看您创建的连接现在可用。如果您输入了示例名称,您会看到 Obtain S3 Data 显示为可以添加到集成的连接。

2.5.2. 从 Amazon S3 获取数据以触发集成执行

要通过从 Amazon S3 存储桶获取数据来启动集成,请将 Amazon S3 连接添加为简单集成的启动连接。

前提条件

您创建了 Amazon S3 连接。

流程

  1. 在左侧的 Fuse Online 面板中,单击 Integrations
  2. Create Integration
  3. Choose a connection 页面上,单击您要用来启动集成的 Amazon S3 连接。
  4. Choose an action 页面中,选择您要连接执行的操作:

    • Get Object 从连接访问的存储桶获取文件。在 File Name 字段中输入您要获取的文件的名称。如果指定文件不在存储桶中,则它是一个运行时错误。
    • 轮询 Amazon S3 Bucket 定期从连接访问的存储桶中获取文件。配置此操作:

      1. Delay 字段中,接受默认的 500 毫秒,作为轮询之间经过的时间。或者,要指定不同的轮询间隔,输入数字并选择其时间单位。
      2. Maximum Objects to Retrieve 字段中,输入一次轮询操作可以获取的最大文件数。默认值为 10。

        要对可获取的文件数量没有限制,请指定 0 或负整数。当 Retrieve 的最大对象 没有限制时,poll 操作会获取存储桶中的所有文件。

        如果存储桶包含超过指定的最大文件数,则操作会获取最近修改或创建的文件。

      3. Prefix 字段中,可选指定评估为字符串的正则表达式。如果您指定了前缀,则此操作仅在其名称以该字符串开头时检索文件。
      4. 指明您是否希望 获取文件,然后从存储桶中删除这些文件
  5. 配置操作后,点 Next 来指定操作的输出类型。
  6. Select Type 字段中,如果不需要知道数据类型,则接受 类型规格, 然后点 Next。您不需要遵循这些指令的其余部分。

    但是,建议使用结构化的数据类型。例如,如果要在数据映射映射映射器步骤中的连接输出,您必须指定数据类型。数据映射器无法显示非结构化数据的字段。

    要指定数据类型,点 Select Type 字段,并选择以下之一作为 schema 类型:

    • JSON 模式是 描述 JSON 数据结构的文档。文档的介质类型是 application/schema+json
    • JSON 实例 是包含 JSON 数据的文档。文档的介质类型是 application/json
    • XML 模式 是一个描述 XML 数据结构的文档。文档的文件扩展为 .xsd
    • XML 实例 是包含 XML 数据的文档。文档的文件扩展为 .xml
  7. Definition 输入框中,粘贴符合您选择的 schema 类型的定义。例如,如果您选择 JSON 模式,您将粘贴 JSON 模式文件的内容,该文件的介质类型为 application/schema+json
  8. Data Type Name 字段中输入您为数据类型选择的名称。例如,如果您要为供应商指定 JSON 模式,您可以指定 Vendor 作为数据类型名称。

    在创建或编辑使用指定此类型的连接时,您将看到此数据类型名称。Fuse Online 在集成视觉化和数据映射程序中显示类型名称。

  9. Data Type Description 字段中,提供可帮助您区分此类型的信息。当您将鼠标悬停在处理此类型的步骤上时,此描述会出现在数据映射程序中。
  10. 点击 Next

结果

集成现在有一个启动连接,Fuse Online 会提示您选择完成连接。

2.5.3. 将数据添加到 Amazon S3 以完成集成

要通过将数据复制到 Amazon S3 来完成集成,请将 Amazon S3 连接添加为简单的集成结束连接。

先决条件

  • 您创建了 Amazon S3 连接。
  • 您正在创建或编辑简单集成,Fuse Online 会提示您选择完整的连接。

流程

  1. Choose a connection 页面上,单击您要用来完成集成的 Amazon S3 连接。
  2. 选择您要连接执行的操作:

    • 复制对象,将一个或多个对象添加到存储桶。

      要为存储桶添加一个文件,您可以在 File Name 字段中输入其名称。

      要将多个文件添加到存储桶,请不要指定文件名。在这种情况下,操作会添加它从之前集成步骤获得的所有对象。

      如果您使用 poll 操作来获取多个文件,并且指定了文件名,则 Copy Object 操作仅添加从 poll 操作接收的最后一个文件。

    • 删除对象 从存储桶中删除对象。在 File Name 字段中,指定您要删除的对象名称。如果指定文件不在存储桶中,则集成将继续且没有错误。
  3. 配置所选操作后,点 Next 来指定操作的输入类型。
  4. Select Type 字段中,如果不需要知道数据类型,则接受 类型规格, 然后点 Next。您不需要遵循这些指令的其余部分。

    但是,建议使用结构化的数据类型。例如,如果要在数据映射映射映射器步骤中的连接输入,您必须指定数据类型。数据映射器无法显示非结构化数据的字段。

    要指定数据类型,点 Select Type 字段,并选择以下之一作为 schema 类型:

    • JSON 模式是 描述 JSON 数据结构的文档。文档的介质类型是 application/schema+json
    • JSON 实例 是包含 JSON 数据的文档。文档的介质类型是 application/json
    • XML 模式 是一个描述 XML 数据结构的文档。文档的文件扩展为 .xsd
    • XML 实例 是包含 XML 数据的文档。文档的文件扩展为 .xml
  5. Definition 输入框中,粘贴符合您选择的 schema 类型的定义。例如,如果您选择 JSON 模式,您将粘贴 JSON 模式文件的内容,该文件的介质类型为 application/schema+json
  6. Data Type Name 字段中输入您为数据类型选择的名称。例如,如果您要为供应商指定 JSON 模式,您可以指定 Vendor 作为数据类型名称。

    在创建或编辑使用指定此类型的连接时,您将看到此数据类型名称。Fuse Online 在集成视觉化和数据映射程序中显示类型名称。

  7. Data Type Description 字段中,提供可帮助您区分此类型的信息。当您将鼠标悬停在处理此类型的步骤上时,此描述会出现在数据映射程序中。
  8. 点击 Next

结果

连接会出现在集成视觉化的末尾。

2.5.4. 在集成过程中将数据添加到 Amazon S3 中

在集成中,若要向 Amazon S3 添加数据,请将 Amazon S3 连接添加到流中间。

前提条件

  • 您创建了 Amazon S3 连接。
  • 您正在创建或编辑流,Fuse Online 会提示您添加到集成。

流程

  1. 在流视觉化中,点您要添加 Amazon S3 连接的加号。
  2. 点击您要在流中使用的 Amazon S3 连接。
  3. 选择您要连接执行的操作:

    • 复制对象,将一个或多个对象添加到存储桶。

      要为存储桶添加一个文件,您可以在 File Name 字段中输入其名称。

      要将多个文件添加到存储桶,请不要指定文件名。在这种情况下,操作会添加它从之前集成步骤获得的所有对象。

      如果您使用 poll 操作来获取多个文件,并且指定了文件名,则 Copy Object 操作仅添加从 poll 操作接收的最后一个文件。

    • 删除对象 从存储桶中删除对象。在 File Name 字段中,指定您要删除的对象名称。如果指定文件不在存储桶中,则集成将继续且没有错误。
  4. 配置所选操作后,点 Next 来指定操作的输入类型。
  5. Select Type 字段中,如果不需要知道数据类型,则接受 类型规格, 然后点 Next。您不需要遵循这些指令的其余部分。

    但是,建议使用结构化的数据类型。例如,如果要在数据映射映射映射器步骤中的连接输入,您必须指定数据类型。数据映射器无法显示非结构化数据的字段。

    要指定数据类型,点 Select Type 字段,并选择以下之一作为 schema 类型:

    • JSON 模式是 描述 JSON 数据结构的文档。文档的介质类型是 application/schema+json
    • JSON 实例 是包含 JSON 数据的文档。文档的介质类型是 application/json
    • XML 模式 是一个描述 XML 数据结构的文档。文档的文件扩展为 .xsd
    • XML 实例 是包含 XML 数据的文档。文档的文件扩展为 .xml
  6. Definition 输入框中,粘贴符合您选择的 schema 类型的定义。例如,如果您选择 JSON 模式,您将粘贴 JSON 模式文件的内容,该文件的介质类型为 application/schema+json
  7. Data Type Name 字段中输入您为数据类型选择的名称。例如,如果您要为供应商指定 JSON 模式,您可以指定 Vendor 作为数据类型名称。

    在创建或编辑使用指定此类型的连接时,您将看到此数据类型名称。Fuse Online 在集成视觉化和数据映射程序中显示类型名称。

  8. Data Type Description 字段中,提供可帮助您区分此类型的信息。当您将鼠标悬停在处理此类型的步骤上时,此描述会出现在数据映射程序中。
  9. 点击 Next

结果

连接会出现在您添加它的流视觉化中。

第 3 章 连接到 AMQ

在集成中,您可以从 Red Hat AMQ 代理获取信息,或向 Red Hat AMQ 代理发布信息。Red Hat AMQ 使用 OpenWire 协议在客户端和消息代理之间的通信。要与以下代理类型通信,请使用 Red Hat AMQ 连接器创建与感兴趣的代理的连接:

  • 不支持 AMQP 的 Apache ActiveMQ 代理
  • AMQ 6 代理

要与以下代理类型之一通信,请使用 AMQP 连接器 创建与感兴趣的代理的连接:

  • 支持 AMQP 的 Apache ActiveMQ 代理
  • Apache ActiveMQ Artemis
  • AMQ 7 代理
  • EnMasse,它是一个开源的管理平台

要使用 Red Hat AMQ 连接器,请参阅:

3.1. 创建 AMQ 连接

在集成中,获取信息或从发布信息到:

  • 不支持 AMQP 的 Apache ActiveMQ 代理
  • AMQ 6 代理

创建 Red Hat AMQ 连接,您可以将其添加到集成。

先决条件

对于您要连接的 Red Hat AMQ 代理,您有以下内容:

  • 代理 URL
  • 用户帐户凭证
  • 代理的 PEM 证书文本

流程

  1. 在 Fuse Online 中,在左侧面板中,单击 Connections 以显示任何可用连接。
  2. 在右上角,单击 Create Connection 以显示连接器。
  3. Red Hat AMQ 连接器。
  4. 配置连接:

    1. Broker URL 字段中,输入您要向或获取数据的位置,例如 tcp://localhost:61616
    2. User name 字段中,输入您要用来访问此代理的帐户的用户名。
    3. Password 字段中,输入您要用来访问此代理的帐户的密码。
    4. Client ID 字段中,输入允许关闭并重新打开的 ID,而不缺少信息。目的地类型必须是主题。
    5. 如果在开发环境中使用此连接,您可以通过禁用 检查证书 来保存一些时间。禁用检查证书对于开发环境来说比较方便。对于安全生产环境,请始终启用 检查证书
    6. Broker 证书 字段中,粘贴 Red Hat AMQ 代理的 PEM 证书文本。除非禁用检查证书,还需要此项。
    7. Client certificate 字段中,粘贴红帽客户端的 PEM 证书文本。此字段中的内容始终是可选的。
  5. 单击 Validate。Fuse Online 立即尝试验证连接并显示一条消息,指示验证是否成功。如果验证失败,请根据需要重新传输配置详情,然后重试。
  6. 如果验证成功,请单击 Next
  7. Name 字段中输入您选择的名称,可帮助您将这个连接与任何其他连接区分开来。例如,您可以输入 Red Hat AMQ 1
  8. Description 字段中,输入有助于了解此连接的任何信息。例如,输入 使用提供的代理的 Sample Red Hat AMQ 连接。
  9. Save 查看您创建的连接现在可用。如果您输入了示例名称,您会看到 Red Hat AMQ 1 显示为可添加到集成的连接。

3.2. 添加 AMQ 连接以在接收信息时触发集成执行

要在收到 Red Hat AMQ 代理的消息时触发集成执行,请添加 Red Hat AMQ 连接作为启动连接。

前提条件

您创建了 Red Hat AMQ 连接到您要获取信息的 Red Hat AMQ 代理。

流程

  1. 在左侧的 Fuse Online 面板中,单击 Integrations
  2. Create Integration
  3. Choose a connection 页面中,点您要用来启动集成的 Red Hat AMQ 连接。
  4. Choose an action 页面上,选择 Subscribe for messages 操作来接收来自您指定的队列或主题的消息。
  5. 配置操作:

    1. Destination name 字段中,输入要接收数据的队列或主题的名称。
    2. 对于 Destination 类型,接受 队列 或选择 主题
    3. Durable subscription ID 字段中,要允许连接关闭和重新打开而不缺少消息,请输入 durable 订阅 ID。目的地类型必须是主题。
    4. Message selector 字段中,如果只想接收满足特定条件的数据,请输入过滤器表达式。

      消息选择器是包含表达式的字符串。表达式的语法基于 SQL92 条件表达式语法的子集。以下示例中的消息选择器选择具有 NewsType 属性的任何消息,其值设为 SportsOpinion

      NewsType = ’Sports’ OR NewsType = ’Opinion’

      消息消费者仅接收那些标头和属性与消息选择器表达式匹配的消息。消息选择器无法根据消息正文的内容选择消息。

  6. Next 指定操作的输出类型。
  7. Select Type 字段中,如果不需要知道数据类型,则接受 类型规格, 然后点 Next。您不需要遵循这些指令的其余部分。

    但是,建议使用结构化的数据类型。例如,如果要在数据映射映射映射器步骤中的连接输出,您必须指定数据类型。数据映射器无法显示非结构化数据的字段。

    要指定数据类型,点 Select Type 字段,并选择以下之一作为 schema 类型:

    • JSON 模式是 描述 JSON 数据结构的文档。文档的介质类型是 application/schema+json
    • JSON 实例 是包含 JSON 数据的文档。文档的介质类型是 application/json
    • XML 模式 是一个描述 XML 数据结构的文档。文档的文件扩展为 .xsd
    • XML 实例 是包含 XML 数据的文档。文档的文件扩展为 .xml
  8. Definition 输入框中,粘贴符合您选择的 schema 类型的定义。例如,如果您选择 JSON 模式,您将粘贴 JSON 模式文件的内容,该文件的介质类型为 application/schema+json
  9. Data Type Name 字段中输入您为数据类型选择的名称。例如,如果您要为供应商指定 JSON 模式,您可以指定 Vendor 作为数据类型名称。

    在创建或编辑使用指定此类型的连接时,您将看到此数据类型名称。Fuse Online 在集成视觉化和数据映射程序中显示类型名称。

  10. Data Type Description 字段中,提供可帮助您区分此类型的信息。当您将鼠标悬停在处理此类型的步骤上时,此描述会出现在数据映射程序中。
  11. 点击 Next

结果

连接会出现在集成流的开头。

3.3. 发布 AMQ 消息以完成集成

要通过向 Red Hat AMQ 代理发布信息来完成简单的集成,请在简单的集成完成连接中添加 Red Hat AMQ 连接。

先决条件

  • 您创建了与要发布消息的 Red Hat AMQ 代理的连接。
  • 您正创建集成,Fuse Online 正在提示您选择完成连接,或者您编辑集成以更改完成连接。

流程

  1. Choose a connection 页面中,点您要用来完成集成的 Red Hat AMQ 连接。
  2. Choose an action 页面上,选择 Publish messages 操作,将消息发布到您指定的队列或主题。
  3. Destination name 字段中,输入要发送消息的队列或主题的名称。
  4. 对于 Destination 类型,接受 队列 或选择 主题
  5. 选择 Persistent 以保证消息发送,即使连接失败也是如此。
  6. Next 指定操作的输入/输出类型。
  7. Select Type 字段中,如果不需要知道数据类型,则接受 类型规格, 然后点 Next。您不需要遵循这些指令的其余部分。

    但是,建议使用结构化的数据类型。例如,如果要在数据映射器步骤中映射连接输入/输出,您必须指定数据类型。数据映射器无法显示非结构化数据的字段。

    要指定数据类型,点 Select Type 字段,并选择以下之一作为 schema 类型:

    • JSON 模式是 描述 JSON 数据结构的文档。文档的介质类型是 application/schema+json
    • JSON 实例 是包含 JSON 数据的文档。文档的介质类型是 application/json
    • XML 模式 是一个描述 XML 数据结构的文档。文档的文件扩展为 .xsd
    • XML 实例 是包含 XML 数据的文档。文档的文件扩展为 .xml
  8. Definition 输入框中,粘贴符合您选择的 schema 类型的定义。例如,如果您选择 JSON 模式,您将粘贴 JSON 模式文件的内容,该文件的介质类型为 application/schema+json
  9. Data Type Name 字段中输入您为数据类型选择的名称。例如,如果您要为供应商指定 JSON 模式,您可以指定 Vendor 作为数据类型名称。

    在创建或编辑使用指定此类型的连接时,您将看到此数据类型名称。Fuse Online 在集成视觉化和数据映射程序中显示类型名称。

  10. Data Type Description 字段中,提供可帮助您区分此类型的信息。当您将鼠标悬停在处理此类型的步骤上时,此描述会出现在数据映射程序中。
  11. 点击 Next

结果

连接会出现在集成视觉化的末尾。

3.4. 在集成中发布 AMQ 消息

在集成中,要向 Red Hat AMQ 代理发布信息,请在流的中间添加一个 Red Hat AMQ 连接。

先决条件

  • 您创建了与要发布消息的 Red Hat AMQ 代理的连接。
  • 您正在创建或编辑流,Fuse Online 会提示您添加到集成。或者,Fuse Online 正在提示您选择完成连接。

流程

  1. Add to Integration 页面上,单击您要添加连接的加号。如果 Fuse Online 正在提示您选择完成连接,请跳过这一步。
  2. 点流中您要的 Red Hat AMQ 连接。
  3. Choose an action 页面中,选择以下操作之一:

    • 发布消息以将 消息 发布到您指定的队列或主题。配置此操作:

      1. Destination name 字段中,输入要发送消息的队列或主题的名称。
      2. 对于 Destination 类型,接受 队列 或选择 主题
      3. 选择 Persistent 以保证消息发送,即使连接失败也是如此。
    • 使用消息 将消息发送到您指定的和接收响应的 JMS 目的地来请求响应。配置此操作:

      1. Destination name 字段中,输入要发送消息的队列或主题的名称。
      2. 对于 Destination 类型,接受 队列 或选择 主题
      3. Message selector 字段中,如果只想接收满足特定条件的响应,请输入过滤器表达式。

        消息选择器是包含表达式的字符串。表达式的语法基于 SQL92 条件表达式语法的子集。以下示例中的消息选择器选择具有 NewsType 属性的任何消息,其值设为 SportsOpinion

        NewsType = ’Sports’ OR NewsType = ’Opinion’

        消息消费者仅接收那些标头和属性与消息选择器表达式匹配的消息。消息选择器无法根据消息正文的内容选择消息。

      4. Named reply to 字段中,输入队列或主题的名称。目标将其响应发送到此队列或主题。
      5. 选择 Persistent 以保证消息发送,即使连接失败也是如此。
      6. Response time out 字段中,指定此连接在抛出运行时异常前等待响应消息的毫秒数。默认值为 5000 毫秒(5 秒)。
  4. 单击 Next 以指定操作的输入类型,然后单击操作的输出类型。
  5. Select Type 字段中,如果不需要知道数据类型,则接受 类型规格, 然后点 Next。您不需要遵循这些指令的其余部分。

    但是,建议使用结构化的数据类型。例如,如果要在数据映射器步骤中映射连接输入/输出,您必须指定数据类型。数据映射器无法显示非结构化数据的字段。

    要指定数据类型,点 Select Type 字段,并选择以下之一作为 schema 类型:

    • JSON 模式是 描述 JSON 数据结构的文档。文档的介质类型是 application/schema+json
    • JSON 实例 是包含 JSON 数据的文档。文档的介质类型是 application/json
    • XML 模式 是一个描述 XML 数据结构的文档。文档的文件扩展为 .xsd
    • XML 实例 是包含 XML 数据的文档。文档的文件扩展为 .xml
  6. Definition 输入框中,粘贴符合您选择的 schema 类型的定义。例如,如果您选择 JSON 模式,您将粘贴 JSON 模式文件的内容,该文件的介质类型为 application/schema+json
  7. Data Type Name 字段中输入您为数据类型选择的名称。例如,如果您要为供应商指定 JSON 模式,您可以指定 Vendor 作为数据类型名称。

    在创建或编辑使用指定此类型的连接时,您将看到此数据类型名称。Fuse Online 在集成视觉化和数据映射程序中显示类型名称。

  8. Data Type Description 字段中,提供可帮助您区分此类型的信息。当您将鼠标悬停在处理此类型的步骤上时,此描述会出现在数据映射程序中。
  9. 点击 Next

结果

连接会出现在您添加它的集成视觉化中。

第 4 章 连接到 AMQP

在集成中,您可以获取信息或从高级消息队列协议(AMQP)代理发布信息。AMQP 定义客户端和消息代理之间的通信。要与以下代理类型通信,请使用 AMQP 连接器创建与感兴趣的代理的连接:

  • 支持 AMQP 的 Apache ActiveMQ 代理
  • Apache ActiveMQ Artemis
  • AMQ 7 代理
  • EnMasse,它是一个开源的管理平台

要与以下代理类型之一通信,请使用 Red Hat AMQ 连接器 创建与感兴趣的代理的连接:

  • 不支持 AMQP 的 Apache ActiveMQ 代理
  • AMQ 6 代理
注意

可使用 AMQP 连接器创建与不支持 AMQP 或 AMQ 6 代理的 Apache ActiveMQ 代理的连接。这样做需要代理中的传输配置。有关配置代理的详情,请参考 Red Hat JBoss A-MQ 管理和监控 Broker,添加客户端连接点。有关要指定配置值的详情,请参考 Red Hat JBoss A-MQ Connection Reference, Advanced Message Queuing Protocol (AMQP)

要使用 AMQP 连接器,请参阅:

4.1. 创建 AMQP 连接

集成中,若要从 AMQP 代理获取消息或发布消息,可创建 AMQP 连接,您可以将其添加到集成。

先决条件

对于您要连接的 AMQP 代理,您有以下内容:

  • 其 URI
  • 用户帐户凭证
  • 其 PEM 证书文本

流程

  1. 在 Fuse Online 中,在左侧面板中,单击 Connections 以显示任何可用连接。
  2. 在右上角,单击 Create Connection 以显示连接器。
  3. AMQP Message Broker 连接器。
  4. 配置连接:

    1. Connection URI 字段中,输入您要向或获取数据的位置。
    2. User name 字段中,输入您要用来访问此代理的帐户的用户名。
    3. Password 字段中,输入您要用来访问此代理的帐户的密码。
    4. Client ID 字段中,输入允许关闭并重新打开的 ID,而不缺少信息。目的地类型必须是主题。
    5. 如果在开发环境中使用此连接,您可以通过禁用 检查证书 来保存一些时间。禁用检查证书对于开发环境来说比较方便。对于安全生产环境,请始终启用 检查证书
    6. Broker 证书 字段中,粘贴代理的 PEM 证书文本。除非禁用证书检查,还需要此项。
    7. Client certificate 字段中,粘贴客户端的 PEM 证书文本。此字段中的内容始终是可选的。
  5. 单击 Validate。Fuse Online 立即尝试验证连接并显示一条消息,指示验证是否成功。如果验证失败,请根据需要重新传输配置详情,然后重试。
  6. 如果验证成功,请单击 Next
  7. Name 字段中输入您选择的名称,可帮助您将这个连接与任何其他连接区分开来。例如,您可以输入 AMQP 1
  8. Description 字段中,输入有助于了解此连接的任何信息。例如,输入 Sample AMQP 连接
  9. Save 查看您创建的连接现在可用。如果您输入了示例名称,您会看到 AMQP 1 显示为可添加到集成的连接。

4.2. 添加 AMQP 连接以在接收消息时触发集成执行

要在从 AMQP 代理接收消息时触发集成执行,请添加 AMQP 连接作为集成的启动连接。

先决条件

  • 您创建了与要从中接收消息的 AMQP 代理的连接。
  • 您正创建集成,Fuse Online 会提示您选择启动连接。

流程

  1. Choose a connection 页面上,单击您要用来启动集成的 AMQP 连接。
  2. Choose an action 页面上,选择 Subscribe for messages 操作来接收来自您指定的队列或主题的消息。
  3. 配置操作:

    1. Destination name 字段中,输入要接收数据的队列或主题的名称。
    2. 对于 Destination 类型,接受 队列 或选择 主题
    3. Durable subscription ID 字段中,要允许连接关闭和重新打开而不缺少消息,请输入 durable 订阅 ID。目的地类型必须是主题。
    4. Message selector 字段中,如果只想接收满足特定条件的数据,请输入过滤器表达式。

      消息选择器是包含表达式的字符串。表达式的语法基于 SQL92 条件表达式语法的子集。以下示例中的消息选择器选择具有 NewsType 属性的任何消息,其值设为 SportsOpinion

      NewsType = ’Sports’ OR NewsType = ’Opinion’

      消息消费者仅接收那些标头和属性与消息选择器表达式匹配的消息。消息选择器无法根据消息正文的内容选择消息。

  4. Next 指定操作的输出类型。
  5. Select Type 字段中,如果不需要知道数据类型,则接受 类型规格, 然后点 Next。您不需要遵循这些指令的其余部分。

    但是,建议使用结构化的数据类型。例如,如果要在数据映射映射映射器步骤中的连接输出,您必须指定数据类型。数据映射器无法显示非结构化数据的字段。

    要指定数据类型,点 Select Type 字段,并选择以下之一作为 schema 类型:

    • JSON 模式是 描述 JSON 数据结构的文档。文档的介质类型是 application/schema+json
    • JSON 实例 是包含 JSON 数据的文档。文档的介质类型是 application/json
    • XML 模式 是一个描述 XML 数据结构的文档。文档的文件扩展为 .xsd
    • XML 实例 是包含 XML 数据的文档。文档的文件扩展为 .xml
  6. Definition 输入框中,粘贴符合您选择的 schema 类型的定义。例如,如果您选择 JSON 模式,您将粘贴 JSON 模式文件的内容,该文件的介质类型为 application/schema+json
  7. Data Type Name 字段中输入您为数据类型选择的名称。例如,如果您要为供应商指定 JSON 模式,您可以指定 Vendor 作为数据类型名称。

    在创建或编辑使用指定此类型的连接时,您将看到此数据类型名称。Fuse Online 在集成视觉化和数据映射程序中显示类型名称。

  8. Data Type Description 字段中,提供可帮助您区分此类型的信息。当您将鼠标悬停在处理此类型的步骤上时,此描述会出现在数据映射程序中。
  9. 点击 Next

结果

连接会出现在集成流的开头。

4.3. 在流中向 AMQP 发布消息或完成集成

您可以在流中发布消息到 AMQP 代理,或者完成简单的集成。为此,请在流程的中间或简单集成完成连接中添加 AMQP 连接。

先决条件

  • 您创建了与您要发布消息的 AMQP 代理的连接。
  • 您正在创建或编辑流,Fuse Online 会提示您添加到集成。或者,Fuse Online 正在提示您选择简单集成的完成连接。

流程

  1. Add to Integration 页面上,单击您要添加连接的加号。如果 Fuse Online 正在提示您选择完成连接,请跳过这一步。
  2. 点您要用来发布消息的 AMQP 连接。
  3. Choose an action 页面中,选择以下操作之一:

    • 发布消息以将 消息 发布到您指定的队列或主题,而不收到响应。配置此操作:

      1. Destination name 字段中,输入要发送消息的队列或主题的名称。
      2. 对于 Destination 类型,接受 队列 或选择 主题
      3. 选择 Persistent 以保证消息发送,即使连接失败也是如此。
    • 使用消息向您指定的和接收响应的 队列或主题请求响应。

      注意

      当简单集成中的完成连接是 AMQP 连接,它使用消息操作执行 Request 响应,连接会发布消息,但响应将被丢弃。为避免丢失响应,请将 AMQP 连接作为中间连接添加,以使用消息操作执行 Request 响应,并完成与日志步骤的简单集成。

      配置此操作:

      1. Destination name 字段中,输入要发送消息的队列或主题的名称。
      2. 对于 Destination 类型,接受 队列 或选择 主题
      3. Durable subscription ID 字段中,要允许连接关闭和重新打开而不缺少消息,请输入 durable 订阅 ID。目的地类型必须是主题。
      4. Message selector 字段中,如果只想接收满足特定条件的响应,请输入过滤器表达式。

        消息选择器是包含表达式的字符串。表达式的语法基于 SQL92 条件表达式语法的子集。以下示例中的消息选择器选择具有 NewsType 属性的任何消息,其值设为 SportsOpinion

        NewsType = ’Sports’ OR NewsType = ’Opinion’

        消息消费者仅接收那些标头和属性与消息选择器表达式匹配的消息。消息选择器无法根据消息正文的内容选择消息。

  4. Next 指定操作的输入和输出类型。
  5. Select Type 字段中,如果不需要知道数据类型,则接受 类型规格, 然后点 Next。您不需要遵循这些指令的其余部分。

    但是,建议使用结构化的数据类型。例如,如果要在数据映射器步骤中映射连接输入/输出,您必须指定数据类型。数据映射器无法显示非结构化数据的字段。

    要指定数据类型,点 Select Type 字段,并选择以下之一作为 schema 类型:

    • JSON 模式是 描述 JSON 数据结构的文档。文档的介质类型是 application/schema+json
    • JSON 实例 是包含 JSON 数据的文档。文档的介质类型是 application/json
    • XML 模式 是一个描述 XML 数据结构的文档。文档的文件扩展为 .xsd
    • XML 实例 是包含 XML 数据的文档。文档的文件扩展为 .xml
  6. Definition 输入框中,粘贴符合您选择的 schema 类型的定义。例如,如果您选择 JSON 模式,您将粘贴 JSON 模式文件的内容,该文件的介质类型为 application/schema+json
  7. Data Type Name 字段中输入您为数据类型选择的名称。例如,如果您要为供应商指定 JSON 模式,您可以指定 Vendor 作为数据类型名称。

    在创建或编辑使用指定此类型的连接时,您将看到此数据类型名称。Fuse Online 在集成视觉化和数据映射程序中显示类型名称。

  8. Data Type Description 字段中,提供可帮助您区分此类型的信息。当您将鼠标悬停在处理此类型的步骤上时,此描述会出现在数据映射程序中。
  9. 点击 Next

结果

连接会出现在您添加它的集成视觉化中。

第 5 章 连接到 Box

在集成中,您可以从 Box 下载文件,或者将文件上传到 Box。

与 Box 的连接无法启动简单的集成。换句话说,您无法使用 Box 连接来触发集成执行。

以下主题提供详情:

5.1. 将 Fuse Online 注册为 Box 客户端

您必须将 Fuse Online 环境注册为可访问 Box 的客户端应用程序。这样,您可以创建连接到 Box 的任意数量的集成。换句话说,您需要仅通过 Box 注册特定的 Fuse 在线环境。

在每个 Fuse Online 环境中,只有 Fuse Online 注册作为 Box 客户端应用程序。但是,尽管每个 Box 连接都使用相同的注册,但它可以使用不同的用户凭据。

先决条件

流程

  1. 在 Fuse Online 中:

    1. 在左侧面板中,单击 Settings
    2. Settings 页面中,在回调 URL 右侧,点 Copy Callback URL 将 Fuse Online 环境的回调 URL 复制到剪贴板。在此过程中,您将需要此 URL。
  2. 在另一个浏览器标签页中,访问位于 https://app.box.com/developers/console 的 Box 开发人员门户,并执行以下操作:

    1. 登录。
    2. 单击 Create New App
    3. 单击 Custom App,然后单击 Next
    4. 对于 身份验证方法,请单击 Standard OAuth 2.0 (User Authentication),然后单击 Next
    5. 输入应用程序名称,例如 Fuse Online Client,再点 Create App
    6. View Your App
    7. 可选的。在 OAuth 2.0 Credentials 部分中,将客户端 ID 和客户端 secret 复制到安全位置。创建与 Box 的连接需要这些值。
    8. Save Changes

结果

您的 Fuse Online 环境现在注册为 Box 客户端,这意味着 Fuse Online 可以访问您登录的 Box 帐户中的内容。

5.2. 创建 Box 连接

在集成中,要下载或上传 Box 文件,请创建一个 Box 连接,您可以将其添加到集成中。您可以将相同的连接添加到任意数量的集成。

先决条件

  • 有一个 Box 客户端应用程序可将您的 Fuse 在线环境注册为可访问 Box 的应用。
  • 您可以登录到创建该应用程序的 Box 开发人员帐户,或者具有该应用的 Box 客户端 ID 和 Box 客户端机密。
  • 您知道希望此连接用于访问 Box 的 Box 帐户的用户名和密码。

流程

  1. 如果您已有 Box 客户端 ID 和客户端机密,请跳至下一步。否则,要在新的浏览器标签页中获取这些值,请访问 https://app.box.com/developers/console 并执行以下操作:

    1. 登录您在其中创建应用程序的 Box 帐户,该帐户注册了 Fuse Online 环境对 Box 的访问权限。
    2. My Apps 页面上,单击 Fuse Online 应用以显示其设置。
    3. 在左侧,单击 Configuration
    4. OAuth 2.0 Credentials 部分中,将客户端 ID 复制到剪贴板。
  2. 在不同的浏览器标签页中,在 Fuse Online 中:

    1. 单击 Connections
    2. 单击 Create Connection
    3. 点 Box 连接器。
    4. User name 字段中,输入您希望此连接用于下载或上传 Box 文件的用户名。
    5. User password 字段中,输入该帐户的密码。
    6. Client ID 字段中,粘贴 Box 客户端 ID。
  3. 可选的。如果您需要,返回到 Box 应用的 OAuth 2.0 凭据,将客户端 secret 复制到剪贴板,然后返回到 Fuse Online。
  4. Client secret 字段中,粘贴 Box 客户端 secret 字符串。
  5. 单击 Validate。Fuse Online 显示一条消息,指示它是否可以验证此连接。如果验证失败,请重试,并确保输入正确的值。
  6. 验证成功后,单击 Next
  7. Name 字段中输入您选择的名称,可帮助您将这个连接与任何其他连接区分开来。例如,输入 Box 销售帐户
  8. Description 字段中,输入有助于了解此连接的任何信息。例如,输入 Sample Box 连接,该连接可以访问我们公司 Sales Box 帐户中的内容。
  9. Save 查看您创建的连接现在可用。如果您输入了示例名称,您会看到 Box 销售帐户 显示为可以添加到集成的连接。

5.3. 在集成中下载或上传 Box 文件

要从 Box 下载文件,或者在流中上传文件到 Box,请在流的中间添加一个 Box 连接。

先决条件

  • 您创建了 Box 连接。
  • 您正在创建或编辑流,Fuse Online 会提示您添加到集成。

流程

  1. Add to Integration 页面上,单击您要添加连接的加号。
  2. 单击您要集成的 Box 连接。
  3. Choose an action 页面中,选择以下之一:

    • 从此连接访问的 Box 帐户 下载,以获取一个文件。
    • 上传文件 以上传到此连接访问的 Box 帐户。
  4. 配置您选择的操作。

    下载文件

    1. File encoding 字段中,接受 UTF-8,或者指定您希望连接获取的文件的编码。
    2. 可选的。在 File ID 字段中,为您要获取的文件指定 Box ID。当您在 Box 中查看文件时,文件 ID 位于 URL 的末尾。例如,在这个 URL 中: https://app.box.com/file/537364588548,文件 ID 为 537364588548

      或者,您可以在此连接前添加数据映射程序步骤,并将上一步中的文件 ID 映射到此连接。

      在本发行版本中,您只能下载一个文件。但是,从上一步中映射文件 ID 可以识别文件动态,例如,ID 可以来自数据库表。这意味着每个执行可能会下载不同的文件。

    上传文件

    1. Parent folder ID 字段中,输入 Box 文件夹的 ID,以将文件上传到。

      当您在 Box 中查看文件夹内容时,box 文件夹 ID 位于 URL 的末尾。在本例中: https://app.box.com/folder/89490291417,文件夹 ID 是 89490291417。在本发行版本中,您只能上传一个文件。

    2. 可选的。在 File name 字段中,输入新文件的名称。如果您指定了指定 Box 文件夹中的文件的名称,连接会覆盖位于 文件夹中的文件。

      到连接的输入必须是您要上传到 Box 的文件。如果没有指定文件名,连接会将名称与输入文件相同的文件上传到连接,只要该名称的文件不存在。

    3. Next 指定上传操作的输入类型。
    4. Select Type 字段中,接受 Type 规格不需要,然后点 Next

结果

连接会出现在您添加它的集成流中。

5.4. 将文件上传到 Box 以完成集成

要通过上传文件到 Box 来完成集成,可在集成结束连接中添加 Box 连接。

先决条件

  • 您创建了 Box 连接。
  • 您正在创建或编辑简单集成,Fuse Online 会提示您选择完成连接。

流程

  1. Choose a connection 页面上,单击您要用来完成集成的 Box 连接。
  2. Choose an action 页面上,选择 Upload action,将文件上传到此连接访问的 Box 帐户。
  3. Parent folder ID 字段中,输入 Box 文件夹的 ID,以将文件上传到。

    当您在 Box 中选择文件夹时,选框文件夹 ID 位于 URL 的末尾。在本例中: https://app.box.com/folder/89490291417,文件夹 ID 是 89490291417。在本发行版本中,您只能上传一个文件。

  4. 可选的。在 File name 字段中,输入新文件或现有文件的名称。如果您指定了指定 Box 文件夹中的文件的名称,连接会覆盖位于 文件夹中的文件。

    到连接的输入必须是您要上传到 Box 的文件。如果没有指定文件名,连接将名称与输入文件同名的文件上传到连接。

  5. 点击 Next
  6. Select Type 字段中,接受 Type 规格不需要,然后点 Next

结果

连接会出现在集成视觉化的末尾。

第 6 章 连接到 Dropbox

在集成中,您可以从 Dropbox 下载文件,或者上传文件到 Dropbox。以下主题提供详情:

6.1. 将 Fuse Online 注册为 Dropbox 客户端

您必须将 Fuse Online 环境注册为能够访问 Dropbox 的客户端应用程序。这可让您创建连接到 Dropbox 的任意数量的集成。换句话说,您需要仅通过 Dropbox 注册特定的 Fuse 在线环境。

在每个 Fuse Online 环境中,只有 Fuse Online 注册为 Dropbox 客户端应用程序。但是,虽然每个 Dropbox 连接都使用相同的注册,但它可以使用不同的用户凭据。

前提条件

您可以登录到您要用来下载或上传文件的 Dropbox 帐户。

流程

  1. 在 Fuse Online 中:

    1. 在左侧面板中,单击 Settings
    2. Settings 页面中,在回调 URL 右侧,点 Copy Callback URL 将 Fuse Online 环境的回调 URL 复制到剪贴板。在此过程中,您将需要此 URL。
  2. 在另一个浏览器标签页中,进入 https://www.dropbox.com 并执行以下操作:

    1. 登录到具有集成中要访问数据的 Dropbox 帐户。
    2. 登录后,请访问 https://www.dropbox.com/developers/apps
    3. Create App
    4. 选择 Dropbox API
    5. 在页面的顶部附近,在 注册期间开始,输入此回调 URL: 粘贴在此流程开始时复制到剪贴板的 URL。例如,您粘贴的 URL 如下所示: https://app-proj9128.7b63.fuse-ignite.openshiftapps.com/api/v1/credentials/callback
    6. 选择 Fuse Online 是否可以访问单个文件夹或所有文件夹和文件。
    7. 为您的 Dropbox 应用程序指定一个名称。例如,您可以指定 Fuse Online Access From Aslan LLC。您指定的名称在 Dropbox 应用程序名称集中必须是唯一的。
    8. 选中该框,以指明您同意 Dropbox API 条款和条件。
    9. Create App
    10. 在新应用程序的 Dropbox Settings 页面中,在 OAuth2 Redirect URI 的输入字段中,粘贴 Fuse Online URL,您在此流程开始时复制到剪贴板。
    11. 点击 Add

结果

您的 Fuse Online 环境现在注册为 Dropbox 客户端,这意味着 Fuse Online 可以访问您登录的 Dropbox 帐户中的内容。

6.2. 创建 Dropbox 连接

在集成中,要下载或上传 Dropbox 文件,您可以创建一个 Dropbox 连接,您可以将其添加到集成。您可以将相同的连接添加到任意数量的集成。

前提条件

您已将 Fuse Online 环境注册为可访问 Dropbox 的应用程序。

流程

  1. 在新浏览器标签页中,进入 https://www.dropbox.com 并执行以下操作:

    1. 登录您在其中创建从 Fuse Online 环境访问的应用程序的 Dropbox 帐户。
    2. 转至 https://www.dropbox.com/developers/apps
    3. 单击 Fuse Online 应用以显示其设置。
  2. 在另一个浏览器标签页中,在 Fuse Online 中执行以下操作:

    1. 在左侧面板中,点 Connections 以显示任何可用连接。
    2. 在右上角,单击 Create Connection 以显示可用的连接器。
    3. 单击 Dropbox 连接器。
  3. 返回到应用程序的 Dropbox 设置,并执行以下操作:

    1. 向下滚动,以查看生成的访问令牌
    2. Generate
    3. 将生成的访问令牌复制到剪贴板。
  4. 回到 Fuse Online,在 Configure Connection 页面中,在 Access Token 字段中粘贴生成的访问令牌。
  5. Client Identifier 字段中,输入您在创建 Dropbox 应用时指定的名称。
  6. 单击 Validate。Fuse Online 显示一条消息,指示它是否可以验证此连接。如果验证失败,请重试,并确保输入正确的值。
  7. 验证成功后,单击 Next
  8. Name 字段中输入您选择的名称,可帮助您将这个连接与任何其他连接区分开来。例如,输入 Dropbox Connect 1
  9. Description 字段中,输入有助于了解此连接的任何信息。例如,输入 Sample Dropbox 连接,该连接可以访问我们公司 Dropbox 帐户中的所有内容。
  10. Save 查看您创建的连接现在可用。如果您输入了示例名称,您会看到 Dropbox Connect 1 显示为一个连接,您可以选择添加到集成。

6.3. 从 Dropbox 获取文件以触发集成执行

若要通过从 Dropbox 下载文件来启动集成,可添加一个 Dropbox 连接作为启动连接。

前提条件

您创建了 Dropbox 连接。

流程

  1. 在左侧的 Fuse Online 面板中,单击 Integrations
  2. Create Integration
  3. Choose a connection 页面上,单击您要用来启动集成的 Dropbox 连接。
  4. Choose an action 页面上,选择 Download 操作,以从此连接访问的 Dropbox 帐户获取一个或多个文件。
  5. 要配置操作,请在 Folder or name path to download 字段中指定您希望集成要获取的内容的文件名路径。在本发行版本中,您只能下载一个文件。
  6. Next 指定操作的输出类型。
  7. Select Type 字段中,如果不需要知道数据类型,则接受 类型规格, 然后点 Next。您不需要遵循这些指令的其余部分。

    但是,建议使用结构化的数据类型。例如,如果要在数据映射映射映射器步骤中的连接输出,您必须指定数据类型。数据映射器无法显示非结构化数据的字段。

    要指定数据类型,点 Select Type 字段,并选择以下之一作为 schema 类型:

    • JSON 模式是 描述 JSON 数据结构的文档。文档的介质类型是 application/schema+json
    • JSON 实例 是包含 JSON 数据的文档。文档的介质类型是 application/json
    • XML 模式 是一个描述 XML 数据结构的文档。文档的文件扩展为 .xsd
    • XML 实例 是包含 XML 数据的文档。文档的文件扩展为 .xml
  8. Definition 输入框中,粘贴符合您选择的 schema 类型的定义。例如,如果您选择 JSON 模式,您将粘贴 JSON 模式文件的内容,该文件的介质类型为 application/schema+json
  9. Data Type Name 字段中输入您为数据类型选择的名称。例如,如果您要为供应商指定 JSON 模式,您可以指定 Vendor 作为数据类型名称。

    在创建或编辑使用指定此类型的连接时,您将看到此数据类型名称。Fuse Online 在集成视觉化和数据映射程序中显示类型名称。

  10. Data Type Description 字段中,提供可帮助您区分此类型的信息。当您将鼠标悬停在处理此类型的步骤上时,此描述会出现在数据映射程序中。
  11. 点击 Next

结果

该连接启动简单集成,Fuse Online 会提示您选择完成连接。

6.4. 将文件添加到 Dropbox 以完成集成

要通过上传文件到 Dropbox 来完成集成,可在集成结束连接中添加 Dropbox 连接。

先决条件

  • 您创建了 Dropbox 连接。
  • 您正在创建或编辑集成,Fuse Online 会提示您选择完成连接。

流程

  1. Choose a connection 页面上,单击您要用来完成集成的 Dropbox 连接。
  2. Choose an action 页面上,选择 Upload action,将当前的集成数据添加到此连接访问的 Dropbox 帐户。
  3. Remote Path 字段中,输入您要上传的文件的本地文件名路径。dropbox 存储具有相同路径和名称的文件。在本发行版本中,您只能上传一个文件。
  4. 对于 Upload 模式

    • 选择 Add 仅当具有相同名称的文件尚未在同一 Dropbox 文件夹中时上传文件。如果具有相同名称的文件已位于同一 Dropbox 文件夹中,则该文件不会被上传,并且集成将继续。无论您要上传的内容是否已更新,都会产生此行为。
    • 选择 Force 以确保即使同一 Dropbox 文件夹中存在具有相同名称的文件也上传该文件。dropbox 覆盖已具有上传的文件的文件。
  5. Next 指定操作的输入类型。
  6. Select Type 字段中,如果不需要知道数据类型,则接受 类型规格, 然后点 Next。您不需要遵循这些指令的其余部分。

    但是,建议使用结构化的数据类型。例如,如果要在数据映射映射映射器步骤中的连接输入,您必须指定数据类型。数据映射器无法显示非结构化数据的字段。

    要指定数据类型,点 Select Type 字段,并选择以下之一作为 schema 类型:

    • JSON 模式是 描述 JSON 数据结构的文档。文档的介质类型是 application/schema+json
    • JSON 实例 是包含 JSON 数据的文档。文档的介质类型是 application/json
    • XML 模式 是一个描述 XML 数据结构的文档。文档的文件扩展为 .xsd
    • XML 实例 是包含 XML 数据的文档。文档的文件扩展为 .xml
  7. Definition 输入框中,粘贴符合您选择的 schema 类型的定义。例如,如果您选择 JSON 模式,您将粘贴 JSON 模式文件的内容,该文件的介质类型为 application/schema+json
  8. Data Type Name 字段中输入您为数据类型选择的名称。例如,如果您要为供应商指定 JSON 模式,您可以指定 Vendor 作为数据类型名称。

    在创建或编辑使用指定此类型的连接时,您将看到此数据类型名称。Fuse Online 在集成视觉化和数据映射程序中显示类型名称。

  9. Data Type Description 字段中,提供可帮助您区分此类型的信息。当您将鼠标悬停在处理此类型的步骤上时,此描述会出现在数据映射程序中。
  10. 点击 Next

结果

连接会出现在集成视觉化的末尾。

6.5. 在集成期间访问 Dropbox

要在流中间将文件上传到 Dropbox,请在流的中间添加一个 Dropbox 连接。

先决条件

  • 您创建了 Dropbox 连接。
  • 您正在创建或编辑流,Fuse Online 会提示您添加到集成。

流程

  1. Add to Integration 页面上,单击您要添加连接的加号。如果 Fuse Online 正在提示您选择完成连接,请跳过这一步。
  2. 单击您要集成的 Dropbox 连接。
  3. Choose an action 页面上,选择 Upload,将当前的集成数据添加到此连接访问的 Dropbox 帐户。
  4. 配置此操作:

    1. Remote Path 字段中,指定要上传的文件的本地路径和文件名。dropbox 存储具有相同路径和名称的文件。在本发行版本中,您只能上传一个文件。
    2. 对于 Upload 模式

      • 选择 Add 仅当具有相同名称的文件尚未在同一 Dropbox 文件夹中时上传文件。如果具有相同名称的文件已位于同一 Dropbox 文件夹中,则该文件不会被上传,并且集成将继续。无论您要上传的内容是否已更新,都会产生此行为。
      • 选择 Force 以确保即使同一 Dropbox 文件夹中存在具有相同名称的文件也上传该文件。dropbox 覆盖已具有上传的文件的文件。
  5. Next 指定操作的输入和输出类型。
  6. Select Type 字段中,如果不需要知道数据类型,则接受 类型规格, 然后点 Next。您不需要遵循这些指令的其余部分。

    但是,建议使用结构化的数据类型。例如,如果要在数据映射器步骤中映射连接输入/输出,您必须指定数据类型。数据映射器无法显示非结构化数据的字段。

    要指定数据类型,点 Select Type 字段,并选择以下之一作为 schema 类型:

    • JSON 模式是 描述 JSON 数据结构的文档。文档的介质类型是 application/schema+json
    • JSON 实例 是包含 JSON 数据的文档。文档的介质类型是 application/json
    • XML 模式 是一个描述 XML 数据结构的文档。文档的文件扩展为 .xsd
    • XML 实例 是包含 XML 数据的文档。文档的文件扩展为 .xml
  7. Definition 输入框中,粘贴符合您选择的 schema 类型的定义。例如,如果您选择 JSON 模式,您将粘贴 JSON 模式文件的内容,该文件的介质类型为 application/schema+json
  8. Data Type Name 字段中输入您为数据类型选择的名称。例如,如果您要为供应商指定 JSON 模式,您可以指定 Vendor 作为数据类型名称。

    在创建或编辑使用指定此类型的连接时,您将看到此数据类型名称。Fuse Online 在集成视觉化和数据映射程序中显示类型名称。

  9. Data Type Description 字段中,提供可帮助您区分此类型的信息。当您将鼠标悬停在处理此类型的步骤上时,此描述会出现在数据映射程序中。
  10. 点击 Next

结果

连接会出现在您添加它的集成流中。

第 7 章 连接到电子邮件服务器(IMAP, POP3, SMTP)

集成可以连接到 IMAP 或 POP3 电子邮件服务器,以检索电子邮件消息或连接到 SMTP 电子邮件服务器以发送电子邮件消息。要在检索电子邮件时触发集成执行,请创建一个到 IMAP 或 POP3 电子邮件服务器的连接,然后将该连接添加为简单集成的启动连接。要从流中发送电子邮件,请创建一个到 SMTP 电子邮件服务器的连接,然后将该连接添加到流的中间或完成简单集成。

详情请查看:

7.1. 创建到 IMAP 或 POP3 电子邮件服务器的连接

您必须先创建与 IMAP 或 POP3 电子邮件服务器的连接,然后才能创建由接收电子邮件触发其执行的简单集成。

先决条件

您必须熟悉此连接访问的电子邮件服务器。具体来说,您必须知道:

  • 电子邮件服务器是否使用 IMAP 还是 POP3 协议。
  • 是否需要身份验证凭据。如果是,则必须具有用户名和密码。
  • 是否实施了安全方法。如果是,您必须了解哪种方法。
  • 是否需要服务器证书。如果是,则必须指定它。

流程

  1. 在 Fuse Online 中,在左侧面板中,单击 Connections 以显示任何可用连接。
  2. 在右上角,单击 Create Connection 以显示 Fuse Online 连接器。
  3. 单击 Receive Email 连接器。
  4. 配置连接:

    1. Protocol 字段中,接受 imap 或选择 pop3
    2. Email Host Name 字段中,输入电子邮件服务器主机名、虚拟主机名称或 IP 地址。
    3. Email Server Port Number 字段中,输入电子邮件服务器侦听的端口号。
    4. User Name 字段中,指定此连接有权访问的电子邮件帐户的用户名。在进行集成期间,此连接会轮询此电子邮件帐户以获取消息。

      很少是,电子邮件服务器无法验证访问权限。在这种情况下,不需要指定用户名和密码。

    5. Password 字段中,指定此连接被授权访问的电子邮件帐户的密码。
    6. 可选的。在 Security Method 字段中,如果电子邮件服务器实施安全方法,请选择 StartTLSSSL/TLS
    7. 可选的。在 Server Certificate 字段中,如果电子邮件服务器不是公共服务器,即位于内部网络中,如果您选择了 StartTLSSSL/TLS 作为安全方法,请在此字段中粘贴自签名电子邮件服务器证书。Fuse Online 无法验证是否需要服务器证书且未指定服务器证书。
  5. 单击 Validate。Fuse Online 立即尝试验证连接并显示一条消息,指示验证是否成功。如果验证失败,请根据需要重新传输配置详情,然后重试。
  6. 验证成功后,单击 Next
  7. Name 字段中输入您选择的名称,可帮助您将这个连接与任何其他连接区分开来。例如,输入 Obtain Info Emails
  8. Description 字段中,输入有助于了解此连接的任何信息。例如,输入 连接到我们的公司电子邮件服务器以获取发送到 info@ourcompany.com 的信息。
  9. Save 查看您创建的连接现在可用。如果您输入了示例名称,您会看到 Obtain Info Emails 显示为一个连接,您可以选择添加到集成。

7.2. 创建到 SMTP 电子邮件服务器的连接

您必须先创建与 SMTP 电子邮件服务器的连接,然后才能编辑集成流,以便它连接到 SMTP 电子邮件服务器来发送电子邮件。

先决条件

您必须熟悉此连接访问的电子邮件服务器。具体来说,您必须知道:

  • 是否需要身份验证凭据。如果是,则必须具有用户名和密码。
  • 是否实施了安全方法。如果是,您必须了解哪种方法。
  • 是否需要服务器证书。如果是,则必须指定它。

流程

  1. 在 Fuse Online 中,在左侧面板中,单击 Connections 以显示任何可用连接。
  2. 在右上角,单击 Create Connection 以显示 Fuse Online 连接器。
  3. 单击 Send Email 连接器。
  4. 配置连接:

    1. Email Host Name 字段中,输入电子邮件服务器主机名、虚拟主机名称或 IP 地址。
    2. Email Server Port Number 字段中,输入电子邮件服务器侦听的端口号。
    3. User Name 字段中,指定此连接有权访问的电子邮件帐户的用户名。在执行集成期间,此连接使用此电子邮件帐户来发送消息。

      很少是,电子邮件服务器无法验证访问权限。在这种情况下,不需要指定用户名和密码。

    4. Password 字段中,指定此连接被授权访问的电子邮件帐户的密码。
    5. 可选的。在 Security Method 字段中,如果电子邮件服务器实施安全方法,请选择 StartTLSSSL/TLS
    6. 可选的。在 Server Certificate 字段中,如果电子邮件服务器不是公共服务器,即位于内部网络中,如果您选择了 StartTLSSSL/TLS 作为安全方法,请在此字段中粘贴自签名电子邮件服务器证书。Fuse Online 无法验证是否需要服务器证书且未指定服务器证书。
  5. 单击 Validate。Fuse Online 立即尝试验证连接并显示一条消息,指示验证是否成功。如果验证失败,请根据需要重新传输配置详情,然后重试。
  6. 验证成功后,单击 Next
  7. Name 字段中输入您选择的名称,可帮助您将这个连接与任何其他连接区分开来。例如,输入 Send Emails to Leads
  8. Description 字段中,输入有助于了解此连接的任何信息。例如,输入 Connect to our company email server to send information from info@ourcompany.com。
  9. Save 查看您创建的连接现在可用。如果您输入了示例名称,您将看到发送电子邮件 显示为 Leads,您可以选择添加到集成。

7.3. 获取触发集成执行的电子邮件

要在收到电子邮件时触发集成执行,请将 IMAP 或 POP3 电子邮件服务器连接添加为简单集成的启动连接。

先决条件

  • 您创建了 IMAP 或 POP3 电子邮件服务器连接,该连接配置为访问您要从中获取电子邮件的帐户。
  • 您知道要从中检索消息的文件夹名称。

流程

  1. 在左侧的 Fuse Online 面板中,单击 Integrations
  2. Create Integration
  3. Choose a connection 页面上,单击您要用来启动集成的电子邮件服务器连接。
  4. Choose an action 页面上,选择 Receive Email 以定期从连接被授权访问的电子邮件帐户中检索消息。
  5. 配置操作:

    1. Folder 字段留空以从 inbox 获取电子邮件。或者,若要从特定文件夹获取消息,请输入该文件夹的名称。

      如果此连接访问 POP3 电子邮件服务器,则只支持标准文件夹,如 InboxSent

    2. 选中 Unseen Only 复选框,以仅获取在电子邮件服务器上标记为未读取的消息。
    3. Delay 字段中,接受默认的 5 秒,作为消息轮询之间经过的时间。或者,要指定不同的轮询间隔,输入数字并选择其时间单位。
    4. Maximum Emails 字段中,输入一次轮询操作可以返回的最大消息数。默认值为 5。如果 inbox 或 文件夹包含可以返回的最大消息数,则连接会将最旧的消息返回到为 最大电子邮件 设置的数量。

      如果您希望每次轮询获得,请将 最大电子邮件 设置为 -1

      • 当选择 Unseen Only 时,指定文件夹中的所有新消息都会被选择。
      • 如果没有选择 Unseen Only,则指定文件夹中的所有消息。
  6. 点击 Next

结果

连接会出现在集成流的开头。在执行期间,如果轮询返回电子邮件,连接会将消息传递给集成中的下一步。如果轮询没有返回任何电子邮件,则集成将继续运行,但 Fuse Online 不会触发其余的集成步骤。

示例

考虑配置如下的 Receive Email 操作:

  • Folder 字段为空,以便连接轮询 inbox。
  • 可以选择不 可预见。
  • 接受 Delay (5 秒) 和最大电子邮件 (5)的默认值。

假设 10 个消息在下一次轮询前延迟期间到达 inbox。连接返回 5 个最旧的消息。在下一次轮询 5 秒时,连接会返回其他 5 消息。即使出现新消息,情况也是如此,因为如果消息超过为 最大电子邮件 设置的数量,连接会返回最旧的消息。

7.4. 从集成发送电子邮件

在流中或完成简单集成,您可以添加发送电子邮件服务器连接来发送消息。

先决条件

  • 您创建了 SMTP 电子邮件服务器连接,该连接配置为访问您要从中发送消息的帐户。
  • Fuse Online 会提示您添加到集成,或者选择完成连接以进行简单集成。

流程

  1. Add to Integration 页面上,单击您要添加连接的加号。如果 Fuse Online 正在提示您选择完成连接,请跳过这一步。
  2. 点击您要用来发送消息的电子邮件服务器连接。
  3. 选择 Send Email 操作。
  4. Email from 字段中,输入发送消息的电子邮件地址。即使计划添加数据映射器步骤(将之前集成步骤中的电子邮件地址映射到此连接),也需要这样做。
  5. recommended:在每个以下字段中指定值。使用逗号分隔多个电子邮件地址。

    1. 电子邮件到
    2. 电子邮件主题
    3. 电子邮件文本
    4. 电子邮件 cc
    5. 电子邮件 bcc
  6. 参数优先级 字段中,接受 输入值或选择 Consumed Data。这决定了以下哪个优先级:

    • 在此操作配置中输入值
    • 映射到此连接的数据值

    建议是选择 Consumed Data。这意味着您在电子邮件字段中指定的值作为默认值。

  7. Next 将连接添加到流。

结果

连接会出现在您添加它的集成流中。

后续步骤

将其他所有需要连接到流。然后,在发送电子邮件的连接前添加数据映射程序步骤。在数据映射程序步骤中,将 source 字段映射到用于发送电子邮件的目标字段。

第 8 章 连接到 FHIR

快速健康互操作性资源(FHIR)是交换医疗数据的标准。在集成中,您可以获取一个或多个 FHIR 资源,创建或更新资源,更新资源中的一个或多个字段,或使用事务来创建多个资源。为此,请将 FHIR 连接添加到流中间,或者作为简单的集成完成连接。

Fuse 在线连接到 FHIR:

  • 可以与使用基本令牌(OAuth)身份验证的 FHIR 服务器通信。
  • 可以针对符合 FHIR DSTU3 的所有 FHIR DSTU3 操作。
  • 无法对扩展进行操作,允许将自定义数据存储在资源中。如果扩展位于从 FHIR 服务器接收的数据中,集成会静默忽略它。

在连接到 FHIR 的集成中,在数据映射器步骤中,您只能映射 FHIR 列表字段的深度级别。换句话说,如果 FHIR 列表包含列表,则无法映射嵌套列表中的字段。为缓解这个限制,Fuse Online 将一些 FHIR 资源列表字段转换为单值字段,例如,列表字段中的地址可能会作为一个字段在数据映射程序中显示。

连接到 FHIR 的详情位于以下主题:

8.1. 创建到 FHIR 服务器的连接

在集成中,若要在 FHIR 资源上运行,请创建一个到 FHIR 服务器的连接,然后将该连接添加到流中或作为简单集成的完成连接。

FHIR 连接不能是简单集成的开始连接。但是,您可以启动与定期触发 FHIR 连接的计时器的简单集成。

先决条件

  • 您必须知道您要连接的 FHIR 服务器的 URL。
  • 您必须具有访问 FHIR 服务器的授权凭证。您应该从 FHIR 服务器管理员获取它们。很少情况下,FHIR 服务器不需要身份验证,您可以在不指定凭证的情况下创建连接。例如,私有网络中的公共 FHIR 服务器或 FHIR 服务器可能不需要身份验证。

流程

  1. 在 Fuse Online 中,在左侧面板中,单击 Connections 以显示任何可用连接。
  2. 在右上角,单击 Create Connection 以显示连接器。
  3. 点击 FHIR 连接器并配置连接,如下所示:

    1. FHIR version 字段中,接受 DSTU3,这是必需的。
    2. FHIR 服务器 URL 字段中,输入您要访问的 FHIR 服务器的 URL。在创建集成时,您可以接受默认的测试服务器 http://fhirtest.uhn.ca/baseDstu3
    3. FHIR 服务器用户名 字段中,输入您的用户名。这是使用基本身份验证的 FHIR 服务器所需要的。
    4. FHIR 服务器 密码字段中,输入您的密码,使用基本身份验证的 FHIR 服务器还需要该密码。
    5. FHIR 服务器 bearer 令牌 字段中,输入您的令牌。这是使用 OAuth 身份验证的 FHIR 服务器所需要的。
  4. 单击 Validate。Fuse Online 立即尝试验证连接并显示一条消息,指示验证是否成功。如果验证失败,请重新发布输入参数并重试。
  5. 如果验证成功,请单击 Next
  6. Name 字段中输入您选择的名称,可帮助您将这个连接与任何其他连接区分开来。例如,您可以输入 FHIR West
  7. Description 字段中,输入有助于了解此连接的任何信息。
  8. Save 查看您创建的连接现在可用。如果您输入了示例名称,您会看到 FHIR West 显示为一个连接,您可以选择添加到集成。

8.2. 从 FHIR 服务器获取资源

在集成中,您可以获取您指定的类型的一个资源。为此,请将 FHIR 连接添加到流中间。

先决条件

  • 您创建了到具有您要获取资源的 FHIR 服务器的连接。
  • 您正在创建或编辑流,Fuse Online 会提示您添加到集成。

流程

  1. Add to Integration 页面上,单击您要添加连接的加号。
  2. 点可访问您要获取的资源的 FHIR 连接。
  3. Choose an action 页面上,选择 Read
  4. 单击 Resource Type 字段,以显示 FHIR 资源类型的列表。选择或输入您要获取的资源类型。
  5. Contained Resource Types 字段中,如果您想要的资源类型包含其他资源类型,请选择它们。如果您需要选择多个,请使用 Ctrl 键。

    识别包含的资源类型可让数据映射器显示包含资源中的字段。如果没有指定包含的资源类型,则无法从包含资源中的任何字段映射。选择没有实际包含的资源没有损害。

  6. Resource Id 字段中输入您想要的资源 ID。或者,如果您计划将其从之前的步骤中映射,请将此字段留空。
  7. Resource version 字段中,可以选择为资源指定版本 ID。将此字段留空以获取资源的最新版本,或者映射您要从上一步中获取的资源版本 ID。
  8. Next 将这个连接添加到流中。

结果

连接会出现在您添加它的集成视觉化中。在执行过程中,此连接会返回一个资源。

后续步骤

要将值映射到 Resource Id 字段或 Resource version 字段,请在此连接前添加数据映射程序步骤。

8.3. 查询 FHIR 服务器以获取资源

在集成中,您可以查询 FHIR 服务器来获取满足您指定的查询的特定 FHIR 资源实例。例如,假设您要确保 65 和更早的病人都收到了 pneumonia vaccination。指定查询,以获取在 1955 之前为生存者的病人资源。为此,请将 FHIR 连接添加到流中间。

先决条件

  • 您创建了到具有您要获取资源的 FHIR 服务器的连接。
  • 您正在创建或编辑流,Fuse Online 会提示您添加到集成。

流程

  1. Add to Integration 页面上,单击您要添加连接的加号。
  2. 点具有您要获取的资源的 FHIR 连接。
  3. Choose an action 页面上,选择 Search
  4. 单击 Resource Type 字段,以显示 FHIR 资源类型的列表。选择或输入您要获取的资源类型。
  5. Query 字段中,指定 FHIR 查询或将此字段留空来映射上一步中的查询。有关构成 FHIR 查询的详情,请参阅 FHIR 版本 3 搜索
  6. Next 将这个连接添加到流中。

结果

连接会出现在您添加它的集成视觉化中。在执行过程中,此连接会返回一个满足您指定的查询的资源列表。Fuse Online 将此列表视为集合。

后续步骤

如果您没有指定查询,请在此连接前添加数据映射器步骤,并将查询映射到此连接。要对单个返回的资源进行操作,而不是在返回的列表集合后,在流中添加分割步骤。

8.4. 在 FHIR 服务器上创建资源

在集成中,您可以创建资源并将其添加到 FHIR 服务器中。当您配置连接的 Create 操作时,您可以指定您要创建的资源类型。例如,您可能希望向 FHIR 服务器添加新的病人资源。要创建资源,请将 FHIR 连接添加到流中间,或者作为简单的集成完成连接。

要填充新资源中的值,请在此流程中添加 FHIR 连接前,将数据映射程序步骤添加到流中。流中的前面的步骤预计会提供您希望新资源包含的数据。将前面的步骤中的字段映射到创建此 FHIR 连接的目标资源中的字段。新资源仅包含您映射到的字段。

当连接执行 Create 操作以在 FHIR 服务器上创建新资源时,新资源具有自动生成的 FHIR 资源 ID。如果要为新资源指定资源 ID,而不是选择 Create action 选择连接的 Update 操作

先决条件

  • 您创建了要向其添加资源的 FHIR 服务器的连接。
  • 您正在创建或编辑流,Fuse Online 会提示您添加到集成。或者,Fuse Online 正在提示您添加完成连接。

流程

  1. Add to Integration 页面上,单击您要添加连接的加号。如果 Fuse Online 正在提示您选择完成连接,请跳过这一步。
  2. 点 FHIR 连接到您要向其添加资源的服务器。
  3. Choose an action 页面上,选择 Create
  4. 单击 Resource Type 字段,以显示 FHIR 资源类型的列表。选择或输入您要创建的资源类型。
  5. Contained Resource Types 字段中,如果要创建的资源类型包含其他资源类型,请选择它们。如果您需要选择多个,请使用 Ctrl 键。

    识别包含的资源类型可让数据映射器显示包含资源中的字段。如果没有指定包含的资源类型,则无法映射到或来自包含资源中的任何字段。选择没有实际包含的资源没有损害。

  6. Next 将这个连接添加到流中。

结果

连接会出现在您添加它的集成视觉化中。在执行过程中,连接会在 FHIR 服务器上创建新资源。连接返回包含 id.idPart 字段的 MethodOutcome 资源。此字段包含新资源的资源 ID,您可能希望映射到流中的后续步骤。

后续步骤

如果此流程需要额外的步骤来获取您希望新资源包含的数据,请在此 FHIR 连接前添加它们。这些步骤就位后,在 FHIR 连接创建新资源之前,向流中添加数据映射程序步骤。在数据映射程序步骤中,映射到要创建的资源中的字段。

小心

在创建了新资源的 FHIR 连接之前没有数据映射程序,连接会尝试创建空资源。根据 FHIR 服务器配置,这可能无法正常工作。

8.5. 更新 FHIR 服务器上的资源中的所有字段

在集成中,您可以更新位于 FHIR 服务器上的资源。要提供更新的值,请在更新资源的 FHIR 连接前向流添加一个数据映射程序步骤。流中预期的是前面的步骤,提供您希望更新的资源包含的数据。将前面步骤中的字段映射到此 FHIR 连接更新的目标资源中的字段。

小心

更新的资源仅包含您映射到的字段。换句话说,除了映射值要更改的字段外,您必须映射您要位于资源中的字段,以及其值没有更改。如果您没有映射特定资源字段,则连接会从更新的资源中删除该字段。

务必将上一步中的资源 ID 映射到此连接中的资源 ID。这是连接不更改的唯一资源字段。如果 FHIR 服务器还没有具有要更新的资源 ID 的资源,则连接会创建一个具有该资源 ID 的新资源。这是添加具有您选择的资源 ID 的新资源的唯一方法。

要更新或创建资源,请将 FHIR 连接添加到流中间,或者作为简单集成完成连接。

先决条件

  • 您创建了与要更新或创建资源的 FHIR 服务器的连接。
  • 您正在创建或编辑流,Fuse Online 会提示您添加到集成。或者,Fuse Online 正在提示您添加完成连接。

流程

  1. Add to Integration 页面上,单击您要添加连接的加号。如果 Fuse Online 正在提示您选择完成连接,请跳过这一步。
  2. 点击您要用来更新 FHIR 服务器上的资源的 FHIR 连接。
  3. Choose an action 页面上,选择 Update
  4. 单击 Resource Type 字段,以显示 FHIR 资源类型的列表。选择或输入您要更新或创建的资源类型。
  5. Contained Resource Types 字段中,如果要更新或创建的资源类型包含其他资源类型,请选择它们。如果您需要选择多个,请使用 Ctrl 键。

    识别包含的资源类型可让数据映射器显示包含资源中的字段。如果没有指定包含的资源类型,则无法映射到或来自包含资源中的任何字段。选择没有实际包含的资源没有损害。

  6. Next 将这个连接添加到流中。
  7. 如果此流程需要额外的步骤来获取您希望更新的资源包含的数据,请在此 FHIR 连接前添加它们。
  8. 在集成视觉化中,点更新资源的 FHIR 连接前的加号。
  9. 单击 Data Mapper
  10. 在数据映射程序中:

    1. 将资源 ID 映射到目标资源 ID。这是为新资源指定资源 ID 的唯一方法。
    2. 映射到您希望更新或新资源包含的每个资源字段。务必映射值不更改的字段,以及需要更新值的字段。
    3. Done 将数据映射程序步骤添加到流中。

结果

连接会出现在您添加它的集成视觉化中。在执行期间,连接更新或在 FHIR 服务器上创建资源,并返回包含 id.idPart 字段的 MethodOutcome 资源。此字段包含更新的/创建资源 ID,您可能希望映射到流中的后续步骤。

8.6. 更新 FHIR 服务器上的资源中的指定字段

在集成中,您可以更新位于 FHIR 服务器上的资源中的各个字段。为此,请将 FHIR 连接添加到流中间,或者作为简单的集成完成连接。

先决条件

  • 您创建了到具有您要更新资源的 FHIR 服务器的连接。
  • 您正在创建或编辑流,Fuse Online 会提示您添加到集成。或者,Fuse Online 正在提示您选择完成连接。

流程

  1. Add to Integration 页面上,单击您要添加连接的加号。如果 Fuse Online 正在提示您选择完成连接,请跳过这一步。
  2. 点击您要用来更新资源的 FHIR 连接。
  3. Choose an action 页面上,选择 Patch
  4. 单击 Resource Type 字段,以显示 FHIR 资源类型的列表。选择或输入您要更新的字段的资源类型。
  5. Operations 字段中,指定您要更新的字段数。
  6. 如果要在流中映射上一步中的值,请将 Resource id 字段留空,这通常是您想要执行的操作。否则,请指定您要更新的字段的资源 ID。
  7. 指定描述更新的 JSON 补丁。JSON 补丁必须具有 JSON Patch? 中描述的格式?

    Patient 资源补丁示例

    active 字段设置为 true

    [{ "op":"replace", "path":"/active", "value": true }]

    替换 name 字段的值,这是病人名称的数组。在本例中,病人有一个名称。如果病人拥有多个名称,类似格式化的补丁可以取代所有病人的名称:

    [{ "op":"replace", "path":"/name", "value": [{"given": ["Bob"]}] }]

    替换给您的病人名称:

    [{ "op":"replace", "path":"/name/0/given/0", "value": "John" }]

    在名字前向病人添加另一个名称:

    [{ "op":"add", "path":"/name/0", "value": {"given": ["Anthony"]} }]

    对于一些更新,您必须在配置 Patch 操作时指定 JSON 补丁。例如,如果要将 resource 字段的值复制到另一个字段。对于其他更新,您可以将 JSON Patch 字段留空,而是映射定义每个更新的值。

  8. Next 将这个连接添加到流中。
  9. 如果您没有指定 JSON 补丁和/或资源 ID,请添加数据映射程序步骤:

    1. 在流视觉化中,点您刚刚添加的 FHIR 连接前的加号。
    2. 单击 Data Mapper

      Target 面板显示您要更新的每个字段的编号文件夹。当您配置 Patch 操作时,您可以指定要更新的字段数量。数据映射器在 Target 面板中显示此数量的文件夹。例如,如果您将 3 指定为要更新的字段数,您将看到三个目标文件夹,其标签为 123

    3. 对于您要更新的每个字段,请映射到一个目标文件夹中的字段:

      1. Target 面板中,展开文件夹以显示 op路径 的三个字段。
      2. 将 source 字段、常量或属性映射到 目标路径 字段。该路径标识了您要更新的资源字段。在路径值中,数字表示列表字段的索引,斜杠则会导致子字段。例如,映射此路径 /name/1/given/1/value 以更新给定 name 字段的值。
      3. 接受默认更新操作,它替换字段的当前值,或者将 source 字段、常量或属性映射到 op 字段,以指示如何更新字段。有关可能的操作的详情,请参阅 JSON 补丁操作
      4. 如果您要更新字段来具有新值,则将 source 字段、常量或属性映射到目标 。这是您希望字段包含的新值。
    4. 如果您在配置 Patch 操作时没有指定资源 ID,请将资源 ID 映射到目标 id 字段。
    5. Done 将数据映射程序步骤添加到流中。

结果

连接会出现在您添加它的集成视觉化中。在执行期间,连接会更新指定的 resource 字段,并返回包含 id.idPart 字段的 MethodOutcome 资源。此字段包含已更新的资源的 ID。

8.7. 在 FHIR 服务器上创建不同类型的资源

在集成中,您可以在 FHIR 服务器上创建两个或多个资源,每个资源都可以是不同的类型。例如,您可以在一个到 FHIR 服务器的连接中添加新的病人资源和新的供应商资源。为此,请将 FHIR 连接添加到流中间,或者作为简单的集成完成连接。

先决条件

  • 您创建了要向其添加资源的 FHIR 服务器的连接。
  • 您正在创建或编辑流,Fuse Online 会提示您添加到集成。或者,Fuse Online 正在提示您选择完成连接。

流程

  1. Add to Integration 页面上,单击您要添加连接的加号。如果 Fuse Online 正在提示您选择完成连接,请跳过这一步。
  2. 点击您要创建的 FHIR 连接,并将新资源添加到 FHIR 服务器中。
  3. Choose an action 页面上,选择 Transaction
  4. Included Resource Types 字段中,选择此连接创建的资源类型。使用 Ctrl 键选择多个资源类型。该连接会为您选择的每种类型创建一个资源。
  5. Next 将这个连接添加到流中。
  6. 要填充新资源中的字段,请在此连接前添加数据映射程序步骤:

    1. 在流视觉化中,点您刚刚添加的连接前的加号。
    2. 单击 Data Mapper
    3. 在数据映射器中,将 source 字段映射到目标资源字段。新资源仅包含您映射到的目标字段。
    4. Next 将数据映射程序步骤添加到流中。

结果

连接会出现在您添加它的集成视觉化中。在执行过程中,连接会将所有资源添加到 FHIR 服务器,或者如果出现错误,连接不会将任何资源添加到 FHIR 服务器。成功操作会返回一个事务资源,其中包含每个新资源的资源 ID。您可以将这些资源 ID 映射到流中的后续步骤。

8.8. 从 FHIR 服务器中删除资源

在集成中,您可以从 FHIR 服务器中删除资源。为此,请将 FHIR 连接添加到流中间,或者作为简单的集成完成连接。

先决条件

  • 您创建了到具有您要删除的资源的 FHIR 服务器的连接。
  • 您正在创建或编辑流,Fuse Online 会提示您添加到集成。或者,Fuse Online 正在提示您选择完成连接。

流程

  1. Add to Integration 页面上,单击您要添加连接的加号。如果 Fuse Online 正在提示您选择完成连接,请跳过这一步。
  2. 点击您要用来删除资源的 FHIR 连接。
  3. Choose an action 页面上,选择 Delete
  4. 单击 Resource Type 字段,以显示 FHIR 资源类型的列表。选择或输入您要删除的资源类型。
  5. Resource Id 字段中,如果您计划在集成中映射资源 ID,请指定要删除的资源 ID 或将此字段留空。
  6. Resource version 字段中,可以选择为资源指定版本 ID。将此字段留空以删除资源的最新版本,或者映射您要从上一步中删除的资源的版本 ID。
  7. Next 将这个连接添加到流中。

结果

连接会出现在您添加它的集成视觉化中。在执行期间,连接会删除 FHIR 服务器上的指定资源,并返回包含 id.idPart 字段的 MethodOutcome 资源。此字段包含已删除资源的资源 ID。

后续步骤

要将值映射到 Resource Id 字段或 Resource version 字段,请在此连接前添加数据映射程序步骤。

第 9 章 连接到 FTP 或 SFTP 服务器

在集成中,您可以连接到 FTP 或 SFTP 服务器以下载或上传文件。为此,请创建一个 FTP 或 SFTP 连接,然后将其添加到集成流中。以下主题提供详情:

9.1. 创建 FTP 或 SFTP 连接

在集成中,若要从/下载文件到 FTP 或 SFTP 服务器,请创建一个与该 FTP 或 SFTP 服务器的连接。您可以将相同的连接添加到任意数量的集成。

前提条件

您必须知道您要连接到的服务器的主机名。

流程

  1. 在 Fuse Online 中,在左侧面板中,单击 Connections 以显示任何可用连接。
  2. 在右上角,单击 Create Connection 以显示 Fuse Online 连接器。
  3. 要创建使用文件传输协议的连接,请点 FTP 连接器。

    或者,要创建使用安全文件传输协议的连接,请点 SFTP 连接器。

  4. 配置连接。

    • 对于 FTP 连接:

      • host 是您必须指定的唯一参数。输入您要连接的服务器的主机名。例如,如果您的 FTP 主机名称为 FTP.WEST,那么您将完全输入 FTP.WEST。不要指定协议,例如,您不应该指定类似如下的协议 :ftp://FTP.WEST。
      • 端口 是必需的,默认值为 21。这是 FTP 服务器侦听的端口。
      • 所有其他参数都不是必需的,或者具有默认值。默认值适合大多数集成。这些参数的描述在此流程后。
    • 对于 SFTP 连接,这些参数必须具有值:

      • host 是您要连接的 SFTP 服务器的主机名。例如,如果您的 SFTP 主机名称为 SFTP.EAST,则您将完全输入 SFTP.EAST。不要指定协议,例如,您不应该指定类似如下的协议: sftp://SFTP.EAST
      • port 的默认值为 22。这是 SFTP 服务器侦听的端口。
      • 用于访问 SFTP 服务器的 帐户的用户名
      • 与该用户名关联的密码。
      • 所有其他参数都有默认值。默认值适合大多数集成。这些参数的描述在此流程后。
  5. 单击 Validate。Fuse Online 立即尝试验证连接并显示一条消息,指示验证是否成功。如果验证失败,请根据需要重新传输配置详情,然后重试。
  6. 验证成功后,单击 Next
  7. Name 字段中输入您选择的名称,可帮助您将这个连接与任何其他连接区分开来。例如,输入 XLight FTP Server
  8. Description 字段中,输入有助于了解此连接的任何信息。
  9. Save 查看您创建的连接现在可用。如果您输入了示例名称,您会看到 XLight FTP 服务器 显示为一个连接,您可以选择添加到集成。

其他参数的描述

  • 连接超时 默认为 10000 毫秒,并指示最大等待 10 秒以建立连接。如果在没有连接的情况下经过 10 秒,则 Fuse Online 会等待 Reconnect delay 定义的毫秒数,然后尝试重新连接。
  • 重新连接延迟 默认为 1000 毫秒,并在尝试再次重新连接前指示等待时间。
  • 最大重新连接尝试 默认为 3。Fuse Online 尝试尝试 3 次以建立连接。
  • 默认使用 二进制文件 传输模式。在 ASCII 传输模式中,选择 No
  • 被动连接模式 默认为 Yes,通常是首选模式。在被动模式中,客户端打开与服务器的通信通道,以避免防火墙问题。如果您选择 No,则使用 active 模式。
  • 使用默认为 No 后断开 与服务器的连接。连接在执行操作后保持建立。如果要在连接执行上传或下载后与服务器断开连接,请选择 Yes
  • 数据超时 默认为 30000 毫秒,并指示 Fuse 在线等待回复的最大时长。

9.2. 从 FTP 或 SFTP 服务器获取文件

要在 FTP 或 SFTP 连接找到您感兴趣的文件时触发集成执行,请将 FTP 或 SFTP 连接添加为集成的启动连接。

前提条件

您创建了 FTP 或 SFTP 连接。

流程

  1. 在左侧的 Fuse Online 面板中,单击 Integrations
  2. Create Integration
  3. Choose a connection 页面上,单击您要用于轮询 FTP 或 SFTP 服务器的 FTP 或 SFTP 连接。
  4. Choose an action 页面上,选择 Download
  5. File name expression 字段中,如果您对单个文件感兴趣,则输入解析为 文件名的 Apache Camel Simple 语言 表达式。您不能指定正则表达式。连接轮询(以句点方式检查)服务器以获取此文件,并在找到时下载它。如果要下载多个文件,请将此字段留空。
  6. FTP 目录 字段中,输入要轮询的服务器目录的绝对路径或相对路径。该连接会监视此目录是否有任何内容,并在找到任何内容时下载所有文件。
  7. polling 启动字段前的 Milliseconds 中,接受默认的 1000 毫秒或更改毫秒。
  8. 在下一个 poll 字段前的 Milliseconds 中,接受默认值 500 毫秒或更改毫秒。这是轮询之间的间隔。
  9. Delete after download 字段中,接受默认值 No 或 select Yes 以下载文件,然后从服务器中删除它。
  10. Next 指定操作的输出类型。
  11. Select Type 字段中,如果不需要知道数据类型,则接受 类型规格, 然后点 Next。您不需要遵循这些指令的其余部分。

    但是,建议使用结构化的数据类型。例如,如果要在数据映射映射映射器步骤中的连接输出,您必须指定数据类型。数据映射器无法显示非结构化数据的字段。

    要指定数据类型,点 Select Type 字段,并选择以下之一作为 schema 类型:

    • JSON 模式是 描述 JSON 数据结构的文档。文档的介质类型是 application/schema+json
    • JSON 实例 是包含 JSON 数据的文档。文档的介质类型是 application/json
    • XML 模式 是一个描述 XML 数据结构的文档。文档的文件扩展为 .xsd
    • XML 实例 是包含 XML 数据的文档。文档的文件扩展为 .xml
  12. Definition 输入框中,粘贴符合您选择的 schema 类型的定义。例如,如果您选择 JSON 模式,您将粘贴 JSON 模式文件的内容,该文件的介质类型为 application/schema+json
  13. Data Type Name 字段中输入您为数据类型选择的名称。例如,如果您要为供应商指定 JSON 模式,您可以指定 Vendor 作为数据类型名称。

    在创建或编辑使用指定此类型的连接时,您将看到此数据类型名称。Fuse Online 在集成视觉化和数据映射程序中显示类型名称。

  14. Data Type Description 字段中,提供可帮助您区分此类型的信息。当您将鼠标悬停在处理此类型的步骤上时,此描述会出现在数据映射程序中。
  15. 点击 Next

结果

连接会出现在集成视觉化的开头。

9.3. 将文件上传到 FTP 或 SFTP 服务器

在集成中,您可以在流中上传文件到 FTP 或 SFTP 服务器,或者完成简单的集成。为此,请将 FTP 或 SFTP 连接添加到流中间或作为简单集成结束连接。

前提条件

  • 您创建了 FTP 或 SFTP 连接。
  • 您正在创建或编辑流,Fuse Online 会提示您添加到集成。或者,Fuse Online 正在提示您选择完成连接。

流程

  1. Add to Integration 页面上,单击您要添加连接的加号。如果 Fuse Online 正在提示您选择完成连接,请跳过这一步。
  2. 点击您要上传文件的 FTP 或 SFTP 连接。
  3. Choose an action 页面上,选择 Upload
  4. File name expression 字段中,如果要只上传一个特定文件,则输入解析为 文件名的 Apache Camel Simple 语言 表达式。这是操作上传到服务器的文件的名称。您不能指定正则表达式。要上传多个文件,请将此字段留空。
  5. FTP 目录 字段中,输入服务器目录的绝对或相对路径名称。如果 File name expression 字段包含一个表达式,则连接会将指定的文件存储在这个目录中。如果 File name expression 字段为空,则连接将上传到此目录中从上一步中收到的所有文件。
  6. If file exists 字段中,指定您上传与服务器中文件相同的路径和名称的文件时的行为。接受默认的 覆盖 (覆盖 ),以使用您要上传的文件覆盖服务器上的文件。或者,选择以下之一:

    • 附加 将 正在上传的内容添加到服务器上的文件中。
    • 失败 抛出 GenericFileOperationException。集成不会进入错误状态。
    • ignore 不上传文件。整合在假设一切正常下运行。
    • move 重命名其中一个文件。
    • TryRename 使用临时名称上传文件,并将该文件重命名为所需名称。此操作不会检查是否存在具有所需名称的文件,这使得在大多数服务器上比存在性检查要快得多。
  7. 在 copy 字段中的 Temporary 文件前缀 中,指定一个字符串。连接会在上传时将此字符串添加到文件的名称中。这可让连接写入服务器上的临时文件,然后将该临时文件重命名为具有正确的名称。这在上传非常大文件时,这可用于减少锁定。
  8. copy 字段中的 Temporary 文件名 中,指定一个字符串。连接重命名正在上传的文件,使其在上传时具有此名称。这可让连接写入服务器上的临时文件,然后将该临时文件重命名为具有正确的名称。这在上传非常大文件时,这可用于减少锁定。
  9. Next 指定操作的输入类型。
  10. Select Type 字段中,如果不需要知道数据类型,则接受 类型规格, 然后点 Next。您不需要遵循这些指令的其余部分。

    但是,建议使用结构化的数据类型。例如,如果要在数据映射映射映射器步骤中的连接输入,您必须指定数据类型。数据映射器无法显示非结构化数据的字段。

    要指定数据类型,点 Select Type 字段,并选择以下之一作为 schema 类型:

    • JSON 模式是 描述 JSON 数据结构的文档。文档的介质类型是 application/schema+json
    • JSON 实例 是包含 JSON 数据的文档。文档的介质类型是 application/json
    • XML 模式 是一个描述 XML 数据结构的文档。文档的文件扩展为 .xsd
    • XML 实例 是包含 XML 数据的文档。文档的文件扩展为 .xml
  11. Definition 输入框中,粘贴符合您选择的 schema 类型的定义。例如,如果您选择 JSON 模式,您将粘贴 JSON 模式文件的内容,该文件的介质类型为 application/schema+json
  12. Data Type Name 字段中输入您为数据类型选择的名称。例如,如果您要为供应商指定 JSON 模式,您可以指定 Vendor 作为数据类型名称。

    在创建或编辑使用指定此类型的连接时,您将看到此数据类型名称。Fuse Online 在集成视觉化和数据映射程序中显示类型名称。

  13. Data Type Description 字段中,提供可帮助您区分此类型的信息。当您将鼠标悬停在处理此类型的步骤上时,此描述会出现在数据映射程序中。
  14. 点击 Next

结果

连接会出现在您添加它的集成视觉化中。

第 10 章 连接到 Google 应用程序

集成可以连接到这些 Google 应用程序:Gmail、Calendar 和 Sheets。详情请查看以下主题:

10.1. 将 Fuse Online 注册为 Google 客户端应用程序

在集成中,要能够连接到 Gmail、Google Calendar 或 Google Sheets,您必须将 Fuse Online 环境注册为 Google 客户端应用程序。在注册过程中,您可以启用 Google API 并创建 Fuse Online 用于访问您启用的 Google API 的凭证。

通过注册,您可以创建与 Gmail、Google Calendar 和 Google Sheets 的多个连接。您可以在多个集成中使用每个连接。虽然与 Google 应用程序的每个连接都可以使用相同的 Google 客户端 ID 和 Google 客户端 secret,但每个连接都可以访问您选择的不同 Google 帐户。

此流程指示您启用 Gmail API、Google Calendar API 和 Google Sheets API。但是,您只能启用您需要的 API,而不是所有三个 API。稍后,如果您需要创建与未启用 API 的应用的连接,您可以在此处返回并按照说明启用其 API。

重要

您必须为 Fuse Online 创建新的 Google 客户端应用程序。Google 为新客户端应用程序提供的凭证包含一个刷新令牌,用于刷新已过期的访问令牌。此刷新令牌仅在 Fuse 在线客户端应用使用凭据时可用。在 Fuse Online 中,到 Gmail、Google Calendar 和 Google Sheets 的连接都可以使用相同的 Google 客户端 ID 和 Google 客户端 secret。如果这样做,则刷新令牌可用于所有与 Google 应用程序的连接。当您在 Fuse Online 用户界面中查看连接详情时,请不要单击 Validate 按钮。验证是凭据的第二个使用,刷新令牌不再是客户端凭据的一部分。但是,您可以重新连接到 Google 应用程序。

在开发环境中,如果您选择使用 Google 客户端 ID 和 Google 客户端 secret,用于其他非Fuse Online OAuth 客户端,请小心。Fuse Online 需要在第一次 OAuth 交换上请求的离线访问。如果另一个 OAuth 客户端已进入 OAuth 交换且没有请求离线访问,则 Fuse Online 无法获取后续 OAuth 交换的离线访问。如果您不确定在第一次交换上请求离线访问,请为 Fuse Online 创建新的 Google 客户端应用程序。

先决条件

  • 您必须能够登录到您要用来将 Fuse Online 注册为 Google 客户端应用程序的 Google 帐户。

流程

  1. 在 Fuse Online 中:

    1. 在左侧导航面板中,单击 Settings
    2. Settings 页面中,在回调 URL 右侧,点 Copy Callback URL 将 Fuse Online 环境的回调 URL 复制到剪贴板。此流程稍后您将需要此 URL。
  2. 在另一个浏览器标签页中,进入 https://console.developers.google.com 并执行以下操作:

    1. 检查您是否已签名了您要用来将 Fuse Online 注册为 Google 客户端应用程序的 Google 帐户。或者,选择不同的 Google 帐户并登录到该帐户。

      当前 Google 项目的名称会出现在 Google API 页面的顶部。

    2. 要使用当前项目为 Fuse Online 授予授权,请继续下一步。要在另一个 Google 项目中向 Fuse Online 授予授权,请选择或创建该项目。如果此 Google 帐户还没有项目,则必须创建一个项目。
    3. 启用 Google API:

      1. 在左上角,点 Navigation menu icon 并选择 API 和 Services > Library
      2. 如有必要,向下滚动以查看卡的 G Suite 行。
      3. Google Calendar API 卡,显示一个页面,表示启用了 Google Calendar API。
      4. 向下滚动并单击 Gmail API 卡,显示指出 Gmail API 已启用的页面。
      5. 在左上角,点 Navigation menu icon 并选择 API 和 Services > Library
      6. 如有必要,向下滚动以查看卡的 G Suite 行。
      7. Google Sheets API 卡,显示一个页面,表示启用了 Google Sheets API。
    4. 为您的客户端应用程序指定一个名称:

      1. 单击 MANAGE
      2. 在出现的页面中,在左侧导航面板中点 Credentials,然后点 API & Services 中的 Credentials
      3. OAuth consent 屏幕 标签页。
      4. 在出现的页面中,在 Application Name 字段中输入 Fuse Online 客户端应用程序的名称。例如,输入 Fuse Online 客户端应用程序
      5. 跳过其他字段。
      6. Save
    5. 获取客户端应用程序凭证,如下所示:

      1. Create Credentials 右侧,单击向下箭头以显示菜单,然后选择 OAuth 客户端 ID
      2. 在出现的页面中,选择 Web application 以显示更多内容。
      3. Name 字段中输入 Fuse Online 环境的 OAuth 客户端 ID 的名称。这与您为客户端应用程序本身输入的名称不同。例如,为 Fuse Online 输入 OAuth 客户端 ID
      4. 跳过 Authorized JavaScript 来源
      5. Authorized redirect URIs 字段中,粘贴您在此流程开始时从 Fuse Online 环境复制的回调 URL。
      6. Create 显示 Fuse Online 环境的客户端 ID 和客户端 secret。
    6. 在客户端 ID 字段右侧,点 the Copy icon 将客户端 ID 复制到您的剪贴板。
  3. 返回 Fuse Online Settings 页面并执行以下操作:

    1. 展开 Gmail、Google Calendar 和 Google Sheets 的条目。
    2. 在每个 Google 应用程序的 Client ID 字段中,粘贴您刚才复制的 Google 客户端 ID。
  4. 返回到 Google developers 站点和客户端 secret 字段右侧,点 the Copy icon 将客户端 secret 复制到您的剪贴板。
  5. 返回到 Fuse Online Settings 页面,并在每个 Google 应用程序的条目中执行以下操作:

    1. Client Secret 字段中,粘贴刚才复制的 Google 客户端 secret。
    2. Save。您应会收到" 注册成功" 通知。
    3. 折叠条目。

结果

对于启用的每个 Google 应用程序 API,您可以创建一个与应用程序的连接。

从 Fuse Online 到 Google 应用程序的所有连接都使用相同的 Google 客户端 ID 和 Google 客户端 secret。

重要

Google 客户端 ID 和 Google 客户端 secret 包含令牌刷新信息,以确保与 Google 应用程序的连接的集成可以持续正常工作。因此,您不应该 获取新凭证。如果这样做,则需要重新创建每个 Google 连接,将旧连接替换为新连接,然后重新发布使用 Google 连接的每个集成。

10.2. 连接到 Gmail

要在特定 Gmail 帐户收到电子邮件时触发集成执行,请在启动连接时将 Gmail 连接添加到简单集成。在集成中,要从特定的 Gmail 帐户发送电子邮件,请执行以下操作之一:

  • 向流的中间添加 Gmail 连接。
  • 添加 Gmail 连接以完成简单的集成。

在集成中连接到 Gmail 的一般步骤有:

  1. 将 Fuse Online 注册为 Google 客户端应用程序
  2. 创建 Gmail 连接.当您执行此操作时,您可以选择连接被授权访问的 Gmail 帐户。
  3. 如果您的集成从 Gmail 帐户发送电子邮件,则决定如何填写要发送的电子邮件。
  4. 添加 Gmail 连接到集成流程.
  5. 对于发送电子邮件的 Gmail 连接,可选择将集成数据映射到电子邮件字段。

信息和说明位于以下主题:

10.2.1. 创建 Gmail 连接

当您创建 Gmail 连接时,您授权连接访问一个特定的 Gmail 帐户。创建 Gmail 连接后,您可以将其添加到多个集成中。

先决条件

  • 您已将 Fuse Online 注册为 Google 客户端应用程序 并启用了 Gmail API。
  • Gmail 的 Fuse Online Settings 页面条目具有客户端 ID 和客户端 secret 的值,您可以通过将 Fuse Online 注册为 Google 客户端应用程序来获取。

流程

  1. 在 Fuse Online 中,在左侧面板中,单击 Connections 以显示任何可用连接。
  2. 在右上角,单击 Create Connection 以显示可用的连接器。连接器是一个模板,用于创建一个或多个连接。
  3. Gmail 连接器。
  4. Configure Connection 页面中,单击 Connect Gmail,这将进入 使用 Gmail 页面的 Sign in

    如果没有显示 Connect Gmail,您的 Fuse Online 环境不会注册为 Google 客户端应用程序。请参阅 将 Fuse Online 注册为 Google 客户端应用程序。当您尝试创建 Gmail 连接并且 Fuse Online 环境没有注册为 Google 客户端应用程序时,Fuse Online 会显示多个提示授权信息的字段。虽然您可以通过在这些字段中输入值来创建 Gmail 连接,但不推荐这样做。

  5. 在提示您登录 Gmail 的页面中,输入您希望此连接从 Fuse Online 访问的 Google 帐户的电子邮件地址,然后单击 Next
  6. 要响应 openshiftapps.com 想要访问 Google 帐户,请单击 Allow to return to Fuse Online。
  7. 在 Fuse Online Name 字段中输入您选择的名称,以帮助您将这个连接与任何其他连接区分开来。例如,输入 Gmail Connect 1
  8. Description 字段中,输入有助于了解此连接的任何信息。例如,输入 使用 jkim Gmail 帐户凭证的 Sample Gmail 连接。
  9. Save 查看您创建的连接现在可用。如果您输入了示例名称,您会看到 Gmail Connect 1 显示为一个连接,您可以选择添加到集成。

10.2.2. 填充电子邮件发送的替代方案

完成简单集成或位于流中间的 Gmail 连接,从连接被授权访问的 Gmail 帐户发送电子邮件。可以通过多种方式填充连接发送的电子邮件的内容。在添加发送电子邮件的 Gmail 连接之前,请考虑如何填充该电子邮件。

填充要发送的电子邮件的替代方案如下:

  • 只需在发送电子邮件的 Gmail 连接之前添加数据映射程序步骤。在这个数据映射程序步骤中,将作为前面步骤输出的数据字段映射到 Gmail connection Send Email action 字段。Send Email action 字段有:

    • 电子邮件到
    • 电子邮件主题
    • 电子邮件文本
    • 电子邮件 cc
    • 电子邮件 bcc

    如果添加数据映射程序步骤,您可以映射 one、some 或 all Send Email action 字段。

  • 将 Gmail 连接添加到流时,通过在 Send Email action 字段中指定值来配置操作。您可以在 one、some 或 all 字段中指定值。
  • 使用数据映射程序步骤和 发送电子邮件 操作配置来填充字段。换句话说,您可以通过指定一个或多个字段来配置 Send Email 操作,并添加填充其他字段的数据映射程序步骤。

    您直接在 Send Email action 字段中指定的值优先于映射到 Send Email action 字段的值。换句话说,假设您在添加连接时通过指定一个值来填充 Send Email 字段,并配置该操作,并通过将值映射到同一字段来填充 Send Email 字段。您在操作配置中指定的值始终覆盖映射的值。例如,假设您在 Email to action 字段中指定 people@redhat.com,您还会将上一步中的电子邮件字段映射到 Gmail Email to 字段。集成始终使用 people@redhat.com 作为电子邮件地址。

当您添加发送电子邮件的 Gmail 连接时,所有操作配置参数都是可选的。这是因为,您可以选择通过将集成数据映射到 Send Email action 字段来完全填充电子邮件。但是,根据操作配置规格或映射,在 Email to 字段中存在电子邮件地址。如果没有要将邮件发送到的电子邮件地址,Fuse Online 会生成运行时错误,集成将停止执行。

10.2.3. 轮询返回 Gmail 消息时触发集成

要根据特定 Gmail 帐户接收的电子邮件触发集成执行,请在简单集成的开始连接中添加 Gmail 连接。当集成运行时,Gmail 连接会按您控制的间隔检查此帐户是否有电子邮件。当连接找到未读取电子邮件时,它会将电子邮件传递给集成中的下一步,默认情况下,将电子邮件标记为 读取

先决条件

  • 您创建了 Gmail 连接,该连接有权访问您要从中获取电子邮件的 Gmail 帐户。

流程

  1. 在左侧的 Fuse Online 面板中,单击 Integrations
  2. Create Integration
  3. Choose a connection 页面上,单击您要用来启动集成的 Gmail 连接。
  4. Choose an action 页面上,选择 Receive Email 操作。
  5. 配置 Receive Email 操作:

    1. Delay 字段中,接受默认值 30 秒,或者指定集成检查新电子邮件的频率。
    2. Labels 字段留空以获取任何未读取电子邮件。要只获取某些电子邮件,请指定连接正在访问的 Gmail 帐户中使用的以逗号分隔的标签列表。默认情况下,集成会获取具有这些标签的未读取电子邮件。
    3. 选择 Mark as read 以确保连接不会返回同一电子邮件两次。如果没有选择 Mark as read,连接会返回位于帐户 ins in 框中的电子邮件,无论它们之前没有被读取。或者,如果您指定了一个或多个标签,则具有这些标签的集成返回电子邮件是否已经读取。
    4. Max Results 字段中,接受默认值 5 或指示连接可以为每个轮询返回的最大电子邮件数。如果连接发现超过这个未读取电子邮件的数量,它会返回最新的 Max Results 电子邮件。

      当 Gmail 连接返回多个电子邮件时,集成将电子邮件作为批处理。换句话说,Fuse Online 为批处理执行一次集成。

    5. Next 将这个 Gmail 连接添加为集成中的启动连接。连接作为集成流中的第一个步骤出现。

10.2.4. 从 Gmail 帐户发送电子邮件

在集成中,您可以从 Gmail 帐户在流中或完成简单集成中发送电子邮件。为此,请在流的中间或作为简单集成完成连接中添加 Gmail 连接。

先决条件

流程

  1. Add to Integration 页面上,单击您要添加连接的加号。如果 Fuse Online 正在提示您选择完成连接,请跳过这一步。
  2. 点击您要用来发送电子邮件的 Gmail 连接。
  3. Choose an action 页面上,选择 Send Email
  4. Configure Send Email 页面中,执行以下操作之一:

    • 如果您计划在此连接前添加数据映射程序步骤,并且计划将集成数据映射到 Send Email 字段,请将所有字段留空。
    • 在以下 发送电子邮件 字段中输入信息。使用逗号分隔多个电子邮件地址。

      1. 电子邮件到
      2. 电子邮件主题
      3. 电子邮件文本
      4. 电子邮件 cc
      5. 电子邮件 bcc
    • 将一些字段留空,并在某些字段中输入信息。

      如果您计划在此 Gmail 连接前添加数据映射程序步骤,而您想要将集成数据映射到某些电子邮件字段,请将这些字段留空。根据需要在其他操作字段中输入值。

      您在 Send Email action 配置字段中指定的值优先于上一步中映射的值。

  5. Next 将连接添加到流。

结果

连接会出现在您添加它的集成流中。

后续步骤

如果您计划在此连接前添加数据映射程序步骤,首先添加您计划添加到此流的任何其他连接。然后添加数据映射程序步骤。

10.3. 连接到 Google Calendar

要在轮询返回更新到 Google 日历时触发集成执行,请在启动连接时将 Google Calendar 连接添加到简单集成。要在日历中添加事件或更新一个事件,您可以执行以下操作之一:

  • 向流的中间添加 Google Calendar 连接。
  • 添加 Google Calendar 连接以完成简单的集成。

连接到 Google Calendar 的详情位于以下主题:

10.3.1. 创建 Google Calendar 连接

当您创建 Google Calendar 连接时,您可以授权连接访问与一个特定的 Google 帐户关联的 Google Calendars。创建 Google Calendar 连接后,您可以将其添加到多个集成中。

先决条件

  • 您已将 Fuse Online 注册为 Google 客户端应用程序 并启用了 Google Calendar API。
  • Google Calendar 的 Fuse Online Settings 页面条目具有客户端 ID 和客户端 secret 的值,您可以通过将 Fuse Online 注册为 Google 客户端应用程序来获取。

流程

  1. 在 Fuse Online 中,在左侧面板中,单击 Connections 以显示任何可用连接。
  2. 在右上角,单击 Create Connection 以显示可用的连接器。连接器是一个模板,用于创建一个或多个连接。
  3. Google Calendar 连接器。
  4. Configure Connection 页面中,单击 Connect Google Calendar,这将进入 Google 登录页面。

    如果没有显示 Connect Google Calendar,则 Fuse Online 环境不会注册为启用了 Google Calendar API 的 Google 客户端应用程序。请参阅 将 Fuse Online 注册为 Google 客户端应用程序。如果没有使用 Google 注册您的环境,那么当您试图创建 Google Calendar 连接时,Fuse Online 会显示多个提示授权信息的字段。虽然您可以通过在这些字段中输入值来创建 Google Calendar 连接,但不推荐这样做。

  5. 在 Google sign-in 页面中,选择您希望此连接从 Fuse Online 访问的 Google 帐户,然后点 Next
  6. 要响应 openshiftapps.com 想要访问 Google Account 提示符,请单击 Allow 以返回到 Fuse Online。
  7. 在 Fuse Online Name 字段中输入您选择的名称,以帮助您将这个连接与其他连接区分开来。例如,输入 Google Calendar Work Connection
  8. Description 字段中,输入有助于了解此连接的任何信息。例如,输入 Sample Google Calendar 连接,它使用 my Google work 帐户。
  9. Save 查看您创建的连接现在可用。如果您输入了示例名称,您会看到 Google Calendar Work Connection 显示为您可以选择添加到集成的连接。

10.3.2. 当轮询从 Google Calendar 返回事件时触发集成

要在从您指定的 Google Calendar 获取事件时触发集成执行,请在启动连接时将 Google Calendar 连接添加到简单集成。当集成运行时,Google Calendar 连接会按您控制的间隔检查 Google Calendar 的事件。当连接找到符合您配置 Google Calendar Get Events 操作的方式的事件时,连接会将事件传递给集成中的下一步。

当 Google Calendar 连接返回多个事件时,Fuse Online 会针对每个返回的事件执行集成。例如,如果轮询返回 5 个事件,Fuse Online 会执行集成五次。

先决条件

  • 您创建了 Google Calendar 连接。

流程

  1. 在左侧的 Fuse Online 面板中,单击 Integrations
  2. Create Integration
  3. Choose a connection 页面上,单击您要用来启动集成的 Google Calendar 连接。
  4. Choose an action 页面上,选择 Get Events 操作。
  5. 配置 Get Events 操作:

    1. Delay 字段中,接受默认值 30 秒,或者指定集成检查日历的频率。
    2. Calendar name 字段中,输入可以从此 Google Calendar 连接被授权访问的 Google 帐户访问的日历名称。
    3. Max Results 字段中,接受默认值 5 或指示连接可以为每个轮询返回的最大事件数。
    4. 选择以下之一来指示您希望连接用来开始检查事件的日期。连接检查日期和后续日期。

      • 从当前日期开始 于当前日期开始。

        例如,如果您选择了这个选项,如果 Max Results 为 5,则 Google Calendar 连接开始检查当前日期上的事件,并返回超过找到的前五个事件。从上一次轮询以来,这些事件是否已更新或添加无关紧要。

      • 从下一次轮询上最后一次事件更新日期的消耗将 在上一个轮询返回的最近更新事件的日期开始。

        例如,如果您选择了这个选项,如果 Max Results 为 5,则 Google Calendar 连接不再返回 5 更新或新事件。连接开始检查上一次轮询返回的最近更新事件的日期是否有新的或更新的事件。

    5. (可选)在 Query for events 字段中指定文本来过滤轮询可以返回的事件。连接仅返回包含至少一个事件字段中指定文本的事件。

      例如,假设您在查询字段中指定了 Standup meeting。轮询仅返回在事件字段中具有 Standup meet 的事件。

  6. Next 将这个 Google Calendar 连接添加为集成的启动连接。

结果

连接作为简单集成中的第一个步骤显示。

10.3.3. 从 Google Calendar 获取特定事件

在集成中,您可以在流中间获取特定的 Google Calendar 事件。获取特定事件很有用,例如,当您想要时:

  • 更新后续 Google Calendar 连接中的事件。
  • 使用后续的 Twitter 连接宣布事件。

要获取一个事件,请在流的中间添加 Google Calendar 连接。

注意

在本发行版本中,在简单的集成完成连接中获取特定事件时被支持,但它并特别有用。以后的发行版本中应该会改变。

先决条件

  • 您创建了 Google Calendar 连接,该连接有权访问 Google Calendar,该连接具有您要获取的事件。
  • 您正在创建或编辑流,Fuse Online 会提示您添加到集成。

流程

  1. Add to Integration 页面上,单击您要添加连接的加号。
  2. 点授权访问您要连接的日历的 Google Calendar 连接。
  3. Choose an action 页面上,选择 Get a Specific Event
  4. 指定具有您想要事件的日历名称。
  5. 指定要获取的事件 ID。要获取事件 ID,请执行以下操作之一:

    • 从以前的 Google Calendar 连接映射它。
    • 从日历手动获取它,如下所示:

      1. 在浏览器中,显示包含您要获取的事件的日历。
      2. ?gsessionid=OK&eventdeb=1 附加到 URL 中,并重新显示日历。
      3. 在日历中,点击您要获取的事件。
      4. 在事件弹出窗口中点 Options 并选择 Troubleshooting info
      5. 在 Google Calendar 显示的弹出窗口中,复制 eid= 后面的字符串。例如,事件 ID 类似如下: p1pva2a4t504sha12di9ch6k_20181107T150000Z*
  6. Next 将连接添加到流。

结果

连接会出现在您添加它的流中。

后续步骤

如果要将上一步中的任何值映射到此连接中的字段,请添加数据映射器步骤。首先,将所有需要的连接添加到流中。然后,在这个连接前立即添加数据映射程序步骤。

10.3.4. 在 Google Calendar 中添加事件

在集成中,您可以在流的中间向 Google Calendar 中添加事件,或完成简单的集成。为此,请将 Google Calendar 连接添加到流中间,或作为一个简单的集成完成连接。

先决条件

  • 您创建了 Google Calendar 连接,它有权访问您要添加事件的 Google Calendar。
  • 您正在创建或编辑流,Fuse Online 会提示您添加到集成。或者,Fuse Online 正在提示您选择完成连接。

流程

  1. Add to Integration 页面上,单击您要添加连接的加号。如果 Fuse Online 正在提示您选择完成连接,请跳过这一步。
  2. 点一个 Google Calendar 连接,该连接有权访问您要向其添加事件的日历。
  3. Choose an action 页面上,选择 Create Event 操作。
  4. 配置 Create Event 操作:

    1. 输入新事件的标题。
    2. 输入 Google Calendar 的名称,将事件添加到其中。
    3. 对于其他输入参数,您可以输入数据,或者您可能希望从之前 Google Calendar 连接中获取的事件映射值。
  5. Next 将连接添加到流。

结果

连接会出现在您添加它的集成流中。

后续步骤

如果要将任何值映射到此 Google Calendar 连接中的字段,请将数据映射程序步骤添加到流中。首先,将所有需要的连接添加到流中。然后,在 Google Calendar 连接前立即添加数据映射程序步骤。

10.3.5. 在 Google Calendar 中更新事件

在集成中,您可以更新流中 Google Calendar 中的事件,或完成简单的集成。为此,请将 Google Calendar 连接添加到流中间,或作为一个简单的集成完成连接。

重要

在这个发行版本中,Update Event 操作在每个事件字段中都需要一个值。在大多数情况下,这意味着您必须添加一个 Google Calendar 连接,该连接 获取您要更新的事件,然后添加更新 该事件的 Google Calendar 连接,然后在两个 Google Calendar 连接之间插入一个数据映射程序步骤。

先决条件

  • 您创建了 Google Calendar 连接,该连接有权访问具有您要更新的事件的 Google Calendar。
  • 在流中,有一个早期与 Google Calendar 的连接,该连接会获取您要更新的事件。
  • 您正在创建或编辑流,Fuse Online 会提示您添加到集成。或者,Fuse Online 正在提示您选择完成连接。

流程

  1. Add to Integration 页面上,单击您要添加连接的加号。如果 Fuse Online 正在提示您选择完成连接,请跳过这一步。
  2. 点一个 Google Calendar 连接,该连接有权访问具有您要更新的事件的日历。
  3. Choose an action 页面上,选择 Update Event
  4. 配置 Update Event 操作:

    1. 输入您要更新的事件的标题。
    2. 在您要更新的每个事件字段中输入内容。如果您希望该字段中的内容保持不变,请不要在事件字段中输入内容。
  5. Next 将连接添加到流。连接会出现在您添加它的集成视觉化中。
  6. 在集成视觉化中,单击刚刚添加的连接前的加号。
  7. 单击 Data Mapper
  8. 在数据映射程序中,对于更新事件中的每个事件字段,请从 Google Calendar 连接中映射该字段,该连接从 Google Calendar 连接中获取事件到更新事件的 Google Calendar 连接中的对应字段。

    不要映射您要更新的字段。如果您映射了一个字段,并在配置 Update Event 操作时为该字段指定一个更新,Fuse Online 将使用映射的值。

  9. 在右上角,点 Done 添加数据映射程序步骤。

10.4. 连接到 Google Sheets

要在 Google Sheets 连接返回电子表格数据或电子表格属性时触发集成执行,请在启动连接时将 Google Sheets 连接添加到简单集成。要通过更新电子表格值或属性来完成简单的集成,或者将 chart 或 pivot 表插入到电子表格中,请在其完成连接中添加 Google Sheets 连接到简单集成。

在流的中间,您可以添加 Google Sheets 连接来获取、创建或更新电子表格中的值,或者将 chart 或 pivot 表插入到电子表格中。

连接到 Google Sheets 的详情位于以下主题:

10.4.1. 创建 Google Sheets 连接

当您创建 Google Sheets 连接时,您可以授权访问与您选择的特定 Google 帐户关联的 Google Sheets 电子表格的连接。创建 Google Sheets 连接后,您可以将其添加到多个集成中。

先决条件

  • 您已将 Fuse Online 注册为 Google 客户端应用程序 并启用了 Google Sheets API。
  • Google Sheets 的 Fuse Online Settings 页面条目具有客户端 ID 和客户端 secret 的值,您可以通过将 Fuse Online 注册为 Google 客户端应用程序来获取。

流程

  1. 在 Fuse Online 中,在左侧面板中,单击 Connections 以显示任何可用连接。
  2. 在右上角,单击 Create Connection 以显示可用的连接器。连接器是一个模板,用于创建一个或多个连接。
  3. Google Sheets 连接器。
  4. Configure Connection 页面中,单击 Connect Google Sheets,这将进入 Google 登录页面。

    如果没有显示 Connect Google Sheets,则 Fuse Online 环境没有作为 Google 客户端应用程序注册,并启用了 Google Sheets API。请参阅 将 Fuse Online 注册为 Google 客户端应用程序。如果没有使用 Google 注册您的环境,那么当您试图创建 Google Sheets 连接时,Fuse Online 会显示多个提示授权信息的字段。虽然您可以通过在这些字段中输入值来创建 Google Sheets 连接,但不建议这样做。

  5. 在 Google sign-in 页面中,选择您希望此连接从 Fuse Online 访问的 Google 帐户,然后点 Next
  6. 要响应 openshiftapps.com 想要访问 Google Account 提示符,请单击 Allow 以返回到 Fuse Online。
  7. 在 Fuse Online Name 字段中输入您选择的名称,以帮助您将这个连接与其他连接区分开来。例如,输入 Google Sheets Work Connection
  8. Description 字段中,输入有助于了解此连接的任何信息。例如,输入 使用 my Google work 帐户的 Sample Google Sheets 连接。
  9. Save 查看您创建的连接现在可用。如果您输入了示例名称,您会看到 Google Sheets Work Connection 显示为您可以选择添加到集成的连接。

10.4.2. 获取电子表格数据以触发集成或在流中间的中

要在从 Google Sheets 电子表格获取数据时触发集成执行,请在启动连接时将 Google Sheets 连接添加到简单集成。当集成运行时,Google Sheets 连接会在您指定的间隔轮询电子表格,获取您识别的数据,并将数据传递给集成中的下一步。

要在流中间获取电子表格数据,请将 Google Sheets 连接添加为中间连接。在执行期间,Fuse Online 在开始处理此连接后立即轮询指定数据的电子表格。换句话说,连接不会等待经过的时间间隔,然后再轮询电子表格。

要从电子表格中的特定表格中获取数据,您可以在为 Google Sheets 连接配置操作时指定表名称。特定连接只能从一个表格中获取数据。

在轮询之间,如果没有更改连接的表值,则下一次轮询会返回与上一次轮询相同的值。

先决条件

  • 您创建了 Google Sheets 连接,它有权访问您要从中获取数据的电子表格。
  • 如果此 Google Sheets 连接正在触发集成执行,则您要创建一个集成,Fuse Online 会提示您选择启动连接。
  • 如果此 Google Sheets 连接位于流中,则集成已具有启动连接和完成连接,Fuse Online 会提示您通过选择步骤来添加到集成。

流程

  1. 点您要使用的 Google Sheets 连接。
  2. Choose an action 页面上,对于启动连接,选择 Get sheet 值 操作或中间连接,选择 Retrieve sheet 值 操作。
  3. 配置操作:

    1. SpreadsheetId 字段中,输入 Google 电子表格的 ID,该表可从此 Google Sheets 连接被授权访问的 Google 帐户访问。

      要获取电子表格 ID,请在浏览器中显示电子表格。该 ID 是 d//edit 之间的 URL 的一部分。

    2. Range 字段中,输入 Google A1 表示法,以标识您要获取的数据。默认值为 A:A

      例如,假设您想获得电子表格中的所有数据,其中有一个表格,包含 4 列。指定 A:D。或者,若要从行 5 到 15 中获取数据,请指定 A5:D15

      如果您要获取数据的电子表格具有多个表,请指定表格名称以及启动单元协调以及结束单元协调。如果有多个表格,并且您没有指定表格名称,则连接会从电子表格的第一个表格中获取数据。例如,2019!A1:D5 规格指定您要从名称为 2019 的表中获取数据。在该表格中,您希望通过 D (第 1 行到第 1 行到第 5 行)列入 A 中的数据。

    3. Major dimension 字段中,接受 Rows (默认值),或者选择 Columns

      行配置操作,以返回每行对象集合,其中每行对象包含每个所需列的值。Major 维度Rows 时,Fuse Online 可将有意义的列标题显示为数据映射器中的字段名称,而不是 ABC 等。

      配置操作,以返回列对象集合,其中每个列对象包含每个所需行的值。

    4. Header row number 字段中,如果将 Major dimension 设置为 Rows,可以选择在连接获取的数据中输入包含列标题的行数。标题行的规格使 Fuse Online 从电子表格中获取标题。如果您没有指定标头行,则列标题默认为连接获取的数据范围内的每个列的字母标题。您可以在后续页面中编辑获取的标题或字母标题。

      注意

      如果您要配置 Google Sheets 中连接,则不需要其他配置选项,Fuse Online 不会提示它们。跳至第 4 步。

    5. Split 结果 字段中,接受 No (默认值),或者选择 Yes。设置 No 将操作配置为返回数据作为值集合。也就是说,连接将一系列行对象或列对象集合传递给流中的下一步。选择 Yes 以启用根据 主维度 的设置分割返回的数据的连接。例如,如果将 Major dimension 设置为 Rows,则连接会返回行对象。每行对象会触发单独的流执行。也就是说,Fuse Online 为每个返回的行对象执行一次流。例如,如果轮询返回 5 行,Fuse Online 会执行流 5 次。

      Fuse Online 还提供离散分割和聚合步骤,您可将它们添加到流中。如果要在一个或多个步骤中处理单个对象,然后聚合行或列对象,请不要分割 Google Sheets 连接结果。相反,接受默认值 No,然后在此连接后向流添加分割步骤。如果您希望流中的聚合步骤,则需要分割步骤。

    6. Delay 字段中,接受默认值 30 秒,或者指定连接来获取电子表格数据的频率。
    7. Max results 字段中,如果您不想限制行或列轮询可以返回多少行或列,则接受默认值 0。Max results 的设置适用于结果列表中主要维度的设置。要限制连接为主要维度返回的数据,请指定整数。

      例如,假设主要维度为行,并且 Max results 设置为 25。轮询返回不超过 25 行的值。

      Range 指定主维度,还指定了 Max results,轮询使用较低数字来确定要返回的数据量。因此,当您只为 Range 指定次维度时,为 Max results 设置一个值会很有用。例如,假设一个表,每行中有三个值列有 30 行。假设 Major 维度RowsRangeA:C。如果将 Max results 设置为 10,轮询会返回 10 行数据。如果您接受 0 作为 Max results 的设置,则轮询会返回 30 行。但是,如果您将 Range 指定为 A1:C15,并且您也将 Max results 指定为 25,则轮询会返回 15 行。如果将 Range 指定为 A1:C30,并且您也将 Max results 指定为 25,轮询会返回 25 行。

  4. Next 查看当 Major dimension 设置为 Rows 时连接获取的数据中的列名称。如果 Major dimensionColumns,则此字段中的内容将被忽略,您可以点 Next 来完成此流程。

    Column names 字段中出现的值成为数据映射程序步骤显示的字段名称。如果您指定了标头行号,Fuse Online 会在您要从中获取数据的表格中显示该行中的标题。如果您将标题行号留空,Fuse Online 会在您要获取的数据范围内为每个列显示一个字母(ABC 等)。

  5. (可选)编辑 Column name 字段,使其包含要在数据映射程序步骤中看到的字段名称。该字段必须包含用逗号分开的列表,如 Name,Address,City,State,Zip
  6. Next 将这个 Google Sheets 连接添加到流中。

后续步骤

如果您将 Google Sheets 连接添加为启动连接,Fuse Online 会提示您添加集成的完成连接。随着集成中的开始和完成连接,添加集成中您想要的任何其他连接。

获取表格值的连接后,添加数据映射程序步骤。在数据映射程序中,Fuse Online 根据如何配置获取电子表格值的操作来显示源字段。也就是说,如果主要维度是 Rows,则数据映射器会将列名称列为您可以映射到目标的字段。如果主要维度是 Columns,则数据映射器会将行索引列为您可以映射到目标的字段。

其他资源

Google A1 表示法 用于在电子表格中指定单元组

10.4.3. 在轮询返回电子表格属性时触发集成

要在从 Google Sheets 电子表格获取属性时触发集成执行,请在启动连接时将 Google Sheets 连接添加到简单集成。当集成运行时,Google Sheets 连接会在您指定的间隔轮询电子表格,获取电子表格属性,并将结果传递给集成中的下一步。

属性包括电子表格的标题、区域设置和时区。在轮询之间,如果没有对表属性的更改,则下一次轮询会返回与上一轮询相同的值。

先决条件

  • 您创建了 Google Sheets 连接,它有权访问您要从中获取属性的电子表格。

流程

  1. 在左侧的 Fuse Online 面板中,单击 Integrations
  2. Create Integration
  3. Choose a connection 页面上,单击您要用来启动集成的 Google Sheets 连接。
  4. Choose an action 页面上,选择 Get spreadsheet 属性 操作。
  5. 配置 Get spreadsheet 属性 操作:

    1. SpreadsheetId 字段中,输入 Google 电子表格的 ID,该表可从此 Google Sheets 连接被授权访问的 Google 帐户访问。

      要获取电子表格 ID,请在浏览器中显示电子表格。该 ID 是 d//edit 之间的 URL 的一部分。

    2. Delay 字段中,接受默认值 30 秒,或者指定连接来获取属性的频率。
  6. Next 将这个 Google Sheets 连接添加为集成的启动连接。

结果

该集成现在有一个启动连接,Fuse Online 会提示您选择集成的完成连接。

10.4.4. 创建电子表格

要在流的中间创建新的电子表格,请在开始和完成连接之间添加 Google Sheets 连接。虽然您还可以完成与创建电子表格的 Google Sheets 连接的简单集成,但您不能在同一连接中添加数据到新的电子表格中。因此,当您要创建电子表格并将数据添加到同一流的电子表格中时,流程需要两个 Google Sheets 连接。一个连接会创建电子表格,然后后续连接会将数据添加到电子表格中。

先决条件

  • 您创建了 Google Sheets 连接,它有权访问您要在其中创建电子表格的 Google 帐户。
  • 您正在创建或编辑流,Fuse Online 会提示您添加到集成。或者,Fuse Online 正在提示您选择完成连接。

流程

  1. Add to Integration 页面上,单击您要添加连接的加号。如果 Fuse Online 正在提示您选择完成连接,请跳过这一步。
  2. 点一个 Google Sheets 连接,它被授权访问您要用来创建电子表格的 Google 帐户。
  3. Choose an action 页面上,选择 Create spreadsheet
  4. 配置 Create spreadsheet 操作:

    1. Title 字段中,输入新电子表格的标题。
    2. Time Zone 字段中,输入新电子表格应使用的时区,例如,印度标准时间,即 India Standard Time,或 netobserv。
    3. Locale 字段中,输入新电子表格的区域设置,如 Canada、或 香港
  5. Next 将连接添加到流。连接会出现在您添加它的集成视觉化中。

结果

创建电子表格的连接返回新电子表格的电子表格 ID。在后续步骤中,您可以将此电子表格 ID 映射到访问新电子表格的连接中的电子表格 ID,例如更新它。

10.4.5. 更新表中的数据

在集成中,您可以在流中更新电子表格中的数据或完成简单的集成。为此,请将 Google Sheets 连接添加到流中间,或作为一个简单的集成完成连接。

先决条件

  • 您创建了 Google Sheets 连接,它有权访问您要更新的 Google 电子表格。
  • 您可以访问您要更新的电子表格的电子表格 ID。
  • 您正在创建或编辑流,Fuse Online 会提示您添加到集成。或者,Fuse Online 正在提示您选择完成连接。

流程

  1. Add to Integration 页面上,单击您要添加连接的加号。如果 Fuse Online 正在提示您选择完成连接,请跳过这一步。
  2. 点授权访问您要更新的电子表格的 Google Sheets 连接。
  3. Choose an action 页面上,选择 Update sheet 值
  4. 配置 Update sheet 值 操作:

    1. SpreadsheetId 字段中执行以下操作之一:

      • 输入您要更新的电子表格的 ID。
      • 将字段留空。在这种情况下,在将此连接添加到流后,您必须在此连接前添加数据映射程序步骤。在数据映射程序步骤中,将上一连接中的电子表格 ID 映射到此连接。以上连接必须访问此连接中您要更新的电子表格。
    2. Range 字段中,使用 Google A1 表示法指定要更新的电子表格单元。指定开始和结束协调,例如 A1:D4 更新电子表格中第一个 4 行的前 4 列。

      默认值为 A:A,它会更新电子表格中第一列。

    3. Major dimension 字段中,接受 Rows (默认值),或者选择 Columns 将操作配置为使用行对象来更新表。每行对象包含您要更新的每个列的值。 将操作配置为使用列对象来更新表。每个列对象包含您要更新的每行的值。
    4. Value 输入选项 字段中,指示您希望 Google sheets 如何解释它接收的数据来更新表。未指定 (默认值)可让 Google Sheets 自动转换它识别的数据。例如,如果输入数据是日期,则 Google Sheets 将其格式化为日期。如果输入数据是一个十进制,则 Google Sheets 会将它格式化为十进制。

      • 未指定 的默认值是 Google Sheets API 设置,它默认为 User 输入
      • raw 会导致 Google Sheets 插入输入数据。
      • 输入的用户 启用了自动转换可识别的数据。
    5. Next 将连接添加到流。连接会出现在您添加它的位置的集成视觉化中。
  5. 如果要向流中添加任何其他连接,请立即添加它们,然后返回到这些指令。
  6. 在流都有所有所需的连接后,在集成视觉化中点加号,该符号仅在更新表值的 Google Sheets 连接之前。
  7. Data Mapper 卡将数据映射步骤添加到流中。
  8. 在数据映射程序中:

    1. 如果您在配置 Update sheet 值 操作时没有指定电子表格 ID,请将源 spreadsheetId 映射到目标 spreadsheetId
    2. 指定您要用来更新表的数据,方法是将源步骤中的字段映射到目标电子表格。例如,您可以映射其他电子表格或数据库中的字段。

      如果需要,您可以编辑 Google Sheets 连接,该更新表值并更改 RangeMajor 的维度 设置。更改这些设置会导致数据映射器根据您的更改显示不同的目标字段。

    3. 在右上角,点 Done 添加数据映射程序步骤。

10.4.6. 将数据附加到表

您可以将数据附加到流中间的表格中,或者完成简单的集成。为此,请将 Google Sheets 连接添加到流中间,或作为一个简单的集成完成连接。

先决条件

  • 您创建了 Google Sheets 连接,它有权访问要附加数据的 Google 电子表格。
  • 您可以访问要为其附加数据的电子表格的 ID。
  • 您正在创建或编辑流,Fuse Online 会提示您添加到集成。或者,Fuse Online 正在提示您选择完成连接。

流程

  1. Add to Integration 页面上,单击您要添加连接的加号。如果 Fuse Online 正在提示您选择完成连接,请跳过这一步。
  2. 点一个 Google Sheets 连接,它有权访问您要附加数据的电子表格。
  3. Choose an action 页面上,选择 Append values to a sheet
  4. Append 值配置为表格操作

    1. SpreadsheetId 字段中执行以下操作之一:

      • 输入您要将值附加到的电子表格的 ID。
      • 将字段留空。在这种情况下,在将此连接添加到流后,您必须在此连接前添加数据映射程序步骤。在数据映射程序步骤中,将上一连接中的电子表格 ID 映射到此连接。以上连接必须访问您要在此连接中附加数据的电子表格。
    2. Range 字段中,使用 Google A1 表示法指定要将数据附加到的电子表格范围。指定开始和结束协调,例如 A3:D3 在 4 列的第三行后将数据附加到第一个表格中。默认值为 A:A,它将数据附加到电子表格的第一列中。

      连接永远不会覆盖数据。连接会在您指定的范围后开始附加数据,然后始终将数据附加到现有内容中。

    3. Major dimension 字段中,接受 Rows (默认值),或者选择 Columns 将操作配置为使用行对象来附加数据。每行对象包含您要将数据附加到的每个列的值。 配置该操作,以使用列对象来附加数据。每个列对象包含您要附加的每个行的值。
    4. Value 输入选项 字段中,指示您希望 Google sheets 如何解释它接收的数据以附加到表格中。未指定 (默认值)可让 Google Sheets 自动转换它识别的数据。例如,如果输入数据是日期,则 Google Sheets 将其格式化为日期。如果输入数据是一个十进制,则 Google Sheets 会将它格式化为十进制。

      • 未指定 的默认值是 Google Sheets API 设置,它默认为 User 输入
      • raw 什么都不做。Google Sheets 会按照以下方式插入输入数据。
      • 输入的用户 启用了自动转换可识别的数据。
    5. Next 将连接添加到流。连接会出现在您添加它的集成视觉化中。

      您指定的值将 Append 值配置为表操作, 决定数据映射器显示的字段,以便从此连接中映射或从中映射的字段。

  5. 如果要向流中添加任何其他连接,请立即添加它们,然后返回到这些指令。
  6. 在流都有所有所需的连接后,在集成视觉化中点加号,该符号只是在将数据附加到表的 Google Sheets 连接之前。
  7. Data Mapper 将数据映射步骤添加到流中。
  8. 在数据映射程序中:

    1. 如果您在将 Append 值配置为电子表格操作时没有指定电子表格 ID,请将源 spreadsheetId 映射到目标 spreadsheetId
    2. 通过将源步骤中的字段映射到目标电子表格中指定要附加到表的数据。例如,您可以映射其他电子表格或数据库中的字段。

      如果需要,您可以编辑 Google Sheets 连接,该连接附加表格值并更改 RangeMajor 的维度 设置。更改这些设置会导致数据映射器根据您的更改显示不同的目标字段。

    3. 在右上角,点 Done 添加数据映射程序步骤。

10.4.7. 更新电子表格属性

在集成中,您可以更新流中电子表格的属性,或者完成简单的集成。为此,请将 Google Sheets 连接添加到流中间,或作为一个简单的集成完成连接。

属性包括电子表格的标题、区域设置和时区。

当 Fuse Online 提示您配置 Update spreadsheet 属性 操作时,您可以将一些或所有字段留空。如果您在此连接前将字段留空,然后在流(稍后添加它)之前将字段映射到空的 Update spreadsheet 属性配置 字段。

先决条件

  • 您创建了 Google Sheets 连接,它有权访问 Google 电子表格,其中包含您要更新的属性。
  • 您可以访问您要更新其属性的电子表格 ID。
  • 您正在创建或编辑流,Fuse Online 会提示您添加到集成。或者,Fuse Online 正在提示您选择完成连接。

流程

  1. Add to Integration 页面上,单击您要添加连接的加号。如果 Fuse Online 正在提示您选择完成连接,请跳过这一步。
  2. 点一个 Google Sheets 连接,它有权访问您要更新的属性的电子表格。
  3. Choose an action 页面上,选择 Update spreadsheet 属性
  4. 配置 Update spreadsheet 属性 操作:

    1. SpreadsheetId 字段中执行以下操作之一:

      • 输入您要更新其属性的电子表格的 ID。
      • 将字段留空。在这种情况下,在将此连接添加到流后,您必须添加此连接前的数据映射程序步骤。在数据映射程序步骤中,将上一连接中的电子表格 ID 映射到此连接。以上连接必须访问此连接中您要更新的电子表格。
    2. 在其他字段中,仅在您要更改属性时才输入一个值。或者,您可以将字段留空。如果您这样做,那么在稍后添加的数据映射程序步骤中,只需在此连接之前,您可以映射要更改的字段。
    3. Next 将连接添加到流。连接会出现在您添加它的集成视觉化中。
  5. 如果要向流中添加任何其他连接,请立即添加它们,然后返回到这些指令。
  6. 在流都有所有所需的连接后,您可能需要使用数据映射程序步骤来更新电子表格属性:

    1. 在集成视觉化中,单击刚刚在 Google Sheets 连接更新属性之前的加号。
    2. Data Mapper 将数据映射步骤添加到流中。
    3. 在数据映射程序中,如果您在配置 Update spreadsheet 属性操作时没有指定电子表格 ID,请将源 spreadsheetId 映射到目标 spreadsheetId
    4. 对于您要更改的每个电子表格属性,以及您在配置 Update spreadsheet 属性 时没有指定更新的值,将源步骤中的字段映射到您要更改的目标电子表格属性。
    5. 在右上角,点 Done 添加数据映射程序步骤。

10.4.8. 在表中添加 chart

在流中,或完成简单集成,您可以在 Google Sheets 电子表格中添加基本图表或照片。为此,请将 Google Sheets 连接添加到流中间,或作为一个简单的集成完成连接。然后,在连接前添加数据映射程序步骤。在数据映射程序步骤中,设置选项来确定 chart 的位置、属性和内容。

当 Fuse Online 提示您配置 Add chart 操作时,您可以将某些或所有字段留空。如果将一个字段留空,您可以在此连接前添加的数据映射器步骤中的值。

先决条件

  • 您创建了 Google Sheets 连接,它有权访问您要向其添加 chart 的 Google 电子表格。
  • 您可以访问要向其添加 chart 的电子表格的 ID。
  • 您正在创建或编辑流,Fuse Online 会提示您添加到集成。或者,Fuse Online 正在提示您选择简单集成的完成连接。

流程

  1. Add to Integration 页面上,单击您要添加连接的加号。如果 Fuse Online 正在提示您选择完成连接,请跳过这一步。
  2. 点击授权访问您要向其添加 chart 的电子表格的 Google Sheets 连接。
  3. Choose an action 页面中,选择 Add chart
  4. 配置 Add chart 操作:

    1. SpreadsheetId 字段中执行以下操作之一:

      • 输入您要将 chart 添加到的电子表格的 ID。
      • 将字段留空。在连接之前将的数据映射器步骤中,将上一连接中的电子表格 ID 映射到此连接。以上连接必须访问您要在此连接中添加 chart 的电子表格。
    2. Chart Title 字段中,输入标题。

      或者,将字段留空。在这个连接前的数据映射程序步骤中,将 source 字段或属性中的 chart 标题映射到 title 目标字段。

    3. Subtitle 字段中,输入子标题。

      或者,将字段留空。在这个连接前的数据映射程序步骤中,将 source 字段或属性中的 chart 子标题映射到 subtitle 目标字段。

  5. Next 将连接添加到流。连接会出现在您添加它的集成视觉化中。
  6. 如果要向流中添加任何其他连接,请立即添加它们。然后返回到这些指令。
  7. 在集成视觉化中,单击刚刚在添加 chart 的连接之前的加号。
  8. 单击 Data Mapper

    在数据映射器中,将源属性、源字段或源常量映射到目标 Google Sheets 连接,这是添加 chart。以下说明假定有一个 source 字段、源属性或源常数,其中包含您要映射到每个目标字段的值。

    如果没有所需值的源,点 Properties 文件夹右侧的 + 符号在 data mapper 中创建一个 source 属性。在 Create Property 对话框中,为属性指定一个名称,以便可以轻松地映射到正确的目标字段,例如,指定 overlayPosition 作为属性名称。对于属性值,请指定您希望连接用于创建 chart 的值。chart 的 overlay 位置字段需要 A1 表示法来标识单元。也就是说,它指定了一个起始位置,但不需要结束位置规格,如果存在,则忽略它。例如,指定 D4 作为 overlayPosition source 属性的值。保存新属性。

    当您配置了 Add chart 操作时,您可能会为电子表格 ID、图表标题和/或 chart 子标题指定值。如果这样做,请不要将值映射到该字段。

  9. 要将图表添加到表格中,将源属性、源字段或源常数映射到目标字段,如下所示:

    1. 通过将 A1 表示法值(用于标识单元格)映射到 overlayPosition 目标字段来设置 chart 的位置。不需要结束位置,如果存在,则忽略该位置。映射的值标识 Google Sheets 放置 chart 的单元。此单元是图表显示的左上角。

      如果您没有将值映射到 overlayPosition 字段,并且您也没有将值映射到 sheetId 字段,它标识您要将图表添加到的表,则默认行为是 Google Sheets 会创建一个新的表,并将 chart 放在 A1 中。

      如果您计划将值映射到 sheetId 字段,则必须将值映射到 overlayPosition 字段。

    2. 将源 spreadsheetId 字段映射到目标 spreadsheetId 字段。该连接使用此电子表格中的源数据,将 chart 添加到同一电子表格中的表格中。源数据和图表可以在同一电子表格中分为两个不同的表格,但它们不能处于两个不同的电子表格中。
    3. 通过映射到目标标题字段来设置图表 标题。该连接将这个字符串作为 Chart 的标题插入。
    4. 通过映射到目标 subtitle 字段来设置 chart 子标题。该连接将这个字符串作为图表子标题插入。
    5. 通过将整数映射到 sheetId 字段来识别要添加图表的表。

      如果将值映射到 sheetId 字段,则还必须将值映射到 overlayPosition 字段。

      如果您没有将值映射到 sheetId 字段,并且您也没有将值映射到 overlayPosition 字段,则连接会创建一个新的表,并将 chart 添加到新的表中。

      如果您没有将值映射到 sheetId 字段,但没有将值映射到 overlayPosition 字段,则连接会将 chart 放置到 sourceSheetId 字段标识的表上。这是提供 chart 数据的表。

      0 标识电子表格中的第一个表。在后续表格中,当表格 ID 在浏览器中可见时,表格 ID 位于 URL 的末尾。例如,在以下 URL 的末尾,您可以看到 gid=206589330

      https://docs.google.com/spreadsheets/d/1pa…​ngQbKkM/edit#gid=206589330

      这表示表 ID 是 206589330,这是您要映射到 sheetId 的值。

    6. 通过将整数表 ID 映射到目标 sourceSheetId 字段来识别提供图表数据的表。默认值为 0, 它标识电子表格中的第一个表。

      您可以添加基本 chart 或 pie chart。根据您要添加的图表类型,按照以下一组说明进行操作。

    7. 要添加基本图表,在目标面板中展开 basicChart 文件夹,并将 source 字段映射到 basicChart 文件夹中的目标字段:

      1. 通过映射到目标类型字段设置 chart 类型(BARLINEAREACOLUMN)。默认值为 COLUMN
      2. 通过映射到目标 axisTitleBottom 字段来设置 chart 的底部 axisis 的标题。
      3. 通过映射到目标 axisTitleLeft 字段来设置图表左侧的标题。
      4. 通过映射到目标 domainRange 字段来设置图表显示的高级别类别。此字段使用 Google Sheets A1 表示法。例如,假设源表中的第一列通过 A 2 提供 5 个产品列表,并且您希望图表为每个产品提供一些数据。在本列中,第一个单元(A1)必须包含标签,如 ProductsdomainRange 的设置将是 A1:A6。图表将包含 A2A6 中的数据。chart 不显示标签。
      5. 通过映射到目标 dataRange 字段来识别图表显示的源数据的位置。此字段使用 Google Sheets A1 表示法。chart 只能提供一系列数据。继续 domainRange 示例,假设源表中的第二列显示了第一列中列出的每个 5 个产品的编号,这是您希望图表显示的数据。在此列中,第一个单元(B1)必须包含标签,如 Number SolddataRange 的设置将是 B1:B6。图表将包含 B2B6 中的数据。chart 不显示标签。
    8. 要在目标面板中添加 pie chart,展开 pieChart 文件夹,并将源字段映射到 pieChart 文件夹中的目标字段:

      1. 通过映射到目标图例字段设置 pie chart legend 的位置。默认值为 LEFT_LEGEND。该值必须是 BOTTOM_LEGENDLEFT_LEGENDRIGHT_LEGENDTOP_LEGENDNO_LEGEND
      2. 通过映射到目标 domainRange 字段,设置 pie chart 显示的高级别类别。此字段使用 Google Sheets A1 表示法。例如,假设源表中的第一列通过 A 2 提供 5 个产品列表,并且您希望图表为每个产品提供一些数据。在本列中,第一个单元(A1)必须包含标签,如 ProductsdomainRange 的设置将是 A1:A6。图表将包含 A2A6 中的数据。chart 不显示标签。
      3. 通过映射到目标 dataRange 字段来识别图表显示的源数据的位置。此字段使用 Google Sheets A1 表示法。chart 只能提供一系列数据。继续 domainRange 示例,假设源表中的第二列显示了第一列中列出的每个 5 个产品的编号,这是您希望图表显示的数据。在此列中,第一个单元(B1)必须包含标签,如 Number SolddataRange 的设置将是 B1:B6。图表将包含 B2B6 中的数据。chart 不显示标签。
    9. 在右上角,点 Done 添加数据映射程序步骤。

10.4.9. 在表中添加 pivot 表

在流的中间或完成简单集成,您可以在 Google Sheets 电子表格中添加 pivot 表。Pivot 表可让您聚合、排序或应用功能来分散表格数据,并在相同的电子表格中显示结果。要添加 pivot 表,请在流的中间或简单集成完成连接中添加 Google Sheets 连接。然后,在连接前添加数据映射步骤。在数据映射步骤中,您可以设置选项来确定 pivot 表的位置、属性和内容。

在本发行版本中,Add pivot 表 操作被限制为定义一个值组、一行 pivot 组,以及一个列 pivot 组。预计会在以后的发行版本中添加对单一操作中的多个组的支持。作为临时解决方案,您可以添加多个 Google Sheets 连接,该连接会根据同一源电子表格添加 pivot 表。

先决条件

  • 您创建了 Google Sheets 连接,它有权访问要向其添加 pivot 表的 Google 电子表格。
  • 您可以访问包含 pivot 表的源数据的电子表格的 ID。
  • 您正在创建或编辑流,Fuse Online 会提示您添加到集成。或者,Fuse Online 正在提示您选择简单集成的完成连接。

流程

  1. Add to Integration 页面上,单击您要添加连接的加号。如果 Fuse Online 正在提示您选择完成连接,请跳过这一步。
  2. 点一个 Google Sheets 连接,它有权访问您要将 pivot 表添加到的电子表格。
  3. Choose an action 页面上,选择 Add pivot tables
  4. 要配置 Add pivot 表 操作,在 SpreadsheetId 字段中执行以下操作之一:

    • 输入您要将 pivot 表添加到的电子表格的 ID。
    • 将字段留空。在连接前添加的数据映射程序步骤中,您要将上一连接中的电子表格 ID 映射到此连接。以上连接必须访问您要在此连接中添加 pivot 表的电子表格。
  5. Next 将连接添加到流。连接会出现在您添加它的集成视觉化中。
  6. 如果要在此流中添加任何其他连接,请立即添加它们。然后返回到这些指令。
  7. 在集成视觉化中,单击刚刚在连接添加 pivot 表到表的加号。
  8. 单击 Data Mapper

    在数据映射器中,将源属性、源字段或源常数映射到目标 Google Sheets 连接,这是添加 pivot 表。以下说明假定有一个 source 字段、源属性或源常数,其中包含您要映射到每个目标字段的值。

    如果没有所需值的源,点 Properties 文件夹右侧的 + 符号在 data mapper 中创建一个 source 属性。在 Create Property 对话框中,为属性指定一个名称,以便可以轻松地映射到正确的目标字段,例如,指定 valueLayout 作为属性名称。指定您希望连接用于创建 pivot 表的值。pivot 表的值布局字段需要 HORIZONTAL VERTICAL 值,以便您可以指定 VERTICAL 作为 valueLayout 属性的值。保存新属性。

  9. 在数据映射程序中,配置一个新的 pivot 表,如下所示:

    1. 将源 spreadsheetId 字段映射到目标 spreadsheetId 字段。该连接使用此电子表格中的源数据,将 pivot 表添加到同一电子表格中的表格中。源数据和 pivot 表可以在同一电子表格中位于两个不同的表格中,但它们不能处于两个不同的电子表格中。
    2. 通过将整数映射到 sheetId 字段来识别要添加 pivot 表的表。默认值为 0, 它标识电子表格中的第一个表。在后续表格中,当表格 ID 在浏览器中可见时,表格 ID 位于 URL 的末尾。例如,在以下 URL 的末尾,您可以 gid=206589330

      https://docs.google.com/spreadsheets/d/1pa…​ngQbKkM/edit#gid=206589330.

      这表示表 ID 是 206589330,这是您要映射到 sheetId 的值。

    3. 通过将整数表 ID 映射到目标 sourceSheetId 字段来识别提供生成 pivot 表的数据的表。如果您没有将值映射到 sourceSheetId,则连接将使用 sheetId 值,如果没有映射到 sheetId,则连接将使用 0。0 标识电子表格中的第一个表。
    4. 通过将 A1 表示法值映射到 target sourceRange 字段来设置用于生成 pivot 表的源数据范围。例如,A2:D5
    5. 通过映射到目标 valueLayout 字段,设置 pivot 表中要使用的值布局。该值必须是 VERTICALHORIZONTAL,这是默认值。HORIZONTAL 指定值将 laid out 指定为列。
    6. 通过将 A1 表示法单元与目标 启动 字段映射,设置 pivot 表的顶端单元。当连接将 pivot 表添加到包含源数据的表中时,如果没有将值映射到 start 字段,则默认设置是 pivot 表的左单元格,位于源数据范围的第一行和源数据范围后的第一个空列中。当源数据是一个表格,并且 pivot 表将位于另一表格中时,默认值为 A1
    7. 要添加值组,请展开目标面板中的 valueGroups,并将值映射到 valueGroups 下的字段:

      1. 将值 组名称映射到目标名称字段
      2. 将您要应用到值组 的功能映射到目标功能 字段。该值必须是 SUMCOUNTAVERAGEMAXMINCUSTOM。默认值为 SUM。在定义公式时,将 CUSTOM 映射到 功能
      3. 如果将 CUSTOM 值映射到 function 字段,请将您要应用到值组的自定义 公式映射到目标公式 字段。
      4. 将构建值组的列名称映射到 target sourceColumn 字段。
    8. 要添加行 pivot 组,展开目标面板中的 columnGroups,并将值映射到 columnGroups 下的字段:

      1. 将行 pivot 组名称映射到目标 标签 字段。
      2. 将您要应用到行 pivot 组的排序顺序映射到目标 sortOrder 字段。该值必须是 ASCENDINGDESCENDING。默认值为 ASCENDING
      3. truefalse 映射到目标 showTotals 字段。默认值为 true,它可显示行 pivot 组的总总数。
      4. 将一个列名称(即构建行 pivot 组)映射到 target sourceColumn 字段。
    9. 要添加列 pivot 组,请展开目标面板中的 rowGroups,并将值映射到 rowGroups 下的字段:

      1. 将列 pivot 组名称映射到目标 标签 字段。
      2. 将您要应用到列的 pivot 组的排序顺序映射到目标 sortOrder 字段。该值必须是 ASCENDINGDESCENDING。默认值为 ASCENDING
      3. truefalse 映射到目标 showTotals 字段。默认值为 true,它启用列 pivot 组的总总数。
      4. 将构建列名称(构建列 pivot 组)映射到 target sourceColumn 字段。
    10. 在右上角,点 Done 添加数据映射程序步骤。

第 11 章 连接到 HTTP 和 HTTPS 端点

在集成中,您可以连接到 HTTP 和 HTTPS 端点,以执行 GETPUTPOSTDELETEHEADOPTIONSTRACE、TRACE 或 PATCH 方法。为此,请创建一个 HTTP 或 HTTPS 连接,然后将其添加到集成流中。以下主题提供详情:

11.1. 创建到 HTTP 或 HTTPS 端点的连接

在集成中,若要执行 HTTP GETPUTPOSTDELETEHEADOPTIONSTRACEPATCH 方法,请创建一个到 HTTP 或 HTTPS 端点的连接。然后,您可以将连接添加到一个或多个集成。

前提条件

您必须知道您要连接到的端点的 URL。

流程

  1. 在 Fuse Online 中,在左侧面板中,单击 Connections 以显示任何可用连接。
  2. 在右上角,单击 Create Connection 以显示 Fuse Online 连接器。
  3. 如果要使用 Hyper Text Transfer Protocol 连接到端点,点 HTTP 连接器。如果要使用 Hyper Text Transfer Protocol Secure,点 HTTPS 连接器。
  4. Base URL 字段中,输入端点路径。例如: www.mycompany.com/sales
  5. 单击 Validate。Fuse Online 立即尝试验证连接并显示一条消息,指示验证是否成功。如果验证失败,请重新检查基本 URL 的规格,然后重试。
  6. 如果验证成功,请单击 Next
  7. Name 字段中输入您选择的名称,可帮助您将这个连接与任何其他连接区分开来。例如,输入 HTTPS My Company Sales
  8. Description 字段中,输入有助于了解此连接的任何信息。
  9. Save 查看您创建的连接现在可用。如果您输入了示例名称,您会看到 HTTPS My Company Sales 显示为您可以选择添加到集成的连接。

11.2. 在集成中添加 HTTP 或 HTTPS 连接

您可以将 HTTP 或 HTTPS 连接添加到任意数量的集成。

前提条件

  • 您创建了 HTTP 或 HTTPS 连接。
  • 您正在创建或编辑流,Fuse Online 会提示您添加到集成。或者,Fuse Online 正在提示您选择启动连接,或者选择完成连接。

流程

  1. Add to Integration 页面上,单击您要添加连接的加号。如果 Fuse Online 正在提示您选择完成连接,请跳过这一步。
  2. 点击您要添加到流中的 HTTP 或 HTTPS 连接。
  3. 选择您要连接执行的操作:

    • 如果您要添加启动连接,则 Periodic invoke URL 是唯一可用的操作。此操作会按间隔调用端点,您在端点返回任何数据时指定和触发集成。
    • 如果您要添加中间或完成连接,则 Invoke URL 是唯一可用的操作。此操作调用端点一次。
  4. URL Path 字段中,指定您要调用的端点的位置。
  5. HTTP Method 字段中,选择您希望连接执行的方法。默认方法是 GET

    • GET 在 URL 路径获取内容。
    • PUT 将 URL 路径中的内容替换为集成数据。
    • POST 将集成数据存储在 URL 路径上以创建新内容。
    • DELETE 在 URL 路径中删除内容。
    • HEAD 在 URL 路径上获取有关内容的元数据。
    • OPTIONS 在 URL 路径获取通信选项设置。
    • TRACE 获取用于测试和诊断目的的信息。
    • PATCH 根据集成数据部分更新 URL 路径中的内容。
  6. 如果您要添加启动连接,它会定期调用 URL,然后在 Period 字段中接受默认的间隔 1 秒,或者指定数字及其单元(毫秒、秒、分钟或小时)来指示调用之间等待的时间。
  7. Next 指定操作的输入或输出类型。
  8. Select Type 字段中,如果不需要知道数据类型,则接受 类型规格, 然后点 Next。您不需要遵循这些指令的其余部分。

    但是,建议使用结构化的数据类型。例如,如果要在数据映射器步骤中映射连接输入/输出,您必须指定数据类型。数据映射器无法为非结构化数据分发字段。

    要指定数据类型,点 Select Type 字段,并选择以下之一作为 schema 类型:

    • JSON 模式是 描述 JSON 数据结构的文档。文档的介质类型是 application/schema+json
    • JSON 实例 是包含 JSON 数据的文档。文档的介质类型是 application/json
    • XML 模式 是一个描述 XML 数据结构的文档。文档的文件扩展为 .xsd
    • XML 实例 是包含 XML 数据的文档。文档的文件扩展为 .xml
  9. Definition 输入框中,粘贴符合您选择的 schema 类型的定义。例如,如果您选择 JSON 模式,您将粘贴 JSON 模式文件的内容,该文件的介质类型为 application/schema+json
  10. Data Type Name 字段中输入您为数据类型选择的名称。例如,如果您要为供应商指定 JSON 模式,您可以指定 Vendor 作为数据类型名称。

    在创建或编辑使用指定此类型的连接时,您将看到此数据类型名称。Fuse Online 在集成视觉化和数据映射程序中显示类型名称。

  11. Data Type Description 字段中,提供可帮助您区分此类型的信息。当您将鼠标悬停在处理此类型的步骤上时,此描述会出现在数据映射程序中。
  12. 点击 Next

结果

连接会出现在您添加它的集成视觉化中。

第 12 章 连接到 IRC

Internet Relay Chat (IRC)是一种协议,允许具有 IRC 客户端的任何人实时发送和接收文本消息。在集成中,与 IRC 的连接可以执行以下操作之一:

  • 当您指定的 IRC 别名收到私有消息时,触发简单的集成执行。集成将消息传递到流中的下一步。例如,您可以为接收可能的客户名称指定 IRC 别名。在收到信息后,集成可以连接到 Salesforce 以创建销售线索。
  • 向特定频道发送消息。消息来自您指定的 nickname。例如,当集成从 FTP 服务器下载文件并以某种方式处理该文件时,这非常有用。集成流可以向特定频道发送消息以指示进程成功。

要在集成中连接到 IRC,请创建一个 IRC 连接,然后将连接添加到集成流中。详情包括在以下主题中:

12.1. 创建 IRC 连接

在集成中,IRC 连接可以检索发送到您指定或发送消息到频道上的 nickname 的消息。您可以在任意数量的集成中使用相同的 IRC 连接。

先决条件

  • 您知道您要连接的 IRC 服务器的主机名和端口。
  • 如果 IRC 服务器需要密码,则知道密码。

流程

  1. 在 Fuse Online 中,在左侧面板中,单击 Connections 以显示任何可用连接。
  2. 在右上角,单击 Create Connection 以显示 Fuse Online 连接器。
  3. IRC 连接器。
  4. Hostname 字段中,输入 IRC 主机名。您可以指定 IP 地址或名称,例如 chat.freenode.net
  5. Port 字段中,输入 IRC 服务器侦听的端口,例如 6665
  6. Password 字段中,如果 IRC 服务器需要密码,请在此处输入它。
  7. 单击 Validate。Fuse Online 立即尝试验证连接并显示一条消息,指示验证是否成功。如果验证失败,请重新发送连接配置值并重试。
  8. 如果验证成功,请单击 Next
  9. Name 字段中输入您选择的名称,可帮助您将这个连接与任何其他连接区分开来。例如,输入 IRC Freenode
  10. Description 字段中,输入有助于了解此连接的任何信息。
  11. Save 查看更新的可用连接列表,包括您刚才创建的连接。如果您输入了示例名称,您会看到 IRC Freenode 显示为可添加到集成的连接。您可以将此连接添加到任意数量的集成。

12.2. 添加 IRC 连接以在收到消息时触发集成执行

当连接找到发送到您指定的 IRC 别名的私有消息时,IRC 连接启动集成会触发集成执行。

先决条件

  • 您创建了 IRC 连接。
  • 您有一个 IRC 别名用于接收和发送消息。
  • 您正在创建简单的集成,Fuse Online 会提示您选择如何开始集成。

流程

  1. 点击您要用来启动集成的 IRC 连接。
  2. 选择 IRC Receive Private Message 操作。
  3. Channels 字段中,选择使用逗号分隔的一个或多个 IRC 频道。
  4. Nickname 字段中,指定集成使用的 IRC 别名。对于您指定的任何频道,这个 nickname 会加入频道。在执行过程中,集成会检索发送到此 nickname 的消息,并将它们传递给集成中的下一步。
  5. NickServ Password 字段中,如果指定的 nickname 有密码,请输入它。
  6. Next 指定操作的输出类型。
  7. Select Type 字段中,如果不需要知道数据类型,则接受 类型规格, 然后点 Next。您不需要遵循这些指令的其余部分。

    但是,建议使用结构化的数据类型。例如,如果要在数据映射映射映射器步骤中的连接输出,您必须指定数据类型。数据映射器无法显示非结构化数据的字段。

    要指定数据类型,点 Select Type 字段,并选择以下之一作为 schema 类型:

    • JSON 模式是 描述 JSON 数据结构的文档。文档的介质类型是 application/schema+json
    • JSON 实例 是包含 JSON 数据的文档。文档的介质类型是 application/json
    • XML 模式 是一个描述 XML 数据结构的文档。文档的文件扩展为 .xsd
    • XML 实例 是包含 XML 数据的文档。文档的文件扩展为 .xml
  8. Definition 输入框中,粘贴符合您选择的 schema 类型的定义。例如,如果您选择 JSON 模式,您将粘贴 JSON 模式文件的内容,该文件的介质类型为 application/schema+json
  9. Data Type Name 字段中输入您为数据类型选择的名称。例如,如果您要为供应商指定 JSON 模式,您可以指定 Vendor 作为数据类型名称。

    在创建或编辑使用指定此类型的连接时,您将看到此数据类型名称。Fuse Online 在集成视觉化和数据映射程序中显示类型名称。

  10. Data Type Description 字段中,提供可帮助您区分此类型的信息。当您将鼠标悬停在处理此类型的步骤上时,此描述会出现在数据映射程序中。
  11. Next 将连接添加到流。

结果

该连接是一个简单的集成启动连接,Fuse Online 会提示您选择集成的完整连接。

12.3. 添加 IRC 连接以发送消息

在集成中,您可以在流中向一个或多个 IRC 频道发送消息,或完成简单的集成。为此,请在流的中间或简单集成完成连接中添加 IRC 连接。

先决条件

  • 您创建了 IRC 连接。
  • 您有一个 IRC 别名用于接收和发送消息。
  • 您正在创建或编辑流,Fuse Online 会提示您添加到集成。或者,Fuse Online 正在提示您选择完成连接。

流程

  1. Add to Integration 页面上,单击您要添加连接的加号。如果 Fuse Online 正在提示您选择完成连接,请跳过这一步。
  2. 点击您要添加到流中的 IRC 连接。
  3. 选择 IRC Send Message to Channel 以发送消息到一个或多个频道。

    • Channels 字段中,输入一个或多个以逗号分隔的 IRC 频道。在执行过程中,此连接会从您指定的 IRC 别名发送消息。
  4. Nickname 字段中,指定将消息发送到指定的频道的 IRC 别名。
  5. NickServ 密码字段中,如果您指定的 nickname 具有密码,请在此处指定。
  6. Next 指定操作的输入类型。
  7. Select Type 字段中,如果不需要知道数据类型,则接受 类型规格, 然后点 Next。您不需要遵循这些指令的其余部分。

    但是,建议使用结构化的数据类型。例如,如果要在数据映射映射映射器步骤中的连接输入,您必须指定数据类型。数据映射器无法显示非结构化数据的字段。

    要指定数据类型,点 Select Type 字段,并选择以下之一作为 schema 类型:

    • JSON 模式是 描述 JSON 数据结构的文档。文档的介质类型是 application/schema+json
    • JSON 实例 是包含 JSON 数据的文档。文档的介质类型是 application/json
    • XML 模式 是一个描述 XML 数据结构的文档。文档的文件扩展为 .xsd
    • XML 实例 是包含 XML 数据的文档。文档的文件扩展为 .xml
  8. Definition 输入框中,粘贴符合您选择的 schema 类型的定义。例如,如果您选择 JSON 模式,您将粘贴 JSON 模式文件的内容,该文件的介质类型为 application/schema+json
  9. Data Type Name 字段中输入您为数据类型选择的名称。例如,如果您要为供应商指定 JSON 模式,您可以指定 Vendor 作为数据类型名称。

    在创建或编辑使用指定此类型的连接时,您将看到此数据类型名称。Fuse Online 在集成视觉化和数据映射程序中显示类型名称。

  10. Data Type Description 字段中,提供可帮助您区分此类型的信息。当您将鼠标悬停在处理此类型的步骤上时,此描述会出现在数据映射程序中。
  11. Next 将连接添加到流。

结果

连接会出现在您添加它的流视觉化中。

第 13 章 连接到 JIRA

在集成中,您可以连接到 JIRA 服务器来获取、创建或更新问题。JIRA 是一个规划、跟踪和管理软件开发项目的工具。每个 JIRA 环境都允许自定义工作流,这会影响集成中连接到 JIRA 的详情。您的 Jira 管理员的咨询应阐明详细信息。

以下主题提供了创建连接到 JIRA 服务器的集成的信息和流程:

13.1. 使用使用 OAuth 的 JIRA 服务器注册 Fuse Online

集成可以连接到使用 OAuth 协议验证访问的 JIRA 服务器。要启用此功能,请将 Fuse Online 环境注册为 JIRA 客户端应用程序。JIRA 客户端应用程序也称为 JIRA 用户。换句话说,您的 Fuse Online 环境是一个 Jira 消费者。

注意

当 Jira 服务器只使用基本身份验证时,不需要注册。

按照以下步骤获取创建 Fuse Online 连接到 JIRA 所需的 JIRA OAuth 凭证。有关注册 Jira 用户的详情,包括通过示例服务器执行步骤的教程,请参阅有关 REST API 的 OAuth 的 JIRA 文档

使用 JIRA 服务器注册 Fuse Online 后,您可以使用 Fuse Online 创建与该 JIRA 服务器的连接。任何多个集成都可以使用相同的 JIRA 连接。但是,如果要创建另一个 JIRA 连接,则必须通过重复此处提供的注册步骤来获取另一组 OAuth 凭证。

主要步骤概述

注册过程中的主要步骤有:

  • 获取 Atlassian 命令行应用程序,供您获取 OAuth 凭证。
  • 运行下载的应用程序以创建 config.properties 文件。
  • 创建一个公钥/私钥对,Fuse Online 用于访问 JIRA 服务器。
  • 编辑 config.properties 文件以更新其某些值。
  • 配置 JIRA 服务器,将 Fuse Online 环境识别为消费者应用程序。
  • 获取 Fuse Online 访问 JIRA 服务器上的数据的 JIRA 访问令牌。

这些步骤各自有多个子步骤,以下步骤提供了详细信息。

先决条件

  • JIRA 服务器管理权限。
  • 熟悉命令行界面.

流程

  1. 获取 Atlassian 命令行应用程序,供您获取 OAuth 凭证:

    1. 前往 atlassian-oauth-examples 页面
    2. 在左侧面板中,单击底部的 下载
    3. Downloads 页面中,点 Download repository
    4. 将文件提取到您选择的目录中。
  2. 运行下载的应用程序为 OAuth 凭证创建 config.properties 文件:

    1. 在终端中,导航到包含提取内容的目录。
    2. 进入 java 目录并构建客户端:

      cd atlassianlabs-atlassian-oauth-examples-dd0264cad043/java
      mvn clean compile assembly:single
    3. 进入 目标目录 并生成 config.properties 文件:

      cd target
      java -jar OAuthTutorialClient-1.0.jar requestToken

    您可以忽略连接异常。在目标目录中,现在有一个 config.properties 文件,其中包含一些临时密钥。

  3. 生成一个公钥/私钥对,Fuse Online 需要访问 JIRA 服务器的需求。虽然您可以在任何位置运行这些命令,但第一条指令会将您定向到特定目录以便方便:

    1. 导航到包含下载应用程序的目录。
    2. 生成私钥:

      openssl genrsa -out jira_privatekey.pem 1024
    3. 获取公钥:

      openssl req -newkey rsa:1024 -x509 -key jira_privatekey.pem -out jira_publickey.cer -days 365

      此命令提示您输入 Fuse Online 环境的信息。或者,为了避免响应提示,请在命令中添加 -subj 选项。例如,在上面命令行的末尾,添加如下内容:

      -subj "/C=US/ST=New York/L=New York/O=MyCompany Ltd./OU=IT/CN=mysubdomain.mydomain.com"
    4. 导出密钥:

      openssl pkcs8 -topk8 -nocrypt -in jira_privatekey.pem -out jira_privatekey.pcks8
      openssl x509 -pubkey -noout -in jira_publickey.cer  > jira_publickey.pem

      您现在有四个文件:

      jira_privatekey.pcks8
      jira_privatekey.pem
      jira_publickey.cer
      jira_publickey.pem

    5. 获取私钥,没有标头、换行符和页脚:

      cat jira_privatekey.pcks8 | grep -v 'PRIVATE'|awk '{print}' ORS=''
    6. 将私钥复制到剪贴板。
  4. 编辑 config.properties 文件:

    1. 导航到包含 config.properties 文件的 java/target 目录,并打开文件进行编辑。
    2. config.properties 文件中,将私钥替换为您复制到剪贴板的私钥。
    3. jira_home 设置改为 JIRA 服务器的 URL。如果您的 Jira 服务器使用 https,请务必指定 https。此外,您还需要转义冒号。例如:

      jira_home=https\://issues.mycompany.org
    4. consumer_key 设置更改为 Fuse Online App。例如:

      consumer_key=Fuse Online App
    5. 保存并关闭 config.properties 文件。
  5. 配置 JIRA 服务器,将 Fuse Online 环境识别为消费者应用程序。您必须以管理用户身份登录到 JIRA 服务器。

    1. 选择 Settings ( cog )> Products > Application links
    2. Create new link input 字段中,输入任何 URL,例如,输入: https://example.com

      这将显示一个显示没有收到响应的对话框,这是 okay,因为只需要单向通信。

    3. Continue 以显示 Link applications 对话框。在此对话框中:

      1. Consumer Key 字段中,输入 Fuse Online App
      2. 在底部,选择 Create incoming 链接
      3. 在每个其他字段中输入任何值。每个字段都需要一个值。您输入的值无关紧要,因为不需要响应。
      4. 单击 Continue 以显示另一个对话框。
      5. Consumer Key 字段中,输入 Fuse Online App
      6. Consumer Name 字段中输入 Fuse Online App
      7. Public Key 字段中,粘贴位于 jira_publickey.pem 文件中的公钥。务必仅粘贴没有标头和页脚的密钥。要显示密钥以便复制它,在包含 jira_publickey.pem 文件的 目录中,请输入 cat jira_publickey.pem
      8. Continue
  6. 获取 Fuse Online 访问 JIRA 服务器上的数据的 JIRA 访问令牌。在此流程开始时链接到的 JIRA OAuth 文档中,此步骤被称为 "The Oauth dance",因为 Fuse Online、Jira 服务器和 JIRA 管理员之间存在交换。

    1. 导航到包含整个过程第一步中下载的命令行应用程序的目录中的 java/target 目录。
    2. 从 JIRA 服务器获取请求令牌:

      java -jar OAuthTutorialClient-1.0.jar requestToken

      这将显示类似如下的内容:

      Token:          ec3dj4byySM5ek3XW7gl7f4oc99obAlo
      Token Secret:   OhONj0eF7zhXAMKZLbD2Rd3x7Dmxjy0d
      Retrieved request token. go to https://jira101.atlassian.net/plugins/servlet/oauth/authorize?oauth_token=ec3dj4byySM5ek3XW7gl7f4oc99obAlo to authorize it
    3. 在另一个浏览器标签页中,前往该输出中提供的 URL。该页建议您进行 Jira,并提示您访问 Fuse Online App。
    4. 单击 Allow,它会显示一个 Access Approved 页面,其中包含验证代码。
    5. 将验证代码复制到剪贴板,并将它粘贴在某个位置,以便您可以轻松地检索它。
    6. 通过调用如下命令来获取访问令牌:在以下命令行示例中,最后一个值是验证代码。在运行的命令中,将示例验证代码替换为您在上一步中复制的验证代码。例如:

      java -jar OAuthTutorialClient-1.0.jar accessToken qTJkPi

      这个命令的输出是 Fuse Online 需要访问您的 JIRA 服务器的访问令牌。

结果

JIRA 命令行应用程序更新 config.properties 文件,使其包含为 Fuse Online 配置 JIRA 连接所需的所有值。

后续步骤

创建一个 JIRA 连接。

13.2. 创建 JIRA 连接

在集成中,要获取、创建或更新 JIRA 问题,请创建一个 JIRA 连接,然后添加到集成中。您可以将相同的连接添加到任意数量的集成。

如果您要连接的 JIRA 服务器使用 OAuth 协议来验证访问,则必须将 Fuse Online 环境注册为您要连接的 JIRA 服务器的客户端。请参阅 使用 OAuth 的 JIRA 服务器注册 Fuse Online

先决条件

  • 对于使用基本身份验证的 Jira 服务器,您有一个 JIRA 用户名和密码。
  • 对于使用 OAuth 的 JIRA 服务器,您可以访问 config.properties 文件,该文件包含 JIRA 访问令牌、消费者密钥、私钥和验证代码的值。

流程

  1. 在 Fuse Online 中,在导航面板中点 Connections 以显示所有可用的连接。
  2. 在右上角,单击 Create Connection 以显示可用的连接器。
  3. JIRA 连接器。
  4. JIRA URL 字段中,输入您要连接到的 JIRA 服务器的 URL,例如 https://issues.mycompany.org

    对于到 JIRA 服务器的连接使用 OAuth,注册 Fuse Online 环境作为 JIRA 消费者应用程序的步骤会导致 config.properties 文件。您在此处指定的 URL 应该是该 config.preperties 文件中的同一 URL。例如,您可以在 config.properties 文件中看到类似如下的行:

    jira_home=https\:issues.mycompany.org
  5. 如果这个 Jira 服务器使用基本身份验证:

    1. User name 字段中输入 JIRA 用户名。该连接使用此帐户在指定的 JIRA 服务器上操作。
    2. Password 字段中,输入指定的用户的密码。

    如果 JIRA 服务器没有使用 OAuth 身份验证,请跳过下一步。

  6. 如果 Jira 服务器使用 OAuth 身份验证:

    1. 打开 config.properties 文件,其中包含 OAuth 访问令牌、密钥和验证代码。这是注册步骤结果的文件。从该文件中复制值并将其粘贴到连接配置字段中。
    2. access_token 值复制到 Access Token 字段中。
    3. consumer_key 值复制到 Consumer Key 字段中。
    4. private_key 值复制到 Private Key 字段中。
    5. secret 值复制到 Verification Code 字段中。
  7. 单击 Validate。Fuse Online 显示一条消息,指示它是否可以验证此连接。如果验证失败,请重试,并确保输入正确的值。
  8. 验证成功后,单击 Next
  9. Name 字段中输入您选择的名称,可帮助您将这个连接与任何其他连接区分开来。例如,输入 JIRA Connect 1
  10. Description 字段中,输入有助于了解此连接的任何信息。例如,输入 使用 jkim 帐户的 Sample Jira 连接。
  11. Save 查看您创建的连接现在可用。如果您输入了示例名称,您会看到 JIRA Connect 1 显示为一个连接,您可以选择添加到集成。

13.3. 获取 JIRA 问题或注释以触发集成执行

要在从 JIRA 服务器获取问题或注释时触发集成执行,请添加 JIRA 连接作为简单的集成启动连接。

先决条件

  • 您创建了 JIRA 连接。

流程

  1. 在左侧的 Fuse Online 面板中,单击 Integrations
  2. Create Integration
  3. Choose a connection 页面中,点您要用来启动集成的 JIRA 连接。
  4. Choose an action 页面中,选择一个操作:

    • 检索 New Comments 使用您指定的查询来搜索 JIRA 服务器。对于查询返回的每个问题,连接会检查连接是否在之前调用查询后添加注释。连接返回任何新注释。
    • 检索 New issues 使用您指定的查询来搜索 JIRA 服务器。对于查询返回的每个问题,连接会检查其创建日期。如果因为之前调用查询而创建了问题,连接会将问题返回到集成。连接第一次执行此查询时,它会返回它找到的所有问题。
  5. Delay 字段中,接受默认的 5000 毫秒(5 秒),或者输入要在查询调用之间经过的毫秒数。
  6. JIRA Query Language 字段中,输入 JIRA 查询。例如:

    project = GATE AND assignee = jkim AND (status = Open OR status = New OR status = Reopened)

    此查询在 网关在线项目中发现问题,这些项目被分配给 jkim 且未解析。每个 Jira 项目都有一个短名称和长名称。在本例中,网关在线 项目的短名称为 GATE。在查询中,指定项目的短名称。

    更具体的查询是,搜索 JIRA 服务器所需的时间比较短。当查询没有任何结果时,连接不会触发集成执行。

  7. 点击 Next

结果

该连接启动一个简单的集成,Fuse Online 会提示您选择集成的完成连接。

13.4. 在 JIRA 服务器中添加问题

在流中或完成简单集成,您可以连接到 JIRA 服务器来添加问题。

先决条件

  • 您创建了 JIRA 连接。
  • 您正在创建或编辑流,Fuse Online 会提示您添加到集成。或者,Fuse Online 正在提示您选择简单集成的完成连接。

流程

  1. Add to Integration 页面中,单击您要添加 JIRA 连接的加号。如果要添加简单的集成完成连接,请跳过这一步。
  2. 点击您要用来连接到 JIRA 服务器的 JIRA 连接。
  3. Choose an action 页面上,选择 Add Issue
  4. 配置操作。必要字段是 Issue type ID 或 nameProject key。对于可选字段,您可以现在输入值,或者在将此连接添加到集成后输入值,您可以在此连接前添加数据映射程序步骤。在数据映射程序步骤中,将前面步骤中的字段映射到此连接中的可选字段。

    1. 另外,在 Assignee 字段中,为您要为其分配此问题的人员输入 JIRA 用户名。
    2. (可选)在 Components 字段中输入一个或多个组件的名称。使用逗号分隔多个名称。JIRA 管理员定义了您可以指定的组件。
    3. (可选)在 Priority ID 或 name 字段中输入新问题的优先级。JIRA 管理员定义您可以输入的优先级值。
    4. (可选)在 Summary 字段中输入有关此问题的简单语句。
    5. Issue type ID 或 name 字段中输入描述问题类型的值。例如,这通常类似于 StoryEpicChoreBug

      在 Jira 中,具有管理员权限的用户可以通过选择 Project settings > Issue type 来查看有效的问题类型列表。没有这些权限的用户可以在问题的 type 字段中点,并显示允许值的列表。

    6. (可选)在 Watchers 字段中输入以逗号分隔的 JIRA 用户名列表。这些人员在更新此问题时收到通知。
    7. Project Key 字段中,输入 JIRA 管理员定义的 JIRA 项目的短名称。该连接会在这个项目中创建新问题。例如,项目密钥类似于 GATE
    8. (可选)在 Description 字段中输入有关此问题的任何信息,这有助于捕获。
  5. 点击 Next

结果

连接会出现在您添加它的集成视觉化中。

13.5. 在 JIRA 问题中添加注释

在流中或完成简单集成,您可以连接到 JIRA 服务器来向问题添加注释。

先决条件

  • 您创建了 JIRA 连接。
  • 您正在创建或编辑流,Fuse Online 会提示您添加到集成。或者,Fuse Online 正在提示您选择简单集成的完成连接。

流程

  1. Add to Integration 页面中,单击您要添加 JIRA 连接的加号。如果要添加简单的集成完成连接,请跳过这一步。
  2. 点击您要用来连接到 JIRA 服务器的 JIRA 连接。
  3. Choose an action 页面上,选择 Add Comment
  4. Comment 字段中,输入您要添加到问题或计划在此连接前添加数据映射程序步骤的注释。在该数据映射程序步骤中,将上一集成步骤中的注释映射到此连接 的注释 字段。
  5. Issue Key 字段中,为问题输入 JIRA 标识符。问题密钥示例: GATE-1234Ent-239.
  6. 点击 Next

结果

连接会出现在您添加它的集成视觉化中。

后续步骤

要将上一个集成步骤中的注释映射到此连接,请添加提供注释内容的连接,然后在此 JIRA 连接前添加数据映射程序步骤。例如,假设数据库连接获取客户记录。在数据映射程序步骤中,将客户记录的集合映射到 JIRA 连接 的注释 字段。

13.6. 将文件附加到 JIRA 问题

在流中或完成简单集成,您可以连接到 JIRA 服务器来将一个或多个文件附加到问题。在集成中,必须有一个上一步来获取您要附加的文件。

先决条件

  • 您创建了 JIRA 连接。
  • 您正在创建或编辑流,Fuse Online 会提示您添加到集成。或者,Fuse Online 正在提示您选择简单集成的完成连接。

流程

  1. Add to Integration 页面中,单击您要添加 JIRA 连接的加号。如果要添加简单的集成完成连接,请跳过这一步。
  2. 点击您要用来连接到 JIRA 服务器的 JIRA 连接。
  3. Choose an action 页面上,选择 Attach File
  4. Issue Key 字段中,输入您要将文件附加到的问题的 JIRA 标识符。问题密钥示例: GATE-1234Ent-239.
  5. 点击 Next

结果

连接会出现在您添加它的集成视觉化中。

后续步骤

如果集成还没有一个更早的连接,它会获取您要附加到 JIRA 问题的文件,请将该连接添加到集成。确保它在附加文件的 Jira 连接之前。例如,假设您添加 FTP 连接,并从 FTP 服务器下载一个或多个文件。当集成执行时,后续的 Jira 连接会将这些文件附加到您在配置 attach 文件操作时指定的 JIRA 问题。

13.7. 添加和删除 JIRA 问题监视器

在流中或完成简单集成,您可以连接到 JIRA 服务器,将监视器添加到问题,并/或删除问题。

先决条件

  • 您创建了 JIRA 连接。
  • 您正在创建或编辑流,Fuse Online 会提示您添加到集成。或者,Fuse Online 正在提示您选择简单集成的完成连接。

流程

  1. Add to Integration 页面中,单击您要添加 JIRA 连接的加号。如果要添加简单的集成完成连接,请跳过这一步。
  2. 点您要集成的 JIRA 连接。
  3. Choose an action 页面上,选择 Add Issue
  4. Issue Key 字段中,输入您要向或移除观察者添加观察者的问题的 JIRA 标识符。问题密钥示例: GATE-1234Ent-239.
  5. (可选)在 Add Watchers 字段中输入以逗号分隔的 JIRA 用户名列表。这些人员在更新此问题时收到通知。
  6. 另外,在 Remove Watchers 字段中,输入以逗号分隔的 JIRA 用户名列表,这些名称已经监视了此问题。该连接从监视者列表中删除这些用户。
  7. 点击 Next

结果

连接会出现在您添加它的集成视觉化中。

13.8. 更新 JIRA 服务器中的问题

在流中或完成简单集成,您可以连接到 JIRA 服务器来更新问题。连接可以更新一个或多个问题字段。如果更新问题已经有字段的值,则该连接会将该值替换为您为连接指定的任何值,或者您映射到连接字段。例如,如果问题已经有描述,并且您在配置 Update Issue 操作时在 Description 字段中指定文本,连接会将描述替换为这个新描述。

先决条件

  • 您创建了 JIRA 连接。
  • 您正在创建或编辑流,Fuse Online 会提示您添加到集成。或者,Fuse Online 正在提示您选择简单集成的完成连接。

流程

  1. Add to Integration 页面中,单击您要添加 JIRA 连接的加号。如果要添加简单的集成完成连接,请跳过这一步。
  2. 点击您要用来连接到 JIRA 服务器的 JIRA 连接。
  3. Choose an action 页面上,选择 Update Issue
  4. 配置操作。唯一必填字段是 Issue Key。对于可选字段,您可以现在输入值,或者在将此连接添加到集成后输入值,您可以在此连接前添加数据映射程序步骤。在数据映射程序步骤中,将前面步骤中的字段映射到此连接中的可选字段。

    1. 另外,在 Assignee 字段中,为您要为其分配此问题的人员输入 JIRA 用户名。
    2. (可选)在 Components 字段中输入一个或多个组件的名称。使用逗号分隔多个名称。JIRA 管理员定义了您可以指定的组件。
    3. Issue Key 字段中,为您要更新的问题输入 JIRA 标识符。问题密钥示例: GATE-1234Ent-239.
    4. (可选)在 Priority ID 或 name 字段中输入新问题的优先级。JIRA 管理员定义您可以输入的优先级值。
    5. (可选)在 Summary 字段中输入有关此问题的简单语句。
    6. Issue type ID 或 name 字段中输入描述问题类型的值。例如,这通常类似于 StoryEpicChoreBug
    7. (可选)在 Description 字段中输入有关此问题的任何信息,这有助于捕获。
  5. 点击 Next

结果

连接会出现在您添加它的集成视觉化中。

13.9. 将 JIRA 问题转换为新状态

在流的中间或完成简单集成,您可以连接到 JIRA 服务器来将问题转换为新状态,或迁移到新的工作流阶段。JIRA 管理员定义了问题转换的方法以及转换 ID 的值。

先决条件

  • 您创建了 JIRA 连接。
  • 您正在创建或编辑流,Fuse Online 会提示您添加到集成。或者,Fuse Online 正在提示您选择简单集成的完成连接。

流程

  1. Add to Integration 页面中,单击您要添加 JIRA 连接的加号。如果要添加简单的集成完成连接,请跳过这一步。
  2. 点击您要用来连接到 JIRA 服务器的 JIRA 连接。
  3. Choose an action 页面上,选择 Transition Issue

    您不需要指定任何值来配置转换问题操作。相反,您可以将之前集成步骤中的值映射到此连接中的字段。

  4. 另外,在 Comment 字段中输入您要添加到此问题的注释。
  5. 另外,在 Issue Key 字段中,为正在转换的问题输入 JIRA 标识符。问题密钥示例: GATE-1234Ent-239.
  6. (可选) 在转换字段的 ID 中,输入 JIRA 管理员与特定转换关联的整数,如 JIRA 从新变为新工作的时间,或者在它被测试时。

    JIRA 管理员可以查看项目工作流显示中的转换 ID。如果您没有管理权限,请从 JIRA 管理员获取允许的转换 ID。

  7. 点击 Next

结果

连接会出现在您添加它的集成视觉化中。

后续步骤

如果您没有在每个 Transition Issue 字段中指定一个值,请确保集成有一个步骤来获取每个字段的值。集成所有需要的连接后,在 JIRA 连接转换问题前添加一个数据映射程序步骤。在数据映射程序步骤中,将上一步中的字段映射到 JIRA 连接中的字段来转换问题。

第 14 章 连接到 Kafka

Apache Kafka 是一个分布式流平台,可用于获取和发布数据。在集成中,您可以从您指定的 Kafka 主题订阅数据,或将数据发布到您指定的 Kafka 主题。要做到这一点,请启用 Fuse Online 来发现集群中的 Kafka 代理。然后,创建到 Kafka 的连接并添加到集成流的连接。详情包括在以下主题中:

14.1. 启用 Kafka 代理/AMQ Streams 的自动发现

在集成中,如果您计划连接到一个 AMQ Streams 实例的 Kafka 代理,请在创建 Kafka 连接前启用此类代理的自动发现。这样可以更轻松地创建 Kafka 连接,因为 Fuse Online 可以提供配置连接所需的 Kafka 代理详情。

要启用自动发现,您可以授予 OpenShift 用户帐户特权,以允许该帐户查看集群中的资源。您指定的特定权限可让帐户发现不同的代理子集。

先决条件

  • 您在 OCP 现场运行 Fuse Online。
  • 已安装 oc 客户端工具,并将其连接到要在其中启用 Kafka 代理的自动发现集群。
  • 有集群管理权限。
  • 要在集成中连接到的 Kafka 代理(AMQ Streams 实例)会在与 Fuse Online 相同的集群中安装。

流程

  1. 使用具有集群管理权限的帐户登录 OpenShift。例如:

    $ oc login -u admin -p admin
  2. 确保当前项目是 Fuse Online 运行的项目。要查看当前项目,请调用以下命令:

    $ oc project
  3. 授予向 oc 用户帐户启用集群中 Kafka 代理的访问权限的权限。如何配置集群决定了您需要授予的权限。例如,对于 minishift 上的 Strimzi 集群,您可以执行以下操作:

    1. 创建一个集群角色,可访问集群中的 Kafka/Strimzi 资源。在以下示例中,kafkas.kafka.strimzi.io-view 是新角色的名称:

      oc create clusterrole kafkas.kafka.strimzi.io-view --verb=get,list --resource=kafkas --resource=crd
    2. 将此集群角色添加到 oc 用户。在以下示例中,syndesis-serveroc 用户帐户的名称:

      oc adm policy add-cluster-role-to-user kafkas.kafka.strimzi.io-view -z syndesis-server

结果

在 Fuse Online 中,当您创建 Kafka 连接时,连接配置页面会显示可用的 Kafka 代理。您可以选择要连接访问的代理。

14.2. 创建到 Kafka 代理的连接

在集成中,若要从 Kafka 主题订阅数据或将数据发布到 Kafka 主题,请创建一个到 Kafka 的连接,然后将该连接添加到集成。

重要

在这个发行版本中,到 Kafka 的连接不支持 SSL。预计会在以后的版本中有所变化。

先决条件

  • 在集群中启用了 Kafka 代理的自动发现。或者,您知道您要连接的 Kafka 代理的 URI。

流程

  1. 在 Fuse Online 中,在左侧面板中,单击 Connections 以显示任何可用连接。
  2. 在右上角,单击 Create Connection 以显示连接器。
  3. Kafka 连接器。
  4. Kafka broker URIs 字段中,选择您希望此连接访问的代理,或者输入以逗号分隔的 Kafka 代理 URI 列表。每个 URI 的格式应为 host:port
  5. 单击 Validate。Fuse Online 立即尝试验证连接并显示一条消息,指示验证是否成功。如果验证失败,请重新发布输入参数并重试。
  6. 如果验证成功,请单击 Next
  7. Name 字段中输入您选择的名称,可帮助您将这个连接与任何其他连接区分开来。例如,您可以输入 Kafka West
  8. Description 字段中,输入有助于了解此连接的任何信息。
  9. Save 查看您创建的连接现在可用。如果您输入了示例名称,您会看到 Kafka West 显示为可添加到集成的连接。

14.3. 从 Kafka 代理获取数据以触发集成执行

要在从 Kafka 代理接收数据时触发集成执行,请添加 Kafka 连接作为启动连接。当集成运行时,Kafka 连接会在您指定的 Kafka 主题中持续监控数据。当连接找到新数据时,它会将这些数据传递给集成中的下一步。

前提条件

您创建了与 Kafka 代理的连接。

流程

  1. 在左侧的 Fuse Online 面板中,单击 Integrations
  2. Create Integration
  3. Choose a connection 页面中,点击您要用来启动集成的 Kafka 连接。
  4. Choose an action 页面中,选择 Subscribe 操作来从您指定的主题接收数据。
  5. Topic Name 字段中,点 down carat 以显示主题列表,然后单击您要订阅的主题。或者,键入主题名称来创建该主题。
  6. Next 指定操作的输出类型。
  7. Select Type 字段中,如果不需要知道数据类型,则接受 类型规格, 然后点 Next。您不需要遵循这些指令的其余部分。

    但是,建议使用结构化的数据类型。例如,如果要将 Kafka 连接输出映射到后续步骤,您必须指定数据类型。数据映射器无法识别非结构化数据。

    要指定数据类型,点 Select Type 字段,并选择以下之一作为 schema 类型:

    • JSON 模式是 描述 JSON 数据结构的文档。文档的介质类型是 application/schema+json
    • JSON 实例 是包含 JSON 数据的文档。文档的介质类型是 application/json
    • XML 模式 是一个描述 XML 数据结构的文档。文档的文件扩展为 .xsd
    • XML 实例 是包含 XML 数据的文档。文档的文件扩展为 .xml
  8. Definition 输入框中,粘贴符合您选择的 schema 类型的定义。例如,如果您选择 JSON 模式,您将粘贴 JSON 模式文件的内容,该文件的介质类型为 application/schema+json
  9. Data Type Name 字段中输入您为数据类型选择的名称。例如,如果您要为供应商指定 JSON 模式,您可以指定 Vendor 作为数据类型名称。

    在创建或编辑使用指定此类型的连接时,您将看到此数据类型名称。Fuse Online 在集成视觉化和数据映射程序中显示类型名称。

  10. Data Type Description 字段中,提供可帮助您区分此类型的信息。当您将鼠标悬停在处理此类型的步骤上时,此描述会出现在数据映射程序中。
  11. 点击 Next

结果

集成现在有一个启动连接,Fuse Online 会提示您选择完成连接。

14.4. 将数据发布到 Kafka 代理

在集成中,您可以在流中将数据发布到 Kafka 代理,或者完成简单的集成。要做到这一点,在流的中间或一个简单的集成完成连接中添加 Kafka 连接。

先决条件

  • 您创建了与 Kafka 代理的连接。
  • 您正在创建或编辑流,Fuse Online 会提示您添加到集成。或者,Fuse Online 正在提示您选择完成连接。

流程

  1. Add to Integration 页面中,点您要添加 Kafka 连接的加号。如果要添加简单的集成完成连接,请跳过这一步。
  2. 点击您要用来发布消息的 Kafka 连接。
  3. Choose an action 页面上,选择 Publish
  4. 在主题名称字段中,单击向下车键以显示主题列表,然后单击您要发布到的主题。
  5. Next 指定操作的输入类型。
  6. Select Type 字段中,如果不需要知道数据类型,则接受 类型规格, 然后点 Next。您不需要遵循这些指令的其余部分。

    但是,建议使用结构化的数据类型。例如,如果要在数据映射映射映射器步骤中的连接输入,您必须指定数据类型。数据映射器无法显示非结构化数据的字段。

    要指定数据类型,点 Select Type 字段,并选择以下之一作为 schema 类型:

    • JSON 模式是 描述 JSON 数据结构的文档。文档的介质类型是 application/schema+json
    • JSON 实例 是包含 JSON 数据的文档。文档的介质类型是 application/json
    • XML 模式 是一个描述 XML 数据结构的文档。文档的文件扩展为 .xsd
    • XML 实例 是包含 XML 数据的文档。文档的文件扩展为 .xml
  7. Definition 输入框中,粘贴符合您选择的 schema 类型的定义。例如,如果您选择 JSON 模式,您将粘贴 JSON 模式文件的内容,该文件的介质类型为 application/schema+json
  8. Data Type Name 字段中输入您为数据类型选择的名称。例如,如果您要为供应商指定 JSON 模式,您可以指定 Vendor 作为数据类型名称。

    在创建或编辑使用指定此类型的连接时,您将看到此数据类型名称。Fuse Online 在集成视觉化和数据映射程序中显示类型名称。

  9. Data Type Description 字段中,提供可帮助您区分此类型的信息。当您将鼠标悬停在处理此类型的步骤上时,此描述会出现在数据映射程序中。
  10. 点击 Next

结果

连接会出现在您添加它的集成视觉化中。

第 15 章 连接到 Knative 资源

您可以创建以下任意一个简单集成:

  • 连接到 Knative 频道以获取或发送消息
  • 将集成公开为 Knative 服务
  • 调用 Knative 服务
重要

连接到 Knative 资源只是一个技术预览功能。技术预览功能不受红帽产品服务等级协议(SLA)支持,且功能可能并不完整。红帽不推荐在生产环境中使用它们。这些技术预览功能可以使用户提早试用新的功能,并有机会在开发阶段提供反馈意见。有关红帽技术预览功能支持范围的详情,请参考 https://access.redhat.com/support/offerings/techpreview/

Exchanged 消息可以是任何格式,但消息通常采用 JSON 格式。

例如,简单的集成可能会定期针对新的销售线索轮询 Salesforce。当 Salesforce 连接找到新线索时,它可以向 Knative 频道发送包含详情的消息。多个简单集成可以从同一 Knative 频道获取信息。每个集成都可以对领导数据执行不同的操作。

详情请查看以下主题:

15.1. 启用到 Knative 资源的连接

您必须将 Knative 连接添加到简单集成前,您必须启用 Knative 连接。

安装 Fuse Online 时,可能会启用 Knative 连接。要检查这一点,请查看 syndesis 自定义资源的内容。如果 camelkknative 附加组件指定了 enabled: true,则代表启用了 Knative 连接。

先决条件

  • oc 客户端工具已安装并连接到运行 Fuse Online 的 OCP 集群。
  • Fuse Online 在客户管理的环境中的 OpenShift Container Platform 现场运行。
  • Fuse Online 运行时是 Camel K。
  • 在安装 Fuse Online 的集群中,也会安装您希望集成的每个 Knative 资源。在安装 Knative 资源前,您必须安装 OpenShift Serverless OperatorKnative Eventing Operator
  • 您有安装 Fuse 在线的权限。

流程

  1. 使用有权安装 Fuse Online 的帐户登录到 OpenShift。例如:

    $ oc login -u developer -p developer
  2. 切换到运行 Fuse Online 的项目,例如:

    $ oc project my-integration-project
  3. 编辑 syndesis 自定义资源:

    1. 调用以下命令,这通常会在编辑器中打开资源:

      oc edit syndesis
    2. 更新资源以指定以下内容:

      spec:
        addons:
           camelk:
             enabled: true
           knative:
             enabled: true
    3. 保存资源。

      将这一更改保存到复合自定义资源将触发 syndesis -operator (负责安装 Fuse Online)以重新部署 syndesis-server

      如果已经启用了 camelkknative,您可以关闭该文件。启用到 Knative 资源的连接。

结果

在 Fuse Online 控制台中,在 Connections 页面中,提供了 Knative 连接。您可以将相同的 Knative 连接添加到任意数量的简单集成。连接操作的配置,指定连接访问的 Knative 资源。

15.2. 订阅 Knative 频道以获取信息

要在收到 Knative 频道消息时触发集成执行,请将 Knative 连接添加为简单集成的启动连接。当没有从频道接收消息达到指定分钟数时,启动这种方法的集成会自动缩减到 0 个 pod。默认值为 1 分钟。

这种自动扩展会节省资源,与简单集成相比,它与其他类型的连接(如连接到 AMQ 代理)相比具有优势。

先决条件

  • 启用到 Knative 资源的连接。
  • 要从中获取消息的 Knative 资源与 Fuse Online 位于同一集群中
  • 您知道您要从中获取信息的 Knative 频道的名称。

流程

  1. 在 Fuse Online 的左侧面板中,单击 Integrations
  2. Create Integration
  3. Choose a connection 页面中,点 Knative 连接。
  4. 选择 Receive from Channel 操作。
  5. Channel name 字段显示可用 Knative 频道列表。
  6. 选择您要获取信息的资源的 Knative 频道名称。
  7. Next 指定 Receive from Channel 操作的输出类型。这是连接传递给集成中下一步的类型。

    1. Select Type 字段中,如果不需要知道数据类型,则接受 类型规格, 然后点 Next。您不需要遵循这些指令的其余部分。

      但是,建议使用结构化的数据类型。例如,如果要在数据映射映射映射器步骤中的连接输出,您必须指定数据类型。数据映射器无法显示非结构化数据的字段。

      要指定数据类型,点 Select Type 字段,并选择以下之一作为 schema 类型:

      • JSON 模式是 描述 JSON 数据结构的文档。文档的介质类型是 application/schema+json
      • JSON 实例 是包含 JSON 数据的文档。文档的介质类型是 application/json
      • XML 模式 是一个描述 XML 数据结构的文档。文档的文件扩展为 .xsd
      • XML 实例 是包含 XML 数据的文档。文档的文件扩展为 .xml
    2. Definition 输入框中,粘贴符合您选择的 schema 类型的定义。例如,如果您选择 JSON 模式,您将粘贴 JSON 模式文件的内容,该文件的介质类型为 application/schema+json
    3. Data Type Name 字段中输入您为数据类型选择的名称。例如,如果您要为供应商指定 JSON 模式,您可以指定 Vendor 作为数据类型名称。

      在创建或编辑使用指定此类型的连接时,您将看到此数据类型名称。Fuse Online 在集成视觉化和数据映射程序中显示类型名称。

    4. Data Type Description 字段中,提供可帮助您区分此类型的信息。当您将鼠标悬停在处理此类型的步骤上时,此描述会出现在数据映射程序中。
    5. 点击 Next

结果

Fuse Online 会提示您添加简单集成的完成连接。

在执行过程中,当所选 Knative 频道收到新消息时,Knative 连接会将信息传递给集成中的下一步,

后续步骤

将所有需要的连接添加到集成。然后,在启动集成的 Knative 连接后添加数据映射程序步骤。将 source message 字段映射到下一个连接中的 target 字段。

15.3. 将信息发送到 Knative 频道

在简单的集成中,Knative 连接可在流中向 Knative 频道发送一条信息,或者完成简单的集成。要做到这一点,在流的中间或一个简单的集成完成连接中添加 Knative 连接。

先决条件

  • 启用 Knative 连接。
  • 要将信息发送到的 Knative 资源会在与 Fuse Online 相同的集群中安装。
  • 您知道希望连接将信息发送到的 Knative 频道的名称。
  • 您正在创建或编辑流,Fuse Online 会提示您添加到集成。或者,Fuse Online 正在提示您选择完成连接。

流程

  1. Add to Integration 页面上,单击您要添加连接的加号。如果 Fuse Online 正在提示您选择完成连接,请跳过这一步。
  2. Choose a connection 页面中,点 Knative 连接。
  3. 选择 Send to Channel 操作。
  4. Channel name 字段显示运行 Fuse Online 的集群中的 Knative 频道列表。
  5. 选择您要集成以将信息发送到的频道。
  6. Next 指定 Send to Channel 操作的输入类型。这是集成发送到 Knative 频道的类型。

    1. Select Type 字段中,如果不需要知道数据类型,或者上一个集成步骤的输出是预期的类型,则接受 所需的 Type 规格 并点 Next。您不需要遵循这些指令的其余部分。

      但是,建议使用结构化的数据类型。例如,如果要在数据映射映射映射器步骤中的连接输入,您必须指定数据类型。数据映射器无法显示非结构化数据的字段。

      要指定数据类型,点 Select Type 字段,并选择以下之一作为 schema 类型:

      • JSON 模式是 描述 JSON 数据结构的文档。文档的介质类型是 application/schema+json
      • JSON 实例 是包含 JSON 数据的文档。文档的介质类型是 application/json
      • XML 模式 是一个描述 XML 数据结构的文档。文档的文件扩展为 .xsd
      • XML 实例 是包含 XML 数据的文档。文档的文件扩展为 .xml
    2. Definition 输入框中,粘贴符合您选择的 schema 类型的定义。例如,如果您选择 JSON 模式,您将粘贴 JSON 模式文件的内容,该文件的介质类型为 application/schema+json
    3. Data Type Name 字段中输入您为数据类型选择的名称。例如,如果您要为供应商指定 JSON 模式,您可以指定 Vendor 作为数据类型名称。

      在创建或编辑使用指定此类型的连接时,您将看到此数据类型名称。Fuse Online 在集成视觉化和数据映射程序中显示类型名称。

    4. Data Type Description 字段中,提供可帮助您区分此类型的信息。当您将鼠标悬停在处理此类型的步骤上时,此描述会出现在数据映射程序中。
    5. 点击 Next

结果

在集成视觉化中,连接会出现在您添加它的地方。在执行过程中,此连接会向所选 Knative 频道发送消息。

后续步骤

将所有需要的连接添加到集成。然后,在将信息发送到 Knative 频道的 Knative 连接前添加数据映射程序步骤。将 source 字段映射到 Knative connection target message 字段。

15.4. 公开简单的集成作为 Knative 服务

在简单集成中,启动连接可以是 Knative 连接,它将集成作为 Knative 服务公开。当没有对服务调用指定分钟的调用时,启动的方式启动集成会自动缩减到 0 个 pod。默认值为 1 分钟。

这种自动扩展会节省资源,与简单集成相比,它与其他类型的连接(如连接到 AMQ 代理)相比具有优势。

先决条件

  • 启用到 Knative 资源的连接。
  • Knative 安装在同一集群中,Fuse Online 正在运行。

流程

  1. 在 Fuse Online 的左侧面板中,单击 Integrations
  2. Create Integration
  3. Choose a connection 页面中,点 Knative 连接。
  4. 选择 Expose as Service 操作。

结果

Fuse Online 会提示您添加简单集成的完成连接。

当 Fuse Online 发布集成时,Camel K 运行时会创建一个 Knative service.knative.dev 服务。此服务:

  • 是 Kubernetes 部署对象的替代方案
  • 可以在没有活动期后自动缩放到 0
  • 不应与 Kubernetes 服务混淆

出版物使集成可以在 root 路径(/)中调用。客户端可以通过将其作为 HTTP 端点调用并根据需要传递数据来调用集成执行。通常,传递的数据采用 JSON 格式。

在这个发行版本中,预期将集成公开为 Knative 服务的主要用途是其他 Fuse 在线集成调用该服务。在这种情况下,调用服务的集成选择服务名称,不需要指定路径。

15.5. 从简单集成调用 Knative 服务

在简单的集成中,Knative 连接可以在集成中调用 Knative 服务,或者完成集成。要做到这一点,在流的中间或一个简单的集成完成连接中添加 Knative 连接。

先决条件

  • 启用 Knative 连接。
  • 您知道您要调用的 Knative 服务名称。该服务与 Fuse Online 在同一集群中运行。
  • 您正在创建或编辑流,Fuse Online 会提示您添加到集成。或者,Fuse Online 正在提示您选择完成连接。

流程

  1. Add to Integration 页面上,单击您要添加连接的加号。如果 Fuse Online 正在提示您选择完成连接,请跳过这一步。
  2. Choose a connection 页面中,点 Knative 连接。
  3. 选择 Call Service 操作。
  4. Service name 字段显示运行 Fuse Online 的集群中的 Knative 服务列表。
  5. 选择您要调用集成的服务。

    如果您公开了集成为 Knative 服务,并且这是您要调用的服务,则服务的名称与集成名称类似。

  6. Next 指定 Call Service 操作的输入类型。这是集成发送到 Knative 服务的类型。

    1. Select Type 字段中,如果不需要知道数据类型,或者上一个集成步骤的输出是预期的类型,则接受 所需的 Type 规格 并点 Next。您不需要遵循这个指令子集。

      建议使用结构化数据类型。例如,如果要在数据映射映射映射器步骤中的连接输入,您必须指定数据类型。数据映射器无法显示非结构化数据的字段。

      要指定数据类型,点 Select Type 字段,并选择以下之一作为 schema 类型:

      • JSON 模式是 描述 JSON 数据结构的文档。文档的介质类型是 application/schema+json
      • JSON 实例 是包含 JSON 数据的文档。文档的介质类型是 application/json
      • XML 模式 是一个描述 XML 数据结构的文档。文档的文件扩展为 .xsd
      • XML 实例 是包含 XML 数据的文档。文档的文件扩展为 .xml
    2. Definition 输入框中,粘贴符合您选择的 schema 类型的定义。例如,如果您选择 JSON 模式,您将粘贴 JSON 模式文件的内容,该文件的介质类型为 application/schema+json
    3. Data Type Name 字段中输入您为数据类型选择的名称。例如,如果您要为供应商指定 JSON 模式,您可以指定 Vendor 作为数据类型名称。

      在创建或编辑使用指定此类型的连接时,您将看到此数据类型名称。Fuse Online 在集成视觉化和数据映射程序中显示类型名称。

    4. Data Type Description 字段中,提供可帮助您区分此类型的信息。当您将鼠标悬停在处理此类型的步骤上时,此描述会出现在数据映射程序中。
    5. 点击 Next
  7. 指定 Call Service 操作的输出类型。

    这是当 Knative 连接是中间连接时 Knative 服务返回到集成的类型。

    重复前面的指令子集,以指定输出类型。或者,如果 Knative 服务响应为空,则接受 不需要的类型规格

  8. Next 添加连接。

结果

在集成视觉化中,连接会出现在您添加它的地方。

在执行过程中,这个连接会调用指定的 Knative 服务。调用包括之前集成步骤的输出(此 Knative 连接前的步骤)。如果此 Knative 连接是一个中间连接,连接会将服务输出传递给集成中的下一步。

后续步骤

将任何其他需要的连接添加到集成。如果指定了 input 和/或输出类型,请根据需要在 Knative 连接和映射字段前和/或后添加数据映射程序步骤。

第 16 章 连接到 Apache Kudu

Apache Kudu 是为 Apache Hadoop 平台开发的列示存储管理器。Fuse Online 集成可以连接到 Kudu 数据存储来扫描表,它会将表中的所有记录返回到集成,或者将记录插入到表中。详情包括在以下主题中:

16.1. 创建到 Apache Kudu 数据存储的连接

在集成中,若要从记录获取或插入 Kudu 表中的记录,请创建一个到 Kudu master 主机的连接,然后将该连接添加到集成。

前提条件

  • 您必须知道您要连接的 Kudu master 主机的 IP 地址或主机名。
  • 您必须知道 Kudu 正在侦听的端口。

流程

  1. 在 Fuse Online 中,在左侧面板中,单击 Connections 以显示任何可用连接。
  2. 在右上角,单击 Create Connection 以显示连接器。
  3. Apache Kudu 连接器。
  4. 配置连接:

    1. Kudu master 主机地址 中,输入 Kudu master 主机的主机名或 IP 地址。
    2. Port to establish connection to field 中,输入 Kudu 正在侦听的端口。默认值为 7051
  5. 点击 Next
  6. Name 字段中输入您选择的名称,可帮助您将这个连接与任何其他连接区分开来。例如,您可以输入 Kudu North
  7. Description 字段中,输入有助于了解此连接的任何信息。
  8. Save 查看您创建的连接现在可用。如果您输入了示例名称,您会看到 Kudu North 显示为可以添加到集成的连接。

16.2. 当扫描从 Kudu 表中返回记录时触发集成

要在从 Kudu 表中获取数据时触发集成执行,请在启动连接时向简单集成添加 Kudu 连接。当集成运行时,Kudu 连接会扫描您在指定间隔中指定的表,获取表中的所有记录,并将记录的集合传递给集成中的下一步。

Kudu 连接只能从一个表中获取数据。在扫描之间,如果连接扫描表中没有更改数据,则下一次扫描会返回与之前扫描相同的数据。

前提条件

  • 您创建了 Kudu 连接。
  • 要从中获取记录的表已存在。

流程

  1. 在左侧的 Fuse Online 面板中,单击 Integrations
  2. Create Integration
  3. Choose a connection 页面上,单击您要用来启动集成的 Kudu 连接。
  4. Choose an action 页面上,选择 Scan a Kudu 表 操作。
  5. Table 字段中,输入您要从中获取记录的表名称。
  6. Period 字段中,接受默认的一分钟,或者输入您希望连接扫描表的时间间隔,并返回表中的记录。
  7. 点击 Next

结果

连接是简单集成的启动连接。

后续步骤

添加集成的完成连接以及您要包含在集成中的任何其他连接。当集成包含所需的所有连接时,请考虑是否需要分割 Kudu 连接返回的记录集合。如果要为从 Kudu 表中获取的每个记录执行集成步骤,请在 Kudu 连接后添加分割步骤。另外,您可能还需要遵循 Kudu 连接与数据映射步骤,该步骤将从 Kudu 获取的数据映射到集成中的后续连接中的字段。

16.3. 将记录插入到 Kudu 表中

在集成中,您可以在流中间的 Kudu 表中添加记录,或完成简单的集成。为此,请将 Kudu 连接添加到流中间或作为简单集成结束连接。

先决条件

  • 您创建了 Kudu 连接。
  • 您正在创建或编辑集成,Fuse Online 会提示您添加到集成。或者,Fuse Online 正在提示您选择完成连接。
  • 您要添加记录的表存在。

流程

  1. Add to Integration 页面上,单击您要添加连接的加号。如果 Fuse Online 正在提示您选择完成连接,请跳过这一步。
  2. 点击您要使用的 Kudu 连接。请注意,当 Kudu 连接插入数据时,连接不会返回任何内容。
  3. Choose an action 页面上,选择 Insert data into a Kudu table
  4. 要配置操作,请在 Table 字段中指定要向其添加记录的表的名称。

    务必要了解您要在其中添加记录的 Kudu 表。例如,您要向 添加记录的 Kudu 表可能有一个唯一的密钥。如果您尝试添加包含已在表中的键值的记录,Kudu 连接不会添加该记录。

  5. 点击 Next

结果

连接会出现在您添加它的集成视觉化中。

后续步骤

考虑您是否需要将一组记录分成 Kudu 连接可以添加到表中的单个记录。为此,请在集成中添加拆分步骤。split 步骤对每个记录执行集成一次后续步骤。另外,您可能需要在向表添加记录的 Kudu 连接前进行数据映射程序步骤。

第 17 章 连接到 MongoDB

MongoDB 是一个分布式 NoSQL 数据库。Fuse Online 集成可以从 MongoDB 数据库获取内容或更新 MongoDB 数据库中的内容。要做到这一点,创建一个 MongoDB 连接,并将其添加到集成中。

连接到 MongoDB 数据库的详情位于以下主题:

17.1. 创建到 MongoDB 数据库的连接

创建一个 MongoDB 连接,以便您可以连接到集成中的 MongoDB 数据库。

先决条件

  • 您必须知道您要连接的 MongoDB 数据库的主机名。
  • 您必须有一个用户名和密码来授权对 MongoDB 数据库的访问。

流程

  1. 在 Fuse Online 中,在左侧面板中,单击 Connections 以显示任何可用连接。
  2. 在右上角,单击 Create Connection 以显示连接器。
  3. MongoDB 连接器。
  4. 配置连接:

    1. Database host (s) 字段中,指定此连接可访问的一个或多个 MongoDB 数据库主机。使用逗号分隔 host:port 的多个规格。使用主机名、虚拟主机名或 IP 地址替换 host。例如: mongodb0.example.com:1234,mongodb1.example.com:1234
    2. Username 字段中输入有权访问数据库的用户名。
    3. Password 字段中,输入您指定的用户名的密码。
    4. 可选的。在 Administration 数据库 字段中,如果数据库具有管理数据库,请输入用于授予访问权限的 MongoDB 管理数据库的名称。MongoDB 管理员应让您知道您要访问的数据库是否具有管理数据库。
    5. 可选的。在 Replica set name 字段中,指定连接可访问的 MongoDB 副本集(cluster)的名称。
    6. Database 字段中,输入 MongoDB 数据库的名称,其中包含您希望连接读取的集合。
  5. 单击 Validate。Fuse Online 立即尝试验证连接并显示一条消息,指示验证是否成功。如果验证失败,请重新发送输入参数并重试。
  6. 验证成功后,单击 Next
  7. Name 字段中输入您选择的名称,可帮助您将这个连接与任何其他连接区分开来。例如,您可以输入 MongoDB North
  8. Description 字段中,输入有助于了解此连接的任何信息。
  9. Save 查看您创建的连接现在可用。如果您输入了示例名称,您会看到 MongoDB North 显示为一个连接,您可以选择添加到集成。

后续步骤

将您的 MongoDB 连接添加到集成。

17.2. 更新 MongoDB 集合时触发集成

要在将文档添加到 MongoDB 集合中时触发集成执行,请在启动连接时将 MongoDB 连接添加到简单集成。当集成运行时,MongoDB 连接会监控您在创建集成时指定的数据库集合。将新文档插入到连接的集合中,以监控集成的触发器执行。MongoDB 连接会将新文档返回到集成,此数据可用于集成中的下一步。

先决条件

  • 您创建了 MongoDB 连接。
  • 您知道您要读取连接的 MongoDB 集合的名称。
  • 如果您希望连接监控的集合是一个 capped 集合,则还必须知道:

    • 跟踪传入文档的 MongoDB 集合字段的名称。
    • 是否为包含集合的数据库启用持久性跟踪。
    • 如何指定与希望连接读取的数据相关的尾部跟踪信息。MongoDB 连接可以使用尾部跟踪信息在意外连接终止后恢复操作。tail 跟踪可确保当连接恢复其活动时,它不会将重复数据返回到集成,也不会丢弃需要返回到集成的任何数据。

流程

  1. 在左侧的 Fuse Online 面板中,单击 Integrations
  2. Create Integration
  3. Choose a connection 页面上,点 MongoDB 连接,该连接配置为访问您希望集成从中获取更新的数据库。
  4. Choose an action 页面中,选择这些操作之一:

    • 检索文档(stream) 通常是要选择的操作。它从非捕获的集合检索数据。
    • 检索文档(tail) 是从大写的集合中检索数据的操作。
  5. 配置操作:

    1. Collection name 字段中,输入您希望连接读取的 MongoDB 集合的名称。

      如果您要配置 Retrieve 文档(stream) 操作,这是唯一需要的参数。进入第 6 步。如果您要配置 Retrieve 文档(tail) 操作,请按照剩余的子步骤操作。

    2. 用于跟踪传入文档字段的 Collection 字段中,输入相关 MongoDB 集合字段的名称。此字段包含可以排序的数据,如日期或 ID。
    3. 如果为您希望连接要读取的数据库启用了持久性跟踪,请选择 Persistent tracking enabled
    4. 可选的。在 唯一 id 中,用于识别此跟踪进程 字段,如果有多个消费者用于监控同一集合,则指定唯一的 ID。如需更多信息,请参阅 Camel 文档 Tailable Cursor Consumer
    5. 可选的。在 用于存储 tail tracking 字段的 DB 中,输入包含尾部跟踪信息的 MongoDB 数据库的名称。
    6. 可选的。在 用来存储 tail tracking 字段的 Collection 中,输入包含尾部跟踪信息的集合名称。
    7. 可选的。在 用来存储 tail tracking 字段的字段中,输入存储此连接正在读取的集合的尾部跟踪信息的字段名称

    要识别 tail 跟踪字段,您可以指定 tail 跟踪数据库或尾部跟踪集合。使用这些信息之一,连接可以找到 tail 跟踪字段。

  6. Next 指定操作的输出类型。
  7. Select Type 字段中,如果不需要知道数据类型,则接受 类型规格, 然后点 Next。您不需要遵循这些指令的其余部分。

    但是,建议使用结构化的数据类型。例如,如果要在数据映射映射映射器步骤中的连接输出,您必须指定数据类型。数据映射器无法显示非结构化数据的字段。

    要指定数据类型,点 Select Type 字段,并选择以下之一作为 schema 类型:

    • JSON 模式是 描述 JSON 数据结构的文档。文档的介质类型是 application/schema+json
    • JSON 实例 是包含 JSON 数据的文档。文档的介质类型是 application/json
    • XML 模式 是一个描述 XML 数据结构的文档。文档的文件扩展为 .xsd
    • XML 实例 是包含 XML 数据的文档。文档的文件扩展为 .xml
  8. Definition 输入框中,粘贴符合您选择的 schema 类型的定义。例如,如果您选择 JSON 模式,您将粘贴 JSON 模式文件的内容,该文件的介质类型为 application/schema+json
  9. Data Type Name 字段中输入您为数据类型选择的名称。例如,如果您要为供应商指定 JSON 模式,您可以指定 Vendor 作为数据类型名称。

    在创建或编辑使用指定此类型的连接时,您将看到此数据类型名称。Fuse Online 在集成视觉化和数据映射程序中显示类型名称。

  10. Data Type Description 字段中,提供可帮助您区分此类型的信息。当您将鼠标悬停在处理此类型的步骤上时,此描述会出现在数据映射程序中。
  11. 点击 Next

结果

集成现在有一个启动连接,Fuse Online 会提示您选择完成连接。

在执行过程中,连接会返回 JSON 格式的插入文档。

17.3. 对 MongoDB 集合中的文档操作

在集成中,您可以搜索、更新、删除、计数或向 MongoDB 集合添加文档。要做到这一点,在流的中间或简单集成完成连接中添加 MongoDB 连接。

先决条件

  • 您创建了 MongoDB 连接。
  • 您知道您希望连接操作的 MongoDB 集合的名称。
  • 您正在创建或编辑集成,Fuse Online 会提示您添加到集成。或者,Fuse Online 正在提示您选择完成连接。

流程

  1. Add to Integration 页面中,点您要添加 MongoDB 连接的加号。如果要添加简单的集成完成连接,请跳过这一步。
  2. 点击您要使用的 MongoDB 连接。
  3. Choose an action 页面中,选择您要连接执行的操作。
  4. 要配置操作,在 Collection name 字段中输入您要连接操作的集合名称。

    如果您选择了 Insert 操作:

    • 您已配置连接。
    • 确保集成传递给此 MongoDB 连接的数据包含 JSON 表示法,用于指定要添加到集合中的文档。
    • Next 将这个连接添加到集成。
  5. 对于所有其他操作,下表提供有关在第二个字段中配置该操作的信息。

    第二个字段是一个 JSON 表示法表达式,用于标识要操作的文档以及可能的操作详情。如果您计划将传入的 source 字段映射到表达式中的标识符,请在表达式中指定 :#variable-name

    为了完全起见,此表中也会描述 Insert 操作。

    操作它的作用参数字段返回

    数量

    计算满足您指定的计数表达式的文档数量。

    Count expression 字段中,以 {"test":"unit"} 的形式指定一个 JSON 过滤器表达式。该操作将计算具有 test 属性值的文档 数量

    java.lang.Long 实例,用于指定找到的文档数量。

    删除

    从集合中删除一个或多个文档。

    Delete expression 字段中,以 {"test":"unit"} 的形式指定一个 JSON 表达式。该操作将删除其 test 属性的值为 单元 的每个文档。

    java.lang.Long 实例,用于指定已删除的文档数量。

    查找

    查找与您指定的过滤器表达式匹配的所有文档。

    Filter expression 字段中,指定一个 JSON 表示法字符串来标识一个或多个文档。

    指定列表(数组)的 JSON 表示法。每个 list 元素标识了与过滤器表达式匹配的文档并提供文档内容。如果没有找到文档,则操作会返回一个空列表。

    您必须熟悉集合的数据模型。如果集合遵循 JSON 模式,您必须熟悉此模式,因为返回的列表元素遵循这个模式。如需更多信息,请参阅 MongoDB Data Models

    要在后续数据映射程序步骤中使用 Find 操作的输出数据,集合必须遵循 JSON 模式。这可让数据映射器显示数据字段。如需更多信息,请参阅 MongoDB 文档了解 JSON 模式验证

    insert

    在集合中添加一个或多个文档。

    没有可用于插入文档的操作配置参数。进到 MongoDB 连接的数据必须包含 JSON 表示法,用于指定要添加到集合的一个或多个文档。

    指定列表(数组)的 JSON 表示法。每个 list 元素都是插入此操作的文档。

    Update(更新)

    更新集合中的一个或多个文档。

    Filter 条件 字段中,指定 2 个参数的数组。第一个参数是一个过滤器表达式,用于标识要更新的文档。第二个参数是 MongoDB update 语句,指定如何更新文档。更新语句格式在 https://docs.mongodb.com/manual/reference/method/db.collection.update/ 中进行了描述。例如: [{"_id":11},{$set: {"test":"updated!"}}].

    java.lang.Long 实例,用于指定更新的文档数量。

    UPSERT

    更新集合中的一个或多个文档,如果没有与 Upsert 表达式匹配,则创建文档。

    Upsert 表达式 字段中,指定用于标识一个或多个文档的 JSON 表示法。该操作将使用此表达式来检测任何匹配的文档。如果操作在集合中找到匹配的文档,它会更新它。如果操作找不到匹配的文档,则操作将创建一个新文档。进入 MongoDB 连接的数据必须包含 JSON 表示法,该表示法指定:

    * 一个 _id 字段来识别它是插入还是更新操作。

    * 要添加或更新的内容。

    com.mongodb.client.result.UpdateResult 实例,用于指定更新文档的数量或新插入文档的 ID。

    每个操作都会返回一个响应。如果这是完成连接,则响应将会丢失,但您可以添加 日志 步骤来捕获响应。

  6. 点击 Next
  7. 可选的。如果这是完成连接,请添加 Log 步骤来完成集成。配置日志 步骤 以捕获响应。

结果

连接会出现在您添加它的集成视觉化中。

后续步骤

将任何其他需要的连接添加到流中。添加处理数据的任何其他步骤。通过添加任何所需的数据映射步骤来完成集成。当您配置 MongoDB 连接操作时,如果您在操作表达式中指定了任何 :#variable-name 标识符,请确保将 source 字段映射到 MongoDB connection 变量字段。

第 18 章 连接到 MQTT

MQ Telemetry Transport (MQTT)是一个轻量级、机器到机器、连接协议的互联网。在集成中,您可以从 MQTT 代理获取信息或发布消息。为此,请创建一个到感兴趣的 MQTT 代理的连接,然后将该连接添加到集成流中。详情包括在以下主题中:

18.1. 创建到 MQTT 代理的连接

在集成中,若要从 MQTT 代理获取消息或发布消息,请创建一个到感兴趣的 MQTT 代理的连接,然后将该连接添加到集成。

前提条件

您必须知道您要连接的 MQTT 代理的 URL。

流程

  1. 在 Fuse Online 中,在左侧面板中,单击 Connections 以显示任何可用连接。
  2. 在右上角,单击 Create Connection 以显示连接器。
  3. MQTT Message Broker 连接器。
  4. 配置连接:

    1. MQTT broker URL 字段中,输入您要向或获取数据的 MQTT 代理的位置。这是唯一必填字段。
    2. User Name 字段中,选择输入您要用于访问代理的 MQTT 帐户的用户名。
    3. Password 字段中,如果您指定了用户名,则指定与该帐户关联的密码。
    4. Client ID 字段中,选择输入 ID,允许连接关闭并重新打开,而不缺少信息。连接必须订阅或发布到一个主题。
  5. 单击 Validate。Fuse Online 立即尝试验证连接并显示一条消息,指示验证是否成功。如果验证失败,请重新发布输入参数并重试。
  6. 如果验证成功,请单击 Next
  7. Name 字段中输入您选择的名称,可帮助您将这个连接与任何其他连接区分开来。例如,您可以输入 MQTT West
  8. Description 字段中,输入有助于了解此连接的任何信息。
  9. Save 查看您创建的连接现在可用。如果您输入了示例名称,您会看到 MQTT West 显示为可以添加到集成的连接。

18.2. 从 MQTT 代理获取消息以触发集成执行

要根据 MQTT 代理收到消息来触发集成执行,请添加 MQTT 连接作为启动连接。当集成运行时,MQTT 连接会持续监控您指定的 MQTT 队列或主题上的消息。当连接找到消息时,它会将其传递给集成中的下一步。MQTT 连接一次处理一条消息。

前提条件

您创建了 MQTT 连接。

流程

  1. 在左侧的 Fuse Online 面板中,单击 Integrations
  2. Create Integration
  3. Choose a connection 页面上,单击您要用来启动集成的 MQTT 连接。
  4. Choose an action 页面上,选择 Subscribe 操作来接收来自您指定的队列或主题的消息。
  5. MQTT queue/topic name 字段中,输入要接收数据的队列或主题的名称。
  6. Next 指定操作的输出类型。
  7. Select Type 字段中,如果不需要知道数据类型,则接受 类型规格, 然后点 Next。您不需要遵循这些指令的其余部分。

    但是,建议使用结构化的数据类型。例如,如果要在数据映射映射映射器步骤中的连接输出,您必须指定数据类型。数据映射器无法显示非结构化数据的字段。

    要指定数据类型,点 Select Type 字段,并选择以下之一作为 schema 类型:

    • JSON 模式是 描述 JSON 数据结构的文档。文档的介质类型是 application/schema+json
    • JSON 实例 是包含 JSON 数据的文档。文档的介质类型是 application/json
    • XML 模式 是一个描述 XML 数据结构的文档。文档的文件扩展为 .xsd
    • XML 实例 是包含 XML 数据的文档。文档的文件扩展为 .xml
  8. Definition 输入框中,粘贴符合您选择的 schema 类型的定义。例如,如果您选择 JSON 模式,您将粘贴 JSON 模式文件的内容,该文件的介质类型为 application/schema+json
  9. Data Type Name 字段中输入您为数据类型选择的名称。例如,如果您要为供应商指定 JSON 模式,您可以指定 Vendor 作为数据类型名称。

    在创建或编辑使用指定此类型的连接时,您将看到此数据类型名称。Fuse Online 在集成视觉化和数据映射程序中显示类型名称。

  10. Data Type Description 字段中,提供可帮助您区分此类型的信息。当您将鼠标悬停在处理此类型的步骤上时,此描述会出现在数据映射程序中。
  11. 点击 Next

结果

集成现在有一个启动连接,Fuse Online 会提示您选择完成连接。

18.3. 向 MQTT 代理发布消息

在集成中,您可以在流中发布消息到 MQTT 代理,或者完成简单的集成。为此,请在流的中间或集成完成连接中添加 MQTT 连接。

先决条件

  • 您创建了 MQTT 连接。
  • 您正在创建或编辑流,Fuse Online 会提示您添加到集成。或者,Fuse Online 正在提示您选择完成连接。

流程

  1. Add to Integration 页面上,单击您要添加 MQTT 连接的加号。如果要添加简单的集成完成连接,请跳过这一步。
  2. 点您要用来发布消息的 MQTT 连接。
  3. Choose an action 页面上,选择 Publish
  4. MQTT queue/topic name 字段中,指定要发布消息的队列或主题的名称。
  5. Next 指定操作的输入类型。
  6. Select Type 字段中,如果不需要知道数据类型,则接受 类型规格, 然后点 Next。您不需要遵循这些指令的其余部分。

    但是,建议使用结构化的数据类型。例如,如果要在数据映射映射映射器步骤中的连接输入,您必须指定数据类型。数据映射器无法显示非结构化数据的字段。

    要指定数据类型,点 Select Type 字段,并选择以下之一作为 schema 类型:

    • JSON 模式是 描述 JSON 数据结构的文档。文档的介质类型是 application/schema+json
    • JSON 实例 是包含 JSON 数据的文档。文档的介质类型是 application/json
    • XML 模式 是一个描述 XML 数据结构的文档。文档的文件扩展为 .xsd
    • XML 实例 是包含 XML 数据的文档。文档的文件扩展为 .xml
  7. Definition 输入框中,粘贴符合您选择的 schema 类型的定义。例如,如果您选择 JSON 模式,您将粘贴 JSON 模式文件的内容,该文件的介质类型为 application/schema+json
  8. Data Type Name 字段中输入您为数据类型选择的名称。例如,如果您要为供应商指定 JSON 模式,您可以指定 Vendor 作为数据类型名称。

    在创建或编辑使用指定此类型的连接时,您将看到此数据类型名称。Fuse Online 在集成视觉化和数据映射程序中显示类型名称。

  9. Data Type Description 字段中,提供可帮助您区分此类型的信息。当您将鼠标悬停在处理此类型的步骤上时,此描述会出现在数据映射程序中。
  10. 点击 Next

结果

连接会出现在您添加它的集成视觉化中。

第 19 章 连接到 OData

开放数据协议(OData)是构建和使用 REST API 的标准。OData 服务通过 OData 兼容 HTTP 请求向客户端(如 Fuse Online)提供服务。Fuse Online 集成可从 OData 服务获取实体,并可更新、创建或删除由 OData 服务管理的实体。为此,创建一个 OData 连接,并将其添加到集成中。

假设您熟悉 OData 规格

连接到 OData 服务的详情位于以下主题:

19.1. 创建与 OData 服务的连接

在集成中,若要获取、更新、创建或删除由 OData 服务管理的实体,您必须首先创建与该 OData 服务的连接。

先决条件

  • 您必须知道您要连接的 OData 服务的基本 URL。
  • 如果该服务使用身份验证,则必须具有所需的凭证,如果需要,则 SSL 证书。但是,大多数 OData 服务都是公共的,不需要身份验证。

流程

  1. 在 Fuse Online 中,在左侧面板中,单击 Connections 以显示任何可用连接。
  2. 在右上角,单击 Create Connection 以显示连接器。
  3. OData 连接器。
  4. 配置连接:

    1. Service Root URL 字段中,输入您要访问的 OData 服务的基本 URL。
    2. User Name 字段中,如果服务使用基本身份验证,请输入您的用户名。
    3. Password 字段中,如果服务使用基本身份验证,请输入您的密码。
    4. Server Certificate 字段中,如果服务需要它,请粘贴 SSL 证书的内容。

      通常,除浏览器提供的证书外,公共 OData 服务不需要证书。但是,对于内部 OData 服务,您可能已创建了自己的 SSL 证书和自签名证书。由于此证书不被证书颁发机构信任,所以到您的 OData 服务的连接将失败。要启用连接,请在此处粘贴自签名证书。

      获取证书的一种方法是在浏览器中加载服务。这之后的步骤取决于您正在使用的浏览器,但是它将类似于以下内容:单击地址栏旁边的 Not secure padlock 符号,然后单击 View Certificate,将显示的证书导出到文件中,复制证书,并将它粘贴到此字段中。

  5. 单击 Validate。Fuse Online 立即尝试验证连接并显示一条消息,指示验证是否成功。如果验证失败,请重新发送输入参数并重试。
  6. 验证成功后,单击 Next
  7. Name 字段中输入您选择的名称,可帮助您将这个连接与任何其他连接区分开来。例如,您可以输入 OData North
  8. Description 字段中,输入有助于了解此连接的任何信息。
  9. Save 查看您创建的连接现在可用。如果您输入了示例名称,您会看到 OData North 显示为一个连接,您可以选择添加到集成。

后续步骤

将 OData 连接添加到集成。

19.2. 在轮询从 OData 服务返回数据时触发集成

要在从 OData 服务获取数据时触发集成执行,请在启动连接时将 OData 连接添加到简单集成。当集成运行时,OData 连接会按您指定的间隔轮询服务。当连接找到满足连接配置的数据时,连接会将数据传递给集成中的下一步。

前提条件

您创建了 OData 连接。

流程

  1. 在左侧的 Fuse Online 面板中,单击 Integrations
  2. Create Integration
  3. Choose a connection 页面上,单击您要用来启动集成的 OData 连接。
  4. Choose an action 页面上,选择 Read action。
  5. 配置 Read 操作:

    1. Resource Collection 字段中,选择要查询的 OData 资源的名称。Fuse Online 从 OData 服务获取数据,以提供可用资源集合的列表。
    2. Entity Key Predicate 字段中,若要获取特定的实体,请通过指定其 key predicate 来识别您想要的实体。例如,指定诸如 UserName='Bob'Categories (1) 的内容。要获取多个实体,请将此字段留空。
    3. Query Options 字段中,输入您要应用到资源的查询。使用 OData 语法。例如,$filter=startswith (name, 'N') 返回资源中的每个实体的消息,其名称 字段以 N 开头。

      您可以指定 Entity Key PredicateQuery Options。如果您这样做,OData 服务会获取指定的实体,并将查询应用到该实体。例如,假设您将 Entity Key Predicate 设置为 UserName='russellwhyte'/Emails,并将 Query Options 设置为 $filter=contains ($it,'example')。连接会创建一个类似如下的请求:

      https://services.odata.org/TripPinRESTierService/People(UserName='russellwhyte')/Emails?$filter=contains($it, 'example')

      该服务返回包含域 示例 的 Russell 为什么的所有电子邮件地址。

    4. 选中 Filter Old Results 复选框,以只获取特定消息一次。
    5. 如果您希望连接返回单个消息而不是一组信息,请选择 Split Results 复选框。

      Fuse Online 还提供离散分割和聚合步骤,您可将它们添加到流中。如果要在一个或多个步骤中处理单个消息,然后将消息聚合到一个集合中,请不要选择 Split Results 复选框。相反,将复选框留空,然后在此连接后向流添加分割步骤。如果您希望流中的聚合步骤,则需要分割步骤。

    6. Interval Before Polling Starts 字段中,接受默认值 1 秒,或者输入连接开始轮询 OData 服务前要经过的时间长度。
    7. Delay 字段中,接受默认值 30 秒,或者输入您希望连接轮询 OData 服务的时间间隔。
    8. Backoff Idle Threshold 字段中,接受默认值 1 或输入整数,表示无法返回任何数据的连续轮询数量。在这个轮询数后,连接会增加后续轮询之间的间隔。连接通过将 Delay 值乘以 Backoff Multiplier 值来指定轮询间隔的新长度。

      例如,假设轮询间隔( Delay 值)是默认值 30 秒,backoff Idle Threshold 设置为 5,并且 Backoff Multiplier 设置为 12。5 连续轮询返回任何数据后,连接会在再次轮询前等待 360 秒(30 x 12)。连接会每 360 秒轮询一次,直到轮询返回数据为止。在轮询返回数据后,连接每 30 秒恢复轮询。

    9. Backoff Multiplier 字段中,接受默认值 1 或输入整数,表示在达到 Backoff Idle Threshold 的值时增加轮询间隔的倍数。

      如果您接受 backoff Multiplier 的默认值 1,那么无论连续的轮询没有结果,连接都会在指定间隔上继续轮询。

      Backoff Idle ThresholdBackoff Multiplier 指定的值可用于减少 CPU 开销,因为连接可以在静默期间自动轮询较少的。

  6. 点击 Next

结果

集成现在有一个启动连接,Fuse Online 会提示您选择完成连接。

在执行期间,连接返回的内容取决于您在 Entity Key PredicateQuery Options 字段中指定的内容。OData 连接可以返回:

  • 实体或实体属性集合

    例如,这可能是资源中的所有 Person 实体,也可能是所有 Person 实体的所有 期限 属性。连接会返回一个消息中的集合。Fuse Online 在集合一次执行一次流程中的后续步骤。但是,当您配置 Read 操作时,如果您选择 Split Results,则连接会返回每个实体或其自身消息中的每个属性。Fuse Online 为每个消息执行一次流中的后续步骤。

  • 实体或实体属性

    例如,这可能是其 UserName 属性为 Bob Person 实体,也可能是 UserName 为ob 实体的 Age 属性。连接返回消息中的 entity 或 entity 属性,该属性传递给流中的下一步。

后续步骤

添加集成的完成连接以及您要包含在集成中的任何其他连接。当集成包含所需的所有连接时,如果 OData 连接返回集合,请考虑是否需要在 OData 连接后添加分割步骤。集成通常需要将 OData 连接返回的数据映射到随后流中连接使用的字段。有时,您可以映射集合,但通常需要分割集合,才能映射到目标字段。

在 OData 连接后,向流中添加数据映射程序步骤。准确在流中的什么位置取决于您要进行的流。例如,在 OData 连接后,您可以添加基本过滤器步骤,然后添加数据映射程序步骤。

19.3. 更新、创建和删除由 OData 服务管理的数据

在集成中,您可以更新流中由 OData 服务管理的资源,或完成简单的集成。为此,请将 OData 连接添加到流中间或作为简单集成的完成连接。

先决条件

  • 您创建了 OData 连接。
  • 您正在创建或编辑集成,Fuse Online 会提示您添加到集成。或者,Fuse Online 正在提示您选择完成连接。

流程

  1. Add to Integration 页面上,单击您要添加 OData 连接的加号。如果要添加简单的集成完成连接,请跳过这一步。
  2. 点您要使用的 OData 连接。请注意,当 OData 连接更新或删除实体时,连接不会返回任何内容。当 OData 连接创建实体时,连接会返回新实体。
  3. Choose an action 页面中,选择您要连接执行的操作:

    • 创建 向 OData 资源添加实体。
    • 删除 从 OData 资源中删除实体。
    • 更新 更改 OData 资源中的实体。
  4. 通过选择要更新的 OData 资源来配置操作。

    务必要了解如何设置 OData 资源。OData 服务的后备数据源决定更新的规则并解决冲突。例如,假设 OData 连接尝试创建新实体,但该 predicate 密钥的实体已经存在。OData 服务可能会覆盖现有的实体,或者可能会更新现有实体中的一些字段,或者可能会忽略此操作。在这种情况下,您需要知道 OData 服务的行为方式。

  5. 点击 Next

结果

连接会出现在您添加它的集成视觉化中。

后续步骤

在 OData 连接前添加数据映射程序步骤。您必须映射提供创建新实体、更新实体或删除实体所需的数据的源字段。有关 下一个连接,请参阅将集成数据映射到字段

第 20 章 连接到 REST API

在集成中,要连接到 REST API,您必须上传描述 API 的 OpenAPI 文档来为该 API 创建连接器。请参阅 将应用程序与 Fuse 在线集成,添加和管理 REST API 客户端连接器

在 Fuse Online 中提供您要连接的 REST API 的连接器时,连接到该 REST API 的步骤包括:

20.1. 将 Fuse Online 注册为 REST API 客户端

在 Fuse Online 创建 REST API 客户端连接器之前,它会提示您指明 API 的安全要求。对于使用 OAuth 协议的 API,当 Fuse Online 创建连接器时,它还向 Fuse Online Settings 页面添加 API 条目。这是您提供 API 客户端 ID 和授权 Fuse Online 访问 API 客户端 secret 的位置。

如果您要连接的 API 不使用 OAuth,请跳过本节,请参阅创建 REST API 客户端连接

前提条件

您必须知道您要连接的 REST API 的 OAuth 自定义应用程序设置页面的 URL。

流程

  1. 在 Fuse Online 中:

    1. Settings 页面中,在回调 URL 右侧,点 Copy Callback URL 将 Fuse Online 环境的回调 URL 复制到剪贴板。此流程稍后您将需要此 URL。
    2. 查找您要连接的 API 的名称,并点击它来显示其客户端 ID 和客户端 secret 字段。
  2. 在另一个浏览器窗口中,您必须注册 Fuse Online 作为您要连接的 API 的 OAuth 客户端。执行此操作的确切步骤因每个 API 服务而异。通常,API 服务提供 OAuth 自定义应用设置页面。进入该页面并执行以下操作:

    1. 提供您在此流程开始时复制的 Fuse Online 回调 URL。
    2. 响应需要输入的任何其他提示。
    3. 获取 API 服务分配给 Fuse 在线环境的客户端 ID 和客户端 secret。
  3. 返回到您要注册的 API 服务的 Fuse Online Settings 页面条目,并执行以下操作:

    1. 粘贴分配的客户端 ID。
    2. 粘贴分配的客户端 secret。
    3. Save

20.2. 创建 REST API 客户端连接

在集成中,要连接到 REST API,请创建一个与该 REST API 的连接,然后添加到任意数量的集成中。

先决条件

  • 您为您要连接的 REST API 创建连接器。
  • 如果 REST API 使用 OAuth 协议,则您已将 Fuse Online 环境注册为可以访问该 REST API 的客户端应用。

流程

  1. 在 Fuse Online 中,在左侧面板中,单击 Connections 以显示任何可用连接。
  2. 在右上角,单击 Create Connection 以显示可用的连接器。
  3. 点您要为其创建连接的 API 的连接器。
  4. 响应,以提示输入其他信息。API 的定义决定了 Fuse 在线提示的内容。

    通常,API 服务具有安全要求,Fuse Online 根据 OpenAPI 文档定义的特定安全类型提示提供安全输入。安全类型可以是以下之一:

    安全类型

    Fuse Online 显示

    HTTP 基本身份验证

    用户名和密码的输入字段。

    OAuth 2.0

    单击此按钮,以便 Fuse Online 能够验证其连接 API 的注册凭证。这些凭证在创建连接器时提供。

    API 密钥

    API 密钥的 input 字段,您必须从 API 服务获取。

  5. Name 字段中输入您选择的名称,可帮助您将这个连接与任何其他连接区分开来。
  6. Description 字段中,输入有助于了解此连接的任何信息。
  7. Save 查看您现在可以选择您创建的连接并添加到集成。

20.3. 在集成中添加 API 客户端连接

在集成中,若要连接到 REST API,请添加连接到该 REST API 的步骤。

在本发行版本中,到 REST API 的连接可以是流中内的一个步骤,也可以是简单集成中的完成连接。换句话说,与 REST API 的连接不能是起始连接。

先决条件

  • 您创建了与 REST API 的连接。
  • 您正在创建或编辑流。
  • 流已具有其启动连接。
  • Fuse Online 正在提示您选择完成连接或添加到集成。

流程

  1. Add to Integration 页面上,单击您要添加连接的加号。如果 Fuse Online 正在提示您选择完成连接,请跳过这一步。
  2. 在显示可用步骤的页面中,点您要添加到流中的 REST API 连接。
  3. 选择您要连接执行的操作。可用的操作基于上传到 Fuse Online 的 OpenAPI 文档中指定的资源操作,并描述了您要连接的 API。
  4. 根据您选择的操作,输入 Fuse Online 提示的任何参数。
  5. 点击 Next

结果

连接会出现在您添加它的集成视觉化中。

第 21 章 连接到 Salesforce

在集成过程中,要连接到 Salesforce,您必须将 Fuse 在线环境注册为 Salesforce 客户端应用程序。这样可让 Fuse Online 访问 Salesforce。通过注册,您可以创建一个 Salesforce 连接,然后您可以添加到任意数量的集成中。详情请查看以下主题:

21.1. 将 Fuse Online 注册为 Salesforce 客户端应用程序

在集成过程中,要连接到 Salesforce,您必须首先做的是将 Fuse Online 环境注册为可访问 Salesforce 的客户端应用程序。这可让您创建连接到 Salesforce 的任意数量的集成。换句话说,您需要将特定的 Fuse 在线环境注册到 Salesforce。

在每个 Fuse Online 环境中,只有 Fuse Online 注册作为 Salesforce 客户端应用程序。但是,虽然每个 Salesforce 连接都使用相同的注册,但可以使用不同的用户凭证。

前提条件

您已登录到 Fuse Online。访问 Fuse Online 的 URL 位于欢迎您使用红帽 Fuse 在线评估计划的电子邮件消息中。

流程

  1. 在 Fuse Online 中:

    1. 在左侧面板中,单击 Settings
    2. Settings 页面中,在回调 URL 右侧,点 Copy Callback URL 将 Fuse Online 环境的回调 URL 复制到剪贴板。在此过程中,您将需要此 URL。
    3. 单击 Salesforce 条目,以显示 客户端 ID 和客户端 Secret 字段。
  2. 在另一个浏览器标签页中,登录到您的 Salesforce 帐户,并按照以下步骤创建连接的应用程序。这些说明假设您使用 Salesforce Classic 用户界面。要从 Salesforce Lightning Experience 界面切换,请点击您的个人资料图标并选择 切换到 Salesforce Classic。如需更多信息,请参阅创建 连接的应用程序的 Salesforce 文档

    1. 在 Salesforce 中,单击右上角的 Setup
    2. 在左侧面板中,选择 Build > Create > Apps
    3. 向下滚动到 Connected Apps,然后点 New
    4. 输入所需信息,然后选择 Enable OAuth Settings
    5. Callback URL 字段中,粘贴 Fuse Online URL,在此流程的开头复制。例如: https://app-proj912876.7b63.fuse-ignite.openshiftapps.com/api/v1/credentials/callback
    6. 对于 OAuth 范围,请添加:

      • 访问和管理您的数据(api)
      • 允许访问您的唯一标识符(openid)
      • 随时代表您执行请求(refresh_token、offline_accesss)
    7. 选择 Configure ID token,然后 包含 Standard Claims
    8. 向下滚动并单击 Save
    9. 向上滚动以查看 Salesforce 表示短等待: SF message to wait a few minutes
    10. Continue
    11. 复制 Salesforce 提供的消费者密钥。
  3. 返回到 Fuse Online Settings 页面,将 Salesforce 提供的使用者密钥粘贴到 Fuse Online Salesforce Client ID 字段。
  4. 返回到 Salesforce,并复制 Salesforce 提供的消费者 secret。
  5. 返回到 Fuse Online Settings 页面,将 Salesforce 提供的消费者 secret 粘贴到 Fuse Online Salesforce Client Secret 字段中。
  6. Save
  7. Salesforce 条目折叠它。

21.2. 创建 Salesforce 连接

要创建在 Salesforce 中访问数据的集成,您必须首先创建一个 Salesforce 连接。创建 Salesforce 连接后,您可以在多个集成中使用它。

先决条件

  • 您已登录到 Fuse Online。访问 Fuse Online 的 URL 位于欢迎您使用红帽 Fuse 在线评估计划的电子邮件消息中。
  • Fuse Online 在网页浏览器中打开。
  • 您必须已经注册了 Fuse Online 环境,作为可访问 Salesforce 的应用程序。
  • 将您注册后接收到的 Salesforce 客户端 ID 和客户端 secret 添加至 Fuse Online Settings 页面。

    在尝试创建 Salesforce 连接前,请务必在将 Fuse 在线安装注册为 Salesforce 客户端后等待 2 到 10 分钟。

流程

  1. 在 Fuse Online 中,在左侧面板中点 Connections 以显示可用连接。
  2. 在右上角,单击 Create Connection 以显示可用的连接器。连接器是用于创建一个或多个连接的模板。
  3. Salesforce 连接器。
  4. 单击 Connect Salesforce 以显示 Salesforce 授权页面。在看到授权页面前,您可能需要登录到 Salesforce。

    如果没有显示 Connect Salesforce,则 Fuse Online 环境不会注册为 Salesforce 客户端应用程序。请参阅 将 Fuse Online 注册为 Salesforce 客户端应用程序。当您尝试创建 Salesforce 连接且 Fuse Online 环境未注册为 Salesforce 客户端应用程序时,Fuse Online 会显示多个提示授权信息的字段。虽然您可以通过在这些字段中输入值来创建 Salesforce 连接,但不推荐这样做。

    注意

    以下错误表示 Salesforce 没有正确的 Fuse 在线回调 URL:

    error=redirect_uri_mismatch&error_description=redirect_uri%20must%20match%20configuration

    如果您收到此错误消息,然后在 Salesforce 上,确保根据将 Fuse Online 注册为 Salesforce 客户端应用程序中的说明来指定 Fuse Online 回调 URL。

  5. 单击 Allow 以返回到 Fuse Online。
  6. Name 字段中输入您选择的名称,可帮助您将这个连接与任何其他连接区分开来。例如,输入 SF Connect 1
  7. Description 字段中,输入有助于了解此连接的任何信息。例如,输入 使用 Salesforce 登录凭证的 Sample Salesforce 连接。
  8. Save 查看您创建的连接现在可用。如果您输入了示例名称,您会看到 SF Connect 1 显示为可以添加到集成的连接。

21.3. 在集成中添加 Salesforce 连接

在集成中,您可以在流中连接到 Salesforce,或者启动或完成简单的集成。为此,请在集成中添加 Salesforce 连接。

先决条件

  • 您创建了 Salesforce 连接。
  • 您正在创建或更新集成。
  • Fuse Online 会提示您选择启动连接,或者选择完成连接或添加到集成。

流程

  1. 如果您要向流的中间添加 Salesforce 连接,请单击您要添加连接的加号。如果 Fuse Online 正在提示输入启动或完成连接,请跳过这一步。
  2. 点击您要添加到流中的 Salesforce 连接。当集成使用您选择连接到 Salesforce 的连接时,Fuse Online 使用该连接中定义的凭证。
  3. 选择您希望所选连接执行的操作。您添加到流的每个 Salesforce 连接都只执行您选择的操作。
  4. 指定操作所操作的 Salesforce 对象,例如,它可能是联系人、领导或价格书条目。点 Object 字段从 Salesforce 对象列表中选择,或者输入对象的名称。
  5. Next 将连接添加到流。

第 22 章 连接到 SAP Concur

SAP Concur 管理业务费用、旅行和发票。在集成中,您可以连接到 SAP Concur 并执行各种 SAP Concur 操作之一。例如,假设您将项目代码存储在 SQL 数据库中,并且需要 SAP Concur 中的同一项目代码,以便费用可以与项目关联。您可以创建一个连接到 SQL 数据库的集成,并运行获取任何新项目代码的存储流程。然后,集成可以连接到 SAP Concur,并将新项目代码上传到适当的列表中。

请参见以下主题:

22.1. 用于连接到 SAP Concur 的用户角色

SAP Concur 具有用于开发工作的实施网站,以及用于实时使用的生产站点。实施站点模拟生产站点。这可让您在生产环境与实时 SAP Concur 站点搭配使用前创建和优化集成。

在任何时候,Fuse Online 环境都可以连接到 SAP Concur 实现网站或 SAP Concur 产品网站。换句话说,特定的 Fuse 在线环境不支持同时连接到两个 SAP Concur 站点。每个 Fuse Online 环境都需要自己的凭据来访问每个 SAP Concur 站点,实施站点的凭据与生产站点的凭据不同。

因此,预期是系统管理员相关角色中的某人可以执行以下操作:

  1. 从 SAP Concur 获取两组 OAuth 凭证:

    • 一个集合可访问 SAP Concur 实现网站
    • 另一个集合可访问 SAP Concur 产品站点
  2. 配置 SAP Concur 连接器以访问适当的 SAP Concur 站点。
  3. 创建 SAP Concur 连接。

然后,企业用户可以创建一个使用 SAP Concur 连接的集成。

22.2. 如何获取 SAP Concur 实现站点 OAuth 凭证

要获取用于访问 SAP Concur 实现网站的凭证,请直接联系 SAP Concur 并告诉它们:

  • 您希望将 Fuse Online 注册为有权访问 SAP Concur 实现网站的新应用程序。
  • 您需要一组新的 OAuth 凭证来实现站点。
  • 凭据必须包含 LIST 范围。
  • 另外,要获取执行列表操作以外的操作的权限,请询问其他范围。https://developer.concur.com/api-reference/authentication/scopes.html
  • 这些凭证的 OAuth 授权类型应当是 Authorization Grant Flow

    要使用 REST 客户端(如 Postman )向 SAP Concur 实现站点发送请求,您需要具有 OAuth 授权类型 的凭证。

  • 您想获得凭证的环境的 Fuse 在线回调 URL,如下所示:

    https://syndesis.my-minishift.syndesis.io/api/v1/credentials/callback

    在这个 URL 中,syndesis.my-minishift.syndesis.io 与 Fuse Online 环境的 OpenShift 路由匹配。

SAP Concur 的响应应提供:

  • 用于登录到 SAP Concur 实现网站的用户名和密码。
  • 您在 Fuse Online 开发环境设置页面中指定的客户端 ID 和客户端 secret 值,以配置 Fuse Online SAP Concur 连接器。

22.3. 如何获取 SAP Concur production 站点 OAuth 凭证

要获取授权 Fuse Online 访问 SAP Concur 产品站点的 OAuth 凭证,请转至 SAP Concur Developer Center Getting Started 页面,并按照其中的说明进行操作。

22.4. 配置 SAP Concur 连接器

要连接到 SAP Concur in 集成,您必须配置 Fuse Online SAP Concur 连接器。然后,您可以使用连接器创建与 SAP Concur 的连接。

先决条件

  • 您知道,是否要将 SAP Concur 连接器配置为访问 SAP Concur 实现站点或 SAP Concur 产品站点。
  • 您获取了授权 Fuse 在线环境访问适当 SAP Concur 站点的 OAuth 凭证。

流程

  1. 在 Fuse Online 的左侧面板中,单击 Settings
  2. Settings 页面中,展开 SAP Concur 条目。
  3. Client ID 字段中,输入您从 SAP Concur 接收的客户端 ID。
  4. Client Secret 字段中,输入您从 SAP Concur 接收的客户端 secret。

    Fuse Online 填充其他字段。

  5. Save

    Fuse Online 立即尝试验证配置。如果验证不成功,请更正输入值并重试。如果验证成功,您可以创建一个 SAP Concur 连接,您可以将其添加到集成中。

  6. 单击 SAP Concur 条目以折叠它。

后续步骤

创建 SAP Concur 连接。

22.5. 创建 SAP Concur 连接

要连接到 SAP Concur in 集成,您必须首先创建一个 SAP Concur 连接,然后您可以添加到任意数量的集成中。当您创建 SAP Concur 连接时,您可以授权连接使用您在创建连接时输入的登录凭证访问 SAP Concur。

先决条件

  • 在您要创建连接的 Fuse Online 环境中,您必须已配置了 SAP Concur 连接器。
  • 您应该知道是否配置了连接器来访问 SAP Concur 实现站点还是 SAP Concur production 站点。
  • 您必须有一个用户名和密码才能登录到配置了 SAP Concur 连接器的 SAP Concur 站点。

流程

  1. 在 Fuse Online 中,在左侧面板中,单击 Connections 以显示任何可用连接。
  2. 在右上角,单击 Create Connection 以显示可用的连接器。连接器是一个模板,用于创建一个或多个连接。
  3. SAP Concur 连接器。
  4. Configure Connection 页面中,单击 Connect SAP Concur,这将进入配置了连接器的 SAP Concur 站点。

    如果没有显示 Connect SAP Concur,则不会配置 Fuse Online 环境中的 SAP Concur 连接器。请参阅配置 SAP Concur 连接器

    如果 redirect_uri 不正确或之前没有注册,则 SAP Concur 连接器配置不正确。返回到 Fuse Online Settings 页面,以更新并验证连接器配置。

  5. 在 SAP Concur OAuth 网站上:

    1. 输入您希望此连接用于访问 SAP Concur 帐户的 SAP Concur 帐户的电子邮件地址。
    2. 确保已选中 Username
    3. Continue
    4. 输入与电子邮件地址关联的 SAP Concur 密码。
    5. 单击 Sign In,这将使您返回到 Fuse Online。
  6. 在 Fuse Online Name 字段中输入您选择的名称,以帮助您将这个连接与任何其他连接区分开来。例如,输入 SAP Concur Test1
  7. Description 字段中,输入有助于了解此连接的任何信息。例如,输入 Sample SAP Concur 连接到实施站点。
  8. Save 查看您创建的连接现在可用。如果您输入了示例名称,您会看到 SAP Concur Test1 显示为可以添加到集成的连接。

22.6. 在集成中添加 SAP Concur 连接

您可以将 SAP Concur 连接添加到流中间,或者在简单集成中作为完成连接。与 SAP Concur 的连接可以执行任何一个 85 操作。

先决条件

  • 您创建了 SAP Concur 连接。
  • 您正在创建或编辑流。
  • Fuse Online 会提示您添加到集成,或者在简单集成中选择完成连接。

流程

  1. Add to Integration 页面上,单击您要添加连接的加号。如果 Fuse Online 正在提示您选择完成连接,请跳过这一步。
  2. 点击您要添加到流中的 SAP Concur 连接。当集成使用您选择的连接时,Fuse Online 使用该连接中定义的凭证连接到 SAP Concur。
  3. 选择您要连接执行的操作。您添加到流中的每个 SAP Concur 连接都只执行您选择的操作。

    有关 SAP Concur 操作的详细信息,请访问 SAP Concur developer Center 并扩展 v3.0

  4. Next 将连接添加到流。

结果

连接会出现在您添加它的集成视觉化中。

22.7. 将集成数据字段映射到 SAP Concur 字段的示例

在大多数集成中,您需要在连接到 SAP Concur 前添加数据映射步骤。在数据映射步骤中,您要将之前集成步骤中提供的数据字段映射到 SAP Concur action 参数。在数据映射程序中,Target 面板显示您在将 SAP Concur 连接添加到集成时选择的 SAP Concur 参数。

假设集成首先执行 SQL 存储的步骤来获取新项目代码。集成通过向 SAP Concur 添加新项目代码来完成。以下流程提供了 SAP Concur 连接前的数据映射程序步骤示例。集成视觉化显示,Fuse Online 正在提示您添加到集成。

  1. 在集成视觉化中,点 SAP Concur finish 连接前的加号。
  2. 单击 Data Mapper。当显示数据字段时,左侧的 Sources 面板会显示数据库连接中可用的字段。在本例中,source 字段包括 concur-list-idproject-code。右侧的 Target 面板显示连接执行的 SAP Concur idcontent 参数。
  3. concur-list-id source 字段映射到 id target 字段。
  4. project-code source 字段映射到 内容 目标字段。
  5. 在右上角,点 Done 将数据映射程序步骤添加到集成。

第 23 章 连接到 ServiceNow

集成可以从 ServiceNow 表检索记录,或将记录添加到 ServiceNow 导入集中,ServiceNow 用于更新表。在集成中,要连接到 ServiceNow,请创建一个 ServiceNow 连接,然后将该连接添加到集成。详情请查看:

23.1. 创建 ServiceNow 连接

在集成中,要连接到您公司的 ServiceNow 实例,您必须创建一个 ServiceNow 连接。

先决条件

  • 您的站点的 ServiceNow 管理员必须已为您创建了 ServiceNow 帐户。
  • 您必须知道 ServiceNow 实例的 URL,以及您的 ServiceNow 用户名和密码。
  • 如果 ServiceNow 管理员还为您创建了 ServiceNow 客户端 ID 和客户端 secret,您必须知道这些值。

流程

  1. 在 Fuse Online 中,在左侧面板中,单击 Connections 以显示任何可用连接。
  2. 在右上角,单击 Create Connection 以显示 Fuse Online 连接器。
  3. ServiceNow 连接器。
  4. 配置此 ServiceNow 连接:

    1. Instance Name 字段中,输入您要从或复制记录到的 ServiceNow 实例的名称。例如,如果您的 ServiceNow 实例的 URL 是 https://abc12345.service-now.com,则实例名称为 abc12345
    2. User Name 字段中输入您的 ServiceNow 用户名。
    3. User Password 字段中,输入您的 ServiceNow 密码。
    4. 另外,在 Client ID 字段中,如果您从 ServiceNow 管理员收到了一个客户端 ID,请输入您的客户端 ID。
    5. 另外,在 Client Secret 字段中,如果您从 ServiceNow 管理员收到了客户端 secret,请输入您的客户端 secret。
    6. 单击 Validate。Fuse Online 立即尝试验证连接并显示一条消息,指示验证是否成功。如果验证失败,请根据需要更新配置详情,然后重试。
    7. 验证成功后,单击 Next
  5. Name 字段中输入一个名称,帮助您将这个连接与其他连接区分开来。例如,输入 ServiceNow Con 1
  6. Description 字段中,输入有助于了解此连接的任何信息。例如,输入 使用管理凭证的 ServiceNow 连接。
  7. Save 查看您创建的连接现在可用。如果您输入了示例名称,您会看到 ServiceNow Con 1 显示为一个连接,您可以选择添加到集成。

23.2. 从 ServiceNow 获取记录以触发集成执行

要在从 ServiceNow 接收记录时触发集成执行,请在启动连接时将 ServiceNow 连接添加到简单集成。

先决条件

  • 您创建了 ServiceNow 连接。
  • 您知道要从中检索记录的表名称。
  • 您应该已经定义了 ServiceNow 查询,仅获取您想要的记录。您可以在此处找到有关 ServiceNow 查询的信息:ServiceNow encoded 查询

流程

  1. 在左侧的 Fuse Online 面板中,单击 Integrations
  2. Create Integration
  3. Choose a connection 页面上,单击您要用来启动集成的 ServiceNow 连接。
  4. Choose an action 页面上,选择 Retrieve Record 从您选择的 ServiceNow 表中获取记录。
  5. 配置 Retrieve Record 操作:

    1. Table name 字段,再选择您要从中获取记录的表。
    2. Query 过滤结果集 字段中,输入 ServiceNow 查询。例如,考虑 state=1^impact=2 查询在保留有关事件记录的表上。此查询返回新事件(state=1)的记录,其具有中等影响(impact=2)。如果您没有输入查询,且表中的记录不会改变,则连接会每次获取相同的记录。
    3. 按页字段的 Limit of 元素中,输入您希望连接获取的最大记录数。在这个发行版本中,您必须输入一个值,建议输入 1000 个或更少,且不支持分页。
    4. Period 字段中,指示您要获取记录的频率。默认值为每分钟。换句话说,默认情况下 Fuse Online 每 60 秒执行此集成。
    5. 点击 Next

结果

Fuse Online 生成 JSON 模式,用于定义获取的记录结构。这可让您在集成中的下一个连接前添加数据映射步骤(如果需要数据映射)。

Fuse Online 会提示您选择完成连接。

23.3. 在 ServiceNow 中创建导入集

在 Fuse Online 集成中,ServiceNow 连接无法直接更新 ServiceNow 表。要在集成中更新 ServiceNow 数据,先决条件是 ServiceNow 表的导入阶段更新。

通常,创建导入集的最简单方法是让 ServiceNow 管理员创建 ServiceNow 入站 Web 服务。这会隐式创建 ServiceNow 导入集。导入集基于在创建 Web 服务时选择的 ServiceNow 目标表。ServiceNow 连接会更新这个导入集,ServiceNow 使用导入集来更新对应的 ServiceNow 表。

先决条件

您必须具有 ServiceNow 管理特权。

ServiceNow 中的步骤

  1. 在 ServiceNow 中,搜索 Web 服务
  2. 在结果中,在 System Web Services > Inbound 下点 Create New
  3. Create Web Service 页面中:

    1. Label 字段中,指定 web 服务的显示名称。Web 服务的导入集也将具有此名称。
    2. Target table 字段中,选择此服务更新的 ServiceNow 表。
    3. 从目标表中选择 Copy fields。这会创建一个与目标表相同的导入集。导入集是一个暂存区域,用于更新目标表。
    4. 选择 Create transform map。这个映射可让 ServiceNow 复制并转换导入集到目标表的数据。
  4. Create
  5. 在下一个显示中,在 Related Links 下,单击 Auto Map Matching Fields 以显示您选择的目标表中的字段列表。
  6. 选择一个目标表字段,作为关联(或 coalesce)字段。

    当导入集合中记录中的 correlation 字段的值与目标表中的关联字段值匹配时,ServiceNow 会更新目标表中的记录,而不是创建新记录。

  7. 选择 Coalesce 来识别您刚刚选择的字段作为关联字段。如果没有关联字段,ServiceNow 会将导入集中的每个记录添加到目标表中。
  8. Update
  9. 确认创建了转换映射:

    1. 在 ServiceNow 中,搜索 转换映射
    2. System Import Sets 下,单击 Transform Maps 以显示转换映射的列表。
    3. 在此列表中,确认有转换映射,其名称是您为您创建的 Web 服务标签指定的值。

23.4. 在或完成集成过程中将记录复制到 ServiceNow

您可以将记录复制到流中间的 ServiceNow,或者完成简单的集成。为此,请将 ServiceNow 连接添加到流中间,或作为一个简单的集成完成连接。

先决条件

  • 您创建了 ServiceNow 连接。
  • 您正在创建或编辑流,Fuse Online 会提示您添加到集成。或者,Fuse Online 正在提示您选择完成连接。
  • 您知道您要向其添加记录的 ServiceNow 导入集的名称。您的 ServiceNow 管理员可以帮助您识别适当的导入集。如果导入集不存在,请参阅在 ServiceNow 中创建导入集
  • ServiceNow 导入集被配置为处理添加记录。

流程

  1. Add to Integration 页面上,单击您要添加连接的加号。如果 Fuse Online 正在提示您选择完成连接,请跳过这一步。
  2. 点击您要添加到集成的 ServiceNow 连接。
  3. 选择 Add Record 操作。
  4. Import Set 字段,再选择您要向其添加记录的导入集。
  5. 点击 Next

结果

Fuse Online 将连接添加到流。

通常,在这个连接之前需要数据映射程序步骤。在集成视觉化中,Fuse Online 在连接中显示 Data Type Mismatch 。在大多数集成中,您需要将 source 字段映射到用作 ServiceNow 表中关联字段的目标字段。

23.5. Salesforce 到 ServiceNow 集成示例

这个示例描述了两个简单集成:

  • 个集成从 Salesforce 获得新案例,并将它们作为事件添加到 ServiceNow。
  • 其他集成从 Salesforce 获取更新的情况,并在 ServiceNow 中更新相应的事件。

先决条件(在 ServiceNow 中)

对于这两个集成,ServiceNow 管理员创建入站 Web 服务的先决条件。这会隐式创建 ServiceNow 导入集,这是将数据添加到 ServiceNow 所需的。在此例中:

  • Web 服务的名称 是来自 Salesforce 的问题单
  • 服务的目标表是 Incidents。此表包含要更新的数据。
  • 因为 从目标表选择 Copy 字段,导入集与 Incidents 具有相同的模式。导入集的名称也是 来自 Salesforce 的问题单
  • ServiceNow 可能会因为选择 创建转换映射,从 Cases 从 Salesforce 导入集复制并转换数据事件 目标表。
  • 在导入集中,correlation 字段是 correlation_Id,因为选择 correlation_Id 字段,后跟 Coalesce 的选择。

流程概述(在 Fuse Online 中)

在 Fuse Online 中,您可以创建 Salesforce 和 ServiceNow 连接。

两个集成相同,除了 Salesforce 连接执行的操作,具体如以下步骤中所述。要创建集成,您将执行这些步骤两次,即创建每个集成一次:

  1. 添加 Salesforce 连接作为开始连接。

    • 要创建获取新案例的集成,请选择 On create 操作。
    • 要创建获取更新问题单的集成,请选择 On update 操作。
  2. 为要操作的操作选择 Case 对象。这个 Salesforce 连接会根据所选操作返回新的 Case 对象或更新的 Case 对象。
  3. 将 ServiceNow 连接添加为完成连接。
  4. 选择 Create Record 操作,然后选择 Salesforce 中的 Cases 作为集成更新的导入集。

    此 ServiceNow 连接向 Salesforce 导入集中的问题单中添加新的或更新的 Salesforce 案例。

  5. 添加映射的数据映射程序步骤:

    • salesforce case id to the ServiceNow import set's correlation_Id
    • Salesforce ServiceNow short_description的影响
    • salesforce 描述 到 ServiceNow 描述
  6. 为集成指定一个名称,然后发布它。

    • 对于获取新案例的集成,请使用 SF 创建案例
    • 对于获取更新问题单的集成,在 SF 更新问题单中

确认集成正常工作

当两个集成都运行时,您可以确认集成是否正常工作:

  1. 在 Salesforce 中,创建一个问题单。
  2. 在 Fuse Online 中,查看 On SF 创建案例 集成摘要。单击其 Activity 选项卡,以查看 Fuse 在线执行一次集成。
  3. 在 ServiceNow 中,查看 Incidents 表。您应看到一个新事件,该事件具有您在 Salesforce 中指定的主题和描述。
  4. 返回 Salesforce,通过更改其主题来更新您刚才创建的问题单。
  5. 在 Fuse Online 中,查看 On SF Update Case 集成摘要。单击其 Activity 选项卡,以查看 Fuse 在线执行一次集成。
  6. 在 ServiceNow 中,查看 Incidents 表并展开之前新事件的条目。您应该会看到此事件具有更新的 short_description 值。ServiceNow 检查导入设置条目,以获取其 correlation_Id 的值。如果 Incidents 表中已存在这个值,ServiceNow 会更新具有该值的事件。

第 24 章 连接到 Slack

作为业务用户,您可以创建一个连接到 Slack 的集成。与 Slack 的连接可以执行以下操作之一:

  • 当您指定 Slack 频道收到消息时,触发简单集成的执行。集成将消息传递到流中的下一步。例如,您可以监控 Slack 频道中的关键字实例,如产品名称。在查找包含这些产品名称的消息后,集成可以通知 Gmail 连接中的相应联系人。
  • 向特定用户或频道发送消息。例如,当集成从 FTP 服务器下载文件并以某种方式处理该文件时,此行为非常有用。集成流程可以通知 Slack 频道或进程成功的用户。

要在集成中连接到 Slack,请创建一个 Slack 连接,然后将连接添加到集成流中。详情包括在以下主题中:

24.1. 创建 Slack 连接

在集成中,Slack 连接可以从您指定的频道检索信息,或向频道或用户发送信息。您可以在任意数量的集成中使用相同的 Slack 连接。

先决条件

  • 您创建了 Slack 应用程序,用于将 Fuse Online 连接到 Slack。
  • 您可以获取 Slack 应用程序的 Slack Webhook URL。
  • 您可以获取授权对 Slack 应用程序访问权限的旧令牌。

流程

  1. 在 Fuse Online 中,在左侧面板中,单击 Connections 以显示任何可用连接。
  2. 在右上角,单击 Create Connection 以显示 Fuse Online 连接器。
  3. Slack 连接器。
  4. Slack webhook URL 字段中,输入 Slack 应用程序的 Webhook URL。
  5. Token for access Slack API 字段中,输入 Slack 提供的令牌,您可以从 Slack 获取。
  6. 另外,还可为附加参数输入值:

    • sending username for messages 字段中,输入 bot 在向 Slack 发送消息时具有的用户名。
    • Message avatar emoji 字段中,指定一个 emoji,bot 会在发送消息时用作消息 avatar。示例: :smile:, :wave:, :question:.

      提示

      在 web 中搜索 emoji cheat sheet 以查看一些 emoji 代码。

    • Message avatar 图标 URL 字段中,指定 bot 发送消息到 Slack 时使用的 URL。

    如果您指定了 emoji 和图标 URL,则集成将使用图标 URL。如果您没有指定 emoji 或图标 URL,则会在没有 avatar 的情况下发送该消息。

  7. 单击 Validate。Fuse Online 立即尝试验证连接并显示一条消息,指示验证是否成功。如果验证失败,请重新发送连接配置值并重试。
  8. 如果验证成功,请单击 Next
  9. Name 字段中输入您选择的名称,可帮助您将这个连接与任何其他连接区分开来。例如,输入 Slack for Tracking Company Sales
  10. Description 字段中,输入有助于了解此连接的任何信息。
  11. Save 查看更新的可用连接列表,包括您刚才创建的连接。如果您输入了示例名称,您会看到 Slack for Tracking Company Sales 显示为一个连接,您可以选择添加到集成。您可以将此连接添加到任意数量的集成。

24.2. 添加 Slack 连接,以便在收到信息时触发集成执行

当连接在您指定的 Slack 频道上找到消息时,启动集成的 Slack 连接会触发集成执行。

先决条件

  • 您创建了 Slack 连接。
  • 您正创建集成,Fuse Online 正在提示您选择如何开始集成。

流程

  1. 点击您要用来启动集成的 Slack 连接。
  2. 选择 Read Messages 操作。
  3. Channel 字段中,指定要获取消息的 Slack 频道。
  4. Delay 字段中,接受默认的 500 毫秒,作为消息轮询之间经过的时间。或者,要指定检查消息的不同间隔,请输入一个数字并选择其时间单位。
  5. Maximum Messages to Retrieve 字段中,接受默认值 10 或指示连接为每个轮询返回的最大消息数。如果连接发现超过此数量的未读取消息,则返回最新的消息。连接仅返回一次特定的消息。

    例如,如果您接受默认的 10,轮询时有 15 个消息,则连接会返回 10 个最新消息。在下一次轮询时,连接会检查具有之前返回连接的最新消息的时间戳的消息。这意味着,在第一个示例轮询中未返回的 5 个消息永远不会返回。

    当 Slack 连接返回多个消息时,集成会将消息作为批处理处理。换句话说,Fuse Online 为批处理执行一次集成。

  6. Next 将连接添加到集成。

24.3. 添加 Slack 连接以向 Slack 频道或用户发送消息

在集成中,您可以在流中向 Slack 频道或 Slack 用户发送一条信息,或者完成简单的集成。为此,请在流的中间或简单集成完成连接中添加 Slack 连接。

先决条件

  • 您创建了 Slack 连接。
  • 您正在创建或编辑流,Fuse Online 会提示您添加到集成。或者,Fuse Online 正在提示您选择完成连接。

流程

  1. Add to Integration 页面上,单击您要添加连接的加号。如果 Fuse Online 正在提示您选择完成连接,请跳过这一步。
  2. 点击您要添加到流中的 Slack 连接。
  3. 选择您要连接执行的操作。

    • 选择 Username 将信息发送到一个用户。要配置此操作,请在 User name 字段中指定要发送消息的用户的 Slack 名称。
    • 选择 Channel 在频道上发布信息。要配置此操作,请在 Channel 字段中指定要发布消息的频道。
  4. Next 将连接添加到流。
  5. 另外,还可在流中添加其他连接。是否需要其他连接取决于您要进行的流程。重要点是在继续前添加所有连接。
  6. 在此流程中添加的 Slack 连接前添加数据映射程序步骤。在映射步骤中,将数据映射源的字符串映射到 Slack 消息字段。此字符串应包含您要发送到 Slack 用户或频道的消息。请参阅 添加数据映射程序步骤

第 25 章 连接到 SQL 数据库

在集成中,您可以连接到以下任何类型的 SQL 数据库:

  • Apache Derby
  • MySQL
  • PostgreSQL

创建与要在集成中访问的数据库的连接。然后,创建一个集成,并将该数据库连接添加到集成。

要连接到其他类型的数据库,您必须为该数据库上传 JDBC 驱动程序。

详情请查看以下主题:

25.1. 创建数据库连接

您可以为集成中的每个数据库创建一个单独的连接。您可以在多个集成中使用相同的连接。

数据库连接在您指定的数据库表上运行,或者调用您指定的存储流程。

前提条件

当集成连接到数据库时,数据库表或存储的步骤必须存在。

流程

  1. 确保您要连接的数据库的 JDBC 驱动程序位于您的 classpath 上。如果您上传 JDBC 驱动程序库扩展以连接到专有数据库,则上传过程会将驱动程序放在您的类路径上。请参阅创建 JDBC 驱动程序库扩展
  2. 在 Fuse Online 中,在左侧面板中,单击 Connections 以显示任何可用连接。
  3. 在右上角,单击 Create Connection 以显示 Fuse Online 连接器。
  4. Database 连接器。
  5. 使用以下命令配置连接:

    1. Connection URL 字段中,输入您要连接的数据库的 JDBC URL。例如,输入 jdbc:postgresql://ignite-db1234/sampledb
    2. Username 字段中,输入您要用来访问数据库的帐户名称。确保指定的密码和用户名是同一帐户。
    3. Password 字段中,输入与您要用来访问数据库的用户帐户关联的密码。
    4. Schema 字段中,为数据库输入 schema 的名称。如何指定数据库架构因每种数据库而异。下一节中的详细信息: 如何在数据库连接中指定 schema
  6. 单击 Validate。Fuse Online 尝试验证连接并显示指示验证是否成功的消息。如果验证失败,请根据需要重新传输配置详情,然后重试。
  7. 如果验证成功,请单击 Next
  8. Name 字段中输入您选择的名称,可帮助您将这个连接与任何其他连接区分开来。例如,输入 PostgreSQL DB 1
  9. Description 字段中,输入有助于了解此连接的任何信息。例如,输入 使用我的登录凭据的 Sample PostgreSQL 连接。
  10. Save 查看您创建的连接现在可用。如果您输入了示例名称,您会看到 PostgreSQL DB 1 显示为可以添加到集成的连接。

25.2. 如何在数据库连接中指定 schema

在 Fuse Online 中,当您创建数据库连接时,用户界面会提示您指定数据库的模式。如何为每个数据库指定 schema 的不同。下表显示了每个数据库需要的内容。

数据库连接配置示例备注

Apache Derby

Connection URL (JDBC URL): jdbc:derby:memory:testdb;create=true
Username:sa
Password: any value
Schema:sample

仅用于测试目的。默认用户名是 sa,密码可以是任何内容,但您必须输入一个值。在本例中,连接 使用示例 模式,类似于命名空间。例如,您可以使用 sample. mytable 引用 mytable 表。

MS SQLServer

Connection URL (JDBC URL): jdbc:sqlserver://localhost:1433/sampledb
Username:kurt
Password:mypw
Schema:sampledb

使用扩展机制上传 驱动程序。然后创建一个连接。如果您还没有上传驱动程序,连接验证会失败。您必须在连接 URL 和 Schema 字段中指定相同的模式。

MySQL

Connection URL (JDBC URL: sql-connector.url=jdbc:mysql://mysql-host:3307/test?allowPublicKeyRetrieval=true&useUnicode=true&useUnicode=true&use JDBCTimezoneShift=true&useLegacyDatetimeCode=false&serverTimezone=UTC
Username:kurt
Password:mypw
Schema:

MySQL 不支持模式。当您创建到 MySQL 数据库的连接时,将 Schema 字段留空。MySQL 需要连接(JDBC) URL 中的所有配置。

Oracle DB

连接 URL (JDBC URL): jdbc:oracle:thin:@10.192.212.255:1521:xe
Username:kurt
Password:mypw
Schema:

使用 Fuse Online 扩展机制. 上传 Oracle 数据库驱动程序。然后,创建连接。如果没有上传驱动程序,连接验证会失败。
schema 是数据库名称。您必须具有访问此数据库实例的权限,这在 Oracle 术语中被称为 schema。将 Schema 字段留空。在 Connection 字段中,您必须引用此数据库实例的 Oracle 系统标识符(SID) (本例中为x )。

PostgreSQL

Connection URL (JDBC URL): jdbc:postgresql://syndesis-db:5432/sampledb
Username:kurt
Password:mypw
Schema:sampledb

您必须在连接(JDBC) URL 中指定数据库。T 如果要使用模式,则必须在 Schema 字段中指定它。查询可以引用格式为 database.schema.table 的表。当引用只指定表名称时,连接首先搜索您在配置连接时指定的模式。如果没有找到表,连接会搜索指定表的公共资源。如需了解更多详细信息,请参阅 PostgreSQL 模式文档

Teiid

Connection URL (JDBC URL) :jdbc:teiid:<vdb-name>@mm://localhost:31000
Username: any value
Password: any value
Schema:

虚拟数据库必须已创建,例如使用数据 虚拟化功能。在连接 URL 中,将 & lt;vdb-name > 替换为虚拟数据库的名称。尚未实施安全性,以连接到 Teiid。在 UsernamePassword 字段中指定任何值。将 Schema 字段留空。Fuse Online 中已经提供该驱动程序。

重要

数据虚拟化只是一个技术预览功能。技术预览功能不受红帽产品服务等级协议(SLA)支持,且功能可能并不完整。红帽不推荐在生产环境中使用它们。这些技术预览功能可以使用户提早试用新的功能,并有机会在开发阶段提供反馈意见。有关红帽技术预览功能支持范围的详情,请参考 https://access.redhat.com/support/offerings/techpreview/

25.3. 获取数据库记录以触发集成执行

要根据调用 SQL 语句或 SQL 存储的步骤触发集成执行,请选择数据库连接作为集成的启动连接。

前提条件

您创建了数据库连接。

流程

  1. 在左侧的 Fuse Online 面板中,单击 Integrations
  2. Create Integration
  3. Choose a connection 页面上,单击您要用来启动集成的数据库连接。
  4. Choose an action 页面中,选择以下之一:

    • 定期 SQL 调用 通过定期调用您指定的 SQL 语句来获取数据。
    • 定期存储的步骤调用 通过定期调用您指定的或选择的已存储流程来获取数据。
  5. 如果您选择了 Periodic SQL invocation,在 Query 字段中输入 SQL SELECT 语句或获取一个或多个记录的其他标准 SQL 语句。例如: SELECT * from my_db_table.包含您想要数据的数据库表必须已经存在。

    如果您选择了 Periodic 存储流程调用,在 流程 名称字段中选择或输入存储的步骤来获取感兴趣的数据。您指定的存储步骤必须已经存在。数据库管理员应已创建了集成中使用的任何存储程序。

  6. Period 字段中,输入整数,并指示单位是毫秒、秒、分钟、小时或天。例如,如果您指定了 5 分钟,则连接每五分钟调用指定的声明或存储流程。
  7. 点击 Next

SQL 扩展的使用限制

您在 Query 字段中输入的 SQL 语句必须是标准 SQL 构造。Fuse Online 不识别或解析 SQL 扩展,如 Procedural Language/PostgreSQL (PL/pgSQL)或 Oracle Procedural Language Extensions to SQL (PL/SQL)。但是,您可以在存储的步骤中使用 SQL 扩展。

结果

Fuse Online 尝试验证连接,其中包括检查指定的 SQL 语句是否正确,并确认是否存在声明或存储的流程目标数据。如果验证成功,Fuse Online 将开始连接添加到集成。如果验证失败,Fuse Online 会显示有关此问题的消息。根据需要更新您的输入并重试。

25.4. 关于 SQL 语句中更新数据的参数占位符和值

位于流中或完成简单集成的数据库连接可以执行更新数据的 SQL 语句。当您向集成添加数据库连接时,您可以指定要执行的 SQL 语句中的占位符参数。在执行期间,当输入参数值位于集合中时,连接可以执行批处理更新。

在 SQL 语句中指定参数

当您创建或编辑集成,并添加更新数据库的连接,您可以在 SQL 语句中指定连接在运行时执行的占位符参数,或者存储过程中将执行占位符。例如:

INSERT INTO TODO(task, completed) VALUES(:#param_1, :#param_2)
DELETE FROM TODO WHERE task LIKE :#param_3

要指定这些占位符的值,请在数据库连接前向流添加数据映射步骤。在数据映射步骤中,将适当的源数据字段映射到目标数据字段,例如,将源数据映射到 :#param_1,:#param_2, 和 :#param_3 target 字段。请参阅 添加数据映射程序步骤

使用一组参数值进行批量更新

在运行时,当数据库连接执行插入、删除或更新数据的 SQL 语句时,执行的 SQL 语句通常会指定一个或多个占位符参数,例如 :#task。执行此操作时,对连接的输入可以是一组参数或一组参数集,其中集合中的每个元素为对应的占位符参数定义一个值。

数据库连接的输入来自较早的连接,例如,HTTP 请求(Webhook)或发送到 REST API 服务的请求,用于 API 供应商集成。当输入是集合时,连接使用批处理模式来更新表。例如,考虑这个 SQL 语句:

insert into todo (task) values (:#task)

如果输入集合包含 3 个值,连接会插入三个记录,每个记录对应一个。现在考虑一个带有两个占位符参数的 SQL 语句:

insert into todo (task, completed) values (:#task, :#completed)

在执行此 SQL 语句的连接的输入中,数据组成规格可以指定单个元素,例如:

{"task": "write some docs", "completed": 0}

或者可以指定集合,例如:

[{"task": "write doc", "completed": 1},
 {"task": "publish doc", "completed": 0}]

当集合作为输入时,连接会对每个一组参数值执行插入操作一次。在本例中,连接向表中添加两个记录,分别对应于每组参数值。

25.5. 在中间或访问数据库以完成集成

在集成中,您可以在流中访问数据库或完成简单的集成。为此,请在流程的中间或简单集成完成连接中添加数据库连接。

先决条件

  • 您创建了数据库连接。
  • 您正在创建或编辑流,Fuse Online 会提示您添加到集成。或者,Fuse Online 正在提示您选择完成连接。

流程

  1. Add to Integration 页面上,单击您要添加连接的加号。如果 Fuse Online 正在提示您选择完成连接,请跳过这一步。
  2. 单击您要访问的数据库的数据库连接。
  3. Choose an action 页面中,选择以下之一:

    • 通过执行您指定的 SQL 语句来调用 SQL 对数据进行操作。
    • 通过调用 您指定的或选择的存储流程,调用存储的步骤对数据进行操作。
  4. 如果您选择了 Invoke SQL,在 SQL Statement 字段中:

    • 对于中间连接,输入 SQL SELECT 语句,该语句获取一个或多个记录,或者输入 SQL INSERTUPDATEDELETE 语句,该语句在一个或多个记录上运行。包含数据的数据库表必须已经存在。
    • 对于完成连接,请输入 SQL INSERTUPDATEDELETE 语句来对一个或多个记录进行操作。
    • Batch update 字段中,接受 No,这是默认值,或者选择 Yes

      当输入到此操作时,Batch update 的设置会影响连接行为,SQL 语句会插入、删除或更新记录。默认行为(Batch updateNo)是连接只接受单个对象,并为每个对象执行 SQL 语句一次。当 Batch 更新Yes 时,连接接受集合作为操作的输入。连接执行 SQL 语句一次,并使用所有集合项作为批处理更新操作的输入。

    如果您选择了 Invoke 存储的步骤,在 流程 名称字段中,选择或输入要调用对感兴趣的数据操作的已存储流程的名称。您指定的存储步骤必须已经存在。数据库管理员应已创建了集成中使用的任何存储程序。

  5. 点击 Next

结果

Fuse Online 尝试验证连接,其中包括检查指定的 SQL 查询是否正确,并确认是否存在查询或存储的流程目标数据。如果验证成功,Fuse Online 将连接添加到流。如果验证失败,Fuse Online 会显示有关此问题的消息。根据需要更新您的输入并重试。

25.6. 连接到专有数据库

要连接到专有 SQL 数据库,必须完成的主要任务如下:

  1. 开发人员会创建一个库扩展,其中包含您要在集成中访问的数据库的 JDBC 驱动程序。请参阅创建 JDBC 驱动程序库扩展
  2. 开发人员提供了一个包含库扩展的 .jar 文件。
  3. 您可以将该 .jar 文件上传到 Fuse Online。请参阅 使扩展可用
  4. 您可以通过选择 Fuse Online Database 连接器并指定您的数据库的连接 URL 来创建与数据库的连接。请参阅创建数据库连接
  5. 在集成中,您将连接添加到您的数据库。请参阅通过访问数据库或访问 中间或完成集成 来启动集成

第 26 章 连接到 Telegram

作为业务用户,您可以创建一个连接到 Telegram 的集成。与 Telegram 的连接可以执行以下操作之一:

  • 当您指定的 Telegram bot 接收消息时,触发简单的集成执行。集成将消息传递到流中的下一步。例如,在简单集成收到一条消息后,可能会有一个过滤器步骤来监视关键字实例,如产品名称。在查找包含这些产品名称的消息后,该集成可以在 Gmail 连接或不同的 Telegram 连接中通知适当的联系人。
  • 向特定的 Telegram chat 发送消息。例如,当集成从 FTP 服务器下载文件并以某种方式处理该文件时,此行为非常有用。您可以添加 Telegram 连接,该连接通知了进程成功的 Telegram chat。

要连接到集成中的 Telegram,请创建一个 Telegram 连接,然后将连接添加到集成流中。详情包括在以下主题中:

26.1. 创建 Telegram 连接

在集成中,Telegram 连接可以接收发送到特定聊天的消息。您创建的 chat bot 将消息转发到 Fuse Online。Telegram 连接也可以发送消息到连接可访问的聊天。您可以使用相同的 Telegram 连接:

  • 在任意数量的集成中,使用连接将消息发送到聊天。
  • 另外,您可以在一个集成中使用它,该集成使用连接从 Telegram chat 接收消息。

换句话说,如果您希望连接在两个集成中接收 Telegram chat 消息,则无法在多个集成中使用同样的 Telegram 连接。这是 Telegram 限制。

先决条件

  • 在 Telegram 中,您可以为您要从中获取信息并发送到的聊天创建一个 bot。有关这一点的帮助,请参阅 Bots,开发人员简介
  • 您已从 Telegram BotFather 获取了 bot 授权令牌。

流程

  1. 在 Fuse Online 中,在左侧面板中,单击 Connections 以显示任何可用连接。
  2. 在右上角,单击 Create Connection 以显示 Fuse Online 连接器。
  3. Telegram 连接器。
  4. Authorization Token 字段中,为 bot 输入 Telegram 授权令牌,您想要从中获取信息并发送到该令牌。
  5. 点击 Next
  6. Name 字段中输入您选择的名称,可帮助您将这个连接与任何其他连接区分开来。例如,为产品 Mentions 输入 Telegram
  7. Description 字段中,输入有助于了解此连接的任何信息。
  8. Save 查看更新的可用连接列表,包括您刚才创建的连接。如果您输入了示例名称,您会看到 Telegram for Product Mentions 显示为一个连接,您可以选择添加到集成。您可以将此连接添加到任意数量的集成。

26.2. 添加 Telegram 连接,以在接收消息时触发集成执行

每次来自您指定的 Telegram chat bot 消息时,启动集成会触发集成执行的 Telegram 连接。

先决条件

  • 您创建了 Telegram 连接。
  • 您正在创建简单的集成,Fuse Online 会提示您选择如何开始集成。

流程

  1. 点击您要用来启动集成的 Telegram 连接。
  2. 选择 Read Messages 操作来接收发送到 chat bot 的所有消息。

    连接配置标识了您要从中接收消息的 chat bot。不需要其他配置。

26.3. 添加 Telegram 连接来向 Telegram chat 发送消息

在集成中,您可以在流中向 Telegram chat 发送消息,或完成简单的集成。为此,请在流的中间或简单集成完成连接中添加 Telegram 连接。

先决条件

  • 您创建了 Telegram 连接。
  • 您正在创建或编辑流,Fuse Online 会提示您添加到集成。或者,Fuse Online 正在提示您选择完成连接。

流程

  1. Add to Integration 页面上,单击您要添加连接的加号。如果 Fuse Online 正在提示您选择完成连接,请跳过这一步。
  2. 点击您要添加到流中的 Telegram 连接。
  3. 选择 Send a Text Message 操作。
  4. Chat Id 字段中,输入您要发送消息的 Telegram chat 的 ID。

    如果将此字段留空,如果有一个早期的 Telegram 连接接收消息,则 Fuse Online 会使用传入消息中的聊天 ID。

    获取聊天的 ID:

    1. 在 Telegram 中,在您要发送消息的聊天中添加 bot。BotFather 响应包括 bot 访问令牌。
    2. 将访问令牌复制到剪贴板。
    3. 在 Telegram 中,直接向该聊天发送消息。不要使用 bot 来发送消息。
    4. 通过以以下格式调用 curl 命令,读取发送到该聊天的消息。将 bot-access-token 替换为剪贴板中的访问令牌。

      curl https://api.telegram.org/bot-access-token/getUpdates\?offset\=0

      响应采用 JSON 格式。JSON chat 对象包含 chat ID。

  5. Next 将连接添加到流。

第 27 章 连接到 Twitter

要在集成中连接到 Twitter,主要步骤包括:

您需要 Twitter 开发人员帐户来授权从 Fuse 在线环境访问 Twitter。如果您还没有 Twitter 开发人员帐户,请访问 https://apps.twitter.com,签署 Twitter,然后点 Apply for a developer account。当您提供专业电子邮件地址,如 me@redhat.com 而不是个人地址(如 you@gmail.com )时,可以快速获取开发人员帐户。

27.1. 将 Fuse Online 注册为 Twitter 客户端应用程序

在集成过程中,要连接到 Twitter,您必须首先将 Fuse Online 环境注册为可访问 Twitter 的客户端应用程序。这可让您创建连接到 Twitter 的任意数量的集成。换句话说,您需要使用 Twitter 注册特定的 Fuse 在线环境。

在每个 Fuse Online 环境中,只有 Fuse Online 注册作为 Twitter 客户端应用程序。但是,虽然每个 Twitter 连接都使用相同的注册,但可以使用不同的用户凭证。

前提条件

您已登录到 Fuse Online。访问 Fuse Online 的 URL 位于欢迎您使用红帽 Fuse 在线评估计划的电子邮件消息中。

流程

  1. 在 Fuse Online 中:

    1. 在左侧面板中,单击 Settings
    2. Settings 页面中,在回调 URL 右侧,点 Copy Callback URL 将 Fuse Online 安装的回调 URL 复制到剪贴板。此流程稍后您将需要此 URL。
    3. 单击 Twitter 条目,以显示 Consumer API KeyConsumer API Secret Key 字段。
  2. 在另一个浏览器标签页中,进入 Twitter 开发人员帐户,如果需要,请登录并执行以下操作:

    1. 在右上角,单击开发人员项目的名称,单击向下护理,再单击 Apps
    2. 在右上角,单击 Create a app
    3. App name 字段中,输入 My Fuse Online Client 等名称。
    4. Application description 字段中,输入如下提示,例如用于利用偏移
    5. Website URL 字段中,粘贴您在此流程开始时复制的 URL,并从 URL 末尾删除 api/v1/credentials/callback
    6. 选择 Enable Sign in with Twitter
    7. Callback URL 字段中,再次粘贴 URL。它应如下所示: https://app-proj912876.7b63.fuse-ignite.openshiftapps.com/api/v1/credentials/callback

      您可以跳过下一个几个字段。

    8. 告知我们如何使用此应用程序, 需要 100 个字符的描述。为方便起见,您可以复制和粘贴: 这是一个演示应用程序,因此我可以评估如何将 Twitter 与我的企业应用程序集成。
    9. Create
    10. 再次单击 Create,以确认您检查了开发人员术语。
    11. 在您刚才创建的应用程序的页面的顶部,点 Keys 和 token 选项卡
    12. 复制使用者 API 密钥。
  3. 返回到 Fuse Online Settings 页面,将 Twitter 使用者 API 密钥粘贴到 Fuse Online Twitter Consumer API Key 字段中。
  4. 返回到 Twitter Keys 和 token 选项卡,再复制使用者 API secret 密钥。
  5. 返回到 Fuse Online Settings 页面,将 Twitter 使用者 API secret 密钥粘贴到 Fuse Online Twitter Consumer API Secret Key 字段中。
  6. Save
  7. Twitter 条目折叠它。

27.2. 创建 Twitter 连接

要创建从 Twitter 获取数据的集成,您必须首先创建一个 Twitter 连接。创建 Twitter 连接后,您可以在任意数量的集成中使用它。

先决条件

  • 您已登录到 Fuse Online。访问 Fuse Online 的 URL 位于欢迎您使用红帽 Fuse 在线评估计划的电子邮件消息中。
  • Fuse Online 在网页浏览器中打开。
  • 您已将 Fuse Online 环境注册为可访问 Twitter 的应用程序。
  • 您已向 Fuse Online Settings 页面注册后,添加了 Twitter 使用者 API 密钥和消费者 API secret 密钥。

流程

  1. 在 Fuse Online 中,在左侧面板中,单击 Connections 以显示任何可用连接。
  2. 在右上角,单击 Create Connection 以显示可用的连接器。连接器是一个模板,用于创建一个或多个连接。
  3. Twitter 连接器。
  4. Connect Twitter 以显示 Twitter 授权页面。在看到授权页面前,您可能需要登录到 Twitter。

    如果没有显示 Connect Twitter,则您的 Fuse Online 环境不会作为 Twitter 客户端应用程序注册。请参阅 将 Fuse Online 注册为 Twitter 客户端应用程序。当您尝试创建 Twitter 连接且 Fuse Online 环境没有注册为 Twitter 客户端应用程序时,Fuse Online 会显示多个提示授权信息的字段。虽然您可以通过在这些字段中输入值来创建 Twitter 连接,但不推荐这样做。

  5. 单击 Authorize app 以返回到 Fuse Online。
  6. Name 字段中输入您选择的名称,可帮助您将这个连接与任何其他连接区分开来。例如,输入 Twitter Connect 1
  7. Description 字段中,输入有助于了解此连接的任何信息。例如,输入 Sample Twitter 连接,它使用 my Twitter 登录凭证。
  8. Save 查看您创建的连接现在可用。如果您输入了示例名称,您会看到 Twitter Connect 1 显示为可以添加到集成的连接。

27.3. 添加 Twitter 连接来触发集成执行

在简单的集成中,启动连接可以是 Twitter 连接,它会在找到某些二者或直接消息时触发集成执行。

先决条件

  • 您创建了 Twitter 连接。
  • 您正在创建或编辑简单集成,Fuse Online 会提示您选择启动连接。

流程

  1. 点启动集成的 Twitter 连接。当集成使用所选连接连接到 Twitter 时,Fuse Online 使用该连接中定义的凭证。
  2. 选择您要连接执行的操作。添加到集成中的 Twitter 连接只执行您选择的操作:

    • 提到 monitor Twitter for tweets,其中包含已授权访问的 Twitter 帐户的 Twitter 句柄。在发现此类调整后,连接将其返回到 Fuse Online,这会触发对集成的执行。
    • 检索 定期轮询 Twitter 以定向到 Twitter 连接被授权访问的 Twitter 帐户的信息。在查找此类消息后,连接将它们返回到 Fuse Online,这会触发集成执行。
    • 搜索 定期轮询 Twitter,以获取与您指定的条件匹配的 Teets。在发现此类二十二后,连接将它们返回到 Fuse Online,这会触发对集成的执行。
  3. 配置您选择的操作:

    • 提到 不需要任何配置。
    • retrieve

      • count 的默认值为 100,您不需要更改此值,这会影响内部行为。但是,不要将此值设置为小于 50,因为这样做可能会降低性能。

        Retrieve 操作总是返回过去 30 天内收到的所有未返回直接消息。如果您没有选择 之前找到的 Ignore direct 信息,则 Retrieve 操作会返回最后 30 天内收到的所有消息。

      • delay 是轮询之间的时间周期。Twitter 强制执行速率限值,因此您不应经常轮询。默认间隔为 5 秒。
      • 忽略之前找到的消息 仅在选择时返回新消息。
    • 搜索

      • delay 是轮询之间的时间周期。Twitter 强制执行速率限值,因此您不应经常轮询。默认间隔为 5 秒。
      • 忽略之前发现的十二者 仅在选择时返回新的 tweets。
      • query 是一个 Twitter 格式的搜索表达式,用于指定您希望连接返回的 Teets。下表提供了您可以输入的内容示例。此 Twitter 文档中详细介绍了搜索操作符

        查询

        结果

        我的产品

        获取包含 MyProduct 的二十二者,但不一定是我 的产品

        "My Product”

        获取包含 My Product 实例的 tweets。

        My OR Product

        获取包含 MyProduct 实例或每个实例的 tweets。

        My -Product

        获取包含 My 实例并不包含 产品 实例的 tweets。

        #MyProduct

        获取包含 MyProduct hashtag 的 tweets。

  4. Next 将连接添加到集成。

结果

集成现在有一个启动连接,Fuse Online 会提示您选择完成连接。

27.4. 添加发送直接消息的 Twitter 连接

在流的中间或完成简单集成,您可以添加 Twitter 连接,向 Twitter 用户发送直接消息。直接消息是私有消息,仅发送到指定用户。

先决条件

  • 您创建了 Twitter 连接。
  • 您正在创建或编辑流,Fuse Online 会提示您添加到集成。或者,对于简单集成,Fuse Online 会提示您选择完成连接。

流程

  1. Add to Integration 页面上,单击您要添加 Twitter 连接的加号。
  2. 点击您要添加到集成的 Twitter 连接。当集成使用所选连接连接到 Twitter 时,Fuse Online 使用该连接中定义的凭证。
  3. 选择 Send 操作。
  4. Default Message 字段中,输入您希望连接发送的消息,当数据映射器步骤不会将上一步中的直接消息内容映射到此 Twitter 连接。虽然在配置此 Twitter 连接时必须输入消息,但从上一步中映射的消息优先于您在此处指定的消息。
  5. User 字段中,输入您要向其发送直接消息的用户的 Twitter 处理。例如,Aslan@Aslan 都正确。
  6. Next 将连接添加到集成。

结果

连接会出现在集成视觉化的中间或结束时。

法律通告

Copyright © 2023 Red Hat, Inc.
本文档内容及图解由红帽根据 Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA")授权。有关 CC-BY-SA 的解释,请访问 http://creativecommons.org/licenses/by-sa/3.0/。根据 CC-BY-SA,如果发布本文档或提供此文档,则必须提供原始版本的 URL。
作为本文档的许可者,红帽可能会放弃强制制执行 CC-BY-SA 第4d 条款,且不声明该条款在适用条款允许的最大限度内有效。
Red Hat、Red Hat Enterprise Linux、Shadowman 商标、JBoss、OpenShift、Fedora、Infinity 商标以及 RHCE 都是在美国及其他国家的注册商标。
Linux® 是 Linus Torvalds 在美国和其它国家的注册商标。
Java® 是 Oracle 和/或其附属公司的注册商标。
XFS® 是 Silicon Graphics International Corp. 或其子公司在美国和/或其他国家的商标。
MySQL® 是 MySQL AB 在美国、欧盟和其他国家/地区的注册商标。
Node.js® 是 Joyent 的官方商标。Red Hat Software Collections 与官方 Joyent Node.js 开源或商业项目没有正式关联或被正式认可。
OpenStack® Word Mark 和 OpenStack 标识是 OpenStack Foundation 在美国及其他国家的注册商标/服务标记或商标/服务标记,可根据 OpenStack Foundation 授权使用。我们不附属于 OpenStack Foundation 或 OpenStack 社区。
Amazon Web Services®、AWS 徽标和 DynamoDB 标识的图标是 Amazon.com, Inc. 在美国和/或其他国家/地区的注册商标。
所有其他商标均由其各自所有者所有。