Modify view in the Data List widget

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

Vorbereitungen

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

Warum und wann dieser Vorgang ausgeführt wird

Tabelle : 1. Priority order for how the Data List widget determines the view

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.

Prozedur

1. Navigate to All > System Extensions Points > Scripted Extensions Points.
2. On the Extension Points page, in the API Name column search field, enter *datalist.
3. 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.
4. On the DatalistCategoryConditionScript page, in the Related links, select Create implementation.
5. In the Script field, paste the following CSS code:

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

   Tabelle : 2. Function parameters

   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" }

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