đź‘·Admin Guide

Owned by Development Techanics
Last updated: Jul 17, 2024 by Development Techanics
5 min read

Dear user, thank you for using the User Magic for Jira app.
To use the app and all its features there are some neccessary and optional steps you should check.
Go to Manage Apps > User Magic for Jira > Configuration

Please remember, that you need to be a Jira Admin to access the App configurations.

App user (necessary)

The App user tab is there to define a user, who will be used as the one creating new users, as it is required to authorize the access towards the Create User API. This only has to be done once.

Please notice, that this user has to have the organisation admin role.

  1. As you open the grafik-20240530-143009.png tab on the grafik-20240530-142821.png page in “Manage your Apps“, the current user will automatically be selected as the app user.

  2. To authenticate yourself please create a new API token by clicking on grafik-20240530-142707.png, which will re-direct you to your personal security settings.

  3. Select grafik-20240530-142342.png and grafik-20240530-142736.png it to the clipboard.

  4. Switch back to the App User configuration tab and paste it into the grafik-20240530-142536.png field.

  5. To confirm just click grafik-20240530-142605.png.

Step-by-Step

grafik-20240717-134140.png
grafik-20240717-134201.png

Reset the App user

If you want to change the App user or want to remove the actual one, just click on grafik-20240530-143155.png and confirm your choice on the following pop-up.

Mapping

Simply select the custom fields (short text only) that will be used by the app on the issue view and click grafik-20240530-150207.png. This way everything you need is shown on the app UI!

Project Enablement (necessary)

Just click on grafik-20240530-151229.png / grafik-20240530-151247.png to en- or disable the app for a project. By default every project is disabled.
As you enabled the app for a project you can expand it and en- or disable the app for specific issue types. By default every issue type is enabled for the selected project.

Permissions (necessary)

To define the permissions for users or groups simply type in the user or group picker field and select one or more objects. By clicking Add permission, the new users or groups are granted permission.

Show App History Permissions

Users or groups with this permission are allowed to see the apps UI on the Issue View after the triggered action, so you can view its documentation as followed:

Invite User Functionality Permission

Users or groups with this permission are allowed to trigger the “Invite user” and “Assign groups” functionality on the apps Issue View as described in the User Guide.

Every user who has the app permission Invite User Functionality will also have the global permission to Browse users and groups for this use case.

Invite Users

 

 

 

 

This App was developed by Techanics. If you have any questions or feedback, feel free to visit our Jira Service Desk.

Â