test

Sun Java System Portal Server 7.2 管理指南

管理 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 或父组织上。

Procedure部署 Portlet

  1. 登录到 Portal Server 管理控制台。

  2. 选择“Portal”选项卡。

  3. 从“Portal”选择一个门户服务器。

  4. 从“选择 DN”下拉菜单，选择任意 DN。

  5. 单击“部署 Portlet”启动该向导。

    1. 确保选定的门户和选定的 DN 是您想要部署 Portlet 的门户和 DN，然后单击“下一步”。

    2. 指定 Portlet war 文件、角色文件以及用户文件。

      注 –

      角色文件和用户文件是可选的。war 文件、角色文件以及用户文件可以位于本地计算机上，也可以位于远程门户服务器系统上。

    3. 选择本地系统或远程门户服务器系统的按钮。

      • 如果上载的文件来自本地计算机，则使用浏览对话框从本地计算机选择文件。

      • 如果上载的文件来自远程门户服务器系统，则使用文件选择器对话框从远程计算机选择文件。

    4. 确认提供的信息，然后单击“下一步”。

    5. 当部署 Portlet 时，会显示一个信息页面。

  6. 按照说明部署 Portlet。

等同的 psadmin 命令

psadmin deploy-portlet

Procedure取消部署 Portlet

  1. 登录到 Portal Server 管理控制台。

  2. 选择“Portal”选项卡。

  3. 从“Portal”选择一个门户服务器。

  4. 从“选择 DN”下拉菜单，选择任意 DN。

  5. 单击“取消部署 Portlet”启动该向导。

  6. 根据需要修改配置属性。

  7. 单击“取消部署”以记录更改。

等同的 psadmin 命令

psadmin undeploy-portlet

Procedure修改 Portlet 首选项

  1. 登录到 Portal Server 管理控制台。

  2. 单击“常用任务”选项卡，然后从子菜单选择“管理频道和容器”。

  3. 选择要部署 Portlet 的门户和 DN。

    将显示带有可用频道和 Portlet 的导航树。

  4. 从左侧框架的导航树中，选择 Portlet 频道。

    首选项表格和属性表格显示在右侧框架中。

  5. 在首选项表格中，单击您要修改的首选项的“编辑值”链接。

  6. 在首选项向导中，在文本字段中键入新值，然后单击“确定”。

    • 要删除一个值，从列表中选择该值然后单击“删除”。

  7. 完成修改首选项后，单击“保存”。

  8. 单击“关闭”。

管理频道和容器

本节说明如何通过管理控制台管理门户服务器频道和容器。

以下主题在讨论之列：

查看频道和容器

用户的桌面是通过启动桌面父容器来呈现的。您可以在每个组织、角色和用户 DN 中自定义父容器属性。通过重复选择为在桌面父容器内显示的子容器和频道，提供特定 DN 的桌面内容。

通常，桌面父容器包含几个选项卡或表容器。父容器选定节点列表下的每个选项卡容器将在用户桌面上显示一个选项卡。出现在选项卡下的频道是选项卡容器内的频道。

门户管理控制台中“频道和容器管理”左下方的框架有两个组件：

“视图类型”菜单中的各项和树中显示的节点取决于合并的“显示配置文件 XML”的内容。

树包含容器和频道节点。有三种类型的频道为桌面提供内容：

您可以单击树中任何节点链接，以在右侧的框架中显示属性和操作。

“视图类型”菜单中有两种类型的项目：

参见查看显示配置文件 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 处桌面的父容器。当您选择桌面视图后，树将提供频道和容器的可视层次结构，该结构可为桌面呈现内容。

显示在桌面视图下的频道和容器有两个状态：

您可以更改桌面视图中的频道和容器的状态，方法是单击右侧框架中的任务链接。要显示关于状态的工具提示，请将鼠标置于容器或频道图标之上。工具提示还显示节点的全限定名。

Procedure查看显示配置文件 XML 树和桌面视图

  1. 登录到 Portal Server 管理控制台。

  2. 选择“Portal”选项卡。

  3. 在“Portal”下选择门户服务器，然后从“选择 DN”下拉菜单中选择任意 DN。

    • 您还可以从“管理容器和频道”页面中的“选择 DN”菜单选择组织。

  4. 在“任务”下，单击“管理容器和频道”。

  5. 从“视图类型”下拉菜单选择“DP XML 树”或“桌面视图”。

修改频道和容器属性

