Teamworkx Issue Publisher for Jira

Viele Firmen nutzen bereits – als Ergänzung zu ihrer Jira-Applikation – Confluence für die Dokumentation. Wenn Atlassian von “Integration beider Systeme” spricht, dann ist in erster Linie gemeint, dass in Confluence Anforderungsdefinitionen und Produktspezifikationen gepflegt werden. An entsprechender Stelle sind dabei Links auf zugehörige Jira-Vorgänge eingefügt. In der Gegenrichtung besteht nur die Möglichkeit, von einem Jira-Vorgang auf eine bestehende Confluence-Seite zu verlinken.

Mit dem Teamworkx Issue Publisher stellt catworkx eine App bereit, über das die Erstellung oder Aktualisierung einer Confluence-Seite aus einer Jira-Applikation heraus angestoßen wird. Drei Möglichkeiten des Publizierens werden dabei unterstützt:

• Automatisiert über eine Post-Function während eines Status-Überganges
• Automatisiert bei Vorgangsevents, z.B. nach dem Aktualisieren eines Vorgangs
• Manuell per “Publish Issue”-Operation im “Mehr”-Menü der Vorgangsansicht

Das Aussehen der Confluence-Seiten wird vorab über die Erstellung von Vorlageseiten im Confluence festgelegt. Für die Formatierung einer Seite stehen alle Möglichkeiten, die Confluence bietet, zur Verfügung. An den Stellen, an denen später Vorgangsdaten ausgegeben werden sollen, wird ein Platzhalter auf der Seite eingefügt. Steht beim Erstellen der Vorlage schon fest, dass die Zielseite nur einmal erstellt wird oder später bei einem Update komplett überschrieben wird, genügt eine Variable als Platzhalter. Steht jedoch fest, dass bei einem Update nur die Werte aus den Jira-Vorgängen aktualisiert werden sollen, so ist das mitgelieferte Jira Field Value Makro für Confluence als Platzhalter zu verwenden.

Die Vorlageseiten werden über die Vorlagenverwaltung des Teamworkx Issue Publishers importiert.

Bei der Ausführung über Workflowtransition oder Vorgangsaktion erstellt der Teamworkx Issue Publisher eine neue Confluence-Seite oder eine neue Seitenversion. In der Vorlage eingefügte Platzhalter werden dabei durch die tatsächlichen Feldwerte des Vorgangs ersetzt. Über die Seiten-Versionierung in Confluence kann jederzeit auf ältere Dokumentation zurückgegriffen und sich so über die Entwicklung der Vorgänge informiert werden.