Utilisation de DocuSign avec un formulaire adaptatif

DocuSign est une solution de signature électronique de premier plan. Vous pouvez l’utiliser pour signer un contrat électroniquement. Vous pouvez intégrer DocuSign à un formulaire adaptatif. Il vous permet d’envoyer un formulaire adaptatif à plusieurs destinataires pour qu’ils le signent électroniquement. L’utilisation des signatures électroniques vous permet d’effectuer les opérations suivantes :

  • Vous pouvez établir des contrats à partir de tout appareil à l’aide de processus entièrement automatisés d’offre, de devis et de contrat.
  • Vous pouvez exécuter plus rapidement les processus de ressources humaines et offrir à vos employés une expérience numérique plus satisfaisante.
  • Vous pouvez réduire considérablement les durées des cycles de mise en œuvre des contrats et intégrer plus rapidement vos fournisseurs.

AEM Forms as a Cloud Service fournit une action d’envoi personnalisée pour DocuSign. L’action d’envoi vous permet d’envoyer des formulaires adaptatifs pour les signatures électroniques à l’aide des API DocuSign.

Vous pouvez également utiliser la solution de signature électronique d’Adobe, Adobe Sign, pour signer électroniquement un formulaire adaptatif. AEM Forms est bien plus intégré à Adobe Sign et offre des contrôles bien plus précis tels que la signature séquentielle et parallèle, plusieurs méthodes d’authentification, l’expérience de signature dans un formulaire, etc. Pour plus d’informations, voir Utilisation d’Adobe Sign dans un formulaire adaptatif.

Prérequis

Les éléments suivants sont requis pour intégrer DocuSign à AEM Forms :

Configuration d’une action d’envoi personnalisée et du service cloud pour DocuSign

AEM Forms as a Cloud Service fournit une action d’envoi personnalisée pour DocuSign. L’action d’envoi vous permet d’envoyer des formulaires adaptatifs pour les signatures électroniques à l’aide des API DocuSign. Le code de l’action d’envoi personnalisée est disponible dans le référentiel git public des exemples d’AEM Forms. Vous pouvez déployer le code tel qu’il se présente dans votre environnement AEM Forms ou le personnaliser selon les besoins de votre entreprise.

Suivez les étapes suivantes pour configurer l’action d’envoi personnalisée prête à l’emploi et le service cloud DocuSign :

  1. Clonez votre projet AEM Forms as a Cloud Service ou créez un projet Experience Manager Forms as a Cloud Service basé sur l’archétype AEM 27 ou une version supérieure. Pour créer un projet Experience Manager Forms as a Cloud Service basé sur l’archétype AEM, suivez les étapes suivantes :

    Ouvrez l’invite de commandes et exécutez la commande ci-après pour créer un projet Experience Manager Forms as a Cloud Service :

    mvn -B archetype:generate -DarchetypeGroupId=com.adobe.aem -DarchetypeArtifactId=aem-project-archetype -DarchetypeVersion=27 -DaemVersion="cloud" -DappTitle="My Site" -DappId="mysite" -DgroupId="com.mysite" -DincludeForms="y"
    

    Modifiez également appTitle, appId et groupId dans la commande ci-dessus pour refléter votre environnement.

  2. Clonez le référentiel aem-forms-samples. Ce référentiel contient une action d’envoi personnalisée pour DocuSign et des détails de configuration pour se connecter au serveur DocuSign.

  3. Ouvrez le projet AEM Forms as a Cloud Service créé à l’étape 1 pour le modifier dans l’IDE de votre choix.

  4. Ouvrez le projet [AEM Forms as a Cloud Service project]\pom.xml pour le modifier et opérer les changements suivants :

    1. Ajoutez le texte suivant à la fin de la balise <properties> :

      <repository.location>maven_repository</repository.location>
      
    2. Ajoutez le texte suivant à la fin de la balise <repositories> :

       <repository>
          <id>project-repository</id>
          <url>file://${project.basedir}/${repository.location}</url>
       </repository>
      

      Si la balise <repositories> n’existe pas, créez-la sous la balise <properties>.

    3. Ajoutez le texte suivant à la fin de la balise <dependencyManagement> :

       <dependency>
         <groupId>com.adobe.aemforms.samples</groupId>
         <artifactId>forms.integration.docusign.all</artifactId>
         <type>zip</type>
         <version>1.0.0</version>
       </dependency>
      
  5. Procédez comme suit dans le fichier all/pom.xml disponible dans le dossier du projet Cloud Service :

    1. Ajoutez le texte suivant à la fin de la balise <embeddeds> :

       <embedded>
          <groupId>com.adobe.aemforms.samples</groupId>
          <artifactId>forms.integration.docusign.all</artifactId>
          <type>zip</type>
          <target>/apps/moonlightprodprogram-vendor-packages/application/install</target>
       </embedded>
      
    2. Ajoutez le texte suivant à la fin de la balise <dependencies> :

       <dependency>
          <groupId>com.adobe.aemforms.samples</groupId>
          <artifactId>forms.integration.docusign.all</artifactId>
          <type>zip</type>
       </dependency>
      
  6. Ouvrez l’invite de commandes, accédez à aem-forms-samples\forms-integration-docusign (cloné à l’étape 3) et exécutez la commande suivante :

    mvn clean install -Dinstall.dir="<AEM Forms as a Cloud Service project path>/maven_repository"
    

    <AEM Forms as a Cloud Service project path> fait référence au nom du dossier créé à l’étape 1 de cette procédure.

  7. Déployez le projet sur votre environnement de développement local. Vous pouvez utiliser la commande suivante pour effectuer un déploiement sur votre environnement de développement local :

    mvn -PautoInstallPackage clean install

    Après avoir suivi ces étapes, vous pouvez afficher une nouvelle action d’envoi personnalisée Envoyer avec les signatures électroniques DocuSign disponible dans la liste des options d’envoi d’un formulaire adaptatif et d’une configuration du service cloud DocuSign dans votre environnement de développement local.

  8. Compilez et déployez le code sur votre environnement AEM Forms as a Cloud Service.

