DocumentationAEM 6.5Guide de l’utilisateur

Installer et configurer le site de référence We.Gov et We.Finance set-up-and-configure-we-gov-reference-site

Last update: Fri Apr 05 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Détails du package de démonstration demo-package-details

Conditions préalables à l’installation installation-prerequisites

Ce package a été créé pour l’auteur OSGi AEM Forms 6.4. Il a été testé et est donc pris en charge sur les versions de plateforme suivantes :

VERSION D’AEM
VERSION DU PACKAGE AEM FORMS
ÉTAT
6.4
5.0.86
Pris en charge
6.5
6.0.80
Pris en charge
6.5.3
6.0.122
Pris en charge

Ce package contient la configuration cloud qui prend en charge les versions de plateforme suivantes :

FOURNISSEUR DE CLOUD
VERSION DU SERVICE
ÉTAT
Adobe Sign
API v5
Pris en charge
Microsoft® Dynamics 365
1710 (9.1.0.3020)
Pris en charge
Adobe Analytics
API REST v1.4
Pris en charge
Considérations relatives à l’installation du package :
  • Installez le package sur un serveur propre, qui ne comporte pas d’autres packages de démonstration ou d’anciennes versions de packages de démonstration.
  • Installez le package sur un serveur OSGI, exécuté en mode Création.

Que comprend ce package ? what-does-this-package-include

Le package de démonstration AEM Forms We.Gov (we-gov-forms.pkg.all-<version>.zip) est fourni sous la forme d’un package qui comprend plusieurs autres sous-packages et services. Le package inclut les packages suivants :

  • we-gov-forms.pkg.all-<version>.zip  : package de démonstration complet.

    • we-gov-forms.ui.apps-<version>.zip  : contient tous les composants, bibliothèques clientes, exemples d’utilisateurs, modèles de workflow, etc.

      • we-gov-forms.core-<version>.jar  : contient tous les services OSGi, l’implémentation par étapes de workflows personnalisés, etc.

      • we-gov-forms.derby<version>.jar  : contient tous les services OSGi, le schéma de base de données, etc.

      • core.wcm.components.all-2.0.4.zip  : collection d’exemples de composants WCM.

      • grid-aem.ui.apps-1.0-SNAPSHOT.zip  : package de disposition Grille AEM Sites pour le contrôle des colonnes des pages Sites.

    • we-gov-forms.ui.content-<version>.zip  : contient l’ensemble du contenu, des pages, des images, des formulaires, des ressources de communication interactive, etc.

    • we-gov-forms.ui.analytics-<version>.zip  : contient toutes les données d’analyse de formulaires We.Gov à stocker dans le référentiel.

    • we-gov-forms.config.public-<version>.zip  : contient tous les nœuds de configuration par défaut, y compris les configurations cloud d’espace réservé, pour éviter les problèmes de modèle de données de formulaire et de liaison de service.

Les ressources incluses dans ce package sont les suivantes :

  • Pages de site AEM avec modèles modifiables
  • Formulaires adaptatifs AEM Forms
  • Communications interactives AEM Forms (canal d’impression et web)
  • Document d’enregistrement XDP AEM Forms
  • Modèle de données de formulaire MS® Dynamics AEM Forms
  • Intégration d’Adobe Sign
  • Modèle de workflow AEM
  • Exemples d’images AEM Assets
  • Exemple de base de données Apache Derby (en mémoire)
  • Source de données Apache Derby (à utiliser avec le modèle de données de formulaire)

Installation du package de démonstration demo-package-installation

Cette section contient des informations sur l’installation du package de démonstration.

À partir de la distribution logicielle from-software-distribution

  1. Ouvrez la Distribution de logiciels. Vous avez besoin d’un Adobe ID pour vous connecter à la Distribution de logiciels.

  2. Sélectionnez Adobe Experience Manager situé dans le menu d’en-tête.

  3. Dans la section Filtres  :

    1. Sélectionnez Forms dans la liste déroulante Solution.
    2. Sélectionnez la version et le type du package. Vous pouvez également utiliser l’option  Rechercher des téléchargements  pour filtrer les résultats.

  4. Sélectionnez le nom du package we-gov-forms.pkg.all-<version>.zip, sélectionnez Accepter les termes du CLUF, puis Télécharger.

  5. Ouvrez Package Manager et cliquez sur  Télécharger le package  pour télécharger le package.

  6. Sélectionnez le package et cliquez sur  Installer.

    package de formulaires we gov

  7. Attendez la fin du processus d’installation.

  8. Accédez à https://<aemserver>:<port>/content/we-gov/home.html?wcmmode=disabled pour vérifier que l’installation a réussi.

À partir d’un fichier ZIP local from-a-local-zip-file

  1. Téléchargez et recherchez le fichier we-gov-forms.pkg.all-<version>.zip.

  2. Accédez à https://<aemserver>:<port>/crx/packmgr/index.jsp.

  3. Sélectionnez l’option « Télécharger le package ».

    Option de chargement de package

  4. Utilisez l’explorateur de fichiers pour accéder au fichier ZIP téléchargé et sélectionnez-le.

  5. Cliquez sur « Ouvrir » pour lancer le téléchargement.

  6. Une fois le téléchargement terminé, sélectionnez l’option « Installer » pour installer le package.

    Installer le package Forms WeGov

  7. Attendez la fin du processus d’installation.

  8. Accédez à https://<aemserver>:<port>/content/we-gov/home.html?wcmmode=disabled pour vérifier que l’installation a réussi.

