Adobe Sign pour Salesforce : signature simplifiée

Simple Sign est un composant d’origine permettant aux utilisateurs du portail communautaire de signer des accords en libre-service. Ajoutez ce composant à tout portail Salesforce Experience Cloud (client, partenaire, employé, etc.) ou incorporez-le dans d’autres composants Lightning.

Conditions préalables

Pour accéder à la fonctionnalité de signature simplifiée, la version 21.0 ou ultérieure du package Adobe Sign pour Salesforce doit être installée.

Les nouvelles installations ne doivent pas oublier de générer des exemples de modèle d’accord au moment de lier Salesforce à Adobe Sign.

link-accounts

Si les modèles n’ont pas été générés lors de l’installation, ou si vous avez effectué une mise à niveau à partir d’une version précédente du package vers v19, vous pouvez générer les modèles depuis l’onglet Administrateur Adobe Sign.

generate-self-sign-template

Vérifiez que l’onglet Modèles d’accord contient le modèle Tester l’accord de communauté :

verify-test-community-agreement

Si vous ne l’avez pas encore fait, activez Lightning

La version Lightning doit être activée dans votre organisation Salesforce pour que le portail fonctionne.

Pour activer l’interface Lightning :

  • Dans le menu supérieur, sélectionnez Basculer vers Lightning ou
  • Sélectionnez votre nom, puis, dans le menu déroulant, sélectionnez Basculer vers Lightning Experience.
Basculer dans Lightning


Activation de Chatter

Chatter doit être activé dans votre organisation SFDC. Pour ce faire, procédez comme suit :

  1. Accédez à : Configuration > Outils de la plate-forme > Paramètres de fonctionnalité > Chatter > Paramètres Chatter.
  2. Sélectionnez Modifier.
  3. Cochez la case Activer.
  4. Sélectionnez Enregistrer.


Activation des expériences numériques

Pour activer les expériences digitales :

  1. Accédez à Configuration > Outils de la plate-forme > Paramètres de fonctionnalité > Expériences digitales > Paramètres.
  2. Cochez la case Activer les expériences digitales.
  3. Fournissez un nom de domaine pour vos expériences.
    Si votre compte possède déjà un domaine établi, vous pouvez utiliser la même valeur pour les expériences.
  4. Sélectionnez Enregistrer.
  5. Dans la boîte de dialogue présentant un avertissement indiquant que votre domaine ne peut pas être modifié une fois établi, sélectionnez OK.
Activation des expériences numériques


Activer deux sites de confiance CSP

Vous devez configurer deux sites de confiance CSP (Politique de sécurité des contenus) pour autoriser les URL de base pour votre compte Adobe Acrobat Sign. Pour ce faire, procédez comme suit :

  1. Pour obtenir la valeur de partition de votre compte Acrobat Sign, procédez comme suit :

    1. Connectez-vous à votre compte Adobe Acrobat Sign.
    2. Dans l’URL, copiez le paramètre situé immédiatement avant la partie echosign.com (peut-être adobesign.com) (la valeur de partition). 
      Par exemple, l’URL https://caseyjones.na1.echosign.com a la valeur de partition na1.
    3. Fermez cet onglet.

    Découvrez comment identifier l’environnement de compte Adobe Acrobat Sign.

    global-settings

  2. Accédez à Configuration > Paramètres > Sécurité > Sites de confiance CSP, puis sélectionnez Nouveau site de confiance.

    csp-trusted-sites

  3. Dans la nouvelle page Définition de site qui s’ouvre, remplissez les champs obligatoires comme suit :

    1. Nom du site de confiance : indiquez un nom, par exemple AcrobatSign.
    2. URL du site de confiance : saisissez l’URL du site https://secure.<partition>.adobesign.com
      Exemple : https://secure.na1.adobesign.com
      Si votre compte n’est pas mis à jour vers le domaine adobesign.com, vous pouvez utiliser echosign.com à la place.
    3. Cochez la case Actif.
    4. Contexte : sélectionnez Sites Générateur d’expérience pour le contexte.
    5. Cochez la case Autoriser le site pour frame-src sous Directives CSP.
    6. Sélectionnez Enregistrer.
    csp-trusted-site-definition

  4. Revenez à Configuration > Paramètres > Sécurité > Sites de confiance CSP, puis sélectionnez Nouveau site de confiance.

  5. Dans la nouvelle page Définition de site qui s’ouvre, remplissez les champs obligatoires comme suit :

    1. Nom du site de confiance : indiquez un nom, par exemple AcrobatSign2.
    2. URL du site de confiance : saisissez l’URL du site  https://secure.adobesign.com
    3. Cochez la case Actif.
    4. Contexte : sélectionnez Sites Générateur d’expérience pour le contexte.
    5. Cochez la case Autoriser le site pour frame-src sous Directives CSP.
    6. Sélectionnez Enregistrer.
    Deuxième site de confiance CSP

  6. Vérifiez les deux sites de confiance CSP.

    Sites CSP approuvés


