Google Calendar模块

在Adobe Workfront Fusion方案中,您可以自动执行使用Google Calendar的工作流,并将其连接到多个第三方应用程序和服务。

如果需要有关创建方案的说明,请参阅在 Adobe Workfront Fusion中创建方案。

有关模块的信息,请参阅 Adobe Workfront Fusion🔗中的模块。

访问要求

您必须具有以下权限才能使用本文中的功能:

Adobe Workfront 计划*
Pro或更高版本
Adobe Workfront 许可证*
计划,工作
Adobe Workfront Fusion 许可证**

当前许可证要求:无Workfront Fusion许可证要求。

旧版许可证要求:Workfront Fusion for Work Automation and Integration

产品

当前产品要求:如果您有Select或Prime Adobe Workfront计划,则贵组织必须购买Adobe Workfront Fusion和Adobe Workfront才能使用本文中描述的功能。 Workfront Fusion包含在Ultimate Workfront计划中。

旧版产品要求:您的组织必须购买Adobe Workfront Fusion和Adobe Workfront,才能使用本文中介绍的功能。

要了解您拥有什么计划、许可证类型或访问权限,请与Workfront管理员联系。

有关Adobe Workfront Fusion许可证的信息,请参阅Adobe Workfront Fusion 许可证

先决条件

要使用Google Calendar模块,您必须具有Google帐户。

Google日历API信息

Google Calendar连接器使用以下对象:

基本URL
https://www.googleapis.com/calendar/v3
API版本
v3
API标记
v5.4.5

Google Calendar模块及其字段

配置Google Calendar模块时,Workfront Fusion显示下面列出的字段。 除此以外,可能还会显示其他Google Calendar字段,具体取决于应用程序或服务中的访问级别等因素。 模块中的粗体标题表示必填字段。

如果看到字段或函数上方的映射按钮,则可以使用该按钮设置该字段的变量和函数。 有关详细信息,请参阅在 Adobe Workfront Fusion中将信息从一个模块映射到另一个模块。

活动

观看活动

此触发器模块执行在您指定的日历中添加、更新、删除、启动或结束新事件的场景。 该模块返回与一个或多个记录关联的所有标准字段,以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。

配置此模块时,会显示以下字段。

Connection
有关将Google Calendar帐户连接到Workfront Fusion的说明,请参阅创建与AdobeWorkfront Fusion的连接 — 基本说明
日历
选择您希望模块使用的日历。
监视活动
选择要按“创建日期”、“更新日期”、“开始日期”或“结束日期”监视事件。
显示已删除的事件
启用此选项可包含已删除的事件。
Query
输入要搜索的文本。
限制
设置Workfront Fusion在一个周期内处理的最大事件数(每个方案运行的重复次数)。 如果该值设置得过高,则可能会中断与给定第三方服务的连接(超时)。 Workfront Fusion对此没有影响。 我们建议您设置较低的值,并为最大循环数定义较高的值,或者更频繁地运行方案。

搜索事件

此操作模块在选定日历中搜索事件。

指定搜索的日历和参数。

模块会返回事件的ID和任何关联字段,以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。

配置此模块时,会显示以下字段。

Connection
有关将Google Calendar帐户连接到Workfront Fusion的说明,请参阅创建与Adobe Workfront Fusion的连接 — 基本说明
日历ID
选择要搜索的日历。
开始日期

输入或映射事件开始的日期。 此模块还会检索在此日期之前开始的、在输入的开始日期仍然发生的事件。

有关支持的日期和时间格式的列表,请参阅在Adobe Workfront Fusion中键入强制。

结束日期

输入或映射事件结束的日期。

有关支持的日期和时间格式的列表,请参阅在Adobe Workfront Fusion中键入强制。

单个事件
启用此选项可将定期事件视为单个实例。 例如,如果您有一个每周会议并且启用了此选项,模块会将每周的会议作为单独事件返回。
Query
输入或映射要作为搜索依据的搜索词。
Order by

选择结果中返回的事件的顺序。

  • 开始时间:按开始日期和时间(升序)排序。 这仅在查询单个事件时可用。
  • 更新时间:按上次修改时间(升序)排序。
限制
设置在一个执行周期内返回的最大事件数Workfront Fusion。

获取事件

此操作模块返回指定日历中单个事件的元数据。

指定日历和事件。

该模块会返回事件的ID和所有关联的字段,以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。

配置此模块时,会显示以下字段。

Connection
有关将Google Calendar帐户连接到Workfront Fusion的说明,请参阅创建与AdobeWorkfront Fusion的连接 — 基本说明
日历ID
输入或映射包含要获取的事件的日历的ID。
事件ID
输入要获取的现有Google Calendar事件的事件ID。

