Руководство по сервисам для отправки больших документов и передачи соглашений в Adobe Acrobat Sign для Salesforce

Обзор

В руководстве по сервисам для отправки больших документов и передачи соглашений в Adobe Acrobat Sign для Salesforce объясняется, как настроить Acrobat Sign для Salesforce для отправки больших документов (размером более 4 МБ со страницы отправки документа и 9 МБ при массовой отправке) или передачи соглашений, созданных вне среды Salesforce.

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

  • Используется известный набор разрешений с минимальной авторизацией.
  • Работа функций не нарушается при отключении пользователя.

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

Предварительные условия

  • Должна быть установлена версия 20.13.5 или более поздняя пакета Adobe Sign для Salesforce.
  • Должен быть настроен Мой домен, чтобы разрешить аутентификацию OAuth пользователя обратного вызова..
Примечание.

Отправка больших документов и передача соглашений не поддерживаются в Salesforce Professional Edition. 

Определение пользователя обратного вызова

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

  1. Выберите Настройка > Администрирование > Пользователи > Профили.

  2. В списке профилей пользователей выберите Клонировать для элемента Стандартный пользователь.

  3. На открывшейся странице «Клонировать профиль» введите имя профиля и выберите Сохранить.

    clone-profile

  4. На странице «Профили» выберите Изменить для профиля, созданного выше (пользователь обратного вызова ABC Sign). Затем на странице «Изменение профиля» выполните следующие действия:

    1. В разделе Пользовательские настройки вкладок убедитесь, что для обоих параметров в разделе Администратор Adobe Acrobat Sign установлено значение Включен по умолчанию.
    2. Убедитесь, что эти страницы Visualforce включены:
      • echosign_dev1.EchosignAdmin
      • echosign_dev1.SalesforceOAuthPage
    3. Нажмите Сохранить.
  5. Создайте нового пользователя с использованием стандартной лицензии Salesforce, выполнив следующие действия:

    1. На панели слева выберите Пользователи.
    2. На странице «Пользователи» выберите Создать пользователя.
    3.  На странице «Изменение нового пользователя» дайте пользователю интуитивно понятное имя, назначьте ему лицензию Salesforce и профиль, созданный выше. Нажмите Сохранить.

  6. Добавьте набор разрешений Adobe Acrobat Sign Integrator для пользователя обратного вызова.

    1. Выберите Настройка > Администрирование > Пользователи > Пользователи.
    2. Нажмите ссылку Полное имя пользователя обратного вызова.
    3. Наведите курсор на ссылку Назначения набора разрешений и выберите Изменить разрешения.
    permission-sets-edit

  7. На странице Назначение набора разрешений:

    1. Выберите набор разрешений Пользователь интеграции Adobe Acrobat Sign.
    2. Выберите Добавить, чтобы переместить набор разрешений в столбец Включено.
    3. Нажмите Сохранить.
    add-callback-user

  8. Выполните указанные ниже действия, чтобы активировать пользователя обратного вызова в Adobe Acrobat Sign путем отправки соглашения:

    1.  Войдите в Salesforce как пользователь обратного вызова.
    2. Выберите Средство запуска приложений > Adobe Acrobat Sign для Salesforce > Соглашения.
    3. Выберите Создать, чтобы открыть страницу нового соглашения.
    4. Настройте соглашение, добавив получателя и прикрепив файл.
    5. Выберите Отправить.
    agreements-tab-recipients

  9. На странице обработки после отправки выберите OK, чтобы вернуться к соглашению, а затем выберите Отмена, чтобы отменить соглашение.

  10. Привяжите пользователя обратного вызова к Acrobat Sign следующим образом:

    1. Выберите Средство запуска приложений > Adobe Acrobat Sign для Salesforce > Администратор Adobe Acrobat Sign.
    2. В разделе Пользователь обратного вызова выберите Привязать учетную запись.
    3. На странице Предоставить доступ? выберите Предоставить.
    4. На странице администратора Adobe Acrobat Sign убедитесь, что пользователь обратного вызова привязан.
    5. Выйдите из Salesforce и снова войдите с учетными данными администратора Salesforce.
    callback-user-link-account

    link-callback-allow-access

    Аутентифицированный пользователь обратного вызова

Настройка сайта обратного вызова

Необходимо установить и настроить сайт для обратного вызова Adobe Acrobat Sign, чтобы обновления соглашений отправлялись в Salesforce своевременно.

Примечание.

