DocuSign 模块

Adobe Workfront Fusion DocuSign模块允许您监视和检索信封状态、搜索和检索信封,或者下载并发送文档以登录您的DocuSign帐户。

有关创建场景的说明,请参阅创建场景:文章索引中的相关文章。

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

访问权限要求

展开可查看本文所述功能的访问权限要求。
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Adobe Workfront 包

任意 Adobe Workfront Workflow 包以及任意 Adobe Workfront 自动化和集成包

Workfront Ultimate

Workfront Prime 和 Select 包,且需额外购买 Workfront Fusion。

Adobe Workfront 许可证

标准

工作版或更高版本

Adobe Workfront Fusion 许可证

基于操作:不需要 Workfront Fusion 许可证

基于连接器(旧版):Workfront Fusion for Work Automation and Integration

产品 如果您的组织使用的 Workfront Select 或 Prime 包不包含 Workfront 自动化和集成,则必须单独购买 Adobe Workfront Fusion。

有关此表中信息的更多详细说明,请参阅文档中的访问权限要求

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

先决条件

要使用 DocuSign 模块,您必须拥有一个 DocuSign 帐户。

DocuSign API信息

DocuSign连接器使用以下内容:

API 标记
1.18.11

将 DocuSign 连接到 Workfront Fusion connect-docusign-to-workfront-fusion

要为您的 DocuSign 模块创建连接:

  1. 开始配置第一个DocuSign模块时,单击连接框旁边的​添加

  2. 输入以下内容:

    table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
    连接名称 输入新DocuSign连接的名称。
    环境 选择是否连接到非生产环境中的生产。
    连接名称 选择连接服务帐户还是个人帐户。
    帐户类型 选择要连接的帐户是生产帐户还是演示帐户。
  3. 点击​ 继续 ​保存连接并返回模块。

DocuSign 模块及其字段

在您配置 DocuSign 模块时,Workfront Fusion 会显示以下字段。 除这些字段外,根据您的应用程序或服务访问权限级别,可能会显示更多 DocuSign 字段。 模块中的加粗标题表示必填字段。

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

映射切换

触发器

观看信封

当信封被发送、投放、签署、完成或拒绝时,此触发器模块会启动一个场景。

连接
有关将DocuSign帐户连接到Workfront Fusion的说明,请参阅本文中的将Docusign连接到Workfront Fusion
帐户
选择包含要监视的记录的帐户。
事件类型

选择要监视的事件类型。

  • 文档已完成
  • 文档已拒绝
  • 文档已发送
  • 文档已签名
  • 收件箱中的新文档
输出
选择要包含在模块输出中的字段。
限制
输入或映射模块在每次场景执行周期中可处理的最大记录数。

操作

添加自定义字段

此操作模块向文档添加自定义字段

连接
有关将 DocuSign 帐户连接到 Workfront Fusion 的说明,请参阅本文中的将 DocuSign 连接到 Workfront Fusion
帐户
选择包含要添加自定义字段的文档的帐户。
信封ID
输入或映射包含要添加自定义字段的文档的信封的ID。
字段名称
为要添加的新字段输入或映射名称。
必填
如果您希望添加的字段为必填字段,请启用此选项。
显示字段
如果您希望字段可见,请启用此选项。
输入或映射添加字段的值(内容)。

将收件人添加到信封

此操作模块将一个或多个收件人添加到现有信封。 如果信封已发送,则会向收件人发送电子邮件。 此模块对已完成的信封无效。

连接
有关将DocuSign帐户连接到Workfront Fusion的说明,请参阅创建连接 — 基本说明
帐户
选择包含要添加收件人的信封的帐户。
信封ID
选择或映射要添加收件人的信封的ID。
收件人类型

选择要添加到信封中的收件人类型。

  • Agent

  • Carbon copy

  • 认证交付

  • 现场签名者

  • Intermediate

  • 签名者

电子邮件
输入或映射要添加到信封的收件人的电子邮件地址。
名称
输入或映射要添加到信封的收件人名称。
路由顺序
输入或映射收件人的路由编号。 路由号码确定收件人接收和签署文档的顺序。
电子邮件正文
输入或映射发送给收件人的电子邮件的正文(内容)。
电子邮件主题
输入或映射发送给收件人的电子邮件的主题。
私人消息

如果要向收件人发送私人邮件,请输入或映射邮件的文本。

只有选定的收件人会看到该私人邮件以及常规邮件。 私密消息长度限制为1000个字符。

Authentication

选择要用于确认收件人身份的身份验证方法。

  • 访问代码

    输入或映射访问代码。

  • Phone

    输入或映射电话号码。

  • 短信

    输入或映射电话号码。

新建信封

此操作模块从模板创建新信封。 它返回新信封的ID以及新信封的状态。

连接
有关将DocuSign帐户连接到Workfront Fusion的说明,请参阅创建连接 — 基本说明下的文章。
帐户
选择包含要上载文件的信封的帐户。
模板
选择要从中创建新信封的模板。 根据您选择的帐户,可以使用模板。
创建后
选择是将信封另存为草稿还是发送信封以供签名。
模板收件人

对于要添加到此信封的每个收件人,单击 添加项 并输入以下详细信息:

  • 访问代码

    输入或映射收件人用于访问信封的代码。

  • 电子邮件

    输入或映射收件人的电子邮件地址。

  • 名称

    输入或映射收件人的名称。

  • 角色名称

    输入或映射收件人的角色名称。

  • 路由顺序

    输入或映射收件人的路由编号。 路由号码确定收件人接收和签署文档的顺序。

