Personnaliser l'interface de création de correspondance

Présentation

Correspondence Management vous permet d’adapter le modèle de solution à l’identité graphique de votre société afin de conserver la valorisation de votre marque. Le changement d'identité graphique de l'interface utilisateur comprend la modification du logo de la société, qui est affiché dans le coin supérieur gauche de l'interface utilisateur de création de correspondance.

Vous pouvez changer le logo dans l'interface utilisateur de création de correspondance pour le remplacer par le logo de votre entreprise.

Icône personnalisée dans l’
interface utilisateur de création de correspondance : icône personnalisée dans l’interface utilisateur de création de correspondance

Modification du logo dans l'interface utilisateur de création de correspondance

Pour configurer une image de logo de votre choix, procédez comme suit :

  1. Créez la structure de dossiers appropriée dans CRX.

  2. Téléchargez le nouveau fichier logo dans le dossier que vous avez créé dans CRX.

  3. Configurez le CSS sur CRX pour faire référence au nouveau logo.

  4. Effacez l’historique du navigateur et actualisez l’interface utilisateur de création de correspondance.

Création de la structure de dossiers requise

Créez la structure de dossiers, comme expliqué ci-après, pour héberger l'image de logo et la feuille de style personnalisées. La nouvelle structure de dossiers avec le dossier racine /apps est similaire à la structure de dossier /libs.

Pour une personnalisation, créez une structure de dossiers parallèle, comme expliqué ci-après, dans la branche /apps.

La branche /apps (structure de dossiers) :

  • Garantit que vos fichiers sont sûrs en cas de mise à jour du système. En cas de mise à niveau, de Feature Pack ou de correctif, la branche /libs est mise à jour et si vous hébergez vos modifications dans la branche /libs, elles sont écrasées.
  • Vous aide à ne pas toucher au système/à la branche actuels, que vous pouvez ébranler par erreur si vous utilisez les emplacements par défaut pour enregistrer les fichiers personnalisés.
  • Aide vos ressources pour obtenir une priorité plus élevée si AEM recherche des ressources. AEM est configuré pour rechercher d’abord la branche /apps , puis la branche /libs pour trouver une ressource. Ce mécanisme signifie que le système utilise votre recouvrement (et les personnalisations qui y sont définies).

Suivez les étapes ci-dessous pour créer la structure de dossiers requise dans la branche /apps :

  1. Accédez à https://[server]:[port]/[ContextPath]/crx/de et connectez-vous en tant qu’administrateur.

  2. Dans le dossier des applications, créez un dossier nommé css dont le chemin d'accès/la structure est similaire au dossier css (situé dans le dossier ccrui).

    Procédure de création du dossier css :

    1. Cliquez avec le bouton droit sur le dossier css à l’emplacement suivant et sélectionnez Noeud de recouvrement : /libs/fd/cm/ccr/gui/components/admin/clientlibs/ccrui/css

      Nœud de recouvrement

    2. Assurez-vous que la boîte de dialogue du nœud de recouvrement possède les valeurs suivantes :

      Chemin d’accès : /libs/fd/cm/ccr/gui/components/admin/clientlibs/ccrui/css

      Emplacement de la superposition : /apps/

      Faire correspondre les types de noeud : coché

      Chemin d'accès au nœud de recouvrement

      REMARQUE

      N’effectuez pas de modifications dans la branche /libs. Toutes les modifications que vous apportez risquent d’être perdues, car cette branche est exposée aux modifications chaque fois que vous :

      • Effectuez une mise à niveau sur votre instance
      • Appliquez un correctif
      • Configurez un feature pack

    3. Cliquez sur OK. Le dossier CSS est créé au niveau du chemin d'accès indiqué.

  3. Dans le dossier des applications, créez un dossier nommé imgs avec un chemin/une structure semblables au dossier imgs (situé dans le dossier ccrui).

    1. Cliquez avec le bouton droit sur le dossier imgs à l’emplacement suivant et sélectionnez Noeud de recouvrement : /libs/fd/cm/ccr/gui/components/admin/clientlibs/ccrui/imgs

    2. Assurez-vous que la boîte de dialogue du nœud de recouvrement possède les valeurs suivantes :

      Chemin d’accès : /libs/fd/cm/ccr/gui/components/admin/clientlibs/ccrui/imgs

      Emplacement de la superposition : /apps/

      Faire correspondre les types de noeud : coché

    3. Cliquez sur OK.

      REMARQUE

      Vous pouvez également créer la structure de dossiers dans le dossier /apps manuellement.

  4. Cliquez sur Enregistrer tout pour enregistrer les modifications sur le serveur.

