8.5 Configuration de la solution Correspondence Management

Effectuez les tâches suivantes pour configurer la solution Correspondence Management.

Pour la configuration recommandée pour la solution Correspondence Management, voir Topologie de la solution Correspondence Management .

8.5.1 Configuration de l’instance d’auteur

L’instance d’auteur est intégrée dans le serveur AEM forms on JEE. Cela signifie qu’il n’est pas nécessaire d’effectuer des mises à jour de configuration de l’instance d’auteur. L’instance hérite de tous les paramètres de configuration du serveur AEM forms on JEE.

8.5.2 Configuration de l’instance de publication

Vous devez exécuter des instances distinctes d’auteur et de publication pour la solution Correspondence Management. Toutefois, vous pouvez configurer les deux instances sur le même ordinateur ou sur deux ordinateurs différents. Une instance d’auteur est incluse dans l’application principale AEM forms on JEE et s’exécute sur le serveur AEM forms on JEE. Pour l’instance de publication, LCM configure un fichier EAR de publication ( adobe-livecycle-cq-publication.ear ). Déployez le fichier EAR de publication sur une instance de serveur distincte.

Remarque : Avant de configurer l’instance de publication, assurez-vous que l’instance d’auteur est configurée et déployée. Vous pouvez le vérifier en vous connectant au modèle de solution pour la solution Correspondence management. Pour plus d’informations, voir la section Accès au modèle de solution Correspondence Management de ce document.

  1. Créez une instance de serveur dans un domaine WebLogic différent.

  2. Copiez le répertoire [ racine aem-forms ]/crx-repository du serveur de l’instance d’auteur à celui de l’instance de publication.

  3. Depuis le répertoire crx-repository du serveur de l’instance de publication, ouvrez le dossier crx-repository/install . Conserver les packages suivants et supprimez toutes les autres packages dans le dossier d’installation :

    • dataservices-pkg.zip

    • platform-common-pkg.zip

    • platform-content-pkg.zip

    • platform-security-pkg.zip

    • solution-correspondencemanagement-pkg.zip

  4. Démarrez le serveur de publication à l’aide du paramètre -Dcom.adobe.livecycle.crx.home=< emplacement de crx-repository > , où < emplacement de crx-repository > correspond à l’emplacement où vous avez copié le répertoire crx-repository pour l’instance de publication.

    Pour plus d’informations sur la configuration des arguments JVM génériques pour WebSphere et WebLogic, voir la section Configuration des arguments JVM pour WebSphere et WebLogic .

  5. Déployez adobe-livecycle-cq-publish.ear sur le serveur.

Remarque : Si les instances de publication et d’auteur se trouvent sur le même ordinateur, veillez à démarrer l’instance de publication avec un port différent.

Maintenant que l’instance de publication fonctionne, vous devez configurer les deux instances pour qu’elles communiquent ensemble.

8.5.3 Configuration des nœuds de publication à intégrer à AEM forms on JEE

Exécutez ces étapes sur toutes les instances de publication. Pour activer la communication entre l’instance de publication et le serveur AEM forms on JEE :

  1. Allez à http://[ hôte de publication ]:[ port de publication ]/lc/system/console/configMgr et connectez-vous avec les informations d’identification d’utilisateur de la console de gestion OSGi. Les informations d’identification par défaut sont admin/admin

  2. Recherchez l’icône Editer en regard du paramètre Adobe LiveCycle Client SDK Configuration et cliquez dessus.

  3. Dans le champ Server URL (URL de serveur), vérifiez que http://[ lchost ]:[ lc port ] est spécifié.
    Important : vérifiez que le serveur AEM forms on JEE écoute la combinaison d’hôte et de port spécifiée. Les trois scénarios suivants sont possibles dans une grappe de serveurs AEM forms on JEE :

    • Toutes les instances de serveur AEM forms on JEE s’exécutent sur hôtelocal et le même port. Dans ce cas, utilisez hôtelocal:[port] .

    • Toutes les instances de serveur AEM forms on JEE s’exécutent sur hôtelocal , mais sur des ports différents. Dans ce cas, utilisez une combinaison de nom d’hôte et port d’équilibreur de charge : [hôte_équilibreurDeCharge]:[port_équilibreurDeCharge] .

    • Toutes les instances de serveur AEM forms on JEE s’exécutent sur un nom d’hôte particulier (différent de hôtelocal ) et des ports similaires/différents. Dans ce cas, utilisez un nom d’hôte et un port d’équilibreur de charge : [hôte_équilibreurDeCharge]:[port_équilibreurDeCharge] .

    Si vous souhaitez utiliser une URL d’équilibrage de charge pour accéder à la grappe de serveurs AEM forms on JEE (comme indiqué ci-dessus), veillez à ce que les ports de communication requis entre les instances d’auteur et l’équilibrage de charge soient ouverts.

  4. Spécifiez les informations d’identification de l’administrateur d’AEM forms on JEE dans les champs Nom d’utilisateur et Mot de passe.

  5. Cliquez sur Enregistrer .

