Generally, a list of records contains elements as listed below:
- The <breadcrumbs> widget allowing navigation within the Portal pages structure.
- The <listItems> widget displaying the items list in line with the parameters specified.
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
list widget, use its attributes. Attribute values can be passed in several ways:
- By a client script or a server script of the widget.
- From the Schema Option Values field of the related Widget Instance (widget_instance).
- 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. That is, the specified record URL is: https://{your_instance_url}/record/{request_id}
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.