View this page in the latest version of Appian. a!groupsByName() Function Share Share via LinkedIn Reddit Email Copy Link Print On This Page Function a!groupsByName( groupName ) Returns an array of groups with the given name, or an empty array if no group exists. See also: group(): Parameters Keyword Type Description groupName Text The case-insensitive name of the group to retrieve. Returns Group Array Usage considerations If there are multiple groups that have the same name, a!groupsByName() will return all of the groups, sorted by id, ascending. a!groupsByName() always returns an array. 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, an empty array will be returned. See also: Group Visibility System groups cannot be retrieved using a!groupsByName(). a!groupsByName() 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 there is one group named Case Viewers - 123 with id 7, a!groupsByName("Case Viewers - 123") returns {[Group:7]} Given there are no groups named Group Does Not Exist, a!groupsByName("Group Does Not Exist") returns {} 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 Sync-Time Custom Record Fields Incompatible Real-Time Custom Record Fields 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. Feedback Was this page helpful? SHARE FEEDBACK Loading...