8.5.4 Communication entre les instances d’auteur et de publication

Vous devez effectuer certaines modifications de configuration pour activer la communication bidirectionnelle entre les instances d’auteur et de publication.

8.5.4.1 Configuration des agents de réplication (Définition de l’URL de l’instance de publication)

Sur l’instance d’auteur, vous devez configurer les agents de réplication pour chaque instance de publication. Ces agents répliquent le contenu des instances d’auteur dans toutes les instances de publication.

  1. Connectez-vous à l’interface utilisateur Outils à http://<hôte auteur>:<port auteur>/lc/miscadmin

  2. Sélectionnez Réplication , puis Agents sur l’auteur dans le volet de gauche.

    Dans le volet de droite, vous voyez différents agents configurés pour l’instance de l’auteur.

  3. Dans le volet droit, sélectionnez Nouveau .... Puis cliquez sur Nouvelle page .

    La boîte de dialogue Créer une page s’affiche.

  4. Définissez le Titre et le Nom , puis sélectionnez Agent de réplication .

  5. Cliquez sur Créer pour créer un nouvel agent.

  6. Double-cliquez sur le nouvel élément de l’agent pour ouvrir le panneau de configuration.

  7. Cliquez sur Modifier . La boîte de dialogue Paramètres de l’agent s’affiche.

    1. Dans l’onglet Paramètres :

      • Saisissez une Description .

      • Sélectionnez Activé .

      • Sélectionnez la sérialisation du type comme valeur par défaut .

      • Définissez le délai de nouvel essai à 60000 .

      • Définissez le niveau de journal sur Info .

    2. Dans l’onglet Transport :

      • Saisissez l’URI requise pour l’instance de publication occurrence http://<hôte de publication>:<port de publication>/lc/bin/receive?sling:authRequestLogin=1

      • Définissez l’ utilisateur et le mot de passe . Les informations d’identification par défaut sont admin/admin

  8. Cliquez sur OK pour enregistrer les paramètres.

  9. Sur le volet de configuration de l’agent, cliquez sur Tester la connexion .

    La connexion réussie assure que la configuration est effectuée correctement.

Remarque : Si vous n’avez qu’une seule instance de publication, vous pouvez utiliser l’agent de réplication par défaut nommé publish. Vous devez le modifier pour la spécification de l’URI de publication dans l’onglet Transport comme mentionné à l’étape b(i). Dans ce cas, vous n’avez pas besoin de créer un nouvel agent de réplication.
Remarque : Si vous disposez d’une batterie de publication (plusieurs instances de publication non clusterisées), vous devez créer un agent de réplication pour chaque instance de publication comme mentionné dans les étapes 1-9. Pour chacun de ces agents de réplication, le titre et le nom doivent être significatifs et uniques, de sorte que l’identification de l’instance de publication correspondante puisse être plus simple. Chacun de ces agents de réplication dispose d’un autre URI dans l’onglet Transport pointant vers une instance de publication particulière. Pour plusieurs instances de publication, vous pouvez également créer des agents de réplication en copiant l’agent de publication par défaut puis en modifiant l’URI dans l’onglet Transport de l’agent créé. Si vous n’utilisez pas l’agent de réplication par défaut, désactivez-le, afin d’éviter une tentative de réplication inutile.
Remarque : Pour les grappes d’auteur, ces étapes doivent être exécutées sur une instance d’auteur (instance maître de préférence).

8.5.4.2 Définition de l’URL de l’instance de publication pour ActivationManagerImpl

  1. Accédez à http://< hôteAuteur >:< portAuteur >/lc/system/console/configMgr. Connectez-vous avec les informations d’identification d’utilisateur de la console de gestion OSGi. Les informations d’identification par défaut sont admin/admin

  2. Recherchez l’icône d’édition située en regard du paramètre com.adobe.livecycle.content.activate.impl.ActivationManagerImpl.name et cliquez dessus.

  3. Dans le champ ActivationManager Publish URL (URL de publication ActivationManager), spécifiez l’URL pour accéder à l’instance de publication ActivationManager. Vous pouvez fournir les URL suivantes.

    1. U RL d’équilibreur de charge (recommandée) : saisissez l’URL de l’équilibreur de charge, si vous avez un serveur Web agissant en tant qu’équilibreur de charge devant la batterie de publication (plusieurs instances de publication non clusterisées).

    2. URL d’instance de publication : saisissez toute URL d’instance de publication, si vous avez une instance de publication unique ou si le serveur Web donnant la batterie de publication n’est pas accessible à partir de l’environnement d’auteur en raison de restrictions. Dans le cas où l’instance de publication indiquée n’est pas disponible, un mécanisme de secours est disponible pour traiter le côté auteur.

    Chaîne d’URL : http://<nom d’hôte>:<port>/lc/bin/remoting/lc.content.remote.activate.activationManager

  4. Cliquez sur Enregistrer .

