Руководство по обновлению Adobe Acrobat Sign для Salesforce

Начиная с версии 21.0 объект SIGN_Signed_Agreement__c (название метки: «Подписанный документ») устарел.

Клиенты, желающие получить URL-адрес подписанного документа, должны использовать вызов REST API для документа GET /agreements/{agreementId}/combinedDocument/url.

Примечание. URL-адрес, возвращаемый от вызова API, защищен и может быть использован только в течение ограниченного времени.

Ниже приведен новый порядок (версия 21.0), в котором документ и связанные с ним объекты обновлены.

1. Вложения
2. Получатели
3. Документ (состояние и другие атрибуты)
4. Действия, связанные с документом
5. Каналы Chatter

Начиная с версии 21.x, все асинхронные процессы, в том числе автоматические обновления и сопоставления данных, переведены с будущих методов на методы с созданием очереди. Этот новый подход введен по рекомендации Salesforce.

В связи с этим при изменении параметров абонентской организации, добавляющей задания в очередь Salesforce в процессе автоматического обновления и/или сопоставления данных, возникает ошибка «System.LimitException: слишком много заданий добавлено в очередь: 2»

Это происходит потому, что процесс с созданием очереди может добавить в очередь толькоодно дочернее задание, которое уже занято приложением Adobe Sign (см. раздел Ограничения метода Apex с созданием очереди).

«При создании цепочки заданий можно добавить только одно задание из выполняемого задания с помощью System.enqueueJob. Это означает, что у каждого родительского задания, добавляемого в очередь, может быть только одно дочернее задание. Запуск нескольких дочерних заданий из одного и того же задания, добавляемого в очередь, не поддерживается».

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

Чтобы устранить эту ошибку, найдите триггер, компоновщик процессов или рабочий процесс, где допущено нарушение, и отключите его. Также можно переключить его в режим синхронных вызовов или запланировать его выполнение на будущее, например на 1 час позже.

• Статус соглашения теперь обновляется после обновления документов и получателей.
  Для версии 21 или более ранних статус установлен ранее.

• Объект подписанного соглашения, в котором хранятся URL-адреса изображений, сейчас не вставлен.
  Для версии 21 он вставлялся после завершения всех остальных обновлений.
• Максимальный размер запроса или ответа выноски ограничен до 12 МБ для асинхронного Apex в пределах возможностей руководителя Salesforce: https://developer.salesforce.com/docs/atlas.ru-ru.210.0.apexcode.meta/apexcode/apex_gov_limits.htm
  Документы, размер которых превышает 12 МБ, невозможно извлечь из Sign ввиду ограничения, указанного выше.

• Теперь описания события документа совпадают с описанием, возвращенным Sign API, и содержат отчеты об аудите.
• Процесс обновления теперь выполняется в Salesforce как встроенный пакетный процесс Apex (это асинхронный процесс).
  Ранее обновление выполнялось с помощью API-вызовов за пределами Salesforce. Триггеры этих обновлений статуса, которые запускают асинхронные процессы, теперь не выполняются, поскольку Salesforce ограничивает вызов другого асинхронного процесса из уже запущенного асинхронного процесса.
• Объект документа теперь обновляется в одной транзакции.
  До версии 21 обновления атрибутов документа разделялись на отдельные вызовы обновления.
• Теперь обновления стали более надежными, так как внутренний сервер Sign повторяет попытку запуска событий со сбоями указанное число раз.
  До версии 21 документы со сбоями повторно запускались только путем обновления вручную в приложении Salesforce.
• Обновление, запускаемое вручную, теперь включает все аспекты документов, включая связанные объекты.
• Передача документов теперь запускается в асинхронном режиме, так же, как регулярные обновления; при этом аналогично регулярным обновлениям обновляются другие атрибуты.
• Реализованы новые параметры, которые позволяют включить и отключить обновление различных аспектов документа.
• После сохранения подписанного документа PDF в Salesforce в конце имени файла больше не будет добавляться дескриптор (-signed или -approved).

После завершения обновления выполните следующие действия, чтобы восстановить подключение OAuth к Acrobat Sign:

1. Выберите вкладку Администратор Adobe Acrobat Sign.
2. Выберите Включить автоматическое обновление статуса.
3. Нажмите Включить.
4. Выберите пункт Разрешить.

В версии 20 пользователь обратного вызова в Salesforce не должен был быть лицензионным пользователем Adobe Sign. 

