DocuSign: Как отправить выбор группы радиостанций на вкладках получателя?

Question

У меня есть радиогруппы, настроенные в моем шаблоне, и я хочу предварительно заполнить эти теги с помощью REST API.

Пожалуйста, не запрашивайте код и/или запрос/ответные свалки. У меня нет кода для показа, и я прошу об этом, потому что он не документирован. Я хочу знать, какой JSON мне нужно производить, поэтому на самом деле это не мой код или язык программирования.

---

(Все, что ниже этой линии наполовину декламация и половина описывает мои неудачные попытки найти документацию для этой функции. Это еще может быть полезно, если кто-то имеет точно такую ​​же проблему со мной.)

Here - это документация для API, которую я пытаюсь использовать. Существует пример для textTabs, но radioGroupTabs здесь даже не упоминается. Упомянуто here, но я не могу много сделать из "null", очевидно, что я должен отправлять что-то отличное от нуля.

Переходя, единственная полезная информация, которую я могу найти в группах радио, - это о том, как их создать в шаблоне, это here. На этой странице также ничего не говорится о предварительном заполнении значений для получателя. Но это связано с here (см. tabs) в любом случае. Существует немного информации здесь:

value: if an X, this is the selected radio button. Only one radio button in a group can be selected. 

А потом как раз перед этим он говорит:

selected: Sets if this is radio button is selected. Use true/false to show the value is selected or not. Only one radio button can be true. 

Так мы узнаем, есть только два способа указать радио виджет выбран. Конечно, это применимо, когда вы создаете виджет.

Тем не менее я попытался сделать запросы, предполагая, это также будет работать для предварительного заполнения Я получил это полезное сообщение об ошибке:

{ 
    "errorCode": "UNSPECIFIED_ERROR", 
    "message": "Object reference not set to an instance of an object." 
} 

Когда я обыскать форум поддержки Я нашел this, это не совсем то же самое с моей проблемой, я был бы рад, если бы был выбран неправильный виджет радио (в отличие от получения UNSPECIFIED_ERROR), но этот пост посвящен XML API.

Я начал свой безумный поиск по новой теме, он настолько хорошо расположен, что вы можете найти его менее чем за 10 минут. Я помню, что раньше я ходил в свой профиль, а затем щелкнул что-то там ... Тогда я сделал то, что каждый разумный разработчик сделал бы в первую очередь, и вернулся к URL-адресу сообщения и прочитал панихиды; Dev Zone раздел был переименован в Dev Zone (MOVED TO STACK OVERFLOW - Use tag DocuSignAPI). И вот я здесь.

Не могли бы рассказать, где эта функция задокументирована или, может быть, предоставить образец JSON, пожалуйста?

Answer 1

Вы нашли правильную страницу для how to create radio buttons, не знаете, почему у вас возникли проблемы с использованием этого ресурса. Вы упомянули, что это код, чтобы СОЗДАТЬ вкладки переключателя и не отправлять их. Это неверно - тело запроса для отправки их - это то же самое тело, что только статус свойства запроса изменяется с создано по отправлено.

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

{ 
"emailBlurb": "Testing DocuSign radio buttons", 
"emailSubject": "Custom PHP script", 
"status": "sent", 
"documents": [ 
    { 
     "documentId": "1", 
     "name": "test.pdf" 
    } 
], 
"recipients": { 
    "signers": [ 
     { 
      "email": "john.doe@docusign.com", 
      "name": "John Doe", 
      "recipientId": "1", 
      "tabs": { 
       "signHereTabs": [ 
        { 
         "xPosition": "100", 
         "yPosition": "200", 
         "documentId": "1", 
         "pageNumber": "1" 
        } 
       ], 
       "radioGroupTabs": [ 
        { 
         "documentId": "1", 
         "groupName": "RadioGroup1", 
         "radios": [ 
          { 
           "pageNumber": "1", 
           "selected": "true", 
           "value": "X", 
           "xPosition": "300", 
           "yPosition": "75" 
          }, 
          { 
           "pageNumber": "1", 
           "selected": "false", 
           "xPosition": "350", 
           "yPosition": "75" 
          } 
         ] 
        } 
       ] 
      } 
     } 
    ] 
} 

}

Чтобы добавить к этому, в приведенном выше примере используется абсолютное позиционирование в положение переключателей на документе. Другой способ указания мест вкладок в DocuSign заключается в использовании так называемой «привязки привязки». При привязке меток вместо позиционирования на основе систем координат вы можете разместить свои вкладки в отношении содержимого документа. Пожалуйста, смотрите следующие две ссылки, чтобы узнать, как использовать якорь тегов, это довольно легко перейти к этому методу:

Anchor Tagging Introduction - Look at the "Tab Positioning" section

Related Stack Overflow Link