Documentation AEM as a Cloud Service Guide de l’utilisateur

Connecter AEM Forms as a Cloud Service avec Adobe Acrobat Sign integrate-adobe-sign-with-aem-forms

Last update: Thu Nov 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

Intermédiaire
Administration
Utilisateur ou utilisatrice

Version

Lien de l’article

AEM 6.5

Cliquez ici

AEM as a Cloud Service

Cet article

Adobe Acrobat Sign active des workflows de signature électronique pour les formulaires adaptatifs et les workflows AEM. 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
Connecter AEM Forms à Adobe Acrobat Sign Solutions pour le gouvernement

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 conditions préalables et configurez Adobe Sign Cloud Service dans vos instances de création et de publication Forms as a Cloud Service

Conditions préalables à la connexion d’AEM Forms à Adobe Acrobat Sign prerequisites-for-adobe-sign

Vous avez besoin de la configuration suivante pour intégrer Adobe Acrobat Sign à AEM Forms :

Un compte de développement Adobe Acrobat Sign actif.
Une application API Adobe Acrobat Sign.
Les informations d’identification (ID client et clé secrète client) de l’application API Adobe Acrobat Sign.
(Uniquement pour l’authentification basée sur l’ID du gouvernement) Activez la méthode d’authentification pour l’authentification de l’ID du gouvernement.

Connecter les instances de création et de publication AEM Forms à Adobe Acrobat Sign configure-adobe-sign-with-aem-forms

Une fois les prérequis réunis, procédez comme suit pour configurer Adobe Acrobat Sign avec AEM Forms sur les instances d’auteur.

Dans l’instance de création AEM Forms, accédez à Outils > Général > Navigateur de configuration.
Sur la page du navigateur de configuration, sélectionnez Créer.
Dans la boîte de dialogue Créer une configuration, indiquez un titre pour la configuration, activez Configurations cloud et sélectionnez Créer. Un conteneur de configurations pour Cloud Services est ainsi créé. Vérifiez que le nom du dossier ne contient aucun espace.

Accédez à Outils > Services cloud > Adobe Sign et ouvrez le conteneur de configurations que vous avez créé à l’étape précédente.

note note
NOTE
Lorsque vous créez un formulaire adaptatif, indiquez le nom du conteneur dans le champ Conteneur de configurations.

Sur la page de configuration, sélectionnez Créer pour créer une configuration Adobe Acrobat Sign dans AEM Forms.
Dans l’onglet Général de la page Créer une configuration Adobe Acrobat Sign, spécifiez un Nom pour la configuration, puis sélectionnez Suivant. Vous avez la possibilité d’indiquer un titre et de rechercher et sélectionner une vignette pour la configuration.
Maintenant, vous pouvez sélectionner une solution pour sélectionner Adobe Acrobat Sign.
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. Sélectionnez Suivant.

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.

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

Ouvrez une fenêtre de navigateur et connectez-vous au compte de développeur Adobe Acrobat Sign.
Sélectionnez l’application configurée pour AEM Forms, puis Configurer OAuth pour l’application.
Dans la zone URL de redirection, ajoutez l’URL copiée à l’étape précédente (étape 8) et cliquez sur Enregistrer.
Activez la Portée suivante pour l’application Adobe Acrobat Sign et cliquez sur Enregistrer.

aggrement_read
aggrement_write
aggrement_send
widget_read
widget_write
workflow_read

note note
NOTE
Vous pouvez modifier le modificateur de portées de `self` à `account` directement depuis l’interface utilisateur d’AEM, comme indiqué à l’étape 12.

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

Configuration OAuth

Revenez à la page Créer une configuration Adobe Acrobat 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 Acrobat Sign que vous avez créés à l’étape précédente.
Dans la section Domaine de l’autorisation, vous pouvez modifier les portées en "compte" ou "moi" en ajoutant le préfixe "moi" ou "compte" aux portées, si nécessaire.
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.
Sélectionnez Se connecter à Adobe Acrobat Sign. Lorsque vous devez 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 devez confirmer l’accès à your developer account, 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.
Sélectionnez Créer pour créer la configuration Adobe Acrobat Sign.
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’Adobe Acrobat Sign avec AEM Forms pour votre environnement.

Vous pouvez maintenant utiliser l’ajout de champs Adobe Acrobat Sign à un formulaire adaptatif. Veillez à ajouter le conteneur de configurations utilisé pour Cloud Service à 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.

NOTE

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

Résolution des problèmes resolve-config-error

Lorsque vous vous connectez à Adobe Acrobat Sign avec AEM Forms et recherchez une erreur Unable to authorize access because the client configuration is invalid: invalid_request comme illustré dans l'image ci-dessous. Pour résoudre ce problème, procédez comme suit :

