第 4 章 管理 Portal Server 桌面
本章说明 Sun JavaTM System Portal Server 桌面以及如何管理它。
了解 Portal Server 桌面管理
本节说明 Portal Server 桌面的重要组件。以下主题在讨论之列：
了解显示配置文件
安装 Portal Server 时，您会创建一个初始组织。安装程序接下来会根据您指定的输入参数，导入显示配置文件的全局级别文档和默认组织的显示配置文件。
此后，每次创建新的组织、子组织或角色时，显示配置文件不会自动加载。不过，新的组织、子组织或角色会继承其父项的已定义显示配置文件。如果新建的组织、子组织或角色有其他特定的条目，则您必须手动加载显示配置文件。
显示配置文件通过定义以下三项，为标准的桌面创建显示配置：
- 提供者定义
-
指定提供者的名称和 Java 类。提供者是一个模板，用于生成在频道中显示的内容。
- 频道定义
-
指定提供者类实例的运行时配置。频道是内容的单位，通常以行和列排列。也可以有包含频道的频道，称为容器频道。
- 提供者和频道属性定义
-
指定提供者和频道属性的值。在提供者中定义的属性通常为派生于提供者的频道指定默认值。频道的显示配置包括诸如标题、描述、频道宽度等属性。在频道中定义的属性通常为该频道指定与默认值不同的特定值。
容器属性定义关于如何显示容器中包含的频道的显示定义，包括：容器的布局（窄-宽、宽-窄或窄-宽-窄）；包含的频道的列表；频道的位置（行号和列号）；所包含频道的窗口状态（最小化或分离）。
显示配置文件仅为频道提供属性值。它实际上并未定义用户在其桌面上看到的整体布局或组织。但是，显示配置文件确实对频道显示的某些方面起到了间接控制作用，如表容器的列布局或表容器如何在表中绘制频道。
当尝试保存包含无效 XML 的显示配置文件文档时，系统将报告错误。错误消息显示为标题、消息和子消息。消息框的标题为“无效 XML 文档”。消息内容为以下某一项：
-
无法解析 XML...
-
XML 中缺少 doctype
-
无法保存 DP...
-
无效 XML 输入...
如果您收到“无效 XML 文档”错误，则您必须修正错误才能保存 XML 文档。
显示文档的语法如下所示：
<?xml version="1.0" encoding="utf-8" standalone="no"?> <DOCTYPE DisplayProfile SYSTEM " jar://resources/psdp.dtd"> <DisplayProfile version="1.0" priority="xxx"> <Properties> ... </Properties> </Channels> ... </Channels> <Providers> ... </Providers> </DisplayProfile> |
了解桌面属性
桌面将用户的显示配置文件合并集内的所有文档合并在一起，并使用合并结果配置用户桌面。显示配置文件合并集由与用户相关的所有显示配置文件文档组成。显示配置文件会在 Portal Server 组织树的不同级别中定义。通过合并或组合来自此树不同级别的显示配置文件文档可创建用户的显示配置文件。
例如，用户显示配置文件会与角色显示配置文件（如果存在）、组织显示配置文件以及全局显示配置文件进行合并，从而形成用户显示配置文件。
桌面显示配置文件和其他配置数据定义为服务属性，例如 Sun Java System Access Manager 服务管理框架下的 Portal 桌面服务的父容器、桌面类型和编辑容器。从 Sun Java System Access Manager 管理控制台为组织添加“Portal 桌面”服务时，此组织内的所有用户都会在其用户配置文件中继承“Portal 桌面”服务属性。这些属性由“Portal 桌面”查询，以确定信息在“Portal 桌面”中聚集和出现的方式。
参见管理桌面属性
管理 Portal Server 桌面内容
本节说明如何管理桌面内容。有关桌面的更多信息，参见《Sun Java System Portal Server 7 Technical Overview》中的 "Understanding the Standard Desktop"。
管理 Portlet
本节说明如何部署和取消部署 Portlet，以及如何修改 Portlet 首选项。
Portlet 是 Web 应用程序，可处理请求并在门户的环境中生成内容。Portlet 由“Portlet 容器”（“JSR 168 专家组”定义的 Portlet 规范的一种实现方式）管理。
Portlet 只能在选定的 DN 节点上部署一次。如果已经在同一 DN 节点上部署了 Portlet，则您应取消部署该 Portlet，然后再部署它。如果想要 Portlet 位于多个子组织或角色上，那么将该 Portlet 部署在门户全局 DN 或父组织上。
部署 Portlet
等同的 psadmin 命令
取消部署 Portlet
-
选择 "Portal" 选项卡。
-
从 "Portal" 选择一个门户服务器。
-
从“选择 DN”下拉菜单，选择任意 DN。
-
单击“取消部署 Portlet”启动该向导。
-
根据需要修改配置属性。
-
单击“取消部署”以记录更改。
等同的 psadmin 命令
修改 Portlet 首选项
-
单击“常用任务”选项卡，然后从子菜单选择“管理频道和容器”。
-
选择要部署 Portlet 的门户和 DN。
将显示带有可用频道和 Portlet 的导航树。
-
从左侧框架的导航树中，选择 Portlet 频道。
首选项表格和属性表格显示在右侧框架中。
-
在首选项表格中，单击您要修改的首选项的“编辑值”链接。
-
在首选项向导中，在文本字段中键入新值，然后单击“确定”。
-
当您修改首选项完毕之后，单击“保存”。
-
单击“关闭”。
管理频道和容器
本节说明如何通过管理控制台管理门户服务器频道和容器。
以下主题在讨论之列：
查看频道和容器
用户的桌面是通过启动桌面父容器来呈现的。您可以在每个组织、角色和用户 DN 中自定义父容器属性。通过重复选择为在桌面父容器内显示的子容器和频道，提供特定 DN 的桌面内容。
通常，桌面父容器包含几个选项卡或表容器。父容器选定节点列表下的每个选项卡容器将在用户桌面上显示一个选项卡。出现在选项卡下的频道是选项卡容器内的频道。
门户管理控制台中“频道和容器管理”左下方的框架有两个组件：
-
“视图类型”菜单
-
“频道和容器”树
“视图类型”菜单中的各项和树中显示的节点取决于合并的“显示配置文件 XML”的内容。
树包含容器和频道节点。有三种类型的频道为桌面提供内容：
-
提供者（本机）频道
-
Portlet 频道
-
远程 Portlet 频道
您可以单击树中任何节点链接，以在右侧的框架中显示属性和操作。
“视图类型”菜单中有两种类型的项目：
-
显示配置文件 XML 树
-
桌面视图
显示配置文件 XML 树
树在合并的显示配置文件 (Display Profile, DP) XML 中显示完整的频道和容器集。DP XML 树中的根元素为 DP_ROOT，它是显示配置文件所有频道和容器的父元素。您可以直接在 DP_ROOT 下创建频道，或在 DP_ROOT 下的容器中创建频道。
DP XML 树下列出的节点并非总是显示在桌面上。显示配置文件中的某些节点从不会被引用或包括在桌面容器的层次结构中。
例如，桌面默认的容器 JSPTabContainer 有两个容器：tab1 和 tab2。如果 tab1 包含 ch1 和 ch2，而 tab2 包含 ch3 和 ch4，则 DP XML 树中有五个定义的频道。DP XML 树在容器层次结构中引用 ch1 到 ch4，但不引用 ch5。因此，桌面上将只显示 ch1 到 ch4。
桌面视图
桌面视图是合并的显示配置文件中可用的顶层容器。您可以将每个桌面视图设为 DN 处桌面的父容器。当您选择桌面视图后，树将提供频道和容器的可视层次结构，该结构可为桌面呈现内容。
显示在桌面视图下的频道和容器有两个状态：
-
已选定且在桌面上可见
-
可供选择
注 –在此状态下，频道和容器的图标显示为灰色。
您可以更改桌面视图中的频道和容器的状态，方法是单击右侧框架中的任务链接。要显示关于状态的工具提示，请将鼠标置于容器或频道图标之上。工具提示还显示节点的全限定名。
查看显示配置文件 XML 树和桌面视图
-
选择 "Portal" 选项卡。
-
在 "Portal" 下选择门户服务器，然后从“选择 DN”下拉菜单中选择任意 DN。
-
在“任务”下，单击“管理容器和频道”。
-
从“视图类型”下拉菜单选择“DP XML 树”或“桌面视图”。
修改频道和容器属性
本节说明频道和容器的属性，以及如何修改它们。
您可以执行以下任务：
了解属性
当您单击树中节点时显示的属性为顶层属性或频道级别属性。这些属性定义在提供者级别，您可以为频道自定义这些属性。不过，添加到频道的新属性无法添加到提供者。这就是您无法在频道级别添加新属性的原因。
属性表显示客户机类型和语言环境。没有显示属性类型的列，不过遵循以下约定：
- 字符串
-
值列拥有宽文本字段，最多为 30 个字符。
- 整数
-
值列拥有窄文本字段，最多为 5 个字符。
- Boolean（布尔型）
-
值为单选按钮。
- 映射
-
名称为链接。
- 列表
-
值列拥有“编辑值”链接。单击此链接可打开一个向导来添加和删除值。
- 空集合
-
名称是显示“编辑值”链接的链接。可将名称和值对添加到空集合中以像映射一般运作，这样不再显示“编辑值”。如果使用“编辑值”向导将值添加到一个空集合，则集合成为一个列表且不再出现名称链接。
除了“名称”和“值”列，属性表还有两列：
- 类别
-
显示属性是高级还是基本。高级属性通常适用于有经验的管理员。
- 状态
-
属性可以为下三种状态之一：
-
默认 – 在提供者级别指定的值。
-
继承 – 在某上层级别修改的值。例如，如果当前节点为角色，则属性可能已在角色的组织中自定义。此组织可能为父组织，或父组织的父项。当属性为继承时，它是一个链接。单击此链接便会显示层次结构中该属性继承自的所有可能的父节点。
-
自定义 – 在此节点定义的值。
-
属性表中有以下按钮：
- 删除自定义
-
从显示配置文件中，删除在此节点定义的值。如果属性在层次结构中进行过自定义，此操作将导致从层次结构的某些父项继承属性。如果没有在层次结构的任何地方进行自定义，则显示在提供者级别定义的值，并且状态显示为“默认”。
- 保存
-
保存值的添加、删除和更改。
- 重置
-
忽略更改并将值重置为数据存储库中的上次保存状态。
- 清除所有排序
-
清除所有排序。
提示 –表格可通过单击任意列标题进行排序。当您单击“名称”按钮时，首先按名称进行排序，“类别”和“状态”按钮旁边会显示一个 + 号。单击 + 号以应用下一个排序标准。
- 表格首选项
-
设置表格首选项。
除非经过修改，否则客户机类型和语言环境均设为默认。
创建属性
您可以通过“新建属性”向导编辑这些值并保存。您还可以添加新的成对的名称和值。
-
选择 "Portal" 选项卡。
-
从 "Portal" 选择一个门户。
-
从“选择 DN”下拉菜单，选择任意 DN。
-
在“任务”下，单击“管理频道和容器”。
-
在左侧框架的树中选择一个容器，以在右侧框架中显示“编辑属性”页面。
-
单击“新建属性”按钮以启动该向导。
-
选择属性类型，然后单击“下一步”。
-
键入一个名称，选择一个值，然后指定该属性是否为高级。
注 –当集合属性包含名称和值对时，其行为与映射类似。“集合”类型的属性可以嵌套。表格上方的属性路径将更改以显示当前的嵌套，而您可以导航回到上一层。
任何结尾值都是可选的。例如，值可以是 en 或 en_US，但不能仅仅是 US。应根据标准的 Java 格式指定语言环境。
-
单击“完成”创建该属性。
-
单击“关闭”，在表格中显示新属性。
编辑列表
当集合属性只包含值时，其行为与列表类似。
-
选择 "Portal" 选项卡。
-
从 "Portal" 选择一个门户。
-
从“选择 DN”下拉菜单，选择任意 DN。
-
在“任务”下，单击“管理频道和容器”。
-
在左侧框架的树中选择一个容器，以在右侧框架中显示“编辑属性”页面。
-
单击属性的“编辑值”链接以启动向导。
-
进行更改。
-
单击“关闭”。
编辑属性页面会更新列表中值的数目。
修改频道和容器属性
-
选择 "Portal" 选项卡。
-
从 "Portal" 选择一个门户。
-
从“选择 DN”下拉菜单，选择任意 DN。
-
在“任务”下，单击“管理频道和容器”。
-
在左侧框架的树中选择一个频道或容器，以在右侧框架中显示“编辑属性”页面。
-
更改属性，然后单击“保存”。
等同的 psadmin 命令
创建和删除频道和容器
本节说明如何通过门户管理控制台创建和删除频道和容器。
创建频道或容器
-
选择 "Portal" 选项卡。
-
从 "Portal" 选择一个门户。
-
从“选择 DN”下拉菜单，选择任意 DN。
-
在“任务”下，单击“管理频道和容器”。
-
在左侧框架的树中选择一个容器，以在右侧框架中显示“编辑属性”页面。
-
在“任务”下，单击“新建频道或容器”以启动向导。
在向导中，确保选定的门户和选定的 DN 是您想要创建频道或容器的位置，然后单击“下一步”。
-
通过向导创建容器或频道。
等同的 psadmin 命令
删除频道或容器
-
选择 "Portal" 选项卡。
-
从 "Portal" 选择一个门户。
-
从“选择 DN”下拉菜单，选择任意 DN。
-
在“任务”下，单击“管理频道和容器”。
-
在左侧框架的树中选择一个容器，以在右侧框架中显示“编辑属性”页面。
-
在“任务”下，单击“选择要删除的容器或频道”。
-
在“类型”下，选择“频道或容器”。
会显示可用的频道和容器。
-
选择一个频道或容器，然后单击“删除”。
等同的 psadmin 命令
创建选项卡
本节说明如何通过门户服务器管理控制台创建选项卡。
创建选项卡
-
选择 "Portal" 选项卡。
-
从 "Portal" 选择一个门户。
-
从“选择 DN”下拉菜单，选择任意 DN。
-
在“任务”下，单击“管理频道和容器”。
-
从左侧框架的树中，选择一个选项卡容器。
-
在右侧框架中的“任务”下，单击“新建选项卡”以启动向导。
显示频道和容器
本节说明如何显示最终用户桌面上的频道和容器。频道和容器也可以在内容页面上提供，以便最终用户进行选择以将它们显示在桌面上。
在桌面上显示频道和容器
-
选择 "Portal" 选项卡。
-
从 "Portal" 选择一个门户。
-
在“任务”下，单击“管理容器和频道”。
-
在左侧框架的树中选择一个容器，以在右侧框架中显示“编辑属性”页面。
-
在“任务”下，单击“在 Portal 桌面上显示或隐藏频道和容器”。
-
在“准备使用”下，选择一个频道或容器。
-
使用“添加”按钮，将频道移动到“内容页面”或“Portal 桌面”上显示。
-
单击“保存”。
等同的 psadmin 命令
管理桌面属性
本节说明如何管理桌面属性。有关更多信息，参见了解桌面属性。
顶层组织的桌面属性与组织树中其他级别不同。可将地址栏更改为 "TopLevel" 以查看全局桌面属性，然后为组织或角色桌面属性选择其他标识名。
设置桌面属性
-
选择 "Portal" 选项卡。
-
在 "Portal" 下选择一个门户服务器，然后选择“桌面”。
-
从“选择 DN”下拉菜单，选择任意 DN。
-
根据需要修改“桌面属性”下的配置属性。
可用的选项如下：
- COS 优先
-
为“桌面”服务模板设置冲突解决级别，用于在合并多个“桌面”模板时解决冲突。本属性只适用于“组织”和“角色”，不适用于“用户”和“全局 DN” 。
- 父容器
-
标识当未指定的提供者调用“桌面”时呈现哪个默认容器。“父容器”的值可以是定义为 TopLevelContainer 的容器之一，它可以在门户页面上绘制页眉和页脚。如果显示配置文件属性 TopLevel 设置为 true，则容器为“顶层”容器。
- 编辑容器
-
指定当 URL 中没有指定编辑容器时使用哪个默认编辑容器来包装内容。当单击频道标题栏上的编辑链接时，父容器将使用此容器绘制编辑页面。
- 桌面类型
-
“桌面”查找操作在搜索模板和 JSP 时使用的以逗号分隔的列表。查找操作将从该列表中的第一个元素开始，并且每个元素均代表了“桌面”模板基目录下的一个子目录。例如，"sampleportal,foo" 的查找顺序为 sampleportal 目录、foo 目录和默认目录。
- 桌面属性
-
指定对于与角色相关联的用户来说是否显示桌面属性。此动态属性主要用于管理标记库中基于角色的委托管理。启用此属性可以显示桌面内容，从而允许委托管理员管理从父组织继承的频道/容器。此属性只能应用于“组织”和“角色”。
- 显示配置文件优先级
-
设置显示配置文件文档的优先级。显示配置文件文档是从低优先级到高优先级进行合并。较小的数字代表较低的优先级。例如，1 是比 2 低的优先级。较高优先级文档会使用合并语义覆盖较低优先级文档中的值设置（除非较低优先级的文档锁定了合并的对象）。
注 –显示配置文件优先级不作为桌面服务属性存储。
以下属性只能应用于全局（顶层）DN。
- XML 解析验证
-
启用 XML 解析的验证。
- 联合
-
启用身份联合，使用户能够关联、连接或绑定多个 Internet 服务提供者的本地身份，从而使他们能够获得一个网络身份。
- 托管提供者 ID
-
指定提供用户网络身份的主机的唯一标识符。
- 会话记录间隔时间
-
指定会话的清除间隔时间（单位为秒）。
- 会话空闲时间
-
指定空闲时间（单位为秒），会话经过该时间后终止。
- 客户机会话的最大数目
-
指定在任意给定时间允许的最大客户机会话数。
- 匿名桌面
-
启用时，允许选定的门户使用匿名桌面。
- 已联合用户的匿名访问
-
阻止在托管提供者上拥有网络身份的用户通过提供用户名和密码来访问 Portal 桌面。
- 匿名桌面的有效 UID
-
被授权无需验证即可访问桌面的用户 ID 列表。
-
单击“保存”以记录更改。
否则，单击“重置”取消所有编辑内容。
注 –要修改全局属性，请将地址栏下拉菜单中的 DN 更改为 "TopLevel"。
等同的 psadmin 命令
管理显示配置文件
本节说明如何管理 Sun Java System Portal Server 显示配置文件。有关更多信息，参见了解显示配置文件。
您可以通过门户管理控制台执行以下任务：
下载显示配置文件
您可以将显示配置文件下载到文件中。
-
选择 "Portal" 选项卡。
-
在 "Portal" 下选择一个门户服务器。
-
从“选择 DN”下拉菜单，选择任意 DN。
-
单击“任务”下的“下载显示配置文件”。
会弹出浏览器的下载窗口。
-
选择位置然后单击“保存”。
注 –此步骤可能因浏览器的不同而有所不同。
等同的 psadmin 命令
上载显示配置文件
您可以将显示配置文件上载到文件中。
-
选择 "Portal" 选项卡。
-
在 "Portal" 下选择一个门户服务器。
-
从“选择 DN”下拉菜单，选择任意 DN。
-
单击“任务”下的“上载显示配置文件”。
-
使用“浏览”按钮选择要上载的显示配置文件。
注 –根据用户的浏览器设置，该文件应位于本地计算机中。
-
单击“上载”。
等同的 psadmin 命令
删除显示配置文件
-
选择 "Portal" 选项卡。
-
在 "Portal" 下选择一个门户服务器。
-
从“选择 DN”下拉菜单，选择任意 DN。
-
单击“任务”下的“删除显示配置文件”。
-
单击警告对话框中的“确定”以确认删除。
等同的 psadmin 命令
- © 2010, Oracle Corporation and/or its affiliates