...
...
| Table of Contents |
|---|
Plugin installation
The OvGroupAutoAssigner Ovyka Group Auto Assigner for Jira plugin is provided as a JAR file.
To install the plugin, go to JIRA Add-ons administration, and select the Manage Add-ons page. On the page, click the Upload add-on button, select the OvGroupAutoAssigner Ovyka Group Auto Assigner for Jira JAR, and click OK.
Prerequisites
User groups
The OvGroupAutoAssigner Ovyka Group Auto Assigner for Jira plugin requires that users groups are available : these groups will be needed in the mapping mail domains => user groups.
...
For example, for a group dedicated to the Carrefour Apple customer, you could name the user group [C]CarrefourApple. This shows clearly that the group is a Customer group.
...
User groups must be created in Crowd, not in Jira (but the add-on will work also with groups created in Jira). To add a custom group, go to your crowd instance, click on the Groups menu, then on the Add group link. A popup will open, allowing you to define the customer group. The screenshot below shows this popup.
...
Then select the Direct Members tab. This screen will show no users for a newly created group (as shown in screenshot below).
To add users, click the Add users button. A popup will ope, allowing to search for users. Once you found some that you want to include in the group, check them and click the Add selected users button.
...
Once the user groups have been created and filled with users, you can synchronise the Crowd directory in Jira, and the new group will be copied into JIRA. The screenshot below shows JIRA User management administration page. On the right of the Crowd Server directory, click the Synchronise link.
Custom Field
The OvGroupAutoAssigner Ovyka Group Auto Assigner for Jira plugin requires that a custom field exists, to store the user group of issues.
The custom field must be of Group Picker type. It is possible to add the custom field to the View screen, but not necessary for the plugin to work.
...
Example custom field
Type : Group Picker
Title: Customer Group
Description: Choose the customer group for visibility of this issue. Do not edit if autocompleted by GroupAutoAssignerOvyka Group Auto Assigner for Jira
Permissions & Issue Security
Customers often have restricted permissions in the projects, often based on them being the ticket's Reporter. The Custom Field Group Picker's value (= customer group selected) must also be allowed to do the same things as the reporter on the ticket.
...
This is the general use case, but you might want to use the feature just for a read only permission.
Issue Security
For OvGroupAutoAssigner Ovyka Group Auto Assigner for Jira to be able to grant access to customer's issues to all members of the customer group, an issue security scheme must be configured in Jira. This tells JIRA that users belonging to this issue security configuration are allowed to access issues monitored by the issue security.
...
Plugin configuration
When the OvGroupAutoAssigner Ovyka Group Auto Assigner for Jira is installed, new links appear in the Add-ons administration, under the label OVGROUPAUTOASSIGNER left Ovyka Group Auto Assigner left menu, as shown below (you may have to reload the page if the plugin was just installed).
...
The customer domain mapping is the place where you can define to which group are assigned users with a same email domain. For example, you can configure that users with the carrefourthe apple.frcom email domain are assigned to the [C] CarrefourApple user group.
The list of configured mapping appear as shown in the screenshot below.
...
In the example above, all users with the ovyka.com email domain (for example frederic.esnault@ovyka.com) are automatically mapped to the Ovyka Team group.
...
| Warning |
|---|
This does NOT assign users with a matching domain to the configured group. |
...
It will only assign the group name to the custom field value in issues created by users with this email domain. See Context configuration for more on custom field configuration. |
To add a customer mapping, click the Add a mapping button. This will open a popup window in which you can configure your mapping, as shown in screenshot below. When you begin typing in the Customer's group field, JIRA will show you groups it found containing the text you entered. Continue typing to restrict the number of matching groups, until you find the desired group.
...