8.5.4.3 Configuration de la file d’attente de réplication inversée

Sur l’instance d’auteur, vous devez configurer les agents de réplication inversée pour chaque instance de publication. Ces agents répliquent du contenu à partir de l’instance de publication vers l’instance d’auteur.

  1. Connectez-vous à l’interface utilisateur Outils à http://<hôte auteur>:<port auteur>/lc/miscadmin

  2. Sélectionnez Réplication , puis Agents sur l’auteur dans le volet de gauche.

    Dans le volet de droite, vous voyez différents agents configurés pour l’instance de l’auteur.

  3. Sur le volet droit, sélectionnez Nouveau , puis cliquez sur Nouvelle page .

    La boîte de dialogue Créer une page s’affiche.

  4. Définissez le Titre et le Nom , puis sélectionnez Agent de réplication inversée .

  5. Cliquez sur Créer pour créer un nouvel agent.

  6. Double-cliquez sur le nouvel élément de l’agent pour ouvrir le panneau de configuration.

  7. Cliquez sur Modifier . La boîte de dialogue Paramètres de l’agent s’affiche.

    1. Dans l’onglet Paramètres :

      • Saisissez une description

      • Sélectionnez Activé .

      • Définissez le délai de nouvel essai à 60000 .

      • Définissez le niveau de journal sur Info .

    2. Dans l’onglet Transport :

      • Saisissez l’URI requise pour l’instance de publication occurrence http://<hôte de publication>:<port de publication>/lc/bin/receive?sling:authRequestLogin=1

      • Définissez l’ utilisateur et le mot de passe : admin/admin

    3. Dans l’onglet Etendu : définissez la méthode HTTP sur GET

  8. Cliquez sur OK pour enregistrer les paramètres.

  9. Sur le volet de configuration de l’agent, cliquez sur Tester la connexion .

La connexion réussie assure que la configuration est effectuée correctement.

Remarque : Si vous n’avez qu’une seule instance de publication, vous pouvez utiliser l’agent de réplication par défaut nommé publish_reverse . Vous devez le modifier pour la spécification de l’URI de publication dans l’onglet Transport comme mentionné à l’étape b(i). Dans ce cas, vous n’avez pas besoin de créer un nouvel agent de réplication inversée.
Remarque : Si vous disposez d’une batterie de publication (plusieurs instances de publication non clusterisées), vous devez créer un agent de réplication inversée pour chaque instance de publication comme mentionné dans les étapes 1-9. Pour chacun de ces agents de réplication, le titre et le nom doivent être significatif et unique, de sorte que l’identification de l’instance de publication correspondante puisse être plus simple. Chacun de ces agents de réplication dispose d’un autre URI dans l’onglet Transport pointant vers une instance de publication particulière. Pour plusieurs agents de publication, vous pouvez également créer des agents de réplication inversée en copiant l’agent par défaut publish_reverse puis en modifiant le nom et l’ URI dans l’onglet Transport de l’agent créé. Si vous n’utilisez pas l’agent de réplication inversée par défaut, désactivez-le, afin d’éviter une tentative de réplication inutile.
Remarque : Pour les grappes d’auteur, ces étapes doivent être exécutées sur une instance d’auteur (instance maître de préférence).

8.5.4.4 Définition de l’URL de l’instance d’auteur pour VersionRestoreManagerImpl

  1. Accédez à http://< hôtePublication >:< portPublication >/lc/system/console/configMgr . Connectez-vous avec les informations d’identification d’utilisateur de la console de gestion OSGi. Les informations d’identification par défaut sont admin/admin

  2. Recherchez l’icône d’édition située en regard du paramètre com.adobe.livecycle.content.activate.impl.VersionRestoreManagerImpl.name et cliquez dessus.

  3. Dans le champ VersionRestoreManager Author URL (URL d’auteur VersionRestoreManager), spécifiez l’URL de l’instance d’auteur VersionRestoreManager.

    Chaîne d’URL : http://<nom d’hôte>:<port>/lc/bin/remoting/lc.content.remote.activate.versionRestoreManager

    Remarque : S’il existe plusieurs instances d’auteur (en grappe) derrière un équilibreur de charge, spécifiez l’URL de l’équilibreur de charge dans le champ d’URL d’auteur VersionRestoreManager.

  4. Cliquez sur Enregistrer .

