To configure the general settings of catWorkX OTRS Integration for JIRA, select Edit down to the "General Configuration" section in the catWorkX OTRS Integration for JIRA configuration dialog.

The "Edit Configuration" dialog with the following sections is displayed:

In this section, you configure the basic connection settings:

  • OTRS URL: The URL of the OTRS server, e.g. http://localhost/otrs.
  • : The URL of the OTRS server for the links in JIRA, e.g. https://yourcompany.com/otrs. Leave empty to use the above.
  • REST Web Service: Name of the REST web service. If empty the default GenericTicketConnectorREST will be used.

  • User Name: Specify the user name for updating tickets in OTRS.

    You have to create the user specified in this field on the OTRS server.

  • Password: Specify the password for updating tickets in OTRS.

 

In this section, you select the custom fields that store the issue and ticket IDs of an issue:

  • Customfield With OTRS Ticket ID: Select the custom field that is used to store the OTRS ticket ID. This custom field has to be created manually before.
  • Dynamicfield With JIRA Issue ID: Enter the name of the OTRS dynamic field where the JIRA issue ID is stored. This custom field is created automatically during the installation of the OTRS package on your OTRS system.

In this section, you configure, when an OTRS ticket is created or updated:

  • Comments Events: Select the events which should trigger the creation of an article on the OTRS side.
  • : Select the events which should trigger an update of the mapped fields on the OTRS side.
  • : Only issues from the selected projects will be handled by the listener. Leave empty to disable the filter and handle all issues.

  • : Specify one or more special JIRA user. When this user creates or changes an issue the OTRS ticket will not be updated. This should in particular include the JIRA user used by OTRS to update or create issues.

    You have to create the user entered here on the JIRA server.

In this section, you can do some OTRS Article configurations:

  • Comment Action With TimeUnit: Select to display an input field for TimeUnit in the "OTRS Comment" action.
    To allow JIRA users to enter their own TimeUnit values on the OTRS comment action, select this option. This will overwrite the default value.
  • TimeUnit Required: Select if the TimeUnit field is required for the "OTRS Comment" action.
    If "Comment Action With TimeUnit" is activated and "TimeUnit Required" is deactivated, the users can enter empty values which will still overwrite the default value.
  • : Prefix for the OTRS subject field, this will be added to all articles created by JIRA.

In this section, you configure the "Create OTRS Ticket" and "OTRS Comment" actions:

  • : Select the custom field where the OTRS queue is stored.
  • Customer Customfield: Select the custom field where the OTRS customer is stored.
  • Activated: Activate to make the "Create OTRS Ticket" action will be available in the "More" menu.
  • Read-only: Activate to set the customer and queue on the "Create OTRS Ticket" action to read-only.