Asistencia al usuario para autores de contenido

Creación de árboles de selección de categorías

Los árboles de selección de categorías se utilizan para permitir que los usuarios personalicen los menús.

Nota:
  • Asegúrese de que esté definida la propiedad connect.businesslogic.module.ajpecatselect.class en el servicio WCM WCMConfigService, utilizando la consola de administración de IBM® WebSphere Application Server, con un valor de com.aptrix.pluto.CategoryProfileUpdaterModule.
  • No puede utilizar árboles de selección de categorías en un portlet de representación local. En lugar de ello, debe representar el árbol directamente. Por ejemplo:
    http://host:port/wps/wcm/myconnect/library/sitearea/content 

Formulario de elemento de taxonomía

La función principal del elemento de taxonomía consiste en visualizar un árbol de selección de categorías que se utiliza para permitir a un usuario seleccionar categorías para la personalización de menús.

  • El elemento se configura seleccionando una taxonomía o una categoría como área inicial.
  • Seleccione una profundidad de nivel inferior desde el área inicial y un nivel superior relativo al área inicial.
  • Seleccione "Incluir Inicio" para visualizar el área de inicio. Esta opción no tiene ningún efecto si el área inicial es una taxonomía.
  • Hay dos opciones de diseño de elementos disponibles
    • Una se representa cuando el usuario que ha iniciado la sesión ha seleccionado la categoría que se debe visualizar.
    • La otra se representa si el usuario no ha seleccionado la categoría.
    Estos diseños de elementos son elementos de texto enriquecido y se utilizan igual que los elementos de Menú y Navegador.

El ejemplo del formulario de elementos de taxonomía crea un formulario de entrada de recuadro de selección:

  • El número de identidad de la categoría se asigna al atributo "value" en los campos de entrada.
  • Se crean campos de entrada de recuadro de selección, y se asigna el valor "selectedCategories" al atributo "name".
  • Se crean campos de entrada ocultos, y se asigna el valor "visibleCategories" al atributo "name".

Diseños de elementos

Los ejemplos de código siguientes sirven para desarrollar un árbol de selección de categorías básico:

Tabla 1. Cabecera
Código Detalles
[PathCmpnt end="/[Library]/[SiteArea]/[Content]?MOD=AJPECatSelect' 
method=post> 
"start="
<FORM action='" type="servlet"]
Este código llama al módulo Actualizador de perfiles de categorías.
<input type="hidden" 
value='[PathCmpnt type="servlet"]/[Library]/[SiteArea]/[Content]' 
name="redirectURL">
Este código apunta a la página a la que debe ir después de procesar la solicitud del usuario. El elemento no se representa correctamente si la vía de acceso "[Site area]/[Content]" (Área de sitio/Contenido) no es válida. El elemento no se representa correctamente si la vía de acceso "[Site area]/[Content]" (Área de sitio/Contenido) no es válida.
<input type="hidden" 
name="updateSourceProfile" value="true">
Esta línea determina cómo se actualiza el perfil de categoría de un usuario.

El parámetro "value" es opcional.

Verdadero
Actualiza permanentemente el perfil de categoría del usuario.
Falso
Actualiza sólo el perfil de sesión del usuario.
Actualización del perfil de sesión del usuario:

Las categorías seleccionadas por el usuario se calculan combinando las categorías que se encuentran en el perfil de sesión del usuario y las categorías que se encuentran en el perfil de categorías permanentes del usuario. Por lo tanto, si una categoría se encuentra en el perfil de categoría del usuario y únicamente se elimina del perfil de sesión del usuario, se seguirá mostrando como seleccionada.

Tabla 2. Diseño de elemento no seleccionado
Código Detalles
<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>
Sirve para visualizar los elementos no seleccionados en el árbol de selección de categorías representado.
Tabla 3. Diseño de elemento seleccionado
Código Detalles
<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>
Sirve para visualizar los elementos seleccionados en el árbol de selección de categorías representado.
Tabla 4. Pie de página
Código Detalles
<input type="submit" value="Set User Categories"></input>
</form>
El pie de página contiene el botón Enviar.
Elemento de sangrado:

Este ejemplo utiliza el código de elemento de sangrado. Se puede utilizar en los elementos de navegador o taxonomía. Este código representa una serie HTML/de texto que se debe repetir en función de la profundidad a la que se representa un nodo en estos elementos.

En el ejemplo de elemento de taxonomía, se utiliza el elemento de sangrado para representar y repetir la serie "." que depende de la profundidad del nodo al que se aplica el diseño de elemento. Se puede desplazar el valor de repetición si se asigna un valor entero al atributo "offset" del código. Por ejemplo, una profundidad de nodo actual de 5 y un valor de desplazamiento de -2 representará la serie de repetición tres veces. Si la suma del desplazamiento y la profundidad de nodo es negativa o igual a 0, la serie de repetición no se representará.

diseños de elementos:

La única diferencia entre el diseño de elementos no seleccionado y el diseño de elemento seleccionado es que el campo de entrada de recuadro de selección del diseño de elementos seleccionado tiene establecido el atributo "checked".

Acceso de usuario:

Si utiliza un elemento de taxonomía, los usuarios necesitan acceso de "Edición" a su propio elemento Usuario para poder actualizar las categorías seleccionadas.

Utilización de un URL para actualizar categorías de usuario:

Como alternativa al uso de un árbol de selección de categorías, se puede utilizar un URL para actualizar las categorías seleccionadas del usuario:

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

Los parámetros "selectedCategories" y "visibleCategories" tienen varios valores que están delimitados por comas. Las categorías especificadas en "selectCategories" deberían ser un subconjunto de "visibleCategories".

Este URL se podría utilizar en una página con el formato de un botón para permitir que los usuarios utilicen sus categorías de usuario. Por ejemplo, puede crear un botón que añada la categoría "Noticias" a una lista de categorías seleccionada por un usuario.