User Selector by Site/Service/Function
Used to select a Qubes user, filtered by site, service and/or function.
Properties
| Property | Description |
| AutoCompleteMode | Defines how the selectors behave. There are two possible values: Start / Contains. |
| Enabled | Boolean indicating whether or not the component is enabled. |
| Function | The users must have the specified function. To specify more than one: =List('function1','function2',...). |
| FormatDisplayValue | Macro string defining a display format for the text in the selector's text zone. Only the fields used to define display formats will be used to filter the elements in the selector list. |
| FormatSelectValue | Macro string defining a display format for an element in the selector list. These fields are not used to filter the elements in the selector list. |
| FormatResultValue | Macro string defining a format for the value returned by the selector. |
| Hint | Specifies the user hint string that will appear in the component's interactive help bubble. |
| SelectorColumns | List of fields to display as columns in the selector table that opens when the user clicks on a selector's button. |
| Service | The users must be part of the specified service. To specify more than one: =List('service1','service2',...). |
| Site | The users must be part of the specified site. To specify more than one: =List('site1','site2',...). |
| SubSite | Boolean indicating whether the user can be part of a sub-site of the Site property. |
| SubService | Boolean indicating whether the user can be part of a sub-service of the Service property. |
| TabIndex | Integer indicating the component's tab order (Qubes 5.6). |
| UserStatus | Display the users that have the status listed. List of strings which can be "ACTIVE", "SUSPENDED" or "CANCELED" (Qubes 11.0) |
| ValueInitial | Determines the component's initial value when the screen opens and each time it is reset (see Reset Button). |
| Visible | Boolean indicating whether or not the component will be visible. |
List of available fields
| Name | Description |
| ID | User identifier |
| LASTNAME | User last name |
| FIRSTNAME | User first name |
| LOGIN | User login |
Value
The component returns the value defined by the FormatResultValue property, if the selection is valid; if not, it will return an empty string.
Remarks
The list of users is limited to active Qubes users (before Qubes 11.0).
The Function, Site and Service filters can take Name or ID values.
If a list of sites is specified, services and functions must be in both sites.
If a list of services is specified, functions must be in both services.
Site and Service properties target main site and main service but also sites and services that are used by the user's functions. It is not possible to filter only on the main site and main service.
(Qubes 11.0) The optional "STATUS" column field can be displayed with SelectorColumns but not used with the other properties.