11.2. 连接到 Gmail
要在特定 Gmail 帐户收到电子邮件时触发集成执行,请在启动连接时将 Gmail 连接添加到简单集成。在集成中,要从特定的 Gmail 帐户发送电子邮件,请执行以下操作之一:
- 向流的中间添加 Gmail 连接。
- 添加 Gmail 连接以完成简单的集成。
在集成中连接到 Gmail 的一般步骤有:
- 将 Fuse Online 注册为 Google 客户端应用程序。
- 创建 Gmail 连接.当您执行此操作时,您可以选择连接被授权访问的 Gmail 帐户。
- 如果您的集成从 Gmail 帐户发送电子邮件,则决定如何填写要发送的电子邮件。
- 添加 Gmail 连接到集成流程.
- 对于发送电子邮件的 Gmail 连接,可选择将集成数据映射到电子邮件字段。
信息和说明位于以下主题:
11.2.1. 创建 Gmail 连接
当您创建 Gmail 连接时,您授权连接访问一个特定的 Gmail 帐户。创建 Gmail 连接后,您可以将其添加到多个集成中。
先决条件
- 您已将 Fuse Online 注册为 Google 客户端应用程序 并启用了 Gmail API。
- Gmail 的 Fuse Online Settings 页面条目具有客户端 ID 和客户端 secret 的值,您可以通过将 Fuse Online 注册为 Google 客户端应用程序来获取。
流程
- 在 Fuse Online 中,在左侧面板中,单击 Connections 以显示任何可用连接。
- 点 Create Connection 以显示可用的连接器。连接器是一个模板,用于创建一个或多个连接。
- 点 Gmail 连接器。
在 Configure Connection 页面中,单击 Connect Gmail,这将进入 使用 Gmail 页面的 Sign in。
如果没有显示 Connect Gmail,您的 Fuse Online 环境不会注册为 Google 客户端应用程序。请参阅 将 Fuse Online 注册为 Google 客户端应用程序。当您尝试创建 Gmail 连接并且 Fuse Online 环境没有注册为 Google 客户端应用程序时,Fuse Online 会显示多个提示授权信息的字段。虽然您可以通过在这些字段中输入值来创建 Gmail 连接,但不推荐这样做。
- 在提示您登录 Gmail 的页面中,输入您希望此连接从 Fuse Online 访问的 Google 帐户的电子邮件地址,然后单击 Next。
- 要响应 openshiftapps.com 想要访问 Google 帐户,请单击 Allow to return to Fuse Online。
-
在 Fuse Online Name 字段中输入您选择的名称,以帮助您将这个连接与任何其他连接区分开来。例如,输入
Gmail Connect 1
。 -
在 Description 字段中,输入有助于了解此连接的任何信息。例如,输入
使用 jkim Gmail 帐户凭证的 Sample Gmail 连接。
- 点 Save 查看您创建的连接现在可用。如果您输入了示例名称,您会看到 Gmail Connect 1 显示为一个连接,您可以选择添加到集成。
11.2.2. 填充电子邮件发送的替代方案
完成简单集成或位于流中间的 Gmail 连接,从连接被授权访问的 Gmail 帐户发送电子邮件。可以通过多种方式填充连接发送的电子邮件的内容。在添加发送电子邮件的 Gmail 连接之前,请考虑如何填充该电子邮件。
填充要发送的电子邮件的替代方案如下:
只需在发送电子邮件的 Gmail 连接之前添加数据映射程序步骤。在这个数据映射程序步骤中,将作为前面步骤输出的数据字段映射到 Gmail connection Send Email action 字段。Send Email action 字段有:
- 电子邮件到
- 电子邮件主题
- 电子邮件文本
- 电子邮件 cc
- 电子邮件 bcc
如果添加数据映射程序步骤,您可以映射 one、some 或 all Send Email action 字段。
- 将 Gmail 连接添加到流时,通过在 Send Email action 字段中指定值来配置操作。您可以在 one、some 或 all 字段中指定值。
使用数据映射程序步骤和 发送电子邮件 操作配置来填充字段。换句话说,您可以通过指定一个或多个字段来配置 Send Email 操作,并添加填充其他字段的数据映射程序步骤。
您直接在 Send Email action 字段中指定的值优先于映射到 Send Email action 字段的值。换句话说,假设您在添加连接时通过指定一个值来填充 Send Email 字段,并配置该操作,并通过将值映射到同一字段来填充 Send Email 字段。您在操作配置中指定的值始终覆盖映射的值。例如,假设您在 Email to action 字段中指定
people@redhat.com
,您还会将上一步中的电子邮件字段映射到 Gmail Email to 字段。集成始终使用people@redhat.com
作为电子邮件地址。
当您添加发送电子邮件的 Gmail 连接时,所有操作配置参数都是可选的。这是因为,您可以选择通过将集成数据映射到 Send Email action 字段来完全填充电子邮件。但是,根据操作配置规格或映射,在 Email to 字段中存在电子邮件地址。如果没有要将邮件发送到的电子邮件地址,Fuse Online 会生成运行时错误,集成将停止执行。
11.2.3. 轮询返回 Gmail 消息时触发集成
要根据特定 Gmail 帐户接收的电子邮件触发集成执行,请在简单集成的开始连接中添加 Gmail 连接。当集成运行时,Gmail 连接会按您控制的间隔检查此帐户是否有电子邮件。当连接找到未读取电子邮件时,它会将电子邮件传递给集成中的下一步,默认情况下,将电子邮件标记为 读取。
先决条件
- 您创建了 Gmail 连接,该连接有权访问您要从中获取电子邮件的 Gmail 帐户。
流程
- 在左侧的 Fuse Online 面板中,单击 Integrations。
- 点 Create Integration。
- 在 Choose a connection 页面上,单击您要用来启动集成的 Gmail 连接。
- 在 Choose an action 页面上,选择 Receive Email 操作。
配置 Receive Email 操作:
- 在 Delay 字段中,接受默认值 30 秒,或者指定集成检查新电子邮件的频率。
- 将 Labels 字段留空以获取任何未读取电子邮件。要只获取某些电子邮件,请指定连接正在访问的 Gmail 帐户中使用的以逗号分隔的标签列表。默认情况下,集成会获取具有这些标签的未读取电子邮件。
- 选择 Mark as read 以确保连接不会返回同一电子邮件两次。如果没有选择 Mark as read,连接会返回位于帐户 ins in 框中的电子邮件,无论它们之前没有被读取。或者,如果您指定了一个或多个标签,则具有这些标签的集成返回电子邮件是否已经读取。
在 Max Results 字段中,接受默认值 5 或指示连接可以为每个轮询返回的最大电子邮件数。如果连接发现超过这个未读取电子邮件的数量,它会返回最新的 Max Results 电子邮件。
当 Gmail 连接返回多个电子邮件时,集成将电子邮件作为批处理。换句话说,Fuse Online 为批处理执行一次集成。
- 点 Next 将这个 Gmail 连接添加为集成中的启动连接。连接作为集成流中的第一个步骤出现。
11.2.4. 从 Gmail 帐户发送电子邮件
在集成中,您可以从 Gmail 帐户在流中或完成简单集成中发送电子邮件。为此,请在流的中间或作为简单集成完成连接中添加 Gmail 连接。
先决条件
- 您创建了 Gmail 连接。
- 熟悉 填充电子邮件进行发送的替代选择, 您有计划填充此类电子邮件。
- Fuse Online 会提示您添加到集成,或选择简单集成的完成连接。
流程
- 在 Add to Integration 页面上,单击您要添加连接的加号。如果 Fuse Online 正在提示您选择完成连接,请跳过这一步。
- 点击您要用来发送电子邮件的 Gmail 连接。
- 在 Choose an action 页面上,选择 Send Email。
在 Configure Send Email 页面中,执行以下操作之一:
- 如果您计划在此连接前添加数据映射程序步骤,并且计划将集成数据映射到 Send Email 字段,请将所有字段留空。
在以下 发送电子邮件 字段中输入信息。使用逗号分隔多个电子邮件地址。
- 电子邮件到
- 电子邮件主题
- 电子邮件文本
- 电子邮件 cc
- 电子邮件 bcc
将一些字段留空,并在某些字段中输入信息。
如果您计划在此 Gmail 连接前添加数据映射程序步骤,而您想要将集成数据映射到某些电子邮件字段,请将这些字段留空。根据需要在其他操作字段中输入值。
您在 Send Email action 配置字段中指定的值优先于上一步中映射的值。
- 点 Next 将连接添加到流。
结果
连接会出现在您添加它的集成流中。
后续步骤
如果您计划在此连接前添加数据映射程序步骤,首先添加您计划添加到此流的任何其他连接。然后添加数据映射程序步骤。