test

Sun Java System Portal Server 7.2 管理指南

第 2 部分 设计桌面

第 13 章 管理桌面主题和布局

利用 Portal Server 管理控制台中的桌面设计工具 (Desktop Design Tool, DDT) 可轻松地使用 GUI 创建新的桌面和/或编辑现有的桌面。本章包含以下各节：

了解桌面设计工具

本节包含以下子节：

在哪里部署 DDT？

桌面设计工具支持两种部署方案：

如果从头开始工作，必须已经给标识节点 (Distinguished node, DN) 分配了桌面服务。创建新节点并为其分配了桌面服务后，您就可以在 Portal Server 管理控制台中选择新节点，并单击“桌面设计工具”链接。该节点中会自动创建一个名为 Untitled 的选项卡，您可以在该选项卡上开始工作。

什么是沙箱组织？

如果安装了沙箱范例，则安装程序会创建沙箱组织。同时会在沙箱组织下创建一个桌面用户 sandbox。sandbox 是用户 sandbox 的密码。您可以使用该组织开始建立桌面。沙箱组织有一个主选项卡，该主选项卡又拥有两个子选项卡。您可以开始将 Portlet 添加到布局。以用户 sandbox 登录即可查看使用桌面设计工具建立的实际桌面。

可利用沙箱组织 DN 在桌面设计工具中快速创建新桌面，而无需分别创建新组织和新用户。

DDT 有什么作用？

使用桌面设计工具可以创建或编辑桌面布局，然后在其上应用主题。桌面设计工具可以分为两个主要区域：布局和主题。您可以使用桌面设计工具处理所选择的没有加载任何显示配置文件文档的 DN，并从头开始创建新的桌面。默认主题（外观和感觉）会被使用，且您可通过桌面通用任务区域中的“管理主题”链接切换主题。

如果在桌面设计工具中创建了新桌面，则桌面类型值为 theme_support。在空白方案中创建了新组织时，桌面类型为 default，父容器为 DefaultChannel。使用桌面设计工具设计新组织后，桌面类型仍为 default，父容器会更改为 DefaultJSPTabContainer。

使用桌面设计工具自定义桌面

可使用 DDT 自定义门户中的页面的布局，以及门户页面所用的主题。

桌面设计工具布局

桌面设计工具布局：

桌面设计工具主题

桌面设计工具主题：

Portal Server 软件包括两个主题：default 和 heavy，部署后可分别在 WEB_CONTAINER/portal/desktop/themes/lite 和 WEB_CONTAINER/portal/desktop/themes/heavy 目录中提供。默认情况下，沙箱范例门户使用 default 主题，企业范例门户使用 heavy 主题。

主题 CSS 文件存储在门户 Web 应用程序中，或 Web 容器中的独立主题 Web 应用程序中。Web 应用程序的文件结构是：

WEB_APPLICATION_BASE_DIR/portal/desktop/themes/ THEME_NAME/css/style.css

主题的样式表

WEB_APPLICATION_BASE_DIR/desktop/themes/THEME_NAME/images/IMAGE_FILES

样式表中使用的图像文件

WEB_CONTAINER/portal/desktop/themes/THEME_NAME/Template.html

Web 设计人员可使用 Dreamweaver 自定义的模板

WEB_CONTAINER/portal/desktop/themes//js/scripts.js

Javascript

注 –

default 主题和 heavy 主题中使用的所有 Javascript 均位于 WEB_CONTAINER/portal/desktop/themes/js/scripts.js 文件中，该文件也会加载 WEB_CONTAINER/portal/desktop/themes/js/scripts.js/portalMenuHandler.js 文件。

注 –

对于 Solaris，WEB_CONTAINER 为 /opt/SUNWappserver/appserver/domains/domain1/applications/j2ee-modules/，对于 Linux 为 /opt/sun/appserver/domains/domain1/applications/j2ee-modules/。

default 主题和 heavy 主题都在显示配置文件 AvailableThemes 集合中拥有相关的集合：


