Adobe Sign для Salesforce: Simple Sign

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

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

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

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

link-accounts

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

generate-self-sign-template

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

verify-test-community-agreement

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

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

Для включения Lightning:

  • В верхнем меню выберите Переключиться на Lightning, или
  • Выберите свое имя и в раскрывающемся меню выберите Переключиться на интерфейс Lightning.
Переключение на Lightning


Включение Chatter

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

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


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

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

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


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

Необходимо настроить два доверенных узла CSP (политики защиты содержимого), чтобы добавить базовые URL-адреса для вашей учетной записи Adobe Acrobat Sign. Выполните следующие действия:

  1. Для получения значения сегмента вашей учетной записи Acrobat Sign выполните следующие действия:

    1. Выполните вход в учетную запись Adobe Acrobat Sign.
    2. Из URL-адреса скопируйте параметр перед частью echosign.com (также может быть adobesign.com) (значение сегмента). 
      Например, для URL-адреса https://caseyjones.na1.echosign.com значение сегмента будет «na1».
    3. Закройте вкладку.

    Узнайте, как идентифицировать среду учетной записи Adobe Acrobat Sign.

    global-settings

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

    csp-trusted-sites

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

    1. Имя доверенного узла — введите имя, например, AcrobatSign
    2. URL-адрес доверенного узла — введите URL-адрес узла https://secure.<shard>.adobesign.com
      Например, https://secure.na1.adobesign.com
      Если ваша учетная запись не обновлена до домена adobesign.com, вы можете использовать вместо этого echosign.com.
    3. Установите флажок Активный.
    4. Контекст — выберите Узлы Experience Builder для контекста.
    5. Установите флажок Директива CSP — разрешить узел для frame-src.
    6. Нажмите Сохранить.
    csp-trusted-site-definition

  4. Снова выберите Настройка > Настройки > Безопасность > Доверенные узлы CSP, а затем выберите Новый доверенный узел.

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

    1. Имя доверенного узла — введите имя, например, AcrobatSign2
    2. URL-адрес доверенного узла — введите URL-адрес узла https://secure.adobesign.com
    3. Установите флажок Активный.
    4. Контекст — выберите Узлы Experience Builder для контекста.
    5. Установите флажок Директива CSP — разрешить узел для frame-src.
    6. Нажмите Сохранить.
    Второй доверенный сайт CSP

  6. Проверьте два доверенных узла CSP.

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


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

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

Чтобы настроить профили пользователей для использования портала самообслуживания Adobe Acrobat Sign, необходимо клонировать и изменить один из стандартных профилей. Выполните следующие действия:

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

  2. Для любого из стандартных пользовательских профилей выберите Клонировать.

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

    setup-profiles

  3. Введите интуитивно понятное имя клонированного профиля и выберите Сохранить.

    cloned-profile-name

  4. На открывшейся странице клонированного профиля выберите Изменить.

    cloned-profile-edit

  5. На странице редактирования пользовательского профиля прокрутите вниз до раздела Пользовательские разрешения для объектов и включите все объекты Adobe Acrobat Sign. Можно установить флажок Изменить все или выбрать только необходимые разрешения для дополнительной безопасности. 

    cloned-prodile-custom-object-permissions


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

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

Владелец учетной записи должен быть связан с ролью, чтобы включать пользователей портала. Чтобы связать роль с пользователем Salesforce, перейдите к Настройка > Администрирование > Пользователи > Пользователи. Затем в списке пользователей выберите Изменить для одного из пользователей, а на открывшейся странице разверните раскрывающееся меню Роль > выберите роль > выберите Сохранить.

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

  1. Запустите приложение Sales в Средстве запуска приложений.

  2. Откройте раскрывающееся меню Учетная запись и выберите +Создать учетную запись.

    sales-new-account

  3. На открывшейся странице Создать учетную запись введите значение имени учетной записи и выберите Сохранить.

    Имя учетной записи должно идентифицировать учетную запись как учетную запись портала Adobe Acrobat Sign. Имя учетной записи — единственное значение, которое нужно ввести на этой странице.

    sales-new-account-details


Настройка страницы сообщества 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 без загрузки страницы электронной подписи в режиме наложения.
    • Если установлено значение «true», то будет возвращен signingURL и загружена страница электронной подписи в режиме наложения.
    • Значение по умолчанию: «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

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