第 16 章 管理和自定义频道
本章说明如何使用“桌面设计布局”管理和自定义频道。
注 –
要配置 Instant Messenger 频道，可参阅 http://wiki.java.net/bin/view/OpenPortal/ConfigureIMPortlet72。
管理频道
移动频道
-
在 Portal Server 管理控制台中，访问要创建或修改的桌面的“桌面设计布局”页面。
要访问“桌面设计布局”页面，参见“在 Portal Server 管理控制台中访问桌面设计工具”的过程。
-
在工作区中，选择要移动的频道所在的选项卡。
-
在“频道”标题栏中选择：
- 向上或向下图标
-
在桌面中向上或向下移动频道。
- 向左 (<) 或向右 (>) 图标
-
在桌面中向右或向左移动频道。请注意，窄频道无法移动到宽栏中，宽频道无法移动到窄栏中。但是，在三列（窄-宽-窄）桌面中，可以使用向右或向左 (<) 图标将频道从窄栏移到左边或者右边的窄栏中。
删除频道
-
在 Portal Server 管理控制台中，访问要创建或修改的桌面的“桌面设计布局”页面。
要访问“桌面设计布局”页面，参见“在 Portal Server 管理控制台中访问桌面设计工具”的过程。
-
在工作区中，选择要删除的频道所在的选项卡。
-
在“频道”标题栏中，选择关闭 (x) 图标来从桌面删除频道。
添加频道
-
在 Portal Server 管理控制台中，访问要创建或修改的桌面的“桌面设计布局”页面。
要访问“桌面设计布局”页面，参见“在 Portal Server 管理控制台中访问桌面设计工具”的过程。
-
在工作区中，选择要在其中添加频道的选项卡。
-
从右侧窗格中的“频道库”中选择要添加的频道。
-
单击“添加到桌面”按钮将频道添加到工作区中的桌面。
如果在库区域中选择的频道是库频道，则会出现一个弹出窗口，必须在其中指定频道名称、频道标题和频道宽度。如果所选的频道是位于当前显示配置文件节点的频道实例，则会将该频道实例添加到当前选择的选项卡。
配置频道
-
在 Portal Server 管理控制台中，访问要创建或修改的桌面的“桌面设计布局”页面。
要访问“桌面设计布局”页面，参见“在 Portal Server 管理控制台中访问桌面设计工具”的过程。
-
在工作区中，选择要配置的频道所在的选项卡。
-
在频道中选择“配置频道”链接。
会弹出带有频道属性的页面，可在其中编辑频道属性。
-
完成修改后单击“关闭”。
设置频道工具栏属性
-
在 Portal Server 管理控制台中，访问要创建或修改的桌面的“桌面设计布局”页面。
要访问“桌面设计布局”页面，参见“在 Portal Server 管理控制台中访问桌面设计工具”的过程。
-
在工作区中，选择频道所在的选项卡。
-
在“频道”窗口中选择“设置工具栏属性”链接。
会弹出一个页面，可在其中修改频道的频道工具栏属性。也可在该页面中修改频道所在的选项卡的频道工具栏和显示属性（例如最小化、最大化、可移动，可删除）。
-
单击“保存”以保存值。
-
单击“关闭”以关闭弹出窗口。
使频道对用户可见或不可见
-
在 Portal Server 管理控制台中，访问要创建或修改的桌面的“桌面设计布局”页面。
要访问“桌面设计布局”页面，参见“在 Portal Server 管理控制台中访问桌面设计工具”的过程。
-
在工作区中，选择频道所在的选项卡。
-
选择以下链接：
- 使频道对最终用户不可见
-
使频道不可见。
- 使频道可见
-
使频道在用户桌面上可见。
将频道添加到用户定义选项卡
用户可以使用“选项卡”链接并单击“创建新选项卡”将新选项卡添加到桌面。如果用户从头开始创建新选项卡，则出现的内容页面中显示的频道列表来自于 JSPTabCustomTableContainer 的可用列表。
使用频道将内容添加到桌面
门户管理员可以通过添加提供者和 Portlet 频道来将内容添加到 Portal 桌面。以下过程讨论了创建频道、修改频道属性、将频道添加到桌面并确认其显示的方法。
创建 URLScraper 频道
假设您要创建名为 MyChannel、并且从外部 Web 页面（例如 http://www.google.com）显示内容的频道。以下就是创建 URLScraper 频道的步骤。也可以执行同样的步骤来创建其他基于提供者和基于 Portlet 的频道。
TBD
-
以管理员的身份 (amadmin) 登录到 Portal Server 管理控制台。
-
单击“Portal”选项卡。
-
单击“Portal”列表中的“Portal-URI”。
-
在“选择 DN”列表中选择“企业范例 [Org]”。
-
单击“设计桌面布局”。
-
选择要创建新频道的选项卡。例如，单击“新闻”选项卡。
-
单击“NewsContainer”页面中的“新建频道或容器”。
-
在“频道库”列表中选择“URLScraper”。
-
在“频道库”中单击“添加至桌面”。
显示一个弹出窗口。提供以下信息：
-
单击“添加频道”。此时频道在工作区中可用并可见。
自定义频道刷新时间和容器高速缓存
refreshTime 属性控制重新载入频道内容的频率。如果将容器的 refreshTime 设为 0（默认值），浏览器刷新（或重新载入）会引起页面重新载入，并且会再次调用每个频道的 getContent() 方法。
以下应用于单个频道：
-
不可能仅刷新容器中单个频道的内容，因为频道是 HTML 表格单元。
-
可以在 PAPI 中使用 DesktopURL() 方法。提供者可以使用 getDesktopURL() 获得桌面 Servlet 的 URL、为 URL 附加参数，以及生成新的 URL（或链接）。
-
将容器的 refreshTime 属性和容器中单个频道的 refreshTime 一起使用。
-
如果容器的 refreshTime 为空，则此属性会计算为所有包含的频道的最短时间。如果要覆写计算得到的时间，可为容器设置 refreshTime，然后整个容器的内容都会被高速缓存。
注 –
如果有很多通道，则可以将 refreshTime 设置为较大的数值来利用提供者高速缓存，以便门户页面可以使用高速缓存后的内容。这在大多数频道都拥有静态内容时很有意义。refreshTime 的工作方式是，如果已设置容器的 refreshTime，就会使用它。如果将 refreshTime 设置为空字符串，则会尝试获得和使用所选频道的 refreshTime 的最小值。
自定义窗口首选项
对于包含启动其他浏览器的链接的频道，可控制浏览器窗口的打开方式。
自定义频道窗口首选项
-
定义显示配置文件（对于频道，仅更改频道本身；对于提供者，则更改所有使用该提供者的频道）以包含 windowPref 属性。
例如：
<Properties> ... <String name="windowPref" value="all_new"/> ... </Properties>
注 –值可以是：
-
all_new（在不同新窗口中打开每个链接）
-
one_new（在同一个新窗口中打开所有链接）
-
same（桌面窗口）
-
-
使用 psadmin 子命令或从 Portal Server 管理控制台将显示配置文件加载到 LDAP。
注 –需要借助 JavaScript 来为该特定频道建立智能。
从 Portal Server 管理控制台自定义频道窗口首选项
-
登录到 Portal Server 管理控制台，并选择要更改 windowPref 的用户、组织或角色。
-
选择“管理频道和容器”，并单击所涉及的频道。在右侧框架中，更改频道的 windowPref 属性值。
值可以是 ：
-
all_new（在不同新窗口中打开每个链接）
-
one_new（在同一个新窗口中打开所有链接）
-
same（桌面窗口）
-
删除按钮
删除容器的所有频道中的按钮
-
查找要使用的容器。如果要使用其中一个范例门户，则需要修改相应的“已包含”容器，此容器是顶层容器的一部分。
-
将“删除按钮”中的相应属性（在 <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>
-
使用 psadmin 子命令或从 Portal Server 管理控制台将显示配置文件加载到 LDAP。
从 Portal Server 管理控制台中删除容器的所有频道中的按钮
-
登录到 Portal Server 管理控制台，并选择在其中定义了容器的用户、组织或角色。
-
选择“管理频道和容器”，并单击所包含的容器。
-
将 DefaultChannelIsMinimizable、 DefaultChannelIsMaximizable、helpURL、isEditable、DefaultChannelIsDetachable 和 DefaultChannelsIsRemovable 属性的值更改为 false。
-
选择“保存”以保存新值。
删除单个频道中的按钮
-
对于要删除按钮的频道，可将相应的属性添加到包含该频道的容器的 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>
-
对于要删除按钮的频道，可将相应的属性添加到控制容器中的“集合”标记。
例如，使用以下 XML 在 JSP 表格容器（此表格容器的名称为 MyFrontPageTabPanelContainer，其容器为 JSPTabContainer）中隐藏范例 JSP 频道的“删除”按钮。
<Container name="MyFrontPageFramePanelContainer" provider="JSPTableContainerProvider"> <Properties> ... <Collection name="channelsIsRemovable"> <Boolean name="SampleJSP” value="false”/> </Collection> </Properties> ...
-
使用 psadmin 子命令或从 Portal Server 管理控制台将显示配置文件加载到 LDAP。
从 Portal Server 管理控制台中删除单个频道中的按钮
-
登录到 Portal Server 管理控制台，并选择在其中定义了容器的用户、组织或角色。
-
选择“管理频道和容器”，并单击所包含的容器。
-
按照以下操作更改 channelsIsMinimizable、channelsIsMaximizable、channelsIsDetachable 和 channelsIsRemovable 属性的值：
从频道删除标题栏
从频道删除标题栏
-
将以下内容添加到频道所在的表格容器的显示配置文件。
<Collection name="channelsHasFrame"> <Boolean name="channelname" value="false"/> </Collection>
-
使用 psadmin 子命令或从 Portal Server 管理控制台将显示配置文件加载到 LDAP。
更改频道边界宽度和/或颜色
您可以更改 GlobalThemes 集合的 borderWidth 属性和 borderColor 属性。这会分别更改主题的频道边界的宽度和颜色。用户随后可以在“主题”页面选择该主题。
更改容器中所有频道的边界宽度和颜色
-
登录到 Portal Server 管理控制台，并选择“Portal”、“portal-URI”、“企业范例”（从“选择 DN”下拉菜单） 和“管理频道和容器”。
-
在“视图”下拉菜单中选择“DP XML 树”。
-
选择“DP_Root”、“GlobalThemes”和“SunTheme”。
-
修改 borderWidth 和 borderColor 设置并保存。
管理频道库
创建新的库频道
-
在 Portal Server 管理控制台中，访问要创建或修改的桌面的“桌面设计布局”页面。
要访问“桌面设计布局”页面，参见“在 Portal Server 管理控制台中访问桌面设计工具”的过程。
-
从“频道库”工具栏中选择“新建库频道”图标。
弹出一个页面，可从该页面将新频道添加到库。
-
指定是频道还是库频道。
创建库频道之后，其名称中会附加 __Library__ 前缀，而且此库频道会存储在全局显示配置文件中。无法从 Portal Server 管理控制台的“管理容器和频道”链接管理以 _ 开头的频道。使用管理控制台的“桌面设计工具”链接更改库频道的属性。
-
指定频道类型。
频道可以是基于提供者的频道、与 JSR 168 兼容的 Portlet 或 WSRP 远程 Portlet 频道。
-
指定以下对象的名称：
- 提供者
-
适用于基于提供者的频道。
- Portlet
-
适用于兼容 JSR 168 或 JSR 286 的 Portlet。
- 生成方
-
适用于 WSRP 远程 Portlet 频道。
-
指定频道的名称。
频道名称必须是唯一的。
-
检查您的设置，并单击“完成”。
结果页面显示了尝试为频道库创建新频道的结果。
编辑库频道属性
-
在 Portal Server 管理控制台中，访问要创建或修改的桌面的“桌面设计布局”页面。
要访问“桌面设计布局”页面，参见“在 Portal Server 管理控制台中访问桌面设计工具”的过程。
-
从“频道库”中的频道列表中选择频道。
-
从“频道库”工具栏中选择“编辑”图标。
弹出一个页面，可在此页面中编辑频道属性。
-
在页面中进行更改，并单击“关闭”。
频道属性得到修改。
删除库频道
-
在 Portal Server 管理控制台中，访问要创建或修改的桌面的“桌面设计布局”页面。
要访问“桌面设计布局”页面，参见“在 Portal Server 管理控制台中访问桌面设计工具”的过程。
-
从“频道库”中的频道列表中选择频道。
-
从“频道库”工具栏中选择“删除”图标。
弹出要求确认删除的窗口。
-
单击“确定”。
从“频道库”列表中删除频道。
部署 Portlet
-
在 Portal Server 管理控制台中，访问要创建或修改的桌面的“桌面设计布局”页面。
要访问“桌面设计布局”页面，参见“在 Portal Server 管理控制台中访问桌面设计工具”的过程。
-
从“频道库”工具栏中选择“部署 Portlet”图标。
弹出部署 Portlet 的页面。
-
分别从“选择 Portal”和“选择 DN”下拉列表中选择要部署 Portlet 的 Portal 和 DN。
-
选择相应的单选按钮，并指定 Portlet WAR 和 Portlet 部署信息的路径。
您可以指定位于本地机器或 Portlal Server 主机的 WAR 文件。Portlet WAR 文件是必需的。您可以指定位于本地机器或 Portlal Server 主机的角色和用户文件。角色映射文件和用户映射文件是可选的。
-
验证信息，并单击“完成”。
结果页面显示了尝试部署 Portlet 的结果。
- © 2010, Oracle Corporation and/or its affiliates