Integration mit JIRA

Die Jira-Integration zeigt Jira-Aufgaben im Projektzeitplan von FlexiProject an. Jedes Projekt kann Aufgaben aus einem oder mehreren Jira-Projekten abrufen, und die Liste der abgerufenen Aufgaben wird nach Aufgabentypen oder mit einem JQL-Filter eingegrenzt. Jira-Aufgaben bleiben im Zeitplan mit Jira synchronisiert; ihre Felder sind schreibgeschützt.

Ein Administrator schaltet die Integration unter Systemeinstellungen > JIRA ein und konfiguriert sie dort (siehe Systemeinstellungen). Die Verknüpfung von Jira-Benutzern mit FlexiProject-Benutzern bewirkt, dass der Zeitplan und die Ressourcenauslastung die Eigentümer von Jira-Aufgaben anzeigen.

Verbindung zu Jira

Der Verbindungsschlüssel in Jira

Klicken Sie in Jira oben rechts auf den Avatar und wählen Sie Konto verwalten.
Wechseln Sie zur Registerkarte Sicherheit und klicken Sie im Abschnitt API-Token auf API-Token erstellen und verwalten.
Klicken Sie auf API-Token erstellen, geben Sie einen Namen ein (zum Beispiel „FlexiProject“) und klicken Sie auf Erstellen.
Kopieren Sie den erzeugten Schlüssel. Jira zeigt ihn nur einmal an.

Integration in FlexiProject einschalten

Öffnen Sie die Systemeinstellungen (Hauptmenü) und wechseln Sie zur Seite JIRA. Die Karte Integration mit JIRA erscheint.
Stellen Sie die Integration auf Aktiviert.
Geben Sie die Server-Adresse ein — die Adresse, unter der das Jira Ihrer Organisation geöffnet wird, zum Beispiel https://name.atlassian.net.
Geben Sie die Benutzer-E-Mail ein — dieselbe, mit der der Benutzer angemeldet ist, der den Schlüssel erzeugt hat.
Fügen Sie den kopierten Schlüssel in das Feld Schlüssel ein.
Klicken Sie auf Speichern. Bei korrekten Daten erscheint die Meldung Die Verbindung zum JIRA-Server ist korrekt, bei falschen Verbindung zum JIRA-Server fehlgeschlagen oder Falsche JIRA-Serveradresse.

Mit der Schaltfläche Prüfen Sie die Verbindung prüfen Sie den Verbindungsstatus jederzeit.

System settings, Jira tab with the server address, user e-mail and key fields and the Test connection button highlighted

Hinweis: Das Ausschalten der Integration mit Aus entfernt alle Verknüpfungen von Projekten mit Jira und alle Jira-Aufgaben aus den Zeitplänen. Das kann nicht rückgängig gemacht werden, und nach dem erneuten Einschalten müssen die Projekte erneut verknüpft werden.

Jira-Benutzer verknüpfen

Unter den Verbindungsparametern befindet sich die Tabelle Benutzer mit den Spalten Name von Jira, ID Jira und Benutzer (der verknüpfte FlexiProject-Benutzer). Ein Filter über der Tabelle grenzt die Liste ein. Bei aktiver Verbindung versucht FlexiProject laufend, Jira-Benutzer anhand der E-Mail-Adressen mit FlexiProject-Benutzern zu verknüpfen. Gibt Jira eine E-Mail-Adresse frei und existiert dieselbe Adresse in FlexiProject, erscheinen neben dem Jira-Namen Avatar und Name des verknüpften Benutzers. Ob Jira Adressen freigibt, hängt von den globalen Sicherheitseinstellungen und von den Datenschutzeinstellungen des Jira-Benutzers ab.

Jira tab with the Importing Jira users button and the Users table with Jira name, Jira Id and User columns highlighted

