Service du gestionnaire d'état

Le service du gestionnaire d'état du portail constitue le point d'accès pour la gestion de l'état de navigation du portail. L'état de navigation représente la vue actuelle des ressources du portail telles qu'elles apparaissent à un utilisateur.

In the WebSphere® Integrated Solutions Console, the portal State Manager Service is listed as WP StateManagerService.

Le service du gestionnaire d'état du portail contient les propriétés suivantes :

preprocessors = (com.ibm.wps.state.preprocessors.selection.StandardPortalSelectionImpl )

Cette propriété permet de définir une liste d'un ou de plusieurs préprocesseurs utilisés. Il peut prendre plusieurs valeurs.

Notes :

Pour ajouter vos propres préprocesseurs personnalisés dans WebSphere® Integrated Solutions Console, vous devez d'abord entrer les valeurs par défaut suivant l'ordre indiqué ci-après, puis ajouter vos préprocesseurs personnalisés à la fin de la liste. La raison est la suivante :
- Si vous indiquez une valeur pour ce paramètre, cette valeur remplace la valeur par défaut.
- La valeur par défaut est obligatoire. Par conséquent, vous ne pouvez pas la remplacer par une autre valeur.
- Les préprocesseurs ci-après doivent être classés dans l'ordre et les requêtes doivent être traitées dans le même ordre.
La syntaxe requise est (classname (, classname) * ) 1 .

La valeur par défaut est la suivante :

preprocessors = com.ibm.wps.state.preprocessors.urlmapping.URLMappingPreProcessor,
                com.ibm.wps.resolver.friendly.preprocessors.FriendlyPreProcessor,
                com.ibm.wps.resolver.portal.ResolvedPreprocessor,
                com.ibm.wps.state.preprocessors.selection.StandardPortalSelectionImpl,
                com.ibm.wps.state.preprocessors.selection.FragmentSelectionImpl,
                com.ibm.wps.state.preprocessors.selection.ResourceSelectionImpl,
                com.ibm.wps.state.preprocessors.eclipse.ExtensionPreProcessor,
                com.ibm.wps.state.preprocessors.portlet.RequestParameterMerger

Parmi les valeurs par défaut fournies, les deux préprocesseurs de sélection suivants sont des options alternatives. Ils traitent la page que l'utilisateur a sélectionnée. Tous les autres préprocesseurs sont réservés pour une utilisation interne et ne doivent pas être modifiés.

Remarque : Les deux préprocesseurs de sélection suivants s'excluent mutuellement Ils ne peuvent pas être utilisés simultanément.

