Intégrer Adobe Signavec AEM Forms

Dernière mise à jour : 2023-11-07
  • Créé pour :
  • User

Adobe recommande d’utiliser la capture de données moderne et extensible. Composants principaux pour création d’un Forms adaptatif ou Ajout de Forms adaptatif à des pages AEM Sites. Ces composants représentent une avancée significative dans la création de Forms adaptatif, ce qui garantit des expériences utilisateur impressionnantes. Cet article décrit l’approche plus ancienne de la création de Forms adaptatif à l’aide de composants de base.

Version Lien de l’article
AEM as a Cloud Service Cliquez ici
AEM 6.5 Cet article

Adobe Sign permet des processus de signature électronique pour les formulaires adaptatifs. Les signatures électroniques améliorent les processus de traitement des documents pour les services juridiques, commercial, des ressources humaines, et bien d’autres domaines.

Dans un scénario Adobe Acrobat Sign et de formulaires adaptatifs standard, un utilisateur remplit un formulaire adaptatif pour effectuer une demande de service. Par exemple, un formulaire de demande de carte bancaire et d’allocation. Lorsqu’un utilisateur ou une utilisatrice remplit, envoie et signe le formulaire de demande, le formulaire est envoyé au fournisseur de services pour qu’il effectue d’autres actions. Le prestataire de services passe en revue la demande et utilise Adobe Acrobat Sign pour marquer la demande comme approuvée. AEM Forms prend en charge Adobe Acrobat Sign et Adobe Acrobat Sign Solutions pour le gouvernement. En fonction de votre licence et de vos besoins, vous pouvez intégrer ou connecter AEM Forms à l’une des solutions suivantes :

Connecter AEM Forms à Adobe Acrobat Sign

Pour connecter AEM Forms à Adobe Acrobat Sign, configurez le logiciel et les comptes répertoriés dans la section des prérequis et connectez Adobe Sign à toutes vos instances de création et de publication d’AEM Forms :

Prérequis

Vous avez besoin des éléments suivants pour intégrer Adobe Sign à AEM :Forms

  • Un compte de développeur Adobe Sign actif.
  • Un serveur AEM SSL.Forms
  • Une application API Adobe Sign.
  • Les informations d’identification (ID client et clé secrète client) de l’application API Adobe Sign.
  • Lors de la reconfiguration, supprimez la configuration Adobe Sign à partir des instances de création et de publication.
  • Une crypto-clé identique pour les instances d’auteur et de publication.

Configurer Adobe Sign avec AEM Forms

