Adobe Sign для Salesforce: Simple Sign

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

Доступ к функции Simple Sign можно получить в следующих порталах нескольких выпусков облачного портала сообщества Salesforce:

  • Портал B2C: вход для пользователя сообщества и вход для пользователя сообщества с лицензиями, которые используют клиенты
  • Портал B2B: лицензия пользователя сообщества партнеров

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

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

Необходимые требования

Чтобы получить доступ к функции Simple Sign и использовать ее, необходимо проверить следующее:

  • Установлен пакет Adobe Acrobat Sign для Salesforce версии 21.0 или более поздней версии.
  • Интерфейс Lightning включен в вашей организации Salesforce для работы портала. Чтобы включить интерфейс Lightning, в верхнем меню выберите Переключиться на Lightning. Или выберите свое имя и в раскрывающемся меню нажмите Переключиться на интерфейс Lightning.
  • При привязывании Salesforce к Adobe Acrobat Sign был включен параметр Создание образцов шаблонов документов.
link-accounts

  • Если шаблоны не были созданы во время установки или если выполнено обновление с предыдущей версии пакета до версии 19, перейдите на вкладку Администратор Adobe Acrobat Sign и выберите Создание образца шаблона самоподписываемого соглашения.
  • На вкладке Шаблоны соглашений указан шаблон Тестовое соглашение сообщества.
verify-test-community-agreement

Включение Chatter

Включение Chatter в организации SFDC

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

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

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

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

Активация двух доверенных узлов 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. Откройте раскрывающееся меню Учетная запись и выберите +Создать учетную запись.

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

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

    create-new-account

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

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

  2. Нажмите Создать.

  3. Выберите интерфейс Обслуживание клиентов.

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

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

  5. На открывшейся странице:

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

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

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

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

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

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

  2. Для вашего сообщества выберите Рабочие пространства.

  3. На открывшейся странице Мои рабочие пространства выберите Администрирование.

  4. На странице администрирования вашего сообщества:

    1. На панели слева выберите Настройки, затем Активация для индикатора состояния.
    2. На панели слева выберите Участники.
    3. В раскрывающемся меню «Поиск» выберите Все.
    4. В списке Доступные профили выберите созданный вами пользовательский профиль.
    5. Выберите Добавить, чтобы переместить профиль в список Выбранные профили.
    6. Нажмите Сохранить.

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

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

    Войдите в среду как пользователь.

  2. В открывшемся в правом верхнем углу портале интерфейса выберите имя пользователя, затем Мои настройки в раскрывающемся меню.

  3. На открывшейся странице Мои настройки:

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

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

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

  2. Для вашего сообщества выберите Рабочие пространства.

  3. В разделе Мои рабочие пространства на странице выберите Builder.

  4. В верхнем углу страницы слева нажмите значок Компоненты, прокрутите до нижней части меню и перетащите параметр Adobe Simple Sign на макет страницы.

    Поместите компонент в местоположение, в котором требуется отобразить документы Adobe Sign.

    Перетащите Simple Sign в шаблон портала.

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

  5. На панели управления выберите Шаблон соглашения, затем Опубликовать, чтобы сделать портал доступным.

    Примечание.

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

Встраивание кода 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 для назначения получателя на основе поиска главного объекта (этим объектом должен быть «Контакт»).

  1. На вкладке Сведения о шаблоне:

    1. Откройте раскрывающееся меню Объект Salesforce и нажмите Выбрать из других объектов.
    2. В появившемся раскрывающемся поле выберите Контакт.
  2. На вкладке «Получатели»:

    1. Удалите существующего получателя из шаблона.
    2. Выберите Добавить получателя из объекта или переменной времени выполнения.
    3. На появившемся наложении Добавить получателя:
      1. В поле Выберите объект или переменную времени выполнения нажмите Поиск на основе поля главного объекта.
      2. Задайте для первого типа получателя значение «Главный объект (Контакт)», а для Поле-источник из главного объекта — contact ID.
      3. Нажмите Сохранить.

Чтобы использовать Simple Sign, необходимо прикрепить файл к шаблону. В отличие от активного процесса отправки отправитель не может прикрепить документ позже. Прикрепление файла к шаблону

  1. Перейдите к вкладке Вложения и добавьте документ с устройства.

    Также можно выбрать расположение документа в разделе «Выбор документов для добавления».

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

  3. Чтобы прикрепить их к шаблону, выбирайте их по одному.

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

    Примечание.

    Все добавленные файлы хранятся в Salesforce в разделе Salesforce CRM и файлы.

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