Allow Print and Sign
启用此选项可允许收件人打印文档并签署纸张。
允许重新分配
如果希望收件人能够将文档重新分配给其他用户,请启用此选项。
允许收件人递归
启用此选项以允许收件人递归。
权威副本
启用此选项可将此信封中的文档标记为授权副本。
自动导航
启用此选项可设置收件人的自动导航。
品牌ID
输入或映射品牌的ID。
标记已启用
启用此选项以启用文档标记。
过期已启用

启用此选项可设置此信封的过期时间。 如果启用此选项,请填写以下字段:

  • 过期时间

    输入或映射此信封过期的天数。

  • 过期警告

    输入或映射向收件人发送提醒电子邮件之前的天数。

正文
输入或映射此信封随附的电子邮件的正文(内容)。
主题
输入或映射此信封随附的电子邮件的主题。

自定义 API 调用

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

连接
有关将 DocuSign 帐户连接到 Workfront Fusion 的说明,请参阅本文中的将 DocuSign 连接到 Workfront Fusion
帐户
输入或映射要用于访问DocuSign API的帐户。
URL
输入或映射相对路径 https://<BASE_URI>/v2/accounts/<ACCOUNT_ID>.
方法
选择用于配置此 API 调用的 HTTP 请求方法。 有关更多信息,请参阅 HTTP 请求方法
标头

以标准 JSON 对象的形式添加请求标头。 这将决定请求的内容类型。

例如, {"Content-type":"application/json"}

注意:如果出现错误且难以确定来源,请根据 Workfront 文档修改请求标头。 如果自定义API调用返回422 HTTP请求错误,请尝试使用“Content-Type”:“text/plain”标头。

查询字符串

以标准 JSON 对象的形式添加 API 调用的查询。

例如: {"name":"something-urgent"}

正文

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

注意:

在 JSON 中使用 if 等条件语句时,需将引号置于条件语句外部。

限制
输入或映射在一个执行周期内要处理的最大结果数。

示例:​列表信封

以下API调用从您DocuSign帐户中的指定日期开始返回信封:

URL/v2.1/accounts/{accountId}/envelopes/

方法GET

查询字符串

  • from_date

  • YYYY-MM-DD

指定请求何时开始检查帐户信封的状态更改。

示例Docusign设置

可以在“包”>“主体”>“信封”下的模块输出中找到结果。

在我们的示例中,返回了6个信封:

示例docusign输出

下载文档

此操作模块下载单个文档。

连接
有关将 DocuSign 帐户连接到 Workfront Fusion 的说明,请参阅本文中的将 DocuSign 连接到 Workfront Fusion
帐户
选择包含要下载的文档的帐户。
信封ID
输入或映射要下载的信封ID。
文档 ID
输入或映射要下载的文档的ID。
证书
启用此选项以在下载中包含信封签名证书。
[!UICONTROL文档(按用户ID)
启用此选项可允许收件人按用户ID检索文档。 例如,如果将用户包括在具有不同可见性的两个不同的工艺路线订单中,则使用此选项将返回来自两个工艺路线的所有单据。
加密
如果希望为DocuSign帐户上配置的所有密钥管理器加密响应中返回的PDF字节,请启用此选项。
语言
选择语言。
显示更改
启用此选项以突出显示返回的PDF的任何更改字段,并以黄色突出显示可选签名或缩写符号。
水印
启用此选项可启用水印功能。

修改自定义字段

此操作模块使用字段名称修改自定义字段。

连接
有关将 DocuSign 帐户连接到 Workfront Fusion 的说明,请参阅本文中的将 DocuSign 连接到 Workfront Fusion
帐户
选择包含要修改自定义字段的文档的帐户。
信封ID
输入或映射包含要修改自定义字段的文档的信封的ID。
字段ID
输入或映射要修改的字段的ID。
字段名称
输入或映射要修改的字段的名称。
必填
如果希望修改的字段为必填字段,则启用此选项。
显示字段
如果您希望字段可见,请启用此选项。
输入或映射已修改字段的值(内容)。

读取信封

此操作模块使用信封ID读取DocuSign中信封的相关信息。

连接
有关将 DocuSign 帐户连接到 Workfront Fusion 的说明,请参阅本文中的将 DocuSign 连接到 Workfront Fusion
帐户
选择包含要从中读取信息的文档的帐户。
信封ID
输入或映射包含要从中读取信息的文档的信封的ID。
输出
选择要显示在模块输出中的属性。

发送信封

该操作模块会向其收件人发送草稿信封。

连接
有关将 DocuSign 帐户连接到 Workfront Fusion 的说明,请参阅本文中的将 DocuSign 连接到 Workfront Fusion
帐户
选择包含要发送给其收件人的草稿信封的帐户。
信封ID
输入或映射要发送给其收件人的草稿信封的ID。

将文件上载到信封

此模块将指定的文件上传到DocuSign中的现有信封。

连接
有关将 DocuSign 帐户连接到 Workfront Fusion 的说明,请参阅本文中的将 DocuSign 连接到 Workfront Fusion
帐户
选择包含要上载文件的信封的帐户。
信封ID
输入或映射要上载文件的信封的ID。
来源文件
从以前的模块中选择源文件,或输入源文件的名称和数据。
recommendation-more-help
workfront-fusion-help-workfront-fusion