Création de l’utilisateur du portail communautaire

Clonage du profil utilisateur de la communauté

Pour configurer vos profils utilisateur afin d’utiliser le portail en libre-service Adobe Acrobat Sign, vous devez cloner et modifier l’un des profils standard. Pour ce faire, procédez comme suit :

  1. Accédez à Configuration > Administration > Utilisateurs > Profils.

  2. Pour tout profil client standard, sélectionnez Cloner.

    Les profils de la Communauté de clients sont au nombre de quatre. Vous pouvez les utiliser pour cloner et créer un profil utilisateur. Notez le type de licence utilisateur du profil que vous clonez.

    setup-profiles

  3. Donnez un nom intuitif à votre profil cloné, puis sélectionnez Enregistrer.

    cloned-profile-name

  4. Dans la page de profil cloné qui s’ouvre, sélectionnez Modifier.

    cloned-profile-edit

  5. Faites défiler la page Modification personnalisée jusqu’à Autorisations personnalisées des objets et activez tous les objets Adobe Acrobat Sign. Vous pouvez cocher la case Tout modifier ou sélectionner uniquement les autorisations requises pour une sécurité renforcée. 

    cloned-prodile-custom-object-permissions


Création d’un compte, d’un contact et d’un utilisateur pour la communauté

Vous devez créer un compte, un contact et un utilisateur pour la communauté. 

Le propriétaire du compte doit être associé à un rôle pour activer les utilisateurs du portail. Pour associer un rôle à votre utilisateur Salesforce, accédez à Configuration > Administration > Utilisateurs > Utilisateurs. Ensuite, dans la liste des utilisateurs, sélectionnez Modifier pour un utilisateur, puis, dans la page qui s’ouvre, ouvrez le menu déroulant Rôle, sélectionnez un rôle, puis Enregistrer.

Pour créer un compte :

  1. Lancez l’application Ventes depuis la page Lanceur d’applications.

  2. Ouvrez le  menu déroulant Comptes et sélectionnez +Nouveau compte.

    sales-new-account

  3. Dans la page Nouveau compte qui s’ouvre, saisissez une valeur Nom du compte, puis sélectionnez Enregistrer.

    Le nom du compte doit identifier le compte en tant que compte Portail Adobe Acrobat Sign. Le nom du compte est la seule valeur que vous devez indiquer ici.

    sales-new-account-details


Configuration de la page de la Communauté SFDC


Créer une nouvelle communauté

  • Accédez à : Configuration > Outils de la plate-forme > Paramètres de fonctionnalité > Expériences numériques > Tous les sites.
  • Cliquez sur le bouton Nouveau.
Expériences numériques - Tous les sites

 

  • Sélectionnez l’expérience Service client.
    • L’expérience Service client est requise pour les composants Self-Service.

 

  • Lorsque la page Service client charge, cliquez sur Premiers pas.

 

  • Saisissez le nom de la communauté.
    • Si vous le souhaitez, vous pouvez ajouter un nom spécifique au site à l’URL, ce qui est utile si vous avez plusieurs communautés.
  • Cliquez sur Créer après avoir configuré le nom.

Un magnifique diaporama composé de graphiques s’exécute après la création de la communauté. Une fois que vous avez terminé, la page Communauté s’affiche.

►Le nom de la communauté s’affiche en haut de la fenêtre et est surligné en jaune

►La chaîne spécifique au site dans l’URL se trouve dans la barre d’adresse et est surligné en turquoise