<Collection name="AvailableThemes" propagate="false">
	<Collection name="default" propagate="false">
				<String name="contextPath" value="desktop/themes/ lite"/>
		<Boolean name="editable" value="false"/>
		<Boolean name="insidePortalWar" value="true"/>
		<Boolean name="portletControlMenu" value="true"/>
	</Collection>
	<Collection name="heavy" propagate="false">
				<String name="contextPath" value="desktop/themes/ heavy"/>
		<Boolean name="editable" value="false"/>
		<Boolean name="insidePortalWar" value="true"/>
		<Boolean name="portletControlMenu" value="false"/>
	</Collection>
</Collection>

访问桌面设计工具

可在 Portal Server 管理控制台中通过以下其中一种方式访问桌面设计工具：

Procedure通过桌面设计工具链接访问桌面设计工具

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

    可在浏览器中通过以下 URL 来访问 Portal Server 管理控制台登录页面：http://server:port/psconsole

  2. 在“常用管理任务”选项卡中选择“桌面设计工具”链接。

  3. 选择您的门户和 DN。

  4. 单击“确定”。

    会显示一个页面，可在其中设计您的门户的桌面布局。上窗格显示所选 DN，以及用于添加、编辑、移动和删除选项卡或子选项卡的操作工具栏。右窗格显示了可添加到所选桌面的频道库。左窗格是工作区，可在其中设计选项卡和频道在桌面上的显示方式。

Procedure从“Portal”选项卡访问桌面设计工具

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

    可在浏览器中通过以下 URL 来访问 Portal Server 管理控制台登录页面：http://server:port/psconsole

  2. 选择“Portal”选项卡。

  3. 从“Portal”表中选择门户。

  4. 从“常用任务”区域选择“设计桌面布局”链接。

第 14 章 设计页面布局

可以使用桌面设计工具指定页面中的列布局。可以为每个频道分配一个厚度：窄或宽。所有窄和宽的频道都通过容器聚合，并根据所选择的页面布局显示。

使用桌面设计工具布局

本节描述以下过程：

Procedure更改桌面页面布局

  1. 在 Portal Server 管理控制台中，访问要创建或修改的桌面的“桌面设计布局”页面。

    要访问“桌面设计布局”页面，参见“在 Portal Server 管理控制台中访问桌面设计工具”的过程。

  2. 在工作区中选择要更改其页面布局的选项卡。

    您必须选择单层选项卡来更改布局。包含子选项卡的选项卡布局无法更改，因为它不包含任何布局。

  3. 单击“更改布局”。

    弹出选择可用布局的页面。

  4. 选择选项卡的布局图标。

    默认情况下可使用以下页面布局：

    • 窄-宽、宽-窄、窄-宽-窄

    • 全顶-窄-宽、全顶-宽-窄、全顶-窄-宽-窄

    • 窄-宽-全底、宽-窄-全底、窄-宽-窄-全底

    • 全顶-窄-宽-全底、全顶-宽-窄-全底、全顶-窄-宽-窄-全底

  5. 单击“确定”。

    会显示为选项卡选择的页面布局。

第 15 章 管理和自定义选项卡

您可以使用选项卡对桌面上的信息进行分类。选项卡是 Web 页面。每个顶层选项卡都有多个嵌套选项卡。桌面中选项卡显示的顺序是它们在显示配置文件中列出的顺序。因此，要让选项卡成为用户桌面中的第一个选项卡，您需要移动它，并使其成为显示配置文件中所选列表中的第一个选项卡。

管理选项卡

本节包含说明以下内容的任务：