Erreur de configuration

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.
Ouvrez une fenêtre de navigateur et connectez-vous au compte de développeur Adobe Acrobat Sign.
Sélectionnez l’application configurée pour AEM Forms, puis Configurer OAuth pour l’application.
Dans la zone Redirect URL, ajoutez l’URL copiée à l’étape précédente et cliquez sur Enregistrer.

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

Processus gouvernemental Adobe Sign

AEM Forms as a Cloud Service fournit des environnements de développement, d’évaluation et de production. Vous pouvez commencer par connecter votre environnement de développement avec Adobe Acrobat Sign Solutions pour le gouvernement et connecter ultérieurement les environnements d’évaluation et de production.

Avant de commencer prerequisites-for-adobe-sign-for-acrobat-sign-for-government

Avant de commencer à connecter AEM Forms à la solution Adobe Acrobat Sign, assurez-vous que le compte Adobe Acrobat Sign Solutions pour le gouvernement est configuré.

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

Créer une URL de redirection pour votre instance AEM

Sur l’instance de création Forms as a Cloud Service, accédez à Outils > Général > Explorateur de configurations.
Dans la page Navigateur de configuration, sélectionnez Créer.
Dans la boîte de dialogue Créer une configuration, indiquez un titre pour la configuration, activez Configurations du cloud et choisissez Créer. Un conteneur de configurations pour stocker Cloud Services est ainsi créé. Vérifiez que le nom du dossier ne contient aucun espace.
Accédez à Outils > 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.
Sur la page de configuration, sélectionnez Créer pour créer une configuration Adobe Acrobat Sign dans AEM Forms.
Copiez l’URL de votre fenêtre de navigateur actuelle dans un bloc-notes et supprimez /ui#/aem de l’URL. Cette URL est appelée re-direct URL.
Dans la section suivante, partagez l’re-direct URL et les Scopes avec l’équipe Adobe Sign et demandez des informations d’identification (identifiant client et secret client).

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 l’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

aggrement_read
aggrement_write
aggrement_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

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.
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.
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.
Dans le champ E-mail, indiquez l’adresse e-mail associée à votre compte Adobe Acrobat Sign Solutions pour le gouvernement.

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

note note
NOTE
Après vous être connecté à 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.

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].
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.
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é à confirmer l’accès à your developer account, 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.
Sélectionnez Créer pour créer la configuration.
Sélectionnez la configuration, cliquez sur Publier, sélectionnez la configuration, puis cliquez sur Publier. La configuration est 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’Adobe Acrobat Sign Solutions for Government avec AEM Forms pour votre environnement.

Vous pouvez maintenant utiliser l’ajout de champs Adobe Acrobat Sign dans un formulaire adaptatif ou dans un workflow 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 Acrobat Sign pour synchroniser l’état de signature configure-adobe-sign-scheduler-to-sync-the-signing-status

AEM Forms as a Cloud Service fournit un service de planificateur qui vérifie l’état des signataires à des intervalles définis. Les scénarios dans lesquels vous configurez le service du planificateur :

Si vous utilisez Envoyer le formulaire (une fois que chaque destinataire a terminé la cérémonie de signature) pour signer un document, le formulaire est envoyé uniquement après que tous les signataires ont signé le formulaire.
Si vous utilisez l’ étape de signature dans un processus AEM pour signer un document, l’étape de signature attend que tous les signataires signent le document, avant de passer à l’étape suivante du processus.

Par défaut, les services de Planificateur Adobe Acrobat Sign vérifient la réponse du signataire (sondages) toutes les 24 heures. Vous pouvez modifier l’intervalle par défaut pour votre environnement.

Pour modifier l’intervalle par défaut, spécifiez une expression cron pour la propriété sign.status.exp de la configuration Service de configuration Adobe Sign.

Par exemple, pour exécuter le service de configuration tous les jours à 00:00, définissez la propriété sign.status.exp de la configuration Service de configuration Adobe Sign pour spécifier 0 0 0 1/1 * ? *. Le fichier JSON suivant affiche l’échantillon d’exécution du service de configuration tous les jours à 00:00 :

{
  "sign.status.exp":"0 0 0 1/1 * ? *"
}

Pour définir les valeurs d’une configuration, générez des configurations OSGi à l’aide du SDK AEM et déployez la configuration sur votre instance de Cloud Service.

Questions fréquentes

Q : Puis-je effectuer le rendu de la page Adobe Sign GovCloud Signature dans un iframe ?
A : Oui, vous pouvez afficher la page Adobe Sign GovCloud Signature dans un iframe.

recommendation-more-help

fbcff2a9-b6fe-4574-b04a-21e75df764ab