Modify view in the Data List widget

Portal Data List widget › Configurable Portal widgets › Set up self-service › Configure › Customer Service Management

Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Create a condition script to modify views in the Portal Data List widget.

Before you begin

The UI Components for Customer Portals plugin must have been activated. For more information, see Activate the UI Components for Customer Portals plugin

Role required: sp_admin

Priority	Source	Description
1 \(Highest\)	Script	If a Views Condition Script is configured and returns a view name, that view is used. Scripts have the most flexibility since they can apply custom logic using the parameters - `categoryId`, `params`.
2	role\_based\_views / guest\_view	If no script is configured or the script doesn’t return a view, the system checks the JSON instance options. - For logged-in users, it checks `role_based_views` to find a view matching the user's roles. - For non-logged-in users, it uses `guest_view` .
3	view	The widget uses the view JSON instance option if the script or role based view/guest view mappings doesn’t apply.
4 \(Lowest\)	Default View on Platform	If no other configuration applies, the widget uses the platform’s default view for the table.

Navigate to All > System Extensions Points > Scripted Extensions Points.
On the Extension Points page, in the API Name column search field, enter *datalist.
Select the sn_ciwf_ui_cmpnt.DatalistCategoryConditionScript in the API Name column.

If a message appears about the application scope, select here to be able to edit the record.
On the DatalistCategoryConditionScript page, in the Related links, select Create implementation.

In the Script field, paste the following CSS code:

getView: function(category_id, params) {
    return "case"; // view
}

Parameters	Description
category\_id	Portal Data list category id.
params	JSON containing url\_params and related\_table. For example, `{ "url_params": { "table": "customer_contact", "sys_id": "60beb5e7d7600200e5982cf65e6103ad", "view": "sp" }, "related_table": "sn_customerservice_case" }`

Copy the name of a condition script from the Name field.
Select Update.
Navigate to your portal home page.
On the Data List widget, press Control+right-click.
Select Instance Options.
In the Behavior section, paste the name that you copied into the Data List condition script field.
Select the condition script from the list.
Select Save.