Configuration de l’espace de travail de l’expérience pour autoriser les utilisateurs

  • Accédez à : Configuration > Outils de la plate-forme > Paramètres de fonctionnalité > Expériences numériques > Tous les sites.
  • Cliquez sur le lien Espaces de travail de votre communauté.
Cliquez sur Espaces de travail.

La page Mes espaces de travail charge :

  • Cliquez sur l’option Administration.

La page Administration s’ouvre pour votre communauté.

Lorsque les paramètres sont sélectionnés sur le rail de gauche :

  • Cliquez sur le bouton Activer à droite de l’indicateur de statut.

 

Sélectionnez Membres depuis le rail de gauche.

  • Sélectionnez Tous dans la liste déroulante de recherche.
  • Sélectionnez le profil personnalisé que vous avez créé dans la liste Profils disponibles.
  • Cliquez sur le bouton Ajouter, puis déplacez le profil vers la liste Profils sélectionnés.
  • Cliquez sur le bouton Enregistrer.


Définissez les paramètres Visibilité du profil pour le paramètre E-mail de l’utilisateur de la communauté sur Public

L’adresse électronique dans la section Visibilité du profil de la communauté doit être définie sur Public :

  • Ouvrez la page Contact pour l’utilisateur que vous utilisez pour la fonction Envoyer au nom de.
  • Sélectionnez Se connecter à une expérience en tant qu’utilisateur.
Connexion à une expérience en tant qu’utilisateur

L’interface du portail s’ouvre :

  • Cliquez sur le nom d’utilisateur dans la partie supérieure droite de la fenêtre de la page de la communauté pour ouvrir la liste déroulante.
  • Sélectionnez Mes paramètres.

La page Mes paramètres de l’utilisateur s’ouvre :

  • Dans la section Visibilité du profil, définissez la valeur E-mail sur Public.
  • Cliquez sur Enregistrer.

Ajout du composant Adobe Simple Sign à l’espace de travail

  • Accédez à : Configuration > Outils de la plate-forme > Paramètres de fonctionnalité > Expériences numériques > Tous les sites.
  • Cliquez sur le lien Espaces de travail de votre communauté.
  • Cliquez sur l’option Générateur dans la section Mes espaces de travail de la page.
  • Cliquez sur l’icône des composants en haut à gauche de la page, faites défiler jusqu’en bas du menu, cliquez sur l’option Adobe Simple Sign, puis glissez-la sur la mise en page.
    • Faites glisser le composant à l’endroit où vous souhaitez que les accords Adobe Sign apparaissent
Faites glisser Simple Sign dans le modèle de portail

 

La page s’actualise pour afficher le composant supplémentaire sur la mise en page et place le panneau gestion relatif au composant dans le coin supérieur droit.

Le panneau de gestion dans le coin supérieur droit de la fenêtre ne dispose que d’une seule option configurable :

Modèle de l’accord : le modèle qui gère les accords répertoriés au sein du composant

 

Sélectionnez le modèle, puis cliquez sur le bouton Publier pour rendre le portail disponible.

  • Chaque fois que vous modifiez le portail ou un des paramètres, vous devez publier à nouveau le portail.

Intégration du code Simple Sign dans vos composants Lightning

Le composant Simple Sign peut être intégré à n’importe quel autre composant Lightning.

Exemple de code du composant :

<echosign_dev1:SimpleSign templateId="a0L190000019xUrEAI" />

 

Lorsque le composant est intégré par programmation à un autre composant, les paramètres supplémentaires suivants peuvent être définis :

  • agreementId : identifiant Salesforce de l’accord à la volée ou du projet d’accord 
    • L’option Envoyer au nom de doit être configurée pour les projets d’accords
  • templateId : identifiant Salesforce du modèle qui gère les accords générés
  • pollingInterval : la valeur doit correspondre à un nombre en millisecondes
    • Elle indique le temps passé entre chaque tentative de récupération de l’URL de signature
      • La valeur minimale est 500
      • La valeur maximum est 50000
      • La valeur par défaut est 1000
  • showSigningModal
    • S’il est défini sur false, il renvoie simplement la signingURL sans charger la page de signature électronique dans une superposition modale
    • S’il est défini sur true, il renvoie la signingURL et charge la page de signature électronique dans la superposition modale
    • La valeur par défaut est true

 

