Batch Selector
Used to select a Qubes batch.
Properties
| Property | Description |
| AutoCompleteMode | Defines how the selectors behave. There are two possible values: Start/Contains. |
| Container | Limits the list to batches in the specified container (possibility of entering a list), see Remarks. |
| Enabled | Boolean indicating whether or not the component is enabled. |
| CreatedBy | Limits the list to batches created by the filter value (MO). |
| ConsumedBy | Limits the list to batches consumed by the filter value (MO). |
| 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. |
| InStock | Boolean limiting the list to batches in stock. |
| Item | Limits the list to batches of the specified item (possibility of entering a list). |
| Peremption | Boolean limiting the list to consumable batches. |
| SelectorColumns | List of fields to display as columns in the selector table that opens when the user clicks on a selector's button. |
| State | Limits the list to batches with the specified state (possibility of entering a list). |
| TabIndex | Integer indicating the component's tab order (Qubes 5.6). |
| 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 |
| GPAOID | Batch GPAO identifier |
| STATE | Batch state |
| ITEM | Batch item GPAO identifier |
| CREATION | Batch creation date |
| RECEPTION | Batch receipt date |
| PEREMPTION | Batch expiration date |
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 Container allows to filter by batches present in a container, or a list of containers.
- In Qubes 9.0 only container IDs prefixed with 'cnt' are supported, GPAO identifiers are not supported
- In Qubes 10.0, GPAOID identifiers are supported and will take precedence, unless starting with a 'cnt' prefix (case sensitive). Additionally if the property is a list whose first element is 'recursive', then further elements will be considered as top level containers, and all their sub-containers (recursively) will be in the filter.
AutoCompleteMode's value is also used by the filter of the picker.