Installer une nouvelle version de package installing-new-package-versions

Pour installer une nouvelle version de package, suivez les étapes définies aux points 4.1 et 4.2. Il est possible d’installer une version de package plus récente alors qu’un autre package plus ancien est installé. Il est toutefois recommandé de commencer par désinstaller l’ancienne version de package. Pour ce faire, procédez comme suit.

  1. Accédez à https://<serveur_aem>:<port>/crx/packmgr/index.jsp.

  2. Recherchez l’ancien fichier we-gov-forms.pkg.all-<version>.zip.

  3. Sélectionnez l’option « Plus ».

  4. Dans la liste déroulante, sélectionnez l’option « Désinstaller ».

    Désinstaller le package WeGov

  5. Lors de la confirmation, sélectionnez à nouveau « Désinstaller », puis attendez la fin du processus de désinstallation.

Configuration du package de démonstration demo-package-configuration

Cette section contient des informations détaillées et des instructions sur la configuration après le déploiement du package de démonstration avant présentation.

Configuration de l’utilisateur fictif fictional-user-configuration

  1. Accédez à https://<serveur_aem>:<port>/libs/granite/security/content/groupadmin.html.

  2. Connectez-vous en tant qu’administrateur ou administratrice pour effectuer les tâches ci-dessous.

  3. Faites défiler la page jusqu’à la fin pour charger tous les groupes d’utilisateurs ou d’utilisatrices.

  4. Recherchez «  workflow  ».

  5. Sélectionnez le groupe «  utilisateurs et utilisatrices du workflow  », puis cliquez sur « Propriétés ».

  6. Accédez à l’onglet « Membres ».

  7. Dans le champ « Sélectionner un utilisateur ou un groupe », saisissez wegov.

  8. Dans la liste déroulante, sélectionnez «  Utilisateurs We.Gov Forms  ».

    Modifier les paramètres de groupe pour les utilisateurs et utilisatrices du workflow

  9. Dans la barre de menus, cliquez sur « Enregistrer et fermer ».

  10. Répétez les étapes 2 à 7 en recherchant «  analytics  », en sélectionnant le groupe «  Administrateurs Analytics  », puis en ajoutant le groupe «  Utilisateurs We.Gov Forms  » en tant que membre.

  11. Répétez les étapes 2 à 7 en recherchant «  utilisateurs forms  », en sélectionnant le groupe «  forms-power-users  », puis en ajoutant le groupe «  Utilisateurs We.Gov Forms  » en tant que membre.

  12. Répétez les étapes 2 à 7 en recherchant «  forms-users  », en sélectionnant le groupe «  forms-users  », puis en ajoutant cette fois le groupe «  Utilisateurs We.Gov  » en tant que membre.

Configuration du serveur d’e-mail email-server-configuration

  1. Consulter la documentation sur la configuration Configurer la notification par e-mail

  2. Connectez-vous en tant qu’administrateur pour effectuer cette tâche.

  3. Accédez à https://<serveur_aem>:<port>/system/console/configMgr.

  4. Recherchez le Service de messagerie Day CQ, puis cliquez dessus pour le configurer.

    Configuration du service de messagerie Day CQ

  5. Configurez le service pour qu’il se connecte au serveur SMTP de votre choix :

    1. SMTP Server hostname: par exemple (smtp.gmail.com)
    2. Port du serveur: par exemple (465) pour gmail utilisant SSL
    3. Utilisateur SMTP  : demo@ <nom_entreprise> .com
    4. Adresse « De »  : aemformsdemo@adobe.com

    Configurer SMTP

  6. Cliquez sur « Enregistrer » pour enregistrer la configuration.

(Facultatif) Configuration de SSL pour AEM aemsslconfig

Cette section contient des informations détaillées sur la configuration du protocole SSL sur l’instance AEM afin de pouvoir définir la configuration d’Adobe Sign Cloud.

Références:

  1. SSL par défaut

Remarques:

  1. Accédez à https://<aemserver>:<port>/aem/inbox pour terminer le processus expliqué via le lien de documentation de référence ci-dessus.

  2. Le package we-gov-forms.pkg.all-[version].zip comprend un exemple de certificat et de clé SSL accessibles en extrayant le dossier we-gov-forms.pkg.all-[version].zip/ssl qui fait partie du package.

  3. Détails du certificat et de la clé SSL :

    1. délivré sur « CN=localhost »
    2. Validité de 10 ans
    3. valeur de mot de passe de « password »

  4. La clé privée est localhostprivate.der.

  5. Le certificat est localhost.crt.

  6. Cliquez sur Suivant.

  7. Le nom d’hôte HTTPS doit être défini sur localhost.

  8. Le port doit être défini sur un port exposé par le système.

(Facultatif) Configuration cloud d’Adobe Sign adobe-sign-cloud-configuration

Cette section contient des informations détaillées et des instructions sur la configuration cloud d’Adobe Sign.

