Show Menu
SUJETS×

Configuration du site de référence We.Gov

Détails du package de démonstration

Conditions préalables à l’installation

Ce package a été créé pour AEM Forms 6.4 OSGI Author , a été testé et est donc pris en charge sur les versions de plateformes suivantes :
VERSION AEM
VERSION DU PACKAGE AEM FORMS
ÉTAT
6.4
5.0.86
Pris en charge
6.5
6.0.80
Pris en charge
Ce package contient une configuration de cloud qui prend en charge les versions de plateformes suivantes :
FOURNISSEUR CLOUD
VERSION DU SERVICE
ÉTAT
Adobe Sign
API v5
Pris en charge
Microsoft Dynamics 365
1710 (9.1.0.3020)
Pris en charge
Considérations relatives à l’installation du package :
  • Le paquet devrait être installé sur un serveur propre, sans les autres paquets de démonstration ni les versions antérieures des paquets de démonstration.
  • Le package doit être installé sur un serveur OSGI, en mode Auteur.

Qu’inclut ce package ?

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 comprend les modules suivants :
  • we-gov-forms.pkg.all-<version>.zip - Pack de démonstration complet
    • we-gov-forms.ui.apps-<version>.zip - contient tous les composants, bibliothèques client, exemples d’utilisateurs, modèles de flux de travail, etc.
      • we-gov-forms.core-<version>.jar - contient tous les services OSGI, l’implémentation d’étape de flux de travail personnalisé, 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 mise en page Grille de sites AEM pour le contrôle de colonne de la page Sites
    • we-gov-forms.ui.content-<version>.zip - contient tout le contenu, les pages, les images, les formulaires, les ressources de communication interactives, etc.
    • we-gov-forms.config.public-<version>.zip - Contient tous les noeuds de configuration par défaut, y compris les configurations de cloud d’espace réservé pour éviter les modèles de données de formulaires et les problèmes de liaison de service.
Les actifs inclus dans ce package sont les suivants :
  • Pages du site AEM avec modèles modifiables
  • Formulaires adaptatifs AEM Forms
  • Communications interactives AEM Forms ( Impression et Web)
  • d’enregistrement XDP d’AEM Forms
  • Modèle de données AEM Forms MS Dynamics Forms
  • Intégration d’Adobe Sign
  • Modèle de processus AEM
  • Exemples d’images d’AEM Assets

Options de configuration

Cette section comprend des détails sur les options de configuration. Actuellement, cette section est intentionnellement vide.

Installation du package de démonstration

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

From package share

  1. Accédez à https://<aemserver>:<port>/crx/packageshare/
    Ou dans AEM, cliquez sur Déploiement et accédez à l’icône Package Share.
  2. Connectez-vous à l’aide de votre Adobe ID.
  3. Recherchez et recherchez le package we-gov-forms.pkg.all-<version> .
  4. Sélectionnez l’option "Télécharger" et acceptez les conditions générales.
  5. Une fois téléchargé, sélectionnez l’option "Téléchargé" pour localiser le package dans Package Manager.
  6. Sélectionnez l’option "Installer" pour installer le pack.
  7. Autorisez le processus d’installation à se terminer.
  8. Accédez à https://<aemserver>:<port>/content/we-gov/home.html?wcmmode=disabled pour vous assurer que l’installation a réussi.

A partir d’un fichier ZIP local

  1. Téléchargez et localisez 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".
  4. Utilisez l’explorateur de fichiers pour accéder au fichier ZIP téléchargé et le sélectionner.
  5. Cliquez sur "Ouvrir" pour télécharger.
  6. Une fois le téléchargement effectué, sélectionnez l’option "Installer" pour installer le pack.
  7. Autorisez le processus d’installation à se terminer.
  8. Accédez à https://<aemserver>:<port>/content/we-gov/home.html?wcmmode=disabled pour vous assurer que l’installation a réussi.

Installation des nouvelles versions des packages

Pour installer la nouvelle version du pack, suivez les étapes définies dans les versions 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 déjà installé, mais il est recommandé de désinstaller d’abord l’ancienne version de package. Pour ce faire, suivez les étapes ci-dessous.
  1. Accédez à https://<aemserver>:<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".
  5. Sur confirmation, sélectionnez à nouveau "Désinstaller" et autorisez le processus de désinstallation à se terminer.

Configuration du package de démonstration

Cette section contient des détails et des instructions sur la configuration post-déploiement du pack de démonstration avant la présentation.