Intégration de DocuSign à AEM Forms

Une fois les prérequis réunis, procédez comme suit pour intégrer DocuSign à AEM Forms sur les instances d’auteur.

  1. Accédez à Outils marteau > Services cloud > DocuSign et sélectionnez un dossier pour héberger la configuration.

  2. Sur la page des configurations, appuyez sur Créer pour créer une configuration DocuSign dans AEM Forms.

  3. Dans l’onglet Général de la page Créer une configuration DocuSign, spécifiez un nom de configuration et appuyez sur Suivant. Vous pouvez éventuellement spécifier un Titre.

  4. Copiez l’URL dans la fenêtre active du navigateur dans un bloc-notes. L’URL est nécessaire pour configurer l’application DocuSign avec AEM Forms à une étape ultérieure.

  5. Configurez les paramètres OAuth pour l’application DocuSign :

    1. Ouvrez une fenêtre de navigateur et connectez-vous au compte de développeur DocuSign.
    2. Ouvrez l’application configurée pour AEM Forms.
    3. Dans la zone URL de redirection, ajoutez l’URL copiée à l’étape précédente et cliquez sur Enregistrer.
    4. Notez la clé d’intégration et la clé secrète.

    Pour obtenir des informations détaillées sur la configuration des paramètres OAuth pour une application DocuSign et l’obtention des clés, voir Configuration des paramètres oAuth pour l’application dans la documentation du développeur.

  6. Revenez à la page Créer une configuration DocuSign. Dans l’onglet Paramètres, le champ URL OAuth indique l’URL suivante par défaut :

    https://account-d.docusign.com/oauth/auth

  7. Spécifiez l’ID client (la clé d’intégration DocuSign) et la Secret client (clé secrète DocuSign).

  8. Appuyez sur Se connecter à DocuSign. Lorsque vous êtes invité à fournir vos informations d’identification, indiquez le nom d’utilisateur et le mot de passe du compte utilisé lors de la création de l’application DocuSign. Lorsque vous êtes invité à confirmer l’accès à your developer account, cliquez sur Autoriser l’accès. Si les informations d’identification sont correctes, un message de réussite s’affiche.

  9. Appuyez sur Créer pour créer la configuration DocuSign.

  10. Sélectionnez la configuration, cliquez sur Publier, sélectionnez la configuration, puis cliquez sur Publier. La configuration sera ainsi répliquée sur les environnements de publication correspondants.

  11. Répétez toutes les étapes ci-dessus sur vos instances de développement, d’évaluation ou de production (toutes celles non encore configurées) pour terminer la configuration d’DocuSign avec AEM Forms pour votre environnement.

Désormais, votre environnement AEM Forms est configuré pour utiliser DocuSign. Veillez à ajouter le conteneur de configurations utilisé pour le service cloud à tous les formulaires adaptatifs activés pour DocuSign. Vous pouvez spécifier un conteneur de configurations à partir des propriétés d’un formulaire adaptatif.

Utilisation de DocuSign dans un formulaire adaptatif

Vous pouvez activer DocuSign pour un formulaire adaptatif existant ou créer un formulaire adaptatif prenant en charge DocuSign. Choisissez l’une des méthodes suivantes :

Création d’un formulaire adaptatif pour DocuSign