创建事件

此操作模块创建一个事件。

您可以指定事件的日历和参数。

模块会返回事件的ID和任何关联字段,以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。

配置此模块时,会显示以下字段。

Connection
有关将Google Calendar帐户连接到Workfront Fusion的说明,请参阅创建与Adobe Workfront Fusion的连接 — 基本说明
创建事件

选择您希望如何创建事件。

  • 详细信息

    利用此选项,可更详细地介绍该事件。

  • 快速

    您只需选择日历并输入事件名称即可。 您可以在名称中包含时间和地点详细信息,然后Google Calendar将为该时间和地点安排该事件。

日历ID
选择要显示事件的日历。
颜色
选择事件在日历上显示的颜色。
事件名称

输入或映射事件的名称。

注意:如果您在创建事件字段中选择了快速添加,则可以包含事件的日期和时间,然后Workfront Fusion将针对该日期和时间创建该事件。 示例: Appointment at Capitol Hill on June 3rd 10am-10:25am。 如果您选择了快速添加,但未在事件名称中包含日期和时间,则事件将从当前时间创建,并持续一小时。

全天事件
如果事件是全天事件(不需要开始和结束时间),则启用此选项。
开始日期

如果这是全天事件,请输入事件的起始日期。

有关支持的日期格式的列表,请参阅在Adobe Workfront Fusion中键入强制转换。

结束日期

如果这是全天事件,请输入事件的结束日期。

有关支持的日期格式的列表,请参阅在Adobe Workfront Fusion中键入强制转换。

描述
输入或映射事件的描述。 此字段支持HTML。
位置
在文本表单中输入事件的位置。
对此事件使用默认提醒设置
启用此选项可使用默认提醒设置。 如果您在Reminder字段中设置了自定义提醒,此值将设置为“否”。
提醒
添加事件提醒。 对于每个提醒,选择要用于提醒的方法,并定义要提醒的事件之前的时长(以分钟为单位)。
与会者
将与会者添加到活动。 为每位与会者输入或映射其姓名和电子邮件地址。
显示为
选择您希望查看您的日历的人员在此活动期间将您视为“忙碌”或“可用”。
可见性

选择此事件的可见性。

  • Default

    该事件具有您在日历设置中设置的可见性。

  • Public

    与该日历共享的任何人都可以查看此事件。

  • Private

    只有与会者才能看到此活动。

发送有关事件创建的通知

选择是将有关创建新事件的通知发送给所有来宾、非Google Calendar来宾还是不发送给任何人。

提示:我们建议仅在迁移用例中使用None选项。

来宾可以修改事件
如果希望来宾能够修改此事件,请启用此选项。
循环
添加要应用于此事件的任何周期性规则。 每个规则都需要一个RULE、EXRULE、RDATE和EXDATE行的列表才能处理定期事件。 请注意,此字段不允许出现DTSTART和DTEND行;事件的开始和结束时间在开始和结束字段中指定。 对于单个事件或定期事件的实例,将忽略此字段。 有关详细信息,请参阅RFC5545

更新事件

此操作模块更改现有事件。

请指定日历和事件ID。

模块会返回事件的ID和任何关联字段,以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。

配置此模块时,会显示以下字段。

Connection
有关将Google Calendar帐户连接到Workfront Fusion的说明,请参阅创建与AdobeWorkfront Fusion的连接 — 基本说明
日历
选择要使用的日历。
事件ID
输入先前创建的Google Calendar事件中要更新的事件ID。

您可以通过在所需字段中输入新值来更新事件信息。 有关各个字段的详细信息,请参阅创建事件

删除事件

此操作模块删除事件。

请指定日历和事件ID。

模块会返回事件的ID和任何关联字段,以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。

配置此模块时,会显示以下字段。

Connection
有关将Google Calendar帐户连接到Workfront Fusion的说明,请参阅创建与AdobeWorkfront Fusion的连接 — 基本说明
日历ID
选择包含要删除的事件的日历。
事件ID
输入您要删除的先前创建的Google Calendar事件的事件ID。
发送有关事件删除的通知
选择您希望向所有来宾、未使用Google Calendar的来宾或任何人发送有关事件删除的通知。

日程表

列出日历

此操作模块返回用户日历列表中的日历。

模块会返回日历的ID和任何关联字段,以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。

配置此模块时,会显示以下字段。

Connection
有关将Google Calendar帐户连接到Workfront Fusion的说明,请参阅创建与AdobeWorkfront Fusion的连接 — 基本说明
最低访问角色

选择用户的最低访问角色。 模块会根据此最小访问角色返回日历。

  • 忙/闲信息Reader:用户可以读取忙/闲信息。
  • 所有者:用户可以读取和修改事件,并且可以访问控制列表。
  • Reader:用户可以读取非私有事件。
  • Writer:用户可以读取和修改事件。