Configuration fictive de l’utilisateur

  1. Accédez à https://<aemserver>:<port>/libs/granite/security/content/groupadmin.html
  2. Recherchez " workflow ".
  3. Sélectionnez le groupe " Workflow-users " et cliquez sur "Properties".
  4. Accédez à l'onglet "Membres".
  5. Entrez wegov dans le champ "Sélectionner un utilisateur ou un groupe".
  6. Sélectionnez "Utilisateurs de formulaire We.Gov" dans la liste déroulante.
  7. Cliquez sur "Enregistrer et fermer" dans la barre de menus.
  8. Répétez les étapes 2 à 7 en recherchant " Analytics ", en sélectionnant le groupe "Administrateurs d’ Analytics" et en ajoutant le groupe "Utilisateurs de formulaires Google We.Gov" en tant que membre.
  9. Répétez les étapes 2 à 7 en recherchant "utilisateurs de formulaires", en sélectionnant le groupe "utilisateurs de formulaires puissants" et en ajoutant le groupe "Utilisateurs ​de formulaires Web.Gov" en tant que membre.
  10. Répétez les étapes 2 à 7 en recherchant "utilisateurs de formulaires", en sélectionnant le groupe "utilisateurs de formulaires" et en ajoutant cette fois le groupe "Utilisateurs de Web.Gov" en tant que membre.

Configuration du serveur de messagerie

  1. Vérification de la documentation de configuration Configuration de la notification par courrier électronique
  2. Navigate to https://<aemserver>:<port>/system/console/configMgr
  3. Recherchez et cliquez sur le service Service de messagerie Day CQ pour le configurer.
  4. 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_société>.com
  5. Cliquez sur "Enregistrer" pour enregistrer la configuration.

Configuration SSL d’AEM

Cette section contient des détails sur la configuration de SSL sur l’instance AEM afin de pouvoir configurer la configuration d’Adobe Sign Cloud.
Références:
Notes:
  1. Accédez à https://<aemserver>:<port>/aem/inbox où vous pourrez terminer le processus décrit dans le lien de documentation de référence ci-dessus.
  2. Le package we-gov-forms.pkg.all-<version>.zip comprend un exemple de clé et de certificat SSL accessible en extrayant le dossier we-gov-forms.pkg.all-<version>.zip/ssl qui fait partie du package.
  3. Certificat SSL et détails de clé :
    1. émis à "CN=localhost"
    2. 10 ans de validité
    3. valeur de mot de passe de "password"

Adobe Sign cloud configuration

Cette section contient des informations et des instructions sur la configuration d’Adobe Sign Cloud.
Références:

Cloud configuration

  1. Vérifiez les conditions préalables. Voir Configuration SSL AEM pour connaître la configuration SSL requise.
  2. Accédez à:
    https://<aemserver>:<port>/libs/adobesign/cloudservices/adobesign.html/conf/we-gov
    L’URL utilisée pour accéder au serveur AEM doit correspondre à l’URL 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. Entrez l’URL d’authentification, par exemple : https://secure.na1.echosign.com/public/oauth
  7. Indiquez l’ID de client et la clé secrète 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.

Configuration du cloud MS Dynamics

Cette section contient des détails et des instructions sur la configuration de MS Dynamics Cloud.
Références:

Service cloud MS Dynamics OData

  1. Accédez à:
    https://<aemserver>:<port>/libs/fd/fdm/gui/components/admin/fdmcloudservice/fdm.html/conf/we-gov
    1. Vérifiez que vous accédez 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 Microsoft Dynamics OData".
  3. Cliquez sur "Propriétés".
  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 du cloud MS Dynamics pour recueillir ces informations) :
      1. ID client - également appelé
      2. Secret client
      3. URL du jeton d’actualisation - https://login.windows.net/common/oauth2/token
      4. Étendue de l'autorisation - openid
      5. En-tête d'authentification - Auteur d'autorisation
    4. Cliquez sur "Se connecter à OAuth".
  6. Après une authentification réussie, cliquez sur "Enregistrer et fermer" pour terminer l’intégration.

Paramètres de configuration du cloud MS Dynamics

Les étapes détaillées dans cette section sont incluses pour vous aider à localiser l’ID client, la clé secrète 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 le ​à utiliser comme ID ​client OAuth dans la configuration du cloud 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 le de paramètres, cliquez sur "Clés" pour créer une nouvelle clé (utilisée comme clé secrète client dans AEM).
    1. Veillez à conserver une copie de la clé car vous ne pourrez pas la ultérieurement dans Azure ou AEM.
  8. Pour localiser l’URL de ressource/URL racine du service, accédez au d’instance MS Dynamics.
  9. Dans la barre de navigation supérieure, cliquez sur "Ventes" ou sur votre propre type d'instance et sur "Sélectionner les paramètres".
  10. Cliquez sur "Personnalisations" et sur "Ressources pour les développeurs" en bas à droite.
  11. Vous y trouverez l’URL racine du service : e.g
  12. Pour plus d’informations sur l’URL d’actualisation et de de, voir :

