Installer et configurer le site de référence We.Gov et We.Finance

Détails du module de démonstration

Conditions préalables à l’installation

Ce module 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 MODULE 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 module 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 module :
  • Le module doit être installé sur un serveur nettoyé, sans autres modules de démonstration ou anciennes versions de modules de démonstration.
  • Le module doit être installé sur un serveur OSGi s’exécutant en mode création.

Que comprend ce module ?

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

  • we-gov-forms.pkg.all-<version>.zip : module 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 : module 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 module 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 module de démonstration

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

À partir de la distribution logicielle

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

  2. Appuyez sur Adobe Experience Manager disponible dans le menu d’en-tête.

  3. Dans la section Filtres :

    1. Sélectionnez Formulaires 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. Appuyez sur le nom du module we-gov-forms.pkg.all-<version>.zip, sélectionnez Accepter les termes du contrat de licence utilisateur final, puis appuyez sur 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 module et cliquez sur Installer.

    module 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

  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 « Charger le module ».

    Option de chargement de module

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

  6. Une fois le 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://<serveur_aem>:<port>/content/we-gov/home.html?wcmmode=disabled pour vérifier que l’installation a réussi.

Installer une nouvelle version de package

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. À l’invite de confirmation, sélectionnez à nouveau « Désinstaller », puis attendez la fin du processus de désinstallation.

Configuration du package de démonstration

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

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

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

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

  4. Recherchez « workflow ».

  5. Sélectionnez le groupe « workflow-users » (utilisateurs de 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. Faites votre choix dans la liste déroulante « Utilisateurs Forms We.Gov ».

    Modifier les paramètres de groupe pour les utilisateurs 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

  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 Day CQ Mail Service, 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. Nom d’hôte du serveur SMTP : 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

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://<serveur_aem>:<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é 10 ans
    3. Valeur de mot de passe de « mot de passe »
  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

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

  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

    REMARQUE

    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ètre ».

  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

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

Références:

  1. Configuration du service OData de Microsoft Dynamics
  2. Configurer Microsoft Dynamics pour AEM Forms

Service cloud OData de MS Dynamics

  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.windows.net/common/oauth2/authorize)
      4. Actualiser l’URL du jeton (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 de MS Dynamics Cloud

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

  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ètre, cliquez sur « Clés » pour afficher la création d’une 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 : e.g

    *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://docs.microsoft.com/fr-fr/rest/api/datacatalog/authenticate-a-client-app

Tester le modèle de données de formulaire (Dynamics)

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.

    REMARQUE

    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.

    REMARQUE

    Un redémarrage du serveur AEM est nécessaire pour que la source de données soit correctement liée à FDM.

Tester le modèle de données de formulaire (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)

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

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 (Analytics Configuration) ».

    Configuration du service cloud Analytics

  4. Cliquez sur le bouton « Modifier » pour mettre à jour la configuration Adobe Analytics (vous devrez fournir le secret partagé). Cliquez sur « Se connecter à 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

Pour localiser les informations d’identification utilisateur d’un compte Adobe Analytics, l’administrateur 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 aura 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é

Configurer l’authentification des utilisateurs dans Adobe Analytics

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 à la console d’administration.

    • 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. Notez qu’une fois les autorisations mappées, la possibilité pour un utilisateur de se connecter peut prendre quelques heures.

Rapports Adobe Analytics

Afficher les rapports sur les sites Adobe Analytics

REMARQUE

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

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

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

  3. Sélectionnez l’une des pages du site (par exemple Accueil), puis « 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 ».

    Mode 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 « Analyse ».

    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

REMARQUE

Les données AEM Forms Analytics sont disponibles hors ligne ou sans configuration Adobe Analytics Cloud 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é », puis 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

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

  1. Accès à Adobe I/O.

  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.

Avant de lire la suite des instructions, consultez le lien suivant :

Créer une configuration IMS - Partie 1

Pour configurer le service afin qu’il communique correctement avec l’outil de conversion de formulaires, les utilisateurs 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.

REMARQUE

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

Assurez-vous que vous avez la possibilité de créer une intégration dans votre domaine Adobe sans avoir à contacter votre administrateur 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

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 afin d’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 afin d’obtenir la payload JWT et de 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 doivent voir le résultat suivant.

    Confirmation d’intégrité

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

Une fois la configuration IMS terminée, nous pouvons 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://<nom_domaine>:<port_système>.

  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)

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://<nom_domaine>:<port_système>.

  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)

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 le bouton 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 une fois que vous avez 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

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 le ou 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 du service ne pourra pas lire le modèle à partir du référentiel et la conversion échouera.

Personnalisations des packages de démonstration

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

Personnalisation des modèles

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

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 stratégies 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 stratégies de modèle, mais toute classe prise en charge par le Bootstrap 4 peut être ajoutée aux stratégies. 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 module prennent également en charge le système de style :

Système de style

Modèles de 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

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

Ces pages de site utilisent également le module AEM Grid pour contrôler la mise en page de quelques composants.

Système de style

Les pages incluses dans ce module 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

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. Notez que 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 via le 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

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

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

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

  • 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 le courrier électronique Adobe Sign à l’adresse électronique spécifiée dans le champ de courrier électronique 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

  • (AGRS-120) Le composant Navigation du site ne prend actuellement pas en charge les pages enfants imbriquées de plus de 2 niveaux.
  • (AGRS-159) Le FDM MS Dynamics actuel doit effectuer 2 opérations pour commencer, PUBLIER les données du formulaire adaptatif d’inscription à Dynamics, puis rechercher l’enregistrement de l’utilisateur afin de 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 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é

Activer le module complémentaire Chrome Test d’accessibilité

Pour effectuer des tests d’accessibilité, vous devez d’abord installer le plug-in Chrome que vous pouvez trouver ici.

Une fois installé, chargez la page que vous souhaitez tester dans le navigateur Chrome. (Remarque : é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
faites un clic droit sur la page et sélectionnez l’onglet Contrôles. Les développeurs peuvent sélectionner le type de contrôle à effectuer par le plug-in Accessibilité. Une fois toutes les options sélectionnées, l’utilisateur 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 la note globale d’accessibilité.

Une fois le rapport exécuté, les utilisateurs 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 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

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 modules, 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

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

    REMARQUE

    Un utilisateur active le service dans la page Configuration Manager. Par conséquent, les utilisateurs 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 le bouton Enregistrer pour enregistrer les paramètres.

Étapes suivantes

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.

Sur cette page