Use Configuration Wizard

To configure the basic settings for JIRA in OTRS, a configuration wizard is available. Do the following as OTRS administrator:

1. In the OTRS dashboard, select the Admin tab.
2. In the Admin tab, select JIRA in the "System Administration" section.
   
   The "JIRA core settings (1)" dialog of the configuration wizard is displayed.
   

3. In the "JIRA core settings (1)" dialog, you configure the basic connection settings.

   Parameter	Description
   JIRA URL	Enter the JIRA base URL.
   API Path	Enter the path of the REST API.
   User	Enter the name of the JIRA user being used for system login. You have to create this user and assign him the project administrator role in JIRA. He must have the "Create Issue" and "Assignable User" permission. This user must also be specified in the "Special User" parameter in the add-on configuration on your JIRA server.
   Password	Enter the password of the JIRA user being used for system login.
   Incoming User	Enter the name of the OTRS user the JIRA add-on uses for authentication at OTRS. You have to create this user on the OTRS server. He must have the "Create Issue" and "Assignable User" permission. This parameter is required for breaking update loops.

   Click Next to continue.
   The "Issue settings (2)" dialog is displayed.
   

   In the "Issue settings (2)" dialog, you can configure the settings for the JIRA issues to be created.

   Parameter	Description
   Project	Enter a JIRA project where new newly created issues will be located.
   Issue Type	Enter a JIRA issue type being used for automated issue creation.
   Reporter	Enter the name of the JIRA user who will become the issue reporter when creating JIRA issues from OTRS tickets automatically.
   Custom field OTRSTicketID	Enter the name of the JIRA custom field that is used to store the OTRS ticket ID. The name has to be selected in the "Customfield With OTRS Ticket ID" in the "Special Field" section in the JIRA add-on configuration dialog.
   Do not set Assignee	Enable if you do not want to send the assignee to JIRA.
   Assignee	Enter the name of the JIRA user who will become the first issue assignee.
   Use Dialog	Activate this option to display a dialog, when an issue is about to be created. In this dialog, you can edit project, assignee, "automatic" user and issue type.
   Show Assignee (dialog)	Select if you want to display the "Assignee" field. Available options are: Editable Hide Readonly
   Show "Automatic" user (dialog)	Activate to display the "Automatic" user option for assignee.
   Show Issue Type (dialog)	Select if you want to display the "Issue Type" field. Available options are: Editable Hide Readonly
   Show Project (dialog)	Select if you want to display the "Project" field. Available options are: Editable Hide Readonly

   If you set "Use Dialog" to Yes, four more options are added to the dialog.
   

   Parameter	Description
   Show Assignee (dialog)	Select if you want to display the "Assignee" field. Available options are: Editable Hide Readonly
   Show "Automatic" user (dialog)	Activate to display the "Automatic" user option for assignee.
   Show Issue Type (dialog)	Select if you want to display the "Issue Type" field. Available options are: Editable Hide Readonly
   Show Project (dialog)	Select if you want to display the "Project" field. Available options are: Editable Hide Readonly

   Click Next to continue.
   The "Fieldmapping (3)" dialog is displayed.
   

4. In the "Fieldmapping (3)" dialog, you can map your OTRS fields to JIRA fields.
   Select the OTRS ticket fields and JIRA fields you want to map.
   Click Next to continue.
   The "Configuration done ()" dialog is displayed.
   
5. Click Go to Admin area.