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 步骤。