Automatisch erstellte Verknüpfungen aktualisieren sich selbst. Manuell hinzugefügte tun das nicht: Nach einer Änderung des Nachnamens oder der E-Mail-Adresse müssen Sie sie von Hand korrigieren.

Manuell verknüpfen

Fahren Sie mit der Maus über eine Zeile ohne verknüpften Benutzer und klicken Sie auf das Symbol mit den drei Punkten.
Wählen Sie Verbinden. Das Fenster Benutzer verknüpfen wird geöffnet.
Wählen Sie den FlexiProject-Benutzer aus und klicken Sie auf Speichern.

Verknüpfung entfernen

Fahren Sie mit der Maus über eine Zeile mit verknüpftem Benutzer und klicken Sie auf das Symbol mit den drei Punkten.
Wählen Sie Trennen. Die Frage Sind Sie sicher, dass Sie den Link entfernen möchten? erscheint.
Bestätigen Sie mit Speichern.

Liste der Jira-Benutzer importieren

Erzeugen Sie im Atlassian-Verwaltungsbereich (admin.atlassian.com) auf der Registerkarte der Benutzer mit dem Exportbefehl eine CSV-Datei mit den Benutzern. Die Datei muss die Felder User id, User name und email enthalten.
Klicken Sie unter der Tabellenüberschrift auf Einfuhren von Jira-Benutzern. Das Importfenster wird geöffnet.
Wählen Sie die Datei aus oder ziehen Sie sie in das Fenster und klicken Sie auf Speichern. Die Liste der Jira-Benutzer wird aktualisiert, und die gefundenen Verknüpfungen werden automatisch eingetragen.

Zeilen mit falschen Werten werden übersprungen, und die Anwendung listet sie nach dem Import auf; eine fehlerhafte Datei endet mit einer Meldung über ein falsches CSV-Format.

Jira-Aufgaben im Projektzeitplan

Ein Projekt mit Jira verknüpfen

Öffnen Sie das Projekt und die Registerkarte Zeitplan.
Klicken Sie auf Einstellungen und wählen Sie Verbindung zu JIRA (der Eintrag ist sichtbar, sobald die Integration eingeschaltet ist). Das Fenster Integration mit JIRA wird geöffnet.
Geben Sie den Projektschlüssel aus Jira ein. Um Aufgaben aus mehreren Jira-Projekten abzurufen, geben Sie die Schlüssel durch Kommas getrennt ein.
Klicken Sie auf Verbinden. Das Fenster Einfuhren aus JIRA wird geöffnet.
Wählen Sie im Teil Herunterladen von Daten aus, wie die Daten abgerufen werden: Art der Aufgaben (nur mit einem Jira-Projekt) oder JQL-Filter (siehe JQL-Filter).
Bei Aufgabentypen: Haken Sie die Aufgabentypen auf den Hierarchieebenen an (mindestens einen Typ — sonst erscheint die Meldung Mindestens eine Ebene muss markiert sein) und wählen Sie dann Speichern. Abhängigkeiten zwischen Aufgabentypen werden, wenn möglich, in eine Aufgabenhierarchie im Zeitplan umgewandelt.

Ist der Abruf erfolgreich, erscheinen die Jira-Aufgaben im Projekt, und neben dem Projektnamen erscheint ein Jira-Symbol; ein Klick darauf öffnet das Jira-Projekt in einem neuen Tab. Der Abruf kann fehlschlagen, zum Beispiel wenn der in der Verbindung angegebene Benutzer keine Berechtigungen hat oder die JQL einen Syntaxfehler enthält (Fehler in JQL-Abfrage). Die Anwendung zeigt dann eine Meldung an. Ein Schlüssel, der nicht existiert oder auf den Sie keinen Zugriff haben, endet mit der Meldung Falscher Projektschlüssel, Projekt existiert nicht oder Sie haben keinen Zugriff darauf.

Jira integration window of a project with the Project key field and the Link with Jira button highlighted

Abruf der Aufgaben ändern

