创建和使用小组件 › 嵌入用于请求服务和管理请求的小组件 › 使用请求小组件以允许用户请求服务 › 使用源代码调用浏览小组件

使用源代码调用浏览小组件

在 Liferay 中，可以通过创建 portlet 并指定源代码来调用“浏览”小组件。 查看以下用于生成先前浏览小组件示例的步骤。 将其用作在实施中配置“浏览”小组件的显示和行为的模型。

遵循这些步骤:

1. 在门户页面上，执行以下操作来创建 portlet：
   1. 单击“添加”、“Web 内容显示”。
   2. 单击加号图标（添加 Web 内容）。

      将显示“新建 Web 内容”窗口。

   3. 指定必填字段，然后关闭此窗口。

   新的 portlet 将添加到 Liferay 中。

2. 单击页面顶部的“编辑控件”。
3. 将鼠标悬停在该 portlet 上，然后单击铅笔（编辑 Web 内容）图标。

   将显示 portlet 设置。

4. 在“内容”窗口中，单击“源”。

   源容器将打开以用于编辑。

5. 查看先前“浏览”小组件示例的以下源代码和关键参数。 将其用作指定源的模型。
6. 执行以下操作：
   • 关闭源容器。
   • 发布并查看更新的 portlet。
   • 如有必要，请改进规范，直到小组件符合您的要求。

源代码和关键参数

“浏览”小组件示例的源代码如下：

<script type="text/javascript" src="http://hostname:portnumber/usm/explorer/scripts/browse.widget.js"> </script>

<script type="text/javascript"> CA_Catalog.buildWidget({type: 'browse', renderTo: 'browse1', 登录凭据, businessUnit:’London222", rootId: 10001, linkColor: 'inherit', borderColor: 'black', layout:'layout-1', openIn:'_widget', search: true } ); </script>

<div id="browse1" style="margin-bottom: 10px; height: 700px">
	&nbsp;</div>

第一行引用“浏览”小组件的 JavaScript 文件。

第二行使用“浏览”小组件的配置参数指定 JavaScript。

注意：请以逗号分隔各参数，但不要在最后一个参数后指定逗号。

第三行指定在其中呈现“浏览”小组件的 DOM 元素。

“浏览”小组件示例中的 CA_Catalog.buildWidget 函数调用的关键参数和解释如下所示。

登录凭据

建议对于小组件使用单一登录。 但是，如果您需要用于此小组件的登录凭据，请在以下函数调用中指定它们。 采用以下格式：

username: 'username', password: 'password'

businessUnit:"London222"

指定在利用此“浏览”小组件时目录用户可以访问的业务单位。 用户可以浏览此业务单位的所有文件夹中的服务。

例如，如果您指定根业务单位，目录用户可以从所有业务单位（包括根业务单位）中的所有文件夹浏览服务。 反之，如果您指定最低级别业务单位的名称，目录用户仅可以浏览该业务单位的文件夹中的服务。

如果您不指定值，目录系统使用访问小组件的用户的默认业务单位。

type:"browse"

指定小组件为“浏览”小组件。

renderTo:"browse1"

指定在 ID 为 browse1 的 DOM 元素中呈现小组件。

rootId:10001

指定“浏览”小组件显示的文件夹或服务的对象 ID。 在此示例中，10001 是业务单位的目录的根文件夹。

您可以使用其对象 ID 来指定单个文件夹或以逗号分隔的服务列表。

指定的文件夹或服务必须在用户可以访问的业务单位中存在，如 businessUnit 参数中所说明。

注意：可以选择隐藏树（左侧的文件夹列表）。 要隐藏树，请指定 hideTree:true 参数。 默认情况下，此参数设置为 hideTree:false。

layout:'layout-1'

显示在“浏览”小组件中出现的服务的图标和名称。

或者，指定 layout-2 以显示服务的名称、图标和说明。

openIn:"_widget"

指定相同页面上的其他小组件侦听“浏览”小组件中的事件，并对其作出响应。 在此方案中，当用户单击某项服务时，“请求”小组件通过打开该服务作出响应。 您必须将请求小组件添加到本页以启用此功能。

OpenIn 指定当用户在“浏览”小组件上单击某服务时在“请求”小组件中如何打开该服务。 openIn 参数的其他可能值如下：

_self

在相同页面上打开目录中的服务。

_top

执行与 _self 相同的功能，但是它将在浏览器的最顶层框架中打开。 如果该服务是一个框架，则将选择服务选项元素中第一个关联的框架。

_blank

在新的页面上打开目录中的服务。 用户可在该页面上请求服务。

_url

使用自定义 URL 打开服务。 URL 可以包括服务的对象 ID 的占位符。 示例如下：

http://www.google.com?id={id}

search: true

指定“浏览”小组件包括“搜索”字段。 用户可以使用此字段根据名称或关键术语搜索目录以查找服务。

注意：还可以指定以下设置，如源代码中所示：显示突出服务、链接颜色、边框颜色以及背景色。