usersInGroups

Looking for the documentation on the newest versions of SIL Engine and the Simple Issue Language for Jira 8 for Server/Data Center? Click here !

The availability of the users personal data may be impacted by the recent changes by Atlassian in order to meet GDPR compliance. See the following for more information:

Availability

This routine is available starting with katl-commons 1.0.
This routine is available for Jira server and cloud deployment options.

Syntax

usersInGroups(groups)

Description

Returns a list of users common to all the specified groups.

Parameters

Parameter name	Type	Required	Description
groups	string[]	Yes	Array containing the groups names to retrieve the common users from.

Return type

string []

Returns a list with the usernames of the common users for all the specified groups.

The result of the routine is the intersection of the sets of users for each specified group, not the union.

Example

Example 1

//The following users belong to both groups jira-developers and jira-administrators: user1, user2
string[] groups = {"jira-developers", "jira-administrators"};
string[] usersByGroups;
usersByGroups = usersInGroups(groups);
print("The following users belong to both groups jira-administrators and jira-developers: ");
print(usersByGroups);

Result: The following users belong to both groups jira-administrators and jira-developers: user1|user2

Example 2: Union of groups

function getUsers(string [] groups){ 
  string [] users; 
  for(string group in groups){ 
    string [] currentGrp; 
    currentGrp = addElement(currentGrp, group); 
    for(string user in usersInGroups(currentGrp)){ 
      users = addElementIfNotExist(users, user); 
    } 
  } 
  return users;
} 


string [] groups = {"jira-developers", "jira-administrators"}; 
description = getUsers(groups);

This example uses the usersInGroups routine to get all users in each group individually and then adding them into a predefined array. So the usersInGroups routine will be called twice: once for jira-administrators and once for jira-developers. Since each time it will be called with a single group, it will return all users from the specified group.

Starting with katl-commons 2.5.7, the code above can be rewritten with the following code:

string [] developers = usersInGroups({"jira-developers"});
string [] administrators = usersInGroups({"jira-administrators"});
return arrayUnion(developers, administrators);

Simple Issue Language™