Previous Topic: Call the Edit Request Widget Using Source CodeNext Topic: Call the Request List Widget Using Source Code

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 Request List Widget Using Menu Options

Call the Request List 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 Request List widget example. Follow them as a model for using Liferay to configure the display and behavior of the Edit Request widget to meet your requirements.

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 Request List, and click Add. Alternatively, drag-and-drop Request onto the location you want.

    The Request List portlet gets added to Liferay.

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

    The Editing Catalog Request List Portlet Settings appears.

  5. Review the following key parameters for the earlier Request List 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.
  7. Specify the size, position, and contents of the portlet on the page.

    Note: For instructions, see your Liferay documentation. If you are using a different portal, see its documentation.

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

Key Parameters

The key parameters for the earlier Request List 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.

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

Business Unit=London222

Specifies the business unit that catalog users can access while utilizing this Request List widget. Users can list and view requests in all folders in this business unit.

For example, if you specify the root business unit, users can list and view requests in all business units, including the root business unit. Conversely, if you specify the lowest level business unit, users can list and view requests from 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.

Type=Pending Requests

Specifies that the default setting for this Request List widget is to display pending requests (requests pending action). Other options include open, closed, or recent requests.

Column List=ID, Name, Create Date, Status

Specifies that the following fields appear for open, closed, and pending requests:

Note: You can also specify others settings, including records per page, sort column, and sort order, as shown in the menu options.