Как установить значение поля Пользовательская вкладка?

Question

Мне нужно заполнить пользовательское значение поля из системы, используя Docusign Api, есть ли API?

Пока я делал следующие вещи

1. создал настраиваемое поле и поместил его в документ, как показано на рисунке ниже.

2. Используется

   POST / v2 / account / {accountId} / envelopes / {envelopeId} / documents / {documentId} / fields

выдал ошибку:

Есть ли способ заполнить значение настраиваемого поля перед отправкой конкретному подписавшему? Нужна помощь.

Answer 1

Во-первых, к сожалению, термин «настраиваемое поле» часто используется для двух разных функций в системе DocuSign:

Конверты могут иметь поля метаданных. Эти поля не отображаются ни для одного получателя. Их полное имя Envelope Custom Fields. Они управляются с помощью Admin Tool. Смотрите на скриншот панели навигации инструмента администратора:

Envelope Custom Fields может быть установлено отправителем конверта (или через API). Они отображаются в сертификате завершения и доступны через API.

Насколько я могу судить по вашему вопросу, это НЕ то, что вы делаете.

Вкладки могут иметь настраиваемые параметры. Поскольку вкладки (терминология API) называются полями в веб-интерфейсе пользователя, после их настройки некоторые называют их пользовательскими полями. Но лучше термин Document Custom Fields

Они управляются на уровне учетной записи, поэтому вы также можете использовать Admin Tool для управления ими.

API для заполнения пользовательских полей документа Вы можете установить их значения при создании конверта.

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

Обратите внимание, как устанавливаются роли шаблонов, а для роли, с которой связаны вкладки, устанавливается только значение вкладки.

{
    "status": "sent",
    "templateId": "77b6fbef-1448-4ac3-819f-253a9e1cb08e",
    "templateRoles": [
        {
            "clientUserId": "1000",
            "email": "signer@example.com",
            "name": "Larry Kluger",
            "roleName": "signer",
            "tabs": {
                "listTabs": [
                    {
                        "tabLabel": "Custom Drop down",
                        "value": "Option 2"
                    }
                ],
            }
        },
        {
            "email": "cc_person@example.com",
            "name": "Susan Kluger",
            "roleName": "cc"
        }
    ]
}