显示隐藏日历
启用此选项可在模块返回的列表中包含隐藏的日历。
限制
设置在一个执行周期内返回的最大日历数Workfront Fusion。

获取日历

此操作模块可检索日历。

您可以指定要检索的日历ID。

该模块返回记录ID和任何关联字段,以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。

配置此模块时,会显示以下字段。

Connection
有关将Google Calendar帐户连接到Workfront Fusion的说明,请参阅创建与AdobeWorkfront Fusion的连接 — 基本说明
日历ID
选择要检索的日历。

创建日历

此操作模块将创建新日历。

指定日历的名称。

模块会返回日历的ID和任何关联字段,以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。

配置此模块时,会显示以下字段。

Connection
有关将Google Calendar帐户连接到Workfront Fusion的说明,请参阅创建与AdobeWorkfront Fusion的连接 — 基本说明
日历名称
输入新日历的名称。

更新日历

此操作模块更新日历。

您可以指定要更新的日历的ID。

模块会返回日历的ID和任何关联字段,以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。

配置此模块时,会显示以下字段。

Connection
有关将Google Calendar帐户连接到Workfront Fusion的说明,请参阅创建与AdobeWorkfront Fusion的连接 — 基本说明
日历ID
选择要更新的日历。
日历名称
输入日历的新名称。

删除日历

此操作模块删除日历。

指定要删除的日历的ID。

模块会返回日历的ID和任何关联字段,以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。

配置此模块时,会显示以下字段。

Connection
有关将Google Calendar帐户连接到Workfront Fusion的说明,请参阅创建与AdobeWorkfront Fusion的连接 — 基本说明
日历ID
输入或映射要删除的日历的ID。

清除日历

此操作模块将从帐户的主日历中删除所有事件。

您可以指定连接到包含要清除的日历的帐户的连接。

模块会返回日历的ID和任何关联字段,以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。

配置此模块时,会显示以下字段。

Connection
有关将Google Calendar帐户连接到Workfront Fusion的说明,请参阅创建与AdobeWorkfront Fusion的连接 — 基本说明

访问控制规则

列出访问控制规则

此操作模块返回日历上访问控制列表中的规则。

配置此模块时,会显示以下字段。

Connection
有关将Google Calendar帐户连接到Workfront Fusion的说明,请参阅创建与AdobeWorkfront Fusion的连接 — 基本说明
日历ID
选择包含要检索的访问控制规则的日历。
限制
设置在一个执行周期内返回的最大结果数Workfront Fusion。

获取访问控制规则

此操作模块返回访问控制规则的元数据。

配置此模块时,会显示以下字段。

Connection
有关将Google Calendar帐户连接到Workfront Fusion的说明,请参阅创建与AdobeWorkfront Fusion的连接 — 基本说明
日历ID
选择包含要检索的访问控制规则的日历。
访问控制规则ID
选择要检索的访问控制规则。

创建访问控制规则

此操作模块将创建新的访问控制规则。

指定日历的名称。

该模块会返回访问控制规则的ID和任何关联字段,以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。

配置此模块时,会显示以下字段。

Connection
有关将Google Calendar帐户连接到Workfront Fusion的说明,请参阅创建与AdobeWorkfront Fusion的连接 — 基本说明
日历ID
选择要创建访问控制规则的日历。
角色

选择要分配给访问规则的角色。

  • 忙/闲信息Reader:用户可以读取忙/闲信息。
  • 所有者:用户可以读取和修改事件,并且可以访问控制列表。
  • Reader:用户可以读取非私有事件。
  • Writer:用户可以读取和修改事件。
类型

选择范围的类型。

  • 默认值:公共作用域。 这是默认值。
  • 用户:将范围限制为单个用户。
  • :将范围限制为组。
  • :将范围限制为域。

注意:授予Default或公共范围的权限适用于未经身份验证或未经过身份验证的任何用户。

根据范围类型,输入用户或组的电子邮件地址,或域的名称。
发送通知

启用此选项可发送有关访问更改的通知。

注意:访问删除时没有通知。

更新访问控制规则

此操作模块可更新访问控制规则。

指定日历的名称。

该模块会返回访问控制规则的ID和任何关联字段,以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。

配置此模块时,会显示以下字段。

Connection
有关将Google Calendar帐户连接到Workfront Fusion的说明,请参阅创建与AdobeWorkfront Fusion的连接 — 基本说明
日历ID
选择包含要更新的访问控制规则的日历。
访问控制规则ID
选择要更新的访问控制规则。
角色

