JIRA-Felder synchronisieren
JIRA-Issue-Felder müssen auf CodebeamerTracker-Felder zugeordnet werden.
Die folgenden JIRA-Issue-Felder werden entsprechend der Synchronisierungsrichtung immer implizit synchronisiert:
• Id
• Key
• Summary
• Description
Die Anhänge zu einem JIRA-Issue werden standardmäßig synchronisiert, können jedoch bei Bedarf geändert werden. Alle anderen JIRA-Issue-Felder müssen den Tracker-Feldern manuell zugeordnet werden.
Nur die Felder im Bildschirm Create Issue für das ausgewählte JIRA-Projekt und den Issue-Typ sind für die Synchronisierung verfügbar. Falls ein Feld fehlt, prüfen Sie die entsprechende Bildschirmkonfiguration Issue erstellen in JIRA. Die folgenden JIRA-Issue-Felder können nur in Codebeamer importiert werden.
• Creator
• Created
• Updated
JIRA legt diese Felder automatisch auf den aktuellen Benutzer und das aktuelle Datum fest, wenn das Issue erstellt oder aktualisiert wird. Diese Feldwerte können nicht anderweitig geändert werden.
Dieselben Einschränkungen gelten für das JIRA-Änderungsprotokoll. Codebeamer kann das JIRA-Änderungsprotokoll lesen und importieren, aber nicht seine eigene Änderungshistorie in JIRA schreiben oder exportieren.
Jedes Feld, das im Abschnitt Felder aufgeführt ist, kann wie folgt konfiguriert werden:
• Werte ignorieren – Ignorieren Sie den Wert für dieses Feld.
• Werte importieren – Importieren Sie die Werte aus JIRA inCodebeamer
• Werte exportieren – Exportieren Sie den Wert aus Codebeamer in JIRA.
• Werte synchronisieren – Synchronisieren Sie den Wert zwischen JIRA und Codebeamer bidirektional.
 | Werte aus JIRA-Feldern, die vom angegebenen Benutzer nicht bearbeitbar sind, können nur importiert werden. |
