Checkliste vor dem Start

Bitte stellen Sie sicher, dass Sie die Themen auf dieser Checkliste erledigt haben, bevor Sie mit der Synchronisierung beginnen. Administrative Zugriffsrechte auf aqua und Jira sind für die Ersteinrichtung erforderlich.

Lizenzen

Sie erhalten eine spezielle Jira-Synchronisationslizenz. Wenn Sie keine spezielle Lizenz haben, kontaktieren Sie bitte den Aqua-Support ([e-mail])

SyncConfigurator

Bevor Sie mit der Synchronisierung beginnen können, benötigen Sie den Synchronisierungskonfigurator. Sie können ihn von der Startseite Ihres Servers herunterladen. Melden Sie sich mit einem beliebigen aqua-Benutzer an. Wir empfehlen die Verwendung eines Administrators.

Sync User (aqua)

Separater aqua-Benutzer nur für die Synchronisation, mit der folgenden Spezifikation:

• Eine spezielle Jira-Sync-Lizenz muss zugewiesen werden.

• Eine spezielle E-Mail-Adresse sollte verwendet werden. Alle Synchronisierungsfehler werden an diese Adresse gesendet. Bitte überwachen Sie diese Adresse entsprechend.

• Deaktivieren Sie E-Mail-Benachrichtigungen von aqua für diesen Benutzer. Möglicherweise müssen Sie dem Benutzer vorübergehend eine andere Lizenz zuweisen, um dies zu tun.

• Der Sync-Benutzer muss die Rolle 'Projektadministrator' für das synchronisierte aqua-Projekt haben.

Konfiguration Benutzer (Jira)

Für die Konfiguration der Jira-Synchronisierung benötigen Sie einen spezifischen Jira-Benutzer. Dieser Benutzer muss die folgenden Eigenschaften haben:

• Separater Jira-Benutzer, der nur für die Synchronisation verwendet wird

• Dieser Benutzer muss Projektadministrator in dem zu synchronisierenden Projekt sein.

• Verwenden Sie dieselbe E-Mail-Adresse wie für den Aqua Sync User.

• Wählen Sie in den Benutzereinstellungen dieselbe Zeitzone wie die Ihrer Aqua-Server (z.B. Berlin(GMT+1) für Server in Deutschland).

• Schalten Sie E-Mail-Benachrichtigungen für diesen Benutzer aus.

• Deaktivieren Sie das automatische Beobachten in JIRA.

• Wählen Sie Englisch (US) als Sprache.

Hinweis zur Verwendung von Jira Cloud: Ein separates Passwort, auch API-Token genannt, muss erstellt werden, damit sich der Jira-Benutzer über die REST-API für die Synchronisierung anmelden kann. Dies kann unter der folgenden URL konfiguriert werden: https://id.atlassian.com/manage-profile/security/api-tokens Des Weiteren muss die E-Mail-Adresse anstelle des Benutzernamens verwendet werden.

Sync user (Jira) -optional

Sie können einen spezifischen Benutzer in Jira verwenden, der die Synchronisation übernimmt. Dieser Benutzer benötigt weniger Berechtigungen als der Konfigurationsbenutzer. Dieser Benutzer ist optional, Sie können auch den Konfigurationsbenutzer als Synchronisationsbenutzer verwenden. Der Benutzer sollte die gleichen Eigenschaften wie der Konfigurationsbenutzer haben, außer den Berechtigungen. Die folgenden Berechtigungen sind für den Synchronisationsbenutzer erforderlich:

• Issues erstellen

• Issues bearbeiten

• Alle Kommentare löschen

• Alle Kommentare bearbeiten

• Alle Anhänge löschen

Verbindung zum Jira-System

Um eine Verbindung zwischen aqua und Jira herzustellen, müssen Sie Ihre Verbindung wie folgt überprüfen:

• Port 443 explizit definieren, wenn https verwendet wird

• URL ist case-sensitiv

• Ein selbstsigniertes Zertifikat für JIRA verwenden

• Verwenden Sie den Benutzernamen, nicht die E-Mail-Adresse, des Jira-Benutzers

• Denken Sie daran, Captchas zu deaktivieren

Mapping der Benutzer

Während der Synchronisierung werden Benutzer zugeordnet, z. B. für das Feld 'Zugewiesen an'. Daher müssen die folgenden Einstellungen für Ihre Benutzer vorgenommen werden:

• Alle Jira Benutzer, die in synchronisierten Elementen erscheinen, müssen in aqua mit derselben E-Mail-Adresse existieren.

• aqua Benutzer können mit Skripten erstellt werden.

• Die Rolle 'Projektzuweisung' ist ausreichend.

• Die aqua Nutzer müssen den synchronisierten Projekt(en) zugewiesen werden.

Bitte beachten Sie, dass Benutzer mit leeren E-Mail-Adressen zu Fehlern bei der Synchronisierung führen können. Wir bieten eine AD/LDAP-Synchronisierung für aqua-Benutzer an. Wir können Ihnen auch individuell weiterhelfen, wenn Sie kein AD/LDAP verwenden und Ihre Jira-Benutzer automatisch zu aqua hinzufügen möchten.

Mapping der Felder

Es gibt einige erforderliche Felder, die Sie in aqua erstellen müssen:

• Jira ID und Jira Link (Typ: String)*

• Resolution (Typ: Wörterbuch (Einfachauswahl))

*Wir empfehlen, diese Felder schreibgeschützt zu machen. Bitte ändern Sie diese Felder niemals manuell.

Mapping der Feldwerte

Für das Feld "Auflösung" müssen Sie sicherstellen, dass alle Werte erfasst werden, einschließlich Nullwerten. Wir empfehlen, dem Aqua-Wörterbuch für Auflösungen den Wert "Unresolved" hinzuzufügen.

Wenn Sie versuchen, Jira und Aqua aus einer anderen Zeitzone als der MEZ zu synchronisieren, folgen Sie bitte den Anweisungen im Abschnitt 'Zeitzonenkonfiguration'.

Konfiguration der Zeitzone

Jiras fehlende Unterstützung für Zeitzonen in JQL-Abfragen stellt eine Herausforderung bei der Synchronisierung dar. Es gibt jedoch eine Lösung: die Zeitzonen des Jira-Synchronisierungsbenutzers und des Aqua-Servers anzugleichen. Um dies einzurichten:

1. Klicken Sie auf das Setting-Symbol in Jira und wählen Sie dann.

1. Wählen Edit Settings.

1. Blättern Sie zum Abschnitt Zeitzone und wählen Sie die Zeitzone aus, die mit dem aqua-Server übereinstimmt.