Generelles

Dynamische Felder

Bei der Installation des Plugins wird automatisch ein Dynamisches Feld (am Ticket) für die JIRA Issue ID angelegt. Der Name dieses Feldes ('JIRAIssueID') wird auch für die Konfiguration des JIRA Plugins benötigt. Damit das Feld auch angezeigt wird muss es noch im OTRS Konfigurations-Bereich (z.B. 'Frontend::Agent::Ticket::ViewZoom') eingetragen werden. Eventuell muss auch noch der Link zum JIRA Issue in den Einstellungen des Dynamischen Feldes an die URL des JIRA angepasst werden.

Weiter muss sicher gestellt werden, dass sämtliche Dynamischen Felder angelegt sind, welche im Mapping sowohl von OTRS als auch JIRA benutzt werden sollen.

Der Name JIRAIssueID wird ebenso für die Konfiguration des JIRA Add-ons verwendet. Um das Feld auf der Ansicht des OTRS Tickets einzuschalten, fügen Sie im SysConfig unter 'Frontend::Agent::Ticket::ViewZoom' einen Eintrag hinzu.

Stellen Sie des weiteren bitte sicher, dass Sie alle notwendigen Felder im OTRS angelegt haben, die Sie in das JIRA mappen möchten.

Create Issue Dialog

Um den Create Issue Dialog zu aktivieren in den SysConfig Bereich wechseln und dort in der Suche nach 'jira' suchen. Zum Unterpunkt Core wechseln:

Über die Option JIRA::ShowDialog wird der Dialog aktiviert.

Um die editierbaren Felder zu konfigurieren nach CreateIssue wechseln.

Hier können das JIRA Projekt, der Bearbeiter und der Vorgangstyp versteckt oder editierbar gemacht werden.

Sonstige Konfiguration

Für die weitere Konfiguration in den SysConfig Bereich wechseln und dort in der Suche nach 'jira' suchen. Zum Unterpunkt Core::REST wechseln:

Hier müssen die Verbindungsdaten des JIRAs eintragen werden:

• URL vom JIRA
• Pfad zur REST API
• Name des JIRA Benutzers mit dem sich OTRS einloggen soll (dieser sollte auch in der Konfiguration des JIRA-Plugins eingetragen sein)
• dessen Passwort

außerdem lassen sich u.a. noch folgende Einstellungen vornehmen:

• Name des Standard JIRA Autors/Reporters
• Name des Standard JIRA Bearbeiters/Assignee
• Name des OTRS Benutzers den das JIRA benutzt um sich anzumelden
  
  • Dies wird benötigt, um Schleifen zu verhindern

sowie:

• JIRA-Workflow-Übergang, der beim Schließen des JIRA-Issues verwendet wird, wenn das OTRS Ticket geschlossen wurde
  

• eine Liste von OTRS Status von welchen aus automatisch ein JIRA Issue angelegt wird

  Das setzen des Status beim Erzeugen des Tickets löst dieses Event nicht aus.

  • dies passiert automatisch wenn in einen dieser Status eskaliert wird oder
  • manuell mit Button wenn sich das Ticket bereits in einem dieser Status befindet oder direkt in einem angelegt wird
• eine Liste von OTRS Status von welchen aus automatisch ein JIRA Issue geschlossen wird
• eine Liste von OTRS Status von welchen aus automatisch ein JIRA Issue aktualisiert wird
• das JIRA Projekt in dem standardmäßig neue Issues angelegt werden
• der Default Issue Type

und schließlich:

• das Datums und das Datums/Zeit-Format (hier ist normalerweise keine Änderung nötig)
• das Feld-Mapping (Felder die vom OTRS in JIRA übertragen werden)
  • es kann von Standardfeldern, Dynamic Fields und Functions im OTRS auf Standardfelder und Custom Fields im JIRA gemappt werden
  • Für komplexerer Zuordnungen müssen Funktionen seperat implementiert werden, ein Beispiel ist im Downloads Bereich zu finden
  • es muss beachtet werden, dass die Feldtypen im OTRS und im JIRA übereinstimmen
  • bei Optionsfeldern werden die Keys (nicht die Values) übertragen, diese müssen so auch im JIRA vorhanden sein
  • sollen Datumsfelder übertragen werden, so muss der JIRA Benutzer mit dem sich das OTRS anmeldet eine Englische Spracheinstellung haben
  • Sie können u.a. das Zielprojekt, den Vorgangstyp und den Bearbeiter selbst bestimmen, indem Sie diese auf der rechten Seite entsprechend angeben
  • Beispiele für die rechte / JIRA Seite:
    • std:summary
    • std:description
    • std:project:key oder std:project:id
    • std:issuetype:name oder std:issuetype:id
    • std:priority:name oder std:priority:id
    • std:reporter:name
    • std:assignee:name
    • cust:IhrCustomFieldName

TicketNumber
Title
TicketID
State
StateID
StateType
Priority
PriorityID
Lock
LockID
Queue
QueueID
CustomerID
CustomerUserID
Owner
OwnerID
Type
TypeID
SLA
SLAID
Service
ServiceID
Responsible
ResponsibleID
Age
Created
CreateTimeUnix
CreateBy
Changed
ChangeBy
ArchiveFlag

Für OTRS 4 muss die Customfield ID des 'OTRSTicketID' Feldes gesetzt werden.

Angegeben werden kann ebenfall die Time to live für den Cache und ob der Hostname für SSL-Verbindungen überprüft werden soll.

Am unteren Ende des Dialogs können Sie white-listing oder black-listing für Projekt-Schlüssel mittels regulären Ausdrücke aktivieren. Bei White-listing werden im Drop-down Menü für Projekte im JIRA nur die Schlüssel angezeigt, die mindestens einen der angegebenen regulären Ausdrücke erfüllen. Beim Black-listing werden die Projekte, die einen der aufgeführten regulären Ausdrücke erfüllen, vom Menü ausgeschlossen.

Klicken Sie Update, wenn Sie die Konfiguration geändert haben.