本节说明频道和容器的属性，以及如何修改它们。

您可以执行以下任务：

了解属性

当您单击树中节点时显示的属性为顶层属性或频道级别属性。这些属性定义在提供者级别，您可以为频道自定义这些属性。不过，添加到频道的新属性无法添加到提供者。这就是您无法在频道级别添加新属性的原因。

属性表显示客户机类型和语言环境。没有显示属性类型的列，不过遵循以下约定：

字符串

值列拥有宽文本字段，最多为 30 个字符。

整数

值列拥有窄文本字段，最多为 5 个字符。

Boolean（布尔型）

值为单选按钮。

映射

名称为链接。

列表

值列拥有“编辑值”链接。单击此链接可打开一个向导来添加和删除值。

空集合

名称是显示“编辑值”链接的链接。可将名称和值对添加到空集合中以像映射一般运作，这样不再显示“编辑值”。如果使用“编辑值”向导将值添加到一个空集合，则集合成为一个列表且不再出现名称链接。

除了“名称”和“值”列，属性表还有两列：

类别

显示属性是高级还是基本。高级属性通常适用于有经验的管理员。

状态

属性可以为下三种状态之一：

  • 默认 – 在提供者级别指定的值。

  • 继承 – 在某上层级别修改的值。例如，如果当前节点为角色，则属性可能已在角色的组织中自定义。此组织可能为父组织，或父组织的父项。当属性为继承时，它是一个链接。单击此链接便会显示层次结构中该属性继承自的所有可能的父节点。

  • 自定义 – 在此节点定义的值。

属性表中有以下按钮：

删除自定义

从显示配置文件中，删除在此节点定义的值。如果属性在层次结构中进行过自定义，此操作将导致从层次结构的某些父项继承属性。如果没有在层次结构的任何地方进行自定义，则显示在提供者级别定义的值，并且状态显示为“默认”。

保存

保存值的添加、删除和更改。

重置

忽略更改并将值重置为数据存储库中的上次保存状态。

清除所有排序

清除所有排序。

提示 –

表格可通过单击任意列标题进行排序。当您单击“名称”按钮时，首先按名称进行排序，“类别”和“状态”按钮旁边会显示一个 + 号。单击 + 号以应用下一个排序标准。

表格首选项

设置表格首选项。

除非经过修改，否则客户机类型和语言环境均设为默认。

Procedure创建属性

您可以通过“新建属性”向导编辑这些值并保存。您还可以添加新的成对的名称和值。

  1. 登录到 Portal Server 管理控制台。

  2. 选择“Portal”选项卡。

  3. 从“Portal”选择一个门户。

  4. 从“选择 DN”下拉菜单，选择任意 DN。

  5. 在“任务”下，单击“管理频道和容器”。

  6. 在左侧框架的树中选择一个容器，以在右侧框架中显示“编辑属性”页面。

  7. 单击“表格首选项”按钮设置客户机和语言环境的属性。

  8. 单击“新建属性”按钮以启动该向导。

  9. 选择属性类型，然后单击“下一步”。

  10. 键入一个名称，选择一个值，然后指定该属性是否为高级。

    注 –

    当集合属性包含名称和值对时，其行为与映射类似。“集合”类型的属性可以嵌套。表格上方的属性路径将更改以显示当前的嵌套，而您可以导航回到上一层。

    任何结尾值都是可选的。例如，值可以是 en 或 en_US，但不能仅仅是 US。应根据标准的 Java 格式指定语言环境。

  11. 单击“完成”创建该属性。

  12. 单击“关闭”，在表格中显示新属性。

Procedure编辑列表

当集合属性只包含值时，其行为与列表类似。

  1. 登录到 Portal Server 管理控制台。

  2. 选择“Portal”选项卡。

  3. 从“Portal”选择一个门户。

  4. 从“选择 DN”下拉菜单，选择任意 DN。

  5. 在“任务”下，单击“管理频道和容器”。

  6. 在左侧框架的树中选择一个容器，以在右侧框架中显示“编辑属性”页面。

  7. 单击属性的“编辑值”链接以启动向导。

  8. 进行更改。

    • 要添加一个值，在“新建值”文本框中键入值的名称，然后单击“添加”。

    • 要删除一个值，从“值”列表中选择该值，然后单击“删除”。

  9. 单击“关闭”。

    编辑属性页面会更新列表中值的数目。

