11.3. 连接到 Google Calendar
要在轮询返回更新到 Google 日历时触发集成执行,请在启动连接时将 Google Calendar 连接添加到简单集成。要在日历中添加事件或更新一个事件,您可以执行以下操作之一:
- 向流的中间添加 Google Calendar 连接。
- 添加 Google Calendar 连接以完成简单的集成。
连接到 Google Calendar 的详情位于以下主题:
11.3.1. 创建 Google Calendar 连接
当您创建 Google Calendar 连接时,您可以授权连接访问与一个特定的 Google 帐户关联的 Google Calendars。创建 Google Calendar 连接后,您可以将其添加到多个集成中。
先决条件
- 您已将 Fuse Online 注册为 Google 客户端应用程序 并启用了 Google Calendar API。
- Google Calendar 的 Fuse Online Settings 页面条目具有客户端 ID 和客户端 secret 的值,您可以通过将 Fuse Online 注册为 Google 客户端应用程序来获取。
流程
- 在 Fuse Online 中,在左侧面板中,单击 Connections 以显示任何可用连接。
- 点 Create Connection 以显示可用的连接器。连接器是一个模板,用于创建一个或多个连接。
- 点 Google Calendar 连接器。
在 Configure Connection 页面中,单击 Connect Google Calendar,这将进入 Google 登录页面。
如果没有显示 Connect Google Calendar,则 Fuse Online 环境不会注册为启用了 Google Calendar API 的 Google 客户端应用程序。请参阅 将 Fuse Online 注册为 Google 客户端应用程序。如果没有使用 Google 注册您的环境,那么当您试图创建 Google Calendar 连接时,Fuse Online 会显示多个提示授权信息的字段。虽然您可以通过在这些字段中输入值来创建 Google Calendar 连接,但不推荐这样做。
- 在 Google sign-in 页面中,选择您希望此连接从 Fuse Online 访问的 Google 帐户,然后点 Next。
- 要响应 openshiftapps.com 想要访问 Google Account 提示符,请单击 Allow 以返回到 Fuse Online。
-
在 Fuse Online Name 字段中输入您选择的名称,以帮助您将这个连接与其他连接区分开来。例如,输入
Google Calendar Work Connection
。 -
在 Description 字段中,输入有助于了解此连接的任何信息。例如,输入
Sample Google Calendar 连接,它使用 my Google work 帐户。
- 点 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 连接。
流程
- 在左侧的 Fuse Online 面板中,单击 Integrations。
- 点 Create Integration。
- 在 Choose a connection 页面上,单击您要用来启动集成的 Google Calendar 连接。
- 在 Choose an action 页面上,选择 Get Events 操作。
配置 Get Events 操作:
- 在 Delay 字段中,接受默认值 30 秒,或者指定集成检查日历的频率。
- 在 Calendar name 字段中,输入可以从此 Google Calendar 连接被授权访问的 Google 帐户访问的日历名称。
- 在 Max Results 字段中,接受默认值 5 或指示连接可以为每个轮询返回的最大事件数。
选择以下之一来指示您希望连接用来开始检查事件的日期。连接检查日期和后续日期。
从当前日期开始 于当前日期开始。
例如,如果您选择了这个选项,如果 Max Results 为 5,则 Google Calendar 连接开始检查当前日期上的事件,并返回超过找到的前五个事件。从上一次轮询以来,这些事件是否已更新或添加无关紧要。
从下一次轮询上最后一次事件更新日期的消耗将 在上一个轮询返回的最近更新事件的日期开始。
例如,如果您选择了这个选项,如果 Max Results 为 5,则 Google Calendar 连接不再返回 5 更新或新事件。连接开始检查上一次轮询返回的最近更新事件的日期是否有新的或更新的事件。
(可选)在 Query for events 字段中指定文本来过滤轮询可以返回的事件。连接仅返回包含至少一个事件字段中指定文本的事件。
例如,假设您在查询字段中指定了
Standup meeting
。轮询仅返回在事件字段中具有Standup
meet 的事件。
- 点 Next 将这个 Google Calendar 连接添加为集成的启动连接。
结果
连接作为简单集成中的第一个步骤显示。
11.3.3. 从 Google Calendar 获取特定事件
在集成中,您可以在流中间获取特定的 Google Calendar 事件。获取特定事件很有用,例如,当您想要时:
- 更新后续 Google Calendar 连接中的事件。
- 使用后续的 Twitter 连接宣布事件。
要获取一个事件,请在流的中间添加 Google Calendar 连接。
在本发行版本中,在简单的集成完成连接中获取特定事件时被支持,但它并特别有用。以后的发行版本中应该会改变。
先决条件
- 您创建了 Google Calendar 连接,该连接有权访问 Google Calendar,该连接具有您要获取的事件。
- 您正在创建或编辑流,Fuse Online 会提示您添加到集成。
流程
- 在 Add to Integration 页面上,单击您要添加连接的加号。
- 点授权访问您要连接的日历的 Google Calendar 连接。
- 在 Choose an action 页面上,选择 Get a Specific Event。
- 指定具有您想要事件的日历名称。
指定要获取的事件 ID。要获取事件 ID,请执行以下操作之一:
- 从以前的 Google Calendar 连接映射它。
从日历手动获取它,如下所示:
- 在浏览器中,显示包含您要获取的事件的日历。
-
将
?gsessionid=OK&eventdeb=1
附加到 URL 中,并重新显示日历。 - 在日历中,点击您要获取的事件。
- 在事件弹出窗口中点 并选择 Troubleshooting info。
-
在 Google Calendar 显示的弹出窗口中,复制
eid=
后面的字符串。例如,事件 ID 类似如下:p1pva2a4t504sha12di9ch6k_20181107T150000Z*
。
- 点 Next 将连接添加到流。
结果
连接会出现在您添加它的流中。
后续步骤
如果要将上一步中的任何值映射到此连接中的字段,请添加数据映射器步骤。首先,将所有需要的连接添加到流中。然后,在这个连接前立即添加数据映射程序步骤。
11.3.4. 在 Google Calendar 中添加事件
在集成中,您可以在流的中间向 Google Calendar 中添加事件,或完成简单的集成。为此,请将 Google Calendar 连接添加到流中间,或作为一个简单的集成完成连接。
先决条件
- 您创建了 Google Calendar 连接,它有权访问您要添加事件的 Google Calendar。
- 您正在创建或编辑流,Fuse Online 会提示您添加到集成。或者,Fuse Online 正在提示您选择完成连接。
流程
- 在 Add to Integration 页面上,单击您要添加连接的加号。如果 Fuse Online 正在提示您选择完成连接,请跳过这一步。
- 点一个 Google Calendar 连接,该连接有权访问您要向其添加事件的日历。
- 在 Choose an action 页面上,选择 Create Event 操作。
配置 Create Event 操作:
- 输入新事件的标题。
- 输入 Google Calendar 的名称,将事件添加到其中。
- 对于其他输入参数,您可以输入数据,或者您可能希望从之前 Google Calendar 连接中获取的事件映射值。
- 点 Next 将连接添加到流。
结果
连接会出现在您添加它的集成流中。
后续步骤
如果要将任何值映射到此 Google Calendar 连接中的字段,请将数据映射程序步骤添加到流中。首先,将所有需要的连接添加到流中。然后,在 Google Calendar 连接前立即添加数据映射程序步骤。
11.3.5. 在 Google Calendar 中更新事件
在集成中,您可以更新流中 Google Calendar 中的事件,或完成简单的集成。为此,请将 Google Calendar 连接添加到流中间,或作为一个简单的集成完成连接。
在这个发行版本中,Update Event 操作在每个事件字段中都需要一个值。在大多数情况下,这意味着您必须添加一个 Google Calendar 连接,该连接 获取您要更新的事件,然后添加更新 该事件的 Google Calendar 连接,然后在两个 Google Calendar 连接之间插入一个数据映射程序步骤。
先决条件
- 您创建了 Google Calendar 连接,该连接有权访问具有您要更新的事件的 Google Calendar。
- 在流中,有一个早期与 Google Calendar 的连接,该连接会获取您要更新的事件。
- 您正在创建或编辑流,Fuse Online 会提示您添加到集成。或者,Fuse Online 正在提示您选择完成连接。
流程
- 在 Add to Integration 页面上,单击您要添加连接的加号。如果 Fuse Online 正在提示您选择完成连接,请跳过这一步。
- 点一个 Google Calendar 连接,该连接有权访问具有您要更新的事件的日历。
- 在 Choose an action 页面上,选择 Update Event。
配置 Update Event 操作:
- 输入您要更新的事件的标题。
- 在您要更新的每个事件字段中输入内容。如果您希望该字段中的内容保持不变,请不要在事件字段中输入内容。
- 点 Next 将连接添加到流。连接会出现在您添加它的集成视觉化中。
- 在集成视觉化中,单击刚刚添加的连接前的加号。
- 单击 Data Mapper。
在数据映射程序中,对于更新事件中的每个事件字段,请从 Google Calendar 连接中映射该字段,该连接从 Google Calendar 连接中获取事件到更新事件的 Google Calendar 连接中的对应字段。
不要映射您要更新的字段。如果您映射了一个字段,并在配置 Update Event 操作时为该字段指定一个更新,Fuse Online 将使用映射的值。
- 在右上角,点 Done 添加数据映射程序步骤。