Free cookie consent management tool by TermsFeed a!groupsByType() Function
a!groupsByType() Function

Function

a!groupsByType( groupType, pagingInfo )

Returns a DataSubset of the groups of a given group type.

See also:

Parameters

Keyword Type Description

groupType

Group Type

The group type of the groups to be retrieved.

pagingInfo

PagingInfo

The paging and sorting configurations to apply when retrieving the groups. The minimum batchSize is 0 and the maximum is 10,000. If none is provided, a default batchSize of 1,000 will be used.

Returns

DataSubset

Usage considerations

The groupType value should be given as a constant of type Group Type.

By default, the DataSubset is sorted by groupName, ascending. If there are multiple groups with the same groupName, a secondary sort is applied on id, ascending.

Designers can choose to sort on any of the following group attributes:

  • created
  • creator
  • description
  • groupName
  • groupTypeName
  • id
  • lastModified
  • memberPolicyName
  • parentId
  • parentName
  • securityMapName
  • viewingPolicyName

If the user running the expression does not have permission to see a group, that group will not be returned in the result. If the user does not have permission to see any of the groups, the DataSubset returned will have an empty data value. See also: Group Visibility

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

Examples

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

Given a rule input ri!groupType of type Group Type with the following groups of this type: {[Group:7],[Group:8],[Group:9],[Group:10],[Group:11]}

Return Maximum Batch Size

a!groupsByType(groupType: ri!groupType) returns

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
DataSubset
  startIndex: 1
  batchSize: 1000 
  sort: List of SortInfo
    SortInfo
      field: "groupName" 
      ascending: true 
  totalCount: 5
  data: List of Group
    7 - Group A (Group)
    8 - Group B (Group)
    9 - Group C (Group)
    10 - Group D (Group)
    11 - Group E (Group)
  identifiers: List of Group
    7 - Group A (Group)
    8 - Group B (Group)
    9 - Group C (Group)
    10 - Group D (Group)
    11 - Group E (Group)

Return Batch Size of Two

1
2
3
4
5
6
7
a!groupsByType(
  groupType: ri!groupType, 
  pagingInfo: a!pagingInfo(
    startIndex: 1, 
    batchSize: 2
  )
)

returns

1
2
3
4
5
6
7
8
9
10
11
12
13
14
DataSubset
  startIndex: 1 
  batchSize: 2 
  sort: List of SortInfo
    SortInfo
      field: "groupName"
      ascending: true 
  totalCount: 5
  data: List of Group
    7 - Group A (Group)
    8 - Group B (Group)
  identifiers:List of Group
    7 - Group A (Group)
    8 - Group B (Group)

Only Return Data

1
2
3
4
5
6
7
a!groupsByType(
  groupType: ri!groupType, 
  pagingInfo: a!pagingInfo(
    startIndex: 1, 
    batchSize: 2
  )
).data

returns

1
2
3
List of Group
  7 - Group A (Group)
  8 - Group B (Group)

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 Compatible
Custom Record Field Expressions Incompatible
Process Reports Incompatible

You cannot use this function to configure a process report.

Process Events Incompatible

You cannot use this function to configure a process event node, such as a start event or timer event.

Open in Github Built: Fri, Feb 23, 2024 (09:12:49 PM)

a!groupsByType() Function

FEEDBACK