Une fois les conditions préalables en place, procédez comme suit pour configurer Adobe Signavec AEM Forms sur l’instance de création :

  1. Dans Formsl’instance de création AEM, accédez à Outils marteau > Généralités > Navigateur de configuration.

  2. Sur la page du navigateur de configuration, appuyez sur Créer.

  3. Dans la boîte de dialogue Créer une configuration, indiquez un titre pour la configuration, activez Configurations cloud et appuyez sur Créer. Cela crée un conteneur de configuration.

  4. Accédez à Outils marteau > Cloud Services > Adobe Sign et sélectionnez le conteneur de configuration que vous avez créé à l’étape précédente.

    REMARQUE

    Vous pouvez exécuter les étapes 1 à 4 pour créer un conteneur de configuration et créer une Adobe Sign Configuration dans le conteneur ou utilisation de la global dossier dans Outils marteau > Cloud Service > Adobe Sign. Si vous créez la configuration dans le nouveau conteneur de configuration, veillez à spécifier le nom du conteneur dans le champ Conteneur de configuration lorsque vous créez un formulaire adaptatif.

    REMARQUE

    Vérifiez que l’URL de la page de configuration des services cloud commence par HTTPS. Si ce n’est pas le cas, activez SSL pour le serveur AEM Forms

  5. Sur la page de configuration, appuyez sur Créer pour créer Adobe Sign une configuration dans AEM Forms.

  6. Dans l’onglet Généralités de la page Créer une configuration Adobe Sign, spécifiez un Nom de configuration et appuyez sur Suivant. Vous avez la possibilité d’indiquer un titre et de rechercher et de sélectionner une vignette pour la configuration.

  7. Copiez l’URL dans la fenêtre active du navigateur dans un bloc-notes. Vous en avez besoin pour configurer l’application Adobe Sign avec AEM Forms.

  8. Dans l’onglet Paramètres, le champ URL OAuth indique l’URL par défaut. Le format de l’URL est:

    https://<shard>/public/oAuth/v2

    Par exemple :
    https://secure.na1.echosign.com/public/oauth/v2

    où :

    na1 fait référence au partitionnement de base de données par défaut. Vous pouvez modifier la valeur du partitionnement de base de données. Assurez-vous que les configurations cloud de ​ Adobe Sign pointent vers le fragment correct.

    Si vous créez une autre configuration Adobe Sign pour une fonctionnalité ou un composant Adobe Experience Manager, assurez-vous que toutes les configurations cloud de Adobe Sign pointent vers le même fragment.

    REMARQUE

    Gardez la page Créer une configuration Adobe Sign ouverte. Ne la fermez pas. Vous pouvez récupérer l’ID client et le secret client après la configuration des paramètres OAuth pour l’application Adobe Sign comme décrit dans les étapes à venir.

  9. Configurez les paramètres OAuth pour l’application Adobe Sign :

    1. Ouvrez une fenêtre de navigateur et connectez-vous au compte de développeur Adobe Sign.
    2. Sélectionnez l’application configurée pour AEM Forms, puis appuyez sur Configurer OAuth pour l’application.
    3. Copiez l’ID client et le Secret du client vers un bloc-notes.
    4. Dans la zone URL de redirection, ajoutez l’URL HTTPS copiée à l’étape précédente.
    5. Activez les paramètres OAuth suivants pour l’application Adobe Sign et cliquez sur Enregistrer.
    • agreement_read
    • agreement_write
    • agreement_send
    • widget_write
    • workflow_read

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

    Configuration OAuth

  10. Revenez à la page Créer une configuration Adobe Sign. Dans l’onglet Paramètres, le champ URL OAuth indique l’URL par défaut. Le format de l’URL est:

    https://<shard>/public/oAuth/v2

    Par exemple :
    https://secure.na1.echosign.com/public/oauth/v2

    où :

    na1 fait référence au partitionnement de base de données par défaut.

    Vous pouvez modifier la valeur du partitionnement de base de données. Redémarrez le serveur pour pouvoir utiliser la nouvelle valeur pour le partitionnement de base de données.

    REMARQUE

    Assurez-vous que les configurations des instances d’auteur et de publication pointent vers la même partition. Si vous créez plusieurs configurations Adobe Sign pour une organisation, assurez-vous que toutes utilisent la même partition.

  11. Revenez à la page Créer une configuration Adobe Sign. Dans l’onglet Paramètres, spécifiez l’ID client (également appelé ID de l’application) et le secret client. Utilisez l’ID client et le secret client de l’application Adobe Sign créés pour AEM Forms.

  12. Sélectionnez l’option Activer pour les pièces jointes également pour ajouter les fichiers joints à un formulaire adaptatif au document Adobe Sign correspondant envoyé à des fins de signature.Adobe Sign

  13. Appuyez sur Se connecter à Adobe Sign. 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 Adobe Sign.

  14. Appuyez sur Créer pour créer la configuration Adobe Sign.

  15. Ouvrez la console Web AEM. L’URL est https://'[server]:[port]'/system/console/configMgr

  16. Ouvrez le service de configuration commun aux formulaires.

  17. Dans le champ Autoriser, sélectionnez Tous les utilisateurs : tous les utilisateurs, anonymes ou connectés, peuvent afficher un aperçu des pièces jointes, vérifier et signer des formulaires, puis cliquez sur Enregistrer. L’instance d’auteur est configurée pour utiliser Adobe Sign.

  18. Publiez la configuration.

  19. Utilisez la réplication pour créer une configuration identique sur les instances de publication correspondantes.

Adobe Sign est désormais intégré à AEM Forms et prêt à être utilisé dans les formulaires adaptatifs. Pour utiliser le service Adobe Sign dans un formulaire adaptatif, spécifiez le conteneur de configuration créé ci-dessus dans les propriétés du formulaire adaptatif.

