Settings

Select Settings in the "Teamworkx Connector" section in the app configuration.
The "Settings" dialog is displayed.

The dialog has the following sections:

General

In the "General" section, enter the following:

Escalation E-Mail: This setting is used to escalate problems to a specific email address.

Currently no functionality is implemented.
Top Menue: When this checkbox is checked and submitted you will get the Teamworkx Connector for Jira menu in your Jira top navigation bar.

This TWX Connector menu is only visible to Jira administrators.

Download Configuration as JSON

In this section you can download your current configuration of the Teamworkx Connector as JSON file. The download will contain the following information:

accounts
handler
eventMappings
operationSchemes
mappingEntries
valueMappings

View example ...

{    "accounts":[       {
         "accountId":"532D73AF-4770-4318-84D6-2F5DE87C85B6",
         "userKey":"admin",
         "description":"Add a customized description here",
         "status":"ACTIVE",
         "hostname":"<baseURL>",
         "port":"<port>",
         "contextPath":"/rest/cwx-sol-rest/latest/sol/",
         "username":"<username>",
         "password":"<password>",
         "gatewayUrl":"",
         "token":null,
         "headerParams":"cwx-sol-account:C958FC77-D1BC-4166-8B72-37333F48513D",
         "testPath":"/test/account"
      }
   ],
   "handler":[{
      "accountId" : "C958FC77-D1BC-4166-8B72-37333F85270D",
      "projectKey" : "DEV",
      "issueTypeId" : "10004",
      "eventPattern" : "ISSUEUPDATED",
      "eventTypeId" : "2",
      "activityPattern" : "CALLBACK",
      "data" : "{\"path\":\"/aob/event/form/JIRA_8.6.1_ISSUE_UPDATE\",\"method\":\"PUT\",\"body\":\"{\\\"form\\\": {\\\"identity\\\": \\\"EVENT\\\",\\\"type\\\": \\\"EXTERNAL_EVENT\\\",\\\"title\\\": \\\"Event form\\\",\\\"key\\\": \\\"/event/JIRA_8.6.1_ISSUE_UPDATE\\\",\\\"attributevalues\\\":      [{\\\"control\\\": \\\"required\\\",\\\"attribute\\\": \\\"MODE\\\",\\\"position\\\": \\\"0001\\\",\\\"type\\\": \\\"string\\\",\\\"title\\\": \\\"Mode\\\",\\\"value\\\": \\\"sync\\\"},{\\\"control\\\": \\\"required\\\",\\\"attribute\\\": \\\"OBJECTKEY\\\",\\\"position\\\": \\\"0002\\\",\\\"type\\\":      \\\"String\\\",\\\"title\\\": \\\"Remote Object Key\\\",\\\"value\\\": \\\"/issue/$issueKey$\\\"}]}}\"}",
      "customerRef" : "JIRA_8.6.1_ISSUE_UPDATE"
   }, {
      "accountId" : "C958FC77-D1BC-4166-8B72-37333F85270D",
      "projectKey" : "DEV",
      "issueTypeId" : "10004",
      "eventPattern" : "ISSUECREATED",
      "eventTypeId" : "1",
      "activityPattern" : "CALLBACK",
      "data" : "{\"path\":\"/aob/event/form/JIRA_8.6.1_ISSUE_CREATE\",\"method\":\"PUT\",\"body\":\"{\\\"form\\\": {\\\"identity\\\": \\\"EVENT\\\",\\\"type\\\": \\\"EXTERNAL_EVENT\\\",\\\"title\\\": \\\"Event form\\\",\\\"key\\\": \\\"/event/JIRA_8.6.1_ISSUE_CREATE\\\",\\\"attributevalues\\\":      [{\\\"control\\\": \\\"required\\\",\\\"attribute\\\": \\\"MODE\\\",\\\"position\\\": \\\"0001\\\",\\\"type\\\": \\\"string\\\",\\\"title\\\": \\\"Mode\\\",\\\"value\\\": \\\"sync\\\"},{\\\"control\\\": \\\"required\\\",\\\"attribute\\\": \\\"OBJECTKEY\\\",\\\"position\\\": \\\"0002\\\",\\\"type\\\":      \\\"String\\\",\\\"title\\\": \\\"Remote Object Key\\\",\\\"value\\\": \\\"/issue/$issueKey$\\\"}]}}\"}",
      "customerRef" : "JIRA_8.6.1_ISSUE_CREATE"
   } ],
   "eventMappings":[       {
         "accountId":"532D73AF-4770-4318-84D6-2F5DE87C85B6",
         "event":"JIRA_8.6.1_ISSUE_CREATE",
         "operationPattern":"CREATE_ISSUE",
         "solMappingId":1
      },
      {
         "accountId":"532D73AF-4770-4318-84D6-2F5DE87C85B6",
         "event":"JIRA_8.6.1_ISSUE_UPDATE",
         "operationPattern":"UPDATE_ISSUE",
         "solMappingId":2
      },
      {
         "accountId":"532D73AF-4770-4318-84D6-2F5DE87C85B6",
         "event":"JIRA_8.6.1_ISSUE_UPDATE",
         "operationPattern":"TRANSITION",
         "solMappingId":34
      }
   ],
   "operationSchemes":[       {
         "id":1,
         "name":"JIRA_8.6.1_ISSUE_CREATE_SCHEME",
         "description":"",
         "operationType":"CREATE_ISSUE"
      },
      {
         "id":2,
         "name":"JIRA_8.6.1_ISSUE_UPDATE_SCHEME",
         "description":null,
         "operationType":"UPDATE_ISSUE"
      },
      {
         "id":34,
         "name":"JIRA_8.6.1_ISSUE_UPDATE_SCHEME",
         "description":null,
         "operationType":"TRANSITION"
      }
   ],
   "mappingEntries":[       {
         "id":null,
         "solMappingId":1,
         "interfaceId":"description",
         "localId":"description",
         "solMappingType":"DIRECT",
         "info":null,
         "converter":null
      },
      {
         "id":null,
         "solMappingId":1,
         "interfaceId":"issueKey",
         "localId":"customfield_10900",
         "solMappingType":"DIRECT",
         "info":null,
         "converter":null
      },
      {
         "id":null,
         "solMappingId":2,
         "interfaceId":"issueKey",
         "localId":"customfield_10900",
         "solMappingType":"IDENTIFY",
         "info":null,
         "converter":null
      },
      {
         "id":null,
         "solMappingId":1,
         "interfaceId":"issuetype",
         "localId":"issuetype",
         "solMappingType":"MAPPED",
         "info":null,
         "converter":null
      },
      {
         "id":null,
         "solMappingId":2,
         "interfaceId":"labels",
         "localId":"labels",
         "solMappingType":"DIRECT",
         "info":null,
         "converter":null
      },
      {
         "id":null,
         "solMappingId":2,
         "interfaceId":"priority",
         "localId":"priority",
         "solMappingType":"DIRECT",
         "info":null,
         "converter":null
      },
      {
         "id":null,
         "solMappingId":1,
         "interfaceId":"projectKey",
         "localId":"projectKey",
         "solMappingType":"MAPPED",
         "info":null,
         "converter":null
      },
      {
         "id":null,
         "solMappingId":34,
         "interfaceId":"status",
         "localId":"wf_transition",
         "solMappingType":"MAPPED",
         "info":null,
         "converter":null
      },
      {
         "id":null,
         "solMappingId":2,
         "interfaceId":"summary",
         "localId":"summary",
         "solMappingType":"DIRECT",
         "info":null,
         "converter":null
      }
   ],
   "valueMappings":[       {
         "solMappingEntryId":6,
         "application":"REMOTE",
         "field":"issuetype",
         "sourceValue":"10004",
         "targetValue":"10302"
      },
      {
         "solMappingEntryId":12,
         "application":"REMOTE",
         "field":"projectKey",
         "sourceValue":"DEV",
         "targetValue":"PROD"
      },
      {
         "solMappingEntryId":70,
         "application":"REMOTE",
         "field":"status",
         "sourceValue":"1",
         "targetValue":"31"
      }
   ]
}

Configuration Upload

You can upload your Teamworkx Connector configuration from JSON file. During Upload you are able to configure:

Import Account Options
- Delete all existing accounts before import. (This will automatically delete all event handlers too. An event handler needs an account at any time.)
- Add all non existing accounts. (New accounts found in the JSON file will be added. Matching the account ID.)
- Update existing accounts. (Updates the account matching the account ID.)

Import Event Handlers Options
- Delete all existing event handlers before import.
- Add all non existing event handlers. (New event handlers found in the JSON file will be added. Matching the account ID and customer reference.)
- Update existing event handlers. (Updates the event handlers matching the account ID and customer reference.)

Import Operation Data
- Replace all existing operation data with data from file. This includes: Operation Schemes, Event Mappings, Mapping Entries, Value Mappings. (Making a backup before is recommended.)

After the import is finished, you can check the Import Log for a summary about the changes that took place.

Outgoing Queue

This queue contains all pending outgoing-events. The handling of events is executed once a minute.

If you want to delete an event, simply press the Delete action before the event is handled.

Incoming Queue

This queue contains all pending incoming-events. The handling of events is executed once a minute.

If you want to delete an event, simply press the Delete action before the event is handled.