Неожиданное поведение с составными шаблонами

Question

У меня возникла проблема с пониманием того, как работают встроенные шаблоны. У меня есть 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" 
} 

Response

{ 
    "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 находятся в обоих шаблонах). Я бы подумал, что отсутствие встроенного шаблона будет означать, что он не сработает на этом конкретном документе. Я был неправ, но я не знаю, почему. Удалось ли это, потому что имена ролей одинаковы на обоих шаблонах серверов и достаточно указать его для одного встроенного шаблона?

Answer 1

Вы не обязаны предоставлять все подписывающие устройства в встроенном шаблоне.

Вот полные правила для Composite template usage.

Цитирование некоторых из них здесь.

Каждый CompositeTemplate добавляет новый документ и накладывает шаблоны на конверт. Для каждого CompositeTemplate применяются следующие правила:

Шаблоны накладываются в порядке их значения последовательности.

Если документ не передан в систему, используется документ первого шаблона (основанный на значении последовательности шаблона).

Последняя победа во всех случаях, за исключением документа (то есть конверта информации, информации получателя, информации безопасного поля). Этот был сделан, чтобы все было просто. Специального корпуса нет.

Например, если вы хотите повысить безопасность на вкладке, это необходимо указать в последнем шаблоне, в который включена вкладка. Если вы хотите повысить безопасность получателя роли, он должен быть в последнем шаблоне, в котором указан этот получатель этой роли.

Согласование получателей основано на роли получателя и порядке маршрутизации. Если есть совпадения, информация получателя объединяется. Окончательный проход выполняется на всех CompositeTemplates, после того как все наложения шаблонов были применены, чтобы свернуть получателей с тем же адресом электронной почты, именем пользователя и порядком маршрутизации. Это предотвращает наличие одинаковых получателей в одном и том же порядке маршрутизации.