Procedure添加选项卡

  1. 在 Portal Server 管理控制台中，访问要创建或修改的桌面的“桌面设计布局”页面。

    要访问“桌面设计布局”页面，参见“在 Portal Server 管理控制台中访问桌面设计工具”的过程。

  2. 单击“添加选项卡”按钮。

    弹出添加选项卡的页面。

  3. 通过选择相应的单选按钮来指定该选项卡是否有子选项卡。

  4. 在“页面标题”文本框中指定选项卡的标题。

    请注意您在此指定的选项卡是桌面上所显示选项卡的名称。

  5. 在“容器名称”文本框中指定选项卡的容器名称。

    这是 Portal Server 软件标识该选项卡的名称。您在此指定的名称可以与选项卡标题的名称（在第 4 步中指定）相同，但每个名称必须是唯一的。

  6. 指定页面是否要为最终用户启用 AJAX。

    注 –

    如果选项卡启用了 Ajax，则得到以下功能：

    • 在页面中拖放定位频道和 Portlet

    • 频道容器控制的不同步操作控制，如最小化、删除和最大化

    • 单个频道和 Portlet 的单独刷新，不刷新整个页面

    • 编辑内嵌的频道和 Portlet，不刷新整个页面

    • 简单地添加和删除频道

  7. 单击“完成”。

    该选项卡会添加到您的工作区的桌面。

Procedure添加子选项卡

  1. 在 Portal Server 管理控制台中，访问要创建或修改的桌面的“桌面设计布局”页面。

    要访问“桌面设计布局”页面，参见“在 Portal Server 管理控制台中访问桌面设计工具”的过程。

  2. 单击要创建辅助选项卡的主选项卡。

    主选项卡必须支持子选项卡。

  3. 单击“添加选项卡”按钮。

    弹出添加辅助选项卡的页面。

  4. 在“选项卡标题”文本框中指定选项卡的标题。

    请注意您在此指定的选项卡是桌面上所显示选项卡的名称。

  5. 在“容器名称”文本框中指定选项卡的容器名称。

    这是 Portal Server 软件标识该选项卡的名称。您在此指定的名称可以与选项卡标题的名称（在第 3 步中指定）相同，但每个名称必须是唯一的。

  6. 选择相应的单选按钮可指定是否使该选项卡启用 AJAX。

  7. 单击“添加”。

    将辅助选项卡添加到工作区中的桌面上的主选项卡下面。

Procedure编辑选项卡

  1. 在 Portal Server 管理控制台中，访问要创建或修改的桌面的“桌面设计布局”页面。

    要访问“桌面设计布局”页面，参见“在 Portal Server 管理控制台中访问桌面设计工具”的过程。

  2. 单击要编辑的选项卡。

  3. 单击“选项卡操作”菜单中的“编辑选项卡”按钮。

    弹出可编辑选项卡属性的页面。

  4. 完成修改后单击“关闭”。

Procedure删除选项卡

  1. 在 Portal Server 管理控制台中，访问要创建或修改的桌面的“桌面设计布局”页面。

    要访问“桌面设计布局”页面，参见“在 Portal Server 管理控制台中访问桌面设计工具”的过程。

  2. 在工作区中单击要删除的选项卡。

  3. 单击“选项卡操作”菜单中的“删除选项卡”图标。

    弹出可删除选项卡的页面。

  4. 单击“删除”按钮可确认删除选项卡。

    会从工作区的桌面上删除该选项卡。

Procedure移动选项卡

  1. 在 Portal Server 管理控制台中，访问要创建或修改的桌面的“桌面设计布局”页面。

    要访问“桌面设计布局”页面，参见“在 Portal Server 管理控制台中访问桌面设计工具”的过程。

  2. 在工作区中单击要移动的选项卡。

  3. 单击：

    左移选项卡

    将选项卡向左移动。

    右移选项卡

    将选项卡向右移动。

    您可以看到选项卡在工作区中移动。

使用选项卡分类内容

Procedure将选项卡设为启动选项卡

“启动选项卡”是用户首次登录时突出显示的选项卡。

  1. 在 Portal Server 管理控制台中，访问要创建或修改的桌面的“桌面设计布局”页面。

    要访问“桌面设计布局”页面，参见“在 Portal Server 管理控制台中访问桌面设计工具”的过程。

  2. 单击要将其设为启动选项卡的选项卡。

  3. 单击“选项卡操作”菜单中的“编辑选项卡”按钮。

    弹出可编辑选项卡属性的页面。

  4. 更改选项卡的 startTab 属性值，从而在用户登录时突出显示选项卡。

    例如，在“沙箱”范例中，默认情况下该属性的值为 Tab1/SubTab1。

  5. 完成修改后单击“关闭”。