Для этого выполните следующие три действия:

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

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

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

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

  2. Для составления списка Настройки Adobe Sign выберите Управление.

  3. Выберите Создать (или Редактирование, если параметры уже были настроены ранее).

    Загрузится страница Настройки Adobe Sign.

  4. Найдите и установите флажок Разрешить отправку от имени других.

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

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

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

  1. Выберите Настройка > Инструменты платформы > Объекты и поля > Диспетчер объектов.

  2. На странице Диспетчер объектов выберите метку Пользователь

  3. На панели слева на странице Пользователь выберите Макеты страницы пользователя, затем выберите макет пользователя.

    configure-user-1

  4. В макете пользователя выберите параметр Поля и перетащите следующие два поля в раздел макета Дополнительная информация (заголовок отображается только при редактировании):

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

    1. Выберите Настройка > Администрирование > Пользователи > Пользователи.
    2. Для пользователя типа «Контакт сообщества» выберите Редактирование.
    3. На странице Редактирование пользователя найдите раздел Дополнительная информация.
    4. Установите флажки Разрешить отправку от имени других пользователей и Адрес электронной почты Adobe Acrobat Sign проверен.
    5. На странице «Редактирование пользователя» скопируйте UserID из URL-адреса в строке адреса в браузере.

    UserID можно найти в URL-адресе страницы (выделено желтым ниже):

  6. В URL-адресе (выделено выше) скопируйте UserID (выделено полужирным) и сохраните для выполнения следующего действия. Исключите %2F в начале и %3 в конце. Когда это будет сделано, нажмите Сохранить.

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

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

  1. Перейдите в Средство запуска приложений > Adobe Acrobat Sign > Шаблоны документов.

  2. Выберите имя шаблона документа, который требуется изменить.

  3. На вкладке Получатели выберите поле Отправить от имени, затем вставьте в поле идентификатор пользователя Salesforce.

    Идентификатор местозаполнителя можно удалить без каких-либо проблем.

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

Предоставление доступа к данным интеграции Salesforce

Для пользовательских объектов нашего пакета изначально установлен тип доступа «личные» для внешних пользователей по умолчанию. Наборы разрешений для пользователей сообщества предоставляют доступ к пользовательским объектам и их полям, но не к записям, созданным другими пользователями (внутренними и внешними).

На порталах сообществ администраторам доступны два параметра для настройки потоков eSign:

  • Используйте встроенные компоненты (self-sign и simple-sign).
  • Создавайте собственные потоки с помощью API Apex. 

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

Тип лицензии пользователя сообщества определяет способ предоставления доступа:

  • Лицензия на вход для пользователя сообщества: администраторы могут включить «Просмотреть все» для шаблонов документов и объектов объединения/сопоставления данных в профиле пользователя сообщества для предоставления доступа.
  • Вход для пользователя сообщества с лицензией и лицензия пользователя сообщества партнеров: включение доступа «Просмотреть все» в профиле недоступно. Для предоставления доступа администраторам необходимо использовать правила общего доступа на основе ролей.

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

Пользователям сообщества, создающим документы с помощью шаблонов документов, необходимо предоставить доступ «Просмотреть все» к шаблонам документов и связанным объектам.

  • Шаблон документа (echosign_dev1__Agreement_Template__c)
  • Перенос данных (echosign_dev1__SIGN_Merge_Mapping__c)
  • Сопоставление данных (echosign_dev1__SIGN_Data_Mapping__c)

Если шаблоны Acrobat Sign Document Builder используются вместе с шаблоном документа в качестве вложенного файла, объектам ниже необходимо предоставить доступ к пользователям сообщества:

  • Шаблон Document Builder (adobesign__Document_Template__c)

  • Сопоставление полей объекта (adobesign__Object_Field_Mapping__c)

Ограничения Simple Sign

  • Если для шаблона не включен параметр Только подпись отправителяпользователи сообщества увидят сообщение об ошибке, в котором указано, что для них нет доступных URL-адресов для подписания.

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

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

  • Simple Sign не поддерживает делегирование. Другие получатели не смогут получить доступ к URL-адресу для подписи.

  • Simple Sign не поддерживает замену подписывающей стороны (форма делегирования). Новые подписывающие стороны не будут получать доступ к URL-адресу для подписи.

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

 Adobe

Получайте помощь быстрее и проще

Новый пользователь?