8.5.5 Installation d’exemples d’utilisateur

Vous pouvez installer des exemples d’utilisateur avec des autorisations d’utilisateurs prédéfinies afin d’explorer plus en détail le modèle de solution, que vous pouvez par ailleurs personnaliser afin de créer votre propre solution.

  1. Accédez à http://< hôteAuteur > :< portAuteur >/lc/crx/explorer/index.jsp.

  2. Connectez-vous à l’aide des informations d’identification de l’administrateur et cliquez sur Package Manager .

  3. Dans Package Manager , chargez le paquet samples-correspondencemanagement-pkg-< version >.zip depuis < LC_HOME >/deploy/crx.

  4. Cliquez sur Installer une fois que le paquet est téléchargé.

  5. Cliquez sur Installer dans la boîte de dialogue de confirmation afin d’installer les exemples d’utilisateurs.

Exemples d’utilisateurs Correspondence Management

Correspondence Management Solution Accelerator contient les exemples d’utilisateurs suivants. La participation de ces utilisateurs aux activités menant à la génération d’une communication interactive avec le client est attendue.

Les rôles suivants mentionnés sont automatiquement attribués aux utilisateurs lors de l’installation du package :

nom d’utilisateur ;

Rôle attribué

Responsabilités

Todd Goldman

Administrateur Correspondence Management

Administrateur général du système. Son rôle lui permet de modifier la totalité des actifs. Il lui permet également de définir les catégories.

Heather Douglas

Experte spécialisée Correspondence Management

Ce personnage possède un rôle lui permettant d’effectuer des opérations CRUD avec des textes et des images.

Caleb Lopez

Spécialiste d’applications Correspondence Management

Cet utilisateur définit le modèle de lettre grâce à une utilisation judicieuse d’objets de texte, d’images, de conditions et de listes. Avec ce rôle, l’utilisateur peut effectuer des opérations CRUD sur les modèles de lettre, mises en page, listes, conditions, textes et images.

Gloria Rios

Expert en assurance Correspondence Management

Un utilisateur de l’agent utiliserait le modèle de lettre défini par l’utilisateur de l’entreprise pour produire la communication par lettre à livrer au client.

Jocelyn Robinson

Conceptrice de formulaires Correspondence Management

Cette utilisatrice dispose de compétences lui permettant de concevoir des mises en page de formulaires dans LiveCycle Designer. Comme elle dispose du savoir-faire nécessaire pour concevoir des mises en page de formulaire à utiliser pour la gestion de correspondance, cette utilisatrice utilise LiveCycle Designer et créer les modèles XDP, qui serviraient de texte prédéfini à la lettre.

Frank Kricfalusi

Développeur Correspondence Management

Cet utilisateur dispose des connaissances en schémas XSD et en modélisation des données, et il est chargé de la création et de la maintenance des dictionnaires de données.

Pour plus d’informations sur les exemples d’utilisateur et les instructions de mise en œuvre d’une solution à l’aide d’un modèle de solution, voir le Guide de la solution Correspondence Management .
Remarque : pour les grappes d’auteur, ces étapes doivent être exécutées sur une instance d’auteur (instance maître de préférence).

8.5.6 Configuration de l’implémentation IPv6

Remarque : effectuez ces étapes uniquement si la solution Correspondence Management est exécutée sur un ordinateur utilisant une adresse IPv6.

Etapes de mappage de l’adresse IPv6 d’un nom d’hôte sur le serveur et les machines clientes :

  1. Accédez au répertoire C:\Windows\System32\drivers\etc.

  2. Ouvrez le fichier hosts dans un éditeur de texte.

  3. Ajoutez un mappage pour l’adresse IPv6 d’un nom d’hôte. Par exemple : 

    2001:1890:110b:712b:d1d:9c99:37ef:7281 <ipv6_hostname>

  4. Enregistrez le fichier, puis fermez-le.

Assurez-vous d’utiliser le nom d’hôte mappé au lieu de l’adresse IPv6 lors de l’accès à la solution Customer Experience.

8.5.7 Installation des polices japonaises pour Adobe Reader

Si vos actifs Correspondence Management utilisent les polices japonaises, vous devez installer le package de support pour le japonais pour Adobe Reader. Dans le cas contraire, vos lettres et formulaires ne s’afficheront pas et ne fonctionneront pas correctement. Pour l’installation des packs de langues, visitez la page des téléchargements d’Adobe Reader.