Google Calendar模块

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

有关创建方案的说明,请参阅创建方案:文章索引下的文章。

有关模块的信息,请参阅模块:文章索引下的文章。

访问要求

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

Adobe Workfront 计划*
Pro 或更高
Adobe Workfront 许可证*
Plan, Work
Adobe Workfront Fusion 许可证**

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

旧版许可证要求:Workfront Fusion用于工作自动化和集成

产品

当前产品要求:如果您有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字段,具体取决于应用程序或服务中的访问级别等因素。 模块中的粗体标题表示必填字段。

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

映射切换

活动

Watch events

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

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

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

Search events

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

指定搜索的日历和参数。

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

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

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

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

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

End date

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

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

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

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

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

Get an event

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

指定日历和事件。

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

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

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

Create an event

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

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

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

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

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

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

  • In Detail

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

  • Quickly

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

Calendar ID
选择要显示事件的日历。
Color
选择事件在日历上显示的颜色。
Event name

输入或映射事件的名称。

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

All day event
如果事件是全天事件(不需要开始和结束时间),则启用此选项。
Start date

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

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

End date

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

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

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

选择此事件的可见性。

  • Default

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

  • Public

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

  • Private

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

Send notification about the event creation

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

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

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

Update an event

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

请指定日历和事件ID。

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

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

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

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

Delete an event

此操作模块删除事件。

请指定日历和事件ID。

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

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

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

日程表

List calendars

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

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

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

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

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

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

Get a calendar

此操作模块可检索日历。

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

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

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

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

Create a calendar

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

指定日历的名称。

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

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

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

Update a calendar

此操作模块更新日历。

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

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

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

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

Delete a calendar

此操作模块删除日历。

指定要删除的日历的ID。

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

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

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

Clear a calendar

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

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

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

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

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

访问控制规则

List access control rules

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

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

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

Get an access control rule

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

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

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

Create an access control rule

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

指定日历的名称。

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

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

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

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

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

选择范围的类型。

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

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

Value
根据范围类型,输入用户或组的电子邮件地址,或域的名称。
Send notifications

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

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

Update an access control rule

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

指定日历的名称。

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

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

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

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

  • None:此角色不提供访问权限。
  • Free Busy Reader:用户可以读取忙/闲信息。
  • Owner:用户可以读取和修改事件,并且可以访问控制列表。
  • Reader:用户可以读取非私有事件。
  • Writer:用户可以读取和修改事件。
Send notifications

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

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

Delete an access control rule

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

指定日历的名称。

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

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

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

迭代器(已弃用)

已弃用iterate attachments和iterate attendees模块。 若要迭代附件或与会者,请使用Flow Control > Iterator模块。 有关详细信息,请参阅迭代器模块

其他

Make an API Call

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

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

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

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

注意:

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

Get Free/Busy Information

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

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

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

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

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

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

Maximum time

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

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

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

在事件之前触发方案

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

  1. 使用Google Calendar >Update an event模块向活动添加电子邮件提醒:

    在事件之前触发方案

  2. 创建以Webhooks >Custom mailhook模块开头的新方案。

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

    1. 打开您的​ Gmail settings

    2. 打开​ Forwarding and POP/IMAP ​选项卡。

    3. 单击​ Add a forwarding address.

    4. 粘贴复制的邮件挂接的电子邮件地址,单击​ Next,在弹出窗口中按​ Proceed ​进行确认,然后单击​ OK

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

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

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

      确认码

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

      粘贴代码

    9. 打开​ Filters and Blocked Addresses ​选项卡。

    10. 单击 Create a new filter

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

    12. 选择​ Forward it to ​并从列表中选择邮件挂接的电子邮件地址。

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

  4. (可选)在Workfront Fusion中,将Text parser > Match pattern模块添加到Webhooks >Custom mailhook模块之后,以分析电子邮件的HTML代码以获取您需要的任何信息。

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

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

    文本:从Webhooks >Custom mailhook模块输出的HTML content项。

recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3