Если в организации Salesforce не используются сайты Salesforce, сначала необходимо зарегистрировать доменное имя Force.com, которое будет использоваться для всех сайтов Salesforce в учетной записи (см. раздел Регистрация собственного домена Force.com в справке Salesforce.com). Обратите внимание, что при регистрации нового имени домена рекомендуется не использовать слишком длинное имя, поскольку длина защищенного URL-адреса не должна превышать ограничения в 255 символов, заданного для URL обратного вызова в Adobe Acrobat Sign.

  1. Выберите Настройка > Инструменты платформы > Пользовательский интерфейс > Сайты и домены > Сайты.

  2. Зарегистрируйте доменное имя сайта следующим образом:

    1. Введите имя требуемого домена в текстовом поле после префикса http://.
    2. Выберите Проверить доступность, чтобы убедиться, что домен доступен. Если домен доступен, появится сообщение Успешно.
    3. Примите Условия использования и выберите Регистрация моего домена Force.com.

  3. На обновившейся странице выберите Создать.

  4. На странице Изменить сайт выполните следующие действия:

    • Задайте для параметра Метка сайта значение Обратный вызов Adobe Acrobat Sign.
    • Задайте для параметра Имя сайта значение Adobe_Sign_Callback.
    • Задайте для параметра Контакт сайта значение пользователя Salesforce, который будет получать уведомления о сайтах. В большинстве случаев это администратор учетной записи.
    • Задайте для параметра Веб-адрес по умолчанию значение AdobeSignCallback.
    • Установите флажок Активный.
    • Задайте для параметра Активная главная страница сайта значение EchoSignCallback.
      EchoSign — устаревшее название продукта Adobe Acrobat Sign.
    Обратный вызов Adobe Sign

  5. Нажмите Сохранить

  6. Добавьте диапазоны IP-адресов в настройки общего доступа на сайте, чтобы ограничить их IP-адресами Adobe Acrobat Sign. Выполните следующие действия:

    1. На странице Сведения о сайте для своего сайта обратного вызова нажмите кнопку Настройки общего доступа.
    2. Выберите Диапазоны IP-адресов для входа.
    3. Нажмите Создать.
    4. В диалоговом окне «Диапазоны IP-адресов для входа» введите первый диапазон IP-адресов:
      • Начальный IP-адрес: 52.71.63.224
      • Конечный IP-адрес: 52.71.63.255
      • Описание: Acrobat Sign
    5. Нажмите Сохранить.
    6. Повторите шаги 2—5 для диапазонов IP-адресов, перечисленных в таблице ниже.

    Примечание.

    При появлении сообщения об ошибке: Список диапазонов IP-адресов не соответствует текущему IP-адресу…. , включите параметр Сохранить этот диапазон IP-адресов несмотря на то, что он не соответствует текущему IP-адресу, затем снова нажмите «Сохранить».

    Начальный IP-адрес Конечный IP-адрес Описание
    13.126.23.0 13.126.23.31 Adobe Acrobat Sign
    3.236.206.64 3.236.206.95 Adobe Acrobat Sign
    40.67.154.249 40.67.154.249 Adobe Acrobat Sign
    40.67.155.112 40.67.155.112 Adobe Acrobat Sign
    40.67.155.147 40.67.155.147 Adobe Acrobat Sign
    40.67.155.185 40.67.155.185 Adobe Acrobat Sign
    44.234.124.128 44.234.124.159 Adobe Acrobat Sign
    51.105.221.160 51.105.221.191 Adobe Acrobat Sign
    52.196.191.224 52.196.191.255 Adobe Acrobat Sign
    52.35.253.64 52.35.253.95 Adobe Acrobat Sign
    52.48.127.160 52.48.127.191 Adobe Acrobat Sign
    52.58.63.192 52.58.63.223 Adobe Acrobat Sign
    52.65.255.192 52.65.255.223 Adobe Acrobat Sign
    52.71.63.224 52.71.63.255 Adobe Acrobat Sign

    Конечные диапазоны IP-адресов для входа для веб-сайта обратного вызова Adobe Acrobat Sign должны иметь следующий вид.

    Диапазоны IP-адресов

Настройка отдельных сервисов

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

  • Транзакции отправки — можно отправить один документ размером до 4 МБ или несколько документов, суммарный размер которых не превышает 4 МБ, выбрав Отправить на подпись на странице «Соглашения».
  • Фоновые действия — можно использовать фоновые действия, чтобы отправить один документ размером до 9 МБ или несколько документов, суммарный размер которых не превышает 9 МБ. 
    Дополнительная информация о фоновых действиях приведена в Руководстве по расширенной настройке.