第 16 章 管理和自定义频道

本章说明如何使用“桌面设计布局”管理和自定义频道。

注 –

要配置 Instant Messenger 频道，可参阅 http://wiki.java.net/bin/view/OpenPortal/ConfigureIMPortlet72。

管理频道

Procedure移动频道

  1. 在 Portal Server 管理控制台中，访问要创建或修改的桌面的“桌面设计布局”页面。

    要访问“桌面设计布局”页面，参见“在 Portal Server 管理控制台中访问桌面设计工具”的过程。

  2. 在工作区中，选择要移动的频道所在的选项卡。

  3. 在“频道”标题栏中选择：

    向上或向下图标

    在桌面中向上或向下移动频道。

    向左 (<) 或向右 (>) 图标

    在桌面中向右或向左移动频道。请注意，窄频道无法移动到宽栏中，宽频道无法移动到窄栏中。但是，在三列（窄-宽-窄）桌面中，可以使用向右或向左 (<) 图标将频道从窄栏移到左边或者右边的窄栏中。

Procedure删除频道

  1. 在 Portal Server 管理控制台中，访问要创建或修改的桌面的“桌面设计布局”页面。

    要访问“桌面设计布局”页面，参见“在 Portal Server 管理控制台中访问桌面设计工具”的过程。

  2. 在工作区中，选择要删除的频道所在的选项卡。

  3. 在“频道”标题栏中，选择关闭 (x) 图标来从桌面删除频道。

Procedure添加频道

  1. 在 Portal Server 管理控制台中，访问要创建或修改的桌面的“桌面设计布局”页面。

    要访问“桌面设计布局”页面，参见“在 Portal Server 管理控制台中访问桌面设计工具”的过程。

  2. 在工作区中，选择要在其中添加频道的选项卡。

  3. 从右侧窗格中的“频道库”中选择要添加的频道。

  4. 单击“添加到桌面”按钮将频道添加到工作区中的桌面。

    如果在库区域中选择的频道是库频道，则会出现一个弹出窗口，必须在其中指定频道名称、频道标题和频道宽度。如果所选的频道是位于当前显示配置文件节点的频道实例，则会将该频道实例添加到当前选择的选项卡。

Procedure配置频道

  1. 在 Portal Server 管理控制台中，访问要创建或修改的桌面的“桌面设计布局”页面。

    要访问“桌面设计布局”页面，参见“在 Portal Server 管理控制台中访问桌面设计工具”的过程。

  2. 在工作区中，选择要配置的频道所在的选项卡。

  3. 在频道中选择“配置频道”链接。

    会弹出带有频道属性的页面，可在其中编辑频道属性。

  4. 完成修改后单击“关闭”。

Procedure设置频道工具栏属性

  1. 在 Portal Server 管理控制台中，访问要创建或修改的桌面的“桌面设计布局”页面。

    要访问“桌面设计布局”页面，参见“在 Portal Server 管理控制台中访问桌面设计工具”的过程。

  2. 在工作区中，选择频道所在的选项卡。

  3. 在“频道”窗口中选择“设置工具栏属性”链接。

    会弹出一个页面，可在其中修改频道的频道工具栏属性。也可在该页面中修改频道所在的选项卡的频道工具栏和显示属性（例如最小化、最大化、可移动，可删除）。

  4. 单击“保存”以保存值。

  5. 单击“关闭”以关闭弹出窗口。

Procedure使频道对用户可见或不可见

  1. 在 Portal Server 管理控制台中，访问要创建或修改的桌面的“桌面设计布局”页面。

    要访问“桌面设计布局”页面，参见“在 Portal Server 管理控制台中访问桌面设计工具”的过程。

  2. 在工作区中，选择频道所在的选项卡。

  3. 选择以下链接：

    使频道对最终用户不可见

    使频道不可见。

    使频道可见

    使频道在用户桌面上可见。

