Adobe Sign для Salesforce: Simple Sign

Simple Sign — удобный компонент, входящий в комплект поставки, который позволяет пользователям порталов сообществ самостоятельно подписывать соглашения. Добавьте этот компонент в любой портал Salesforce Experience Cloud (для клиентов, партнеров, сотрудников и т. д.) или интегрируйте его в другие компоненты Lightning.

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

Чтобы воспользоваться функциями компонента Simple Sign, необходимо установить пакет Adobe Sign для Salesforce версии 21.0.

Во время новой установки необходимо выбрать параметр Создание образцов шаблонов документов при подключении Salesforce к Adobe Sign.

Шаг 1. Привязка учетной записи

Если шаблоны не были созданы во время установки либо вы выполняете обновление предыдущей версии пакета до версии 19, вы можете создать шаблоны на вкладке Администратор Adobe Sign.

Убедитесь, что на вкладке Шаблоны документов указан шаблон Тестовый документ сообщества.

Шаблоны документов — тестовый документ сообщества

Включение параметра Lightning (если он не был включен)

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

В редких случаях, когда параметр Lightning не включен, выполните одно из следующих действий.

  • Нажмите ссылку Переключиться на Lightning на верхней панели параметров.
  • Нажмите свое имя и выберите в подменю пункт Переключиться на Lightning Experience.
Переключение на Lightning


Включение Chatter

Chatter необходимо включить в организации SFDC.

Если Chatter не включен, выполните следующие действия.

  • Выберите Настройка > Инструменты платформы > Настройки функций > Chatter > Настройки Chatter.
  • Нажмите кнопку Редактировать.
  • Установите флажок Включить.
  • Нажмите Сохранить.


Включение цифровых сред

Необходимо включить цифровые среды (если они не включены).

  • Выберите Настройка > Инструменты платформы > Настройки функций > Цифровые среды > Настройки.
  • Установите флажок Включить цифровые среды.
  • Укажите имя домена для сред.
    • Если ваша учетная запись использует конкретный домен, вы можете использовать его для сред.
  • Нажмите Сохранить.
    • Нажмите ОК при появлении предупреждения о том, что домен нельзя изменить после настройки.
Включение цифровых сред


Активация двух доверенных узлов CSP

Два доверенных узла политики защиты содержимого необходимо настроить, чтобы добавить в список разрешений базовые URL-адреса учетной записи Adobe Sign.

1. Найдите сегмент URL-адресов Adobe Sign.

  • Войдите в Adobe Sign и выясните URL-адрес.
  • Скопируйте параметр перед частью echosign.com (также может быть adobesign.com) (значение сегмента).
    • .na1 в данном примере: https://caseyjones.na1.echosign.com
  • Закройте вкладку.

 

2. Выберите Настройка > Настройки > Безопасность > Доверенные узлы CSP.

3. Нажмите Новый доверенный узел.

 

