Когда использовать Docusign TemplateRole против подписчика

Question

Я пытаюсь увидеть, при каких обстоятельствах лучше использовать TemplateRole и Signer. Для моего приложения у нас есть вещи, структурированные, чтобы иметь один к одному между документом и шаблоном. У нас будут такие получатели, как Buyer1 и Seller1, и мы будем использовать привязные теги, чтобы наши подписывающие вкладки были автоматически. Я вижу одно отличие между подписывающими и TemplateRoles в том, что подписавший может иметь частное примечание. Я просто хочу использовать правильный тип получателя для моих конкретных обстоятельств.

Answer 1

Использование шаблона позволяет администраторам обновлять шаблон (с помощью webtool) без необходимости обновления кода.

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

Подумайте о шаблоне в качестве инструкций по программированию для документа (ов), включая расположение табуляции и настройки. Его проще добавить «программу» через webtool, а не указывать все через API. Хотя результаты одинаковы для обоих случаев.

Я считаю, что вы можете включить личное сообщение электронной почты для получателей, где вы также предоставляете поле roleName. Почему вы думаете, что не можете?

Помните, что вы можете «перезаписать» значения шаблона/программирование шаблонов, составив шаблоны в ваших конвертах: создать вызов.

Answer 2

"Signer" - это тип получателя. ШаблонRole является заполнителем для Получателя в Шаблоне. TemplateRole (как суррогат для будущего получателя) имеет любой атрибут получателя, за исключением того, что он может оставить имя получателя и электронную почту получателя. При создании фактического конверта вам нужно будет указать Получателя. Вы сопоставляете получателя с TemplateRole, чтобы заменить роль шаблона фактическим получателем.

Так, например, ваш шаблон может иметь несколько получателей, которые вы хотите динамически назначать людям во время создания конверта. Вы добавляете роли в шаблон, используя все обычные атрибуты получателя, чтобы указать рабочий процесс (например, routingOrder для последовательности получателей), назначать действия (вкладки) получателям типа подписчика и т. Д. В момент создания конверта ваш вызов API указывает получателей а затем использует их для выполнения TemplateRoles.