Création d'arborescences de sélection de catégories

Les arborescences de sélection de catégories permettent aux utilisateurs de personnaliser les menus.

Remarque :
  • Vérifiez que la propriété connect.businesslogic.module.ajpecatselect.class est définie dans le service WCM WCMConfigService, à l'aide de la console d'administration IBM® WebSphere® Application Server, avec la valeur com.aptrix.pluto.CategoryProfileUpdaterModule.
  • Vous ne pouvez pas utiliser des arborescences de sélection de catégories dans un portlet de rendu local. Vous devez restituer directement l'arborescence. Par exemple:
    http://host:port/wps/wcm/myconnect/library/sitearea/content

Formulaire d'élément de taxinomie

La principale fonction de l'élément de taxinomie est d'afficher une arborescence de sélection de catégories qui permet à l'utilisateur de choisir des catégories pour personnaliser les menus.

  • Pour configurer l'élément, choisissez une taxinomie ou une catégorie en tant que zone de démarrage.
  • Sélectionnez une profondeur d'enfant à partir de la zone de démarrage et un niveau parent par rapport à cette zone de démarrage.
  • Sélectionnez "Inclure le démarrage" pour afficher la zone de démarrage. Cette option n'a aucun effet si la zone de démarrage est une taxinomie.
  • Il existe deux options de conception d'élément :
    • L'une est activée si l'utilisateur connecté a choisi la catégorie à afficher.
    • L'autre est activée si l'utilisateur n'a pas choisi la catégorie à afficher.
    Ces conceptions d'élément sont des éléments de texte enrichi qui sont utilisés d'une façon similaire aux éléments de menu et de navigateur.

L'exemple de formulaire d'élément de taxinomie montre comment créer un formulaire d'entrée de case à cocher :

  • Le numéro d'identité de la catégorie est affecté à l'attribut "value" des zones d'entrée.
  • Les zones d'entrée de case à cocher sont créées et la valeur "selectedCategories" est affectée à l'attribut "name".
  • Des zones d'entrée masquées sont créées et la valeur "visibleCategories" est affectée à l'attribut "name".

Conceptions d'élément

Les exemples de code suivants permettent de créer une arborescence de sélection de catégories de base :

Tableau 1. En-tête
Code Détails 
[PathCmpnt end="/[Library]/[SiteArea]/[Content]?MOD=AJPECatSelect' 
method=post> 
"start="
<FORM action='" type="servlet"]
 Cette code appelle le module de mise à jour du profil de catégorie. 
<input type="hidden" 
value='[PathCmpnt type="servlet"]/[Library]/[SiteArea]/[Content]' 
name="redirectURL">
 Ce code pointe vers la page à contacter une fois la requête de l'utilisateur traitée. L'élément n'est pas affiché correctement si le chemin "[Site area]/[Content]" est incorrect. 
<input type="hidden" 
name="updateSourceProfile" value="true">
 Cette ligne détermine comment le profil de catégorie d'un utilisateur est mis à jour.

Le paramètre "value" est facultatif.

True
Met à jour définitivement le profil de catégorie de l'utilisateur.
False
Ne met à jour que le profil de session de l'utilisateur.
Updating the user's session profile :

Les catégories sélectionnées de l'utilisateur sont calculées en combinant celles figurant dans le profil de session de l'utilisateur et celles présentes dans le profil permanent des catégories d'utilisateur. En conséquence, si vous ne supprimer une catégorie du profil de catégorie d'utilisateur que dans le profil de session de l'utilisateur, celle-ci apparaîtra toujours comme sélectionnée.
Tableau 2. Conception d'élément non sélectionné
Code Détails 
<input type="checkbox" name="selectedCategories"
 value="[Placeholder tag="idnum"]"/>
<IndentCmpnt offset="0" repeat=".."]
[Placeholder tag="name"]
<input type="hidden" name="visibleCategories"
 value="[Placeholder tag="idnum"]"/>
<br>
 Cette option permet d'afficher les objets non sélectionnés dans l'arborescence de sélection de catégories affichée.
Tableau 3. Conception d'élément sélectionné
Code Détails 
<input type="checkbox" checked name="selectedCategories"
 value="[Placeholder tag="idnum"]"/>
[IndentCmpnt offset="0" repeat=".."]
[Placeholder tag="name"]
<input type="hidden" name="visibleCategories"
 value="[Placeholder tag="idnum"]"/>
<br>
Cette option permet d'afficher les objets sélectionnés dans l'arborescence de sélection de catégories affichée.
Tableau 4. Pied de page
Code Détails 
<input type="submit" value="Set User Categories"></input>
</form>
 Le pied de page contient le bouton Envoi.
Indent element :

Cet exemple montre comment utiliser la balise d'élément de retrait "indent". Elle peut être utilisée avec les éléments de taxinomie et de navigateur. Cette balise représente une chaîne HTML/texte qui doit être répétée ou non selon la profondeur d'un noeud d'arborescence affiché dans ces éléments.

Dans l'exemple d'élément de taxinomie, l'élément de retrait "indent" sert à afficher et répéter la chaîne "." en fonction de la profondeur du noeud à laquelle s'applique la conception d'élément. Il est possible de reporter la valeur de répétition en affectant une valeur entière à l'attribut "offset" de la balise. Par exemple, si la profondeur actuelle du noeud est de 5 et que la valeur du report est de -2, la chaîne répétée apparaît trois fois. Si la somme du report et de la profondeur du noeud est inférieure ou égale à 0, la chaîne répétée n'apparaît pas.

element designs :

La seule différence entre la conception d'élément non sélectionné et la conception d'élément sélectionné est que l'attribut "checked" de la zone d'entrée de case à cocher est activé dans la conception d'élément sélectionné.

User access :

Pour utiliser un élément de taxinomie, les utilisateurs doivent disposer du droit d'accès "Edition" sur leurs propres objets utilisateur afin de pouvoir mettre à jour les catégories qu'ils ont sélectionnées.

Using a URL to update user categories :

Pour mettre à jour les catégories sélectionnées par l'utilisateur, vous pouvez utiliser une URL à la place de l'arborescence de sélection de catégories :

http://host:port/wcm/connect/SiteArea/SelectPage?MOD=AJPECatSelect
&redirectURL=/wcm/connect/SiteArea/Content&updateSourceProfile=false
&selectedCategories=categoryID1,categoryID3
&visibleCategories=categoryID1,categoryID2,categoryID3,categoryID4

Les paramètres "selectedCategories" et "visibleCategories" disposent de plusieurs valeurs séparées par des virgules. Les catégories spécifiées dans "selectCategories" doivent être un sous-ensemble de "visibleCategories".

Cette URL peut être utilisée sur une page sous la forme d'un bouton permettant aux utilisateurs de mettre à jour leurs catégories. Par exemple, vous pouvez créer un bouton qui ajoute la catégorie "Informations" à une liste de catégories sélectionnées par l'utilisateur.