Les paramètres respectent les règles suivantes :

  • Les valeurs agreementID ou templateID doivent être spécifiées
    • Si les deux sont spécifiés, agreementID sera utilisée
    • Si aucune valeur n’est spécifiée, une erreur est renvoyée
  • Lors de l’utilisation d’un agreementID, la licence doit être à l’état Brouillon ou Émis pour signature si au moins un destinataire doit encore le signer
    • Si l’accord est à l’état de brouillon, envoyez-le en l’état, capturez l’URL de signature et affichez-la
    • Si l’accord est de type à la volée, capturez l’URL de signature et affichez-la
    • Si l’accord est terminé, affichez et signalez une erreur
  • Si un templateID est utilisé, l’option Envoi automatique est systématiquement activée
    • Lorsqu’un agreementID est utilisé, le paramètre Envoi automatique du modèle est respecté
  • Les modèles d’accord à signature simplifiée doivent disposer d’un type d’objet principal de contact
  • Il est fortement recommandé d’utiliser Envoyer au nom de, car la grande majorité des utilisateurs de la communauté n’est généralement pas autorisée à effectuer d’envois

 

Le composant peut également publier des événements chez ses clients.  Voici un exemple de gestionnaire d’événement :

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

Les événements disponibles sont :

Accord envoyé

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

Accord chargé à partir d’un modèle

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

Page de signature ouverte

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

Signé

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

Aucune signature

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

Erreur pendant une action

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


Exigences en matière de modèles d’accord pour la signature simplifiée

Les modèles dans l’environnement Simple Sign doivent être configurés pour affecter le destinataire à un objet principal en fonction d’une référence, et cet objet doit être un contact.

Sous l’onglet Informations sur le modèle :

  • Cliquez sur le menu déroulant sous Objet Salesforce
  • Sélectionnez Choisir parmi les autres objets
    • une nouvelle liste déroulante apparaît
  • Sélectionnez Contact dans la seconde liste déroulante

  • Cliquez sur l’onglet Destinataire
  • Supprimez le destinataire déjà sur le modèle
  • Cliquez sur le lien Ajouter un destinataire à partir de l’objet ou d’une variable d’exécution
    • La superposition Ajouter un destinataire s’affiche
  • Dans le champ Sélectionner un objet ou une variable d’exécution, sélectionnez Association sur la base du champ d’objet principal
    • Le premier destinataire doit être défini sur Objet principal (Contact) et le champ source de l’objet principal doit être ID de contact
  • Cliquez sur Enregistrer

Un fichier d’un certain type doit être joint au modèle pour que la signature simplifiée fonctionne.  Il n’est pas possible pour l’expéditeur de joindre le document comme un processus d’envoi actif.

  • Cliquez sur l’onglet Pièce jointe
  • Chargez un document à partir de votre système local
    • Vous pouvez également sélectionner un environnement dans lequel votre document se trouve (dans la section Sélectionner pour ajouter des documents)
      • Cliquez sur le champ de recherche pour afficher tous les documents disponibles dans cette section
      • Sélectionnez-les un par un pour les joindre au modèle

Cliquez sur Enregistrer une fois tous vos documents joints

Remarque :

Chaque fichier chargé est stocké dans Salesforce (dans l’option Fichiers et gestion de la relation client Salesforce)

Si certains utilisateurs du portail n’ont pas de licence Adobe Sign, vous devrez contourner la licence utilisateur à l’aide de la fonction « Envoyer au nom de » intégrée dans le package.  Cela permet à un utilisateur de la communauté de générer un accord à l’aide de la licence d’un autre utilisateur.

Ce paramétrage nécessite trois configurations :

  • Activer le paramètre Autoriser envoi au nom d’autres utilis. dans les paramètres personnalisés
  • Configurer un utilisateur possédant une licence sur Autoriser envoi au nom de son utilisateur
  • Configurer le modèle d’accord avec l’ID Salesforce de l’utilisateur ci-dessus 


Activer le paramètre

  1. Accédez à Configuration > Outils de la plate-forme > Code personnalisé > Paramètres personnalisés.
    • La page Paramètres personnalisés se charge alors.
  2. Cliquez sur l’étiquette Paramètres Adobe Sign.
    • La page Paramètres Adobe Sign se charge.

    3. Cliquez sur le bouton Gérer.

    4. Cliquez sur Nouveau (ou Modifier, si vous avez configuré les paramètres avant).

  • La page Paramètres Adobe Sign se charge.

