a!groupBrowserFieldColumns( label, labelPosition, instructions, helpTooltip, rootGroup, pathValue, pathSaveInto, selectionValue, selectionSaveInto, readOnly, height, hideUsers, accessibilityText, showWhen )
Displays group membership structure in columns. Users can navigate through the structure and select a single group.
See also: Example Interfaces
Name | Keyword | Types | Description |
---|---|---|---|
Label |
|
Text |
Text to display as the field label. |
Label Position |
|
Text |
Determines where the label appears. Valid values:
|
Instructions |
|
Text |
Supplemental text about this field. |
Help Tooltip |
|
Text |
Displays a help icon with the specified text as a tooltip. The tooltip displays a maximum of 500 characters. The help icon does not show when the label position is |
Initial Group |
|
Group |
The direct members of the initial group are displayed in the first column. |
Navigation Path |
|
List of Group |
The path from the first column to the current navigation. |
Save Navigation To |
|
List of Save |
Variable or list of variables to update when a user clicks on a group. |
Selection Value |
|
Group |
This group is displayed as selected when it is present in the navigation path array. |
Save Selection To |
|
List of Save |
Variable or list of variables to update upon selection of a group. |
Read-only |
|
Boolean |
Determines whether selection is enabled. Default: false. |
Height |
|
Text |
Determines the height of the component. Valid values: |
Hide Users |
|
Boolean |
Determines whether users will be displayed. Default: false. |
Accessibility Text |
|
Text |
Additional text to be announced by screen readers. Used only for accessibility; produces no visible change. |
Visibility |
|
Boolean |
Determines whether the component is displayed on the interface. When set to false, the component is hidden and is not evaluated. Default: true. |
The user and group browser components create Miller-columns-style browsers that allow users to select a user or group while browsing through a group membership tree.
The three group membership browsing components are:
Similar to the user and group picker fields, these three components appear the same but differ in what they allow to be selected. Depending on whether users, groups, or users and groups should be selected, choose the group browser, user browser, or user and group browser, respectively. If the interface is only for browsing, use the group browser, as it is the only browser that can be configured to show only groups and not users.
To learn how to use these components, see the examples listed below:
Copy and paste an example into the INTERFACE DEFINITION in EXPRESSION MODE to see it displayed.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
a!localVariables(
local!initialGroup,
/* Reset the path value each time you change the initial group */
local!pathValue: a!refreshVariable(
value: {},
refreshOnVarChange: local!initialGroup
),
local!selectionValue,
local!hideUsers,
local!readOnly,
{
a!sectionLayout(
label:"Controls",
contents: a!columnsLayout(
columns: {
a!columnLayout(
contents: {
a!pickerFieldGroups(
label: "Initial Group",
maxSelections: 1,
value: local!initialGroup,
saveInto: local!initialGroup
)
}
),
a!columnLayout(
contents: {
a!checkboxField(
labelPosition: "COLLAPSED",
choiceLabels: {"Read-only"},
choiceValues: {true},
value: local!readOnly,
saveInto: local!readOnly
),
a!checkboxField(
labelPosition: "COLLAPSED",
choiceLabels: {"Hide Users"},
choiceValues: {true},
value: local!hideUsers,
saveInto: local!hideUsers
)
}
)
}
)
),
a!sectionLayout(
label:"Component",
contents: {
a!groupBrowserFieldColumns(
label: "Group Browser",
rootGroup: local!initialGroup,
pathValue: local!pathValue,
pathSaveInto: local!pathValue,
selectionValue: local!selectionValue,
selectionSaveInto: local!selectionValue,
readOnly: local!readOnly,
hideUsers: local!hideUsers
)
}
),
a!sectionLayout(
label: "Selection & Path",
contents: {
a!pickerFieldGroups(
label: "Navigation Path",
instructions: "Represents the current navigation from the rootGroup. Changing this could cause errors in the interface.",
value: local!pathValue,
saveInto: local!pathValue
),
a!pickerFieldGroups(
label: "Selected Group",
instructions: "The selected group only appears as selected if contained in the pathValue.",
value: local!selectionValue,
saveInto: local!selectionValue
)
}
)
}
)
Feature | Compatibility | Note |
---|---|---|
Portals | Incompatible | |
Offline Mobile | Incompatible | |
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 | Incompatible | Cannot be used to configure a process report. |
Process Events | Incompatible | Cannot be used to configure a process event node, such as a start event or timer event. |
The following patterns include usage of the Group Browser Component.
Group Browser Component