Configurer la mise en cache pour la sortie configuring-caching-for-output

Le service Output permet de fusionner des données de formulaire XML dans une conception de formulaire créée dans Designer pour produire un flux de sortie de documents dans différents formats.

La page Output de la console d’administration contient des paramètres contrôlant la méthode de mise en cache d’éléments par le service Output. Vous pouvez ajuster ces paramètres pour optimiser les performances du service Output.

Le service Output met en cache les éléments suivants :

Le service Output stocke le cache à deux emplacements :

Définition du mode de cache specifying-the-cache-mode

Le service Output gère deux modes de mise en cache :

Si vous basculez entre les différents modes de mise en cache, redémarrez le service Output pour que ce changement soit appliqué. Pour redémarrer ce service, utilisez Workbench ou consultez la section Démarrage ou arrêt des services associés aux modules AEM Forms pour obtenir des instructions.

L’heure du point de contrôle du cache est automatiquement réinitialisée lors du basculement d’un mode à l’autre.

Utilisation de la mise en cache sans condition using-unconditional-caching

Dans ce mode, lorsque le service Output reçoit une demande, il valide les ressources requises (conception de formulaire et toute ressource liée comme les fragments et les images). Le service compare la date et l’heure des ressources du référentiel à celles des ressources du cache. Si la ressource du cache est plus ancienne, le service la met à jour.

Ce mode de mise en cache garantit l’utilisation des ressources les plus récentes. Cependant, les performances sont affectées car le service Output valide les éléments mis en cache en les comparant à ceux du référentiel à chaque demande. Ce mode de mise en cache convient aux environnements de développement ou de test dans lesquels les ressources sont fréquemment mises à jour et pour lesquels les performances ne sont pas la priorité.

Définition de la mise en cache sans condition

Utilisation du point de contrôle du cache use-the-cache-check-point

Lorsqu’il est dans ce mode, le service Output ne recherche les versions des ressources les plus récentes dans le référentiel que lorsque la date et l’heure de la ressource mise en cache est antérieures à l’heure du point de contrôle du cache. L’heure du point de contrôle du cache le plus récent s’affiche dans la page Output de la console d’administration.

Utilisez ce mode de mise en cache dans des environnements de production hautement performants où les performances sont d’un intérêt important et où les modifications apportées aux ressources sont peu fréquentes. Vous pouvez réinitialiser l’heure du point de contrôle du cache lorsque vous souhaitez déployer les modifications apportées aux ressources du référentiel.

Définition de l’utilisation d’un point de contrôle du cache

Réinitialisation du point de contrôle du cache

Réinitialisation du contenu du cache reset-the-cache-contents

Vous pouvez vider le contenu du cache à tout moment. Après la réinitialisation du cache, la première demande est plus lente pour chaque formulaire, car le service Output effectue un rendu complet et crée un nouveau contenu de cache.

Configuration des paramètres du cache configuring-cache-settings

Vous pouvez spécifier les paramètres utilisés par le service Output pour la mise en cache, de façon à optimiser les performances de l’environnement AEM Forms.

Pour accéder à ces paramètres, dans la console d’administration, cliquez sur Services > Output.

Définition des paramètres du cache global specifying-global-cache-settings

Les paramètres de la zone Paramètres du cache global affectent tous les types de cache. Si vous modifiez l’un de ces paramètres, redémarrez le service Output pour que ce changement soit appliqué. Pour redémarrer ce service, utilisez Workbench ou consultez la section Démarrage ou arrêt des services associés aux modules AEM Forms pour obtenir des instructions.

Taille max. du document du cache (Ko) : taille maximale, en kilo-octets, d’une conception de formulaire ou autre ressource pouvant être stockée dans un cache mémoire. Ce paramètre global s’applique à tous les caches mémoire. Si une ressource est supérieure à cette valeur, elle n’est pas mise en cache dans la mémoire. La valeur par défaut est 1024 kilo-octets. Ce paramètre n’a aucune incidence sur le cache disque.

Mise en cache des rendus de formulaire activée : cette option est sélectionnée par défaut, ce qui signifie que les formulaires rendus sont mis en cache pour récupération ultérieure. Ce paramètre a peu d’effet sur les performances du service Output, car il ne met pas en cache les documents non interactifs. Cette option n’a aucune incidence lorsque vous utilisez le service Output avec des documents non interactifs rendus sur le client.

