FunctionCopy link to clipboard
getdistinctusers( peopleArray )
Retrieves users from a set of users and groups.
See also: topeople()
ParametersCopy link to clipboard
| Keyword | Type | Description |
|---|---|---|
|
|
User or Group Array |
The groups or users and groups that you want to convert to the User data type. |
ReturnsCopy link to clipboard
User Array
Usage considerationsCopy link to clipboard
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.
ExamplesCopy link to clipboard
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 compatibilityCopy link to clipboard
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 |