Téléchargez votre fichier de logo personnalisé dans CRX. Les règles HTML standard régissent le rendu du logo. Les formats de fichiers image pris en charge dépendent du navigateur que vous utilisez pour accéder à AEM Forms. Tous les navigateurs prennent en charge les fichiers JPEG, GIF et PNG. Pour en savoir plus, reportez-vous à la documentation du navigateur sur les formats d'image pris en charge.

  • Les dimensions par défaut de l’image du logo sont 48 px * 48 px. Assurez-vous que votre image est de cette taille ou d’une taille supérieure à 48 px * 48 px.
  • Si la hauteur de l'image de logo est de plus de 50 px, l'interface utilisateur de création de correspondance réduit l'image à une hauteur maximale de 50 px car il s'agit de la hauteur de l'en-tête. Lors de la réduction de l'image, l'interface utilisateur de création de correspondance conserve les proportions de votre image.
  • L'interface utilisateur de création de correspondance n'agrandit pas votre image si elle est petite. Vous devez donc vous assurer que vous utilisez une image de logo d'au moins 48 px de haut et d'une largeur suffisante pour la clarté.

Suivez les étapes ci-dessous pour télécharger le fichier du logo personnalisé dans CRX :

  1. Accédez à https://[server]:[port]/[contextpath]/crx/de. Le cas échéant, connectez-vous en tant qu’administrateur.

  2. Dans CRXDE, faites un clic droit sur le dossier imgs au niveau du chemin d'accès suivant et sélectionez Créer > Créer un fichier :

    /apps/fd/cm/ccr/gui/components/admin/clientlibs/ccrui/imgs/

    Créer un nouveau nœud dans le dossier imgs

  3. Dans la boîte de dialogue Créer un fichier, entrez le nom du fichier au format CustomLogo.png (ou le nom de fichier de votre logo).

    CustomLogo.png en tant que nouveau nœud

  4. Cliquez sur Enregistrer tout.

    Dans le nouveau fichier que vous avez créé (ici CustomLogo.png), la propriété jcr:content s'affiche.

  5. Cliquez sur jcr:content dans la structure de dossiers.

    Les propriétés de jcr:content s'affichent.

    jcrcontentproperties

  6. Double-cliquez sur la propriété jcr:data.

    La boîte de dialogue Edit jcr:data s'affiche.

    Cliquez maintenant sur le dossier newlogo.png , double-cliquez sur jcr:content (option dim) et définissez le type nt:resource. Dans le cas contraire, créez une propriété du nom de jcr:content.

  7. Dans la boîte de dialogue Edit jcr:data, cliquez sur Parcourir et sélectionnez le fichier image que vous souhaitez utiliser comme logo (ici, CustomLogo.png).

    Les formats de fichiers image pris en charge dépendent du navigateur que vous utilisez pour accéder à AEM Forms. Tous les navigateurs prennent en charge les fichiers JPEG, GIF et PNG. Pour en savoir plus, reportez-vous à la documentation du navigateur sur les formats d'image pris en charge.

    Exemple de fichier de logo personnalisé
    Figure : Exemple : CustomLogo.png à utiliser comme logo personnalisé

  8. Cliquez sur Enregistrer tout.

Créer le CSS pour intégrer le logo à l'interface utilisateur

L'image de logo nécessite une feuille de style supplémentaire à charger dans le contexte du contenu.

Effectuez les étapes suivantes pour définir la feuille de style pour le rendu du logo :

  1. Accédez à https://[server]:[port]/[contextpath]/crx/de. Le cas échéant, connectez-vous en tant qu’administrateur.

  2. Créez un fichier nommé customcss.css (vous ne pouvez pas utiliser un autre nom de fichier) à l’emplacement suivant :

    /apps/fd/cm/ccr/gui/components/admin/clientlibs/ccrui/css/

    Procédure à suivre pour créer le fichier customcss.css :

    1. Faites un clic droit sur le dossier css et sélectionnez Créer > Créer un fichier.

    2. Dans la boîte de dialogue Nouveau fichier, indiquez le nom du fichier CSS sous la forme customcss.css (vous ne pouvez pas utiliser un autre nom de fichier), puis cliquez sur OK.

    3. Ajoutez le code suivant dans le fichier CSS que vous venez de créer. Dans la partie content:url du code, indiquez le nom de l'image que vous avez téléchargée dans le dossier imgs dans CRXDE.

      .logo, .logo:after {
content:url("../imgs/CustomLogo.png");
}

    4. Cliquez sur Enregistrer tout.

Actualiser l'interface utilisateur de création de correspondance pour voir le logo personnalisé

Effacez la mémoire cache du navigateur, puis ouvrez l'instance de l'interface utilisateur de création de correspondance dans votre navigateur. Vous devez voir votre logo personnalisé.

Interface utilisateur de création de correspondance avec
logo personnaliséFigure : Icône personnalisée dans l’interface utilisateur de création de correspondance

Sur cette page