Use Auto Join Groups
- Finn Gale
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.