Как я могу прикрепить пользовательскую вкладку к конверту с подписью документа?

#docusignapi #docusignapextoolkit

Вопрос:

Просматривая документацию API Docusign, я не могу понять, как прикрепить пользовательскую вкладку к конверту. Использование традиционных вкладок иногда запрещает мне устанавливать текст. Следовательно, возникает необходимость в пользовательской вкладке. Используя CustomTabsAPI, я могу создать пользовательскую вкладку. Что остается, так это возможность прикрепить пользовательскую вкладку к конверту.

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

Я использую EnvelopeDefinition его для создания своего конверта. Я ожидал чего-то вроде:

 envelope_definition = EnvelopeDefinition(
        custom_fields=custom_fields,
        documents=documents,
        recipients=recipients,
        status='created',
        event_notification=event_notification,
        email_settings=email_settings,
        custom_tabs=custom_tabs # <------ SOMETHING LIKE THIS
    )
 

Есть какие-нибудь предложения? Пример того, как добавлять пользовательские вкладки? Документация? ТИА

РЕДАКТИРОВАТЬ: Вот текстовая вкладка, которая у меня сейчас есть

 signer = Signer(**args)
title_text = Text(
                anchor_string=anchor_string, 
                anchor_units="pixels", anchor_y_offset="10",
                anchor_x_offset="0", width="180", value=initial_value
            )
signer.tabs = Tabs(text_tabs=[title_text])
 

пример img текста, который нельзя редактировать

пример img пользовательской вкладки это можно отредактировать

Если я смогу отредактировать текстовую вкладку, это будет здорово.

Комментарии:

1. можете ли вы подробнее остановиться на «Использование традиционных вкладок иногда запрещает мне устанавливать текст»? Мне просто интересно, есть ли что-то, чего вам не хватает, и вы могли бы использовать обычные текстовые вкладки для своих нужд.

2. В случае, если заголовок неверен, цель состоит в том, чтобы сделать заголовок редактируемым. Однако, согласно документации Docusign: «На вкладке заголовок отображается заголовок получателя. Это значение невозможно установить». Я хотел бы иметь возможность «установить» заголовок, если он неверен. Поэтому я прибегнул к использованию пользовательских вкладок, когда у меня возникли проблемы с прикреплением пользовательской вкладки к конверту. @InbarGazit

3. Если бы я каким-то образом мог избежать использования CustomTab и вместо этого использовать TextTab, это было бы здорово! Возможно, вы правы, предположив, что я, возможно, упускаю аргумент, который делает текстовую вкладку доступной для редактирования. Хотя в настоящее время я понятия не имею, что такое отсутствующий аргумент/опция? @InbarGazit

4. Спасибо @InbarGazit, Отсутствующий аргумент, на который вы мне указали, был locked="false" . Теперь я могу использовать текстовую таблицу вместо таблицы заголовка (которая недоступна для редактирования). Добавление locked="false" позволяет мне редактировать текст. Тем не менее, мне все еще любопытно, как бы я добавил пользовательскую вкладку в конверт?

5. Я не знаю, как воздать вам должное за вашу помощь. Хотя ваши комментарии не совсем отвечают на мой вопрос, ваша помощь обеспечила мне обходной путь, за который я полностью благодарен и благодарен. Большое вам спасибо @InbarGazit

Ответ №1:

Краткое изложение решения:

title Вкладка является системной вкладкой, поэтому значение не может быть установлено.

Вместо этого операция будет использовать text вкладку, установит ее значение и установит атрибут locked false равным, чтобы подписавшие могли обновить его.