创建和使用小组件 › 嵌入用于请求服务和管理请求的小组件 › 使用状态小组件和其他小组件以允许用户访问请求 › 使用状态和请求列表小组件以允许请求经理批准和拒绝请求 › 使用源代码调用状态小组件

使用源代码调用状态小组件

在 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/status.widget.js"></script>

<script> CA_Catalog.buildWidget({type: 'status', login credentials, renderTo: 'status1', businessUnit:"London222",  layout:'layout-2', openIn: '_widget', hideCart: true} ); </script>

<div align="center" id="status1" style="width: 400px; margin-bottom: 10px; height: 100px">

	&nbsp;</div>

第一行引用“状态”小组件的 JavaScript 文件。

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

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

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

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

登录凭据

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

username: 'username', password: 'password'

type:"status"

指定小组件为“状态”小组件。

renderTo:"status1"

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

businessUnit:"London222"

指定在利用此“状态”小组件时目录用户可以访问的业务单位。 对于此业务单位以及其下面的业务单位，用户可以查看他们有权查看的请求的状态：

• 不是请求经理的用户仅可以查看自己请求的状态。
• 请求经理可以查看自己请求的状态以及分配给他们的并等待操作的请求的状态。

如果您指定根业务单位，用户可以查看所有业务单位（包括根业务单位）中的请求的状态。 反之，如果您指定最低级别业务单位，用户仅可以查看该业务单位中的请求的状态。

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

layout:'layout-2'

将“状态”小组件上的选项以单行按钮形式显示。 选项包括“购物车”、“打开”、“已关闭”和“待处理”。

或者，指定 layout-1 以垂直显示选项：每个选项都显示在其自己的表行上。

openIn:"_widget"

指定同一页面上的其他小组件侦听来自“状态”小组件的事件并对其作出响应。 在此方案中，当用户单击“状态”小组件上的选项时，其他小组件通过打开目标作出响应。 目标如下所示：

要使这些目标功能在用户单击购物车上的选项时正确完成，请将以下小组件添加到该页面中：

• 编辑请求小组件
• 请求列表小组件

OpenIn 指定用户在“状态”小组件上单击目标时该目标的打开方式。 此参数的其他可能值如下所示：

_self

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

_top

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

_blank

在新页面上打开目标。

_url

使用自定义 URL 打开目标。 URL 可以包括源上下文的对象 ID 的占位符，例如服务。

示例如下：

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

注意：还可以指定以下设置，如源代码中所示：刷新速率 (以分钟为单位) 和隐藏购物车。