Installation et configuration des sites de référence AEM Forms set-up-and-configure-aem-forms-reference-sites
AEM Forms fournit une mise en oeuvre de site de référence pour démontrer comment AEM Forms aide les organisations gouvernementales et du secteur des services financiers à transformer leurs transactions complexes en expériences numériques simples et attrayantes, n’importe où, n’importe quand et sur n’importe quel appareil.
Les sites de référence We.Finance et We.Gov tirent parti de cas pratiques réels pour interagir avec les clients existants et potentiels, dès leur première touche, jusqu’à la gestion des correspondances et transactions de manière personnalisée et économique.
Les sites de référence vous permettent d’explorer et de présenter les principales fonctionnalités suivantes d’AEM Forms.
- Expérience de création simplifiée : formulaires adaptatifs attrayants et réactifs et communications interactives.
- Communications interactives pour créer des communications client interactives, personnalisées et réactives qui s’adaptent au paramètre et à la mise en page de l’appareil.
- Intégration de données permettant de se connecter à des sources de données disparates pour préremplir et envoyer des données de formulaire par le biais d’un modèle de données de formulaire.
- Processus Forms pour automatiser les processus d’entreprise et les workflows.
- Fonctionnalités avancées de gestion et de traitement des données utilisateur.
- Intégration à Acrobat Sign pour signer et envoyer en toute sécurité des formulaires adaptatifs.
- Intégration à Adobe Target pour diffuser des recommandations ciblées et effectuer des tests A/B afin d’optimiser le retour sur investissement d’un formulaire.
- Intégration à Adobe Analytics pour mesurer les performances d’un formulaire ou d’une campagne et prendre des décisions éclairées.
- Amélioration de l’expérience de remplissage de formulaire.
Les sites de référence fournissent des ressources réutilisables que vous pouvez utiliser comme modèles pour créer vos propres ressources.
-
Intégration à Acrobat Sign pour signer et envoyer en toute sécurité des formulaires adaptatifs.
-
Intégration à Acrobat Sign pour signer et envoyer en toute sécurité des formulaires adaptatifs.
Conditions préalables et étapes de configuration des sites de référence prerequisites-and-steps-to-set-up-reference-sites
Avant de configurer le site de référence, assurez-vous que vous disposez des éléments suivants :
-
AEM essentiels
AEM QuickStart, package de module complémentaire AEM Forms et packages de site de référence. Voir Versions d’AEM Forms pour les détails des modules complémentaires et des sites de référence.
-
Un service SMTP
Vous pouvez utiliser n’importe quel service SMTP. -
Compte de développeur Acrobat Sign et application API Acrobat Sign
Pour utiliser les fonctionnalités de signature numérique, un compte de développeur Acrobat Sign est requis. Voir Acrobat Sign.
-
Une instance en cours d’exécution de Microsoft Dynamics 365 à intégrer à AEM Forms. Pour exécuter le site de référence, vous importez les exemples de données dans l’instance Microsoft Dynamics afin de préremplir la communication interactive utilisée dans le site de référence.
-
Une instance en cours d’exécution d’AEM 6.4 avec le module complémentaire Forms. Pour plus d’informations, voir Installation et configuration d’AEM Forms.
Effectuez les étapes suivantes dans l’ordre recommandé pour configurer les sites de référence.
Installer et configurer AEM Forms install-and-configure-aem-forms
Installez et déployez AEM Forms comme décrit dans la section Installation et configuration d’AEM Forms sur OSGi.
Configurer SSL ssl
La configuration SSL est requise pour communiquer avec les serveurs Acrobat Sign. Pour obtenir des instructions détaillées, voir Activation de HTTP Over SSL.
/etc/map
dossier.Configuration de l’externaliseur de liens Day CQ externalizer
Dans AEM, la variable Externalizer est un service OSGI qui vous permet de transformer par programmation un chemin d’accès à une ressource (par exemple, /path/to/my/page) en URL externe et absolue (par exemple, https://www.mycompany.com/path/to/my/page) en ajoutant un chemin d’accès en préfixe avec un DNS préconfiguré. Voir Externalisation des URL.
Effectuez les étapes suivantes sur les instances de création et de publication :
-
Accédez à Configuration OSGi à l’adresse https://<hostname>:<port>/system/console/configMgr
-
Rechercher et appuyer sur Externalisateur de lien Day CQ configuration.
La boîte de dialogue Day CQ Link Externalizer (Externalisateur de lien Day CQ) s’ouvre pour modifier la configuration.
-
Dans la boîte de dialogue Day CQ Link Externalizer, dans le champ Domaines :
- Sur l’instance d’auteur, spécifiez une URL de publication accessible à partir d’un système externe. Par exemple, un nom d’hôte ou un serveur web de publication.
- Sur l’instance de publication, spécifiez les URL de création et de publication.
-
Sur les instances d’auteur et de publication, assurez-vous que l’URL du serveur local est spécifiée dans le champ Domaines .
-
Appuyez sur Enregistrer. Patientez un moment pour que tous les services redémarrent.
Configuration du service de messagerie Day CQ cqmail
La mise en oeuvre du site de référence nécessite l’envoi d’emails à des exemples d’utilisateurs lorsqu’ils remplissent et envoient des formulaires. La configuration du service de messagerie Day CQ vous permet de fournir les détails du service SMTP pour envoyer des courriers électroniques automatisés aux clients. Voir Configuration des notifications par courrier électronique.
Effectuez les étapes suivantes pour configurer le service de messagerie sur l’instance de publication :
- Accédez à Configuration OSGi à l’adresse https://<hostname>:<port>/system/console/configMgr
- Rechercher et appuyer sur Service de messagerie Day CQ pour l’ouvrir en vue de la configuration.
- Indiquez les valeurs hostname et port du serveur SMTP.
- Appuyez sur Enregistrer.
Remplacer la configuration XSS par défaut xss
Les modèles de courrier électronique pour le site de référence We.Finance contiennent des liens personnalisés dans les courriers électroniques. Ces liens ont un espace réservé comme ${placeholder}
. Ces espaces réservés sont remplacés par des valeurs réelles avant d’envoyer des emails. La configuration de protection XSS par défaut pour AEM n’autorise pas les accolades ({ }) dans l’URL dans le contenu du HTML. Cependant, vous pouvez remplacer la configuration par défaut en procédant comme suit sur l’instance de publication :
-
Copiez
/libs/cq/xssprotection/config.xml
dans/apps/cq/xssprotection/config.xml
. -
Ouvrez
/apps/cq/xssprotection/config.xml
. -
Dans le
common-regexps
, modifiez la variableonsiteURL
et enregistrez le fichier.<regexp name="onsiteURL" value="([\p{L}\p{N}\\\.\#@\$\{\}%\+&;\-_~,\?=/!\*\(\)]*|\#(\w)+)"/>
Après avoir configuré le serveur SMTP, essayez de remplir un formulaire à l’aide du personnage Sarah Rose et enregistrez-le en tant que brouillon. Lorsque vous enregistrez en tant que brouillon, vous avez la possibilité de recevoir le brouillon par courrier électronique. Lorsque vous appuyez sur Envoyer un courrier électronique si vous recevez un courrier électronique contenant un lien vers le brouillon de la demande, votre configuration de courrier électronique est correcte. Assurez-vous de vous connecter à l’aide des informations d’identification de Sarah pour afficher le brouillon.
Configuration des paramètres AEM DS aemds
AEM les paramètres du service DS sont requis sur l’instance de publication pour les communications par e-mail dans les cas d’utilisation du site de référence. Pour obtenir des instructions détaillées sur la configuration du service DS AEM sur l’instance de publication, voir Configuration des paramètres AEM DS.
Pour les sites de référence AEM Forms, dans le service de paramètres d’AEM, spécifiez l’URL du serveur de publication au lieu de l’URL du serveur de traitement.
/lc
dans l’URL du serveur de traitement si vous la configurez pour AEM Forms OSGi.Déploiement des packages de sites de référence refsite
Installez les packages de sites de référence suivants à l’aide de Distribution logicielle.
Pour en savoir plus sur l’utilisation des packages, voir Utilisation de modules.
Après avoir installé les packages et démarré les instances de création et de publication, accédez aux URL suivantes dans votre navigateur :
https://[server]:[port]/wegov
https://[server]:[port]/wefinance
Si votre installation est réussie, vous pouvez accéder aux landing pages des sites de référence We.Gov et We.Finance.
(Facultatif) Importation de données d’exemple dans Microsoft Dynamics optional-import-sample-data-into-microsoft-dynamics
Les sites de référence de la demande de prêt immobilier et de l’assurance automobile sont configurés pour utiliser les enregistrements de Microsoft Dynamics. Le package de site de référence installe une entité personnalisée et des exemples d’enregistrements que vous pouvez importer dans Microsoft Dynamics pour exécuter le site de référence. Effectuez les étapes suivantes pour migrer et configurer les exemples de données :
Pour importer l’entité personnalisée d’une demande d’assurance automobile :
- Téléchargez la WeFinanceAutoInsurance_1_0.zip package de solution à partir de
https://[server]:[port]/content/aemforms-refsite-collaterals/we-finance/auto-insurance/ms-dynamics/WeFinanceAutoInsurance_1_0.zip
sur votre instance d’auteur AEM. - Dans votre instance Microsoft Dynamics, accédez à Solutions dans le Paramètres et cliquez sur Importer. Sélectionnez le package et importez-le.
Pour importer l’entité personnalisée d’une demande d’assurance automobile :
-
Téléchargez la AEMFormsFSIRefsite_1_0.zip package à partir de https://[author]:[port]/content/aemforms-refsite-collaterals/we-finance/home-mortgage/ms-dynamics/AEMFormsFSIRefsite_1_0.zip. Sélectionnez le package et importez-le.
-
Dans votre instance Microsoft Dynamics, accédez à Solutions dans le Paramètres et cliquez sur Importer. Sélectionnez le package et importez-le.
Pour importer les enregistrements de client et de police d’assurance :
-
Téléchargez la We.Finance Customers.csv, We.Finance Auto Insurance Renewals.csv, et prêt immobilier fichiers de données des emplacements suivants sur votre instance d’auteur AEM :
https://[server]:[port/content/aemforms-refsite-collaterals/we-finance/auto-insurance/ms-dynamics/We.Finance Customers.csv
https://[server]:[port/content/aemforms-refsite-collaterals/we-finance/auto-insurance/ms-dynamics/We.Finance Auto Insurance Renewals.csv
https://[server]:[port]/content/aemforms-refsite-collaterals/we-finance/home-mortgage/ms-dynamics/Sarah%20Rose%20Contact.csv
-
Dans votre instance Microsoft Dynamics, procédez comme suit :
- Accédez à Ventes > Clients We.Finance et cliquez sur Importer.
- Accédez à Ventes > Assurance automobile We.Finance et cliquez sur Importer.
- Accédez à Ventes > Prêt immobilier We.Finance et cliquez sur Importer.
Configuration du service cloud OAuth pour Microsoft Dynamics configure-oauth-cloud-service-for-microsoft-dynamics
Configurez le service cloud OAuth dans AEM Forms pour activer la communication entre AEM Forms et Microsoft Dynamics. Effectuez les étapes suivantes pour configurer le Cloud Service OAuth sur les instances de création et de publication d’AEM :
- Sur AEM instance d’auteur, accédez à Outils > Cloud Services > Sources de données > globales. Appuyer Intégration de Refsite Dynamics icône et appuyez sur Propriétés.
- Accédez au compte Microsoft Azure Principale Directory. Ajoutez l’URL de configuration du service cloud copiée dans le URL de réponse pour votre application enregistrée. Enregistrez la configuration.
- Dans l’onglet Paramètres d’authentification, spécifiez Racine du service, ID client, Secret du client, et URL de ressource pour votre instance Microsoft Dynamics. Cliquez sur Connexion à OAuth qui redirige vers la page de connexion de Microsoft Dynamics.
- Indiquez vos informations de connexion. Une fois connecté, vous êtes redirigé vers la page de configuration du service cloud AEM Forms. Cliquez sur Enregistrer et fermer. La configuration du service cloud est enregistrée.
- Accédez à Forms > Intégrations de données > We.Finance. Sélectionnez Assurance automobile (Dynamics) et cliquez sur Modifier. Les entités Microsoft Dynamics sont répertoriées sous l’onglet Sources de données . Patientez jusqu’à ce que toutes les entités soient récupérées à partir de Microsoft Dynamics et répertoriées sous l’onglet Sources de données .
- Sélectionnez la Entité AutoInsuranceRenewal et cliquez sur Objet de modèle de test. Dans la section de demande d’entrée, indiquez la valeur de l’ID de client comme "900001", puis cliquez sur Test. La section Sortie affiche les enregistrements récupérés de Microsoft Dynamics pour l’ID de client 900001.
- Dans la section de demande d’entrée, indiquez la valeur de l’ID de client comme "900001", puis cliquez sur Test. La section Sortie affiche les enregistrements récupérés de Microsoft Dynamics pour l’ID de client 900001.
- Répétez les étapes 1 à 6 sur l’instance de publication.
Configuration du planificateur Acrobat Sign scheduler
Procédez comme suit sur les instances d’auteur et de publication :
-
Accédez à AEM console de configuration Web à l’adresse
https://[server]:[host]/system/console/configMgr
. -
Rechercher et appuyer sur Service de configuration Acrobat Sign pour l’ouvrir en vue de la configuration.
-
Configurer Expression du planificateur de mise à jour d’état as 0 0/2 * * * ?.
note note NOTE La configuration du planificateur ci-dessus vérifie l’état du service Acrobat Sign toutes les deux minutes. -
Appuyez sur Enregistrer.
Configuration du service cloud Acrobat Sign du site de référence sign-service
Procédez comme suit sur les instances d’auteur et de publication :
-
Accédez à Outils > Cloud Services > Acrobat Sign > global. Sélectionner AEM Forms Reference Site Sign et appuyez sur Propriétés.
note caution CAUTION Assurez-vous que le fichier https://[hôte]:[ssl_port]/mnt/overlay/adobesign/cloudservices/adobesign/properties.html L’URL est ajoutée à la liste des URL de redirection de la configuration OAuth de l’application API Acrobat Sign. -
Indiquez l’identifiant du client et le secret de la configuration OAuth de l’application Acrobat Sign.
-
(Facultatif) Sélectionnez le Activation d’Acrobat Sign pour les pièces jointes également et appuyez sur Connexion à Acrobat Sign. Il ajoute les fichiers joints à un formulaire adaptatif au document Acrobat Sign correspondant envoyé pour signature.
-
Appuyer Connexion à Acrobat Sign et connectez-vous avec vos informations d’identification Acrobat Sign.
Configuration du service de configuration commun à Forms anonymous
Procédez comme suit sur l’instance de publication pour autoriser l’accès aux utilisateurs anonymes :
- Accédez à AEM console de configuration Web à l’adresse
https://[server]:[port]/system/console/configMgr
. - Rechercher et appuyer sur Service de configuration commun à Forms pour l’ouvrir en vue de la configuration.
- Configurez la variable Autoriser champ pour Tous les utilisateurs.
- Appuyez sur Enregistrer.
Modifier le service REST pour le modèle de données de formulaire fdm
Procédez comme suit sur les instances d’auteur et de publication :
- Accédez à CRXDE à l’adresse
https://[server]:[port]/crx/de/index.jsp
. - Accédez à /conf/global/settings/cloudconfigs/fdm/roi-rest/jcr:content/swaggerFile et ouvrez le fichier swagger.
- Mettez à jour les paramètres d’hôte et de port en fonction de votre environnement.
- Enregistrez les paramètres.
- (Instance de création uniquement) Accédez à Outils > Cloud Services > Sources de données > global. Sélectionner roi-rest et appuyez sur Propriétés. Appuyer Paramètres d’authentification et défini Type d’authentification to Authentification de base. Spécifier
admin
/admin
comme nom d’utilisateur/mot de passe pour accéder au service. Appuyez sur Enregistrer et fermer.
Intégration à Marketing Cloud integrate-with-marketing-cloud
Vous pouvez intégrer AEM Forms à Adobe Analytics et Adobe Target. Bien qu’Adobe Analytics vous aide à générer des rapports et à analyser les performances des formulaires adaptatifs, Adobe Target vous aide à fournir des expériences personnalisées et à effectuer des tests A/B pour les formulaires adaptatifs.
Procédez comme suit pour configurer Adobe Analytics et Adobe Target dans AEM Forms.
Configuration d’Adobe Analytics configure-adobe-analytics
L’intégration d’AEM Forms à Adobe Analytics vous permet de surveiller et d’analyser la manière dont vos clients interagissent avec vos formulaires et documents. Il vous aide à identifier et à résoudre les zones à problème et à agir pour augmenter le taux de conversion.
Pour tester cette fonctionnalité sur le site de référence, configurez votre compte Analytics comme décrit dans la section Configuration des analyses et des rapports.
Pour générer un rapport, les données sources sont regroupées avec les sites de référence. Avant d’utiliser les données sources, procédez comme suit :
-
Assurez-vous que les configurations d’analyse We.Finance et We.Gov sont disponibles dans les services cloud AEM. Vous pouvez trouver les services cloud de l’une des manières suivantes :
- Accédez à Outils > Cloud Services > Cloud Services hérités ou accédez à https://<host>:<port>/libs/cq/core/content/tools/cloudservices.html.
- Dans le Cloud Services page, sous Adobe Analytics , cliquez sur
Show Configurations
. Vous pouvez voir les configurations We.Finance et We.Gov disponibles. Cliquez sur pour ouvrir la configuration. Dans la page de configuration, cliquez sur Modifier. Indiquez un nom d’utilisateur, une société valide, un secret partagé (mot de passe) et un centre de données, puis cliquez sur Connexion à Analytics. Une fois la boîte de dialogue Connexion réussie, cliquez sur OK dans la boîte de dialogue de configuration. Configurez la structure sous la configuration Analytics comme décrit dans la section Configuration des analyses et des rapports.
-
Accédez à https://<hôte>:<port>/system/console/configMgr et procédez comme suit :
- Dans le Configuration de la console web page, rechercher et cliquer Configuration d’AEM Forms Analytics.
- Dans le Structure de SiteCatalyst dans le champ de la boîte de dialogue Configuration d’AEM Forms Analytics, sélectionnez we-finance (we-finance) ou we-gov (we-gov).
- Cliquez sur Enregistrer et laisser la page s’actualiser.
-
Accédez au gestionnaire de formulaires à l’adresse https://<host>:<port>/aem/forms et procédez comme suit :
- Ouvrez le dossier We.Finance ou We.Gov, puis sélectionnez le formulaire pour lequel vous souhaitez afficher le rapport.
- Cliquez sur Activer Analytics dans la barre d’outils Actions. Après avoir activé les analyses pour le formulaire, cliquez sur Rapport d’analyse. Vous pouvez voir un rapport vierge généré. Une fois qu’un rapport vierge a été généré, vous devez fournir les données sources fournies avec le package refsite pour générer le rapport d’analyse à des fins de démonstration.
Les sites de référence fournissent des rapports d’analyse avec des données sources pour les cas d’utilisation de cartes de crédit, de prêts hypothécaires et d’allocations familiales. Pour la configuration des données sources, voir Présentation du site de référence We.Finance et Présentation du site de référence We.Gov.
Configuration de Target configure-target
Le site de référence présente l’intégration d’AEM Forms à Adobe Target qui vous permet d’inclure du contenu ciblé et personnalisé dans les documents adaptatifs. Il permet également de créer des tests A/B pour les formulaires adaptatifs.
Pour tester l’intégration dans le site de référence, procédez comme suit pour configurer Target dans AEM :
-
Démarrez le démarrage rapide de l’auteur avec l’argument jvm.
-Dabtesting.enabled=true
pour activer les tests A/B sur le serveur.Remarque: Si l’instance d’AEM est en cours d’exécution sur JBoss, qui est démarré en tant que service à partir de l’installation clé en main, ajoutez le
-Dabtesting.enabled=true
dans l’entrée suivante dujboss\bin\standalone.conf.bat
fichier, :set "JAVA_OPTS=%JAVA_OPTS% -Dadobeidp.serverName=server1 -Dfile.encoding=utf8 -Djava.net.preferIPv4Stack=true -Dabtesting.enabled=true"
-
Accédez à https://<hostname>:<port>/libs/cq/core/content/tools/cloudservices.html.
-
Dans le Adobe Target , cliquez sur Afficher les configurations. Vous pouvez voir la configuration de Target We.Finance disponible. Cliquez sur pour ouvrir la configuration. Dans la page de configuration, cliquez sur Modifier. Le Modifier le composant pour la configuration s’ouvre.
-
Indiquez votre code client, votre adresse électronique et votre mot de passe associés à votre compte Target. Sélectionnez le type d’API comme REST.
-
Cliquez sur Connexion à Adobe Target. Une fois le compte Target configuré, cliquez sur OK. Vous pouvez voir que la configuration empaquetée comporte une structure Target.
-
Rendez-vous sur https://<nom de lʼhôte>:<port>/system/console/configMgr.
-
Cliquez sur Configuration d’AEM Forms Target.
-
Sélectionnez une structure Target.
-
Dans le URL Target , indiquez l’URL vers AEM Forms. Par exemple : https://<hostname>:<port>.
-
Cliquez sur Enregistrer.
Les cas pratiques de demande de carte de crédit et de demande de prêt immobilier montrent comment effectuer des tests A/B et présenter un rapport à des fins de démonstration. Pour des instructions, voir Présentation du site de référence We.Finance.
Étape suivante next-step
Vous êtes maintenant prêt à explorer le site de référence Pour plus d’informations sur le processus et les étapes du site de référence, voir :