Docusign API - безопасные поля не видны для второго получателя с использованием составных шаблонов

Question

Я продолжаю работать со сценарием, описанным в этом вопросе, и до сих пор у меня как застрахованного (первого получателя) есть возможность редактировать все защищенные поля, которые были созданы при первоначальном создании шаблонов моего сервера. Что не происходит, однако, второй получатель (производитель, который также является подписывающим лицом) не имеет тех полей, которые были обозначены как обязательные видимые. Кажется, что это происходит только тогда, когда я отправляю вызов API для подписи в составных шаблонах. При работе с одним шаблоном обе стороны обозначили поля, доступные для редактирования. Я понимаю, что это может быть проблема конфигурации, но хотел исключить возможность пропуска важных параметров в моем вызове. Я вошел в функции учетной записи консоли и установил безопасные поля, видимые для всех получателей (см. Комментарий Молли на форуме).

Вот мой вызов XML. Может быть некоторая избыточность (например, тип, порядок маршрутизации), но я работаю на разных примерах. Заранее спасибо.

<envelopeDefinition xmlns=\"http://www.docusign.com/restapi\">
<accountId>123456</accountId>
<status>sent</status>
<emailSubject>another test</emailSubject>
<emailBlurb>This comes from Me</emailBlurb>
<compositeTemplates>
    <compositeTemplate>
        <serverTemplates>
            <serverTemplate>
                <sequence>1</sequence>
                <templateId>894ed334-4183-4b68-857e-01fe4829f79e</templateId>
            </serverTemplate>
        </serverTemplates>
    <inlineTemplates>
        <inlineTemplate>
        <sequence>2</sequence>
            <recipients>
                <signers>
                    <signer>
                        <type>Signer</type>
                        <email>[e-mail]</email>
                        <name>test insured</name>
                        <RoutingOrder>1</RoutingOrder>
                        <recipientId>1</recipientId>
                        <roleName>Insured</roleName>
                    </signer>
                    <signer>
                        <email>[e-mail]</email>
                        <type>Signer</type>
                        <roleName>Producer</roleName>
                        <name>Test Agent</name>
                        <recipientId>2</recipientId>
                        <RoutingOrder>2</RoutingOrder>
                    </signer>
                </signers>
            </recipients>
        </inlineTemplate>
    </inlineTemplates>
</compositeTemplate>
</compositeTemplates>

Answer 1

Я не могу воспроизвести проблему, которую вы описываете. Я могу успешно создать конверт из одного шаблона (используя составные шаблоны в моем XML-запросе), где поле данных является обязательным / редактируемым для первого получателя, а то же поле данных доступно для редактирования для второго получателя (но необязательно - поскольку поле "принадлежит" первому получателю). Вот мой запрос XML:

<envelopeDefinition xmlns="http://www.docusign.com/restapi">
   <accountId>ACCOUNT_ID</accountId>
   <status>sent</status>
   <compositeTemplates>
    <compositeTemplate>
        <serverTemplates>
            <serverTemplate>
                <sequence>1</sequence>
                <templateId>TEMPLATE_ID</templateId>
            </serverTemplate>
        </serverTemplates>
        <inlineTemplates>
            <inlineTemplate>
                <sequence>2</sequence>
                <recipients>
                  <signers>
                    <signer>
                     <email>[e-mail]</email>
                     <name>John Doe</name>
                     <recipientId>1</recipientId>
                     <roleName>signer</roleName>
                     <routingOrder>1</routingOrder>
                    </signer>
                    <signer>
                     <email>[e-mail]</email>
                     <name>Jane Doe</name>
                     <recipientId>2</recipientId>
                     <roleName>signer2</roleName>
                     <routingOrder>2</routingOrder>
                    </signer>
                  </signers>
               </recipients>
            </inlineTemplate>
        </inlineTemplates>
    </compositeTemplate>
  </compositeTemplates>
</envelopeDefinition>

Вот несколько советов по устранению неполадок...

Сначала внесите пару изменений в ваш XML-запрос:

• Попробуйте использовать routingOrder (нижний регистр 'r') вместо RoutingOrder (верхний регистр 'r') в вашем XML. В моем (ограниченном) тестировании только что, DocuSign, кажется, игнорирует элемент RoutingOrder, если он начинается с заглавной буквы 'r'.

• Удалите элемент type из запроса XML - в этом нет необходимости, потому что вы сопоставляете каждого получателя с ролью шаблона (которая определяет тип получателя).

Кроме того, если вы хотите, чтобы оба получателя могли редактировать поле, дважды проверьте свойства поля в шаблоне через веб-консоль DocuSign, чтобы убедиться, что в этом поле выбрано " Разрешить всем редактировать ".

Наконец, не мешало бы дважды проверить настройки учетной записи ("Настройки"> "Функции"), чтобы убедиться, что выбрано свойство " Отображать начальный SecureField". (Иногда я видел, где кто-то включает настройку, но забывает сохранить изменения (нажав кнопку СОХРАНИТЬ, расположенную в самом низу страницы.))