Creating and Using Widgets › Embedding Widgets for Requesting Services and Managing Requests › Use the Status Widget and Other Widgets to Let Users Access Requests › Use the Status and Request List Widgets to Let Request Managers Approve and Reject Requests › Call the Status Widget Using Menu Options

Call the Status Widget Using Menu Options

In Liferay, using the CA Service Catalog WAR files let you configure the display and behavior of CA Service Catalog widgets in portlets by using menu options. Review the following steps for producing the earlier Status widget example. Follow them as a model to configure the display and behavior of the Status widget in your implementation.

Follow these steps:

1. On the portal page, click Add, More.

   The list of preconfigured portlets appears.

2. Expand CA Service Catalog on the list, select Status, and click Add. Alternatively, drag-and-drop Status onto the location you want.

   The Status portlet gets added to Liferay.

3. Close the list, and click Edit Controls at the top of the page.
4. Mouse-over the Status widget, click the wrench (Options) icon, and select Preferences from the drop-down list.

   The Editing Catalog Status Portlet Settings appears.

5. Review the following key parameters for the earlier Status widget example. Use them as a model to configure your portlet settings.
6. Save your settings and review the portlet. If necessary, refine your settings to meet your requirements.

You have called the Status widget and configured its display and behavior in the portlet.

Key Parameters

The key parameters for the earlier Status widget example follow:

Catalog URL=http://host-name:port-number/usm

Important! You must include the "/usm" in the URL for the portlet to render correctly.

Specifies the URL for the catalog.

Use the same host name and port number as when you downloaded and installed the WAR Files in Liferay.

Business Unit=London222

Specifies the business unit that catalog users can access while utilizing this Status widget. For this business unit and the business units under it, users can view the status of the requests for they have permission:

• Users who are not request managers can view the status of their own requests only.
• Request managers can view the status of both their own requests and the requests pending action assigned to them.

If you specify the root business unit, users can view the status of requests in all business units, including the root business unit. Conversely, if you specify the lowest level business unit, users can view the status of requests in that business unit only.

If you do not specify a value, the Catalog system uses the default business unit of the user accessing the widget.

Authentication Type

Specifies whether to authenticate users using single sign-on (Windows NTLM) or login credentials. We recommend single-sign-on for widgets.

If you specify single-sign-on, users are not prompted for login credentials.

If you specify login credentials, use the following format:

User name=username and Password=password

Layout=box

Displays the options on the Status widget as buttons in a single row. The options are Cart, Open, Closed, and Pending.

Alternatively, you can specify the row layout: Each option appears on its own row in a table with a description.

Open In=Other widget

Specifies that another widget on the same page listens to events from the Status widget and responds to them. In this scenario, when the user clicks a service, another widget responds by opening the target. The targets are as follows:

To enable these target functions to complete correctly when users click the option on the cart, add the following widgets to the page:

• Edit Request widget
• Request List widget

Open In specifies how a target opens when the user clicks it on the Status widget. Other possible values for this parameter follow:

New window

Opens the target on a new page.

Same page

Opens the target in the catalog, on the same page.

Top frame

Performs the same function as _self, except that the target opens in the top-most frame of the browser. If the target is a frame, then the first associated frame in the service option element is selected.

URL

Opens the target using a custom URL. The URL can include a placeholder for the object ID of the source context, for example, the service.

An example follows:

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

Note: You can also specify the following settings, as shown in the menu options: refresh rate in minutes and hide cart.