DocuSign API复合模板服务器模板的理解

时间:2019-01-24 19:21:50

标签: docusignapi docusigncompositetmplts

在阅读了herehere并尝试了复合模板之后,我不太确定自己是否了解如何在API请求中正确使用服务器模板。文档中提到了If supplied they are overlaid into the envelope in the order of their Sequence value,因此我将其解释为将它们合并为一个文档。似乎它们合并在一起了,但是却产生了我意想不到的结果。序列中的第一个是显示的内容,您看不到其他的。

我想做的是有几个常见的标头,其中包含我们不同的徽标,并将其与我要发送的任何模板结合在一起。我们不能使用品牌化方法,因为他们希望将其作为模板中文档的一部分,而且据我所知,品牌化是无法实现的。

以下是我的(已清理)请求。查看我的评论。

{
    "brandId": "{{brandId}}",
    "emailSubject": "Testing Subject",
    "status": "SENT",
    "compositeTemplates": [{
            "serverTemplates": [{ // First document
                    "sequence": "1",
                    "templateId": "{{headerTemplateId}}" //Header logo template
                }, {
                    "sequence": "2",
                    "templateId": "{{document1TemplateId}}" // Template with content
                }
            ],
            "inlineTemplates": [{
                    "sequence": "1",
                    "recipients": {
                        "signers": [{
                                "email": "test@test.com",
                                "name": "Leeroy Jenkins",
                                "roleName": "Customer",
                                "recipientId": "1"
                            }
                        ]
                    }
                }
            ]
        }, {
            "serverTemplates": [{ // Second document
                    "sequence": "2",
                    "templateId": "{{document2TemplateId}}"
                }
            ],
            "inlineTemplates": [{
                    "sequence": "2",
                    "recipients": {
                        "signers": [{
                                "email": "test@test.com",
                                "name": "Leeroy Jenkins",
                                "roleName": "Customer",
                                "recipientId": "1",
                                "tabs": {
                                    "textTabs": [{
                                            "tabLabel": "Address",
                                            "value": "123 Test Rd "
                                        }, {
                                            "tabLabel": "CityStateZip",
                                            "value": "Test/XY/12345"
                                        }
                                    ]
                                }
                            }
                        ]
                    }
                }
            ]
        }
    ]
}

1 个答案:

答案 0 :(得分:0)

正如@Drew所说,您的直接问题是每个单独的复合模板只能包含零个或一个服务器模板。

回复:如何在复合模板中正确使用服务器模板

每个组合模板composites都包含信封的不同方面:

  • 零或一个模板定义存储在docusign.com上
  • 新定义的收件人,标签,文档等

例如,复合模板可用于创建包含文档“ B”的信封,而不必使用docusign.com上模板中包含的文档。

更改文档中的徽标

不幸的是,DocuSign合成功能不包括将一个文档中的图像与另一个文档中的图像合并以创建新的(合并的)文档的功能。

一些想法:

  1. 如果合同的仅第一页包含徽标,则您可以拥有第一页的多个版本(将每个版本作为单独的文档进行处理),然后将徽标的第一页与其他页面合并以形成完整的信封。

    请注意,文档可以短于一页。收件人将一起查看信封的所有文档。

  2. 使用PDF库来操纵PDF文档本身以更改徽标。现在有许多可用的PDF库,以及适用于多种语言和操作系统的API。

  3. 使用SAAS PDF渲染服务将图像与内容组合在一起以获得最终的PDF。例如webmerge

  4. 以非PDF格式发送DocuSign文档。例如,您可以发送一个.docx文档。如果您使用的是Windows堆栈,则您的应用程序创建Word文档的自定义徽标版本可能比PDF更为容易。