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

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时出错：{“errorCode”：“ENVELOPE_IS_INCOMPLETE”，“message”：“信封不完整。完整的信封需要文档，收件人，标签和主题行。“ }

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

Answer 1

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

请参阅this example.的第93行及以下该示例发送信封

1. 来自DocuSign的模板（“服务器模板”）
2. 本地创建的HTML源文档。

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

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

Answer 2

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