4. Установите значения полей следующим образом.

  • Имя доверенного узла: AdobeSign
  • URL-адрес доверенного узла: https://secure.<сегмент>.adobesign.com
    • (например, https://secure.na1.adobesign.com)
    • Если ваша учетная запись не перенесена на домен adobesign.com, вместо этого можно использовать echosign.com
  • Активный: оставьте включенным
  • Контекст: веб-сайты Experience Builder

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

Определение доверенных сайтов CSP

 

6. Вернитесь в раздел Настройка > Настройки > Безопасность > Доверенные узлы CSP.

7. Нажмите Новый доверенный узел.

8. Установите значения полей следующим образом.

  • Имя доверенного узла: AdobeSign2
  • URL-адрес доверенного сайта: https://secure.adobesign.com
  • Активный: оставьте включенным
  • Контекст: веб-сайты Experience Builder

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

Второй доверенный сайт CSP

 

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

Доверенные узлы CSP


Создание пользователя портала сообщества

Клонирование профиля пользователя сообщества

Чтобы настроить профили пользователей для использования портала самообслуживания Adobe Sign, вам потребуется отредактировать профиль. Для этого необходимо клонировать один из стандартных профилей.

  • Выберите Настройка > Администрирование > Пользователи > Профили.
  • Нажмите ссылку Клонировать рядом с одним из стандартных профилей сообщества пользователей.
    • Доступно четыре профиля сообщества пользователей; можно использовать любой профиль.
    • Обратите внимание на тип лицензии пользователя клонируемого профиля.
  • Введите интуитивно понятное имя клонированного профиля и нажмите Сохранить.


Создание учетной записи, контакта и пользователя для сообщества

Необходимо создать учетную запись, контакт и пользователя.

Примечание.

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

Настройка > Администрирование > Пользователи > Пользователи > {нажмите ссылку «Редактировать» слева от полного имени}.

Чтобы создать учетную запись, выполните следующие действия.

  • Запустите приложение Sales в Средстве запуска приложений.
  • Нажмите стрелку вниз на вкладке Учетная запись, затем выберите пункт меню «+ Новая учетная запись».

В появившемся окне Новая учетная запись введите Имя учетной записи, которое указывает на то, что данная учетная запись является учетной записью портала Adobe Sign.

  • Это единственное значение, которое требуется указать.
  • По завершении нажмите Сохранить.

Затем необходимо создать контакт и пользователя в учетной записи.

  • Нажмите значок Создать в правом верхнем углу окна.
  • Выберите в меню Новый контакт.

В появившемся окне Новый контакт выполните следующие действия.

  • Введите значимое имя.
  • Введите адрес электронной почты для контакта. Рекомендуется указывать адрес электронной почты администратора, который управляет содержимым портала сообщества.
  • Привяжите контакт к учетной записи портала сообщества Adobe Sign, созданной в предыдущем шаге.
  • Нажмите Сохранить.
Настройте контакт сообщества.

  • Откройте страницу нового контакта, который был создан.
  • Нажмите Настройка (значок шестеренки) в правом верхнем углу окна.
  • Выберите Редактировать объект в меню.
Отредактируйте объект контакта.

 

  • Выберите Макет страницы на панели слева.
  • Отредактируйте макет контакта.

 

  • Выберите Действия на мобильном устройстве и в Lightning в параметрах объекта.
  • Перетащите кнопку Включить пользователя клиента в раздел Действия на мобильном устройстве и в интерфейсе Lightning в Salesforce.
  • Перетащите кнопку Вход в среду от имени пользователя в раздел Действия на мобильном устройстве и в интерфейсе Lightning в Salesforce.
  • Сохраните макет страницы.

  • Вернитесь в контакт сообщества и нажмите кнопку Включить пользователя клиента.
Включите пользователя клиента.

Откроется страница Новый пользователь с импортированными данными контакта.

Настройте пользователя.

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

 

Страница обновится, и отобразится новый пользователь.

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

 

Добавьте набор разрешений Пользователь сообщества Adobe Sign для пользователя и нажмите Сохранить.


Настройка страницы сообщества SFDC


Создание нового сообщества

  • Выберите Настройка > Инструменты платформы > Настройки функций > Цифровые среды > Все сайты.
  • Нажмите кнопку Создать.
Цифровые среды — Все сайты

 

  • Выберите интерфейс Обслуживание клиентов.
    • Интерфейс Обслуживание клиентов требуется для компонентов самообслуживания.

 

  • После загрузки страницы Обслуживание клиентов нажмите Начало работы.

 

  • Укажите имя сообщества.
    • Можно также указать имя URL-адреса определенного сайта (рекомендуется при наличии нескольких сообществ).
  • Нажмите Создать после настройки имени.

Во время создания сообщества отображается эффектная графическая демонстрация. После завершения отображается страница сообщества.

► Имя сообщества отображается в верхней части окна (выделено желтым цветом)

►Строковое значение сайта отображается в строке URL-адреса (выделено сине-зеленым цветом)


Настройка рабочего пространства среды для включения пользователей

  • Выберите Настройка > Инструменты платформы > Настройки функций > Цифровые среды > Все сайты.
  • Нажмите ссылку Рабочие пространства для сообщества.
Нажмите «Рабочие пространства».

Загрузится страница Мои рабочие пространства.

  • Нажмите параметр Администрирование.

Откроется страница «Администрирование» для сообщества.

Выберите Настройки на левой панели и выполните следующие действия.

  • Нажмите кнопку Активировать справа от индикатора состояния.

 

Выберите Участники на панели слева.

  • В раскрывающемся меню «Поиск» выберите Все.
  • Выберите созданный пользовательский профиль в списке Доступные профили.
  • Нажмите кнопку Добавить. Соответствующий профиль будет перемещен в список Выбранные профили.
  • Нажмите кнопку Сохранить.


Установка для параметра «Адрес электронной почты» в разделе «Видимость профиля» пользователя сообщества значения «Общедоступно»

В поле адреса электронной почты в разделе Видимость профиля сообщества должно быть установлено значение Общедоступно:

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

Откроется интерфейс портала.

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

Откроется страница Мои настройки для пользователя.

  • В разделе Видимость профиля установите для параметра Адрес электронной почты значение Общедоступно.
  • Нажмите Сохранить.

Добавление компонента Adobe Simple Sign в рабочее пространство

  • Выберите Настройка > Инструменты платформы > Настройки функций > Цифровые среды > Все сайты.
  • Нажмите ссылку Рабочие пространства для сообщества.
  • Нажмите параметр Builder в разделе Мои рабочие пространства на странице.
  • Нажмите значок Компоненты в левом верхнем углу страницы, прокрутите меню вниз, затем, удерживая левую кнопку мыши, перетащите Adobe Simple Sign в макет страницы.
    • Поместите компонент в местоположение, в котором требуется отобразить документы Adobe Sign.
Перетащите Simple Sign в шаблон портала.

 

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

Панель управления в правом верхнем углу окна содержит только один доступный для настройки параметр.

Шаблон документа — шаблон, определяющий документы, перечисленные в компоненте.

 

Выберите шаблон, затем нажмите кнопку Опубликовать, чтобы портал стал доступным.

  • При каждом изменении портала или настроек необходимо повторно опубликовывать портал.

Встраивание кода Simple Sign в компоненты Lightning

Компонент Simple Sign можно встроить в другой компонент Lightning.

Пример кода компонента:

<echosign_dev1:SimpleSign templateId="a0L190000019xUrEAI" />

 

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

  • agreementId — идентификатор Salesforce документа в состоянии «во время работы» или «черновик». 
    • Для документов в состоянии «черновик» необходимо настроить параметр «отправка от имени».
  • templateId — идентификатор Salesforce шаблона, определяющего созданные документы.
  • pollingInterval — значение в миллисекундах.
    • Это значение указывает время перед каждой попыткой извлечения URL-адреса для подписания.
      • Минимальное значение: 500
      • Максимальное значение: 50000
      • Значение по умолчанию: 1000
  • showSigningModal
    • Если установлено значение «false», то будет возвращен signingURL без загрузки страницы eSign в режиме наложения.
    • Если установлено значение «true», то будет возвращен signingURL и загружена страница eSign в режиме наложения.
    • Значение по умолчанию: «true».

 

Параметры соответствуют следующим правилам.

  • Необходимо указать agreementID или templateID.
    • Если указаны оба значения, то будет использовано значение agreementID.
    • Если ни одно значение не указано, выдается ошибка.
  • При использовании значения agreementID документ должен быть в состоянии Черновик или Отправлено на подпись; при этом документ должен ожидать подписания как минимум от одного получателя.
    • Если документ находится в состоянии «Черновик», он будет отправлен в существующем виде, URL-адрес подписания будет извлечен и отображен.
    • Если документ находится в состоянии «Во время работы», URL-адрес подписания будет извлечен и отображен.
    • Если работа с документом завершена, он будет отображен и будет показано уведомление об ошибке.
  • При использовании значения templateID Автоматическая отправка будет все равно включена.
    • При использовании значения agreementID параметр Автоматическая отправка для шаблона будет сохранен.
  • Шаблоны документов Simple Sign должны иметь Контакт в качестве типа главного объекта.
  • Настоятельно рекомендуется использовать параметр Отправить от имени, поскольку большинство пользователей сообщества не имеют лицензии на отправку сообщений.

 

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

<aura:handler name="notifyError" event="echosign_dev1:ErrorEvent" action="{!c.onError}"/>

Доступные события:

Соглашение отправлено

name="notifyAgreementSent" event="echosign_dev1:AgreementSentEvent" action="{!c.onAgreementSent}"

Соглашение загружено из шаблона

name="notifyAgreementLoaded" event="echosign_dev1:AgreementLoadedEvent" action="{!c.onAgreementLoaded}"

Страница для подписания открыта

name="notifySigningLoaded" event="echosign_dev1:SigningLoadedEvent" action="{!c.onSigningLoaded}"

Подписанные

name="notifyRecipientCompleted" event="echosign_dev1:RecipientCompletedEvent" action="{!c.onRecipientCompleted}"

Не подписано

name="notifyRecipientNotCompleted" event="echosign_dev1:RecipientNotCompletedEvent" action="{!c.onRecipientNotCompleted}"

Ошибка при выполнении любого действия

name="notifyError" event="echosign_dev1:ErrorEvent" action="{!c.onError}"


Требования к шаблонам документов для Simple Sign

Шаблоны в среде Simple Sign должны назначать получателя путем поиска главного объекта (этим объектом должен быть «Контакт»).

На вкладке Данные шаблона выполните следующие действия.

  • Нажмите раскрывающееся меню в разделе Объект Salesforce.
  • Выберите Выбрать из других объектов.
    • Откроется новое поле с раскрывающимся списком.
  • Выберите Контакт во втором поле с раскрывающимся списком.

  • Нажмите вкладку Получатель.
  • Удалите одного существующего получателя в шаблоне.
  • Нажмите ссылку Добавить получателя из объекта или переменную времени выполнения.
    • Откроется окно Добавить получателя.
  • В поле Выберите объект или переменную времени выполнения выберите Поиск на основе поля главного объекта.
    • В качестве первого получателя необходимо выбрать главный объект (контакт), а в поле Исходное поле из главного объектадолжен быть указан идентификатор контакта.
  • Нажмите Сохранить.

Файл определенного типа необходимо прикрепить к шаблону для использования компонента Simple Sign.  Нельзя использовать параметр «отправитель прикрепляет документ», как в активном процессе отправки.

  • Перейдите на вкладку «Вложения».
  • Загрузите документ из локальной системы.
    • Можно также выбрать среду, где находится нужный документ (в разделе Выбор документов для добавления).
      • Нажмите поле поиска, чтобы просмотреть все доступные документы в этом разделе.
      • Поочередно выберите документы, чтобы прикрепить их к шаблону.

Нажмите Сохранить, когда все нужные документы прикреплены.

Примечание.

Все загруженные файлы хранятся в Salesforce (раздел Файлы и CRM Salesforce).

Если у вас есть пользователи портала, не имеющие лицензии Adobe Sign, вам необходимо использовать функцию «Отправить от имени», встроенную в пакет, чтобы обойти ограничения лицензирования.  Эта функция позволяет пользователю сообщества создавать документы, используя лицензию другого пользователя.

Эта функция требует настройки трех следующих параметров.

  • Включите параметр Разрешить отправку от имени других сторон в пользовательских настройках.
  • Включите для лицензированного пользователя параметр Разрешить отправку от его имени.
  • Настройте шаблон документа с идентификатором Salesforce данного пользователя. 


Включение параметра

  1. Выберите Настройка > Инструменты платформы > Пользовательский код > Пользовательские настройки.
    • Откроется страница Пользовательские настройки.
  2. Нажмите название Настройки Adobe Sign.
    • Откроется страница Настройки Adobe Sign.

    3. Нажмите кнопку Управление.

    4. Нажмите Создать (или Редактировать, если настройки были изменены ранее).

  • Откроется страница Настройки Adobe Sign.

5. Выполните поиск параметра Разрешить отправку от имени других сторон.

  • Установите флажок, чтобы включить параметр.
  • Нажмите Сохранить.

Настройка пользователя для отправки документов от его имени

Чтобы пользователь поддерживал функцию Отправить от имени, необходимо добавить два следующих поля в макет записи пользователя.

  • Выберите Настройки > Инструменты платформы > Объекты и поля > Диспетчер объектов.
  • Выберите Пользователь в диспетчере объектов.
  • Выберите Макеты страниц пользователя на панели слева страницы объекта Пользователь.
  • Нажмите ссылку Макет пользователя.
  • Выберите Поляудерживайте левую кнопку мыши и перетащите два указанных ниже поля в раздел макета Дополнительная информация (заголовок отображается только при редактировании).
    • Adobe Sign — отправка от других польз.
    • Адрес эл. почты Adobe Sign проверен 
  • Нажмите Сохранить.

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

  • Выберите Настройка > Администрирование > Пользователи > Пользователи.
  • Нажмите действие Редактировать для пользователя «контакт сообщества».
  • На странице Редактирование пользователя в разделе Дополнительная информация.
    • Включите параметр Adobe Sign разрешает отправку в качестве других пользователей.
    • Установите флажок Адрес эл. почты Adobe Sign проверен.

На открытой странице Редактирование пользователя скопируйте идентификатор пользователя из URL-адреса в строке браузера.

Идентификатор пользователя указан в URL-адресе страницы (выделено желтым цветом внизу):

Указанный выше URL-адрес имеет вид (идентификатор выделен жирным шрифтом):

https://adobedocwinter18test-dev-ed.lightning.force.com/one/one.app?source=aloha#/setup/page?nodeId=ManageUsers&address=%2F0051I000000TA5N%3F

Не следует включать «%2F» в начале и «%3» в конце.

  • Скопируйте и сохраните идентификатор пользователя для следующего шага.

 

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


Обновление шаблона с помощью идентификатора пользователя

  • Выберите Средство запуска приложений > Adobe Sign > Шаблоны документов.
  • Нажмите Имя шаблона документа, который требуется изменить.
Перейдите к разделу «Шаблон документа».

Выберите вкладку Получатели и измените поле Отправить от имени.

  • Вставьте идентификатор пользователя Salesforce в это поле (замещающий идентификатор можно удалить).
  • Нажмите Сохранить.
Отредактируйте поле «Отправить от имени других».


Ограничения компонента

Существуют несколько ограничений компонента Simple Sign, которые необходимо знать.

 

1. Шаблон невозможно настроить при включенном параметре Только подпись отправителя.

○ В этом случае пользователь сообщества увидит ошибку, что URL-адрес подписания отсутствует для текущего пользователя.

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

○ В этом случае документ будет находиться в состоянии «Предварительная отправка», URL-адрес подписания не будет загружен.

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

4. Simple Sign не поддерживает передачу.

○ В этом случае другой получатель не сможет получить доступ к URL-адресу подписания.

5. Simple Sign не поддерживает параметр Замена подписывающей стороны (один из видов передачи).

○ В этом случае новая подписывающая сторона не сможет получить доступ к URL-адресу подписания.

6. Чтобы предоставить доступ к заметкам и вложениям любого объекта Salesforce, администраторы должны включить параметр Разрешить клиентам получать доступ к заметкам и вложениям в Настройках сообществ.

Логотип Adobe

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