将频道添加到用户定义选项卡

用户可以使用“选项卡”链接并单击“创建新选项卡”将新选项卡添加到桌面。如果用户从头开始创建新选项卡，则出现的内容页面中显示的频道列表来自于 JSPTabCustomTableContainer 的可用列表。

使用频道将内容添加到桌面

门户管理员可以通过添加提供者和 Portlet 频道来将内容添加到 Portal 桌面。以下过程讨论了创建频道、修改频道属性、将频道添加到桌面并确认其显示的方法。

Procedure创建 URLScraper 频道

假设您要创建名为 MyChannel、并且从外部 Web 页面（例如 http://www.google.com）显示内容的频道。以下就是创建 URLScraper 频道的步骤。也可以执行同样的步骤来创建其他基于提供者和基于 Portlet 的频道。

TBD

  1. 以管理员的身份 (amadmin) 登录到 Portal Server 管理控制台。

  2. 单击“Portal”选项卡。

  3. 单击“Portal”列表中的“Portal-URI”。

  4. 在“选择 DN”列表中选择“企业范例 [Org]”。

  5. 单击“设计桌面布局”。

  6. 选择要创建新频道的选项卡。例如，单击“新闻”选项卡。

  7. 单击“NewsContainer”页面中的“新建频道或容器”。

  8. 在“频道库”列表中选择“URLScraper”。

  9. 在“频道库”中单击“添加至桌面”。

    显示一个弹出窗口。提供以下信息：

    1. 指定频道标题。

    2. 指定频道名称。

    3. 指定频道宽度。

  10. 单击“添加频道”。此时频道在工作区中可用并可见。

自定义频道刷新时间和容器高速缓存

refreshTime 属性控制重新载入频道内容的频率。如果将容器的 refreshTime 设为 0（默认值），浏览器刷新（或重新载入）会引起页面重新载入，并且会再次调用每个频道的 getContent() 方法。

以下应用于单个频道：

以下适用于控制和配置容器高速缓存：

注 –

如果有很多通道，则可以将 refreshTime 设置为较大的数值来利用提供者高速缓存，以便门户页面可以使用高速缓存后的内容。这在大多数频道都拥有静态内容时很有意义。refreshTime 的工作方式是，如果已设置容器的 refreshTime，就会使用它。如果将 refreshTime 设置为空字符串，则会尝试获得和使用所选频道的 refreshTime 的最小值。

自定义窗口首选项

对于包含启动其他浏览器的链接的频道，可控制浏览器窗口的打开方式。

Procedure自定义频道窗口首选项

  1. 定义显示配置文件（对于频道，仅更改频道本身；对于提供者，则更改所有使用该提供者的频道）以包含 windowPref 属性。

    例如：


    <Properties>
	...
	<String name="windowPref" value="all_new"/>
	...
</Properties>
    注 –

    值可以是：

    • all_new（在不同新窗口中打开每个链接）

    • one_new（在同一个新窗口中打开所有链接）

    • same（桌面窗口）

  2. 使用 psadmin 子命令或从 Portal Server 管理控制台将显示配置文件加载到 LDAP。

    注 –

    需要借助 JavaScript 来为该特定频道建立智能。

Procedure从 Portal Server 管理控制台自定义频道窗口首选项

  1. 登录到 Portal Server 管理控制台，并选择要更改 windowPref 的用户、组织或角色。

  2. 选择“管理频道和容器”，并单击所涉及的频道。在右侧框架中，更改频道的 windowPref 属性值。

    值可以是 ：

    • all_new（在不同新窗口中打开每个链接）

    • one_new（在同一个新窗口中打开所有链接）

    • same（桌面窗口）

删除按钮