Connecter AEM Forms à Adobe Acrobat Sign Solutions pour le gouvernement

La connexion d’AEM Forms à Adobe Acrobat Sign Solutions pour le gouvernement est un processus en plusieurs étapes. Ce processus implique :

  • la création de l’URL de redirection pour vos instances AEM ;
  • le partage de l’URL de redirection et des champs d’application avec l’équipe Adobe Sign Solutions pour le gouvernement ;
  • la réception des informations d’identification de l’équipe Adobe Sign ;
  • l’utilisation des informations d’identification reçues pour connecter AEM Forms à Adobe Acrobat Sign Solutions pour le gouvernement

adobe-acrobat-sign-govt-workflow

Avant de commencer

Avant de commencer à connecter AEM Forms à Adobe Acrobat Sign Solutions :

Connecter AEM Forms à Adobe Acrobat Sign Solutions pour le gouvernement

Créer une URL de redirection pour votre instance AEM

  1. Dans votre instance AEM Forms, accédez à Outils marteau > Général > Navigateur de configurations.

  2. Sur la page du navigateur de configuration, appuyez sur Créer.

  3. Dans la boîte de dialogue Créer une configuration, indiquez un titre pour la configuration, activez Configurations cloud et appuyez sur Créer. Cela crée un conteneur de configuration. Vérifiez que le nom du conteneur/dossier ne contient aucun espace.

  4. Accédez à Outils marteau > Services cloud > Adobe Acrobat Sign et ouvrez le conteneur de configurations que vous avez créé à l’étape précédente. Lorsque vous créez un formulaire adaptatif, indiquez le nom du conteneur dans le champ Conteneur de configurations.

  5. Sur la page de configuration, appuyez sur Créer pour créer une configuration Adobe Acrobat Sign dans AEM Forms.

  6. Copiez l’URL de votre fenêtre de navigateur actuelle dans un bloc-notes à partir de l’URL. Cette URL est appelée re-direct URL. Dans la section suivante, partagez la re-direct URL et les Scopes avec l’équipe Adobe Sign et demandez des informations d’identification (identifiant client et secret client).

REMARQUE
  • Une re-direct URL doit contenir un domaine de niveau supérieur. Par exemple, https://adobe.com/libs/adobesign/cloudservices/adobesign/createcloudconfigwizard/cloudservices.html/conf/global.
  • N’utilisez pas d’URL locale en tant que re-direct URL. Par exemple, https://localhost:4502/libs/adobesign/cloudservices/adobesign/createcloudconfigwizard/cloudservices.html/conf/global.

Partager l’URL de redirection et les champs d’application avec l’équipe Adobe Sign et recevoir des informations d’identification

L’équipe Adobe Acrobat Sign for Government Solutions a besoin des re-direct URL et les portées spécifiques à activer pour votre application Adobe Acrobat Sign (répertoriées ci-dessous) pour générer les informations d’identification (identifiant client et secret client) qui vous permettent de connecter AEM Forms à Adobe Acrobat Sign Solutions for Government.

Partagez les scopes (répertoriés ci-dessous) et la re-direct URL créés et notés à la dernière étape de la section précédente avec votre personne représentante d’Adobe Acrobat Sign Solution pour le gouvernement membre de l’équipe Adobe Professional Services.

Portées

  • agreement_read
  • agreement_write
  • agreement_send
  • widget_read
  • widget_write
  • workflow_read
  • offline_access

La personne représentante génère et partage alors les informations d’identification avec vous. Dans la section suivante, utilisez les informations d’identification (identifiant client et secret client) pour connecter AEM Forms à Adobe Acrobat Sign Solutions pour le gouvernement.

