使用Docusign API使用C＃SDK将多个文档添加到信封

Question

我在Docusign中有一个模板，需要发送至joe@acme.com

但是，Joe负责管理10个客户，而不是由我发送给Joe 10个单独的信封供他签名，我想发送带有10个文档的Joe 1个信封，而Joe需要在信封中签名所有10个文档。 这些文档是相同的，只是模板文本字段中填充的数据不同

我正在使用Docusign提供的C＃SDK，并且可以使用EnvelopeDefinition类和TemplateRole类在信封中发送一个文档，但是对于如何在信封中创建10个文档却迷失了方向

以下食谱可以做到这一点，但是它是在python中使用的，并且使用REST API，我不确定该REST API如何转换为等效于C＃SDK的https://www.docusign.com/developer-center/recipes/send-multiple-docs

Answer 1

您可以使用CompositeTemplates并在信封中多次重复使用同一服务器模板。 以下代码使用相同的服务器模板，并在信封中重复10次。 在此处查看完整示例

public void CreateEnvelope()
{
  var envDef = new EnvelopeDefinition()
  {
      EmailSubject = "Envelope with multiple documents",
      Status = "sent",
      CompositeTemplates = new List<CompositeTemplate>()
  };

  for (int docNumber = 1; docNumber <= 10; docNumber++)
  {
      var compostiteTemplate = BuildCompositeTemplate(docNumber.ToString());
      envDef.CompositeTemplates.Add(compostiteTemplate);

  }

  EnvelopesApi envelopesApi = new EnvelopesApi();
  EnvelopeSummary envelopeSummary = envelopesApi.CreateEnvelope(accountId, envDef);
  Console.WriteLine(envelopeSummary);
}

public CompositeTemplate BuildCompositeTemplate(string docNumber)
{
    string serverTemplateId = "";//Add your server template ID here
    return new CompositeTemplate()
    {
          ServerTemplates = new List<ServerTemplate>()
          {
              new ServerTemplate()
              {
                  TemplateId = serverTemplateId,
                  Sequence = docNumber
              }
          },
          InlineTemplates = new List<InlineTemplate>()
          {
              new InlineTemplate()
              {
                  Sequence = docNumber,
                  Recipients = new Recipients()
                  {
                      Signers = new List<Signer>()
                      {
                          new Signer()
                          {
                              Email = "Janedoe@acme.com",
                              Name = "Jane Doe",
                              RecipientId = "1",
                              RoleName = "Signer1",
                              Tabs = new Tabs()
                              {
                                  TextTabs = new List<Text>()
                                  {
                                      new Text()
                                      {
                                          DocumentId = docNumber,
                                          PageNumber = "1",
                                          XPosition = "100",
                                          YPosition = "100",
                                          Width = 120, 
                                          Value = "Some Tab Value " + docNumber
                                      }
                                  }

                              }
                          }
                      }
                  }
              }
          }
    }
}

Answer 2

EnvelopeDefinition类中有Documents属性，您可以在其中添加多个文档。

当我想检查如何实现功能时，可以使用DocuSign的REST API Explorer 。

            enDef = new EnvelopeDefinition();
            doc = new Document();

            doc.DocumentBase64 = System.Convert.ToBase64String(System.IO.File.ReadAllBytes(filename));
            doc.Name = DocName;
            doc.DocumentId = "1"; // increment this

            enDef.Documents = new List<Document>();
            enDef.Documents.Add(doc);

添加

对于乘法模板角色，在EnvelopeDefinition中还存在一个名为TemplateRoles的属性。 在那里您可以添加多个。

            tempRole = new TemplateRole();
            tempRole.Name = Rolename;

            enDef.TemplateRoles = new List<TemplateRole>();
            enDef.TemplateRoles.Add(tempRole);`