DocumentationAEM 6.5Guide de l’utilisateur

Intégrer Adobe Sign à AEM Forms integrate-adobe-sign-with-aem-forms

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :

Créé pour :

  • Administration
  • Utilisateur ou utilisatrice
  • Développeur

Adobe recommande d’utiliser les composants principauxde capture de données modernes et extensibles pour créer de nouveaux formulaires adaptatifsou ajouter des formulaires adaptatifs à des pages AEM Sites. Ces composants représentent une avancée significative dans la création de formulaires adaptatifs, ce qui garantit des expériences utilisateur impressionnantes. Cet article décrit l’ancienne approche de la création de formulaires adaptatifs à 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 adobe-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 prerequisites

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 configure-adobe-sign-with-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 Navigateur de configuration, sélectionnez Créer.

  3. Dans la boîte de dialogue Créer une configuration, spécifiez un Titre pour la configuration, activez Configurations cloud et sélectionnez 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.

    note note
    NOTE
    Vous pouvez exécuter les étapes 1 à 4 pour créer un nouveau conteneur de configuration et créer une configuration Adobe Sign dans le conteneur ou utiliser le dossier global dans Outils Marteau > Services cloud > 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.
    note note
    NOTE
    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. Maintenant, vous pouvez sélectionner une solution pour sélectionner Adobe Acrobat Sign.

    Adobe Acrobat Sign Solutions

  8. Copiez l’URL présente dans la fenêtre de votre navigateur actuel dans un bloc-notes et supprimez la partie /ui#/aem de l’URL. L’URL modifiée est nécessaire pour configurer l’application Adobe Acrobat Sign avec AEM Forms à une étape ultérieure. Appuyez sur Suivant.

  9. Dans l’onglet Paramètres,

    • le champ URL OAuth contient l’URL par défaut qui inclut le partitionnement de base de données Adobe Sign. Le format de l’URL est:

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

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

    • le champ URL du jeton d’accès contient l’URL par défaut qui inclut le partitionnement de base de données Adobe Sign. Le format de l’URL est:

      https://<shard>/oauth/v2/token

      Par exemple :
      https://api.na1.echosign.com/oauth/v2/token

    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 Acrobat Sign pointent vers le fragment correct.

    note note
    NOTE
    • 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 Acrobat Sign comme décrit dans les étapes à venir.
    • Après votre connexion à votre compte Adobe Sign, accédez à API Acrobat Sign > Informations sur l’API > Documentation sur les méthodes d’API REST > Jeton d’accès OAuth pour accéder aux informations relatives à l’URL OAuth d’Adobe Sign et à l’URL du jeton d’accès.

  10. 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 choisissez 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

  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 Adobe Sign pour les pièces jointes également pour ajouter les fichiers joints à un formulaire adaptatif au document Adobe Sign correspondant envoyé à des fins de signature.

  13. Sélectionnez Se connecter à Adobe Sign. Lorsqu’il vous est demandé de 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.

    Succès de la configuration Adobe Acrobat Sign Cloud

  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.

NOTE
Pour configurer le sandbox Adobe Sign, vous pouvez suivre les mêmes étapes de configuration que celles décrites dans Adobe Sign.

Connecter AEM Forms à Adobe Acrobat Sign Solutions pour le gouvernement adobe-acrobat-sign-for-government

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 prerequisites-for-adobe-sign-for-acrobat-sign-for-government

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

Connecter AEM Forms à Adobe Acrobat Sign Solutions pour le gouvernement connect-adobe-acrobat-sign-for-government

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. Dans la page Navigateur de configuration, sélectionnez Créer.

  3. Dans la boîte de dialogue Créer une configuration, indiquez un titre pour la configuration, activez Configurations du cloud et choisissez 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, sélectionnez 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).

NOTE
  • 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 Solutions pour le gouvernement exige que la re-direct URL et certains champs d’application soient activés pour votre application Adobe Acrobat Sign (répertoriés ci-dessous) afin de générer les informations d’identification (identifiant client et secret client) qui vous permettent de connecter AEM Forms à Adobe Acrobat Sign Solutions pour le gouvernement.

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 sélectionnez 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. Dans l’onglet Paramètres,

    • le champ URL OAuth contient l’URL par défaut qui inclut le partitionnement de base de données Adobe Sign. Le format de l’URL est:

      https://<shard>/api/gateway/adobesignauthservice/api/v1/authorize

      Par exemple :
      https://secure.na1.adobesign.us/api/gateway/adobesignauthservice/api/v1/authorize

    • le champ URL du jeton d’accès contient l’URL par défaut qui inclut le partitionnement de base de données Adobe Sign. Le format de l’URL est:

      https://<shard>/api/gateway/adobesignauthservice/api/v1/token

      Par exemple :
      https://secure.na1.adobesign.us/api/gateway/adobesignauthservice/api/v1/token

    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 Acrobat Sign pointent vers le fragment correct.

    note note
    NOTE
    • Après votre connexion à votre compte Adobe Sign, accédez à API Acrobat Sign  >  Informations sur l’API  >  Documentation sur les méthodes d’API REST  >  Jeton d’accès OAuth pour accéder aux informations relatives à l’URL oAuth d’Adobe Sign et à l’URL du jeton d’accès.

  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. Sélectionnez Se connecter à Adobe Sign. Lorsqu’il vous est demandé de 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. Sélectionnez 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 configure-adobe-sign-scheduler-to-sync-the-signing-status

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é.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2