На странице Salesforce перейдите на вкладку Администрирование Adobe Acrobat Sign.
- Интеграции Adobe Acrobat Sign
- Новые возможности
- Версии и жизненный цикл продуктов
- Acrobat Sign для Salesforce
- Установка пакета
- Настройка пакета
- Руководство пользователя
- Включение аутентификации по цифровому удостоверению
- Руководство разработчика
- Руководство по расширенной настройке
- Руководство по сопоставлению и шаблонам полей
- Руководство пользователя мобильного приложения
- Руководство по автоматизации потоков
- Руководство для Document Builder
- Настройка больших документов
- Руководство по обновлению
- Заметки о выпуске
- Часто задаваемые вопросы
- Руководство по устранению неполадок
- Дополнительные статьи
- Acrobat Sign для Microsoft
- Acrobat Sign для Microsoft 365
- Acrobat Sign для Outlook
- Acrobat Sign для Word/PowerPoint
- Acrobat Sign для Teams
- Acrobat Sign для Microsoft PowerApps и Power Automate
- Соединитель Acrobat Sign для Microsoft Search
- Acrobat Sign для Microsoft Dynamics
- Acrobat Sign для Microsoft SharePoint
- Обзор
- SharePoint On-Prem: Руководство по установке
- SharePoint On-Prem: Руководство по сопоставлению шаблонов
- SharePoint On-Prem: Руководство пользователя
- SharePoint On-Prem: Заметки о выпуске
- SharePoint Online: Руководство по установке
- SharePoint Online: Руководство по сопоставлению шаблонов
- SharePoint Online: Руководство пользователя
- SharePoint Online: Руководство по сопоставлению веб-форм
- SharePoint Online: Заметки о выпуске
- Acrobat Sign для Microsoft 365
- Acrobat Sign для ServiceNow
- Acrobat Sign для HR ServiceNow
- Acrobat Sign для SAP SuccessFactors
- Acrobat Sign для Workday
- Acrobat Sign для NetSuite
- Acrobat Sign для SugarCRM
- Acrobat Sign для VeevaVault
- Acrobat Sign для Coupa BSM Suite
- Acrobat Sign для Zapier
- Документация для разработчиков Acrobat Sign
Не получается отправить документы из Salesforce? Сопоставления данных не обновляют поля в Salesforce?
Руководство по устранению неполадок в Adobe Acrobat Sign для Salesforce помогает решить проблемы с отправкой документов из Salesforce, а также с сопоставлением данных или автоматическим обновлением статуса. Темы:
- Устранение проблем с сопоставлением данных
- Устранение сбоя при отправке соглашений
- Устранение сбоя при автоматическом обновлении статуса
- Устранение проблем, которые могут возникнуть после включения расширенных доменов
- Поиск и устранение неполадок ведет к поиску потенциальных клиентов в среде Government Cloud
- Свяжитесь со Службой технической поддержки
Сопоставление данных Acrobat Sign позволяет обновить объекты Salesforce при подписании соглашения Acrobat Sign или на указанном этапе рабочего процесса. Каждое сопоставление данных необходимо настроить заранее и установить для него правила сопоставления. Каждое правило сопоставления данных определяет источник данных и целевое поле Salesforce, которое оно должно обновить. Более подробную информацию можно найти в разделе справки Сопоставление данных Salesforce.
Если сопоставление данных не обновляет требуемое поле в Salesforce, следующие инструкции помогут вам выявить и устранить проблему.
Выполните следующие действия:
-
Убедитесь, что правильно указан пользователь для автоматического обновления статуса (обычно это администратор учетной записи Sign, которого вы указали при настройке интеграции), и что отправитель имеет доступ к объектам, которые вы намерены обновлять через сопоставление данных.
Для проверки значения этого поля можно добавить это поле в представление списка соглашений, открыть консоль разработчика или Workbench.
Убедитесь, что поле «Результат сопоставления данных» для объекта «Соглашение» имеет значение «Завершено» или «Сбой». Если значения нет, значит сопоставление данных не запускалось. Если значение пусто и в поле «Сопоставление данных» указан идентификатор пользователя, попробуйте повторно запустить сопоставление данных, выполнив следующее.
В поле Ошибка сопоставления данных сохраняются ошибки, возникшие при сопоставлении данных. Для проверки значения этого поля можно добавить его в представление списка соглашений, использовать консоль разработчика или Workbench. Ниже представлен список наиболее частых ошибок и способы их устранения.
Ошибка | Failed to map data field: System.DmlException Update failed. First exception on row 0 with id 00ZxxqwertasdmjVUAR; first error: STRING_TOO_LONG, Owner Title: data value too large: Adobe Acrobat Sign Adobe inc (max length=20): [Owner_Title__c] (echosign_dev1) 165 |
Решение Эта ошибка означает, что объем данных в поле формы обновленного документа превышает предельный размер поля Salesforce, которое нужно обновить. Для решения проблемы:
|
|
Ошибка |
Попытка сопоставления со ссылкой на связанный объект, не установленный в соглашении: <Имя API для поля в объекте Salesforce, который вы пытаетесь обновить>” |
Решение Эта ошибка означает, что между объектом соглашения и обновляемым объектом Salesforce не установлено соединение. См. шаг 4 выше. |
|
Ошибка |
Failed to map data field: System.NullPointerException Attempt to de-reference a null object (echosign_dev1) 656 |
Решение Эта ошибка означает сбой при сопоставлении данных, вызванный отсутствием доступа к требуемому объекту. Выполните следующие действия, чтобы устранить эту проблему:
|
Пример пользователя:
Джон Смит
Пример использования:
Джон хочет:
- отправить соглашения из пользовательского объекта под именем «Демо 1», используя шаблон соглашения;
- получить данные из другого пользовательского объекта под именем «Демо 2», который сопоставлен с объектом «Демо 1» и отправить эти данные в соглашение;
- отправить данные в запись объекта «Демо 2», когда соглашение будет подписано.
Шаги для достижения этих целей.
- В объекте Acrobat Sign «Соглашение» создайте поле поиска для объекта «Демо 1».
- В объекте «Демо 1» создайте поле поиска для объекта «Демо 2».
Вы не сможете отправлять данные в связанный список или получать данные из него. - Создайте шаблон сопоставления данных следующим образом.
- Придумайте уникальное имя шаблона.
- В разделе Сопоставления полей нажмите Выбранный объект, а затем в раскрывающемся меню выберите Демо 1.
- В следующем раскрывающемся списке выберите Идентификатор Демо 2.
- В третьем раскрывающемся списке сохраните значение «Нет» и нажмите Выбрать.
- На вопрос «Какое поле обновить в Salesforce?» выберите имя поля, которое хотите обновлять.
- Чтобы завершить настройку сопоставления данных, выполните шаги из раздела Использование сопоставления данных для отправки данных о подписывающей стороне и файлов в записи Salesforce в руководстве по сопоставлениям и шаблонам.
- Создайте шаблон переноса данных следующим образом.
- Придумайте уникальное имя шаблона.
- Нажмите Добавить сопоставление поля.
- В разделе Исходное значение нажмите Выбранный объект, а затем в раскрывающемся меню выберите Демо 1.
- Во втором раскрывающемся списке выберите Идентификатор Демо 2.
- В следующем раскрывающемся списке выберите имя поля, из которого вам нужно извлекать значения, и нажмите Готово.
- Чтобы завершить настройку переноса данных, выполните инструкции из раздела Использование переноса данных для создания документов с помощью данных Salesforce из руководства по сопоставлениям и шаблонам.
- Создайте шаблон соглашения, выполнив процедуру из раздела Создание шаблонов рабочих процессов.
- В шаблоне соглашения, который вы создали ранее, обязательно добавьте шаблоны переноса данных и сопоставления данных в разделе «Сопоставление данных».
- В разделе Сведения о шаблоне для шаблона соглашения выберите объект Salesforce с именем Демо 1.
- Нажмите Сопоставить данные с полями соглашения и в открывшемся диалоговом окне выполните следующие действия.
- Выберите вариант Выбрать из объекта.
- В поле Тип источника выберите Идентификатор Демо 1.
- В разделе Целевое поле документа выберите объект Демо 1 из поля поиска.
- Нажмите Сохранить.
- На странице шаблона соглашения нажмите Сохранить.
Эта процедура создает шаблон соглашения, связанный с объектом «Демо 1», и включает для него перенос данных и сопоставление данных. - Откройте запись объекта «Демо 1» и нажмите > Страница редактирования. Теперь в разделе пользовательского управления на панели слева выберите и перетащите элемент AgreementPanel, затем нажмите Сохранить.
- Нажмите Активация и назначьте нужную страницу записи. Для целей тестирования можно выбрать «Назначить по умолчанию для организации», чтобы элемент AgreementPanel стал доступен всем пользователям.
- Нажмите Далее, а затем — Сохранить.
- Перейдите к записи объекта «Демо 1» и обновите страницу. Вы должны увидеть только что добавленную панель AgreementPanel.
- Нажмите Отправить соглашение на подпись. Отобразится созданный вами шаблон соглашения.
- Выберите этот шаблон и следуйте инструкциям на экране, чтобы отправить соглашение. Убедитесь, что в соглашение включены данные, объединенные из «Демо 2».
- Подпишите соглашение. Вы увидите, что запись «Демо 2» обновилась и теперь содержит данные из соглашения.
Если не получается отправить соглашения из Salesforce, выполните следующие шаги для устранения этого сбоя.
-
Убедитесь, что у вас поддерживаемая версия Adobe Acrobat Sign. См. поддерживаемые версии.
-
Убедитесь, что у отправителя (это вы) есть требуемые разрешения.
См. раздел о том, как предоставить пользователям доступ. В дополнение к объектам и полям, которые указаны в этом руководстве, отправитель должен иметь доступ к другим объектам Salesforce, которые используются в этом рабочем процессе. -
Проверьте, применены ли к объекту «Соглашение» или к другим объектам Acrobat Sign пользовательские настройки: триггеры, рабочие процессы или правила. Отключите все пользовательские настройки, если они есть, и отправьте тестовое соглашение для проверки правильности работы.
Если после отключения настроек соглашение будет успешно отправлено, изучите инструкции в руководстве для разработчиков.
Примечание.Мы не предоставляем поддержку для устранения неполадок с пользовательскими настройками.
-
Выберите любой из предложенных ниже способов, чтобы выяснить тип ошибки, которую вы получаете при отправке соглашения.
- Откройте запись проблемного соглашения в Salesforce и найдите красный баннер с сообщением об ошибке. Эта ошибка описывает причину проблемы.
- Проверьте поле «Сообщение об ошибке» в объекте «Уведомление о соглашении».
- Чтобы проверить это через консоль разработчика и выполнить предложенный ниже запрос SOQL, выполните следующее.
Select echosign_dev1__Error_Message__c from
echosign_dev1__Agreement_Notification__c where
echosign_dev1__Agreement__c = ‘<ИД вашего документа>
-
См. следующую таблицу ошибок и шагов по устранению неполадок.
Ошибка
Решение
Недействительный идентификатор или адрес электронной почты пользователя в заголовке x-api-user
ИлиУ вас нет действительной учетной записи пользователя Adobe Acrobat Sign
Эти ошибки показывают, что у отправителя нет действующей лицензии Acrobat Sign. Чтобы устранить неполадку:
- Проверьте поле Отправитель записан в записи соглашения, чтобы определить отправителя соглашения.
Если пользователь, указанный в поле Отправитель записан, отсутствует в Salesforce, пакет Acrobat Sign будет использовать поле Создано в качестве «отправителя» соглашения. - Откройте страницу отправителя Сведения о пользователе в Salesforce и убедитесь, что в поле Адрес эл. почты указан допустимый адрес электронной почты, для которого назначена активная лицензия Sign для организаций. Проверка наличия активной лицензии Sign для организаций, назначенной для адреса электронной почты
- Выполните вход в Acrobat Sign с учетными данными администратора.
- Перейдите в раздел Учетная запись > Пользователи и найдите адрес электронной почты.
- Статус пользователя должен быть активным. Пользователи, не имеющие статуса «активный», не могут отправлять соглашения. Если пользователь не является активным, изучите процедуры по добавлению пользователей и управлению ими, в частности инструкции в разделе «Адрес электронной почты используется, но пользователь не имеет статуса "Активный"».
- Если используется механизм Отправить от имени (SOB), проверьте настроенный для него адрес электронной почты, который указан в поле Отправить от имени в объекте Соглашение. Убедитесь, что для адреса электронной почты этого пользователя указана действующая лицензия Sign, выполнив вход в Acrobat Sign. Убедитесь, что поле Разрешить отправку в качестве других пользователей включено на странице Сведения о пользователе для пользователя, который настроен для механизма «Отправить от имени». Это поле может отсутствовать в стандартном макете страницы для объекта «Пользователь».
- Проверьте пользовательские разрешения, как описано выше в шаге 2. См. раздел о том, как предоставить пользователям доступ.
Формат файла не поддерживается
Эта ошибка возникает, если документ, который вы пытаетесь отправить на подпись, имеет поддерживаемый формат.
См. раздел Поддерживаемые форматы документов в статье Системные требования к Acrobat Sign, чтобы проверить, какие форматы файлов поддерживаются для добавления в Acrobat Sign.
В кнопке подписи используется некорректный идентификатор объекта
Эта ошибка возникает, когда идентификатор шаблона кнопки Отправить от имени или идентификатор главного объекта недействителен.
Рекомендуется ввести правильный идентификатор объекта и повторить попытку.
- Проверьте поле Отправитель записан в записи соглашения, чтобы определить отправителя соглашения.
Если статус соглашения не обновляется, выполните следующие шаги по устранению сбоя.
-
Проверьте, выполнены ли у вас предварительные условия и настройка конфигурации после установки (необходима), которые упоминаются в Руководстве по установке Adobe Acrobat Sign для Salesforce.
-
На странице Salesforce Lightning перейдите в раздел Администрирование Adobe Acrobat Sign > Включить автоматическое обновление статуса и убедитесь, что видите сообщение «Функция автоматического обновления статуса включена для этой организации».
Если вы не видите этого сообщения, выполните следующие шаги.
- Выйдите из системы и снова войдите в роли системного администратора.
- Перейдите в раздел Администрирование Adobe Acrobat Sign > Включить автоматическое обновление статуса и нажмите Включить.
- В появившемся диалоговом окне «Разрешить доступ к Acrobat Sign»:
- Обратите внимание на адрес электронной почты в нижней части диалогового окна.
- Этот адрес должен иметь действующую лицензию для Sign и роль системного администратора в Salesforce.
- Убедитесь, что для пользователя назначен набор разрешений «Пользователь интеграции с Adobe Sign».
- Выберите пункт Разрешить.
Должно отобразиться следующее сообщение: «Функция автоматического обновления статуса включена для этой организации».
-
В объекте «Уведомление о соглашении» проверьте значение поля Сообщение об ошибке. Чтобы проверить значение этого поля, выполните предложенный ниже запрос SOQL в консоли разработчика.
SELECT Id, echosign_dev1__Agreement_Event_Type__c, echosign_dev1__Agreement_Status__c, echosign_dev1__Document_Key__c, echosign_dev1__Error_Message__c, echosign_dev1__Notification_Type__c, echosign_dev1__Status__c FROM echosign_dev1__Agreement_Notification__c where echosign_dev1__Agreement__c='<ИД документа>'
-
Если соглашение отправлено в среду Salesforce из внешнего источника, выполните рекомендации из Руководство по сервисам для отправки больших документов и передачи соглашений в Adobe Acrobat Sign для Salesforce.
-
Проверьте, обновился ли статус у этих соглашений. Если обновился, то попробуйте воспроизвести проблему с новым тестовым соглашением. Если проблема повторяется, выполните следующие действия по устранению неполадок.
Если проблему воспроизвести не удается, она могла быть временной, и мы рекомендуем вернуться к этому руководству по устранению неполадок в следующий раз, когда она повторится.
-
Проверьте, применены ли к объекту «Соглашение» или к другим объектам Acrobat Sign пользовательские настройки: триггеры, рабочие процессы или правила.
Отключите все пользовательские настройки при их наличии и отправьте тестовое соглашение для проверки правильности работы, используя обычную процедуру. Статус должен измениться с «Черновик» на «Отправлено на подпись».
Если после отключения настроек соглашение перейдет в статус «Отправлено на подпись», изучите инструкции в руководстве для разработчиков.
Если же статус по-прежнему не обновляется, отправьте тестовое соглашение напрямую с вкладки «Соглашения» при отключенных пользовательских настройках и выясните, доставляется ли оно. Если статус все еще не изменился, выполните шаги 1 и 2, описанные выше.
Примечание.Мы не предоставляем поддержку для устранения неполадок с пользовательскими настройками.
Объекты Acrobat Sign Добавление вложенных файлов Сопоставления файлов Сопоставление данных в полях соглашения Добавление шаблонов полей форм Импорт полей формы Сопоставления объединений Добавление получателей Сопоставление дочерних полей формы Мьютексы Соглашения Запись сопоставления дочерних полей формы Сопоставления объектов События соглашения Сопоставление полей форм Получатели Шаблоны соглашений Записи сопоставления полей формы Подписанное соглашение Сопоставления данных Сопоставления групп Триггеры Сопоставления полей Шаблоны библиотеки Результаты синхронизации пользователей Тип соглашения
Теперь все организации имеют расширенные домены Salesforce, включенные по умолчанию, что не влияет на пакет Acrobat Sign для Salesforce. Однако клиенты, настроившие свои сайты для загрузки больших файлов и передачи соглашений, могут столкнуться с проблемами: если их расширенные домены включены, это может привести к изменению URL-адресов сайтов и нарушению соглашений.
Чтобы обеспечить бесперебойную работу соглашений, клиентам необходимо обновить пользовательские настройки для загрузки больших файлов так, чтобы они соответствовали обновленному URL-адресу сайта.
Для обновления URL-адреса обратного вызова передачи соглашений клиенты должны обратиться в службу поддержки и предоставить необходимую информацию. Для получения дополнительной информации см. Получение отдельных служб, настроенных для вашей учетной записи Acrobat Sign.
Acrobat Sign для Salesforce позволяет искать и добавлять потенциальных клиентов в качестве получателей документа, если в качестве получателя выбран тип «Потенциальные клиенты». Однако, если пользователи Government Cloud создают потенциальных клиентов, контакты или пользователей, но не могут найти их с помощью поля «Поиск», администраторы организации Salesforce могут выполнить следующие действия по устранению проблемы:
- Выберите Настройка > Диспетчер объектов и затем выполните поиск потенциального клиента.
- На панели слева выберите Поля и связи.
- Для всех обязательных полей (например, «Имя», «Адрес электронной почты», «Мобильное устройство» и т. д.) проверьте доступность для пользователей. Выполните следующие действия:
- Выберите поле для проверки. Например, выберите Мобильное устройство.
- Для всех пользователей, для которых требуется включить доступ к полю, установите флажок Видимое.
- Нажмите Сохранить.
Если после выполнения описанных выше шагов для устранения неполадок проблема осталась нерешенной, обратитесь в службу поддержки и сообщите следующую информацию:
- Описание проблемы
- Адрес электронной почты администратора учетной записи Acrobat Sign, который использовался для настройки интеграции
- Адрес электронной почты администратора учетной записи Acrobat Sign, который использовался для включения автоматических обновлений статуса:
- Версия пакета Acrobat Sign, установленного в Salesforce
- Идентификатор организации Salesforce
- Идентификаторы записей Salesforce для проблемных соглашений
- Адрес электронной почты пользователя
- Является ли проблема постоянно воспроизводимой, появляется время от времени или возникла однократно?
- Даты последнего появления: <укажите дату, время и часовой пояс последнего известного появления проблемы>
- Подробные шаги для воспроизведения проблемы
- Ожидаемое поведение: <опишите поведение, которое вы ожидаете увидеть при выполнении этой процедуры>
- Комментарии по устранению неполадок: <подробно опишите все действия по устранению неполадок, которые вы уже выполнили, используя эту документацию>