Pour créer un formulaire adaptatif prenant en charge les signatures :

  1. Accédez à Adobe Experience Manager > Formulaires > Formulaires et documents.

  2. Appuyez sur Créer et sélectionner Formulaire adaptatif. Une liste de modèles s’affiche. Sélectionnez un modèle, puis appuyez sur Suivant.

  3. Dans l’onglet De base :

    1. Précisez les Nom et Titre pour le formulaire adaptatif.

    2. Sélectionnez le conteneur de configurations créé lors de l’ DocuSign intégration d’ à AEM Forms.
      Le conteneur de configurations contient les services DocuSign Cloud Services configurés pour votre environnement. Ces services peuvent être sélectionnés dans l’éditeur de formulaires adaptatifs.

  4. Dans l’onglet Modèle de formulaire, sélectionnez l’une des options suivantes :

    • Si vous disposez d’un modèle de formulaire personnalisé et que vous avez besoin d’un document d’enregistrement basé sur le modèle de formulaire, sélectionnez l’option Associer le modèle de formulaire en tant que modèle de document d’enregistrement, puis un modèle de document d’enregistrement. Lorsque vous utilisez cette option, les documents envoyés pour signature n’affichent que les champs basés sur le modèle de formulaire associé. Ils n’affichent pas tous les champs du formulaire adaptatif.

    • Si vous ne disposez pas d’un modèle de formulaire personnalisé, sélectionnez l’option Générer un document d’enregistrement. Lorsque vous utilisez cette option, le document envoyé pour signature affiche tous les champs du formulaire adaptatif.

  5. Appuyez sur Créer. Un formulaire adaptatif prenant en charge les signatures est créé. Vous pouvez y ajouter vos champs DocuSign et envoyer le formulaire pour signature.

  6. Ouvrez le formulaire adaptatif en mode d’édition. Dans l’onglet Contenu, appuyez sur Conteneur de formulaires et appuyez sur Configurer.

  7. Dans la section Envoi, sélectionnez Envoyer avec les signatures électroniques DocuSign dans la liste déroulante Action d’envoi.

  8. Dans la section Configuration d’action, appuyez sur Ajouter pour ajouter un destinataire et indiquer son adresse e-mail. Appuyer de nouveau sur Ajouter pour ajouter d’autres destinataires.

  9. Indiquez l’objet de l’e-mail dans le champ Objet du message. Sélectionnez Inclure des pièces jointes pour inclure des pièces jointes à l’e-mail.

  10. Appuyez sur Enregistrer pour enregistrer les propriétés.

Activation d’DocuSign pour un formulaire adaptatif

Pour utiliser DocuSign dans un formulaire adaptatif existant :

  1. Accédez à Adobe Experience Manager > Formulaires > Formulaires et documents.

  2. Sélectionnez le document adaptatif et appuyez sur Propriétés.

  3. Dans l’onglet De base, sélectionnez le conteneur de configurations créé lors de l’intégration d’DocuSign à AEM Forms.

  4. Dans l’onglet Modèle de formulaire, sélectionnez l’une des options suivantes :

    • Si vous disposez d’un modèle de formulaire personnalisé et que vous avez besoin d’un document d’enregistrement basé sur le modèle de formulaire, sélectionnez l’option Associer le modèle de formulaire en tant que modèle de document d’enregistrement, puis un modèle de document d’enregistrement. Lorsque vous utilisez cette option, les documents envoyés pour signature n’affichent que les champs basés sur le modèle de formulaire associé. Ils n’affichent pas tous les champs du formulaire adaptatif.

    • Si vous ne disposez pas d’un modèle de formulaire personnalisé, sélectionnez l’option Générer un document d’enregistrement. Lorsque vous utilisez cette option, le document envoyé pour signature affiche tous les champs du formulaire adaptatif.

  5. Appuyez sur Enregistrer et fermer. Le formulaire adaptatif est activé pour DocuSign. Vous pouvez maintenant y ajouter vos champs DocuSign et envoyer le formulaire pour signature.

  6. Ouvrez le formulaire adaptatif en mode d’édition. Dans l’onglet Contenu, appuyez sur la touche Conteneur de formulaires et appuyez sur Configurer.

  7. Dans la section Envoi, sélectionnez Envoyer avec les signatures électroniques DocuSign de la liste déroulante Action d’envoi.

  8. Dans la section Configuration d’action, appuyez sur Ajouter pour ajouter un destinataire et indiquer son adresse e-mail. Appuyez sur Ajouter pour ajouter d’autres destinataires.

  9. Indiquez l’objet de l’e-mail dans le champ Objet du message. Sélectionnez Inclure des pièces jointes pour inclure des pièces jointes à l’e-mail.

  10. Appuyez sur Enregistrer pour enregistrer les propriétés.

Sur cette page