Procedure删除容器的所有频道中的按钮

  1. 查找要使用的容器。如果要使用其中一个范例门户，则需要修改相应的“已包含”容器，此容器是顶层容器的一部分。

  2. 将“删除按钮”中的相应属性（在 <Properties></Properties>之内）标记添加到要删除之按钮所在的容器的显示配置文件中。这张表格包含两列，第一列列出了按钮，第二列列出了可隐藏按钮的属性。

    此表格中按钮的顺序与它们在频道中显示的顺序相同，从左到右依次是：“最小化”、“最大化”、“帮助”、“编辑”、“分离”和“删除”。

    按钮 

    可隐藏按钮的属性 

    最小化 

    <Boolean name="defaultChannelIsMinimizable" value="false"/>

    最大化 

    <Boolean name="defaultChannelIsMaximizable" value="false"/>

    帮助 

    <String name="helpURL" value=""/>

    编辑 

    <Boolean name="isEditable" value="false"/>

    分离 

    <Boolean name="defaultChannelIsDetachable" value="false"/>

    删除 

    <Boolean name="defaultChannelIsRemovable" value="false"/>

    注 –

    对于“帮助”和“编辑”按钮，应该为每个频道插入各自的属性。无法在容器的 <Properties></Properties> 标记中插入属性。

    确保容器中没有定义以下属性：


    <Collection name="channelsIsRemovable">..</Collection>
<Collection name="channelsIsMinimizable"/>..</Collection>
<Collection name="channelsIsMaximizable"/>..</Collection>
<Collection name="channelsIsDetachable"/>..</Collection>

  3. 使用 psadmin 子命令或从 Portal Server 管理控制台将显示配置文件加载到 LDAP。

Procedure从 Portal Server 管理控制台中删除容器的所有频道中的按钮

  1. 登录到 Portal Server 管理控制台，并选择在其中定义了容器的用户、组织或角色。

  2. 选择“管理频道和容器”，并单击所包含的容器。

  3. 将 DefaultChannelIsMinimizable、 DefaultChannelIsMaximizable、helpURL、isEditable、DefaultChannelIsDetachable 和 DefaultChannelsIsRemovable 属性的值更改为 false。

  4. 选择“保存”以保存新值。

Procedure删除单个频道中的按钮

  1. 对于要删除按钮的频道，可将相应的属性添加到包含该频道的容器的 Collection 标记。有关删除按钮的详细信息，参见“删除按钮”。这张表格包含两列，第一列列出了按钮，第二列列出了可隐藏按钮的属性。

    此表格中按钮的顺序与它们在频道中显示的顺序相同，从左到右依次是：“最小化”、“最大化”、“帮助”、“编辑”、“分离”和“删除”。

    按钮 

    可隐藏按钮的属性 

    最小化 

    <Collection name="channelsIsMinimizable">

    <Boolean name="channelname" value="false"/>

    </Collection>

    最大化 

    <Collection name="channelsIsMaximizable">

    <Boolean name="channelname" value="false"/>

    </Collection>

    分离 

    <Collection name="channelsIsDetachable">

    <Boolean name="channelname" value="false"/>

    </Collection>

    删除 

    <Collection name="channelsIsRemovable">

    <Boolean name="channelname" value="false"/>

    </Collection>

  2. 对于要删除按钮的频道，可将相应的属性添加到控制容器中的“集合”标记。

    例如，使用以下 XML 在 JSP 表格容器（此表格容器的名称为 MyFrontPageTabPanelContainer，其容器为 JSPTabContainer）中隐藏范例 JSP 频道的“删除”按钮。


    <Container name="MyFrontPageFramePanelContainer" provider="JSPTableContainerProvider">
	<Properties>
		...
		<Collection name="channelsIsRemovable">
		<Boolean name="SampleJSP” value="false”/>
		</Collection>
	</Properties>
	...

  3. 使用 psadmin 子命令或从 Portal Server 管理控制台将显示配置文件加载到 LDAP。

Procedure从 Portal Server 管理控制台中删除单个频道中的按钮

  1. 登录到 Portal Server 管理控制台，并选择在其中定义了容器的用户、组织或角色。

  2. 选择“管理频道和容器”，并单击所包含的容器。

  3. 按照以下操作更改 channelsIsMinimizable、channelsIsMaximizable、channelsIsDetachable 和 channelsIsRemovable 属性的值：

    1. 从“属性”表格中选择属性（例如 channelsIsMinimizable），然后单击“新建属性”。

    2. 创建布尔类型的属性，并指定不需要该按钮的频道名称，接着将值设为 false。

    3. 按照步骤完成向导。

      指定频道的“属性”表格中将会有新的布尔属性（例如 channelsIsMinimizable 属性）。

