getdistinctusers() Function

Function

getdistinctusers( peopleArray )

Retrieves users from a set of users and groups.

See also: topeople()

Parameters

Keyword	Type	Description
peopleArray	User or Group Array	The groups or users and groups that you want to convert to the User data type.

Returns

User Array

Usage considerations

You can reference a group as a peopleArray value by creating a constant with a User or Group data type and specifying your desired group as its value. Wrap this value with the topeople() function.

getdistinctusers() will only return the first 10,000 users.

getdistinctusers() cannot be used to define a column of process report data or in a process event.

Using this function in a process model with autoscale enabled may result in degraded site or application performance. It should be used with caution and tested thoroughly before deploying it for real-world use. When the application is in production, use the Autoscaled Process Activity tab to monitor how the process performs at scale.

Examples

You can copy and paste these examples into the Expression Rule Designer to see how this works.

Using it in a script task:

getdistinctusers(topeople( cons!group )) when stored as pv!multipleuser returns "user.name1", "user.name2", ...

Feature compatibility

The table below lists this function's compatibility with various features in Appian.

Feature	Compatibility	Note
Portals	Partially compatible	Can be used with Appian Portals if it is connected using an integration and web API.
Offline Mobile	Partially compatible	Can be used with offline mobile if it is loaded at the top of the form.
Sync-Time Custom Record Fields	Incompatible
Real-Time Custom Record Fields	Incompatible	Custom record fields that evaluate in real time must be configured using one or more Custom Field functions.
Process Reports	Compatible
Process Events	Compatible
Process Autoscaling	Partially compatible	Using this function in a process model with autoscale enabled may result in degraded site or application performance.

Feedback