Bitte stellen Sie sicher, dass alle Themen der Checkliste bearbeitet wurden, bevor Sie mit der Synchronisierung beginnen. Administrativer Zugriff auf aqua und Jira wird für das initiale Setup benötigt.
Lizenzen
Sie erhalten eine spezielle Jira Sync Lizenz. Wenn Sie keine spezielle Lizenz besitzen, kontaktieren Sie bitte den aqua-Support (aqua-support@andagon.com).
SyncConfigurator
Bevor Sie mit der synchronisierung beginnen können, benötigen Sie den SyncConfigurator. Dieser kann auf der
Server Landingpage heruntergeladen werden. Sie können sich mit jedem aqua User einloggen, wir empfehlen allerdings einen Administrator-User zu verwenden.
Sync User (aqua)
Separater aqua User, welcher ausschließlich für die Synchronisierung verwendet wird, mit den folgenden Spezifikationen:
-
Spezielle Jira sync Lizenz muss zugewiesen sein
-
Spezielle Email Adresse sollte verwendet werden. Alle SyncErrors werden zu dieser Mail gesendet. Bitte überwachen Sie diese Adresse entsprechend.
-
Deaktivieren Sie Emailbenachrichtigungen aus aqua für diesen User. Weitere Informationen dazu finden Sie
hier. Möglicherweise müssen Sie dazu zwischenzeitig eine andere Lizenz zuweisen.
-
Der Sync User muss die Rolle '
Project Administrator' in dem zu synchronisierenden aqua Projekt haben.
Konfigurations-User (Jira)
Für die Konfiguration des Jira Syncs wird ein spezieller Jira User benötigt. Dieser User benötigt die folgenden Spezifikationen:
-
Separater Jira User, welcher ausschließlich für die Synchronisierung verwendet wird
-
Der User muss ein Jira Administrationsnutzer sein. Er muss in der folgenden Gruppe sein: jira-administrators
-
Nutzen Sie die gleiche Email Adresse, wie für den aqua Sync User
-
Wählen Sie in den Benutzer-Profilpräferenzen für den User die gleiche Zeitzone aus wie die Zeitzone von Ihrem aqua Server (also z.B. Berlin(GMT+1) bei Servern in Deutschland)
-
Deaktivieren Sie Emailbenachrichtigungen für diesen User
-
Deaktivieren Sie "automatic watching" in Jira
-
Wählen Sie English (US) als Spracheinstellung für den User
Außerdem muss die E-Mailadresse anstatt dem Usernamen verwendet werden.
Sync User (Jira) -optional-
Sie können einen separaten Jira User nutzen, der die Synchronisierung übernimmt. Dieser User benötigt weniger Berechtigungen als der Konfigurations-User. Dieser User ist optional, Sie können auch den Konfigurations-User als Sync User verwenden. Der User sollte dieselben Spezifikationen erfüllen, wie der Konfigurations-User, außer der Berechtigungen (Beachten Sie auch die Besonderheiten für Jira Cloud). Die folgenden Berechtigungen werden benötigt:
Verbindung zum Jira System
Um eine Verbindung zwischen Jira und aqua herzustellen, beachten Sie bitte die folgenden Punkte:
-
Definieren Sie Port 443 explizit, falls HTTPS verwendet wird
-
Beachten Sie Groß- & Kleinschreibung bei der URL
-
Die Verwendung eines selbstsignierten Zertifikates erfordert zusätzliche Schritte, welche
hier beschrieben sind
-
Jira Coud: Nutzen Sie den Usernamen, nicht die Emailadresse des Jira Users
-
Denken Sie darüber nach, Captchas zu deaktivieren
Verknüpfen von Usern
Während der Synchronisierung werden User verknüpft, beispielsweise für das Feld "Zugewiesen an". Deshalb müssen die folgenden Einstellungen für die User vorgenommen werden:
-
Alle Jira User, die in synchronisierten Elementen verwendet werden können, müssen in aqua mit der
gleichen Email Adresse angelegt sein
-
aqua User können über Skripte angelegt werden:
-
-
-
Die aqua User müssen den zu synchronisiernenden Projekten zugewiesen sein. Die Rolle '
Project assignment' reicht aus
Bitte beachten Sie, dass User mit leeren Email Adressen zu Sync Fehlern führen können.
Wir bieten eine AD/LDAP Synchronisierung für aqua User an. Weitere Informationen dazu finden Sie
hier. Wir unterstützen gerne auf individueller Basis, wenn Sie kein AD/LDAP nutzen und Ihre Jira User automatisiert nach aqua übertragen möchten.
Verknüpfen von Feldern
Es gibt erforderliche Felder, die in aqua angelegt werden müssen:
-
Jira ID und Jira Link (Typ:
Text)
* -
Resolution (Typ:
Aufzählung)
*Wir empfehlen diese Felder mit Schreibschutz zu konfigurieren. Bitte ändern Sie diese Felder niemals manuell.
Verknüpfen von Feldwerten
Für das Feld resolution müssen alle Werte verknüpft werden, inklusive NULL-Werte. Wir empfehlen, den Wert 'Unresolved' zum aqua Auswahlfeld für resolution hinzuzufügen.