Улучшения механизма сопоставления загрузки в версии 21 требуют, чтобы пользователь обратного вызова имел активный идентификатор пользователя в учетной записи Acrobat Sign, подключенной к организации Salesforce.

Пользователи версии 20, использующие сопоставление загрузки, перед обновлением должны убедиться, что пользователь обратного вызова уже подготовлен в Adobe Acrobat Sign. В противном случае функция сопоставления загрузки прекратит работать (до добавления пользователя) после обновления до версии 21.

Функция сопоставления загрузки, которая автоматически соединяла связанные объекты, используя параметр «Копировать контакт, учетную запись/возможность», была расширена и включает соглашения, отправленные из Salesforce.

• Например, соглашения, отправленные из Salesforce, автоматически копируют подстановку возможности первого получателя контакта в подстановку возможности соглашения и подстановку учетной записи первого получателя контакта в подстановку учетной записи соглашения, если отправленные соглашения не имеют учетных записей/возможностей.

В версиях, предшествующих версии 21, каналы Chatter заполнялись только после отправки соглашения из Salesforce.

Это обновление расширяет канал Chatter, включая в него соглашения, отправленные за пределами Salesforce (Передача соглашений).

В версиях, предшествующих версии 21, на странице «Просмотр документа» изображение PDF и URL-адрес обновлялись только после завершения действий первого получателя.

Теперь изображение и URL-адрес обновляются раньше, при изменении статуса на Предварительное заполнение или когда у первого получателя статус Отправлено на подпись.

Для включения данной функции от пользователя не потребуется менять никакие настройки.

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

Для включения данного статуса от пользователя не потребуется менять никакие настройки.

В шаблоне документа есть поле «Количество дней до окончания срока действия» (echosign_dev1__Days_Until_Expiration__c).  В версии 21 это числовое поле устарело.

Добавлено новое поле «Количество дней до окончания срока действия» (имя API: echosign_dev1__Days_Until_Expiration2__c), которое является текстовым, позволяя использовать ссылки на другие поля главного объекта (например, {!Expiry_Date__c}).

При обновлении с предыдущей версии любые формы данных, для которых создано сопоставление с устаревшим полем срока действия, автоматически копируются в новое поле, поэтому от пользователя не требуется никаких действий.

На странице шаблона в данной версии поля Учетная запись, Возможность, и Контракт недоступны.

Администратор может настроить эти поля в шаблоне, используя функцию Сопоставление данных в полях соглашения.

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

На страницах «Новый шаблон» это поле больше недоступно. Теперь отправители могут добавлять себя в любое место в очереди подписания.

Удален переключатель «Последовательно» - «Параллельно» для указания порядка подписания.

Новый стиль шаблона обеспечивает полностью настраиваемый рабочий процесс, который может быть полностью последовательным (индекс подписанта 1 через 1+N), параллельным (все индексы подписанта равны 1) или комбинацией последовательного и параллельного процессов, при этом индекс подписи настраивается в соответствии со специальным рабочим процессом.

В версии 21 признаны устаревшими 5 настроек. Все эти настройки располагались в разделе Настройки Adobe Sign блока Пользовательские настройки.

5 таких настроек перечислены ниже.

• Добавить аудиторский PDF в список вложений — включите этот параметр, чтобы прикрепить файл PDF с аудиторским следом к записи документа после подписания документа.
• Добавлять подписанные PDF как отд. влож. — включите этот параметр, чтобы прикреплять файлы PDF подписанных документов в виде отдельных вложений, если в рамках одной операции отправлено несколько документов. Чтобы перестать получать подписанный документ в виде объединенного файла PDF, обратитесь в службу поддержки клиентов Adobe.
• Добавить сопутствующие файлы в список вложений — включите этот параметр, чтобы прикрепить файлы PDF сопутствующих документов к записи документа после подписания документа. Используя поля сопутствующих документов в документе, подписанты могут загружать и прикреплять сопутствующие документы к операции документа.
• Добавить ссылку на подписанный PDF для загруженных документов (включено по умолчанию) — этот параметр применим только для загруженных документов, которые отправлены за пределами Salesforce. Включите этот параметр, чтобы добавить ссылку на подписанный документ PDF в запись соглашения.
• Добавить ссылку на подписанный PDF для загруженных документов (включено по умолчанию) — этот параметр применим к документам, которые отправлены за пределами Salesforce и загружены в Salesforce. Включите этот параметр, чтобы добавить подписанный файл PDF к записи документа.

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