Utilisation de DocuSign avec un formulaire adaptatif integrate-aem-forms-with-DocuSign

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.

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.

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

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> :

   code language-shell
   <repository.location>maven_repository</repository.location>

2. Ajoutez le texte suivant à la fin de la balise <repositories> :

   code language-shell
   <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> :

   code language-shell
   <dependency> <groupId>com.adobe.aemforms.samples</groupId> <artifactId>forms.integration.docusign.all</artifactId> <type>zip</type> <version>1.0.0</version> </dependency>

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> :

   code language-shell
   <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> :

   code language-shell
   <dependency> <groupId>com.adobe.aemforms.samples</groupId> <artifactId>forms.integration.docusign.all</artifactId> <type>zip</type> </dependency>

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.

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.

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

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

Sur la page des configurations, sélectionnez Créer pour créer DocuSign dans AEM Forms.

Dans le Général de la Création d’une configuration DocuSign , spécifiez une Nom pour la configuration, puis sélectionnez Suivant. Vous pouvez éventuellement spécifier un Titre.

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.

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.

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

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

Sélectionner Connexion à 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.

Sélectionner Créer pour créer la variable DocuSign configuration.

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.

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.

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

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

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.

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.

Sélectionner Créez. Un formulaire adaptatif prenant en charge les signatures est créé. Vous pouvez y ajouter vos champs DocuSign et envoyer le formulaire pour signature.

Ouvrez le formulaire adaptatif en mode d’édition. Dans le Contenu , sélectionnez l’onglet Conteneur de formulaires et sélectionnez .

Dans le Envoi , sélectionnez Envoyer avec les signatures électroniques DocuSign de la Action Envoyer liste déroulante.

Dans le Configuration d’action , sélectionnez Ajouter pour ajouter un destinataire et indiquer son adresse email. Sélectionner Ajouter pour ajouter d’autres destinataires.

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.

Sélectionner pour enregistrer les propriétés.

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

Sélectionnez le formulaire adaptatif et choisissez Propriétés.

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

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.

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

Ouvrez le formulaire adaptatif en mode d’édition. Dans le Contenu , sélectionnez l’onglet Conteneur de formulaires et sélectionnez .

Dans le Envoi , sélectionnez Envoyer avec les signatures électroniques DocuSign de la Action Envoyer liste déroulante.

Dans le Configuration d’action , sélectionnez Ajouter pour ajouter un destinataire et indiquer son adresse email. Sélectionner Ajouter pour ajouter d’autres destinataires.

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.

Sélectionner pour enregistrer les propriétés.