5. Recherchez le paramètre Autoriser envoi au nom d’autres utilis

  • Activez le paramètre en cochant la case
  • Cliquez sur Enregistrer

Configurer l’utilisateur pour que d’autres personnes puissent envoyer des accords en son nom

Pour permettre à l’utilisateur d’accéder à la fonctionnalité Envoyer au nom de, deux champs doivent être ajoutés à la mise en page des enregistrements d’utilisateur :

  • Accédez à Configuration > Outils de la plate-forme > Objets et champs > Gestionnaire d’objets.
  • Sélectionnez Utilisateur dans le gestionnaire d’objets.
  • Sélectionnez Présentations de page Utilisateur dans le rail gauche de la page d’objet Utilisateur.
  • Cliquez sur le lien Mise en page utilisateur.
  • Avec les champs sélectionnés, cliquez sur les deux champs ci-dessous et faites-les glisser vers la section « Informations supplémentaires (en-tête visible uniquement lors de la modification) » de la mise en page.
    • Adobe Sign - Autoriser envoi comme autres util.
    • Adresse électronique Adobe Sign vérifiée 
  • Cliquez sur Enregistrer

Lorsque les champs sont définis, activez l’utilisateur spécifié :

  • Accédez à Configuration > Administration > Utilisateurs > Utilisateurs.
  • Cliquez sur l’action Modifier pour l’utilisateur « contact de la communauté »
  • Dans la section Informations supplémentaires de la page Modification de l’utilisateur
    • Cochez l’option Adobe Sign - Autoriser envoi comme autres util.
    • Cochez l’option Adresse électronique Adobe Sign vérifiée

En conservant la page Modification de l’utilisateur ouverte, copiez l’ID utilisateur de l’URL dans la barre de votre navigateur.

L’ID utilisateur se trouve dans L’URL de la page (en surbrillance en jaune ci-dessous) :

L’URL ci-dessus indique (avec l’ID en gras) :

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

Veillez à ne pas inclure %2F au début et %3 à la fin

  • Copiez et enregistrez l’ID utilisateur pour l’étape suivante

 

Cliquez sur le bouton Enregistrer une fois terminé pour sauvegarder la configuration.


Mettre à jour le modèle avec l’ID utilisateur

  • Accédez à : Lanceur d’application > Adobe Sign > Modèles d’accord
  • Cliquez sur le nom du modèle d’accord que vous souhaitez modifier
Accédez au modèle d’accord

Cliquez sur l’onglet Destinataires et modifiez le champ Envoyer au nom de

  • Collez l’ID utilisateur Salesforce dans le champ (il y a un caractère de remplacement pour l’ID que vous pouvez facilement supprimer)
  • Cliquez sur Enregistrer
Modifiez Envoyer au nom de


Limites du composant

Le composant Simple Sign présente certaines limites que vous devez connaître :

 

1. Le modèle peut ne pas être configuré avec l’option Uniquement les signatures de l’expéditeur activée

○ Dans ce cas, une erreur indiquant qu’il n’existe aucune URL de signature pour l’utilisateur actuel s’affiche chez l’utilisateur de la communauté

2. L’option Autoris. aperçu et positionnement champs du modèle peut ne pas être cochée

○ Dans ce cas, l’accord reste à l’état de pré-envoi et aucune URL de signature ne charge

3. L’option Activer la signature hébergée du modèle peut ne pas être cochée

4. Simple Sign ne prend pas en charge la délégation

○ Dans ce cas, l’autre destinataire ne pourra pas accéder à l’URL de signature

5. Simple Sign ne prend pas en charge l’option Remplacer le signataire (qui est un formulaire de délégation)

○ Dans ce cas, le nouveau signataire ne pourra pas accéder à l’URL de signature

6. Pour accéder aux notes et pièces jointes de n’importe quel objet Salesforce, les administrateurs doivent activer l’option Autoriser les utilisateurs client à accéder aux notes et pièces jointes dans Paramètres des communautés

Logo Adobe

Accéder à votre compte