DocuSign API - 使用复合模板创建信封答案

【问题标题】：DocuSign API - create envelopes using composite templatesDocuSign API - 使用复合模板创建信封
【发布时间】：2015-03-18 18:56:38
【问题描述】：

我想使用静态/复合模板创建信封。我已经创建了模板、角色并拥有将与角色相关的标签配置到我的 DocuSign 帐户中。我还检索到了 templateid 从 API 调用中引用此模板。

有没有办法在运行时使用另一个文档覆盖模板中的文档 API调用？我尝试使用 API Explorer（使用基于 REST 的 API 调用）做同样的事情，但没有覆盖文档，它从模板附加到文档中。

我这样做的主要原因是使用收件人角色的标签，以便在运行时，我这样做不需要为收件人配置标签。就我而言，收件人标签保持不变对于所有收件人/信封，但每次创建信封时文档都会更改。

请指教，

【问题讨论】：

标签： docusignapi docusigncompositetmplts

【解决方案1】：

是的，您可以这样做。复合模板是要走的路。当您进行调用时，创建一个引用服务器端模板和您的文档的复合模板结构。带有您的文档的 inlineTemplate 应该在序列 1 中，而您的 serverTemplate 应该在序列 2 中。例如：

    --f6e755d3-bbcf-44e5-b276-8ae626f97220
    Content-Type: application/json
    Content-Disposition: form-data

    {
       "emailSubject":"DocuSign API - Composite Templates",
       "emailBlurb":"Composite Templates Sample 1",
       "status":"sent",
       "compositeTemplates":[
          {
            "compositeTemplateId": "1",
             "inlineTemplates":[
                {
                   "sequence":"1",
                   "recipients":{
                      "signers":[
                         {
                            "email":"me@u.them",
                            "name":"My Signer",
                            "recipientId":1,
                            "roleName":"Signer1",
                            "tabs":{
                               "textTabs":[
                                  {
                                     "tabLabel":"NDACompany",
                                     "value":"ACME Co USA"
                                  }
                               ]
                            }
                         }
                      ]
                   },
                    "documents": [
                        {
                            "documentId": "1",
                            "name": "Test Doc.txt"
                        }
                    ]
                }
             ],
             "serverTemplates":[
                {
                   "sequence":"2",
                   "templateId":"83A07CB0-CF0C-4823-B68A-42EE983F301A"
                }
             ]
          }
       ]
    }
    --f6e755d3-bbcf-44e5-b276-8ae626f97220
    Content-Type: text/plain
    Content-Disposition: file; filename="Test Doc.txt"; documentid=1; compositeTemplateId=1

    Howdy.  Please sign!
    --f6e755d3-bbcf-44e5-b276-8ae626f97220--

【讨论】：

非常感谢您的详细回答。我能够将文档覆盖到复合模板中的文档并创建一个信封。不过，如果我已将收件人分配给模板本身的角色，我只能创建一个信封。我无法在运行时添加/更新收件人。我可以在创建信封时将收件人添加到我在模板中创建的角色吗？
确实如此。在每个复合模板结构中（您可以拥有的不仅仅是上面的一个），任何 inlineTemplate 或 serverTemplate 中存在的任何内容都会被合并。在上面的示例中，我的服务器模板中有一个 Signer1 角色，它被合并，但我也可以添加一个 Signer2。所有这些模板混合在一起以创建一个复合模板。
我们是否需要专门使用基于 REST 的 API 调用来从复合模板创建信封？
您也可以通过 SOAP 执行此操作。使用的方法是 CreateEnvelopeFromTemplatesAndForms。