如何在信封中包含多个模板

Question

我无法弄清楚如何使用DocuSign C# SDK在一个信封内发送多个填充的DocuSign模板。 我可以在信封中填充和发送单个模板，但无法使用多个模板执行此操作。

这是我使用的代码片段，可以成功填充并发送模板：

var rolesList = new List<TemplateRole>();
var tRole = new TemplateRole   
{
    Tabs = new Tabs(),
    RoleName = "rolename"
};
tRole.Name = "joe smith";
tRole.Email = "email-address";
var tabData = new List<Text>();
// Populate the tabData 
tRole.Tabs.TextTabs = tabData;
rolesList.Add(tRole);
var envDef = new EnvelopeDefinition
{
    EmailSubject = "Pleae sign this",
    TemplateRoles = rolesList,
    TemplateId = "first template id",
    Status = "sent",
};
var envelopesApi = new EnvelopesApi();
await envelopesApi.CreateEnvelopeAsync("accountId", envDef);

对于多个模板，我假设我需要使用 CompositeTemplate，所以我尝试了以下代码：

var envDef = new EnvelopeDefinition
{
    EmailSubject = subject,
    TemplateRoles = roles,
    Status = send?  "sent" : "created",
};
var compositeTemplate = new CompositeTemplate()
{
    ServerTemplates = new List<ServerTemplate>(),
    CompositeTemplateId = Guid.NewGuid().ToString(),
};

envDef.CompositeTemplates = new List<CompositeTemplate>();
envDef.CompositeTemplates.Add(compositeTemplate);
ServerTemplate first = new ServerTemplate()
{
    TemplateId = "first template id",
    Sequence = "1"
};
ServerTemplate second = new ServerTemplate()
{
    TemplateId = "second template id",
    Sequence = "2",
};
compositeTemplate.ServerTemplates.Add(first);
compositeTemplate.ServerTemplates.Add(second);
var envelopesApi = new EnvelopesApi();
await envelopesApi.CreateEnvelopeAsync("accountId", envDef);

但是，使用此代码，CreateEnvelopeAsync 调用会引发以下异常：DocuSign.eSign.Client.ApiException： 调用 CreateEnvelope 时出错： { "错误代码"： "ENVELOPE_IS_INCOMPLETE"， "消息"："信封不完整。完整的信封需要文档、收件人、选项卡和主题行。}

我显然没有正确配置 CompositeTemplate(很可能没有填充文档(，但我似乎找不到有关如何正确填充它的示例。

Answer 1

您不应该在同一信封定义中混合使用模板角色和复合模板，因为两者都是不同的设计策略。正如Larry所建议的那样，如果要从两个不同的模板添加要添加到信封中的文档，则需要添加两个CompositeTemplate项目。此外，当您引用服务器模板时，您还需要指定内联模板以提供收件人角色详细信息。在服务器模板中，您有收件人的占位符，但没有收件人的姓名和电子邮件，因此通过 InlineTemplate，您可以提供要向其发送信封的收件人占位符的姓名和电子邮件。

Answer 2

由于您的两个服务器模板彼此独立，我相信您希望创建一个包含两个复合模板的数组。每个复合模板项将包含一个服务器模板。

请参阅此示例的第 93 行及下方。该示例发送一个包含

1. 来自DocuSign的模板("服务器模板"(
2. 本地创建的 HTML 源文档。

在您的情况下，请重复添加项目 1 而不是现有项目 2 的方式。

键是两个不同的复合模板项

，而不是一个复合模板项中的两个服务器模板。