Utiliser des informations d’identification reçues pour connecter AEM Forms à Adobe Acrobat Sign Solutions pour le gouvernement

  1. Ouvrez l’re-direct URL dans votre navigateur. Vous avez créé et noté l’re-direct URL dans la dernière étape de la section de création d’une URL de redirection sur votre instance AEM.

  2. Dans l’onglet Général de la page Créer une configuration Adobe Sign, spécifiez un nom de configuration et appuyez sur Suivant. Vous avez la possibilité d’indiquer un titre et de rechercher et sélectionner une vignette pour la configuration. Cliquez sur Suivant.

  3. Dans l’onglet Paramètres de la page Créer une configuration Adobe Sign, pour l’option Sélectionner une solution, sélectionnez Adobe Acrobat Sign Solutions for Government.

    Adobe Acrobat Sign Solutions pour le gouvernement

  4. Dans le champ E-mail, indiquez l’adresse e-mail associée à votre compte Adobe Acrobat Sign Solutions pour le gouvernement.

  5. Le champ URL OAuth spécifie le partitionnement de base de données Adobe Sign. Le champ contient l’URL par défaut. Ne modifiez pas l’URL.

  6. Utilisez les informations d’identification partagées par le représentant ou la représentante Adobe Acrobat Sign Solutions pour le gouvernement ([membre de l’équipe Adobe Professional Services]) dans la section précédente en tant que [ID client et Secret client].

  7. Sélectionnez l’option Activer Adobe Acrobat Sign pour les pièces jointes pour ajouter les fichiers joints à un formulaire adaptatif au document Adobe Acrobat Sign correspondant envoyé à des fins de signature.

  8. Appuyez sur Se connecter à Adobe Sign. 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 Adobe Acrobat Sign. Lorsque vous êtes invité.e à confirmer l’accès à Adobe Acrobat Sign for Government Solutions, cliquez sur Autoriser l’accès. Si les informations d’identification sont correctes et que vous autorisez AEM Forms à accéder à votre compte de développement Adobe Acrobat Sign, un message, semblable à celui ci-dessous, s’affiche pour vous notifier le succès de l’opération.

    Succès de la configuration Adobe Acrobat Sign Cloud

    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 Adobe Acrobat Sign. Lorsque vous êtes invité.e à confirmer l’accès à your account, cliquez sur Autoriser l’accès.

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

  10. Ouvrez la console Web AEM. L’URL est https://'[server]:[port]'/system/console/configMgr

  11. Ouvrez le service de configuration commun aux formulaires.

  12. Dans le champ Autoriser, sélectionnez Tous les utilisateurs : tous les utilisateurs, anonymes ou connectés, peuvent afficher un aperçu des pièces jointes, vérifier et signer des formulaires, puis cliquez sur Enregistrer. L’instance d’auteur est configurée pour utiliser Adobe Sign.

  13. Publiez la configuration.

  14. Utilisez la réplication pour créer une configuration identique sur les instances de publication correspondantes.

Vous pouvez maintenant utiliser l’ajout de champs Adobe Acrobat Sign dans un formulaire adaptatif ou dans un Processus AEM. Veillez à ajouter le conteneur de configurations utilisé pour la configuration du service cloud à tous les formulaires adaptatifs activés pour Adobe Acrobat Sign. Vous pouvez spécifier un conteneur de configurations à partir des propriétés d’un formulaire adaptatif.

Configurer le planificateur Adobe Sign pour synchroniser l’état de signature

Un formulaire adaptatif avec activation d’Adobe Sign n’est envoyé que lorsque tous les signataires ont terminé le processus de signature. Par défaut, les services du planificateur Adobe Sign sont configurés pour vérifier (interroger) la réponse du signataire toutes les 24 heures. Vous pouvez modifier l’intervalle par défaut pour votre environnement. Procédez comme suit pour modifier l’intervalle par défaut :

  1. Connectez-vous au serveur d’AEM Forms à l’aide de vos informations d’identification d’administrateur et accédez à Outils > Opérations > Console web.

    Vous pouvez également ouvrir l’URL suivante dans une fenêtre de navigateur :
    https://[localhost]:'port'/system/console/configMgr

  2. Recherchez et ouvrez l’option Service de configuration Adobe Sign. Spécifiez une expression cron dans le champ Expression du planificateur de mise à jour de l’état et cliquez sur Enregistrer. Par exemple, pour exécuter le service de configuration tous les jours à minuit, indiquez 0 0 0 1/1 * ? * dans le champ Expression du planificateur de mise à jour de l’état.

L’intervalle par défaut pour synchroniser l’état d’Adobe Sign est désormais modifié.

Sur cette page