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 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.

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 Rich Text Editor 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 ci-dessous 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 commande appelle le module de mise à jour du profil de catégorie.
<input type="hidden" value='[PathCmpnt type="servlet"]/[Library]/[SiteArea]/[Content]' name="redirectURL">	Cette instruction pointe sur 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. Mise à jour du profil de la session utilisateur : Les catégories sélectionnées de l'utilisateur sont calculées en associant les catégories qui se trouvent dans le profil de session de l'utilisateur et les catégories qui se trouvent dans le profil des catégories de l'utilisateur permanent. C'est pourquoi, si une catégorie se trouve dans le profil des catégories de l'utilisateur et est supprimée du profil des sessions de l'utilisateur uniquement, elle sera affichée comme étant 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 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 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 bas de page contient le bouton Envoi.

Elément de retrait :

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 ci-dessus, 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 courante 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.

Conception d'éléments :

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é.

Accès utilisateur :

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.

Utilisation d'une URL pour mettre à jour des catégories d'utilisateur :

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://hôte: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.