Use Auto Join Groups

Some features described on this page are yet to be released and are expected to be available in JEMH 3.4.0 and 4.0.10

Global Auto Join Groups

Global Auto Join Groups (AJG) are configured through the User section of the JEMH Profile at:

  • JEMH > Profile > User

Global AJGs are typically used to auto join newly created users to specified groups but can join existing users. Global AJGs will always be applied to valid targets during mail processing.

Configuration

Global Auto Join Group(s)

Auto Join Groups is a text field that defines a comma separated list of groups that should be auto joined.

Auto Join Group Condition

Defines which users should be Automatically joined to the specified groups. The options are:

On User Create: Only users that are newly created by JEMH will be added to the defined group(s).

All Jira Users: New and existing users will all automatically be added to defined group(s).

On Creation or for Users Without Groups: Newly created users, and any existing Jira users that currently have no group Membership.

Project Level Auto Join Groups

Project Level Auto Join Groups (AJG) are defined on a Project Mapping level as well as on Rule level for both ‘Script’ and ‘Domain’ rules. Configuration for Project Level AJGs can be found at:

  • Mapping Level: JEMH > Profile > Project Mapping > Issue > Groups > Auto Join Groups

  • Rule Level: JEMH > Profile > Project Mapping > Rule > Issue > Groups > Auto Join Groups

Project Level AJGs can inherit from Parent Project Mappings allowing a single configuration in the Default Project Mapping to be inherited by other Project Mappings in the Profile.

Leaving the configuration selection blank will allow inheritance. Chain of inheritance is:

Rule ← inherits from: Parent Project Mapping ← inherits from: Default Project Mapping

Configuration

Auto Join Groups

Auto Join Groups is a text field that defines a comma separated list of groups that should be auto joined.

Apply On

Defines when Groups should automatically be joined. The options are:

Issue Creation

Issue Comment/Update

Issue Creation and Issue Comment/Update

Audience

Defines which users should be Automatically joined to the specified groups. The options are:

Reporter: Only the Reporter be added to the defined group(s).

All Jira Users: All Jira users will be added to defined group(s).

All Jira Users Without Groups: Any existing Jira users that currently have no group Membership.

Include New Addressee Users

Defines whether or not Users created through JEMH in any of the Addressee headers (To/Cc/Bcc) should also be added to the defined group. Options are:

Include

Exclude

Note: If the newly created Jira User is in the Reporter role, they will always be added to the defined groups to ensure issue creation.

Known Limitations

New users and reporters are only joined to the Profile / Global auto join group?

Conflict with Global level Auto Join Groups when using ‘All Jira Users Without Groups

If Global level AJGs are used at the same time as Project Level AJGs and the Project Level configuration is using ‘All Jira Users Without Groups’, JEMH may only add the Global group to a valid user. This is due to the nature of Global AJGs which are applied to the Reporter (email sender) and New Users very early in email processing. As such, the Reporter and New users may be added to Global AJGs before Project Mapping has applied, and as such they already have a group when Auto Join Groups is applied, and will not be joined to any groups on a Project Mapping level (If the Audience condition is ‘All Jira Users Without Groups’).

We recommend using not using Global Auto Join groups if you also intend to use the Audience condition is ‘All Jira Users Without Groups’. Groups joined on Global level could be moved to the Default project Mapping instead, which is inherited by other Project Mappings if no Project Specific AJGs are applied.