Derselbe Befehl Verbindung zu JIRA öffnet bei einem bereits verknüpften Projekt das Fenster Einfuhren aus JIRA, in dem Sie die Aufgabentypen oder die JQL-Abfrage ändern.

Jira-Aufgaben aus einem Projekt entfernen

Öffnen Sie das Fenster Einfuhren aus JIRA mit dem Befehl Verbindung zu JIRA.
Klicken Sie auf Löschen und bestätigen Sie im Fenster Entfernung des JIRA-Links. Die Meldung weist darauf hin, dass das Löschen der Verknüpfung alle Verknüpfungen im Zeitplan löscht und nicht rückgängig zu machen ist.

Nach dem Löschen verschwinden die Jira-Aufgaben aus dem Zeitplan, und das Projekt ist nicht mehr als mit Jira verbunden gekennzeichnet.

JQL-Filter

Mit JQL (Jira Query Language) rufen Sie genau die Jira-Aufgaben in ein Projekt ab, die Sie brauchen, auch aus mehreren Jira-Projekten gleichzeitig.

Bereiten Sie in Jira einen Filter im Werkzeug Filter vor. Der JQL-Code ist sichtbar, wenn Sie die Filteransicht von der einfachen auf JQL umschalten.
Kopieren Sie den JQL-Code.
Wählen Sie in FlexiProject im Fenster Einfuhren aus JIRA den JQL-Filter und fügen Sie den Code in das Textfeld ein.
Klicken Sie auf Speichern.

Eine Abfrage mit einem Syntaxfehler wird mit der Meldung Fehler in JQL-Abfrage abgelehnt. Der Filter wirkt sich nur darauf aus, welche Aufgaben in den Zeitplan gelangen; bei jeder Synchronisierung verschwinden Aufgaben außerhalb des Filterergebnisses aus dem Zeitplan.

Jira-Aufgaben im Zeitplan

Jira-Aufgaben landen mit erhaltener Struktur am Ende des Zeitplans und tragen dort ein Jira-Symbol. Sie werden bei einer regelmäßigen Synchronisierung automatisch aktualisiert; die Felder, die aus Jira stammen — Name, Beschreibung, Fortschritt, Eigentümer und die Aufgabenhierarchie — sind schreibgeschützt. Den Fortschritt oder die Eigentümer einer solchen Aufgabe können Sie nicht ändern (die Anwendung meldet Es ist nicht möglich, den Status von Aufgaben zu ändern, die aus JIRA stammen und Es ist nicht möglich, die Eigentümer von Aufgaben zu ändern, die aus JIRA stammen), und solche Aufgaben werden beim Klonen eines Projekts nicht kopiert. Eine Jira-Aufgabe kann nicht übergeordnete Aufgabe von FlexiProject-Aufgaben sein. Aufgaben unter einer übergeordneten Jira-Aufgabe können Sie umordnen, und Jira-Sammelaufgaben mit ihren Teilaufgaben können in die Zeitplanstruktur eingefügt werden.

Bei einem verknüpften Projekt hat der Zeitplan drei zusätzliche Spalten: Jira-Kennung (ein Klick öffnet die Aufgabe in Jira in einem neuen Tab), Jira-Status und Jira-Typ. Der Fortschritt einer Aufgabe ergibt sich aus der Statuskategorie in Jira: zu erledigen — 0 %, in Bearbeitung — 50 %, erledigt — 100 %.

Der Eigentümer der Aufgabe ergibt sich aus der Benutzerverknüpfung (siehe Jira-Benutzer verknüpfen). Ist ein Jira-Benutzer mit einem FlexiProject-Benutzer verknüpft, zeigt der Zeitplan dessen Avatar und Namen, und der Benutzer wird dem Projekt hinzugefügt. Ohne Verknüpfung sehen Sie ein graues Avatar-Symbol mit dem Jira-Namen. Der Zeitplan wird unter Projektzeitplan beschrieben.