从频道删除标题栏

Procedure从频道删除标题栏

  1. 将以下内容添加到频道所在的表格容器的显示配置文件。


    <Collection name="channelsHasFrame">
<Boolean name="channelname" value="false"/>
</Collection>

  2. 使用 psadmin 子命令或从 Portal Server 管理控制台将显示配置文件加载到 LDAP。

更改频道边界宽度和/或颜色

您可以更改 GlobalThemes 集合的 borderWidth 属性和 borderColor 属性。这会分别更改主题的频道边界的宽度和颜色。用户随后可以在“主题”页面选择该主题。

Procedure更改容器中所有频道的边界宽度和颜色

  1. 登录到 Portal Server 管理控制台，并选择“Portal”、“portal-URI”、“企业范例”（从“选择 DN”下拉菜单） 和“管理频道和容器”。

  2. 在“视图”下拉菜单中选择“DP XML 树”。

  3. 选择“DP_Root”、“GlobalThemes”和“SunTheme”。

  4. 修改 borderWidth 和 borderColor 设置并保存。

管理频道库

Procedure创建新的库频道

  1. 在 Portal Server 管理控制台中，访问要创建或修改的桌面的“桌面设计布局”页面。

    要访问“桌面设计布局”页面，参见“在 Portal Server 管理控制台中访问桌面设计工具”的过程。

  2. 从“频道库”工具栏中选择“新建库频道”图标。

    弹出一个页面，可从该页面将新频道添加到库。

  3. 指定是频道还是库频道。

    创建库频道之后，其名称中会附加 __Library__ 前缀，而且此库频道会存储在全局显示配置文件中。无法从 Portal Server 管理控制台的“管理容器和频道”链接管理以 _ 开头的频道。使用管理控制台的“桌面设计工具”链接更改库频道的属性。

  4. 指定频道类型。

    频道可以是基于提供者的频道、与 JSR 168 兼容的 Portlet 或 WSRP 远程 Portlet 频道。

  5. 指定以下对象的名称：

    提供者

    适用于基于提供者的频道。

    Portlet

    适用于兼容 JSR 168 或 JSR 286 的 Portlet。

    生成方

    适用于 WSRP 远程 Portlet 频道。

  6. 指定频道的名称。

    频道名称必须是唯一的。

  7. 检查您的设置，并单击“完成”。

    结果页面显示了尝试为频道库创建新频道的结果。

Procedure编辑库频道属性

  1. 在 Portal Server 管理控制台中，访问要创建或修改的桌面的“桌面设计布局”页面。

    要访问“桌面设计布局”页面，参见“在 Portal Server 管理控制台中访问桌面设计工具”的过程。

  2. 从“频道库”中的频道列表中选择频道。

  3. 从“频道库”工具栏中选择“编辑”图标。

    弹出一个页面，可在此页面中编辑频道属性。

  4. 在页面中进行更改，并单击“关闭”。

    频道属性得到修改。

Procedure删除库频道

  1. 在 Portal Server 管理控制台中，访问要创建或修改的桌面的“桌面设计布局”页面。

    要访问“桌面设计布局”页面，参见“在 Portal Server 管理控制台中访问桌面设计工具”的过程。

  2. 从“频道库”中的频道列表中选择频道。

  3. 从“频道库”工具栏中选择“删除”图标。

    弹出要求确认删除的窗口。

  4. 单击“确定”。

    从“频道库”列表中删除频道。

