Warum SIGNL4
Jira Software ist ein von Atlassian entwickeltes Produkt zur Fehler-Verfolgung. Jira bietet eine REST-API für Integrations-Möglichkeiten. Wenn man ein neues Problem in Jira erstellt, kann man konfigurieren, dass ein Alarm in dem entsprechenden mobilen SIGNL4-Team ausgelöst wird. Es wäre jedoch hilfreich, das Problem in Jira zu aktualisieren, wenn der Alarm in SIGNL4 bestätigt wurde. Genau für diesen Fall haben wir eine Zwei-Wege-Integrations-Lösung dafür entwickelt.
So funktioniert es
Es wird eine HTTP-Anfrage über benutzerdefinierte Bedingungen in der Jira-Software ausgelöst. Außerdem konfigurieren wir zusätzlich SIGNL4 so, dass es mit einem PHP-Skript interagiert und Ereignisse in Jira aktualisiert.
Integration
Szenarien
Integration von SIGNL4 mit Jira Software
Um Bestätigungsinformationen an Jira zurückzusenden, müssen wir die Jira-ID mit der ID von SIGNL4 abgleichen. So funktioniert es mit einem einfachen PHP-Skript.
PHP-Skript: https://github.com/signl4/signl4-integration-jira
Das PHP-Skript ist oben angehängt. Hier muss man die Jira-Anmeldeinformationen hinzufügen, um die REST-API nutzen zu können.
Hier könnt ihr entweder euren eigenen Webserver verwenden oder einen Dienst wie heroku.com ausprobieren.
Jira -> PHP-Skript
Wenn ein Jira-Problem erstellt wird, löst man einen WebHook aus, der an die URL gesendet wird, unter der die PHP-Skripte ausgeführt werden. Dies kann man einfach im WebHook-Bereich in den Jira-Einstellungen konfigurieren.
PHP -> SIGNL4
Nach Erhalt der Jira-Probleminformationen sendet das PHP-Skript eine HTTP-Anfrage an SIGNL4, um den Alarm auszulösen. Das PHP-Skript übergibt die Jira Issue ID (zusammen mit einigen Zusatzinformationen) an SIGNL4 im Feld External ID (X-S4-ExternalID). Diese wird als Referenz verwendet, um sie später wiederzufinden. Als Antwort erhält das PHP-Skript die Ereignis-ID des SIGNL4-Ereignisses.
SIGNL4 -> PHP
Im SIGNL4-Portal konfiguriert man den ausgehenden WebHook, der aufgerufen wird, wenn ein Benutzer einen Alarm in SIGNL4 bestätigt. Dies kann man unter Entwickler -> WebHooks tun.
Das PHP-Skript erhält die Bestätigungsanforderung, bei der die ursprüngliche externe ID SIGNL4 (X-S4-ExternalID) wieder enthalten ist. Es enthält die entsprechende Jira-Problem-ID und sendet dann den Aktualisierungs-Auftrag an Jira zurück.
PHP -> Jira
In Jira wird das Problem dann entsprechend aktualisiert.
Das obige Beispiel ist recht einfach und zusätzliche Funktionen wie der Abgleich von Benutzern, die Unterstützung von Anmerkungen usw. sind möglich.