Références:

  1. Incorporation d’Adobe Sign à AEM Forms

Configuration cloud cloud-configuration

  1. Consultez les conditions préalables. Voir Configuration de SSL AEM pour connaître la configuration SSL requise.

  2. Accédez à :

    https://<aemserver>:<port>/libs/adobesign/cloudservices/adobesign.html/conf/we-gov

    note note
    NOTE
    L’URL utilisée pour accéder au serveur AEM doit correspondre à celle configurée dans l’URI de redirection OAuth d’Adobe Sign afin d’éviter des problèmes de configuration (par exemple : https://<aemserver>:<port>/mnt/overlay/adobesign/cloudservices/adobesign/properties.html).

  3. Sélectionnez la configuration « We.gov Adobe Sign ».

  4. Cliquez sur « Propriétés ».

  5. Accédez à l’onglet « Paramètres ».

  6. Saisissez l’URL oAuth, par exemple : https://secure.na1.echosign.com/public/oauth.

  7. Indiquez l’ID client et le secret client configurés à partir de l’instance Adobe Sign configurée.

  8. Cliquez sur « Se connecter à Adobe Sign ».

  9. Une fois la connexion établie, cliquez sur « Enregistrer et fermer » pour terminer l’intégration.

(Facultatif) Configuration cloud de MS® Dynamics ms-dynamics-cloud-configuration

Cette section contient des détails et des instructions sur la configuration cloud de MS® Dynamics.

Références :

  1. Microsoft
  2. Configurer Microsoft® Dynamics pour AEM Forms

Service cloud OData de MS® Dynamics ms-dynamics-odata-cloud-service

  1. Accédez à :

    https://<aemserver>:<port>/libs/fd/fdm/gui/components/admin/fdmcloudservice/fdm.html/conf/we-gov

    1. Assurez-vous d’accéder au serveur à l’aide de la même URL de redirection que celle configurée dans l’enregistrement de l’application MS® Dynamics.

  2. Sélectionnez la configuration « Service cloud OData de Microsoft® Dynamics ».

  3. Cliquez sur « Propriétés ».

    Propriétés du service cloud OData de Microsoft

  4. Accédez à l’onglet « Paramètres d’authentification ».

  5. Saisissez les informations suivantes :

    1. Racine du service : par exemple, https://msdynamicsserver.api.crm3.dynamics.com/api/data/v9.1/

    2. Type d’authentification : OAuth 2.0

    3. Paramètres d’authentification (voir Paramètres de configuration cloud de MS® Dynamics pour collecter ces informations) :

      1. ID client (également appelé ID d’application)
      2. Secret client
      3. URL OAuth : par exemple, https://login.microsoftonline.com/common/oauth2/authorize
      4. URL du jeton d’actualisation (par exemple, https://login.windows.net/common/oauth2/token)
      5. URL du jeton d’accès (par exemple, https://login.windows.net/common/oauth2/token)
      6. Portée de l’autorisation (openid)
      7. En-tête d’authentification (porteur d’autorisation)
      8. Ressource, par exemple : https://msdynamicsserver.api.crm3.dynamics.com

    4. Cliquez sur « Connexion à OAuth ».

  6. Une fois l’authentification terminée, cliquez sur « Enregistrer et fermer » pour terminer l’intégration.

Paramètres de configuration cloud de MS® Dynamics dynamicsconfig

Les étapes détaillées dans cette section vous aident à localiser l’ID client, le secret client et les détails de votre instance cloud MS® Dynamics.

  1. Accédez à https://portal.azure.com/ et connectez-vous.

  2. Dans le menu de gauche, sélectionnez « Tous les services ».

  3. Recherchez ou accédez à « Enregistrement de l’application ».

  4. Créez ou sélectionnez un enregistrement d’application existant.

  5. Copiez l’ID de l’application à utiliser comme ID client OAuth dans la configuration cloud d’AEM.

  6. Cliquez sur « Paramètres » ou « Manifeste » pour configurer les URL de réponse.

    1. Cette URL doit correspondre à l’URL utilisée pour accéder à votre serveur AEM lors de la configuration du service OData.

  7. Dans la vue Paramètres, cliquez sur « Clés » pour afficher la nouvelle clé (celle-ci est utilisée comme secret client dans AEM).

    1. Veillez à conserver une copie de la clé, car vous ne pourrez pas la visualiser ultérieurement dans Azure ou AEM.

  8. Pour localiser l’URL de ressource/l’URL racine du service, accédez au tableau de bord de l’instance MS® Dynamics.

  9. Dans la barre de navigation supérieure, cliquez sur « Ventes » ou sur votre propre type d’instance, puis sur « Sélectionner les paramètres ».

  10. Cliquez sur « Personnalisations » et « Ressources pour les développeurs » en bas à droite.

  11. Vous y trouverez l’URL racine du service : par exemple,

    *https://msdynamicsserver.api.crm3.dynamics.com/api/data/v9.1/

  12. Vous trouverez des informations détaillées sur l’URL du jeton d’accès et d’actualisation à l’adresse suivante :

    https://learn.microsoft.com/fr/rest/api/datacatalog/authenticate-a-client-app

Tester le modèle de données de formulaire (Dynamics) testing-the-form-data-model

Une fois la configuration du cloud terminée, vous pouvez tester le modèle de données de formulaire.

  1. Accédez à

    https://<aemserver>:<port>/aem/forms.html/content/dam/formsanddocuments-fdm/we-gov

  2. Sélectionnez « We.gov Microsoft® Dynamics CRM FDM », puis « Propriétés ».

    Propriétés de Dynamics CRM FDM

  3. Accédez à l’onglet « Mettre à jour la source ».

  4. Assurez-vous que la « Configuration basée sur le contexte » est définie sur « /conf/we-gov » et que la source de données configurée est « ms-dynamics-odata-cloud-service ».

    Source de données configurée

  5. Modifiez le modèle de données de formulaire.

  6. Testez les services pour vérifier qu’ils se connectent à la source de données configurée.

    note note
    NOTE
    Une fois les services testés, cliquez sur Annuler pour vous assurer que les modifications involontaires ne sont pas propagées au modèle de données de formulaire.
    note note
    NOTE
    Un redémarrage du serveur AEM est nécessaire pour que la source de données soit correctement liée à FDM.
    note note
    NOTE
    Il est recommandé d’utiliser la commande « Ctrl + C » pour redémarrer le SDK. Le redémarrage du SDK AEM à l’aide de méthodes alternatives, par exemple l’arrêt des processus Java, peut entraîner des incohérences dans l’environnement de développement AEM.

Tester le modèle de données de formulaire (Derby) test-fdm-derby

Une fois la configuration du cloud terminée, vous pouvez tester le modèle de données de formulaire.

  1. Accédez à https://<aemserver>:<port>/aem/forms.html/content/dam/formsanddocuments-fdm/we-gov

  2. Sélectionnez Demande d’inscription We.Gov FDM, puis cliquez sur Propriétés.

    Propriétés de Dynamics CRM FDM

  3. Accédez à l’onglet Mettre à jour la source.

  4. Assurez-vous que la Configuration basée sur le contexte est définie sur /conf/we-gov et que la source de données configurée est We.Gov Derby DS.

    Propriétés de Dynamics CRM FDM

  5. Cliquez sur Enregistrer et fermer.

  6. Tester les services pour vérifier qu’ils se connectent bien à la source de données configurée

    • Pour tester la connexion, sélectionnez l’option Compte prêt hypothécaire et appliquez-lui un service « get ». Testez le service afin que les administrateurs système puissent voir les données récupérées.

Configurer Adobe Analytics (facultatif) adobe-analytics-configuration

Cette section contient des informations détaillées et des instructions sur la configuration dʼAdobe Analytics Cloud.

Références:

Configuration du service cloud Adobe Analytics adobe-analytics-cloud-service-configuration

Ce package est préconfiguré pour se connecter à Adobe Analytics. Les étapes ci-dessous sont fournies pour permettre la mise à jour de cette configuration.

  1. Accédez à https://<aemserver>:<port>/libs/cq/core/content/tools/cloudservices.html

  2. Recherchez la section Adobe Analytics et cliquez sur le lien « Afficher les configurations ».

  3. Sélectionnez la configuration « We.Gov Adobe Analytics (Configuration Analytics) ».

    Configuration du service cloud Analytics

  4. Cliquez sur le bouton « Modifier » pour mettre à jour la configuration d’Adobe Analytics (vous devrez fournir le secret partagé). Cliquez sur « Connexion à Analytics » pour vous connecter, puis sur « OK » pour terminer.

    We.Gov Adobe Analytics

  5. Sur la même page, cliquez sur « We.Gov Adobe Analytics Framework (Analytics Framework) » si vous souhaitez mettre à jour les configurations du framework (voir Activer la création AEM pour activer la création).

Localisation d’informations d’identification utilisateur Adobe Analytics analytics-locating-user-credentials

Pour localiser les informations d’identification utilisateur d’un compte Adobe Analytics, l’administrateur ou l’administratrice de compte doit effectuer les tâches suivantes.

  1. Accédez au portail Adobe Experience Cloud.
    • Se connecter avec des informations d’identification d’administrateur
  2. Sélectionnez l’icône Adobe Analytics dans le tableau de bord principal.
    Accès rapide
  3. Accédez à l’onglet Admin et sélectionnez l’élément Gestion des utilisateurs (hérité).
    Rapports
  4. Sélectionnez l’onglet Utilisateurs.
    Gestion des utilisateurs
  5. Sélectionnez un utilisateur dans la liste des utilisateurs.
  6. Faites défiler jusqu’au bas de la page pour afficher les informations d’authentification des utilisateurs.
    Gérer l’accès
  7. Le nom d’utilisateur et les informations secrètes partagées s’affichent sur le côté droit de la zone des autorisations.
  8. Notez que le nom d’utilisateur a le signe des deux points dans le nom. Toutes les informations se trouvant à la gauche des deux points constituent le nom d’utilisateur et celles se trouvant à la droite constituent le nom de la société.
    • Voici un exemple : nom d’utilisateur : nom de la société

Configuration de l’authentification des utilisateurs et utilisatrices dans Adobe Analytics setup-user-authentication

Les administrateurs peuvent accorder aux utilisateurs des autorisations AEM Analytics en procédant comme suit.

  1. Accédez à Adobe Admin Console.

  2. Cliquez sur l’instance Analytics exposée à Admin Console.

    • Elle se trouve sur la page principale de la page d’administration.

  3. Sélectionnez Accès administrateur complet dans Analytics.

  4. Ajoutez un utilisateur au profil.

    Accès administrateur complet dans Analytics

  5. Cliquez sur l’onglet Autorisations une fois que l’ID utilisateur a été mappé dans le profil.

  6. Assurez-vous que toutes les autorisations sont mises en correspondance avec le profil.

    Modifier les autorisations

  7. Une fois les autorisations mappées, la possibilité pour un utilisateur ou une utilisatrice de se connecter peut prendre quelques heures.

Rapports Adobe Analytics adobe-analytics-reporting

Afficher les rapports sur les sites Adobe Analytics view-adobe-analytics-sites-reporting

NOTE
Les données AEM Forms Analytics sont disponibles hors ligne ou sans configuration cloud Adobe Analytics si le package we-gov-forms.ui.analytics-<version>.zip est installé, mais les données AEM Sites nécessitent une configuration cloud active.

  1. Accédez à https://<aemserver>:<port>/sites.html/content

  2. Sélectionnez le « Site We.Gov d’AEM Forms » pour afficher les pages du site.

  3. Sélectionnez l’une des pages du site (par exemple Accueil), puis choisissez « Analytics et Recommendations ».

    Analysis et Recommendations

  4. Sur cette page, vous verrez les informations récupérées d’Adobe Analytics qui se rapportent à la page AEM Sites (remarque : par conception, ces informations sont périodiquement actualisées à partir d’Adobe Analytics et ne s’affichent pas en temps réel).

    Analyse AEM Sites

  5. De retour sur la page Page vue (accessible à l’étape 3), vous pouvez également afficher les informations sur les pages vues en modifiant le paramètre d’affichage pour visualiser les éléments dans la « Vue liste ».

  6. Recherchez le menu déroulant « Affichage » et sélectionnez « Vue liste ».

    Vue Liste

  7. Dans le même menu, sélectionnez « Paramètre d’affichage » et sélectionnez les colonnes que vous souhaitez afficher dans la section « Analytics ».

    Configurer les colonnes

  8. Cliquez sur « Mettre à jour » pour rendre les nouvelles colonnes disponibles.

    Afficher les nouvelles colonnes

Afficher les rapports de formulaires Adobe Analytics view-adobe-analytics-forms-reporting

NOTE
Les données AEM Forms Analytics sont disponibles hors ligne ou sans configuration cloud Adobe Analytics si le package we-gov-forms.ui.analytics-<version>.zip est installé, mais les données AEM Sites nécessitent une configuration cloud active.

  1. Accédez à

    https://<serveur_AEM>:<port>/aem/forms.html/content/dam/formsanddocuments/adobe-gov-forms

  2. Sélectionnez le formulaire adaptatif « Demande d’inscription pour les prestations de santé » et sélectionnez l’option « Rapport Analytics ».

    Rapport Analytics

  3. Patientez jusqu’au chargement de la page, puis affichez les données du rapport Analytics.

    Afficher les données du rapport Analytics

Activation de la configuration des formulaires automatisés Adobe automated-forms-enablement

Pour installer et configurer AEM Forms avec Adobe Forms, les utilisateurs et utilisatrices de l’outil de conversion doivent disposer des éléments suivants.

  1. Accès à Adobe Developer.

  2. Autorisation de créer une intégration avec le service de conversion Adobe Forms.

  3. Service Pack le plus récent pour Adobe AEM 6.5 exécuté en tant qu’auteur.

Consultez les informations suivantes avant de lire d’autres instructions :

Créer une configuration IMS - Partie 1 creating-ims-config

Pour configurer le service afin qu’il communique correctement avec l’outil de conversion de formulaires, les utilisateurs et les utilisatrices doivent configurer le service Identity Management System (IMS) pour pouvoir s’enregistrer auprès d’Adobe I/O.

  1. Accédez à https://<serveur_AEM>:<port> > Cliquez sur Adobe Experience
    Manager en haut à gauche > Outils > Sécurité > Configuration Adobe IMS.

  2. Cliquez sur Créer.

  3. Exécutez les actions dans l’image ci-dessous.

    Configurer le compte technique IMS

  4. Veillez à télécharger le certificat.

  5. Ne procédez pas à la suite de la configuration. Consultez la section Créer une intégration dans Adobe I/O.

NOTE
Le certificat créé dans cette section va être servir à créer le service d’intégration dans Adobe I/O. Une fois ceci fait, les utilisateurs peuvent utiliser ces informations depuis Adobe I/O pour terminer la configuration.

Créer une intégration dans Adobe I/O create-integration-adobeio

Assurez-vous que vous avez la possibilité de créer une intégration dans votre domaine Adobe sans avoir à contacter votre administrateur ou administratrice système.

  1. Accédez à la console Adobe I/O.

  2. Cliquez sur Créer une intégration.

  3. Sélectionnez Accéder à une API.

  4. Assurez-vous que vous vous trouvez dans le bon groupe (liste déroulante en haut à droite).

  5. Dans la section Experience Cloud, sélectionnez l’outil de conversion de formulaires.

  6. Cliquez sur Continuer.

  7. Saisissez le nom et la description de votre intégration.

  8. À l’aide de la clé publique de la section 2.1, placez-la dans l’intégration de la clé.

  9. Sélectionnez un profil pour votre conversion automatisée de formulaires.

    Créer une intégration

Créer la configuration IMS - Partie 2 create-ims-config-part-next

Maintenant que vous avez créé une intégration, vous allez terminer l’installation de la configuration IMS.

  1. Cliquez sur votre intégration dans Adobe I/O pour exposer les détails de connexion.

  2. Accédez à votre configuration IMS dans AEM (Outils > Sécurité > IMS).

  3. Cliquez sur Suivant dans l’écran Configuration IMS.

  4. Saisissez le serveur d’autorisation (valeur affichée dans la capture d’écran).

  5. Saisissez la clé API.

  6. Saisissez le secret client (vous devez cliquer sur Exposer dans l’intégration dans Adobe I/O pour qu’il s’affiche).

  7. Cliquez sur l’onglet JWT dans Adobe I/O pour obtenir la payload JWT et la coller dans la payload de la configuration IMS.

    Configuration IMS de la payload

  8. Une fois la configuration créée, cliquez sur la configuration IMS et sélectionnez Contrôle de l’intégrité. Les utilisateurs et utilisatrices doivent voir le résultat suivant.

    Confirmation d’intégrité

Définir la configuration cloud (We.Gov AFC Production) configure-cloud-configuration

Une fois la configuration IMS terminée, vous pouvez passer en revue la configuration cloud dans AEM. Si la configuration n’existe pas, procédez comme suit pour créer la configuration cloud dans AEM :

  1. Ouvrez votre navigateur et accédez à l’URL système https://<domain_name>:<system_port>.

  2. Cliquez sur Adobe Experience Manager dans le coin supérieur gauche de l’écran > Outils > Services cloud > Configuration de la conversion automatisée des formulaires.

  3. Sélectionnez le dossier de configuration dans lequel vous souhaitez placer la configuration.

  4. Cliquez sur Créer.

  5. Saisissez les informations figurant dans la capture d’écran ci-dessous.

    Exploitation AFC

  6. Fournissez un titre et un nom à la configuration.

  7. L’URL du service pour le système est définie sur https://aemformsconversion.adobe.io/.

  8. URL du modèle /conf-gov/settings/wcm/templates/we-gov-flamingo-template.

  9. URL du thème : /content/dam/formsanddocuments-themes/adobe-gov-forms-themes/we-gov-theme

  10. Cliquez sur Suivant.

  11. Pour cette configuration, nous avons laissé les deux valeurs de case à cocher vides.

Configurer le cloud (exploitation AFC We.Finance) configure-cloud-configuration-wefinance

Une fois la configuration IMS terminée, nous pouvons procéder à la création de la configuration cloud dans AEM.

  1. Ouvrez votre navigateur et accédez à l’URL système https://<domain_name>:<system_port>.

  2. Cliquez sur Adobe Experience Manager dans le coin supérieur gauche de l’écran > Outils > Services cloud > Configuration de la conversion automatisée des formulaires.

  3. Sélectionnez le dossier de configuration dans lequel vous souhaitez placer la configuration.

  4. Cliquez sur Créer.

  5. Saisissez les informations figurant dans la capture d’écran ci-dessous.

    Exploitation AFC We.Finance

  6. Fournissez un titre et un nom à la configuration.

  7. L’URL du service pour le système est définie sur https://aemformsconversion.adobe.io/

  8. URL du modèle : /conf/we-finance/settings/wcm/templates/we-finance-adaptive-form

  9. URL du thème : /content/dam/formsanddocuments-themes/adobe-finance-forms-themes/we-finance-theme

  10. Cliquez sur Suivant.

  11. Pour cette configuration, nous avons laissé les deux valeurs de case à cocher vides.

Tester la conversion de formulaires (demande d’inscription We.Gov) test-forms-conversion

Une fois la configuration définie, les utilisateurs peuvent la tester en chargeant un document PDF.

  1. Accédez au système AEM https://<domain_name>:<system_port>.

  2. Cliquez sur Forms > Forms > Documents > AEM Forms We.gov Forms > AFC.

  3. Sélectionnez le PDF de demande d’inscription We.Gov.

  4. Cliquez sur Démarrer la conversion automatisée dans le coin supérieur droit.

  5. Les utilisateurs doivent pouvoir voir l’option telle qu’illustrée ci-dessous.

    Formulaire adaptatif converti

  6. Une fois le bouton sélectionné, les options suivantes sont présentées aux utilisateurs :

    • Veillez à ce que les utilisateurs sélectionnent la configuration Exploitation AFC We.Gov.

    Paramètres de conversion

    Paramètres de conversion avancés

  7. Sélectionnez Démarrer la conversion après avoir configuré toutes les options que vous souhaitez utiliser.

  8. Au début du processus de conversion, les utilisateurs doivent voir l’écran suivant :

    Paramètres de conversion

  9. Une fois la conversion terminée, l’écran suivant s’affiche pour les utilisateurs :

    Formulaire adaptatif converti

    Cliquez sur le bouton Sortie pour afficher le formulaire adaptatif généré.

Problèmes connus et remarques known-issues-notes

Le service Automated Forms Conversion comprend quelques bonnes pratiques, modèles complexes connus et problèmes connus. Consultez-les avant de commencer à utiliser le service AEM Forms Automated Forms Conversion.

  1. Générez le formulaire avec Générer les formulaires adaptatifs sans liaison de données activée si vous souhaitez lier le formulaire à un FDM après la conversion.

  2. Assurez-vous que jcr:read est activé pour toutes les autorisations du dossier de modèles. Autrement, l’utilisateur ou l’utilisatrice du service ne pourra pas lire le modèle à partir du référentiel et la conversion échouera.

Personnalisations des packages de démonstration demo-package-customizations

Cette section comprend des instructions sur la personnalisation de la démonstration.

Personnalisation des modèles templates-customization

Les modèles modifiables se trouvent à l’emplacement suivant :

https://<aemserver>:<port>/libs/wcm/core/content/sites/templates.html/conf/we-gov

Ces modèles incluent les modèles Site AEM, Formulaire adaptatif et Communications interactives, créés et assemblés avec des composants qui se trouvent à l’adresse :

https://<aemserver>:<port>/crx/de/index.jsp#/apps/we-gov/components

Système de style customizetemplates

Ce site comprend également des bibliothèques clientes, dont l’une importe le Bootstrap 4 (https://getbootstrap.com/). Cette bibliothèque cliente est disponible à l’adresse suivante.

https://<aemserver>:<port>/crx/de/index.jsp#/apps/we-gov/clientlibs/clientlib-base/css/bootstrap

Les modèles modifiables inclus dans ce package sont également préconfigurés avec des politiques de modèle/page qui utilisent les classes CSS Bootstrap 4 pour la pagination, le style, etc. Toutes les classes n’ont pas été ajoutées aux politiques de modèle, mais toute classe prise en charge par le Bootstrap 4 peut être ajoutée aux politiques. Consultez la page de prise en main pour obtenir la liste des classes disponibles :

https://getbootstrap.com/docs/4.1/getting-started/introduction/

Les modèles inclus dans ce package prennent également en charge le système de style :

Système de style

Modèles de logos template-logos

Les ressources DAM du projet incluent également des images et logos We.Gov. Ces ressources sont disponibles à l’adresse suivante :

https://<aemserver>:<port>/assets.html/content/dam/we-gov

Lors de la modification des modèles de page et de formulaire, vous pouvez choisir de mettre à jour les logos de la marque en modifiant les composants Navigation et Pied de page. Ces composants offrent une boîte de dialogue de marque et de logo configurable qui peut être utilisée pour mettre à jour les logos :

Logos des modèles

Voir Modifier le contenu d’un formulaire pour plus d’informations :

Modification du contenu de la page

Personnaliser des pages de sites sites-pages-customization

Toutes les pages du site sont disponibles à l’adresse : https://<aemserver>:<port>/sites.html/content/we-gov.

Ces pages de site utilisent également le package AEM Grid pour contrôler la disposition de quelques composants.

Système de style style-system

Les pages incluses dans ce package prennent également en charge le système de style :

Système de style

Vous pouvez également consulter Système de style de personnalisation des modèles pour en savoir plus sur les styles pris en charge.

Personnaliser les formulaires adaptatifs adaptive-forms-customization

Tous les formulaires adaptatifs sont disponibles à l’adresse suivante :

https://<aemserver>:<port>/aem/forms.html/content/dam/formsanddocuments/adobe-gov-forms

Ces formulaires peuvent être personnalisés pour répondre à certains types d’utilisation. Certains champs et la logique d’envoi ne doivent pas être modifiés afin de garantir le bon fonctionnement du formulaire. Cela inclut :

Demande d’inscription pour les avantages santé :

  • contact_id : champ masqué utilisé pour recevoir l’ID de contact MS® Dynamics lors de l’envoi.
  • Envoyer : la logique du bouton Envoyer nécessite une personnalisation pour prendre en charge les rappels. La personnalisation est documentée, mais un script volumineux était nécessaire pour envoyer le formulaire lors de l’exécution d’une opération POST et GET à MS® Dynamics par le biais du modèle de données Forms.
  • Panneau racine : l’événement Initialize permet d’ajouter un bouton MS® Dynamics à la boîte de réception AEM de la manière la moins intrusive possible, car tous les composants de l’interface utilisateur Granite de la boîte de réception AEM ne peuvent pas être modifiés.

Mise en forme du formulaire adaptatif adaptive-form-styling

Les formulaires adaptatifs peuvent également être stylisés à l’aide de l’éditeur de style ou de l’éditeur de thème :

Personnalisation des workflows workflow-customization

Le formulaire adaptatif d’inscription est envoyé à un workflow OSGI pour traitement. Ce workflow se trouve à l’adresse https://<aemserver>:<port>/conf/we-gov/settings/models/we-gov-process.html.

En raison de certaines limitations, ce workflow contient plusieurs scripts et étapes de processus OSGI personnalisées. Ces étapes de workflow ont été créées sous la forme d’étapes génériques et n’ont pas été créées avec des boîtes de dialogue de configuration. Actuellement, la configuration des étapes du workflow repose sur des arguments de processus.

Tout le code Java™ de l’étape du workflow est contenu dans le lot we-gov-forms.core-<version>.jar.

Considérations relatives aux démonstrations et problèmes connus demo-considerations-and-known-issues

Cette section contient des informations sur les fonctionnalités de démonstration et les décisions de conception qui peuvent nécessiter des considérations spéciales pendant le processus de démonstration.

Considérations relatives aux démonstrations demo-considerations

  • Conformément à l’AGRS-159, assurez-vous que le nom (prénom, deuxième prénom et nom de famille) du contact utilisé dans le formulaire adaptatif d’inscription est unique.
  • Le formulaire adaptatif d’inscription enverra l’e-mail Adobe Sign à l’adresse e-mail spécifiée dans le champ d’adresse e-mail du formulaire. Cette adresse électronique ne peut pas être la même que celle utilisée pour la configuration cloud d’Adobe Sign.

Problèmes connus known-issues

  • (AGRS-120) Le composant Navigation du site ne prend actuellement pas en charge les pages enfants imbriquées de plus deux niveaux.
  • (AGRS-159) Le FDM MS® Dynamics actuel doit effectuer deux opérations pour commencer : PUBLIER (POST) les données du formulaire adaptatif d’inscription à Dynamics, puis rechercher l’enregistrement de l’utilisateur ou de l’utilisatrice pour récupérer l’ID de contact. Dans son état actuel, la récupération de l’ID de contact échoue si plus de deux utilisateurs ou utilisatrices portant le même nom sont présents dans Dynamics, ce qui n’autorise pas l’envoi du formulaire adaptatif d’inscription.

Configurer des tests d’accessibilité configure-accessibility-testing

Activer le module complémentaire Chrome Test d’accessibilité enable-chrome-add-on

Pour effectuer les tests d’accessibilité, installez le plug-in Chrome qui se trouve sur https://chrome.google.com/webstore/detail/accessibility-developer-t/fpkknkljclfencbdbgkenhalefipecmb?hl=en.

Une fois installé, chargez la page que vous souhaitez tester dans le navigateur Chrome. (Note : étant donné que l’ouverture de plusieurs onglets peut avoir une incidence sur votre score, il est préférable de n’ouvrir qu’un seul onglet). Une fois la page chargée, cliquez avec le bouton droit sur la page et sélectionnez l’onglet Contrôles. Les développeurs et développeuses peuvent sélectionner le type de contrôle à effectuer par le plug-in Accessibilité. Une fois toutes les options sélectionnées, l’utilisateur ou l’utilisatrice peut cliquer sur le bouton Générer le rapport. Cela génère un document PDF qui indique la note globale d’accessibilité ainsi que ce qui peut être fait pour augmenter celle-ci.

Une fois le rapport exécuté, les utilisateurs et utilisatrices peuvent s’attendre à voir les éléments suivants :

Rapport d’accessibilité

Le nombre affiché devant les utilisateurs est la note globale d’accessibilité qu’ils ont acquise. Il existe également une description de la façon dont ce calcul a été effectué en fonction du score.

Si les utilisateurs et utilisatrices souhaitent l’exporter, ils peuvent cliquer sur les trois boutons situés à droite de l’écran et choisir parmi les autres options proposées par le plug-in.

Rapport d’accessibilité

Thème Ultramarine ultramarine-theme

Le thème Ultramarine, accessible au public et géré par Adobe, est intégré au
we-gov-forms.pkg.all-<version>.zip fichier ZIP installable. Une fois ce package installé à l’aide de CRX.

Gestionnaire de packages, les utilisateurs peuvent accéder au thème Ultramarine dans AEM Forms en accédant à Forms  > Thèmes  > Thèmes de référence  > Accessible à Ultramarine.

Thème Ultramarine

Options de configuration configuration-options

Les utilisateurs peuvent configurer différentes options de service de workflow, notamment :

  1. Entrée Microsoft® Dynamics
  2. Adobe Sign
  3. Gestion des communications personnalisées AEM
  4. Adobe Analytics

Pour les configurer afin qu’ils soient activés dans le workflow, les utilisateurs et utilisatrices doivent effectuer les tâches suivantes.

  1. Accédez à https://'[serveur]:[port]'/system/console/configMgr.

  2. Recherchez les configurations WeGov.

  3. Ouvrez la définition de service et activez les services sélectionnés à appeler dans le workflow.

    note note
    NOTE
    Un utilisateur ou une utilisatrice active le service dans la page Configuration Manager. Par conséquent, les utilisateurs et utilisatrices doivent toujours configurer un service pour communiquer avec les services externes demandés.

    Package WeGov Forms

  4. Une fois l’opération terminée, cliquez sur Enregistrer pour enregistrer les paramètres.

Étapes suivantes next-steps

Vous êtes maintenant prêt à explorer le site de référence We.Gov. Pour plus d’informations sur les étapes et le workflow du site de référence We.Gov, consultez la section Présentation du site de référence We.Gov.

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