Generally, a list of records contains elements as listed below:

  1. The breadcrumbs widget allowing navigation within the Portal pages structure.
  2. The listItems widget displaying the items list in line with the parameters specified.
  3. The Read Only Form widget displaying record information in a read-only format.
  4. The View Task Readonly Form widget, that is similar to the Read Only Form widget, but it also displays REM attributes of a record.

The page is located on the dedicated portal node.

Breadcrumbs configuration

To configure breadcrumbs correctly, it is preferable to use the attribute values as in the example below (type these values in the Template field of the <breadcrumbs> widget form):

<div class="portal__breadcrumbs">
  <breadcrumbs>
</div>

List widget configuration

To configure a list widget implemented by a listitems tag, use its attributes. Attribute values can be passed in several ways:

  1. By a client script or a server script of the widget.
  2. From the Schema Option Values field of the related Widget Instance (widget_instance).
  3. Or they can be defined in the Template field of the widget.

it is preferable to follow the recommendations when filling in the attribute values. You can use the example below as a pattern:

<listitems class="linkStyles" tableName="itsm_request" condition="(stateNOT IN10@7)" listView="SP" itemPage="record" itemView="SP View Only" choiceConditionName="state" dateConditionName="sys_updated_at" perPage="10" displayColumnNumber="2"></listitems>

Let's take a closer look at this example.

tableName="itsm_request" condition="(stateNOT IN10@7)"

These attributes allow rendering request lists with statuses other than Closed or Completed.

 listView="SP"

In this example, the "SP" list view is used instead of the default.

itemPage="record"

The record page is used for opening and displaying the list items. In this case, it is a pathname of the portal page displayed after the record is opened.

For more information, check the listitems tag attributes description in the relevant article.

itemView="SP View Only"

The SP View Only record view is used instead of the default to display the request record form

choiceConditionName="state"

dateConditionName="sys_updated_at"

Requests are filtered by state and creation date.

perPage="10"

One list page displays ten records

displayColumnNumber="2"

The column containing clickable titles used to navigate into a record is a second one in the list.