DocuSign eSignature REST API C# 客户端:同一模板角色能否在单个文档上执行多个签名步骤?
DocuSign eSignature REST API C# Client : Can the same template role perform multiple signing steps on a single document?
版本
Docusign C# 客户端- DocuSign.eSign.dll v3.1.5
.NetFramework 4.7.1
我们的要求
我们需要实施一个签名工作流,其中同一个模板角色可以对同一个文档执行多个操作。下面是一个简化的示例。
- 单一模板(文档)
- 分配了一个名为“客户”的角色
- 第 1 步 - 客户必须签名
- 第 2 步 - 其他人必须签名
- 第 3 步 - 客户必须查看文件
- 签名工作流程完成
下图来自 DocuSign eSignature 管理控制台,其中“CC”代表客户模板角色
一些示例代码
我们的应用程序使用 C# Docusign 客户端(它本质上是需要发送到 Docusign API 的 Http 请求的包装器)告诉 DocuSign 我们需要填充的模板(文档)的 ID以及在签名工作流程中发挥作用的每个收件人的 name/email 地址。
var envelope = new EnvelopeDefinition
{
AllowRecipientRecursion = "true",
TemplateId = templateId,
TemplateRoles = peopleWithRolesOnTheTemplate.Select(person => new TemplateRole
{
RoleName = person.Role, // e.g "Customer"
Name = person.Name,
Email = person.Email
// etc etc
}).ToList(),
Status = "sent"
};
var envelopesApi = new EnvelopesApi(ApiClient.Configuration);
var result = envelopesApi.CreateEnvelope(AccountId, envelope);
预期结果
我们的应用程序已指定“客户”模板角色的名称和电子邮件地址,并向 DocuSign 发送了创建信封的请求
我们预计生成的 DocuSign 信封有 3 个签名步骤,其中 2 个属于客户模板角色。
我们希望属于客户角色的每个步骤都填充我们在上面的代码片段中指定的姓名和电子邮件地址。
我们希望客户角色收到两次文档,一次是签名,第二次是在签名步骤 2 中的收件人签名后查看文档。
实际结果
客户签署文档,第二个收件人签署文档,客户未发送文档以查看(未执行第 3 步)
查看一些 DocuSign 日志记录,信封中似乎只有两个签名步骤,而不是 3 个。这几乎是因为其中两个签名步骤有相同的角色名称,它们被合并到一个签名步骤中,沿着这些方向。
我的问题
有谁知道上面加粗的说法是否正确?
我们有什么方法可以使用这个 DocuSign C# 客户端来创建一个信封,其中相同的角色可以执行多个签名步骤?还是 DocuSign 中的每个签名步骤都必须属于一个单独的角色?
您应该给客户两个角色名称:customerSigner 和 customerCC。
使用模板时,您将设置三个角色:
- customerSigner
- someoneElseSigner
- 客户抄送
第一个和第三个角色的姓名和电子邮件将相同。
此外,DocuSign 会自动(默认情况下)将已完成文档的副本发送给签名者——所以我不确定您是否需要抄送 role/step。
你终于说了
Customer must view document
为确保客户已在第 3 步中看到文档,您可能需要使用经过认证的收货人。
版本
Docusign C# 客户端- DocuSign.eSign.dll v3.1.5
.NetFramework 4.7.1
我们的要求
我们需要实施一个签名工作流,其中同一个模板角色可以对同一个文档执行多个操作。下面是一个简化的示例。
- 单一模板(文档)
- 分配了一个名为“客户”的角色
- 第 1 步 - 客户必须签名
- 第 2 步 - 其他人必须签名
- 第 3 步 - 客户必须查看文件
- 签名工作流程完成
下图来自 DocuSign eSignature 管理控制台,其中“CC”代表客户模板角色
一些示例代码
我们的应用程序使用 C# Docusign 客户端(它本质上是需要发送到 Docusign API 的 Http 请求的包装器)告诉 DocuSign 我们需要填充的模板(文档)的 ID以及在签名工作流程中发挥作用的每个收件人的 name/email 地址。
var envelope = new EnvelopeDefinition
{
AllowRecipientRecursion = "true",
TemplateId = templateId,
TemplateRoles = peopleWithRolesOnTheTemplate.Select(person => new TemplateRole
{
RoleName = person.Role, // e.g "Customer"
Name = person.Name,
Email = person.Email
// etc etc
}).ToList(),
Status = "sent"
};
var envelopesApi = new EnvelopesApi(ApiClient.Configuration);
var result = envelopesApi.CreateEnvelope(AccountId, envelope);
预期结果
我们的应用程序已指定“客户”模板角色的名称和电子邮件地址,并向 DocuSign 发送了创建信封的请求
我们预计生成的 DocuSign 信封有 3 个签名步骤,其中 2 个属于客户模板角色。
我们希望属于客户角色的每个步骤都填充我们在上面的代码片段中指定的姓名和电子邮件地址。
我们希望客户角色收到两次文档,一次是签名,第二次是在签名步骤 2 中的收件人签名后查看文档。
实际结果
客户签署文档,第二个收件人签署文档,客户未发送文档以查看(未执行第 3 步)
查看一些 DocuSign 日志记录,信封中似乎只有两个签名步骤,而不是 3 个。这几乎是因为其中两个签名步骤有相同的角色名称,它们被合并到一个签名步骤中,沿着这些方向。
我的问题
有谁知道上面加粗的说法是否正确?
我们有什么方法可以使用这个 DocuSign C# 客户端来创建一个信封,其中相同的角色可以执行多个签名步骤?还是 DocuSign 中的每个签名步骤都必须属于一个单独的角色?
您应该给客户两个角色名称:customerSigner 和 customerCC。
使用模板时,您将设置三个角色:
- customerSigner
- someoneElseSigner
- 客户抄送
第一个和第三个角色的姓名和电子邮件将相同。
此外,DocuSign 会自动(默认情况下)将已完成文档的副本发送给签名者——所以我不确定您是否需要抄送 role/step。
你终于说了
Customer must view document
为确保客户已在第 3 步中看到文档,您可能需要使用经过认证的收货人。