Configuration du portlet Liste personnalisée

Le mode de configuration permet à un administrateur de choisir le type et le formatage du contenu personnalisé.

Extraction de ressources de personnalisation

Pourquoi et quand exécuter cette tâche

Sous l'onglet Configurer la zone, vous pouvez choisir d'afficher toutes les ressources d'une collection de ressources unique ou les résultats d'une zone de contenu. Vous pouvez aussi choisir d'exécuter la règle directement.

Procédure

Afficher toutes les ressources à partir d'une collection de ressources unique
  1. Sélectionnez Afficher toutes les ressources du type suivant et sélectionnez le type de collection.
    Cette option n'est recommandée que pour les collections qui retournent peu de ressources.
Afficher les résultats d'une zone de contenu dans le portlet
  1. Sélectionnez Afficher les résultats de la zone de contenu.
  2. Sélectionnez la zone de contenu par son chemin d'accès.
    La zone de contenu est exécutée exactement comme si elle était incluse dans un JSP, de sorte que tous les mappages de règles de la campagne sont pris en compte.
Exécuter directement la règle sans limitation de campagne
  1. Sélectionnez Exécuter la règle suivante et sélectionnez la règle par son chemin.

Affichage des détails

Pourquoi et quand exécuter cette tâche

Sous l'onglet Configurer la zone, sélectionnez l'option de sortie.

Procédure

  1. Si le portlet Liste personnalisée est placé sur la même page que le portlet Editeur Personalization, vous pouvez sélectionner Ouvrir l'objet dans l'éditeur de personnalisation. Les informations de la ressource renvoyée sont affichées dans le portlet Editeur de personnalisation.
  2. Si l'option Générer la page de détails est sélectionnée, un attribut de détail de l'onglet Options d'affichage doit également être sélectionné.
  3. Si Utiliser un JSP existant dans le WAR du portlet est sélectionné, indiquez le chemin complet du JSP, relativement à la racine du WAR du portlet Liste personnalisée.
    Ce JSP existant est affiché quand l'utilisateur clique sur l'un des liens dans la liste de ressources. Pour que le JSP puisse accéder à la ressource référencée, vous devez ajouter un onglet <jsp:useBean> en haut de votre JSP personnalisé. La ressource est placée dans l'objet de la requête HTTP avec la clé "resourceObject". Les objets ressource sont des instances de la classe de ressource définie pour la collection de ressources de la règle existante. Si la classe de ressource renvoyée est wcpdemo.Users, utilisez la balise bean au début du JSP. Par exemple, vous pouvez utiliser cette syntaxe : <jp:useBean type="wcpdemo.Users" id="resourceObject" scope="request"/>

Résultats

Le JSP peut alors lancer des méthodes et lire des propriétés dans la ressource renvoyée par la règle.

Sélection d'attributs

Procédure

  1. Sous l'onglet Options d'affichage, sélectionnez l'option de sortie.
    Trois types d'attributs peuvent être affichés.
    • L'Attribut de titre est affiché en tant que lien dans la liste des ressources qui, une fois sélectionnée, affiche les détails de chaque ressource.
    • L'Attribut de détail n'est nécessaire que si vous avez choisi de générer une page de détails. Cet attribut est affiché lorsque le lien figurera dans la liste de ressources.
    • L'Attribut de catégorisation n'est requis que si vous choisissez de classer les ressources affichées par catégories. Les ressources sont groupées d'après la valeur de l'attribut de catégorisation. Pour plus d'informations, reportez-vous à Options de présentation.
  2. Pour chaque attribut, choisissez d'afficher un ensemble d'attributs fixes ou dynamiques :
    • Sélectionnez fixes pour faire votre choix dans une liste d'attributs toujours disponibles pour ce type de ressource, puis sélectionnez l'attribut dans la liste.
    • Sélectionnez dynamique pour entrer un nom d'attribut. Si la règle, la zone ou la collection de ressources ne déclare pas spécifiquement les attributs fixes, vous êtes autorisé à entrer le nom d'attribut Java directement.

Sélection des options de présentation

Procédure

  1. Under the Display Options tab, select the output option.
  2. Groupez chaque ressource en fonction de la valeur de son Attribut de catégorisation.
  3. Sélectionnez un classement des attributs.
    • Les ordres Croissant et Décroissant remplacent tous les tris déclarés dans vos règles.
    • Tri actuel affiche les catégories dans l'ordre d'exécution de la règle ou de la zone de contenu.
      Remarque : Si vous choisissez Tri actuel et n'indiquez pas l'ordre dans la règle exécutée, les ressources obtenues ne seront pas regroupées lors de l'affichage.

Sélection de classes de style

Procédure

  1. Under the Display Options tab, select the output option.
  2. Les styles de CSS par défaut sont indiqués pour chaque type de propriété. Pour créer de nouveaux styles, ajoutez-les à /jsp/include/rulePortlet.jsp ou à la feuille de style de thème du portail actuelle.

Configuration du mode Edition pour sélectionner les options de règle et d'affichage

Pourquoi et quand exécuter cette tâche

Vous pouvez définir un paramètre de portlet appelé pzn.configureInEditMode sur une valeur true. Lorsque la valeur est true, ce paramètre change le comportement de la Liste personnalisée pour que la page de configuration normale soit affichée en mode Edition. Cette action permet d'utiliser une autorisation d'édition pour sélectionner la règle affichée dans le portlet de la liste. Par défaut, cette propriété est paramétrée sur false, c'est-à-dire que la sélection des option de règle et d'affichage s'effectue en mode de configuration. Quand ce paramètre est true, l'option d'édition normale du nombre d'éléments par page n'est pas disponible.

Les paramètres de configuration du portlet peuvent être définis dans les portlets d'administration.