| | Werte aus Codebeamer Feldern, die nicht bearbeitbar sind. z.B. Felder mit berechneten Werten können nur exportiert werden. |
Pflichtfelder in JIRA sind mit einem Sternchen markiert.
Das Exportieren neuer Codebeamer Tracker-Einträge in JIRA, d.h. das Erstellen eines neuen JIRA-Issues, ohne die Zuordnung der Pflichtfelder zu Codebeamer Tracker-Feldern, das Exportieren/Synchronisieren des Codebeamer Feldwerts in JIRA, schlägt wahrscheinlich fehl, es sei denn, das JIRA-Feld hat einen Standardwert.
Der Feldwert-Synchronisierungsmodus ist nicht durch die aktuell ausgewählte Synchronisierung Richtung eingeschränkt. Dies liegt daran, dass die Konfiguration der Feldwert-Synchronisierung auch dann auf Exportieren oder Bidirektional geändert werden kann, wenn der aktuelle Feldwert Richtung Nur importieren lautet, oder umgekehrt. Auf diese Weise ist es nicht erforderlich, alle Feld-Synchronisierungsmodi jedes Mal anzupassen, wenn die Synchronisierungsrichtung geändert wird.
| | Felder werden nur synchronisiert, wenn der Feld-Synchronisierungsmodus in die tatsächliche Synchronisierungsrichtung zeigt, d.h. ein Import gefolgt von einem Export. |
Für JIRA-Auswahlfelder müssen außerdem die Auswahlwerte den Codebeamer ALM-Auswahloptionen zugeordnet werden. Fehlende Auswahloptionen können mit der Option Neu... aus der Dropdown-Liste erstellt werden.
Zum Beispiel:
Das folgende Bild zeigt die bidirektionale Zuordnung zwischen dem Feld Status in JIRA und dem Feld Statusin Codebeamer
Beachten Sie beim Erstellen neuer Codebeamer Statusoptionen Folgendes:
• Tracker-Felder können für jeden Status bestimmte Berechtigungen und zulässige Werte haben. Diese Felder lassen keine Werte und Berechtigungen für den neu hinzugefügten Status zu. Daher sind diese Felder für importierte Einträge mit diesem Status möglicherweise nicht sichtbar oder bearbeitbar.
• Wenn der Tracker-Workflow aktiv ist, führen keine Zustandsübergänge in oder aus dem neu hinzugefügten Status. Importierte Vorgänge mit diesem Status können im Workflow nicht fortgesetzt werden, es sei denn, der neue Status wird über neu definierte Zustandsübergänge verbunden.
Der JIRA-Connector ändert die vorhandenen Codebeamer Zustandsübergänge nicht, es sei denn, die folgenden Bedingungen sind erfüllt:
• Die Synchronisierungsrichtung ist Exportieren oder Synchronisieren.
• Das JIRA-Feld Status ist dem Codebeamer Feld Status zugeordnet.
• Die Codebeamer Status-Werte sind Exportiert oder mit JIRA Synchronisiert.
Die Workflows werden nur synchronisiert, indem der Codebeamer Workflow durch den JIRA-Workflow ersetzt wird, wenn eine der folgenden Bedingungen erfüllt ist:
• Der Benutzer hat die Berechtigung JIRA-Systemadministrator.
• der Benutzer die Workflows manuell synchronisiert.
Wenn mehrere JIRA-Auswahloptionen neuen Ziel-Auswahloptionen zugeordnet werden sollen, können neue Zieloptionen für alle erstellt werden, indem Sie auf das Abwärtspfeilsymbol neben dem JIRA-Auswahlfeld-Namen klicken:
Zu importierende und zu synchronisierende JIRA-Felder, die kein entsprechendes Gegenstück im Codebeamer Tracker haben, können basierend auf der JIRA-Felddefinition hinzugefügt werden. Klicken Sie auf Neu... in der Dropdown-Liste, um diese Aktion auszuführen.
Beispiel: Klicken Sie zur Erstellung eines neuen Tracker-Felds in Codebeamer für das JIRA-Feld Komponenten auf Neu... in der Dropdown-Liste für das Feld.
Sie können den Namen des JIRA-Felds für das neue Codebeamer Tracker-Feld akzeptieren oder einen anderen Namen eingeben:
Der Name muss in allen Tracker-Feldern eindeutig sein und nicht nur für das aktuelle Tracker-Feld. Wenn ein Namenskonflikt besteht, geben Sie einen anderen Namen ein.
Die folgenden Felder können nicht neuen benutzerdefinierten Feldern zugeordnet werden, sondern nur ihren vordefinierten Zielen:
• Creator
• Created
• Updated
• Sprint
• Roles
• Attachments
• Kommentare
• Worklog
• Change Log
JIRA Agile-Felder, wie Sprint und Epic Link, können synchronisiert werden.
Da es keine vordefinierten Codebeamer Epic-Referenzfelder gibt, muss daher ein neues Zielfeld für das JIRA-Feld Epic definiert werden.
• Wenn die Epic-Verknüpfung aktiviert ist, ist das Ziel-Tracker-Feld ein Referenzfeld für den importierten Epic-Vorgang.
• Wenn die Epic-Verknüpfung deaktiviert ist, verhält es sich wie ein Textfeld, das nur den Schlüssel des JIRA Epic enthält.
Das JIRA-Feld Sprints kann entweder ignoriert oder als Sprints importiert werden.
In Codebeamer:
• Sowohl das Feld Releases als auch das Feld Sprints sind Konfigurationsobjekte des Typs Releases im Tracker Releases, wobei
◦ Releases die Vorgänge der obersten Ebene sind und Sprints in der Regel Kinder von Releases oder anderen Sprints sind.
• Die Release- und Sprint-Planung ermöglicht das Zuweisen von Vorgängen zu Releases und Sprints mithilfe des vordefinierten Ziel-Referenzfelds Versionen. Diese Feldbeschriftung kann unterschiedlich sein, z.B. Releases.
In JIRA:
• Sowohl Versionen als auch Sprints sind unterschiedliche Entitäten und werden mit Issues über verschiedene Referenzfelder zugeordnet:
◦ Versionen werden mithilfe des Felds "Fix Versionen" mit Issues zugeordnet.
◦ Sprints werden mithilfe des Felds "Sprints" mit Issues zugeordnet.
• Sprints beziehen sich nicht auf Versionen.
In Codebeamer Release- und Sprint-Planung funktionieren mit importierten JIRA-Issues, wenn sowohl die JIRA-Versionen als auch die JIRA-Sprints in denselben Codebeamer Releases-Tracker importiert werden und beide mit Vorgängen zugeordnet sind, die dasselbe Zielversionsfeld verwenden.
Da es in JIRA keine Beziehung zwischen Sprints und Versionen gibt, werden Sprints als Vorgänge der obersten Ebene in Codebeamer importiert. Es gibt keine zusätzlichen Sprints-Felder im Ziel-Tracker Codebeamer. Sprints sind nur ein Alias für alle Vorgänge, die importierte JIRA-Sprints darstellen und die mit dem Tracker-Eintrag über das Zielversionen-Feld zugeordnet sind.
Wählen Sie unten in der Liste Felder, ob die Felder ignoriert, importiert, exportiert oder synchronisiert werden sollen.
Die Zuordnung Rollen dient in erster Linie der Synchronisierung von Feldern des Typs Rollen und der Sichtbarkeit von Kommentaren, die auf den Rollen basieren. Jira kann die Sichtbarkeit von Kommentaren auf eine einzelne Rolle oder Gruppe beschränken. Codebeamer kann die Sichtbarkeit von Kommentaren auf mehrere Rollen und Teilnehmer beschränken, indem Mitgliederfelder wie Einreichender, Zugewiesen zu und Besitzer verwendet werden. Die einzige übliche Beschränkung, die synchronisiert werden kann, ist eine einzelne Rolle.
| | Das Erstellen einer neuen Zielrolle erstellt nur einen entsprechenden Rollenstereotyp oder -wert im Zielprojekt Codebeamer, nicht jedoch eine tatsächliche Rolle. |
In JIRA ist die Größe von Anhängen für Issues begrenzt.
Beim Konfigurieren der Synchronisierung von Anhängen durch Exportieren aus JIRA muss der JIRA-Administrator die Größenbegrenzung für Issue-Anhänge prüfen oder anpassen.
| | Kommentare, Worklog und Änderungsprotokoll können nur synchronisiert werden, wenn Benutzer synchronisiert sind. |
Das Feld Worklog wird als Eintrag des Trackers Zeiterfassung innerhalb des Codebeamer Projekts importiert und als Feld Zeiterfassungen für Betreff unter den Referenzen des importierten Issues angezeigt.
Wenn das JIRA-Änderungsprotokoll als Feld Historie für das Issue Codebeamer importiert wird, werden nur zugeordnete Felder importiert, die sich auf Einträge Änderungsprotokoll beziehen. Einträge wie Projekt, Schlüssel, Workflow und Beschriftungen werden ignoriert.
JIRA Änderungsprotokoll-Einträge, die sich auf Kommentare, Anhänge, Issue-Links und Arbeitszeiterfassung beziehen und keine Entsprechung in Codebeamer haben oder anders bearbeitet und gespeichert werden.
Codebeamer kann das JIRA-Änderungsprotokoll nur lesen oder importieren. Codebeamer kann seine eigene Änderungshistorie nicht in JIRA schreiben und exportieren.
Dies wirkt sich auch auf den Export von Issues, Issue-Änderungen, Anhängen, Kommentaren und Worklog-Einträgen aus Codebeamer nach JIRA aus. Der Export wird vom JIRA-Benutzer ausgeführt, der in den JIRA-Synchronisierungs-Einstellungen angegeben ist. Alle exportierten Issues, Issue-Änderungen, Anhänge, Kommentare und Worklog-Einträge sind diesem Benutzer in JIRA zugeordnet, und nicht dem Benutzer, der das Issue, die Issue-Änderung, den Kommentar oder den Worklog-Eintrag ursprünglich in Codebeamer erstellt hat.