Неожиданное поведение с составными шаблонами
У меня проблема с пониманием работы встроенных шаблонов. У меня есть 2 серверных шаблона и 2 встроенных шаблона, 1 встроенный шаблон, чтобы объединиться с шаблоном сервера. Я хочу посмотреть, не заполню ли я информацию для встроенного шаблона, что конверт все еще работает. Вот моя просьба:
Запрос
{
"compositeTemplates": [
{
"serverTemplates": [
{
"sequence": "1",
"templateId": "8a3a21af-4348-45e1-85b9-72a331c9c67a"
}
],
"inlineTemplates": [
{
"sequence": "1",
"recipients": {
"signers": []
}
}
],
"document": {
"documentId": "2",
"name": "FinalSale.docx",
"fileExtension": "docx",
"documentBase64": [bytearray]
}
},
{
"serverTemplates": [
{
"sequence": "1",
"templateId": "d22048be-4bfe-43c2-9acf-3d5bcd79144f"
}
],
"inlineTemplates": [
{
"sequence": "1",
"recipients": {
"signers": [
{
"name": "Kathy Keaton",
"email": "KathyKeaton1@outlook.com",
"recipientId": "1",
"accessCode": "5000",
"routingOrder": "1",
"roleName": "##Buyer1"
},
{
"name": "Kathy Lloyd",
"email": "KathyLloyd1@outlook.com",
"recipientId": "2",
"accessCode": "5000",
"routingOrder": "2",
"roleName": "##Seller1"
}
]
}
}
],
"document": {
"documentId": "1",
"name": "Going to test out signatures and initials.docx",
"fileExtension": "docx",
"documentFields": [
{
"name": "dgsvalue",
"value": "dgs-222"
}
],
"documentBase64": [bytearray]
}
}
],
"status": "sent",
"emailSubject": "Please sign the following 2 documents at 2:39 PM"
}
отклик
{
"envelopeId": "f8a090cf-ddc3-4612-8f24-9ff13beddc48",
"uri": "/envelopes/f8a090cf-ddc3-4612-8f24-9ff13beddc48",
"statusDateTime": "2017-02-01T19:39:26.2330000Z",
"status": "sent"
}
Я предполагал, что встроенные шаблоны должны будут снабжать всех подписывающих лиц. Имена ролей в 2 шаблонах одинаковы ( ##Buyer1 и ##Seller1 в обоих шаблонах). Я бы подумал, что отсутствие заполненного встроенного шаблона будет означать, что он потерпит неудачу в этом конкретном документе. Я был неправ, но я не уверен, почему. Удалось ли это сделать, потому что имена ролей одинаковы в обоих шаблонах сервера, и достаточно было указать его для одного встроенного шаблона?
1 ответ
Вы не обязаны указывать всех подписывающих лиц во встроенном шаблоне.
Вот полные правила использования составного шаблона.
Цитирую некоторые из них здесь.
Каждый CompositeTemplate добавляет в конверт новый документ и шаблоны наложения. Для каждого CompositeTemplate применяются следующие правила:
Шаблоны накладываются в порядке их значения последовательности.
Если Документ не передан в систему, используется документ первого шаблона (на основе значения Последовательности шаблона).
Последний в выигрыше во всех случаях, кроме документа (например, информация о конверте, информация о получателе, информация о безопасном поле). Это было сделано для простоты. Особого корпуса нет.
Например, если вы хотите повысить безопасность вкладки, это необходимо указать в последнем шаблоне, в который включена вкладка. Если вы хотите повысить безопасность получателя роли, он должен быть в последнем шаблоне, в котором указан получатель роли.
Сопоставление получателей основано на роли получателя и порядке маршрутизации. Если есть совпадения, информация о получателе объединяется вместе. После всех наложений шаблонов выполняется окончательная передача всех шаблонов CompositeTemplates, чтобы свернуть получателей с одинаковым адресом электронной почты, именем пользователя и порядком маршрутизации. Это предотвращает наличие одинаковых получателей в одном и том же порядке маршрутизации.