Элементы DocumentPDFs неизменно возвращаются из DocuSign Connect

Question

Я успешно внедрил систему, которая создает документы, которые будут подписаны с помощью шаблона с использованием .NET API, а затем прослушиватель DocuSign Connect, который вызывается на подписанный конверт (прямо сейчас только сообщать Connect о сигнатурах конвертов и отклонениях). У меня есть опция «Включить документы» на мои настройки DocuSign Connect. Когда я создаю конверт для подписи программно с одним подписывающим, все это работает - мой вызывающий прослушиватель подключается, элемент /DocuSignEnvelopeInformation/DocumentPDF/PDFBytes имеет в нем данные Base64, и я успешно декодировал это и сохранил его в нашем управлении doc система. Круто. Демонстрации хорошо, менеджмент любит это.

Однако, я заметил, по крайней мере, два сценария, где /DocuSignEnvelopeInformation/DocumentPDF раздел не возвращается на все:

1. При наличии нескольких подписантов.

2. Когда конверт создается вручную, даже если он использует тот же шаблон.

я все еще могу использовать ответ Connect, чтобы получить /DocuSignEnvelopeInformation/EnvelopeStatus/DocumentStatuses и извлечения идентификаторов документов из DocumentStatus дочерних элементов, а затем получить те программно с помощью .NET API. Но мне интересно, почему байты PDF не постоянно возвращаются постоянно? Является ли это ожидаемым поведением? Я что-то упускаю?

Я бы предпочел, чтобы сохранить «обходы» и просто Connect доставить все подписанные документы PDF для меня, когда она вызывает (и да, я прочитал Рекомендаций для получения документов раздела DocuSign Connect Руководство и понимаете компромиссы. Просто интересно, нужно ли мне кодировать эту проблему, или то, что мне не хватает?

Answer 1

Хммм. Конверты не подписываются, они получают «отправлены» и «завершены». envelopeEvents и списков получателей в Connect::Create call.

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

Событие терминала конверта «завершено» всегда будет отправлено, если вы подписаны на него.

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

Добавлено

Только сейчас, я создал подписку Connect для всего конвертов Завершены события для всех пользователей в моем аккаунте на demo.docusign.net.В качестве подписчика (слушателя) я использовал бесплатную учетную запись от requestb.in

Используя веб-интерфейс пользователя (а не API), я создал конверт с двумя подписчиками. После того как я заполнил конверт, requestb.in получил уведомление, оно включало:

<DocumentPDFs> 
    <DocumentPDF> 
     <Name>House architectural overview.pdf</Name> 
     <PDFBytes>.... 

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