Test du modèle de données de formulaire

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" et "Properties".
  3. Accédez à l'onglet "Mettre à jour la source".
  4. Assurez-vous que la configuration "Context-Aware Configuration" est définie sur "/conf/we-gov" et que la source de données configurée est "ms-dynamic-odata-cloud-service".
  5. Modifiez le modèle de données de formulaire.
    Veillez à cliquer sur Annuler au lieu de Enregistrer et fermer pour éviter les problèmes qui nécessitent une réinstallation.
  6. Testez les services pour vous assurer qu’ils se connectent correctement à la source de données configurée.
    Il a été signalé qu’un redémarrage du serveur AEM était nécessaire pour que la source de données se connecte correctement à FDM.

Configuration du service cloud Adobe Analytics

Ce package est préconfiguré pour la connexion à Adobe Analytics. Les étapes ci-dessous permettent de mettre à jour cette configuration.
  1. Accédez à https://<aemserver>:<port>/libs/cq/core/content/tools/cloudservices.html
  2. Recherchez la section Adobe Analytics, puis sélectionnez le lien "Afficher les configurations".
  3. Sélectionnez la configuration "We.Gov Adobe Analytics (configuration Analytics)".
  4. Cliquez sur le bouton "Modifier" pour mettre à jour la configuration d’Adobe Analytics (vous devrez fournir le secret partagé). Cliquez sur "Se connecter à Analytics" pour vous connecter et sur "OK" pour terminer.
  5. Dans la même page, cliquez sur "We.Gov Adobe Analytics Framework (Analytics Framework)" si vous souhaitez mettre à jour les configurations de la structure (voir Activation de la création AEM pour activer la création).

Adobe Analytics

de sites Adobe Analytics

  1. Accédez à https://<aemserver>:<port>/sites.html/content
  2. Sélectionnez "Site Web AEM Forms We.Gov" pour les pages du site.
  3. Sélectionnez l’une des pages du site (par exemple, Accueil), puis sélectionnez "Analyses et recommandations".
  4. Sur cette page, vous verrez les informations extraites d’Adobe Analytics qui se rapportent à la page Sites AEM (remarque : par conception, ces informations sont régulièrement actualisées à partir d’Adobe Analytics et ne s’affichent pas en temps réel).
  5. De retour sur la page de de de la page (accessible à l’étape 3.), vous pouvez également les informations de la page en modifiant le paramètre d’affichage en éléments de dans le "de la page".
  6. Localisez le menu déroulant "" et sélectionnez " ".
  7. Dans le même menu, sélectionnez "Paramètre " et sélectionnez les colonnes à afficher dans la section "Analyses".
  8. Cliquez sur "Mettre à jour" pour rendre les nouvelles colonnes disponibles.

Adobe Analytics forms

  1. Accédez à .
    https://<aemserver>:<port>/aem/forms.html/content/dam/formsanddocuments/adobe-gov-forms
  2. Sélectionnez le formulaire adaptatif "Demande d’inscription pour les avantages de santé" et sélectionnez l’option "Rapport Analytics".
  3. Patientez jusqu’à ce que la page se charge et les données du rapport Analytics.

Adobe Analytics

Vous pouvez également accéder directement à Adobe Analytics pour afficher les données d’analyse.
  1. Connectez-vous à l’aide de vos informations d’identification :
    1. : Démo d’AEM Forms
    2. Utilisateur : <disponible sur demande>
    3. Mot de passe : <disponible sur demande>
  2. Sélectionnez "Site de référence We.Gov" dans Report Suites.
  3. Sélectionnez l’un des rapports disponibles pour afficher les données d’analyse de ce rapport.

Personnalisation du package de démonstration

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

Activation de la création AEM

Ce package de démonstration comprend un fichier de configuration de service OSGI qui contrôle le comportement du service WCM Filter sur le serveur de l’auteur . Cette configuration fait fonctionner le serveur en mode d'auteur désactivé (équivalent à ?wcmmode=disabled) afin d'autoriser la démonstration. Pour mettre à jour cette configuration et activer la création, procédez comme suit :
  1. Navigate to https://<aemserver>:<port>/system/console/configMgr
  2. Recherchez et cliquez sur le service de filtrage WCM Day CQ pour le configurer.
  3. Définissez la valeur de "Mode ​WCM" sur " Modifier ".
  4. Click “ Save ” to apply the configuration.

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 comprennent les modèles Site AEM, Formulaire adaptatif et Communications interactives, créés et assemblés avec des composants disponibles à l’adresse suivante :
https://<aemserver>:<port>/crx/de/index.jsp#/apps/we-gov/components