Mise en cache des conceptions de formulaire caching-form-designs

Lorsque le service Output reçoit une demande de rendu, il récupère la conception de formulaire dans le référentiel ou à partir d’une source HTTP et la met en cache. Cette mise en cache améliore les performances car le service Output récupère la conception de formulaire à partir du cache et non plus à partir du référentiel lors des requêtes de rendu ultérieures.

Le service Output met toujours les conceptions de formulaire en cache sur le disque. Si les conceptions de formulaire sont stockées sur le serveur, ces fichiers sont considérés comme le cache disque. Le service Output met également les conceptions de formulaire en cache dans la mémoire, en fonction du paramètre défini dans la zone Mise en mémoire cache des modèles. Si vous modifiez l’un de ces paramètres, redémarrez le service Output pour que ce changement soit appliqué. Pour redémarrer ce service, utilisez Workbench ou consultez la section Démarrage ou arrêt des services associés aux modules AEM Forms pour obtenir des instructions.

Taille du cache de configuration des modèles : nombre maximal d’objets de configuration de modèle à conserver en mémoire. La valeur par défaut est 100. Il est recommandé de la définir sur une valeur supérieure ou égale à celle de la Taille du cache des modèles. Ce paramètre n’a aucune incidence sur le cache disque.

Taille du cache des modèles : nombre maximal d’objets de contenu de modèle à conserver en mémoire. La valeur par défaut est 100. Ce paramètre n’a aucune incidence sur le cache disque.

Activé : cette case est cochée par défaut, ce qui signifie que les modèles de formulaire sont mis en mémoire cache. Si cette option n’est pas sélectionnée, les modèles de formulaire sont uniquement mis en cache sur le disque.

Mise en cache des fragments et images caching-fragments-and-images

Le service Output met en cache les fragments et les images utilisés dans les conceptions de formulaire sur le disque. Les performances sont améliorées, car les fragments et les images ne sont lus à partir du référentiel qu’à la première demande. Lors des demandes suivantes, le service Output lit les fragments et les images à partir du cache disque. Les fragments et les images ne sont mis en cache que sur le disque, pas dans la mémoire.

Vous pouvez utiliser les paramètres suivants pour contrôler la mise en cache de fragments et d’images sur le disque. Ces paramètres se situent dans la zone Paramètres du cache des ressources de modèle  :

Mise en cache de ressources : sélectionnez l’une des options suivantes dans la liste :

Activée pour les fragments et les images : le service Output met les fragments et les images en cache. Il s’agit de l’option par défaut.

Activée pour les fragments : le service Output met les fragments en cache, mais pas les images.

Désactivée : le service Output ne met ni les fragments, ni les images en cache.

Intervalle de nettoyage (secondes) : détermine la fréquence de suppression des anciens fichiers cache non valides par le service Output. Le service Output ne supprime pas les fichiers cache valides. Si vous modifiez l’intervalle de nettoyage, redémarrez le service Output pour que ce changement soit appliqué. Pour redémarrer ce service, utilisez Workbench ou consultez la section Démarrage ou arrêt des services associés aux modules AEM Forms pour obtenir des instructions.

Remarques concernant la mise en cluster pour les caches clustering-considerations-for-caches

Dans un environnement organisé en clusters, chaque nœud gère ses propres caches mémoire et disque. Le contenu du cache de chaque nœud dépend des formulaires rendus sur ce dernier.

L’emplacement du cache doit être identique (même disque et même chemin d’accès) pour chaque nœud du cluster. Ne placez pas le cache à un emplacement de stockage partagé.

Si vous utilisez la page Output dans la console d’administration pour modifier les paramètres de mise en cache d’un nœud particulier, les paramètres de mise en cache des autres nœuds sont mis à jour lorsqu’une demande atteint le nœud en question. Ce comportement s’applique également au bouton Réinitialiser le cache. Si vous cliquez sur le bouton Réinitialiser le cache pour un nœud, le cache est immédiatement supprimé de ce nœud. Le cache des autres nœuds est vidé lorsqu’une demande atteint le nœud en question.