Assistência ao utilizador para autores de conteúdo

Criar árvores de selecção de categorias

As árvores de selecção de categorias são utilizadas para permitir aos utilizadores personalizar menus.

Nota:
  • Certifique-se de que a propriedade connect.businesslogic.module.ajpecatselect.class está definida no serviço WCM WCMConfigService, utilizando a consola administrativa do IBM® WebSphere Application Server, com um valor de com.aptrix.pluto.CategoryProfileUpdaterModule.
  • Não é possível utilizar árvores de selecção de categorias numa portlet de apresentação local. Em alternativa, terá de apresentar a árvore directamente. Por exemplo:
    http://host:port/wps/wcm/myconnect/library/sitearea/content

Formulário de elemento de taxonomia

A função principal do elemento de taxonomia consiste em apresentar uma árvore de selecção de categorias, utilizada para permitir ao utilizador a selecção de categorias para a personalização de menus.

  • Este elemento é configurado através da selecção de uma taxonomia ou categoria como área de início.
  • Seleccione a profundidade de um descendente da área de início e um nível ascendente relativo à área de início.
  • Seleccione "Incluir Início" para apresentar a área de início. Esta opção não tem qualquer efeito se a área de início corresponder a uma taxonomia.
  • Encontram-se disponíveis duas opções de concepção de elemento:
    • A primeira é composta quando o utilizador que iniciou a sessão seleccionou a categoria a apresentar.
    • A segunda opção é composta se não tiver sido seleccionada qualquer categoria.
    Estas concepções de elemento correspondem a elementos de rich text, e são utilizadas de modo semelhante aos elementos de navegador e menu.

O exemplo de formulário de elemento de taxonomia cria um formulário de entrada de dados na caixa de verificação:

  • Nos campos de entrada, é atribuído o número identificador da categoria ao atributo "valor".
  • São criados os campos de entrada de dados na caixa de verificação, atribuindo o valor "selectedCategories" ao atributo "name".
  • São criados campos de entrada ocultos, atribuindo o valor "visibleCategories" ao atributo "name".

Concepções de elemento

Os exemplos de códigos seguintes são utilizados para desenvolver uma árvore de selecção de categorias básica:

Tabela 1. Cabeçalho
Código Detalhes 
[PathCmpnt end="/[Library]/[SiteArea]/[Content]?MOD=AJPECatSelect' 
method=post> 
"start="
<FORM action='" type="servlet"]
 Este código invoca o Módulo de actualização do perfil de categorias. 
<input type="hidden" 
value='[PathCmpnt type="servlet"]/[Library]/[SiteArea]/[Content]' 
name="redirectURL">
 Este código remete para a página a ser acedida, após o processamento do pedido do utilizador. O elemento não é correctamente apresentado, se o caminho "[Site area]/[Content]" não for válido. 
<input type="hidden" 
name="updateSourceProfile" value="true">
 Esta linha determina o modo de actualização do perfil da categoria do utilizador.

O parâmetro "value" é opcional.

Verdadeiro
Actualiza permanentemente o perfil da categoria do utilizador.
Falso
Actualiza apenas o perfil da sessão do utilizador.
Actualizar o perfil da sessão do utilizador:

As categorias seleccionadas de um utilizador são processadas através da combinação das categorias que se encontram no perfil de sessão do utilizador e das categorias que se encontram no perfil da categoria do utilizador permanente. Por conseguinte, se uma categoria se encontrar no perfil da categoria do utilizador e for removida apenas do perfil de sessão do utilizador, continuará a ser apresentada como seleccionada.
Tabela 2. Concepção de elemento não seleccionado
Código Detalhes 
<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>
 É utilizado para apresentar itens não seleccionados na árvore de selecção de categorias composta.
Tabela 3. Concepção de elemento seleccionado
Código Detalhes 
<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>
 É utilizado para apresentar itens seleccionados na árvore de selecção de categorias composta.
Tabela 4. Rodapé
Código Detalhes 
<input type="submit" value="Set User Categories"></input>
</form>
 O rodapé inclui o botão enviar.
Elemento de indentação:

Este exemplo utiliza o controlo de elemento de indentação. Este pode ser utilizado nos elementos de navegador e taxonomia. Representa uma cadeia de texto/HTML que deve ser repetida de acordo com a profundidade do nó de árvore composto nestes elementos.

No exemplo de elemento de taxonomia, é utilizado o elemento de indentação para apresentar e repetir a cadeia "." , de acordo com a profundidade do nó ao qual é aplicada a concepção de elemento. É possível deslocar o valor de repetição, atribuindo um valor com número inteiro ao atributo "offset" do controlo. Por exemplo, uma profundidade de nó correspondente a 5, e um valor de deslocação -2, comporiam três vezes a sequência de repetição. Se a soma do deslocamento e da profundidade do nó for negativa ou igual a 0, a sequência de repetição não é composta.

concepções de elemento:

A única diferença existente entre a concepção de elemento seleccionado e não seleccionado consiste no facto de o campo de entrada de dados da caixa de verificação do primeiro ter o conjunto de atributos "seleccionado".

Acesso do utilizador:

Ao utilizar um elemento de taxonomia, terá de ser atribuído acesso de "Edição" ao utilizador para o seu próprio item de utilizador, de modo a permitir a actualização das categorias seleccionadas.

Utilizar um URL para actualizar categorias de utilizador:

Um URL pode ser utilizado como alternativa à utilização de uma árvore de selecção de categorias para actualizar as categorias seleccionadas de um utilizador:

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

Os parâmetros "selectedCategories" e "visibleCategories" têm vários valores separados por vírgulas. As categorias especificadas em "selectCategories" deverão ser um subconjunto de "visibleCategories".

Este URL pode ser utilizado numa página sob a forma de um botão para permitir aos utilizadores actualizar as respectivas categorias de utilizador. Por exemplo, é possível criar um botão que adiciona a categoria "Notícias" a uma lista de categorias seleccionadas de um utilizador.

Tópico ascendente: Utilizar um elemento de taxonomia