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

Red Hat Fuse 7.11

创建到应用程序和服务的连接

Red Hat Fuse Documentation Team

摘要

按照创建连接并将它们添加到集成的分步说明。

前言

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

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

使开源包含更多

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。我们从这四个术语开始:master、slave、黑名单和白名单。由于此项工作十分艰巨,这些更改将在即将推出的几个发行版本中逐步实施。详情请查看我们的 CTO Chris Wright 信息

第 1 章 Fuse Online 支持的连接器

Fuse Online 支持以下连接器:

名称描述

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.

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 表格中获取数据,添加/更新电子表格数据、创建 chart 或在您指定的电子表格中创建 pivot 表。

HTTP/HTTPS

连接到 HTTP 或 HTTPS 端点,并执行 GETPUTPOSTDELETEHEADOPTIONS、或 PATCH 方法。

IRC

接收发送到 IRC nickname 或频道的消息,或将消息发送到特定频道的 IRC nickname。

Jira

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

kus

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

MongoDB

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

MQTT

从 MQ 遥测传输代理获取信息,或将信息发布到 [...] 代理。

OData

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

REST API

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

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

Salesforce

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

SAP Concur

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

ServiceNow

从服务或将记录复制到 ServiceNow 实例。

Slack

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

SOAP API 客户端

通过上传 WSDL 文件,创建自定义 SOAP API 客户端连接器。然后您可以创建与 SOAP API 客户端的连接。

SQL 数据库

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

Telegram

使用 Telegram chat bot 从聊天或向聊天消息获取消息。

wwitter

在涉及您或包含您指定的数据的情况下触发简单的集成执行。

Webhook

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

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

第 2 章 连接到 Amazon Web Services

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

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

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

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

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

AWS 访问密钥有两个部分:

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

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

如果您需要获取访问密钥,以下过程是实现它的一种方法。

先决条件

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

流程

  1. 进入 https://aws.amazon.com/ 并登录到控制台。
  2. 在控制台的右上角,单击用户名旁边的下箭头,然后单击 My Security Credentials
  3. 在弹出对话框中,点 IAM 用户入门

    如果没有显示具有此按钮的弹出窗口,则在左侧,单击 用户

  4. 添加用户:

    1. Add User
    2. 输入用户名并选择 Programmatic Access
    3. Next: Permissions
    4. 响应,以向组群添加新用户。
    5. Next: Tags
    6. 跳过添加标签并点击 Next: Review
    7. 单击 创建用户
  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 字段中,在 AWS 帐户中输入 Amazon 访问密钥 ID,该 ID 是管理您要连接访问的 DynamoDB 表的用户访问密钥。
  5. Secret Key 字段中,为您指定的 Amazon 访问密钥 ID 输入 Amazon secret 访问密钥。
  6. Region 字段中,选择 DynamoDB 表所在的 AWS 区域。
  7. Table Name 字段中输入您希望此连接才能访问的 DynamoDB 表的名称。
  8. 单击 Validate。Fuse Online 立即尝试验证连接并显示一条消息,指示验证是否成功。如果验证失败,请根据需要修改配置详情并重试。
  9. 验证成功后,单击 下一步
  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 a action 页面中,选择 Query 操作。
  4. Filter 字段中,指定用于标识连接应该返回的项目的键属性的 JSON 表示法。您可以使用 :# 指定输入参数。例如,若要获取含有两个关键属性的项目,规格可能如下:

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

    key1,key2,attribute3,attribute4,attribute5

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

  6. 点击 Next

结果

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

后续步骤

如果在 Filter 字段中指定了占位符参数,请在这个连接前添加一个 data mapper 步骤。在 data mapper 步骤中,将源字段映射到 DynamoDB 连接中的目标占位符字段。

2.2.3. 在 Amazon DynamoDB 表中添加数据

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

注意

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

先决条件

  • 您创建了 Amazon DynamoDB 连接。
  • 您需要创建或编辑简单的集成和 Fuse Online,提示您添加至集成或选择完成连接。

流程

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

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

结果

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

后续步骤

如果您在项目的 JSON 定义中指定占位符参数,请在这个连接前添加一个 data mapper 步骤。在 data mapper 步骤中,将源字段映射到 DynamoDB 连接中的目标占位符字段。

2.2.4. 从 Amazon DynamoDB 表中删除数据

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

先决条件

  • 您创建了 Amazon DynamoDB 连接。
  • 您需要创建或编辑简单的集成和 Fuse Online,提示您添加至集成或选择完成连接。

流程

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

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

结果

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

后续步骤

如果您在 element 字段的 JSON 过滤器 中指定占位符参数,请在这个连接前添加一个 data mapper 步骤。在 data mapper 步骤中,将源字段映射到 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 帐户中输入属于用户访问密钥的 Amazon 访问密钥 ID,该 ID 管理您希望连接发送到的主题。

    如果您要连接访问的主题尚不存在,当 Fuse Online 尝试运行集成时,它使用与此访问密钥关联的 AWS 帐户来创建该主题。但是,如果其他 AWS 帐户中存在主题,则连接无法创建主题,且集成无法启动。

  5. Secret Key 字段中,为您指定的 Amazon 访问密钥 ID 输入 Amazon secret 访问密钥。
  6. Region 字段中,选择主题所在的 AWS 区域。如果连接创建了主题,它会在所选区域中创建它。
  7. 单击 Validate。Fuse Online 立即尝试验证连接并显示一条消息,指示验证是否成功。如果验证失败,请根据需要修改配置详情并重试。
  8. 验证成功后,单击 下一步
  9. Name 字段中输入您的选择的名称,帮助您将这个连接与任何其他连接区分开来。例如,输入 SNS North
  10. Description 字段中输入任何有助于了解这个连接的信息。例如,输入 向 north region topic 发送消息的 Sample SNS 连接。
  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)。

    如果 SNS 主题还不存在在连接被授权访问的 AWS 帐户中,或者任何其他 AWS 帐户中,连接会在要访问的 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. 验证成功后,单击 下一步
  9. Name 字段中输入您的选择的名称,帮助您将这个连接与任何其他连接区分开来。例如,输入 SQS South
  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 a action 页面上,选择 Poll a Amazon SQS Queue 以定期从 SQS 队列检索消息。
  5. 配置此操作:

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

      要对可以获取的信息数量没有限制,请指定 0 或一个负整数。当 Maximum Objects to Retrieve 为无限时,Pol poll 操作会获取 SQS 队列中的所有消息。

    3. Queue Name 或 Amazon Resource Name 字段中,指定要从检索消息的 SQS 队列的名称,或者指定队列的 ARN。如果具有此名称的队列不存在,连接会创建它。这是唯一必填字段。
    4. 指明您是否要 获取消息,然后从队列 中删除它们。获取消息,然后从队列中删除它们是默认行为。只有您希望连接检索信息并在队列中保留它们时,取消选择此选项。这意味着将再次检索消息。
    5. 如果消息通过 Camel 过滤器,指明是否希望获取消息并删除 消息。默认选择这个选项。当您要传递通过过滤器的消息,以确定是否将其从队列中删除时,请保留该消息。您不需要取消选择 Obtain 信息,然后从队列 中删除。Fuse Online 可确保在选择 Obtain 消息时正确的行为,如果通过 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 strategy 字段中,在 first-in, first-out(FIFO)队列中,接受 ConstantMessageGroupIdStrategy,或者点击字段中的项并选择不同的策略。

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

    • ConstantMessageGroupIdStrategy the connection使用恒定分组消息。
    • ExchangeIdMessageGroupIdStrategy the connection 使用交换 ID(在每条消息中)对消息进行分组。
    • PropertyValueMessageGroupIdStrategy InventoryService-abrtThe connection 使用 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 Resource Name(ARN)。

流程

  1. 在 Fuse Online 中,在左侧面板中,单击 Connections 以显示任何可用的连接。
  2. 单击 Create Connection 以显示 Fuse Online 连接器。
  3. Amazon S3 连接器。
  4. Access Key 字段中,在 AWS 帐户中输入 Amazon 访问密钥 ID,该 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. 验证成功后,单击 下一步
  10. Name 字段中输入您的选择的名称,帮助您将这个连接与任何其他连接区分开来。例如,输入 Obtain S3 Data
  11. Description 字段中输入任何有助于了解这个连接的信息。例如,输入 来自 northeast 存储桶的数据的 Sample S3 连接。
  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 a action 页面中,选择您要连接执行的操作:

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

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

        要对可获取的文件数没有限制,请指定 0 或一个负整数。当 Maximum Objects to Retrieve 为无限时,poll 操作会获取存储桶中的所有文件。

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

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

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

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

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

    当您创建或编辑使用您要为其指定此类型的连接的集成时,您将看到此数据类型名称。Fuse Online 在集成视觉化和 data mapper 中显示类型名称。

  9. Data Type Description 字段中,提供可帮助您区分此类型的信息。当您将鼠标悬停在处理此类型的步骤上时,这个描述会出现在 data mapper 中。
  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 action 只添加从 poll 操作接收的最后一个文件。

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

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

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

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

    当您创建或编辑使用您要为其指定此类型的连接的集成时,您将看到此数据类型名称。Fuse Online 在集成视觉化和 data mapper 中显示类型名称。

  7. Data Type Description 字段中,提供可帮助您区分此类型的信息。当您将鼠标悬停在处理此类型的步骤上时,这个描述会出现在 data mapper 中。
  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 action 只添加从 poll 操作接收的最后一个文件。

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

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

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

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

    当您创建或编辑使用您要为其指定此类型的连接的集成时,您将看到此数据类型名称。Fuse Online 在集成视觉化和 data mapper 中显示类型名称。

  8. Data Type Description 字段中,提供可帮助您区分此类型的信息。当您将鼠标悬停在处理此类型的步骤上时,这个描述会出现在 data mapper 中。
  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 字段中,粘贴 Red Hat 客户端的 PEM 证书文本。此字段中的内容始终是可选的。
  5. 单击 Validate。Fuse Online 立即尝试验证连接并显示一条消息,指示验证是否成功。如果验证失败,请根据需要修改配置详情并重试。
  6. 如果验证成功,点 下一步
  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 a action 页面上,选择 Subscribe for messages action 以接收来自您指定的队列或主题的消息。
  5. 配置操作:

    1. Destination name 字段中,输入要从中接收数据的队列或主题的名称。
    2. 对于 Destination 类型,接受 Queue 或选择 Topic
    3. Durable 订阅 ID 字段中,要允许连接在没有缺失消息的情况下关闭并重新打开,请输入 durable 订阅 ID。目标类型必须是主题。
    4. Message selector 字段中,如果您想要只接收满足特定条件的数据,请输入过滤器表达式。

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

      NewsType = 'Sports' or NewsType = 'Opinion'

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

  6. Next 指定操作的输出类型。
  7. Select Type 字段中,如果数据类型不需要已知,接受 类型规格不需要,然后单击 Next。您不需要遵循其中一些说明的其余部分。

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

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

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

    当您创建或编辑使用您要为其指定此类型的连接的集成时,您将看到此数据类型名称。Fuse Online 在集成视觉化和 data mapper 中显示类型名称。

  10. Data Type Description 字段中,提供可帮助您区分此类型的信息。当您将鼠标悬停在处理此类型的步骤上时,这个描述会出现在 data mapper 中。
  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 a action 页面上,选择 Publish 消息 操作,以将消息发布到您指定的队列或主题。
  3. Destination name 字段中输入要发送消息的队列或主题的名称。
  4. 对于 Destination 类型,接受 Queue 或选择 Topic
  5. 选择 Persistent 来确保消息交付,即使连接失败。
  6. Next 指定操作的输入/输出类型。
  7. Select Type 字段中,如果数据类型不需要已知,接受 类型规格不需要,然后单击 Next。您不需要遵循其中一些说明的其余部分。

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

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

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

    当您创建或编辑使用您要为其指定此类型的连接的集成时,您将看到此数据类型名称。Fuse Online 在集成视觉化和 data mapper 中显示类型名称。

  10. Data Type Description 字段中,提供可帮助您区分此类型的信息。当您将鼠标悬停在处理此类型的步骤上时,这个描述会出现在 data mapper 中。
  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 a action 页面中,选择以下操作之一:

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

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

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

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

        NewsType = 'Sports' or NewsType = 'Opinion'

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

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

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

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

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

    当您创建或编辑使用您要为其指定此类型的连接的集成时,您将看到此数据类型名称。Fuse Online 在集成视觉化和 data mapper 中显示类型名称。

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

结果

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

第 4 章 连接到 AMQP