Style system

Ce site comporte également des bibliothèques-clients, dont l'une importe Bootstrap 4 ( https://getbootstrap.com/ ). Cette bibliothèque cliente est disponible à l’adresse
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 les stratégies de modèle/page qui utilisent les classes CSS Bootstrap 4 pour la pagination, la mise en forme, etc. Toutes les classes n’ont pas été ajoutées aux stratégies de modèle, mais toute classe prise en charge par Bootstrap 4 peut être ajoutée aux stratégies. Consultez la page de prise en main pour un de classes disponibles :
Les modèles inclus dans ce package prennent également en charge le système de style :

Logos de modèles

Project DAM Assets inclut également des logos et des images 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 marque en modifiant les composants Navigation et Pied de page. Ces composants une boîte de dialogue de marque et de logo configurable qui peut être utilisée pour mettre à jour les logos :
Pour plus d’informations, voir Modification du contenu d’une page :

Personnalisation des pages de sites

Toutes les pages du site sont disponibles à partir de : https://<aemserver>:<port>/sites.html/content/we-gov
Ces pages de site utilisent également le package de grille AEM pour contrôler la mise en page de quelques composants.

Style system

Les pages incluses dans ce package prennent également en charge le système de style :
Vous pouvez également consulter le système de style de personnalisation des modèles pour obtenir de la documentation sur les styles pris en charge.

Personnalisation des formulaires adaptatifs

Tous les formulaires adaptatifs sont disponibles à partir de :
https://<aemserver>:<port>/aem/forms.html/content/dam/formsanddocuments/adobe-gov-forms
Ces formulaires peuvent être personnalisés en fonction de certains cas d’utilisation. Notez que certains champs et la logique d’envoi ne doivent pas être modifiés pour garantir le bon fonctionnement du formulaire. Cela inclut :
Demande D'Inscription Pour Les Prestations De Santé :
  • contact_id - Champ masqué utilisé pour recevoir l'ID de contact MS Dynamics pendant l'envoi
  • Soumettre - 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 de formulaires.
  • Panneau racine : l’ 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.

Style de formulaire adaptatif

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

Personnalisation du processus

Formulaire adaptatif d’inscription envoyé à un processus OSGI pour traitement. Ce flux de travaux se trouve à l’adresse https://<aemserver>:<port>/conf/we-gov/settings/models/we-gov-process.html .
En raison de certaines limitations, ce flux de travaux contient plusieurs scripts et étapes de processus OSGI personnalisés. Ces étapes de flux de travail ont été créées sous forme d’étapes génériques et n’ont pas été créées avec des dialogues de configuration. Actuellement, la configuration des étapes du processus repose sur des arguments de processus.
Tout le code Java de l’étape de flux de travail est contenu dans le lot we-gov-forms.core-<version>.jar .

Remarques concernant les démos 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.

Remarques concernant les démos

  • Conformément à AGRS-159, assurez-vous que le nom (premier, milieu et dernier) du contact utilisé dans le formulaire adaptatif d’inscription est unique.
  • Le formulaire adaptatif d’inscription envoie le courrier électronique Adobe Sign au courrier électronique spécifié dans le champ de courrier électronique du formulaire. Cette adresse électronique ne peut pas être la même que celle utilisée pour configurer la configuration du cloud Adobe Sign.
  • Par défaut, le package de démonstration inclut plusieurs configurations de service OSGI pour contrôler le comportement global du serveur de hébergeant la démonstration. Ces configurations incluent une configuration de service de filtre WCM qui, par défaut, rend le serveur opérationnel en mode auteur ​désactivé (équivalent à ?wcmmode=disabled). Voir Activer la création AEM pour autoriser la création de pages.

Problèmes connus

  • (AGRS-120) Le composant Navigation dans le site ne prend actuellement pas en charge les pages enfants imbriquées d’une profondeur supérieure à 2 niveaux.
  • (AGRS-159) L'actuel MS Dynamics FDM doit effectuer 2 opérations pour commencer, envoyer les données du formulaire adaptatif d'inscription à Dynamics, puis récupérer l'enregistrement 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.

Étapes suivantes

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