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.

Mit dem Teamworkx Issue Publisher for Jira ist es auch möglich, PDFs direkt am Jira-Issue zu erzeugen. Das geschieht über eine PDF-Export-Option, mit einem vorinstallierten Standard-Template.

Die erzeugten PDFs auf Basis von HTML-Templates, werden als Attachments an das Issue hochgeladen und können optional mit der Move-Attachment-Operation auf eine Confluence-Seite verschoben werden.

Funktionen

• Konfigurierbare Operationen, die manuell, automatisch durch Vorgangsevents oder über eine Post-Funktion ausgelöst werden können
• Erstellen und Aktualisieren von Confluence-Seiten und Blog-Einträgen
• Verschieben oder Kopieren von Attachments von einem Jira-Vorgang zur entsprechenden Confluence-Seite
• Senden von E-Mails oder Webanfragen von einem Vorgang aus
• Erstellen von PDF-Dateien oder textbasierten Dateien
• Frei gestaltbare Vorlagen direkt im Confluence
• Unterscheidung von Vorlagen für die Veröffentlichung einzelner oder mehrerer Vorgänge
• Confluence Makro, welches von Jira durch Feldwerte ersetzt wird
• Publizieren von Jira-Informationen in ein Custom-Field unter Verwendung eines Templates
• Ausgabe von Insight-Objekten auf Confluence-Seiten