Modify view in the Data List widget

  • Freigeben Version: Australia
  • Aktualisiert 12. März 2026
  • 1 Minute Lesedauer

    • 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.