com.ibm.wps.state.preprocessors.selection.StandardPortalSelectionImpl: Cette valeur implémente le comportement de sélection de portail normal, qui favorise l'affichage des pages sur celui des libellés. Par conséquent, si un utilisateur sélectionne un libellé, le portail affiche une page sous ce libellé, plutôt que le libellé même accompagné d'un message expliquant qu'aucun contenu n'est disponible. (Dans ce cas, la page affichée est la dernière page sélectionnée par l'utilisateur sous ce libellé ou, si cette page est indisponible, la première page disponible sous ce libellé.)
com.ibm.wps.state.preprocessors.selection.SimpleSelectionImpl: Cette valeur implémente une stratégie de sélection simple ; elle affiche toujours l'élément sélectionné par l'utilisateur, qu'il s'agisse d'un libellé ou d'une page. Si l'utilisateur sélectionne un libellé, le portail affiche ce dernier accompagné d'un message informant qu'aucun contenu n'est disponible. Vous pouvez remplacer cette valeur par la valeur par défaut mentionnée précédemment.

Pour empêcher la perte des informations de langue relatives aux sessions de navigation des utilisateurs, vous pouvez également ajouter le préprocesseur suivant à la liste de préprocesseurs :

com.ibm.wps.state.preprocessors.locale.CookieSupportedLanguagePreProcessor

Ce préprocesseur crée une sauvegarde des informations d'environnement local trouvées dans l'état de navigation de la page de portail et copie ces informations ainsi sauvegardées dans un cookie. Le choix de langue d'un utilisateur est perdu lorsque l'état de navigation est effacé. Par exemple, les informations de langue sont perdues si un utilisateur utilise des signets vers des URL conviviales pour la navigation ou si l'état de navigation est volontairement effacé. Vous pouvez utiliser ce préprocesseur pour conserver le choix de langue de l'utilisateur. La langue est conservée sur la page suivante sélectionnée par l'utilisateur. Lorsque l'utilisateur sélectionne une autre langue, le portail met à jour les informations dans le cookie. Vous pouvez également déterminer la durée de vie maximale du cookie qui détient les informations de langue. Pour cela, spécifiez la propriété suivante dans le service de gestionnaire d'état :

com.ibm.wps.state.preprocessors.locale.CookieSupportedLanguagePreProcessor.cookie.maxage = (-1)

Spécifiez une valeur entière. La valeur est interprétée comme étant le nombre de secondes avant l'invalidation du cookie. Une valeur négative, telle que -1, signifie que le cookie n'est pas supprimé tant que l'utilisateur ne met pas fin à la session de navigation, par exemple, en fermant la fenêtre de session de navigation. La valeur par défaut de cette propriété est -1. Elle signifie que le cookie n'est pas invalidé tant que la session de navigation n'est pas terminée. Exemples :

com.ibm.wps.state.preprocessors.locale .CookieSupportedLanguagePreProcessor.cookie.maxage=30: Le cookie est actif pendant 30 secondes après la dernière demande.
com.ibm.wps.state.preprocessors.locale .CookieSupportedLanguagePreProcessor.cookie.maxage=-1: Le cookie est actif tant que la fenêtre de navigateur reste ouvert.

com.ibm.wps.state.preprocessors.selection.StandardPortalSelectionImpl.selection.fallback.enabled

Utilisez cette propriété pour indiquer ce qui se produit lorsqu'un utilisateur demande une page qui n'existe pas, par exemple en sélectionnant un signet pour une page qui a été supprimée. Indiquez l'une des valeurs suivantes :

true: Il s'agit de la valeur par défaut. Cette valeur conduit le portail à diriger l'utilisateur vers la page de rétromigration, par défaut, par exemple, la page d'accueil.
false: Si cette valeur est définie, le portail génère une erreur HTTP 404.

Utilisez cette propriété avec la propriété state.decoding.fallback dans le service de configuration WP du portail. Soyez cohérent lorsque vous définissez les valeurs pour les deux propriétés.

keymanager.lru.size = ( integer )

Utilisez cette propriété pour spécifier la limite d'expiration de l'historique des pages de portail sélectionnées par les utilisateurs. Le nombre que vous spécifiez définit le nombre minimum de pages différentes sélectionnées par l'utilisateur au-delà duquel le portail peut éliminer les paramètres d'affichage d'une page. (La décision d'éliminer les paramètres de rendu dépend des règles d'expiration du cache interne qui stocke les paramètres d'affichage de ces pages.) Si l'utilisateur retourne sur une page après avoir sélectionné le nombre d'autres pages and qu'il a défini et si les paramètres d'affichage de cette page sont arrivés à expiration, le portail affiche cette page dans son état par défaut.

Vous pouvez définir les circonstances régissant l'enregistrement ou la suppression d'une page :

1: Chaque fois que l'utilisateur sélectionne une nouvelle page, les paramètres de rendu des portlets de la dernière page sélectionnée peuvent être éliminés.
A positive integer: Définissez le nombre nécessaire de pages. Les paramètres d'affichage d'une page donnée peuvent être éliminés après que l'utilisateur a sélectionné ce nombre d'autres pages.
0: Les paramètres d'affichage sont toujours stockés dans la mémoire de session du portail et ne sont jamais éliminés.

Ne spécifiez pas une valeur inférieure à zéro (0). Celles-ci ne sont en effet pas considérées comme valides.