Для включения больших документов:

  1. Отредактируйте профиль пользователя обратного вызова, чтобы предоставить дополнительный доступ.
  2. Включите Число вызовов службы вложений для профиля пользователя обратного вызова.
  3. Отредактируйте сайт, чтобы включить класс Apex LargeFileDownloadService.
  4. Обновление пользовательских настроек для использования URL обратного вызова.

Редактирование профиля пользователя обратного вызова

Чтобы включить права доступа на уровне объектов для пользователя сайта обратного вызова Adobe Acrobat Sign, выполните следующие действия:

  1. на странице Профиль обратного вызова Adobe Acrobat Sign выберите Изменить.
  2. Прокрутите до параметра Пользовательские разрешения для объектов и включите все разрешения для объекта Соглашения: чтение, создание, редактирование, удаление, просмотр всех, изменение всех.
  3. Включите класс Apex echosign_dev1. AgreementAttachmentDownloadService..
  4. Нажмите Сохранить.

Включите Число вызовов службы вложений для профиля пользователя обратного вызова.

  1. Выберите Диспетчер объектов > Соглашение > Поля и связи. 
  2. Выберите метку поля Число вызовов службы вложений.
  3. Выберите Установить безопасность на уровне полей.
  4. Включите параметры Виден и Только для чтения для профиля пользователя обратного вызова.
  5. Нажмите Сохранить.


Редактирование сайта для включения класса Apex LargeFileDownloadService

Также следует настроить профиль для вашего сайта обратного вызова Adobe Acrobat Sign и добавить класс Apex LargeFileDownloadService, чтобы он стал виден.

  1. Выберите Настройка > Инструменты платформы > Пользовательский интерфейс > Сайты и домены > Сайты.

  2. Выберите сайт Обратный вызов Adobe Acrobat Sign.

  3. Выберите Настройки общего доступа.

  4. Выберите Включить доступ для классов Apex, а затем выберите Изменить

  5. В списке Доступные классы Apex в левой части окна выберите echosign_dev1.LargeFileDownloadService, затем нажмите Добавить, чтобы перенести его в список Включенные классы Apex. Затем выберите Сохранить.

Обновите пользовательские настройки для использования URL обратного вызова.

  1. Выберите Настройка > Пользовательский интерфейс > Сайты и домены > Сайты.

  2. Выберите Обратный вызов Acrobat Sign.

  3. В разделе Пользовательские URL выберите Просмотреть.

  4. С этой новой вкладки скопируйте значение URL в браузере и вставьте его в текстовый файл.
    В случае тестирования в изолированных средах скопируйте URL http, а не URL https. Ниже приведен пример того, как должен выглядеть URL.

  5. Выберите Настройка > Инструменты платформы > Пользовательский код > Пользовательские настройки.

  6. На странице Пользовательские настройки выберите Настройки Adobe Sign.

  7. На странице «Настройки Adobe Sign» выберите Управление.

  8. Выберите Создать или Изменить.

  9. На странице Изменение настроек Adobe Acrobat Sign установите для параметра URL обратного вызова Adobe на Salesforce значение «безопасного веб-адреса», скопированного после настройки веб-сайта обратного вызова Adobe Sign. Убедитесь, что адрес имеет префикс «https», а не «http».

  10. Выберите Сохранить для сохранения настроек.

    Теперь сервис для отправки больших документов включен.

Вы можете использовать Acrobat Sign API, чтобы отправлять соглашения на подпись или создавать веб-формы, встраиваемые на ваши веб-сайты. Все соглашения будут передаваться и создаваться в Salesforce точно так же, как если бы они были отправлены из Salesforce. Также можно отправлять соглашения, используя веб-приложение echosign.adobe.com и загружая их все обратно в Salesforce.

Чтобы включить передачу соглашений, необходимо выполнить следующее:

  • Отредактируйте пользователя обратного вызова, предоставив набор разрешений пользователя интеграции Adobe Sign.
  • Отредактируйте сайт обратного вызова, добавив страницу Visualforce EchoSignAgreementPushCallback.
  • Изменение разрешения на уровне объектов и полей сайта.
  • Добавьте конкретные конфигурации использования в зависимости от того, как предполагается использовать Adobe Sign.

Редактирование пользователя обратного вызова для предоставления набора разрешений пользователя интеграции Adobe Acrobat Sign

  1. Выберите Настройка > Администрирование > Пользователи > Пользователи.

  2. Выберите имя пользователя обратного вызова, чтобы открыть страницу сведений о пользователе.

  3. Наведите курсор на ссылку Назначения набора разрешений и выберите Изменить разрешения.

  4. В разделе Доступные наборы разрешений выполните следующие действия:

    1. Выберите разрешение Пользователь интеграции Adobe Acrobat Sign.
    2. Выберите Добавить
    3. Нажмите Сохранить.

  5. Описание шага