选择要分配给访问规则的角色。

  • None:此角色不提供访问权限。
  • 忙/闲信息Reader:用户可以读取忙/闲信息。
  • 所有者:用户可以读取和修改事件,并且可以访问控制列表。
  • Reader:用户可以读取非私有事件。
  • Writer:用户可以读取和修改事件。
发送通知

启用此选项可发送有关访问更改的通知。

注意:访问删除时没有通知。

删除访问控制规则

此操作模块删除访问控制规则。

指定日历的名称。

该模块会返回访问控制规则的ID和任何关联字段,以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。

配置此模块时,会显示以下字段。

Connection
有关将Google Calendar帐户连接到Workfront Fusion的说明,请参阅创建与AdobeWorkfront Fusion的连接 — 基本说明
日历ID
选择或映射包含要删除的访问控制规则的日历的ID。
访问控制规则ID
选择或映射要删除的访问控制规则的ID。

迭代器(已弃用)

已弃用迭代附件和迭代出席者模块。 若要迭代附件或与会者,请使用流控件 > 迭代器模块。 有关详细信息,请参阅 Adobe Workfront Fusion🔗中的迭代器模块

其他

进行API调用

此模块允许您执行自定义API调用。

选择配置API调用所需的HTTP请求方法。 有关详细信息,请参阅Adobe Workfront Fusion中的HTTP请求方法。

Connection
有关将Google Calendar帐户连接到Workfront Fusion的说明,请参阅创建与AdobeWorkfront Fusion的连接 — 基本说明
URL
输入相对于https://www.googleapis.com/calendar的路径。 示例: /v3/users/me/calendarList
方法
Headers
以标准JSON对象的形式添加请求的标头。例如,{"Content-type":"application/json"}。 Workfront Fusion为您添加授权标头。
查询字符串
以标准JSON对象的形式添加API调用的查询。
Body

以标准JSON对象的形式添加API调用的正文内容。

注意:

在JSON中使用条件语句(如if)时,请将引号放在条件语句之外。

获取忙/闲信息

此操作模块返回一组日历的空闲和忙碌信息。

模块会返回日历的ID和任何关联字段,以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。

配置此模块时,会显示以下字段。

有关将Google Calendar帐户连接到Workfront Fusion的说明,请参阅创建与Adobe Workfront Fusion的连接 — 基本说明

最短时间

输入要检索其信息的间隔的开始。

有关支持的日期和时间格式的列表,请参阅在Adobe Workfront Fusion中键入强制。

最大时间

输入要检索其信息的间隔的结束。

有关支持的日期和时间格式的列表,请参阅在Adobe Workfront Fusion中键入强制。

日历
对于要从中检索信息的每个日历,单击 添加 并输入或映射日历ID。

在事件之前触发方案

借助标准Google Calendar电子邮件提醒和Webhook >自定义mailhook模块,您可以在事件之前的指定时间触发方案。

  1. 使用Google日历 >更新活动模块向活动添加电子邮件提醒:

  2. 创建以Webhook >自定义mailhook模块开头的新方案。

    1. 复制mailhook的电子邮件地址。
    2. 保存场景并执行它。
  3. 在Gmail中,将Google Calendar电子邮件提醒重定向到邮件挂接的电子邮件地址:

    1. 打开您的​ Gmail设置

    2. 打开​ 转发和POP/IMAP ​选项卡。

    3. 单击​ 添加转发地址。

    4. 粘贴复制的邮件挂钩的电子邮件地址,单击​ 下一步,在弹出窗口中按​ 继续 ​进行确认,然后单击​ 确定

    5. 在Workfront Fusion中,切换到应通过接收确认电子邮件完成其执行的新方案。

    6. 单击模块上方的气泡以检查模块的输出。

    7. 展开Text项目并复制确认代码:

    8. 在Gmail中,将确认代码粘贴到编辑框中,然后单击​ 验证

    9. 打开​ 筛选器和阻止的地址 ​选项卡。

    10. 单击​ 创建新筛选器

    11. 为来自 calendar-notification@google.com的所有电子邮件设置一个过滤器,然后单击​ 创建过滤器

    12. 选择​ 将其转发到,然后从列表中选择邮件挂接的电子邮件地址。

    13. 单击​ 创建筛选器 ​以创建筛选器。

  4. (可选)在Workfront Fusion中,在Webhooks >自定义mailhook模块之后添加文本解析器 > 匹配模式模块,以解析电子邮件的HTML代码以获取您需要的任何信息。

    例如,您可以按如下方式配置模块,以获取事件的ID:

    模式<meta itemprop="eventId/googleCalendar" content="(?<evenitID>.*?)"/>

    文本:从Webhook >自定义mailhook模块输出的HTML content项目。

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43