Procedure修改频道和容器属性

  1. 登录到 Portal Server 管理控制台。

  2. 选择“Portal”选项卡。

  3. 从“Portal”选择一个门户。

  4. 从“选择 DN”下拉菜单，选择任意 DN。

  5. 在“任务”下，单击“管理频道和容器”。

  6. 在左侧框架的树中选择一个频道或容器，以在右侧框架中显示“编辑属性”页面。

  7. 更改属性，然后单击“保存”。

等同的 psadmin 命令

psadmin modify-dp

创建和删除频道和容器

本节说明如何通过门户管理控制台创建和删除频道和容器。

Procedure创建频道或容器

  1. 登录到 Portal Server 管理控制台。

  2. 选择“Portal”选项卡。

  3. 从“Portal”选择一个门户。

  4. 从“选择 DN”下拉菜单，选择任意 DN。

  5. 在“任务”下，单击“管理频道和容器”。

  6. 在左侧框架的树中选择一个容器，以在右侧框架中显示“编辑属性”页面。

  7. 在“任务”下，单击“新建频道或容器”以启动向导。

    在向导中，确保选定的门户和选定的 DN 是您想要创建频道或容器的位置，然后单击“下一步”。

  8. 通过向导创建容器或频道。

    • 要创建容器，请执行以下步骤：

      1. 从“容器提供者”下拉菜单选择一个提供者，然后单击“下一步”。

      2. 在“频道或容器名称”文本字段中键入名称，然后单击“下一步”。

      3. 查看您的选项，然后单击“完成”。

        会有一条消息确认创建容器。

      4. 单击“关闭”。

    • 要创建频道，请执行以下步骤：

      1. 选择一个频道类型。

        从以下三种类型中选择一种：

        • 如果您选择“提供者频道”，则显示提供者频道的列表。

        • 如果您选择“JSR 168 Portlet 频道”，则显示 Portlet 频道的列表。

        • 如果您选择“WSRP 远程 Portlet 频道”，则从下拉菜单中选择注册的生成方和远程 Portlet。

      2. 在“频道或容器名称”文本字段中键入名称，然后单击“下一步”。

      3. 查看您的选项，然后单击“完成”。

        会有一条消息确认创建频道。

      4. 单击“关闭”。

等同的 psadmin 命令

psadmin add-dp

Procedure删除频道或容器

  1. 登录到 Portal Server 管理控制台。

  2. 选择“Portal”选项卡。

  3. 从“Portal”选择一个门户。

  4. 从“选择 DN”下拉菜单，选择任意 DN。

  5. 在“任务”下，单击“管理频道和容器”。

  6. 在左侧框架的树中选择一个容器，以在右侧框架中显示“编辑属性”页面。

  7. 在“任务”下，单击“选择要删除的容器或频道”。

  8. 在“类型”下，选择“频道或容器”。

    会显示可用的频道和容器。

  9. 选择一个频道或容器，然后单击“删除”。

等同的 psadmin 命令

psadmin remove-dp

创建选项卡

本节说明如何通过门户服务器管理控制台创建选项卡。

Procedure创建选项卡

  1. 登录到 Portal Server 管理控制台。

  2. 选择“Portal”选项卡。

  3. 从“Portal”选择一个门户。

  4. 从“选择 DN”下拉菜单，选择任意 DN。

  5. 在“任务”下，单击“管理频道和容器”。

  6. 从左侧框架中的树中，选择 JSPTabContainer。

  7. 在右侧框架中的“任务”下，单击“新建选项卡”以启动向导。

显示频道和容器

本节说明如何显示最终用户桌面上的频道和容器。频道和容器也可以在内容页面上提供，以便最终用户进行选择以将它们显示在桌面上。

Procedure在桌面上显示频道和容器

  1. 登录到 Portal Server 管理控制台。

  2. 选择“Portal”选项卡。

  3. 从“Portal”选择一个门户。

  4. 在“任务”下，单击“管理容器和频道”。

  5. 在左侧框架的树中选择一个容器，以在右侧框架中显示“编辑属性”页面。

  6. 在“任务”下，单击“在 Portal 桌面上显示或隐藏频道和容器”。

  7. 在“准备使用”下，选择一个频道或容器。

  8. 使用“添加”按钮，将频道移动到“内容页面”或“Portal 桌面”上显示。

    • 使用“删除”按钮，可将频道或容器移回“准备使用”。

  9. 单击“保存”。

等同的 psadmin 命令

psadmin modify-dp