Migration of SelectUserFromList
The SelectUserFromList.aspx page was commonly used in earlier versions of Activate web wizards and forms. In later versions, this functionality is replaced and extended by the SelectUserFromGrid page. This document explains the recommended migration approach and highlights version-specific behaviour to be aware of.
Recommended replacement
For web wizards and forms, SelectUserFromGrid should be used instead of SelectUserFromList.aspx.
SelectUserFromGrid provides equivalent functionality while offering greater flexibility. Rather than applying filtering logic directly in the page definition, user selection is controlled by overriding the AvailableUsers query.
Behaviour differences and prerequisites
When migrating from SelectUserFromList.aspx to SelectUserFromGrid, ensure the following properties are configured:
- autoSkipOnEmpty
- displayColumns
These properties were not consistently available prior to version 8.1.4.465 and may need to be explicitly defined when upgrading existing wizards.
Selecting disabled users
Support for selecting disabled users was introduced in Activate build 8.1.4.481.
From this version onwards, SelectUserFromGrid can be configured to return disabled users when required, provided the correct parameters and query are supplied.
Disabled users query configuration
Disabled user selection is controlled using a task string parameter that defines the LDAP query used to retrieve users.
An example LDAP filter is shown below:
This query returns disabled users whose first name and last name match values provided in the job data.
Migration considerations
When migrating existing web wizards:
- Replace SelectUserFromList.aspx with SelectUserFromGrid
- Move filtering logic into the AvailableUsers query
- Confirm required properties are defined for the target Activate version
- Validate behaviour for disabled users if applicable
Testing should be completed in a non-production environment before deploying updated wizards.