Adobe Sign для Salesforce: Simple Sign

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

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

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

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

• Проверка требований
  
• Включение Chatter
• Включение цифровых сред
• Активация двух доверенных узлов CSP
• Клонирование профиля пользователя сообщества
• Создание учетной записи, контакта и пользователя для сообщества
• Настройка страницы сообщества SFDC
• Настройка рабочего пространства среды для включения пользователей
• Установка для параметра «Адрес электронной почты» в разделе «Видимость профиля» пользователя сообщества значения «Общедоступно»
• Добавление компонента Adobe Simple Sign в рабочее пространство
• Встраивание кода Simple Sign в компоненты Lightning
• Предоставление доступа к данным интеграции Salesforce
• Предоставление доступа к шаблонам соглашений и связанным объектам
• Сведения об ограничениях самостоятельного подписания

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

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

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

• На вкладке Шаблоны соглашений указан шаблон Тестовое соглашение сообщества.
  

Включение Chatter

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Добавление компонента Adobe 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}"/>

В следующей таблице перечислены доступные события:

Настройка шаблона документа для Simple Sign

Предоставление доступа к данным интеграции 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, администраторы должны включить параметр «Разрешить клиентам получать доступ к заметкам и вложениям» в настройках сообществ.