Questions related to **DocuSign Composite Templates**, a DSL focused on compositing together multiple sources of documents of any type, field-tagged PDFs, templates, and explicit sets of tags, recipient ordering and more.
DocuSign Composite Templates
DocuSign Composite Templates is a DSL focused on compositing together multiple sources of documents of any type, field-tagged PDFs, templates, and explicit sets of tags, recipient ordering and more.
Composite templates are optionally used when creating an envelope in the DocuSign system. They're used to solve many different types of use cases. Some examples:
- A PDF includes field definitions. How can I transform the fields into DocuSign tags, and assign some of them to recipient signer 1, and others to recipient signer 2?
- My template on DocuSign is defined to include a specific document. I want to send an envelope that uses the template definition, but substitutes document 2 for the template's document.
- I want my envelope to include two templates, each with its own set of documents.
- I want my envelope to include 5 documents, each of them tagged according to a template in the system.
- And much more.
The theory of compositing templates
The Composite Templates feature, like compositing in film production, enables you to overlay document, recipient, and tab definitions from multiple sources, including PDF Form Field definitions, templates defined on the server, and more.
Each Composite Template consists of optional elements: server templates, inline templates, PDF Metadata templates, and documents.
The Composite Template ID is an optional element used to identify the composite template. It is used as a reference when adding document object information via a multipart HTTP message. If used, the document content-disposition must include the compositeTemplateId to which the document should be added. If compositeTemplateId is not specified in the content-disposition, the document is applied based on the documentId only. If no document object is specified, the composite template inherits the first document.
Server Templates are server-side templates stored on the DocuSign platform. If supplied, they are overlaid into the envelope in the order of their Sequence value.
Inline Templates provide a container to add documents, recipients, tabs, and custom fields. If inline templates are supplied, they are overlaid into the envelope in the order of their Sequence value.
Document objects are optional structures that provide a container to pass in a document or form. If this object is not included, the composite template inherits the first document it finds from a server template or inline template, starting with the lowest sequence value.