Общие сведения о шаблонах сервера шаблонов API DocuSign - PullRequest
0 голосов
/ 24 января 2019

После прочтения ( здесь и здесь ) и опробования составных шаблонов я не совсем уверен, что понимаю, как правильно использовать серверные шаблоны в запросе 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 голосов
/ 27 января 2019

Как говорит @Drew, ваша непосредственная проблема заключается в том, что каждый отдельный составной шаблон может содержать только ноль или один шаблон сервера.

Re: Как правильно использовать серверные шаблоны в составном шаблоне

Каждый композитный шаблон композиты вместе различные аспекты конверта:

  • Определения нуля или одного шаблона хранятся на docusign.com
  • Новые определенные получатели, вкладки, документы и т. Д.

Например, составные шаблоны можно использовать для создания конверта с документом «B» вместо использования документа, включенного в шаблон на docusign.com.

Смена логотипов в документах

К сожалению, функция композитинга DocuSign не включает в себя функцию объединения изображений из одного документа с другим документом для создания нового (объединенного) документа.

Некоторые идеи:

  1. Если только одна страница контракта включает логотип, то вы можете иметь несколько версий первой страницы (рассматривая каждую как отдельный документ) и комбинировать одну страницу с логотипом с другими страницами, чтобы сформировать полный конверт ,

    Обратите внимание, что документ может быть столь же коротким, как страница. Получатели будут просматривать все документы конверта вместе.

  2. Используйте библиотеку PDF для управления самим документом PDF для изменения логотипа. В настоящее время доступно много библиотек PDF с API для многих языков и операционных систем.

  3. Используйте службу рендеринга PDF SAAS, чтобы объединить изображения с содержимым для получения окончательного PDF. Например, webmerge

  4. Отправить DocuSign документ в формате, отличном от PDF. Например, вы можете отправить документ .docx. Если вы используете стек Windows, вашему приложению может быть проще создать собственную версию логотипа документа Word, чем PDF.

...