在集成中,您可以从集成中获取信息或发布消息到 Advanced Message Queue Protocol(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 管理和监控代理,添加客户端连接点。有关指定配置值的详情,请参考 Red Hat JBoss A-MQ Connection Reference、高级消息队列协议(AMQP)

要使用 AMQP 连接器,请查看:

4.1. 创建 AMQP 连接

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

先决条件

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

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

流程

  1. 在 Fuse Online 中,在左侧面板中,单击 Connections 以显示任何可用的连接。
  2. 点击 Create Connection 以显示连接器。
  3. 点击 AMQP 消息代理 连接器。
  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. 如果验证成功,点 下一步
  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 a action 页面上,选择 Subscribe for messages action 以接收来自您指定的队列或主题的消息。
  3. 配置操作:

    1. Destination name 字段中,输入要从中接收数据的队列或主题的名称。
    2. 对于 Destination 类型,接受 Queue 或选择 Topic
    3. Durable 订阅 ID 字段中,要允许连接在没有缺失消息的情况下关闭并重新打开,请输入 durable 订阅 ID。目标类型必须是主题。
    4. Message selector 字段中,如果您想要只接收满足特定条件的数据,请输入过滤器表达式。

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

      NewsType = 'Sports' or NewsType = 'Opinion'

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

  4. Next 指定操作的输出类型。
  5. Select Type 字段中,如果数据类型不需要已知,接受 类型规格不需要,然后单击 Next。您不需要遵循其中一些说明的其余部分。

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

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

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

    当您创建或编辑使用您要为其指定此类型的连接的集成时,您将看到此数据类型名称。Fuse Online 在集成视觉化和 data mapper 中显示类型名称。

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

结果

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

4.3. 在流的中间将消息发布到 AMQP 或完成集成

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

先决条件

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

流程

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

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

      1. Destination name 字段中输入要发送消息的队列或主题的名称。
      2. 对于 Destination 类型,接受 Queue 或选择 Topic
      3. 选择 Persistent 来确保消息交付,即使连接失败。
    • 使用消息 将消息发布到您指定的队列或主题来请求响应。

      注意

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

      配置这个操作:

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

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

        NewsType = 'Sports' or NewsType = 'Opinion'

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

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

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

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

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

    当您创建或编辑使用您要为其指定此类型的连接的集成时,您将看到此数据类型名称。Fuse Online 在集成视觉化和 data mapper 中显示类型名称。

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

结果

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

第 5 章 连接到 API 客户端

在集成中,要连接到 REST 或 SOAP API,您必须已为该 API 创建连接器。请参阅 将应用程序与 Fuse Online 集成,添加和管理 API 客户端连接器

当您要连接的 API 的连接器包括在 Fuse Online 中时,连接到该 API 的步骤有:

5.1. 将 Fuse Online 注册为 REST API 客户端

在 Fuse Online 创建 REST API 客户端连接器前,它会提示您指示 API 的安全要求。对于使用 OAuth 协议的 API,当 Fuse Online 创建连接器时,它还会在 Fuse Online Settings 页面中添加 API 的条目。这是您提供 API 客户端 ID 以及授权 Fuse Online 访问 API 的 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,该 URL 在此流程开始时进行复制。
    2. 响应需要输入的任何其他提示。
    3. 获取 API 服务向您的 Fuse 在线环境分配的客户端 ID 和客户端 secret。
  3. 返回到您注册并执行以下操作的 API 服务的 Fuse Online Settings 页面条目:

    1. 粘贴分配的客户端 ID。
    2. 粘贴分配的客户端 secret。
    3. 点击 Save

5.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 键的输入字段,您必须从 API 服务获取该输入。

  5. 单击 Validate。Fuse 在线验证连接参数。例如,它会检查有效的 host/address URL。
  6. 点击 Next
  7. Name 连接 页面中:

    1. Name 字段中输入您的选择的名称,帮助您将这个连接与任何其他连接区分开来。
    2. Description 字段中输入任何有助于了解这个连接的信息。
    3. 点击 Save。现在,您可以选择您创建的连接并将其添加到集成中。

5.3. 创建 SOAP API 客户端连接

在集成中,要连接到 SOAP API,请创建一个与 SOAP API 的连接,然后添加到任意数量的集成中。

前提条件

  • 您为您要连接的 SOAP API 创建连接器。

流程

  1. 在 Fuse Online 中,在左侧面板中,单击 Connections 以显示任何可用的连接。
  2. 单击 Create Connection 以显示可用的连接器。
  3. 点您要为其创建连接的 API 的连接器。
  4. 在配置页面中,提供请求的信息。API 的定义决定了 Fuse 在线提示的内容。
  5. 在连接配置页面中:

    1. 接受或编辑 SOAP 端点地址。
    2. 选择调用 WSDL 端点时要使用的身份验证类型(None、基础或 WS-Security Username Token)。对于基本身份验证,支持 HTTPS。通常,API 服务具有安全要求,Fuse Online 提示根据 WSDL 文件定义的特定安全类型进行安全输入。

      注意: 不支持 SAML。

    3. 选择 WS-Security 密码类型(、文本或 Digest)。
    4. 指定 用户名和密码
    5. 如果您希望 Fuse Online 添加时间戳到 WS-Security 标头,请选择 Timestamp
    6. 如果您希望 Fuse Online 添加 Nonce 元素到 WS-Security Username Token 标头,请选择 Username Token Nonce。对于 Username 令牌配置集,支持 text 和 Digest 密码。

      有关如何在 Web Services Security(WSS)规格中使用 UsernameToken 的详情请参考 这个 OASIS 文档

    7. 如果您希望 Fuse Online 添加 timestamp 元素到 WS-Security Username Token 标头,请选择 Username Token Created

      注意: 由于缺少 OASIS/W3C 标准来验证与 SOAP 端点的连接,SOAP 连接器不支持验证。

  6. 点击 Next
  7. Name 连接 页面中:

    1. Name 字段中输入您的选择的名称,帮助您将这个连接与任何其他连接区分开来。
    2. Description 字段中输入任何有助于了解这个连接的信息。
    3. 点击 Save。现在,您可以选择您创建的连接并将其添加到集成中。

5.4. 在集成中添加 API 客户端连接

在集成中,要连接到 REST 或 SOAP API,请添加连接到该 API 的步骤。

在本发行版本中,与 REST 或 SOAP API 的连接可以是流中中间的某个步骤,或者在简单的集成中是完成的连接。换句话说,与 REST 或 SOAP API 的连接不能是一个启动连接。

先决条件

  • 您创建了与 REST 或 SOAP API 的连接。
  • 正在创建或编辑一个流。
  • 流已具有其启动连接。
  • Fuse Online 正在提示您选择完成连接或添加到集成。

流程

  1. Add to Integration 页面中,点您要添加连接的加号。如果 Fuse Online 提示您选择完成连接,请跳过这一步。
  2. 在显示可用步骤的页面中,点击您要添加到流的 API 连接。
  3. 选择您要连接执行的操作。可用的操作基于 OpenAPI 文档或 WSDL 文件中指定的资源操作,这些文件已上传到 Fuse Online,这描述了您要连接的 API。
  4. 根据您选择的操作,输入 Fuse Online 提示提供的任何参数。
  5. 点击 Next

结果

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

第 6 章 连接到 Box

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

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

以下主题提供详情:

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

您必须将 Fuse Online 环境注册为可以访问 Box 的客户端应用程序。这可让您创建连接到 Box 的任何数量集成。换而言之,您只需要使用 Box 注册特定的 Fuse Online 环境。

在每个 Fuse 在线环境中,只能有一个 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,然后 下一步
    4. 对于 身份验证方法,请点 Standard OAuth 2.0(User Authentication),然后 下一步
    5. 输入应用程序名称,如 Fuse Online Client,然后点 Create App
    6. View Your App
    7. 可选。在 OAuth 2.0 Credentials 部分中,将客户端 ID 和客户端 secret 复制到安全的位置。创建与 Box 的连接需要这些值。
    8. 点击 Save Changes

结果

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

6.2. 创建 Box 连接

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

先决条件

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

流程

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

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

    1. Connections
    2. Create Connection
    3. 单击 Box 连接器。
    4. User name 字段中,输入您想要此连接的 Box 帐户的用户名,以下载或上传 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. 验证成功后,单击 下一步
  7. Name 字段中输入您的选择的名称,帮助您将这个连接与任何其他连接区分开来。例如,输入 Box Sales Account
  8. Description 字段中输入任何有助于了解这个连接的信息。例如,输入 可访问我们公司销售Box 帐户中的内容的 Sample Box 连接。
  9. Save 以查看您创建的连接现在可用。如果您输入了示例名称,您会看到 Box Sales Account 显示为可选择添加到集成的连接。

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

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

先决条件

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

流程

  1. Add to Integration 页面中,点您要添加连接的加号。
  2. 点您要使用集成的 Box 连接。
  3. 在 Choose a 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 文件夹 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

结果

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

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

要通过将文件上传到 Box 来完成集成,请添加 Box 连接,作为集成完成连接。

先决条件

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

流程

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

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

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

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

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

结果

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

第 7 章 连接到 Dropbox

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

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

您必须将 Fuse Online 环境注册为可以访问 Dropbox 的客户端应用程序。这可让您创建连接到 Dropbox 的任何数量集成。换而言之,您只需要使用 Dropbox 注册特定的 Fuse Online 环境。

在每个 Fuse 在线环境中,只能有一个将 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 URIs 的输入字段中粘贴您的 Fuse Online URL,这将您在此流程开始时复制到剪贴板。
    11. 点击 Add

结果

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

7.2. 创建 Dropbox 连接

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

前提条件

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

流程

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

    1. 登录 Dropbox 帐户,在其中创建了注册从 Fuse Online 环境访问的应用程序。
    2. 请访问 https://www.dropbox.com/developers/apps
    3. 单击 Fuse Online app 以显示其设置。
  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. 验证成功后,单击 下一步
  8. Name 字段中输入您的选择的名称,帮助您将这个连接与任何其他连接区分开来。例如,输入 Dropbox Connect 1
  9. Description 字段中输入任何有助于了解这个连接的信息。例如,输入 Sample Dropbox 连接以访问公司 Dropbox 帐户中的所有内容。
  10. Save 以查看您创建的连接现在可用。如果您输入了示例名称,您会看到 Dropbox Connect 1 显示为可选择添加到集成的连接。

7.3. 从 Dropbox 获取文件来触发集成执行

要通过从 Dropbox 下载文件来启动集成,请将 Dropbox 连接添加为启动连接。

前提条件

您创建了 Dropbox 连接。

流程

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

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

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

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

    当您创建或编辑使用您要为其指定此类型的连接的集成时,您将看到此数据类型名称。Fuse Online 在集成视觉化和 data mapper 中显示类型名称。

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

结果

这个连接启动简单的集成,Fuse Online 提示您选择完成连接。

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

要通过将文件上传到 Dropbox 来完成集成,请添加 Dropbox 连接,作为集成的完成连接。

先决条件

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

流程

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

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

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

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

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

    当您创建或编辑使用您要为其指定此类型的连接的集成时,您将看到此数据类型名称。Fuse Online 在集成视觉化和 data mapper 中显示类型名称。

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

结果

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

7.5. 在集成中访问 Dropbox

要将文件上传到网络流中间的 Dropbox,请向流的中间添加 Dropbox 连接。

先决条件

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

流程

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

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

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

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

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

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

    当您创建或编辑使用您要为其指定此类型的连接的集成时,您将看到此数据类型名称。Fuse Online 在集成视觉化和 data mapper 中显示类型名称。

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

结果

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

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

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

详情请查看:

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

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

先决条件

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

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

流程

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

    1. Protocol 字段中,接受 imagePullPolicy 或选择 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. 验证成功后,单击 下一步
  7. Name 字段中输入您的选择的名称,帮助您将这个连接与任何其他连接区分开来。例如,输入 Obtain Info 电子邮件
  8. Description 字段中输入任何有助于了解这个连接的信息。例如,输入 Connect to us company email server 以获取发送到 info@ourcompany.com 的信息。
  9. Save 以查看您创建的连接现在可用。如果您输入了示例名称,您会看到 Obtain Info Emails 显示为您可以选择添加到集成的连接。

8.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. 验证成功后,单击 下一步
  7. Name 字段中输入您的选择的名称,帮助您将这个连接与任何其他连接区分开来。例如,输入 Send Emails to Leads
  8. Description 字段中输入任何有助于了解这个连接的信息。例如,输入 Connect to us company email server 以发送来自 info@ourcompany.com 的信息。
  9. Save 以查看您创建的连接现在可用。如果您输入了示例名称,您会看到 将电子邮件发送到潜在用户 的连接,您可以选择添加到集成中。

8.3. 获取用于触发集成执行的电子邮件

要在接收电子邮件时触发集成的执行,请将 IMAP 或 POP3 电子邮件服务器连接作为简单的集成开始连接。

先决条件

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

流程

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

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

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

    2. 选择 Unseen Only 复选框,以只获取标记为 unread on the email server 的信息。
    3. Delay 字段中,接受默认值 5 秒,作为邮件轮询之间的时间。或者,要指定不同的轮询间隔,请输入一个数字并选择其单位。
    4. Maximum Emails 字段中,输入一个轮询操作可以返回的最大消息数。默认值为 5。如果 inbox 或 文件夹包含最多可以返回的消息数,连接会将最旧的消息返回到为 Maximum Emails 设置的数字。

      如果您希望每次轮询来获取时将 Maximum Emails 设置为 -1

      • 仅选择 Unseen Only 时,指定文件夹中的所有新消息。
      • 只读时,指定 文件夹中的所有消息都 不会被选择。
  6. 点击 Next

结果

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

示例

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

  • Folder 字段为空,因此连接轮询收件箱。
  • 唯一唯一 将被选择。
  • Delay (5 秒)和 最大电子邮件 (5)的默认值被接受。

假设 10 消息在下一次轮询前会延迟到收件箱中。连接返回 5 个最旧的消息。在下一个轮询后 5 秒,连接会返回其他 5 信息。即使新消息到达,这种情况也是如此,因为连接会返回最旧的消息(如果为 Maximum Emails 设置的编号超过最大电子邮件设置的消息)。

8.4. 从集成发送电子邮件

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

先决条件

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

流程

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

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

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

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

  7. Next 将连接添加到流。

结果

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

后续步骤

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

第 9 章 连接到 FHIR

Fast healthcare Interoperability Interoperability Resources(FHIR)是不断变化的医疗数据标准。在集成中,您可以获取一个或多个 FHIR 资源,创建或更新资源,更新资源中的一个或者多个字段,或使用事务来创建多个资源。为此,请将 FHIR 连接添加到流中,或作为简单的集成完成连接。

Fuse 在线连接至 FHIR:

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

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

连接到 FHIR 的详情,请参考以下主题:

9.1. 创建与 FHIR 服务器的连接

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

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

先决条件

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

流程

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

    1. FHIR 版本 字段中,接受 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. 如果验证成功,点 下一步
  6. Name 字段中输入您的选择的名称,帮助您将这个连接与任何其他连接区分开来。例如,您可以输入 FHIR West
  7. Description 字段中输入任何有助于了解这个连接的信息。
  8. Save 以查看您创建的连接现在可用。如果您输入了示例名称,则 FHIR West 看作为一个可选择添加到集成的连接。

9.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 字段,请在连接前添加数据映射程序步骤。

9.3. 为资源查询 FHIR 服务器

在集成中,您可以查询 FHIR 服务器以获取满足您指定的查询的特定 FHIR 资源实例。例如,假设您想确保 65 和更老的病人收到了一个负负的 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 将这个列表视为一个集合。

后续步骤

如果您没有指定查询,请在连接前添加 data mapper 步骤,并将查询映射到此连接。要在各个返回的资源上运行,而不是在此连接后返回的列表集合,请将拆分步骤添加到流程中。

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

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

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

当连接执行 Create 操作以在 FHIR 服务器上创建新资源时,新资源会自动生成 FHIR 资源 ID。如果要为新资源指定资源 ID,而不是选择 Create 操作来选择 要执行的操作的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 连接创建新资源之前,在流中添加数据映射步骤。在 data mapper 步骤中,映射到要创建的资源中的字段。

小心

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

9.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. 在 data mapper 中:

    1. 将资源 ID 映射到目标资源 ID。这是为新资源指定资源 ID 的唯一方法。
    2. 映射到您希望更新或新资源包含的每个资源字段。务必映射那些值没有更改的字段,以及需要更新值的字段。
    3. 点击 完成 将 data mapper 步骤添加到流程中。

结果

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

9.6. 在 FHIR 服务器中更新资源中的指定字段

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

先决条件

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

流程

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

    Patient 资源的补丁示例

    active 字段设置为 true

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

    替换 name 字段的值,这是患者名称的数组。在本例中,Home 有一个名称。如果病人有多个名称,类似格式化的补丁可能会替换所有最终用户的名称:

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

    替换患者的指定名称:

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

    在第一个名称前为 patient 添加另一个名称:

    [{ "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 操作时,您可以指定要更新的字段数量。data mapper 在 Target 面板中显示这个文件夹数量。例如,如果将 3 指定为要更新的字段数目,您将看到三个带有标签 123 和 3 的目标文件夹。

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

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

结果

这个连接会出现在您添加的集成视觉化中。在执行过程中,连接会更新指定的资源字段并返回包括 id.idPart 字段的 MethodOutcome 资源。此字段包含所更新的资源的 ID。

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

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

先决条件

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

流程

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

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

结果

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

9.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 字段,请在连接前添加数据映射程序步骤。

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

在集成中,您可以连接到 FTP 或 SFTP 服务器来下载或上传文件。要做到这一点,创建一个 FTP 或 SFTP 连接,然后将其添加到集成流中。

对于集成中的第一步,您可以下载使用 Apache Camel 文件语言表达式定义的文件。

对于集成中的中间或最后一个步骤,您可以上传您用 Apache Camel 文件语言表达式定义的文件。对于 FTP 服务器,您还可下载或上传一个指定的文件(集成中的前一步中提供了文件的名称)。

以下主题提供详情:

10.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
      • 端口 的默认值为 22。这是 SFTP 服务器侦听的端口。
      • 用于访问 SFTP 服务器的 帐户的用户名
      • 与这个用户名关联的密码。
      • 所有其他参数都具有默认值。默认值适用于大多数集成。这些参数的描述在此流程后。
  5. 单击 Validate。Fuse Online 立即尝试验证连接并显示一条消息,指示验证是否成功。如果验证失败,请根据需要修改配置详情并重试。
  6. 验证成功后,单击 下一步
  7. Name 字段中输入您的选择的名称,帮助您将这个连接与任何其他连接区分开来。例如,输入 XLight FTP Server
  8. Description 字段中输入任何有助于了解这个连接的信息。
  9. Save 以查看您创建的连接现在可用。如果您输入了示例名称,您会看到 XLight FTP Server 显示为可选择添加到集成的连接。

其他参数的描述

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

10.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 表达式 字段中,键入指定 要下载的文件或文件的 Apache Camel 文件语言 表达式。(注意您无法指定正则表达式。)

    例如,您可以过滤从 FTP 服务器中具有特定扩展名的所有文件。以下示例指定 .doc 扩展的所有文件:

    '${file:onlyname.noext}.doc'

    如果要下载 FTP 目录中的所有文件,请将" 文件名表达式 "字段留空。

    在运行时,连接轮询(句点检查)服务器用于文件或文件,并在找到时下载它们。

  6. FTP 目录 字段中,输入要轮询的服务器目录的绝对或相对路径。这个连接会监视这个目录,并在找到所有内容时下载所有文件。
  7. 轮询启动字段前的 Milliseconds 中,接受默认的 1000 毫秒或更改毫秒的数量。
  8. 在下一个 poll 字段前的 Milliseconds,接受默认的 500 毫秒,或更改毫秒的数量。这是轮询间隔。
  9. Delete after download 字段中,接受默认值 No 或选择 Yes 来下载文件,然后从服务器中删除该文件。
  10. Next 指定操作的输出类型。
  11. Select Type 字段中,如果数据类型不需要已知,接受 类型规格不需要,然后单击 Next。您不需要遵循其中一些说明的其余部分。

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

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

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

    当您创建或编辑使用您要为其指定此类型的连接的集成时,您将看到此数据类型名称。Fuse Online 在集成视觉化和 data mapper 中显示类型名称。

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

结果

连接会出现在集成视觉化开始时。

10.3. 从 FTP 服务器获取指定用户文件

在集成中,您可以从流程中间的 FTP 服务器下载特定文件,或完成简单的集成。要做到这一点,请将 FTP 连接添加到流中,或作为简单的集成完成连接。

先决条件

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

流程

  1. Add to Integration 页面中,点您要添加连接的加号。如果 Fuse Online 提示您选择完成连接,请跳过这一步。
  2. 点击您要下载文件的 FTP 连接。
  3. Choose an action 页面中,选择 DownloadNamedFile
  4. Delete after download 字段中,接受默认值 No 或选择 Yes 以下载该文件,然后从服务器中删除该文件。
  5. FTP 目录 字段中,输入服务器目录的绝对或相对名称。在运行时,连接会监视该目录的命名文件并在找到时下载它。
  6. 点击 Next

结果

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

10.4. 将文件上传到 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 表达式 字段中,键入指定要上传的文件或文件的 Apache Camel 文件语言 表达式。(注意您无法指定正则表达式。)

    例如,您可以过滤从 FTP 服务器中具有特定扩展名的所有文件。以下示例指定 .doc 扩展的所有文件:

    '${file:onlyname.noext}.doc'

    如果要上传 FTP 目录中的所有文件,请将" 文件名表达式 "字段留空。

  5. FTP 目录 字段中,输入服务器目录的绝对或相对名称。如果 File name 表达式 字段包含一个表达式,则连接会将指定的文件存储在此目录中。如果 File name 表达式 字段为空,则连接将上传到此目录,以及从上一步中收到的所有文件。
  6. if file exists 字段中,表示当您上传名称与服务器中具有相同路径的文件时的行为。接受默认 覆盖,以使用您要上传的文件覆盖服务器中的文件。或者,选择以下内容之一:

    • 附加 将上传到服务器上的文件中的内容添加。
    • fail 引发 GenericFileOperationException.集成不会进入错误状态。
    • 忽略 不上传文件。集成在假设一切正常的情况下继续运行。
    • 移动 重命名其中一个文件。
    • TryRename 使用临时名称上传文件,并将该文件重命名为所需的名称。此操作不会检查是否存在具有所需名称的文件,这比存在性检查时,大多数服务器上操作比存在性检查更快。
  7. 复制字段时,在 Temporary 文件前缀 中指定字符串。连接在上传时将这个字符串添加到文件的名称中。这可让连接写入服务器上的临时文件,然后重命名该临时文件具有正确名称。这有助于在上传非常大的文件时减少锁定。
  8. 复制字段时,在 Temporary 文件名 中指定字符串。在上传时,连接重命名为具有此名称的文件。这可让连接写入服务器上的临时文件,然后重命名该临时文件具有正确名称。这有助于在上传非常大的文件时减少锁定。
  9. Next 指定操作的输入类型。
  10. Select Type 字段中,如果数据类型不需要已知,接受 类型规格不需要,然后单击 Next。您不需要遵循其中一些说明的其余部分。

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

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

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

    当您创建或编辑使用您要为其指定此类型的连接的集成时,您将看到此数据类型名称。Fuse Online 在集成视觉化和 data mapper 中显示类型名称。

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

结果

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

10.5. 上传指定文件到 FTP 服务器

在集成中,您可以在流的中间上传特定文件到 FTP 服务器,或者完成简单的集成。要做到这一点,请将 FTP 连接添加到流中,或作为简单的集成完成连接。

先决条件

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

流程

  1. Add to Integration 页面中,点您要添加连接的加号。如果 Fuse Online 提示您选择完成连接,请跳过这一步。
  2. 点击您要用来上传文件的 FTP 连接。
  3. Choose an action 页面中,选择 UploadNamedFile
  4. FTP 目录 字段中,输入服务器目录的绝对或相对名称。在运行时,连接将命名的文件(从上一步中接收)上传到此目录。
  5. if file exists 字段中,表示当您上传名称与服务器中具有相同路径的文件时的行为。接受默认 覆盖,以使用您要上传的文件覆盖服务器中的文件。或者,选择以下内容之一:

    • 附加 将上传到服务器上的文件中的内容添加。
    • fail 引发 GenericFileOperationException.集成不会进入错误状态。
    • 忽略 不上传文件。集成在假设一切正常的情况下继续运行。
    • 移动 重命名其中一个文件。
    • TryRename 使用临时名称上传文件,并将该文件重命名为所需的名称。此操作不会检查是否存在具有所需名称的文件,这比存在性检查时,大多数服务器上操作比存在性检查更快。
  6. 复制字段时,在 Temporary 文件前缀 中指定字符串。连接在上传时将这个字符串添加到文件的名称中。这可让连接写入服务器上的临时文件,然后重命名该临时文件具有正确名称。这有助于在上传非常大的文件时减少锁定。
  7. 复制字段时,在 Temporary 文件名 中指定字符串。在上传时,连接重命名为具有此名称的文件。这可让连接写入服务器上的临时文件,然后重命名该临时文件具有正确名称。这有助于在上传非常大的文件时减少锁定。
  8. 点击 Next

结果

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

第 11 章 连接到 Google 应用程序

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

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

在集成中,要连接到 Gmail、Google Calendar 或 Google Sheets,您必须将 Fuse 在线环境注册为 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 Online 客户端应用使用凭据。在 Fuse Online 中,与 Gmail、Google Calendar 和 Google Sheets 的连接都可以使用相同的 Google 客户端 ID 和 Google 客户端 secret。如果这样做,刷新令牌适用于所有连接到 Google 应用程序。当您在 Fuse Online 用户界面中查看连接详情时,不要单击 Validate 按钮。验证是凭证的第二个使用,刷新令牌不再是客户端凭证的一部分。但是,您可以重新连接到 Google 应用程序。

在开发环境中,如果您选择使用 Google 客户端 ID 和 Google 客户端 secret,请小心使用,而不是使用在线 OAuth 客户端。Fuse Online 需要在第一次 OAuth 交换上请求的离线访问。如果另一个 OAuth 客户端已经进入 OAuth Exchange,且没有请求离线访问,则 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. 检查您是否已注册到 Google 帐户,该帐户将使用 将 Fuse Online 注册为 Google 客户端应用程序。或者,选择其他 Google 帐户并登录到该帐户。

      当前 Google 项目的名称将显示在 Google API 页面的顶部。

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

      1. 在左上角,点 Navigation menu icon ,然后选择 API 和 Services > Library
      2. 如有必要,向下滚动以查看卡的 Google Workspace 行。
      3. Google API 卡(CalendarGmailSheets)。

        Google API 的摘要页面将打开。

      4. 单击 启用。Google 启用 API 并打开 API 概述页面。
      5. 向下滚动并单击 Gmail API 卡,它会显示页面,其中指出启用了 Gmail API。
    4. 为您的客户端应用程序指定一个名称:

      1. 在 API 概述页面中,在左侧导航面板中,单击 Credentials,然后单击 Configure Consent Screen

        此时会出现 OAuth 批准屏幕

      2. Application Name 字段中,选择 External

        注: 如果您是一个 Google Workspace 用户,则可以选择 Internal

      3. Create
      4. 键入 Fuse Online 客户端应用程序的名称。例如,键入 Fuse Online 客户端应用程序
      5. 跳过其他字段。
      6. 单击 Save,再继续
      7. ScopesTest Users 页面中,跳过选项,点 Save 并开始
    5. 获取客户端应用程序凭证,如下所示:

      1. Create Credentials 右侧,单击下箭头以显示菜单,然后选择 OAuth 客户端 ID
      2. 在出现的页面中,在 应用程序类型 中选择 Web 应用程序
      3. Name 字段中,为您的 Fuse 在线环境输入 OAuth 客户端 ID 的名称。这与您为客户端应用程序本身输入的名称不同。例如,为 Fuse 在线键入 OAuth 客户端 ID
      4. 跳过 授权 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 连接的每个集成。

11.2. 连接到 Gmail

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

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

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

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

在以下主题中包括相关信息和说明:

11.2.1. 创建 Gmail 连接

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

先决条件

流程

  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 返回 Fuse Online。
  7. 在 Fuse Online Name 字段中输入您的名称选择,帮助您将这个连接与任何其他连接区分开来。例如,输入 Gmail Connect 1
  8. Description 字段中输入任何有助于了解这个连接的信息。例如,输入 使用 jkim Gmail account credentials 的 Sample Gmail 连接。
  9. Save 以查看您创建的连接现在可用。如果您输入了示例名称,您会看到 Gmail Connect 1 显示为可选择添加到集成的连接。

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

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

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

  • 在发送电子邮件的 Gmail 连接前添加数据映射程序步骤。在此数据映射器步骤中,将输出从前面的步骤中输出的数据字段映射到 Gmail connection Send Email action 字段。Send Email action 字段为:

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

    如果添加数据映射程序步骤,则可以映射一个、某些或所有 Send Email 操作字段。

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

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

当您添加发送电子邮件的 Gmail 连接时,所有操作配置参数都是可选的。这是因为您可能选择将集成数据映射到 Send Email action 字段。但是,电子邮件到 字段中的电子邮件地址(按操作配置规格或映射)是必需的。如果没有要将消息发送到的电子邮件地址,Fuse Online 会生成运行时错误,集成将停止执行。

11.2.3. 在轮询返回 Gmail 信息时触发集成

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

先决条件

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

流程

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

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

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

    5. Next 将这个 Gmail 连接添加为集成中的启动连接。连接显示为集成流程中的第一步。

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

在集成中,您可以从流程中间的 Gmail 帐户发送电子邮件,或完成简单的集成。要做到这一点,在流的中间或简单的集成完成连接中添加 Gmail 连接。

先决条件

流程

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

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

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

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

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

  5. Next 将连接添加到流。

结果

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

后续步骤

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

11.3. 连接到 Google Calendar

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

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

连接到 Google Calendar 的详情,请参考以下主题:

11.3.1. 创建 Google Calendar 连接

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

先决条件

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

流程

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

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

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

11.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 字段中指定要过滤轮询可以返回的事件的文本。连接仅返回包含指定文本的事件,其中至少一个事件字段。

      例如,假设您在 query 字段中指定 了 Standup meeting。在事件字段中,轮询才会返回那些有 Standup meeting 的事件。

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

结果

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

11.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 a 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 类似如下内容: p1pva2a4t504gbsha12di9ch6k_20181107T150000Z*
  6. Next 将连接添加到流。

结果

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

后续步骤

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

11.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 a action 页面中,选择 Create Event 操作。
  4. 配置 Create Event 操作:

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

结果

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

后续步骤

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

11.3.5. 在 Google Calendar 中更新事件

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

重要

在本发行版本中,更新事件 操作需要在每个事件字段中指定一个值。在大多数情况下,如果不是所有情况,这意味着您必须添加一个 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 a action 页面中,选择 Update Event
  4. 配置 Update Event 操作:

    1. 输入您要更新的事件的标题。
    2. 在您要更新的每个事件字段中输入内容。当您希望该字段中的内容保持不变时,不要在事件字段中输入内容。
  5. Next 将连接添加到流。这个连接会出现在您添加的集成视觉化中。
  6. 在集成视觉化中,点刚添加的连接前的加号。
  7. Data Mapper
  8. 在 data mapper 中,对于在更新事件中保留相同的事件字段,请将来自 Google Calendar 连接的字段映射到 Google Calendar 连接中,该事件在 Google Calendar 连接中更新事件。

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

  9. 在右上角,单击 Done 以添加 data mapper 步骤。

11.4. 连接到 Google 表

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

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

连接到 Google Sheets 的详情,请参考以下主题:

11.4.1. 创建 Google Sheets 连接

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

先决条件

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

流程

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

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

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

11.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 a action 页面上的开始连接中,选择 Get sheet values 操作或中间连接,选择 Retrieve sheet 值 操作。
  3. 配置操作:

    1. SpreadsheetId 字段中输入可从 Google Sheets 连接被授权访问的 Google 表格的 ID。

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

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

      例如,假设您想知道来自一个表格(含 4 列)的所有数据。指定 A:D。或者,若要从行 5 到 15 获得数据,请指定 A5:D15

      如果您在获取数据的电子表格中有多个表,请指定表格名称以及开始单元格协调和最终单元格协调。如果有多个表,并且您没有指定表名称,则连接从电子表格中的第一个表中获取数据。例如,为 2019!A1:D5 规格,指定您想要从名为 2019 的表中获取数据。在该表中,您想要在第 A 到第 1 行到第 5 行列的数据。

    3. Majormen sion 字段中,接受 Rows (默认值),或选择 Columns

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

      将操作配置为返回一系列列对象,每个列对象包含每个所需行的值。

    4. Header 行 字段中,如果 Major di mens 设为 Rows,则可以输入包含连接获取数据中列标题的一行数量。一个标题行的规格可让 Fuse Online 从电子表格中获取标题。如果您没有指定标题行,则列标题默认为连接获取的数据范围内每个列的字母标题。您可以在随后的页面中编辑获得的标题或字母标题。

      注意

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

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

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

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

      例如,假设主要维度为行,最大结果 设置为 25。轮询返回值不超过 25 行。

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

  4. Next,在将 Major mens 设置为 Rows 时查看连接获取的数据中的列名称。如果 Major mension 是 Columns,则此字段的内容会被忽略,您可以点 Next now 完成这个过程。

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

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

后续步骤

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

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

其他资源

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

11.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 Sheets 连接被授权访问的 Google 表格的 ID。

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

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

结果

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

11.4.4. 创建电子表格

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

先决条件

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

流程

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

    1. title 字段中输入新电子表格的标题。
    2. Time Zone 字段中输入新电子表格应使用的时区,如 印度标准时间东京
    3. Locale 字段中,输入新电子表格的区域设置,例如: CanadaKong
  5. Next 将连接添加到流。这个连接会出现在您添加的集成视觉化中。

结果

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

11.4.5. 更新表中的数据

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

先决条件

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

流程

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

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

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

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

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

      • Unified 默认为 Google Sheets API 设置,默认为 User 输入
      • raw 可使 Google Sheets 插入输入数据,如下所示。
      • 用户输入 可自动转换可识别的数据。
    5. Next 将连接添加到流。这个连接会出现在您添加的位置进行集成视觉化中。
  5. 如果要向流添加任何其他连接,现在添加它们,然后返回到这些指令。
  6. 在流程均需要的所有连接(集成视觉化中)后,点与更新表值的 Google Sheets 连接前的加号。
  7. Data Mapper 卡将数据映射步骤添加到流中。
  8. 在 data mapper 中:

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

      如果需要,您可以编辑 Google Sheets 连接,更新表值并更改 RangeMajormension 的设置。更改这些设置会导致 data mapper 会根据您的更改显示不同的目标字段。

    3. 在右上角,单击 Done 以添加 data mapper 步骤。

11.4.6. 将数据附加到一个表

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

先决条件

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

流程

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

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

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

      连接不会覆盖数据。连接在指定范围后附加数据,然后总是将数据附加到当前所在的内容中。

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

      • Unified 默认为 Google Sheets API 设置,默认为 User 输入
      • Raw 不做任何作用。Google Sheets 按照原样插入输入数据。
      • 用户输入 可自动转换可识别的数据。
    5. Next 将连接添加到流。这个连接会出现在您添加的集成视觉化中。

      您指定的值将 Append 值配置为表操作, 决定 data mapper 显示至此连接或从这个连接显示的字段。

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

    1. 如果您在将 Append 值配置为电子表格操作时没有指定电子表格 ID,然后将源电子 ID 映射到目标 电子表格Id
    2. 通过从源步骤中将字段映射到目标电子表格,指定要在表中添加的数据。例如,您可以映射来自另一个电子表格或数据库的字段。

      如果需要,您可以编辑 Google Sheets 连接,该连接附加了表值并更改 RangeMajormension 的设置。更改这些设置会导致 data mapper 会根据您的更改显示不同的目标字段。

    3. 在右上角,单击 Done 以添加 data mapper 步骤。

11.4.7. 更新电子表格属性

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

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

当 Fuse Online 提示您 配置更新电子表格属性 操作时,您可以将某些或所有字段留空。如果您将字段留空,然后在流(稍后添加)的 data mapper 步骤中,在连接前添加它,您可以将前一个步骤中的字段映射到空白 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. 配置 更新电子表格属性 操作:

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

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

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

11.4.8. 在表中添加 chart

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

当 Fuse Online 提示您配置 Add charts 操作时,您可以将某些或所有字段留空。如果将字段留空,您可以将值映射到您在这个连接前添加的 data mapper 步骤中的该字段。

先决条件

  • 您创建了 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 charts
  4. 配置 Add charts 操作:

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

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

      或者,将该字段留空。在此连接前,在数据映射程序步骤中,将 Chart 标题从源字段或属性映射到 标题 目标字段。

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

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

  5. Next 将连接添加到流。这个连接会出现在您添加的集成视觉化中。
  6. 如果要向流添加任何其他连接,请现在添加它们。然后返回到这些说明。
  7. 在集成视觉化中,点只添加 chart 的连接前的加号。
  8. Data Mapper

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

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

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

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

    1. 通过将 A1 表示法值映射到 overlayPosition target 字段,设置 chart 的位置。不需要结束位置,并在存在时忽略它。映射的值标识 Google Sheets 放置 chart 的单元。此单元是显示图表的左上角。

      如果您没有将值映射到 overlayPosition 字段,您也不要将值映射到 sheetId 字段,它标识您要将 chart 添加到的表,然后 Google Sheets 会创建一个新的表,并将 chart 放置到 A1 中。

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

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

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

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

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

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

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

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

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

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

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

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

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

11.4.9. 在表中添加 pivot 表

在流中,或完成简单的集成中,您可以添加 pivot 表到 Google Sheets 表格。通过 pivot 表,您可以聚合、排序或对电子数据应用函数,并在相同的电子表格中显示结果。要添加 pivot 表,请将 Google Sheets 连接到流中,或作为简单集成的完成连接。然后在连接前添加数据映射步骤。在数据映射步骤中,您将设置用于确定 pivot 表格的位置、属性和内容的选项。

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

先决条件

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

流程

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

    • 输入您要向其添加 pivot 表的电子表格 ID。
    • 将字段留空。在您要在此连接前添加的数据映射程序步骤中,您要将之前连接的电子表格 ID 映射到此连接。前面的连接必须访问您要在此连接中添加 pivot 表的电子表格。
  5. Next 将连接添加到流。这个连接会出现在您添加的集成视觉化中。
  6. 如果要向这个流添加任何其他连接,请现在添加它们。然后返回到这些说明。
  7. 在集成视觉化中,点仅在将 pivot 表添加到表的连接前的加号符号。
  8. Data Mapper

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

    如果没有所需值的源,则在 data mapper 中创建一个源属性,方法是点击 Properties 文件夹右侧的 + 符号。在 Create Property 对话框中,为属性指定一个名称,使其易于映射到正确的目标字段,例如,将 valueLayout 指定为属性名称。指定您要用来创建 pivot 表的连接值。pivot 表的值布局字段要求值为 HORIZONTALVERTICAL,以便您指定 VERTICAL 作为 valueLayout 属性的值。保存新属性。

  9. 在 data mapper 中,按如下所示配置一个新的 pivot 表:

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

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

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

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

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

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

      1. 将一列 pivot 组名称映射到目标 标签 字段。
      2. 将您要应用到列的排序顺序映射到目标 sortOrder 字段。该值必须是 ASCENDINGDESCENDING。默认为 ASCENDING
      3. truefalse 映射到 target showTotals 字段。默认为 true,它启用列 pivot 组的总计显示。
      4. 将列名称映射到目标 sourceColumn 字段,后者与构建列 pivot group 的协调映射到目标 sourceColumn 字段。
    10. 在右上角,单击 Done 以添加 data mapper 步骤。

第 12 章 连接到 HTTP 和 HTTPS 端点

在集成中,您可以连接到 HTTP 和 HTTPS 端点,以执行 GETPUTPOSTDELETEHEADOPTIONS、OPTIONS 或 PATCH 方法。要做到这一点,请创建一个 HTTP 或 HTTPS 连接,并将其添加到集成流中。以下主题提供详情:

12.1. 创建与 HTTP 或 HTTPS 端点的连接

在集成中,用于执行 HTTP GETPUTPOSTDELETEHEADOPTIONS、letters 或 PATCH 方法,创建与 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. 如果验证成功,点 下一步
  7. Name 字段中输入您的选择的名称,帮助您将这个连接与任何其他连接区分开来。例如,输入 HTTPS My Company Sales
  8. Description 字段中输入任何有助于了解这个连接的信息。
  9. Save 以查看您创建的连接现在可用。如果您输入了示例名称,您会看到 HTTPS My Company Sales 显示为可选择添加到集成的连接。

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

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

前提条件

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

流程

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

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

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

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

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

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

    当您创建或编辑使用您要为其指定此类型的连接的集成时,您将看到此数据类型名称。Fuse Online 在集成视觉化和 data mapper 中显示类型名称。

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

结果

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

第 13 章 连接到 IRC

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

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

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

13.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. 在端口字段中,输入 IRC 服务器侦听的端口,例如 6665
  6. Password 字段中,如果 IRC 服务器需要密码,请在此处输入。
  7. 单击 Validate。Fuse Online 立即尝试验证连接并显示一条消息,指示验证是否成功。如果验证失败,则调整连接配置值并重试。
  8. 如果验证成功,点 下一步
  9. Name 字段中输入您的选择的名称,帮助您将这个连接与任何其他连接区分开来。例如,输入 IRC Freenode
  10. Description 字段中输入任何有助于了解这个连接的信息。
  11. Save 查看更新可用连接列表,包括您刚才创建的连接。如果您输入了示例名称,您会看到 IRC Freenode 显示为可添加到集成的连接。您可以将这个连接添加到任意数量的集成中。

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

当连接发现发送到您指定的 IRC nickname 的专用信息时,该 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。您不需要遵循其中一些说明的其余部分。

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

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

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

    当您创建或编辑使用您要为其指定此类型的连接的集成时,您将看到此数据类型名称。Fuse Online 在集成视觉化和 data mapper 中显示类型名称。

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

结果

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

13.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 nickname 的消息。
  4. Nickname 字段中,指定 IRC nickname 来发送消息到指定的频道。
  5. NickServ password 字段中,如果您指定的 nickname 具有密码,请在此处指定。
  6. Next 指定操作的输入类型。
  7. Select Type 字段中,如果数据类型不需要已知,接受 类型规格不需要,然后单击 Next。您不需要遵循其中一些说明的其余部分。

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

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

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

    当您创建或编辑使用您要为其指定此类型的连接的集成时,您将看到此数据类型名称。Fuse Online 在集成视觉化和 data mapper 中显示类型名称。

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

结果

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

第 14 章 连接到 JIRA

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

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

14.1. 将 Fuse Online 注册到使用 OAuth 的 JIRA 服务器

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

注意

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

按照这里的步骤获取您需要创建 Fuse Online 连接到 JIRA 的 JIRA OAuth 凭证。有关注册 JIRA 消费者的更多详细信息,包括一个教程,它们通过示例服务器帮助您完成 有关 OAuth for REST API的步骤。

在将 Fuse Online 与 JIRA 服务器注册后,您可以使用 Fuse Online 创建与此 JIRA 服务器的连接。任意数量的集成都可使用同一 JIRA 连接。但是,如果要创建另一个 JIRA 连接,您必须重复这里提供的注册步骤来获取另一组 OAuth 凭证。

主要步骤概述

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

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

每个步骤都有几个子步骤,以下过程提供了详细信息。

先决条件

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

流程

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

    1. 转到 atlassian-oauth-examples 页面
    2. 在左侧面板中,单击 Downloads
    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 在线环境的信息。或者,为了避免响应提示,将 -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 在线环境识别为消费者应用。您必须以管理用户身份登录到 JIRA 服务器。

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

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

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

      1. Consumer Key 字段中,输入 Fuse Online App
      2. 在底部,选择 Create incoming link
      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 文档中,这一步被称为"Oauth dance",因为 Fuse Online、JIRA Server 和 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 连接。

14.2. 创建 JIRA 连接

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

如果您要连接的 JIRA 服务器使用 OAuth 协议进行身份验证,则必须将 Fuse 在线环境注册为您要连接的 JIRA 服务器的客户端。请参阅 将 Fuse Online 与使用 OAuth 的 JIRA 服务器注册

先决条件

  • 对于使用基本身份验证的 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 consumer 应用的过程会导致 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. 打开包含 OAuth 访问令牌、密钥和验证代码的 config.properties 文件。这是注册过程后的文件。从该文件中复制值,并将其粘贴到连接配置字段中。
    2. access_token 值复制到 Access Token 字段。
    3. consumer_key 值复制到 Consumer Key 字段中。
    4. private_key 值复制到 Private Key 字段中。
    5. secret 值复制到 Verification Code 字段。
  7. 单击 Validate。Fuse Online 会显示一条消息,指示它是否可以验证这个连接。如果验证失败,请尝试再次尝试,并确保输入正确的值。
  8. 验证成功后,单击 下一步
  9. Name 字段中输入您的选择的名称,帮助您将这个连接与任何其他连接区分开来。例如,输入 JIRA Connect 1
  10. Description 字段中输入任何有助于了解这个连接的信息。例如,输入 使用 jkim 帐户的 Sample JIRA 连接。
  11. Save 以查看您创建的连接现在可用。如果您输入了示例名称,您会看到 JIRA Connect 1 显示为一个可以添加到集成的连接。

14.3. 获取 JIRA 问题或注释来触发集成执行

要在从 JIRA 服务器获取问题或注释时触发集成执行,请将 JIRA 连接添加为简单的集成启动连接。

先决条件

  • 您创建了 JIRA 连接。

流程

  1. 在左侧的 Fuse Online 面板中,单击 Integrations
  2. Create Integration
  3. Choose a connection 页面中,点击您要用来开始集成的 JIRA 连接。
  4. Choose a action 页面中,选择一个操作:

    • 检索新评论 使用您指定的查询来搜索 JIRA 服务器。对于查询返回的每个问题,连接检查自上次调用查询后是否添加了注释。连接返回任何新注释。
    • 检索新问题,使用您指定的查询来搜索 JIRA 服务器。对于查询返回的每个问题,连接会检查其创建日期。如果问题自上次调用查询而创建,连接会将问题返回到集成。连接第一次执行此查询时,它将返回发现的所有问题。
  5. Delay 字段中,接受默认的 5000 毫秒(5 秒),或者输入要在查询调用之间需要延迟的毫秒数。
  6. JIRA Query Language 字段中,输入 JIRA 查询。例如:

    project = GATE AND assignee = jkim AND (status = Open OR status = New OR status = Reopened)

    此查询在 Gateway Online 项目中发现问题,分配给 jkim,并且未解析。每个 JIRA 项目都有一个短名称和一个长名称。在本例中,网关在线 项目的短名称为 GATE。在查询中指定项目的短名称。

    更加具体的查询是,搜索 JIRA 服务器所需的时间越短。当查询没有任何结果时,连接不会触发集成执行。

  7. 点击 Next

结果

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

14.4. 在 JIRA 服务器中添加问题

在流中,或完成简单的集成,您可以连接到 JIRA 服务器以添加问题。

先决条件

  • 您创建了 JIRA 连接。
  • 您正在创建或编辑一个流,Fuse Online 正在提示您添加到集成中。或者,Fuse Online 提示您选择简单的集成完成连接。

流程

  1. Add to Integration 页面中,点您要添加 JIRA 连接的加号。如果您要添加简单集成完成连接,请跳过这一步。
  2. 点击您要用来连接到 JIRA 服务器的 JIRA 连接。
  3. Choose an action 页面上,选择 Add Issue
  4. 配置该操作。所需字段是 问题类型 ID 或名称,以及项目 。对于可选字段,您可以现在输入值,或者在将这个连接添加到集成后,您可以在这个连接前添加数据映射程序。在 data mapper 步骤中,将前面步骤中的字段映射到此连接中的可选字段。

    1. (可选)在 Assignee 字段中,为您要分配此问题的人员输入 JIRA 用户名。
    2. (可选 )在组件 字段中输入一个或多个组件的名称。使用逗号分隔多个名称。JIRA 管理员定义了您可以指定的组件。
    3. (可选)在 Priority ID 或名称 字段中输入新问题的优先级。JIRA 管理员定义您可以输入的优先级值。
    4. (可选)在 Summary 字段中输入有关此问题的简单声明。
    5. Issue type ID 或 name 字段中输入描述问题类型的值。例如,这通常类似于 StoryEpicChoreBug

      在 JIRA 中,具有管理员权限的用户可以通过选择 Project settings > Issue type 来查看有效的问题类型列表。没有这些权限的用户可以点击问题的类型字段中,并显示允许值的列表。

    6. (可选)在 Watchers 字段中输入以逗号分隔的 JIRA 用户名列表。这些人员在更新此问题时收到通知。
    7. Project Key 字段中,输入 JIRA 管理员定义的 JIRA 项目的短名称。这个连接会在这个项目中创建新问题。例如,项目键类似于 GATE
    8. (可选)在 Description 字段中输入有关此问题的任何信息有助于捕获。
  5. 点击 Next

结果

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

14.5. 在 JIRA 的问题中添加注释

在流中,或完成简单的集成,您可以连接到一个 JIRA 服务器,为问题添加注释。

先决条件

  • 您创建了 JIRA 连接。
  • 您正在创建或编辑一个流,Fuse Online 正在提示您添加到集成中。或者,Fuse Online 提示您选择简单的集成完成连接。

流程

  1. Add to Integration 页面中,点您要添加 JIRA 连接的加号。如果您要添加简单集成完成连接,请跳过这一步。
  2. 点击您要用来连接到 JIRA 服务器的 JIRA 连接。
  3. 在 Choose a action 页面中,选择 Add Comment
  4. Comment 字段中,输入您要添加到问题的注释,或计划在此连接前添加数据映射程序。在该数据映射程序步骤中,将上一集成步骤中的注释映射到此连接 的注释 字段。
  5. Issue Key 字段中输入此问题的 JIRA 标识符。问题键示例: GATE-1234,Ent-239.
  6. 点击 Next

结果

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

后续步骤

要将之前集成步骤中的注释映射到此连接,请添加提供注释内容的连接,然后在此 JIRA 连接前添加数据映射程序步骤。例如,假设数据库连接获取了客户记录。在 datamapper 步骤中,将客户记录的集合映射到 JIRA 连接 的注释 字段。

14.6. 将文件附加到一个 JIRA 的问题

在流中,或完成简单的集成中,您可以连接到一个 JIRA 服务器以将一个或多个文件附加到问题。在集成中,必须上一步获取您要附加的文件。

先决条件

  • 您创建了 JIRA 连接。
  • 您正在创建或编辑一个流,Fuse Online 正在提示您添加到集成中。或者,Fuse Online 提示您选择简单的集成完成连接。

流程

  1. Add to Integration 页面中,点您要添加 JIRA 连接的加号。如果您要添加简单集成完成连接,请跳过这一步。
  2. 点击您要用来连接到 JIRA 服务器的集成的 JIRA 连接。
  3. Choose a action 页面中,选择 Attach File
  4. Issue Key 字段中,输入您要附加文件的问题的 JIRA 标识符。问题键示例: GATE-1234,Ent-239.
  5. 点击 Next

结果

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

后续步骤

如果集成还没有预先获取您要附加到 JIRA 问题的文件的连接,请将该连接添加到集成。确保它已在附加文件的 JIRA 连接之前。例如,假设您添加 FTP 连接并从 FTP 服务器下载一个或多个文件。当集成执行时,后续的 JIRA 连接会将这些文件附加到您在配置附加文件操作时指定的 JIRA 问题。

14.7. 添加和删除 JIRA 的问题监视器

在流中,或完成简单的集成,您可以连接到一个 JIRA 服务器,为问题添加监视器和/或移除监视器。

先决条件

  • 您创建了 JIRA 连接。
  • 您正在创建或编辑一个流,Fuse Online 正在提示您添加到集成中。或者,Fuse Online 提示您选择简单的集成完成连接。

流程

  1. Add to Integration 页面中,点您要添加 JIRA 连接的加号。如果您要添加简单集成完成连接,请跳过这一步。
  2. 点您要使用的集成的 JIRA 连接。
  3. Choose an action 页面上,选择 Add Issue
  4. Issue Key 字段中,输入您要添加监视器到或从中删除 watchers 的问题的 JIRA 标识符。问题键示例: GATE-1234,Ent-239.
  5. (可选)在 Add Watchers 字段中输入以逗号分隔的 JIRA 用户名列表。这些人员在更新此问题时收到通知。
  6. (可选)在 Remove Watchers 字段中输入已监视这个问题的以逗号分隔的用户名列表。连接会从监视器列表中删除这些用户。
  7. 点击 Next

结果

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

14.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. 配置该操作。唯一必填字段是 问题键。对于可选字段,您可以现在输入值,或者在将这个连接添加到集成后,您可以在这个连接前添加数据映射程序。在 data mapper 步骤中,将前面步骤中的字段映射到此连接中的可选字段。

    1. (可选)在 Assignee 字段中,为您要分配此问题的人员输入 JIRA 用户名。
    2. (可选 )在组件 字段中输入一个或多个组件的名称。使用逗号分隔多个名称。JIRA 管理员定义了您可以指定的组件。
    3. Issue Key 字段中输入您要连接更新的问题的 JIRA 标识符。问题键示例: GATE-1234,Ent-239.
    4. (可选)在 Priority ID 或名称 字段中输入新问题的优先级。JIRA 管理员定义您可以输入的优先级值。
    5. (可选)在 Summary 字段中输入有关此问题的简单声明。
    6. Issue type ID 或 name 字段中输入描述问题类型的值。例如,这通常类似于 StoryEpicChoreBug
    7. (可选)在 Description 字段中输入有关此问题的任何信息有助于捕获。
  5. 点击 Next

结果

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

14.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. (可选)在注释字段中输入您要添加到问题的注释。
  5. (可选)在 Issue Key 字段中输入正在转换的问题的 JIRA 标识符。问题键示例: GATE-1234,Ent-239.
  6. (可选) 在 transition 项中输入一个整数,输入 JIRA 管理员与特定转换相关联的整数,例如当 JIRA 移至新过渡时,或者在从开始进行测试时。

    JIRA 管理员可以在项目的工作流显示中查看转换 ID。如果您没有管理权限,请从 JIRA 管理员获取允许的转换 ID。

  7. 点击 Next

结果

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

后续步骤

如果您没有在每个 Transition Issue 字段中指定一个值,请确保集成都有一个获取每个字段的值。在集成都有所有必需的连接后,在 JIRA 连接问题前添加一个 data mapper 步骤。在 data mapper 步骤中,将前面步骤中的字段映射到 JIRA 连接中的字段来转换问题。

第 15 章 连接到 Kafka

Apache Kafka 是一个分布式流平台,可用于获取和发布数据。在集成中,您可以从 Kafka 主题订阅您指定的数据,或将数据发布到您指定的 Kafka 主题。要做到这一点,创建一个到 Kafka 的连接,并将该连接添加到集成流中。详情在以下主题中:

15.1. 创建到 Kafka 代理的连接

在集成中,要订阅 Kafka 主题的数据或将数据发布到 Kafka 主题,请创建一个到 Kafka 的连接,然后将该连接添加到集成中。

先决条件

  • 对于 Red Hat Managed Kafka

    • 您已创建了 Kafka 实例,创建了服务帐户,并设置 Kafka 主题,如 开始使用 Apache Kafka 的 Red Hat OpenShift Streams 所述。您知道服务帐户的客户端 ID 和客户端 Secret。
    • 您知道 Kafka 实例的 Bootstrap 服务器 URI。要获得 Bootstrap 服务器 URI:

      1. 登录到 Red Hat Managed Services web 控制台。
      2. 在 Web 控制台的 Kafka Instances 页面中,对于您要连接的相关 Kafka 实例,选择选项图标(三个垂直点),然后单击 Connection 以查看 Bootstrap 服务器 URI。
  • 对于 PLAIN SSL 机制,您知道用户名和密码。
  • 如果要使用传输层安全(TLS)加密数据,则 Kafka 代理的 PEM 证书文本。通常,您可以从 Kafka 服务器管理员获取代理证书文本。

流程

  1. 在 Fuse Online 中,在左侧面板中,单击 Connections 以显示任何可用的连接。
  2. 点击 Create Connection 以显示连接器。
  3. Kafka Message Broker 连接器。
  4. Kafka 代理 URIs 字段中,键入或选择您希望此连接访问的代理,或者输入以逗号分隔的 Kafka 代理 URI 列表。每个 URI 应采用 host:port 的形式。

    对于 Red Hat Managed Kafka,输入 Managed Kafka 实例 Bootstrap 服务器 URI。请注意,如果您在 OpenShift 集群上安装了 Strimzi Operator 或 AMQ Streams Operator,则 URI 会被自动发现,您可以选择它。

  5. 对于 Security Protocol 字段,选择以下选项之一:

    • 如果要加密数据以在传输中保护,请选择 TLS (端口层安全性)。跳至第 7 步。
    • 如果要使用 SASL 验证并使用 SSL 加密您的数据(例如,在 Red Hat Managed Kafka 中),请选择 SASL_SSL
    • 如果您不想加密数据,请选择 Plain,然后跳至第 8 步。
  6. 如果您选择了 SASL_SSL 作为安全协议,则需要选择两个选项来设置凭证:

    • 如果要使用 PLAIN 作为 SASL 机制,则必须设置 UsernamePassword 字段。
    • 如果要使用 OAUTHBEARER 作为 SASL 机制,则必须设置以下字段:

      • 带有 OAuth 客户端的用户名。
      • 使用 OAUth 客户端 Secret 密码。
      • SASL 登录回调处理程序 类,您可以使用来自 kafka-clients 2.5 版本或 Strimzi 项目中的 kafka-oauth-client 的所有回调处理程序类。要连接到 Red Hat Managed Kafka,您可以使用:

        io.strimzi.kafka.oauth.client.JaasClientOauthLoginCallbackHandler

      • 带有由您的供应商提供的 /oauth/token endpoint URI 的 OAuth 令牌端点 URI。
  7. 如果您在第 5 步中选择了 TLS,然后在 Broker 证书 字段中粘贴 Kafka 代理的 PEM 证书文本。
  8. 可选。点 Add a custom 属性指定 key:value 对,以配置 Kafka producer 和使用者选项。

    例如,如果您希望新集成消耗来自主题的旧消息,请将 auto.offset.reset 值从默认值(最新的)更改为最早的,方法是输入 auto.offset.reset for the Key 字段,并在 Value 字段中键入 earlie st

    有关 Kafka producer 配置选项的详情,请访问 https://kafka.apache.org/documentation/#producerconfigs

    有关 Kafka consumer 配置选项的详情,请访问 https://kafka.apache.org/documentation/#consumerconfigs

    注意: 如果您添加配置属性,Fuse Online 不会将它们包含在下一步中,作为其验证过程的一部分。

  9. 单击 Validate。Fuse Online 立即尝试验证连接并显示一条消息,指示验证是否成功。如果验证失败,请调整输入参数并重试。
  10. 如果验证成功,点 下一步
  11. Name 字段中输入您的选择的名称,帮助您将这个连接与任何其他连接区分开来。例如,您可以键入 Kafka Test
  12. Description 字段中输入任何有助于了解这个连接的信息。
  13. Save 以查看您创建的连接现在可用。如果您输入了示例名称,您会看到 Kafka Test 显示为您可以选择添加到集成的连接。

15.2. 从 Kafka 代理获取数据以触发集成执行

要在从 Kafka 代理接收数据时触发集成的执行,请将 Kafka 连接添加为启动连接。当集成运行时,Kafka 连接会持续监视您指定的 Kafka 主题中的数据。当连接发现新数据时,它会将这些数据传递给集成中的下一步。

前提条件

您创建了到 Kafka 代理的连接。

流程

  1. 在左侧的 Fuse Online 面板中,单击 Integrations
  2. Create Integration
  3. Choose a connection 页面中,点您要用来开始集成的 Kafka 连接。
  4. Choose a action 页面中,选择 Subscribe action 以接收来自您指定的主题中的数据。
  5. Topic Name 字段中,单击 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
    • CSV 实例 是一个包含以逗号分隔的值(CSV)数据的文档。文档的文件扩展名是 .csv
  8. Definition 输入框中,粘贴符合您选择的模式类型的定义。例如,如果您选择 JSON 模式,则会粘贴 JSON 架构文件的内容,该文件具有介质类型 application/schema+json
  9. Data Type Name 字段中输入您为数据类型选择的名称。例如,如果您要为供应商指定 JSON 模式,则可能会将 Vendor 指定为数据类型名称。

    当您创建或编辑使用您要为其指定此类型的连接的集成时,您将看到此数据类型名称。Fuse Online 在集成视觉化和 data mapper 中显示类型名称。

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

结果

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

15.3. 将数据发布到 Kafka 代理

在集成中,您可以在流的中间发布数据到 Kafka 代理,或完成简单集成。要做到这一点,在流的中间或简单的集成完成连接中添加 Kafka 连接。

先决条件

  • 您创建了到 Kafka 代理的连接。
  • 您正在创建或编辑一个流,Fuse Online 正在提示您添加到集成中。或者,Fuse Online 提示您选择完成连接。

流程

  1. Add to Integration 页面中,点您要添加 Kafka 连接的加号。如果您要添加简单集成完成连接,请跳过这一步。
  2. 点击您要用来发布消息的 Kafka 连接。
  3. Choose an action 页面上,选择 Publish
  4. Topic Name 字段中,单击 carat 以显示主题列表,然后单击您要发布到的主题。
  5. Next 指定操作的输入类型。
  6. Select Type 字段中,如果数据类型不需要已知,接受 类型规格不需要,然后单击 Next。您不需要遵循其中一些说明的其余部分。

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

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

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

    当您创建或编辑使用您要为其指定此类型的连接的集成时,您将看到此数据类型名称。Fuse Online 在集成视觉化和 data mapper 中显示类型名称。

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

结果

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

第 16 章 连接到 Apache Kudu

Apache Kudu 是一个列式存储管理器,专为 Apache Hadoop 平台开发。Fuse Online 集成可以连接到 Kudu 数据存储来扫描表,该表会将表中的所有记录返回到集成,或者将记录插入到表中。详情在以下主题中:

16.1. 创建与 Apache Kudu 数据存储的连接

在集成中,要从 或 insert 记录中获取记录到 Kudu master 主机,请创建一个连接到 Kudu master 主机的连接,然后将该连接添加到集成中。

前提条件

  • 您必须知道您要连接的 Kudu master 主机的 IP 地址或主机名。
  • 您必须知道 Kudu 侦听的端口。

流程

  1. 在 Fuse Online 中,在左侧面板中,单击 Connections 以显示任何可用的连接。
  2. 点击 Create Connection 以显示连接器。
  3. Apache Kudu 连接器。
  4. 配置连接:

    1. Kudu master 主机字段的 Address 中,输入 Kudu master 主机的主机名或 IP 地址。
    2. 在端口 要 建立到字段的连接中,输入 Kudu 侦听的端口。默认值为 7051
  5. 点击 Next
  6. Name 字段中输入您的选择的名称,帮助您将这个连接与任何其他连接区分开来。例如,您可以输入 Kudu North
  7. Description 字段中输入任何有助于了解这个连接的信息。
  8. Save 以查看您创建的连接现在可用。如果您输入了示例名称,您会看到 Kudu North 显示为您可以选择添加到集成的连接。

16.2. 在扫描从 Kudu 表中返回记录时触发集成

要在从 Kudu 表中获取数据时触发集成执行,请在启动连接时添加 Kudu 连接到简单的集成。当集成运行时,Kuidu 连接会扫描您在指定的时间间隔中指定的表,获取表中的所有记录,并将记录集合传递到集成的下一步中。

Kudu 连接只能从一个表中获取数据。在扫描之间,如果连接扫描的表中没有数据更改,则下一个扫描会返回与之前的扫描相同的数据。

前提条件

  • 您创建了 Kudu 连接。
  • 要从中获取记录的表存在。

流程

  1. 在左侧的 Fuse Online 面板中,单击 Integrations
  2. Create Integration
  3. Choose a connection 页面中,点您要用来开始集成的 Kudu 连接。
  4. Choose a action 页面中,选择 Scan a Kudu table 操作。
  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 a action 页面上,选择 Insert data in 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 主机 字段中,指定此连接可访问的一个或多个 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. 验证成功后,单击 下一步
  7. Name 字段中输入您的选择的名称,帮助您将这个连接与任何其他连接区分开来。例如,您可以输入 MongoDB North
  8. Description 字段中输入任何有助于了解这个连接的信息。
  9. Save 以查看您创建的连接现在可用。如果您输入了示例名称,您会看到 MongoDB North 显示为您可选择添加到集成的连接。

后续步骤

将 MongoDB 连接添加到集成。

17.2. 更新 MongoDB 集合时触发集成

要在将文档添加到 MongoDB 集合中触发集成执行,请在其开始连接时向简单集成添加 MongoDB 连接。当集成运行时,MongoDB 连接会监控您在创建集成时指定的数据库集合。将新文档插入到配置为监控集成的触发器执行的集合中。MongoDB 连接将新文档返回到集成,此数据可供集成中的下一步使用。

先决条件

  • 您创建了 MongoDB 连接。
  • 您知道希望连接的 MongoDB 集合的名称。
  • 如果您希望连接监控的集合是一个上限的集合,还必须知道:

    • 跟踪传入文档的 MongoDB 集合字段的名称。
    • 是否为包含集合的数据库启用持久性跟踪。
    • 如何指定与您要连接读取的数据相关的尾部跟踪信息。MongoDB 连接可以使用 tail 跟踪信息在意外连接终止后恢复操作。尾部跟踪确保连接恢复其活动时,不会将重复的数据返回至集成,也不会丢弃任何需要返回到集成的数据。

流程

  1. 在左侧的 Fuse Online 面板中,单击 Integrations
  2. Create Integration
  3. Choose a connection 页面中,点配置为访问您希望集成从中获取更新的数据库的 MongoDB 连接。
  4. 在 Choose a action 页面中,选择以下操作之一:

    • 检索文档(流) 通常是您要选择的操作。它从未总结的集合中检索数据。
    • 检索文档(tail) 是从大写的集合检索数据的操作。
  5. 配置操作:

    1. Collection name 字段中输入您要读取的 MongoDB 集合的名称。

      如果您要配置 Retrieve 文档(stream) 操作,则这是唯一需要的参数。转到第 6 步。如果您要配置 Retrieve 文档(tail) 操作,请按照剩余的子步骤操作。

    2. 用来跟踪传入的文档字段的 Collection 字段中,输入相关 MongoDB collection 字段的名称。此字段包含可以排序的数据,如日期或 ID。
    3. 如果您希望连接读取的数据库 启用了 永久性跟踪,请选择"永久跟踪"复选框。
    4. 可选。在唯一 ID 中 用于标识此跟踪进程 字段,如果有多个用户监控同一集合,则指定一个唯一 ID。如需更多信息,请参阅Tail able Cursor Consumer 的 Camel 文档。
    5. 可选。在 用来存储 tail 跟踪字段的 DB 中,输入包含尾部跟踪信息的 MongoDB 数据库的名称。
    6. 可选。在 用来存储尾部跟踪 字段的集合名称中,输入包含尾部跟踪信息的集合名称。
    7. 可选。在 用来存储 tail 跟踪 字段的字段中,输入存储此连接正在读取的集合的尾部跟踪信息的字段名称。

    要标识 tail 跟踪字段,您可以指定 tail 跟踪数据库或尾部跟踪集合。使用这些信息之一,连接可以查找 tail 跟踪字段。

  6. Next 指定操作的输出类型。
  7. Select Type 字段中,如果数据类型不需要已知,接受 类型规格不需要,然后单击 Next。您不需要遵循其中一些说明的其余部分。

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

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

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

    当您创建或编辑使用您要为其指定此类型的连接的集成时,您将看到此数据类型名称。Fuse Online 在集成视觉化和 data mapper 中显示类型名称。

  10. Data Type Description 字段中,提供可帮助您区分此类型的信息。当您将鼠标悬停在处理此类型的步骤上时,这个描述会出现在 data mapper 中。
  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 a action 页面中,选择您要连接执行的操作。
  4. 要配置操作,在 Collection name 字段中输入您要连接操作的集合名称。

    如果您选择了 Insert 操作:

    • 您正在配置连接。
    • 确保集成通过此 MongoDB 连接的数据包含 JSON 标记,该标记指定要添加到集合中的内容。
    • 点击 Next 把这个连接添加到集成。
  5. 对于所有其他操作,下表提供了在配置操作的第二个字段中指定什么信息。

    第二个字段是一个 JSON 表示法表达式,用于标识要操作的文档,以及可能需要操作的详细信息。如果您计划将传入的源字段映射到表达式中的标识符,请在表达式中指定 :#variable-name

    为了完整性,此表还介绍了 Insert 操作。

    操作它做什么参数字段返回

    数量

    计算满足您指定的计数表达式的文档数量。

    Count 表达式 字段中,以 {"test":"unit"} 的形式指定 JSON 过滤器表达式。该操作将统计具有 test 属性值的文档 数量

    java.lang.Long 的一个实例,它指定找到的文档数量。

    删除

    从集合中删除一个或多个文档。

    Delete expression 字段中,以 {"test":"unit"} 的形式指定一个 JSON 表达式。该操作将删除其 test 属性的值为 unit 的每个文档。

    java.lang.Long 的实例,用于指定已删除的文档数量。

    find

    查找与您指定的过滤表达式匹配的所有文档。

    Filter 表达式 字段中,指定用于标识一个或多个文档的 JSON 表示法字符串。

    指定列表(数组)的 JSON 符号。每个列表元素标识了与过滤表达式匹配的文档,并提供文档内容。如果没有找到文档,则操作会返回一个空列表。

    您必须熟悉集合的数据模型。如果集合遵循 JSON 模式,您必须熟悉此 schema,因为返回的列表元素遵循这个 schema。如需更多信息,请参阅 MongoDB Data Models

    要在后续数据映射程序步骤中使用 Find 操作的输出数据,集合必须遵循 JSON 模式。这可让数据映射程序显示数据字段。如需更多信息,请参阅 JSON 模式验证的 MongoDB 文档

    insert

    在集合中添加一个或多个文档。

    没有用于插入文档的操作配置参数。来自 MongoDB 连接的数据必须包含 JSON 标记,用于指定添加到集合中的一个或多个文档。

    指定列表(数组)的 JSON 符号。每个列表元素都是操作插入的文档。

    Update(更新)

    更新集合中的一个或多个文档。

    Filter criteria 字段中,指定 2 个参数的数组。第一个参数是一个过滤器表达式,用于标识要更新的文档。第二个参数是 MongoDB 更新声明,它指定如何更新文档。更新声明格式在 https://docs.mongodb.com/manual/reference/method/db.collection.update/ 中描述。例如: [{"_id":11},{$set: {"test":"updated!"}}]

    java.lang.Long 的实例指定更新的文档数量。

    upsert

    更新集合中一个或多个文档,如果没有与 Upsert 表达式匹配,请创建一个文档。

    Upsert 表达式 字段中,指定用于标识一个或多个文档的 JSON 符号。该操作将使用此表达式来检测任何匹配的文档。如果操作在集合中找到匹配的文档,则会更新它。如果操作找不到匹配的文档,则操作会创建一个新文档。进入 MongoDB 连接的数据必须包含指定:

    * _id 字段可以识别它是插入还是更新操作。

    * 添加或更新的内容。

    com.mongodb.client.result.UpdateResult 的实例,用于指定更新文档的数量或插入的新文档 ID。

    每个操作都会返回一个响应。如果这是一个完成连接,则响应将会丢失,但您可以添加一个 Log 步骤来捕获响应。

  6. 点击 Next
  7. 可选。如果这是完成连接,请添加 Log 步骤来完成集成。配置日志 步骤 以捕获响应。

结果

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

后续步骤

将任何其他所需连接添加到流。添加处理数据的任何其他步骤。通过添加任何所需数据映射步骤完成集成。当您配置 MongoDB 连接动作时,如果您在操作表达式中指定了任何 :#variable-name 标识符,请确保将源字段映射到 MongoDB 连接变量字段。

第 18 章 连接到 paper

MQ Telemetry Transport(awx)是一个轻量级、机器到机器的、互联网的、连接协议。在集成中,您可以从中获取信息或将消息发布到 [...] 代理。为此,可创建与感兴趣的 IFL 代理的连接,然后将该连接添加到集成流中。详情在以下主题中:

18.1. 创建与 paper 代理的连接

在集成中,若要从信息获取或发布消息到 LAST 代理,请创建与感兴趣的 awx 代理的连接,然后将该连接添加到集成中。

前提条件

您必须知道您要连接的 IFL 代理的 URL。

流程

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

    1. PlacementBinding broker URL 字段中,输入您要发送到数据或从中获取数据的 [...] 代理的位置。这是唯一必填字段。
    2. User Name 字段中,为您要用来访问代理的凭证输入 [...] 帐户的用户名。
    3. Password 字段中,如果指定了用户名,则指定与该帐户关联的密码。
    4. Client ID 字段中,输入允许连接在没有缺失消息的情况下关闭并重新打开的 ID。连接必须订阅或发布到一个主题。
  5. 单击 Validate。Fuse Online 立即尝试验证连接并显示一条消息,指示验证是否成功。如果验证失败,则调整输入参数并重试。
  6. 如果验证成功,点 下一步
  7. Name 字段中输入您的选择的名称,帮助您将这个连接与任何其他连接区分开来。例如,您可以进入 VDDK West
  8. Description 字段中输入任何有助于了解这个连接的信息。
  9. Save 以查看您创建的连接现在可用。如果您输入了示例名称,则 TITLE West 显示为可选择添加到集成的连接。

18.2. 从 IFL 代理获取消息来触发集成执行

要根据从 LAST 代理接收消息来触发集成的执行,请在启动连接中添加 LAST 连接。当集成运行时,awx 连接会持续监视您指定的 [...] 队列或主题上的消息。当连接找到信息时,它将传递给集成中的下一步。LAST 连接一次处理一条消息。

前提条件

您创建了 unicode 连接。

流程

  1. 在左侧的 Fuse Online 面板中,单击 Integrations
  2. Create Integration
  3. Choose a connection 页面上,单击您要用来开始集成的 awx 连接。
  4. Choose a action 页面中,选择 Subscribe action 以接收来自您指定的队列或主题的消息。
  5. awx queue/topic name 字段中,输入要订阅数据的队列或主题的名称,以接收数据。
  6. Next 指定操作的输出类型。
  7. Select Type 字段中,如果数据类型不需要已知,接受 类型规格不需要,然后单击 Next。您不需要遵循其中一些说明的其余部分。

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

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

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

    当您创建或编辑使用您要为其指定此类型的连接的集成时,您将看到此数据类型名称。Fuse Online 在集成视觉化和 data mapper 中显示类型名称。

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

结果

现在,集成具有启动连接,Fuse Online 正在提示您选择完成连接。

18.3. 向 paper 代理发布消息

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

先决条件

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

流程

  1. Add to Integration 页面中,点您要添加 [...] 连接的加号。如果您要添加简单集成完成连接,请跳过这一步。
  2. 点击您要用来发布消息的 PlacementBinding 连接。
  3. Choose an action 页面上,选择 Publish
  4. LAST queue/topic name 字段中,指定要将消息发布到的队列或主题的名称。
  5. Next 指定操作的输入类型。
  6. Select Type 字段中,如果数据类型不需要已知,接受 类型规格不需要,然后单击 Next。您不需要遵循其中一些说明的其余部分。

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

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

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

    当您创建或编辑使用您要为其指定此类型的连接的集成时,您将看到此数据类型名称。Fuse Online 在集成视觉化和 data mapper 中显示类型名称。

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

结果

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

第 19 章 连接到 OData

开放数据协议(OData)是构建和使用 REST API 的标准。OData 服务通过 OData 兼容 HTTP 请求向客户端(如 Fuse Online)提供服务。Fuse Online 集成可以从 OData 服务获取实体,并可更新、创建或删除 OData 服务所管理的实体。为此,请创建一个 OData 连接,并将其添加到集成中。

假设您熟悉 OData 规格 版本 4版本 2

连接到 OData 服务的详情,请参考以下主题:

19.1. 创建与 OData 服务的连接

在集成中,若要获取、更新、创建或删除由 OData 服务管理的实体,您必须首先创建与 OData 服务的连接。您可以为版本 2 或版本 4 OData 创建连接。

先决条件

  • 您必须知道您要连接的 OData 服务的基本 URL。
  • 如果该服务使用身份验证,则必须具有所需的凭证,如果需要,则 SSL 证书。但是,大多数 OData 服务都是公共的,不需要身份验证。

流程

  1. 在 Fuse Online 中,在左侧面板中,单击 Connections 以显示任何可用的连接。
  2. 点击 Create Connection 以显示连接器。
  3. 单击 OData v2OData v4 连接器。
  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. 验证成功后,单击 下一步
  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 a action 页面中,选择 Read 操作。
  5. 配置 Read 操作:

    1. Resource Collection 字段中,选择要查询的 OData 资源的名称。Fuse Online 从 OData 服务获取数据,以提供可用资源集合的列表。
    2. 实体密钥 Predicate 字段中,若要获取特定实体,通过指定密钥 predicate 来识别您想要的实体。例如,指定诸如 UserName='Bob'Categories(1) 的内容。要获得多个实体,请将此字段留空。
    3. Query Options 字段中输入您要应用到资源的查询。使用 OData 语法。例如,$filter=startswith(name, 'N') 为资源中有一个 名称字段N 开头。

      您可以指定 实体键假定和查询 选项 。如果您这样做,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')

      该服务会返回包含域 示例 的所有电子邮件地址。

    4. 选择 Filter Old Results 复选框,以只获取特定消息一次。
    5. 如果您希望连接返回单个消息而不是消息集合,请选择 Split Results 复选框。

      Fuse Online 还提供了离散的分割和聚合步骤,您可将其添加到一个流中。如果要在一个或多个步骤中处理各个消息,然后将消息聚合到一个集合中,请不要选择 Split Results 复选框。相反,复选框留空,然后在此连接后向流添加一个拆分步骤。如果您希望流程中的聚合步骤,则需要分割步骤。

    6. Interval Before Poling Starts 字段中,接受默认值 1 秒,或者输入在连接开始轮询 OData 服务前希望放弃的时长。
    7. Delay 字段中,接受默认值 30 秒,或者输入您要连接轮询 OData 服务的时间间隔。
    8. Backoff Idle Threshold 字段中,接受默认值 1 或输入一个整数,表示可以返回任何数据的连续轮询数。轮询次数后,连接会增加后续轮询之间的间隔。连接通过 Backoff Multiplier 值乘以 Delay 值来确定轮询间隔的新长度。

      例如,假设轮询间隔( 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 正在提示您选择完成连接。

在执行过程中,返回的连接将取决于您在 实体键预先和查询 选项字段中指定 的内容。OData 连接可以返回:

  • 实体或实体属性集合

    例如,这可能是资源中的所有个人实体,也可能是所有 Person 实体的所有 期限 属性。这个连接会返回一条消息中的集合。Fuse Online 对集合一次执行一次流程中的每个步骤。但是,当您配置 Read 操作时,如果您选择 Split Results,则连接会在其自己的消息中返回每个实体或每个属性。Fuse Online 在每个消息执行一次每个步骤。

  • 实体或实体属性

    例如,这可能是其 UserName 属性为 Bob 的个人实体,也可能是其 UserNameBob Person 实体的 Age 属性。这个连接会返回流中向下一步传递的消息中的实体或实体属性。

后续步骤

添加集成完成连接以及您要包含在集成中的任何其他连接。当集成包含需要的所有连接时,如果 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 a action 页面中,选择您要连接执行的操作:

    • 创建将 实体添加到 OData 资源。
    • 从 OData 资源 中删除 实体。
    • 更新 更改 OData 资源中的实体。

      对于 OData Version 2 连接,当您创建或更新一个实体时,可以设置三个选项。这三个选项指定数据在请求中序列化的方式:

      • 仅内容 - 默认情况下,OData Version 2 将元数据添加为请求的一部分。要禁用此默认行为,请选择 Content Only 选项。
      • omit ETag - 默认情况下,OData Version 2 要求,当您向请求发送更新时,您必须在更新请求中指定所有强制属性值。要禁用此默认行为,以便只指定您要更改的属性值,请选择 Omit ETag 选项。
      • 省略 Json wrapper - 默认情况下,OData Version 2 以 JSON 格式嵌套请求。若要禁用此默认行为,可选择 Omit Json wrapper 选项。
  4. 通过选择您要更新的 OData 资源来配置操作。

    务必要了解您如何设置您更新的 OData 资源。OData 服务的后端数据源决定了更新并解决冲突规则。例如,假设 OData 连接会尝试创建新实体,但具有该 predicate 密钥的实体已存在。OData 服务可能会覆盖现有的实体,或者可能会更新现有实体中的一些字段,或者可能会忽略操作。您知道 OData 服务在这种情形中如何运作。

  5. 点击 Next

结果

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

后续步骤

在 OData 连接前添加数据映射程序步骤。您必须映射提供创建新实体、更新实体或删除实体所需的数据的源字段。对于下一个连接,请参阅映射集成数据到字段

第 20 章 连接到 Salesforce

在集成中,要连接到 Salesforce,您必须将 Fuse 在线环境注册为 Salesforce 客户端应用程序。这会授权 Fuse Online 访问 Salesforce。通过注册,您可以创建一个 Salesforce 连接,然后添加到任意数量的集成中。详情请查看以下主题:

20.1. 将 Fuse Online 注册为 Salesforce 客户端应用程序

在集成中,要连接到 Salesforce,必须首先将 Fuse 在线环境注册为可访问 Salesforce 的客户端应用程序。这可让您创建连接到 Salesforce 的任何数量集成。换句话说,您只需要在 Salesforce 中注册特定的 Fuse 在线环境。

在每个 Fuse 在线环境中,每个 Fuse 在线环境中只能使用一个将 Fuse Online 注册为 Salesforce 客户端应用程序。但是,虽然每个 Salesforce 连接都使用相同的注册,但可以使用不同的用户凭证。

前提条件

您已登录到 Fuse Online。

流程

  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 体验界面切换,请点击您的配置集图标,并选择 切换到 Salesforce Classic。如需更多信息,请参阅有关创建连接应用程序的 Salesforce 文档

    1. 在 Salesforce 中,在右上角点击 Setup
    2. 在左侧面板中,选择 Build > Create > Apps
    3. 向下滚动到 Connected Apps 并点击 New
    4. 输入所需信息,然后选择 Enable OAuth Settings
    5. Callback URL 字段中,粘贴您的 Fuse Online URL,该 URL 在此流程开始时进行复制。例如 :https://app-proj912876.7b63.fuse-ignite.openshiftapps.com/api/v1/credentials/callback
    6. 对于 OAuth 范围,请添加:

      • 通过 API(api)管理用户数据.
      • 访问唯一标识符(openid)
      • 随时执行请求(refresh_token、line_accesss)
    7. 选择 Configure ID 令牌,然后选择 Include Standard Claims
    8. 向下滚动,再单击 Save
    9. 向上滚动以查看 Salesforce 表示短等待: SF message to wait a few minutes
    10. Continue
    11. 复制 Salesforce 提供的消费者密钥。
  3. 返回到您的 Fuse Online Settings 页面,并将 Salesforce 提供的消费者密钥粘贴到 Fuse 在线 Salesforce 客户端 ID 字段中。
  4. 返回 Salesforce 网站并复制 Salesforce 提供的消费者 secret。
  5. 返回到您的 Fuse Online Settings 页面,并将 Salesforce 提供的消费者 secret 粘贴到 Fuse Online Salesforce Client Secret 字段中。
  6. 点击 Save
  7. Salesforce 条目折叠它。

20.2. 创建 Salesforce 连接

要创建可访问 Salesforce 数据的集成,您必须首先创建一个 Salesforce 连接。创建 Salesforce 连接后,您可以在多个集成中使用它。

先决条件

  • 您已登录到 Fuse Online。
  • 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 在线环境不会作为 Salesforce 客户端应用程序注册。请参阅 将 Fuse Online 注册为 Salesforce 客户端应用程序。当您尝试创建 Salesforce 连接并且 Fuse Online 环境未注册为 Salesforce 客户端应用程序时,Fuse Online 会显示多个提示授权信息的字段。虽然您可以通过在这些字段中输入值来创建 Salesforce 连接,但不建议这样做。

    注意

    以下错误表示 Salesforce 没有正确的 Fuse Online 回调 URL:

    error=redirect_uri_mismatch&error_description=redirect_uri%20must%20match%20configuration

    如果收到这个错误消息,然后在 Salesforce 中确保 Fuse Online 回调 URL 由 Registering Fuse Online 中的说明指定为 Salesforce 客户端应用程序

  5. Allow 返回 Fuse Online。
  6. Name 字段中输入您的选择的名称,帮助您将这个连接与任何其他连接区分开来。例如,输入 SF Connect 1
  7. Description 字段中输入任何有助于了解这个连接的信息。例如,输入 使用我的 Salesforce 登录凭证的 Sample Salesforce 连接。
  8. Save 以查看您创建的连接现在可用。如果您输入了示例名称,您会看到 SF Connect 1 显示为可选择添加到集成的连接。

20.3. 在集成中添加 Salesforce 连接

在集成中,您可以在流程中间连接到 Salesforce,或启动或完成简单集成。要做到这一点,在集成中添加 Salesforce 连接。

先决条件

  • 您创建了 Salesforce 连接。
  • 您正在创建或更新集成。
  • Fuse Online 会提示您选择启动连接,或选择完成连接,或添加到集成中。

流程

  1. 如果您要在流的中间将 Salesforce 连接添加到 Salesforce 连接中,点您要添加连接的加号。如果 Fuse Online 提示输入启动或完成连接,请跳过这一步。
  2. 点击您要添加到流中的 Salesforce 连接。当集成使用您选择的连接连接到 Salesforce 时,Fuse Online 使用那个连接中定义的凭证。
  3. 选择您希望所选连接执行的操作。您添加到流中的每个 Salesforce 连接都只执行您选择的操作。
  4. 指定操作所在的 Salesforce 对象,例如,可能是联系人、领导或价格书条目。点 Object 字段中,从 Salesforce 对象列表中进行选择,或者输入对象的名称。
  5. Next 将连接添加到流。

第 21 章 连接到 SAP Concur

SAP Concur 管理商业费用、差旅和发票.在集成中,您可以连接到 SAP Concur,并执行任何各种 SAP Concur 操作之一。例如,假设您将项目代码存储在 SQL 数据库中,且在 SAP Concur 中有相同的项目代码,以便可以把费用与项目关联。您可以创建一个与 SQL 数据库连接的集成,并运行一个获取任何新项目代码的存储过程。然后集成可以连接到 SAP Concur,并将新项目代码上传到适当的列表中。

请参见以下主题:

21.1. 用于连接到 SAP Concur 的用户角色

SAP Concur 具有用于开发工作的实施网站,以及供实时使用的生产网站。该实施站点模拟生产网站。这可让您在生产环境与实时 SAP Concur 站点搭配使用前创建并完善集成。

在任何时候,Fuse 在线环境都可以连接到 SAP Concur implementation 站点或 SAP Concur production 站点。换句话说,特定的 Fuse Online 环境不支持同时连接到两个 SAP 冲突站点。每个 Fuse 在线环境都需要自己的凭据来访问每个 SAP 冲突站点,且实施站点的凭据与生产站点的凭据不同。

因此,预计系统管理员中的某个人可以执行以下操作:

  1. 从 SAP Concur 获取两组 OAuth 凭证:

    • 设定访问 SAP Concur implementation 站点的集合
    • 另一个访问权限设置为 SAP Concur production 站点
  2. 配置 SAP Concur connector,以访问相应的 SAP Concur site。
  3. 创建 SAP 冲突连接。

然后业务用户可以创建使用 SAP Concur 连接的集成。

21.2. 如何获取 SAP Concurin 实现站点 OAuth 凭证

要获得访问 SAP Concur 实现站点的凭证,请直接联系 SAP Concur,并告诉他们:

  • 您需要将 Fuse Online 注册为有权访问 SAP Concur 实现站点的新应用。
  • 您希望一组新的 OAuth 凭证用于其实现网站。
  • 凭证必须包含 LIST 范围。
  • 另外,要获取执行列表操作的权限,请询问其他 范围
  • 这些凭据的 OAuth 授权类型应当是 Authorization Grant Flow

    要使用 REST 客户端(如 Postman)向 SAP Concur 实现网站发送请求,您需要具有 OAuth 授权类型的凭证。

  • 您要凭证的环境的 Fuse Online 回调 URL,如下所示:

    https://syndesis.my-minishift.syndesis.io/api/v1/credentials/callback

    在这个 URL 中,Syndesis.my-minishift.syndesis.io 与 Fuse Online 环境匹配。

来自 SAP Concur 的响应应该提供:

  • 用于登录到 SAP Concur 实施网站的用户名和密码。
  • 您在 Fuse Online 开发环境 Settings 页面中指定的客户端 ID 和客户端 secret 值来配置 Fuse Online SAP Concur connector。

21.3. 如何获取 SAP Concur production site OAuth 凭证

要获取授权 Fuse Online 访问 SAP Concur Developer Center Getting Started 页面的 OAuth 凭证,请按照相关说明进行操作。

21.4. 配置 SAP Concur connector

要在集成中连接到 SAP Concur,您必须配置 Fuse Online SAP Concur connector。然后,您可以使用连接器创建与 SAP Concur 的连接。

先决条件

  • 您知道,您是否要配置 SAP Concur connector,以访问 SAP Concur 实施网站或 SAP Concur production 站点。
  • 已获得了 OAuth 凭证,用于授权您的 Fuse 在线环境访问相应的 SAP Concur 站点。

流程

  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 冲突连接。

21.5. 创建 SAP 冲突连接

要在集成中连接到 SAP Concur,您必须首先创建一个 SAP Concur 连接,然后添加到任意数量的集成中。当您创建 SAP Concur 连接时,您要授权连接使用您在创建连接时输入的登录凭证访问 SAP Concur。

先决条件

  • 在您要创建连接的 Fuse Online 环境中,您必须已经配置 SAP Concur 连接器。
  • 您应该了解连接器是否配置为访问 SAP Concur 实施站点或 SAP Concur production 站点。
  • 您必须有用户名和密码才能登录到配置了 SAP Concur connector 的 SAP Concur 网站。

流程

  1. 在 Fuse Online 中,在左侧面板中,单击 Connections 以显示任何可用的连接。
  2. 单击 Create Connection 以显示可用的连接器。连接器是用来创建一个或多个连接的模板。
  3. SAP Concur connector。
  4. Configure Connection 页面中,点 Connect SAP Concur,它会进入配置连接器的 SAP Concur 站点。

    如果没有出现 Connect SAP Concur,则不会配置 Fuse Online 环境中的 SAP Concur connector。请参阅配置 SAP 冲突连接器

    如果出现 redirect_uri 错误或之前未注册,则 SAP Concur connector 配置不正确。返回到 Fuse Online Settings 页面,以更新并验证连接器配置。

  5. 在 SAP Concur OAuth 站点上:

    1. 输入您希望此连接用来访问 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 connection to the implementation 站点。
  8. Save 以查看您创建的连接现在可用。如果您输入了示例名称,您会看到 SAP Concur Test1 显示为一个可以添加到集成的连接。

21.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 中心 并展开 v3.0

  4. Next 将连接添加到流。

结果

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

21.7. 将集成数据字段映射到 SAP Concur 字段的示例

在大多数集成中,您需要在连接到 SAP Concur 之前添加数据映射步骤。在 data 映射步骤中,您要将之前集成步骤中可用的数据字段映射到 SAP Concur action 参数。在 data mapper 中,Target 面板显示您在将 SAP Concur connection 添加到集成的时所选择的操作的 SAP Concur 参数。

假设集成首先是执行 SQL 存储过程来获取新项目代码。集成通过向 SAP Concurs 添加新项目代码来完成。以下流程提供了 SAP Concur 连接前数据映射程序示例。集成视觉化显示,Fuse Online 正在提示您添加到集成中。

  1. 在集成视觉化中,点 SAP Concur finish 连接前的加号。
  2. Data Mapper。当数据字段出现时,左侧的 Sources 面板会显示数据库连接中可用的字段。在本例中,源字段包含 concur-list-idproject-code。右侧的 Target 面板显示连接执行的更新列表操作的 SAP Concur id内容 参数。
  3. concur-list-id source 字段映射到 id target 字段。
  4. project-code 源字段映射到 内容 目标字段。
  5. 在右上角,点 Done 将 data mapper 步骤添加到集成中。

第 22 章 连接到 ServiceNow

集成可以从 ServiceNow 表检索记录,或者将记录添加到 ServiceNow 导入集,ServiceNow 用来更新表。在集成中,要连接到 ServiceNow,请创建一个 ServiceNow 连接,然后将该连接添加到集成中。详情请查看:

22.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,则实例名称为 bc12345
    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. 验证成功后,单击 下一步
  5. Name 字段中输入可帮助您将此连接与其他连接相区分的名称。例如,输入 ServiceNow Con 1
  6. Description 字段中输入任何有助于了解这个连接的信息。例如,输入 使用管理凭证的 ServiceNow 连接。
  7. Save 以查看您创建的连接现在可用。如果您输入了示例名称,您会看到 ServiceNow Con 1 显示为可选择添加到集成的连接。

22.2. 从 ServiceNow 获取记录以触发集成执行

要在从 ServiceNow 接收记录时触发集成的执行,请在其开始连接时向简单集成添加 ServiceNow 连接。

先决条件

  • 您创建了 ServiceNow 连接。
  • 您知道要从中检索记录的表的名称。
  • 您应该已经定义了一个 ServiceNow 查询,它只获取您想要的记录。您可以在此处查找有关 ServiceNow 查询的信息:ServiceNow 编码的查询

流程

  1. 在左侧的 Fuse Online 面板中,单击 Integrations
  2. Create Integration
  3. Choose a connection 页面中,点您要用来开始集成的 ServiceNow 连接。
  4. Choose a action 页面中,选择 Retrieve Record 从您选择的 ServiceNow 表中获取记录。
  5. 配置 Retrieve Record 操作:

    1. Table name 字段,然后选择您要从中获取记录的表。
    2. Query 以过滤结果集 字段中,输入 ServiceNow 查询。例如,考虑在保留事件记录的表上 state=1^ impact=2 查询。此查询会返回具有中等影响(影响=2)的新事件的记录(status=1)。如果您没有输入查询,且表中的记录不会更改,则每次连接会获得相同的记录。
    3. 每个页面字段的限制元素中,输入您要连接获取的最大 记录数。在本发行版本中,您必须输入一个值,推荐是输入 1000 或 less,且不支持分页。
    4. Period 字段中,指示您要获取记录的频率。默认值为每分钟。换句话说,Fuse Online 每 60 秒执行此集成。
    5. 点击 Next

结果

Fuse Online 生成 JSON 模式,用于定义所获取记录的结构。这可让您在集成中的下一个连接前添加数据映射步骤(如果需要数据映射)。

Fuse Online 提示您选择完成连接。

22.3. 在 ServiceNow 中创建导入集合

在 Fuse Online 集成中,ServiceNow 连接无法直接更新 ServiceNow 表。要更新集成中的 ServiceNow 数据,先决条件是 ServiceNow 表的导入集合。

通常,创建导入集的最简单方法是创建 ServiceNow 入站 Web 服务。这会隐式创建 ServiceNow 导入集。导入集基于管理员在创建 Web 服务时选择的 ServiceNow 目标表。ServiceNow 连接会更新这个导入集,ServiceNow 使用导入集来更新对应的 ServiceNow 表。

先决条件

您必须具有 ServiceNow 管理权限。

ServiceNow 中的步骤

  1. 在 ServiceNow 中,搜索 Web 服务
  2. 在系统 Web Services > Inbound 下点击 Create New
  3. Create Web Service 页面中:

    1. Label 字段中,指定 web 服务的显示名称。Web 服务的导入集也具有此名称。
    2. Target table 字段中,选择此服务更新的 ServiceNow 表。
    3. 从目标表中选择 Copy fields。这会创建一个与目标表相同的 schema 的导入集合。导入集是更新目标表的暂存区域。
    4. 选择 Create transform map。此映射可让 ServiceNow 复制并将数据从导入集转换为目标表。
  4. Create
  5. 在下一显示,在 Related Links 下,单击 Auto Map Matching Fields 以显示您选择的目标表中的字段列表。
  6. 选择一个目标表字段,作为关联(或 coalesce)字段。

    当导入集中的 correlation 字段的值与目标表中的 correlation 字段的值匹配时,ServiceNow 更新该记录,而不是创建新记录。

  7. 选择 Coalesce 来标识您刚刚选择作为关联字段的字段。如果没有关联字段,ServiceNow 会在导入设置为目标表中添加每个记录。
  8. Update
  9. 确认是否已创建转换映射:

    1. 在 ServiceNow 中,搜索 转换映射
    2. System Import Sets 下,单击 Transform Maps 以显示转换映射列表。
    3. 在这个列表中,确认有一个转换映射,其 name 是您为您创建的 web 服务标签指定的值。

22.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 表中的关联字段的目标字段。

22.5. Salesforce 到 ServiceNow 集成示例

这个示例描述了两个简单集成:

  • 个集成可从 Salesforce 网站获取新案例,并将其作为事件添加到 ServiceNow。
  • 其他集成包括了来自 Salesforce 的更新问题单,并在 ServiceNow 中更新相应的事件。

先决条件(在 ServiceNow 中)

对于这两种集成,ServiceNow 管理员是创建入站 Web 服务的先决条件。这隐式创建 ServiceNow 导入集合,集成才能向 ServiceNow 添加数据。在此例中:

  • Web 服务的名称 是来自 Salesforce 的问题单
  • 该服务的目标表是 事件的。此表包含要更新的数据。
  • 导入集合的 schema 与 Incidents 表相同,因为 从目标表中选择 Copy 字段。导入集合的名称也是 来自 Salesforce 的问题单
  • ServiceNow 可能会因为 Create transform 映射 的选择,从 Salesforce 导入集复制数据并将其转换为 Incidents 目标表。
  • 在导入集合中,因为选择 correlation_Id 字段随后选择 Coalesce,所以关联字段是 correlation_Id

流程概述(在 Fuse Online 中)

在 Fuse Online 中,您要创建 Salesforce 和 ServiceNow 连接。

两个集成是相同的,除了 Salesforce 连接执行的操作外,如以下步骤中所述。要创建集成,您需要执行两次步骤,即,一次创建每个集成:

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

    • 要创建获取新情况的集成,请选择 On create 操作。
    • 要创建获取更新问题单的集成,请选择 On update 操作。
  2. 选择要操作的 Case 对象。这个 Salesforce 连接会根据所选操作返回新的 Case 对象或更新的问题单对象。
  3. 添加 ServiceNow 连接作为完成连接。
  4. 选择 Create Record 操作,然后从 Salesforce 中选择 Cases 作为集成更新的导入集合。

    这个 ServiceNow 连接会把新的或更新的 Salesforce 问题单添加到 Salesforce 导入集中的问题单

  5. 添加映射的数据映射步骤:

    • Salesforce 问题单 id 到 ServiceNow 导入集合的 correlation_Id
    • Salesforce ServiceNow short_description限制
    • Salesforce description to the ServiceNow description
  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 会更新具有该值的事件。

第 23 章 连接到 Slack

作为业务用户,您可以创建一个连接到 Slack 的集成。到 Slack 的连接可执行以下操作之一:

  • 当您指定的 Slack 频道收到消息时,触发执行简单集成。该集成将消息传递给流程中的下一步。例如,您可以监控 Slack 频道以获取关键字实例,如产品名称。查找包含这些产品名称的消息后,该集成可以在 Gmail 连接中通知适当的联系人。
  • 向特定用户或频道发送信息。例如,当集成从 FTP 服务器下载文件并以某种方式进行处理时,此行为很有用。集成流程可能会通知 Slack 频道或进程成功的用户。

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

23.1. 创建 Slack 连接

在集成中,Slack 连接可以从您指定的频道或向用户发送信息中检索信息。您可以在任意数量集成中使用同样的 Slack 连接。

先决条件

  • 创建并安装 Slack 应用程序,以将 Fuse Online 连接到 Slack:

    • 使用 Bot User OAuth Access Token 作为消费者端点的令牌。
    • 将相关的用户令牌范围添加到应用程序中,以授予其权限来查看消息:

      history(频道:historygroup:historympim:historyim:history

      读取(频道:readgroup:readmpim:readim:read

  • 您可获取 Slack 应用的 Slack Webhook URL。
  • 您可以获取授权访问 Slack 应用的 Bot User OAuth 访问令牌。

流程

  1. 在 Fuse Online 中,在左侧面板中,单击 Connections 以显示任何可用的连接。
  2. 单击 Create Connection 以显示 Fuse Online 连接器。
  3. Slack 连接器。
  4. Slack Webhook URL 字段中,输入 Slack 应用的 Webhook URL。
  5. 用于访问 Slack API 的 Token 中,输入 Bot User OAuth Access Token,该令牌可从 Slack 应用的 OAuth & Permissions 页面获取。
  6. 另外,还可为附加参数输入值:

    • Sending username for message 项中输入 bot 在向 Slack 发送消息时具有的用户名。
    • Message avatar emoji 字段中,指定 bot 在发送消息时用作消息 avatar。示例: :smile: :wave:, :question:.

      提示

      搜索 web 的 emoji cheat sheet,以查看一些 emoji 代码。

    • Message avatar 图标 URL 字段中,指定 bot 在向 Slack 发送消息时使用的 avatar 的 URL。

    如果您指定了 emoji 和一个图标 URL,则集成将使用图标 URL。如果您既没有指定 emoji 或一个图标 URL,则会在没有 avatar 的情况下发送该消息。

  7. 单击 Validate。Fuse Online 立即尝试验证连接并显示一条消息,指示验证是否成功。如果验证失败,则调整连接配置值并重试。
  8. 如果验证成功,点 下一步
  9. Name 字段中输入您的选择的名称,帮助您将这个连接与任何其他连接区分开来。例如,在 跟踪公司销售时输入 Slack
  10. Description 字段中输入任何有助于了解这个连接的信息。
  11. Save 查看更新可用连接列表,包括您刚才创建的连接。如果您输入了示例名称,您会看到 Tracking Company Sales 的 Slack 做为一个连接,您可以选择添加到集成中。您可以将这个连接添加到任意数量的集成中。

23.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 将连接添加到集成。

23.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 用户或频道的消息。请参阅添加 数据映射程序步骤

第 24 章 连接到 SQL 数据库

在集成中,您可以连接到以下任一类型的 SQL 数据库:

  • Apache Derby
  • MySQL
  • PostgreSQL

创建在集成中要访问的数据库的连接。然后,创建集成并将该数据库连接添加到集成中。

要连接到其他类型的数据库,您必须上传该数据库的 JDBC 驱动程序。

详情请查看以下主题:

24.1. 创建数据库连接

您可以为您要在集成中连接的每个数据库创建一个单独的连接。您可以在多个集成中使用相同的连接。

数据库连接在您指定的数据库表上运行,或调用您指定的存储过程。

前提条件

集成连接到数据库时,必须存在数据库表或存储的流程。

流程

  1. 确保您要连接到的数据库的 JDBC 驱动程序在您的类路径上。如果您上传了 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 字段中输入数据库的架构名称。如何指定数据库模式因每种数据库类型而异。详情位于下一节: 如何在数据库连接中指定模式
  6. 单击 Validate。Fuse Online 尝试验证连接并显示一条消息,指示验证是否成功。如果验证失败,请根据需要修改配置详情并重试。
  7. 如果验证成功,点 下一步
  8. Name 字段中输入您的选择的名称,帮助您将这个连接与任何其他连接区分开来。例如,输入 PostgreSQL DB 1
  9. Description 字段中输入任何有助于了解这个连接的信息。例如,输入 使用我的登录凭证的 Sample PostgreSQL 连接。
  10. Save 以查看您创建的连接现在可用。如果您输入了示例名称,您会看到 PostgreSQL DB 1 显示为一个可以添加到集成的连接。

24.2. 如何在数据库连接中指定 schema

在 Fuse Online 中,当您创建数据库连接时,用户界面会提示您指定数据库的模式。如何指定模式因每个数据库而异。下表显示了每个数据库需要什么。

数据库连接配置示例备注

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

使用扩展机制上传驱动程序。https://access.redhat.com/documentation/zh-cn/red_hat_fuse/7.11/html-single/integrating_applications_with_fuse_online/index#creating-jdbc-driver-library-extensions_extensions然后创建一个连接。如果您还没有上传驱动程序,连接验证会失败。您必须在连接 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 不支持 schema。当您创建与 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 数据库驱动程序。https://access.redhat.com/documentation/zh-cn/red_hat_fuse/7.11/html-single/integrating_applications_with_fuse_online/index#creating-jdbc-driver-library-extensions_extensions然后,创建连接。如果驱动程序尚未上传,连接验证会失败。
架构是数据库名称。您必须有权访问这个数据库实例的权限,在 Oracle 术语中被称为 schema。将 Schema 字段留空。在 Connection 字段中,您必须引用这个数据库实例的 Oracle 系统标识符(本例中为xe )。

PostgreSQL

Connection URL (JDBC URL): jdbc:postgresql://syndesis-db:5432/sampledb
Username:kurt
Password:mypw
Schema:sampledb

您必须在连接(JDBC)URL 中指定数据库。t 如果要使用 schema,您必须在 Schema 字段中指定它。查询可以引用 form database.schema.table 中的一个表。当引用只指定表名称时,连接首先搜索您在配置连接时指定的模式。如果没有找到表,连接将搜索指定表的公共资源。如需了解更多详细信息,请参阅 PostgreSQL 架构文档

24.3. 获取数据库记录来触发集成执行

要根据调用 SQL 语句或 SQL 存储过程的结果触发集成执行,请选择数据库连接作为集成的启动连接。

前提条件

您创建了数据库连接。

流程

  1. 在左侧的 Fuse Online 面板中,单击 Integrations
  2. Create Integration
  3. Choose a connection 页面中,点击您要用来启动集成的数据库连接。
  4. 在 Choose a action 页面中,选择以下内容之一:

    • 定期调用 您指定的 SQL 语句来获取数据。

      请注意,数据库连接器接受最基本的 SQL 语法。如果要使用复杂的 SQL 语句,您应该使用存储的程序,因为 Database Connector 不会验证存储过程中的 SQL 语法。

    • 定期存储的流程调用 通过定期调用您指定的存储步骤获取数据。
  5. 如果您选择了 Periodic SQL 调用,请在 Query 字段中输入 SQL SELECT 语句,或者获取一个或多个记录的其他标准 SQL 语句。例如: 从 my_db_table 中选择 *。包含必须已存在数据的数据库表。

    如果您选择了 Periodic stored process invocation,在 Procedure name 字段中,选择,或者输入输入所存储流程来获取所需数据。您指定的存储过程必须已经存在。数据库管理员应当已创建在集成中使用的任何存储过程。

  6. Period 字段中输入整数,并指示单元是 毫秒、秒、分钟、小时或天。例如,如果您指定了 5 分钟,连接每五分钟调用指定的声明或存储过程。
  7. 点击 Next

对 SQL 扩展使用的限制

您在 Query 字段中输入的 SQL 语句必须是标准 SQL 结构。Fuse Online 不能识别或解析 SQL 扩展,如代理语言/PostgreSQL(PL/pgSQL)或 Oracle 关系语言扩展为 SQL(PL/SQL)。但是,您可以在存储的程序中使用 SQL 扩展。

结果

Fuse Online 尝试验证连接,这包括检查指定的 SQL 语句是否语法正确,并确认存在声明或存储过程目标数据。如果验证是否成功,Fuse Online 会将启动连接添加到集成中。如果验证失败,Fuse Online 显示有关此问题的消息。根据需要更新您的输入并重试。

24.4. 关于 SQL 语句中更新数据的参数占位符和值

流中中间的数据库连接,或者完成简单集成,可以执行更新数据的 SQL 语句。将数据库连接添加到集成时,您可以在 SQL 语句中指定要执行的占位符参数。在执行期间,当输入参数值位于集合中时,连接可以执行批处理更新。

在 SQL 语句中指定参数

当您创建或编辑集成并添加一个更新数据库的连接时,您可以在 SQL 语句中指定连接在运行时执行的占位符参数,或者可以在运行时执行保存过程中的占位符。例如:

INSERT INTO TODO(task, completed) VALUES(:#param_1, :#param_2)
DELETE FROM TODO WHERE task LIKE :#param_3

要指定这些占位符的值,请在数据库连接前添加数据映射步骤到流中。在 data 映射步骤中,将适当的源数据字段映射到目标数据字段,例如,将源数据映射到 :#param_1:#param_2、和 :#param_3 target 字段。请参阅添加 数据映射程序步骤

使用参数值集合进行批处理更新

在运行时,当数据库连接执行可插入、删除或更新数据的 SQL 语句时,执行的 SQL 语句通常会指定一个或多个占位符参数,例如 :#task。当连接时,到连接的输入可以是一组参数或一组参数集,其中每个元素会为对应的占位符参数定义值。

对数据库连接的输入来自流中的较早连接,如 HTTP 请求(Webhook),或发送到 API 供应商集成的 REST 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}]

使用集合作为输入时,连接会针对每一组参数值执行一次插入操作。在本例中,连接会在表中添加两个记录,每个参数值对应一个。

24.5. 访问中间数据库或完成集成

在集成中,您可以在流程中访问数据库或完成简单的集成。为此,请将数据库连接添加到流中,或作为简单的集成完成连接。

先决条件

  • 您创建了数据库连接。
  • 您正在创建或编辑一个流,Fuse Online 正在提示您添加到集成中。或者,Fuse Online 提示您选择完成连接。

流程

  1. Add to Integration 页面中,点您要添加连接的加号。如果 Fuse Online 提示您选择完成连接,请跳过这一步。
  2. 点您要访问的数据库的数据库连接。
  3. 在 Choose a action 页面中,选择以下内容之一:

    • 通过执行您指定的 SQL 语句,调用 SQL 在数据上运行。

      请注意,数据库连接器接受最基本的 SQL 语法。如果要使用复杂的 SQL 语句,您应该使用存储的程序,因为 Database Connector 不会验证存储过程中的 SQL 语法。

    • 调用存储过程 在数据上运行,方法是调用您指定的操作或选择的存储过程。
  4. 如果您选择了 Invoke SQL,在 SQL 语句 字段中:

    • 对于中间连接,请输入用于获取一个或多个记录的 SQL SELECT 语句,或者输入在一个或多个 记录上运行的 SQL INSERTUPDATEDELETE 语句。包含数据的数据库表必须已存在。
    • 对于完成连接,请输入 SQL INSERT,UPDATEDELETE 语句以对一个或多个 记录进行操作。
    • Batch update 字段中,接受 No (默认值)或选择 Yes

      当对这个操作的输入是一个集合时,Batch 更新 的设置会影响连接行为,而 SQL 语句插入、删除或更新记录。默认行为(批处理更新为 No)是连接只接受单个对象,并为每个对象执行一次 SQL 语句。当 批处理更新为 时,连接接受集合,作为操作的输入。连接将执行一次 SQL 语句,并使用所有集合项作为批处理更新操作的输入。

    如果您选择了 Invoke stored 的流程,在 Procedure name 字段中,选择,或者输入要调用以针对感兴趣的数据操作的存储程序的名称。您指定的存储过程必须已经存在。数据库管理员应当已创建在集成中使用的任何存储过程。

  5. 点击 Next

结果

Fuse Online 尝试验证连接,其中包括检查指定的 SQL 查询语法是否正确,并确认是否存在查询或存储过程目标数据。如果验证是否成功,Fuse Online 会将连接添加到流程中。如果验证失败,Fuse Online 显示有关此问题的消息。根据需要更新您的输入并重试。

24.6. 连接到专有数据库

要连接到专有 SQL 数据库,必须完成的主要任务如下:

  1. 开发人员会创建一个库扩展,其中包含您要在集成中您要访问的数据库的 JDBC 驱动程序。请参阅创建 JDBC 驱动程序库扩展
  2. 开发人员提供了一个包含库扩展的 .jar 文件。
  3. 您可以将该 .jar 文件上传到 Fuse Online。请参阅生成 扩展可用
  4. 您可以通过选择 Fuse Online Database 连接器并指定数据库的连接 URL 来创建与数据库的连接。请参阅创建数据库连接
  5. 在集成中,您将连接添加到您的数据库。请参阅通过访问 中间数据库或完成集成 来启动集成

第 25 章 连接到 Telegram

作为业务用户,您可以创建一个连接到 Telegram 的集成。到 Telegram 的连接可执行以下操作之一:

  • 当您指定消息的 Telegram bot 时触发简单的集成执行。该集成将消息传递给流程中的下一步。例如,在简单集成收到一条信息后,可能会有一个过滤器步骤来监视产品名称等关键字实例。查找包含这些产品名称的消息后,该集成可以在 Gmail 连接或不同的 Telegram 连接中通知适当的联系人。
  • 向特定的 Telegram 聊天发送消息。例如,当集成从 FTP 服务器下载文件并以某种方式进行处理时,此行为很有用。您可以添加 Telegram 连接,以通知 Telegram chat,此进程可以成功。

要连接到集成的 Telegram,请创建一个 Telegram 连接,然后向集成流添加连接。详情在以下主题中:

25.1. 创建 Telegram 连接

在集成中,Telefgram 连接可以接收已发送到特定聊天的消息。您创建的 chat bot 将消息转发给 Fuse Online。Telegram 连接也可以向聊天消息发送该连接可访问的聊天。您可以使用相同的 Telegram 连接:

  • 在任意数量使用连接将消息发送到 聊天 中。
  • 另外,您可以在一个集成中使用它来接收来自 Telegram 聊天的消息。

换句话说,如果您希望连接在两个集成中接收 Telegram 通讯消息,则无法在多个集成中使用相同的 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 查看更新可用连接列表,包括您刚才创建的连接。如果您输入了示例名称,您会看到 Product Mentions 的 Telegram 表示,您可以选择添加到集成中的连接。您可以将这个连接添加到任意数量的集成中。

25.2. 添加 Telegram 连接,以在接收消息时触发集成执行

Telegram 连接,每次连接收到来自您指定的 Telegram chat bot 的消息时,会启动集成触发器执行。

先决条件

  • 您创建了 Telegram 连接。
  • 您正在创建一个简单集成和 Fuse Online,提示您选择如何开始集成。

流程

  1. 点您要用来开始集成的 Telegram 连接。
  2. 选择 Read Messages 操作以接收发送到 chat bot 的所有信息。

    连接配置标识您要从中接收消息的 chat bot。不需要其他配置。

25.3. 添加 Telegram 连接,以在 Telegram 聊天中发送消息

在集成中,您可以在流的中间向 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 聊天的 ID。

    如果您将此字段留空,如果早期有 Telegram 连接接收消息,则 Fuse Online 将使用传入消息中的 chat ID。

    要获得聊天的 ID:

    1. 在 Telegram 中,在您要发送消息的聊天中添加 bot。BotFather 响应包括 bot 访问令牌。
    2. 将访问令牌复制到剪贴板。
    3. 在 Telegram 中,将消息直接发送到该 chat。不要使用 bot 来发送消息。
    4. 通过以以下格式调用 curl 命令,读取发送到该聊天的消息。将 bot-access-token 替换为剪贴板中的访问令牌。

      curl https://api.telegram.org/bot-access-token/getUpdates\?offset\=0

      响应采用 JSON 格式。JSON chat 对象包含 chat ID。

  5. Next 将连接添加到流。

第 26 章 连接至witter

要在集成中连接到 Twitter,主要步骤如下:

您需要一个 Twitter 开发人员帐户,将 Fuse 在线环境的访问权限授权给 Twitter。如果您还没有witter 开发人员帐户,请转到 https://apps.twitter.com,登录 Twitter,然后单击 Apply for developer 帐户。当您提供专业电子邮件地址(如 me@redhat.com )而不是个人地址(如 you@gmail.com )时,可以快速获取开发人员帐户。

26.1. 将 Fuse Online 注册为 Twitter 客户端应用程序

在集成中,要连接到 Twitter,您必须先执行的第一个操作是将 Fuse 在线环境注册为可访问 Twitter 的客户端应用程序。这可让您创建连接到 Twitter 的任何数量集成。换句话说,您需要在 Twitter 中注册特定的 Fuse Online 环境。

在每个 Fuse 在线环境中,每个 Fuse 在线环境中只能将一个 Fuse Online 注册为 Twitter 客户端应用程序。但是,虽然每个 Twitter 连接都使用相同的注册,但它会使用不同的用户凭证。

前提条件

您已登录到 Fuse Online。

流程

  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. Projects & Apps
    2. Overview 页面中,向下滚动到 STand standalone Apps,然后单击 Create App
    3. App name 字段中输入一个名称,如 My Fuse Online Client
    4. 向下滚动到 Setup Your App,然后点 App settings
    5. 向下滚动到 用户身份验证设置, 单击 Set up
    6. OAuth 1.0a 选项上切换。
    7. 对于 App 权限,请选择 Read and write and Direct 消息
    8. Callback URL 字段中,粘贴您在此流程开始时复制的 URL。它应该类似: https://app-proj912876.7b63.fuse-ignite.openshiftapps.com/api/v1/credentials/callback
    9. Website URL 字段中,再次粘贴 URL,并从 URL 末尾删除 /api/v1/credentials/callback

      您可以跳过下一几个字段。

    10. 点击 Save
    11. 在您刚才创建的应用程序页面的顶部,点击 Keys 和 tokens 选项卡。
    12. Consumer Keys 下,点 Regenerate,然后验证您要重新生成它们。
    13. 复制 API 密钥。
  3. 返回到您的 Fuse Online Settings 页面,并将 Twitter consumer API 密钥粘贴到 Fuse Online Twitter Consumer API Key 字段中。
  4. 返回到 Twitter Keys 和 tokens 选项卡,再复制使用者 API secret 密钥。
  5. 返回到您的 Fuse Online Settings 页面,并将 Twitter 使用者 API secret 密钥粘贴到 Fuse Online Twitter Consumer API Secret Key 字段中。
  6. 点击 Save
  7. Twitter 条目折叠它。

26.2. 创建 Twitter 连接

要创建从 Twitter 获取数据的集成,您必须首先创建一个 Twitter 连接。创建 Twitter 连接后,您可以在任意数量集成中使用它。

先决条件

  • 您已登录到 Fuse Online。
  • Fuse Online 在网页浏览器中打开。
  • 将 Fuse Online 环境注册为可访问 Twitter 的应用程序。
  • 您会将您在注册后收到的 Twitter 使用者 API 密钥和消费者 API secret 密钥添加到 Fuse Online Settings 页面。

流程

  1. 在 Fuse Online 中,在左侧面板中,单击 Connections 以显示任何可用的连接。
  2. 单击 Create Connection 以显示可用的连接器。连接器是用来创建一个或多个连接的模板。
  3. Twitter 连接器。
  4. 单击 Connect Twitter 以显示 Twitter 授权页面。在看到授权页面前,您可能需要登录 Twitter。

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

  5. 单击 Authorize 应用,返回到 Fuse Online。
  6. Name 字段中输入您的选择的名称,帮助您将这个连接与任何其他连接区分开来。例如,输入 Twitter Connect 1
  7. Description 字段中输入任何有助于了解这个连接的信息。例如,输入 使用 my Twitter 登录凭证的 Sample Twitter 连接。
  8. Save 以查看您创建的连接现在可用。如果您输入了示例名称,看 witter Connect 1 显示为可选择添加到集成的连接。

26.3. 添加 Twitter 连接来触发集成执行

在简单的集成中,启动连接可以是 Twitter 连接,在发现某些调整或直接消息时触发集成执行。

先决条件

  • 您创建了 Twitter 连接。
  • 您需要创建或编辑简单的集成,而 Fuse Online 会提示您选择启动连接。

流程

  1. 点击启动集成的 Twitter 连接。当集成使用所选连接连接到 Twitter 时,Fuse Online 使用那个连接中定义的凭证。
  2. 选择您要连接执行的操作。您添加到集成的 Twitter 连接仅执行您选择的操作:

    • 提到 monitor Twitter,其中包含为其授权了该连接被授权给 Twitter 帐户的 Twitter 帐户。发现此类调整后,连接会将其返回到 Fuse Online,从而会触发集成的执行。
    • 检索 定期轮询 Twitter,以便向 Twitter 帐户发送的直接消息(witterwitter 连接被授权才可以访问)。在查找此类消息时,连接会将它们返回到 Fuse Online,从而会触发集成的执行。
    • 搜索 会定期轮询为符合您指定的条件的 Twitter。在发现此类调整后,连接会将它们返回到 Fuse Online,从而会触发集成的执行。
  3. 配置您选择的操作:

    • 说明 不需要任何配置。
    • retrieve

      • 数量的默认值为 100,您不应该需要更改此值,这会影响内部行为。但是,不要将此值设置为小于 50 的值,因为这样做可能会降低性能。

        Retrieve 操作总是返回过去 30 天内收到的所有未返回直接消息。如果您没有选择 之前找不到的 Ignore direct 消息,则 Retrieve 操作会返回过去 30 天内收到的所有消息。

      • delay 是轮询间隔的时间。Twitter 强制实施速率限值,因此您不应该经常轮询。默认间隔为 5 秒。
      • 忽略前面找到的直接消息 仅在需要时返回新信息。
    • 搜索

      • delay 是轮询间隔的时间。Twitter 强制实施速率限值,因此您不应该经常轮询。默认间隔为 5 秒。
      • 忽略之前找到的调整 仅会在选择时返回新的调整。
      • query 是一个 Twitter 格式的搜索表达式,用于指定您希望连接返回的调整。下表提供了您可以输入的内容的示例。此 Twitter 文档中提供了搜索 operator 的更多详细信息。

        查询

        结果

        我的产品

        获取包含 MyProduct 的调整内容,但不一定是 My Product

        "我的产品"

        获取包含 My Product 实例的调整内容。

        我的 OR 产品

        获取包含 MyProduct 实例或每个实例的调整者。

        my -Product

        获取包含 My 实例的调整内容,不包含 产品 的实例。

        #MyProduct

        获取包含 MyProduct hashtag 的 tweets。

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

结果

现在,集成具有启动连接,Fuse Online 正在提示您选择完成连接。

26.4. 添加发送直接消息的 Twitter 连接

在流中,或完成简单的集成中,您可以添加Twitter 连接,该连接会将直接消息发送到 Twitter 用户。直接消息是仅前往指定用户的专用消息。

先决条件

  • 您创建了 Twitter 连接。
  • 您正在创建或编辑一个流,Fuse Online 正在提示您添加到集成中。或者,对于简单集成,Fuse Online 会提示您选择完成连接。

流程

  1. Add to Integration 页面中,点您要添加 Twitter 连接的加号。
  2. 点您要添加到集成的 Twitter 连接。当集成使用所选连接连接到 Twitter 时,Fuse Online 使用那个连接中定义的凭证。
  3. 选择 Send 操作。
  4. Default Message 字段中,输入您希望连接在 data mapper 步骤没有将上一步中直接消息内容映射到这个 Twitter 连接的消息。虽然您必须在配置此witter 连接时输入消息,但您从上一步中映射的消息优先于您在这里指定的消息。
  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. 在美国和/或其他国家/地区的注册商标。
所有其他商标均由其各自所有者所有。