创建类别选择树

使用类别选择树允许用户实现菜单个性化。

注：
  • 确保使用 IBM® WebSphere® Application Server 管理控制台以 com.aptrix.pluto.CategoryProfileUpdaterModule 值在 WCM WCMConfigService 服务中定义了 connect.businesslogic.module.ajpecatselect.class 属性。
  • 不能在本地呈示 Portlet 中使用类别选择树。而必须直接呈示该树。例如： 
    http://host:port/wps/wcm/myconnect/library/sitearea/content

分类元素表单

分类元素的主要功能是显示类别选择树，使用它允许用户选择用于菜单个性化的类别。

  • 通过选择分类或类别作为开始区域来配置元素。
  • 从开始区域选择子代深度以及相对于开始区域的父级。
  • 选择“包含开始区域”以显示开始区域。如果开始区域是分类，该选项将无效。
  • 可使用两个元素设计选项：
    • 一个是在登录用户选择要显示的类别时呈示。
    • 另一个是在用户未选择类别时呈示。
    这些元素设计为富文本格式元素，使用方法与导航器以及菜单元素相似。

分类元素表单示例创建一个复选框输入表单：

  • 将类别标识号指定到输入字段中的“value”属性。
  • 将创建复选框输入字段，将值“selectedCategories”指定到“name”属性。
  • 将创建隐藏输入字段，将值“visibleCategories”指定到“name”属性。

元素设计

以下代码示例用于开发基本类别选择树：

表 1. 页眉
代码 详细信息 
[PathCmpnt end="/[Library]/[SiteArea]/[Content]?MOD=AJPECatSelect' 
method=post> 
"start="
<FORM action='" type="servlet"]
 此代码调用类别概要文件更新程序模块。 
<input type="hidden" 
value='[PathCmpnt type="servlet"]/[Library]/[SiteArea]/[Content]' 
name="redirectURL">
 此代码指向处理完用户请求后要转至的页面。如果路径“[Site area]/[Content]”无效，那么将无法正确呈示元素。 
<input type="hidden" 
name="updateSourceProfile" value="true">
 该行决定如何更新用户的类别概要文件。

“value”参数是可选参数。

true
永久更新用户类别概要文件。
False
只更新用户的会话概要文件。
更新用户的会话概要文件：

用户的所选类别通过将处于用户会话概要文件中的类别与处于永久用户类别概要文件中的类别进行组合来计算。因此，如果类别处于用户类别概要文件中且仅从用户的会话概要文件中除去，它将仍然显示为已选中。
表 2. 未选定元素设计
代码 详细信息 
<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>
 用于显示呈示的类别选择树中的未选定项。
表 3. 选定元素设计
代码 详细信息 
<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>
 用于显示呈示的类别选择树中的选定项。
表 4. 页脚
代码 详细信息 
<input type="submit" value="Set User Categories"></input>
</form>
 页脚包含提交按钮。
缩进元素：

该示例使用缩进元素标记。它可用于导航器和分类元素中。该标记代表一个 HTML/文本字符串，应根据这些元素中所呈示树节点的深度重复它。

在该分类元素示例中，根据所应用元素设计的节点深度使用缩进元素呈示和重复“.”字符串。可以通过为标记的“offset”属性指定一个整数值来偏置重复值。例如，当前节点深度为 5，偏移值 -2 将呈示重复字符串三次。如果偏移和节点深度之和为负数或 0，将不呈示重复字符串。

元素设计：

未选定元素设计与选定元素设计之间的唯一差别在于选定元素设计中的复选框输入字段设置了“checked”属性。

用户访问：

如果使用分类元素，必须授予用户对其自己用户项的“编辑”访问权，允许他们更新选定的类别。

使用 URL 更新用户类别：

您可以使用 URL 作为使用类别选择树更新用户选定类别的替代方法：

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

“selectedCategories”和“visibleCategories”参数包含逗号分隔的多个值。“selectCategories”中指定的类别应该是“visibleCategories”的子集。

该 URL 可以作为按钮用于页面中，允许用户更新用户类别。例如，您可以创建一个按钮，将类别“新闻”添加到用户选定的类别列表中。