Редактирование сайта обратного вызова, добавив страницу Visualforce EchoSignAgreementPushCallback

  1. Выберите Настройка > Инструменты платформы > Пользовательский интерфейс > Сайты и домены > Сайты.

  2. Выберите сайт Обратный вызов Adobe Acrobat Sign.

  3. Прокрутите до раздела Страницы Visualforce сайта, затем нажмите кнопку Изменить.

  4. Найдите и выберите echosign_dev1.EchoSignAgreementPushCallback, а затем выберите Добавить, чтобы переместить страницу в список Активированные страницы Visualforce. Затем выберите Сохранить.


Изменение разрешения на уровне объектов и полей сайта

После добавления страницы Visualforce будет выполнен возврат на страницу Сведения о сайте для сайта обратного вызова. Чтобы изменить страницу, выполните указанные ниже действия:

  1. Выберите Настройки общего доступа, чтобы открыть страницу Профили.
  2. На странице Профили выберите Изменить.
  3. Прокрутите страницу вниз до раздела Стандартные разрешения для объектов.
  4. Включите разрешения Чтение и Создание для следующих объектов: «Учетная запись», «Контакт», «Контракт», «Интерес» и «Возможность».
  5. Нажмите Сохранить. Вы вернетесь в профиль обратного вызова.
  6. Если необходимо настроить безопасность на уровне полей, прокрутите вниз до раздела Безопасность на уровне полей и измените настройки Стандартная безопасность на уровне полей следующим образом:
    • Контакт
      • Учетная запись: убедитесь, что разрешения «Чтение» и «Редактирование» включены
      • Электронная почта: убедитесь, что разрешения «Чтение» и «Редактирование» включены
      • Имя: убедитесь, что разрешения «Чтение» и «Редактирование» включены
    • Потенциальный клиент
      • Организация: убедитесь, что разрешения «Чтение» и «Редактирование» включены
      • Электронная почта: убедитесь, что разрешения «Чтение» и «Редактирование» включены
      • Имя: убедитесь, что разрешения «Чтение» и «Редактирование» включены


Использование специальных конфигураций

Если требуется, чтобы все соглашения в учетной записи, отправленные извне Acrobat Sign, были созданы и загружены в Salesforce, следуйте приведенным ниже инструкциям.

  1. Скопируйте безопасный URL-адрес из созданного сайта обратного вызова Acrobat Sign и присоедините к нему текст echosign_dev1__EchoSignAgreementPushCallback, чтобы составить URL обратного вызова.
  2. Обратитесь в службу технической поддержки Adobe и предоставьте свой URL обратного вызова, чтобы установить его в качестве URL обратного вызова по умолчанию для вашей учетной записи Adobe Acrobat Sign.
    Например, при адресе сайта: https://echov11-dev.na12.force.com/AdobeSignCallback вы составите URL обратного вызова: https://echov11-dev.na12.force.com/AdobeSignCallback/echosign_dev1__EchoSignAgreementPushCallback
  3. Служба технической поддержки Adobe должна также ввести ваш идентификатор пользователя Adobe Acrobat Sign для пользовательской настройки API URL обратного вызова. Во все учетные записи, использующие Salesforce, также следует добавить ключ документа для URL обратного вызова.

Если отправка соглашения осуществляется через API, выполните следующие действия.

  1. Скопируйте безопасный URL-адрес из созданного сайта обратного вызова Adobe Sign и присоедините к нему текст /echosign_dev1__EchoSignAgreementPushCallback, чтобы создать URL обратного вызова, который будет использоваться в Adobe Acrobat Sign API.
    Например, при адресе сайта: https://echov11-dev.na12.force.com/AdobeSignCallback в Adobe Sign API должен использоваться URL-адрес: https://echov11-dev.na12.force.com/AdobeSignCallback/echosign_dev1__EchoSignAgreementPushCallback
  2. При отправке документа или создании веб-формы с помощью API требуется указывать URL обратного вызова.
    См. раздел https://secure.echosign.com/redirect/latestApiMethods и параметр API «CallbackInfo».
  3. Следует настроить параметры учетной записи для добавления ключа документа в URL обратного вызова, который должен использоваться по умолчанию клиентами Salesforce, использующими Adobe Sign.
    При наличии вопросов обращайтесь в службу технической поддержки Adobe Acrobat Sign.
  4. Перейдите к параметрам сопоставления загрузки, чтобы указать, как должны создаваться записи при загрузке соглашений в Salesforce.
Логотип Adobe

Вход в учетную запись