Procedure部署 Portlet

  1. 在 Portal Server 管理控制台中，访问要创建或修改的桌面的“桌面设计布局”页面。

    要访问“桌面设计布局”页面，参见“在 Portal Server 管理控制台中访问桌面设计工具”的过程。

  2. 从“频道库”工具栏中选择“部署 Portlet”图标。

    弹出部署 Portlet 的页面。

  3. 分别从“选择 Portal”和“选择 DN”下拉列表中选择要部署 Portlet 的 Portal 和 DN。

  4. 选择相应的单选按钮，并指定 Portlet WAR 和 Portlet 部署信息的路径。

    您可以指定位于本地机器或 Portlal Server 主机的 WAR 文件。Portlet WAR 文件是必需的。您可以指定位于本地机器或 Portlal Server 主机的角色和用户文件。角色映射文件和用户映射文件是可选的。

  5. 验证信息，并单击“完成”。

    结果页面显示了尝试部署 Portlet 的结果。

第 17 章 管理 Google 小工具集成

本章介绍如何将 Google 小工具与用户桌面集成。

在桌面启用 Google 小工具

Portal Server 管理员可以授权最终用户将 Google 小工具系统信息库中的小工具添加到其桌面上。本节说明 Google 小工具的功能，并为管理员提供以下指导：

Google 小工具系统信息库中的小工具借助 googlegadgetportlet.GoogleGadgetPortlet（一个 JSR 168 包装器 Portlet）运行。该 Portlet 使小工具可以在门户中运行，并使用页面容器服务，例如编辑首选项、仅显示标题栏、在整个页面中显示、在新窗口中显示和删除。

注 –

一些小工具可能与 Portal Server 不兼容（例如专门为个性化 Google 主页设计的小工具，或显示 RSS 源的小工具）。小工具由 Google、第三方厂商或用户开发，其性能、质量或内容都没有承诺和保证。

您可在门户页面中以全局级别、组织级别、角色级别或用户级别为基于 JSPTableContainerProvider 和 AJAXTableContainerProvider 的页面容器启用 Google 小工具。

如果 Portal Server 管理员启用在桌面上运行 Google 小工具系统信息库中的小工具，则授权的最终用户可以执行以下操作：

Procedure获取 Portal Server 的 Google 小工具 API 密钥

门户使用 Google 的 AJAX Feed API，其需要 Google API 密钥才能工作。一个 Google API 密钥仅对一个域（例如 foo.com）及其子域（例如 bar.foo.com）有效。

  1. 转到 Google AJAX Feed API 的 Google 注册页面。

  2. 单击“Sign-up for a Google AJAX API key”（注册取得 Google AJAX API 密钥）链接。

    显示注册页面。

  3. 按照所提供的说明执行操作。

  4. 单击“Generate API Key”（生成 API 密钥）。

Procedure授权门户最终用户设置 Google 小工具

要允许最终用户设置和显示 Google 小工具，您必须设置“API 密钥”属性，并激活“添加 Google 小工具”链接。

  1. 登录到管理控制台。

  2. 导航至您的门户的“管理容器和频道”这一节。

  3. 设置“Google 小工具 API 密钥”定义。

    1. 选择“顶级[[全局]] DN”。

    2. 在左侧框架中单击“GoogleGadgetContainer”。

    3. 在右侧属性表的 apiKey 属性值中，输入您的 Google API 密钥。

    4. 保存更改。

  4. 激活“添加 Google 小工具链接”属性。

    1. 导航至以下某项的页面容器编辑页面：

      • 用户 DN

      • 组织 DN

      • 角色 DN

      • 全局 DN

    2. 将 isGoogleGadgetsEnabled 属性值设置为 true。

      这一设置会自动在门户页面上为拥有适当权限的最终用户显示“添加 Google 小工具”链接。这些最终用户可单击“添加 Google 小工具”链接在其页面上添加小工具。

Procedure为 2column 社区启用“添加 Google 小工具”链接

  1. 打开 /var/opt/SUNWportal/portals/portal1/communitytemplates/2column 下的 XML 模板文件（owner.xml 和 member.xml）。

  2. 将布尔属性 isGoogleGadgetsEnabled 添加到容器 (jsptablecontainerprovider) 的 DP，并将值设置为 True。