JIRA - First Steps - Versionsgeschichte

Jjarzembowski am 24. Oktober 2018 um 13:41 Uhr

2018-10-24T13:41:42Z

Jjarzembowski am 24. Oktober 2018 um 13:34 Uhr

2018-10-24T13:34:59Z

Jjarzembowski am 24. Oktober 2018 um 13:26 Uhr

2018-10-24T13:26:30Z

Jjarzembowski am 24. Oktober 2018 um 12:53 Uhr

2018-10-24T12:53:04Z

Jjarzembowski: /* Erstellen von 'Relevanz unklar' oder 'Zuordnung unklar' */

2018-09-26T09:35:14Z

‎Erstellen von 'Relevanz unklar' oder 'Zuordnung unklar'

Jjarzembowski: /* Erstellen von Reihen */

2018-09-26T09:34:00Z

‎Erstellen von Reihen

Jjarzembowski: /* Erstellen von Aufnahmen */

2018-09-26T09:33:30Z

‎Erstellen von Aufnahmen

Jjarzembowski: /* Erstellen von JIRA-Tickets */

2018-09-26T09:32:04Z

‎Erstellen von JIRA-Tickets

Jjarzembowski: /* Aufbau der Jira-Tickets */

2018-09-26T09:31:24Z

‎Aufbau der Jira-Tickets

Jjarzembowski: /* Erstellen von JIRA-Tickets */

2018-09-26T08:04:07Z

‎Erstellen von JIRA-Tickets

@@ Zeile 14: / Zeile 14: @@
 [[Datei:JIRA Ticket besser-klein.jpg]] <br>
 Hier sind  Titel des Filmwerks die BA-Filmwerk-ID, Die BA-Filmwerk-UUID, den Matching-Bearbeiter und das Matching-Datum und ein Beschreibungs-Feld enthalten, <br>
-in welchem die Matching-Kommentare  verzeichnet sind. Außerdem gibt  es eine Möglichkeit zum Eintragen von Stichworten. <br>
+in welchem die Matching-Kommentare  verzeichnet sind. Außerdem gibt  es eine Möglichkeit zum Eintragen von Labeln. <br>
-Diese dienen zur Markierung und Übersicht. Durch Klicken auf eines der Stichwörter lässt sich eine Übersicht aller Tickets mit eben diesem Stichwort aufrufen.
+Diese dienen zur Markierung und Übersicht. Durch Klicken auf eines der Stichwörter lässt sich eine Übersicht aller Tickets mit eben diesem Label aufrufen.
 Die Tickets können den verschiedenen Bearbeitern unter dem Menüpunkt „Zuweisen" mit "Mir zuweisen" bzw. "Zugewiesene Person“ zugeordnet werden. <br>
-Eine Beobachtung des Tickets ist ebenfalls möglich. Eine Löschung kann nur durch den Projektleiter vorgenommen  werden (siehe Stichwort “Löschen“). <br>
+Eine Beobachtung des Tickets ist ebenfalls möglich. Eine Löschung kann nur durch den Projektleiter vorgenommen  werden (siehe Label “Löschen“). <br>
 In der Sidebar lässt sich eine Übersicht über die eigenen bearbeiten, nicht bearbeiten und die allgemein noch offenen Vorgänge aufrufen.
@@ Zeile 36: / Zeile 36: @@
-Handelt es sich bei dem aufgerufenen Filmwerk um einen Archivtitel, oder lassen sich mehrere Filmwerke mit Tickets in JIRA einem neu angelegten Filmwerk in der ZDB zuordnen, so werden <b>Stichworte</b> verwendet, um die Tickets dadurch zu gruppieren und zu kennzeichnen. Diese werden im Ticket unter „Stichworte“ aus der Liste ausgewählt und dem Ticket zugefügt (siehe Stichwortliste JIRA).
+Handelt es sich bei dem aufgerufenen Filmwerk um einen Archivtitel, oder lassen sich mehrere Filmwerke mit Tickets in JIRA einem neu angelegten Filmwerk in der ZDB zuordnen, so werden <b>Labels</b> verwendet, um die Tickets dadurch zu gruppieren und zu kennzeichnen. Diese werden im Ticket unter „Label“ aus der Liste ausgewählt und dem Ticket zugefügt (siehe Labelliste JIRA).
 <br>
 == Erstellen von JIRA-Tickets==
@@ Zeile 95: / Zeile 95: @@
 Sollten sich technische Probleme ergeben, die es erfordern mit Detlev Balzer in Kontakt zu treten, so lässt sich dies ebenfalls über JIRA klären. Dazu wird das Projekt  „ZDB-Issues und Bugreporting“ aufgerufen, eine neue Aufgabe  unter „+ Erstellen“ hinzugefügt und dem entsprechenden Bearbeiter zugewiesen. Wenn diese in Arbeit / erledigt ist, taucht sie in der entsprechenden Spalte des Projektes auf.
-== JIRA-Stichworte==
+== JIRA-Labels==
-In einigen gesonderten Fällen ist es von Nöten, die JIRA-Tickets mit bestimmten Stichworten im Eingabefeld "Stichworte" zu kennzeichnen. Die verschiedenen Stichworte und ihre Verwendung findet man in der folgenden Liste: <br>
+In einigen gesonderten Fällen ist es von Nöten, die JIRA-Tickets mit bestimmten Labels im Eingabefeld "Labels" zu kennzeichnen. Die verschiedenen Labels und ihre Verwendung findet man in der folgenden Liste: <br>
 {| class="wikitable sortable mw-datatable" style="background-color:#FFFFFF"
 |-
-! Stichwort || Verwendung
+! Label || Verwendung
 |-
-|AVT || Wenn sich herausstellt, dass ein Filmwerk nur einen Archivtitel besitzt, dann wird dies in den JIRA-Stichworten vermerkt.
+|AVT || Wenn sich herausstellt, dass ein Filmwerk nur einen Archivtitel besitzt, dann wird dies in den JIRA-Labels vermerkt.
 |-
-|Regruppieren || Bei Filmwerken, denen mehrere, in JIRA verzeichnete BASYS3-Datensätze zugeordnet wurden, erhält die '''niedrigste''' BArch-BASYS3-ID das Stichwort "Regruppieren". <br> Das Ticket wird im weiteren Verlauf geöffnet und Michael Freiberg zur Bearbeitung zugewiesen.
+|Regruppieren || Bei Filmwerken, denen mehrere, in JIRA verzeichnete BASYS3-Datensätze zugeordnet wurden, erhält die '''niedrigste''' BArch-BASYS3-ID das Label "Regruppieren". <br> Das Ticket wird im weiteren Verlauf geöffnet und Michael Freiberg zur Bearbeitung zugewiesen.
 |-
-|Löschen|| Bei Filmwerken, denen mehrere, in JIRA verzeichnete BASYS3-Datensätze zugeordnet wurden, werden alle Filmwerke bis auf jenes mit der niedrigsten BArch-BASYS3-ID mit dem Stichwort "Löschen" versehen. <br> Im weiteren Verlauf wird das Ticket geöffnet und Michael Freiberg zur Bearbeitung zugeordnet.
+|Löschen|| Bei Filmwerken, denen mehrere, in JIRA verzeichnete BASYS3-Datensätze zugeordnet wurden, werden alle Filmwerke bis auf jenes mit der niedrigsten BArch-BASYS3-ID mit dem Label "Löschen" versehen. <br> Im weiteren Verlauf wird das Ticket geöffnet und Eric Schlegel zur Bearbeitung zugeordnet.
 |-
-|Wochenschau|| Handelt es sich bei einem Filmwerk um eine Wochenschau oder aber um Wochenschaumaterial, wird das Ticket mit dem Stichwort "Wochenschau" versehen.
+|Wochenschau|| Handelt es sich bei einem Filmwerk um eine Wochenschau oder aber um Wochenschaumaterial, wird das Ticket mit dem Label "Wochenschau" versehen.
 |-
 |}

@@ Zeile 48: / Zeile 48: @@
 <b> <span style="color:#b32425"> WICHTIG: DIE UU-ID wird nicht mehr eingetragen. Ein entsprechendes Feld dazu gibt es ab sofort nicht mehr! </span> </b>
-===Erstellen von Fragen=== <br>
+===Erstellen von Fragen===
 [[Datei:Frage Jira.png]]<br><br>
-JIRA dient als direktes Kommunikations-Tool bei Rückfragen an den Kooperationspartner Deutsches Bundesarchiv. Hierzu ist der Vorgangstyp <b>Frage</b> gedacht.
+JIRA dient als direktes Kommunikations-Tool bei Rückfragen an den Kooperationspartner Deutsches Bundesarchiv. Hierzu ist der Vorgangstyp <b>Frage</b> gedacht. <br>
-Dabei wird auf das <b>+</b> in der Sidebar auf der linken Browserseite geklickt und ein neues Ticket geöffnet. Dann wird im Dropdown-Menü der Vorgangstyp "Frage" ausgewählt.
+Dabei wird auf das <b>+</b> in der Sidebar auf der linken Browserseite geklickt und ein neues Ticket geöffnet. Dann wird im Dropdown-Menü der Vorgangstyp "Frage" ausgewählt.<br>
-Im Feld "Zusammenfassung", welches für das Ticket als Überschrift fungiert, wird mit der allgemeinen Konvention für den Vorgangstyp "Frage" <b>Frage zu ... </b> eine Frage, welche das Problem möglichst genau umreißt, eingefügt. Darauf folgt (wenn möglich) eine oder mehrere BA-IDs, auf welche sich die Frage bezieht.
+Im Feld "Zusammenfassung", welches für das Ticket als Überschrift fungiert, wird mit der allgemeinen Konvention für den Vorgangstyp "Frage" <b>Frage zu ... </b> eine Frage, welche das Problem möglichst genau umreißt, eingefügt.<br>
-Im freien Textfeld "Beschreibung" kann dann das Problem beschrieben werden. Es sollte darauf geachtet werden, dass die Beschreibung möglichst verständlich und eventuell mit Beispielen versehen ist. Das Einfügen von Links ist in diesem Feld möglich.
+Darauf folgt (wenn möglich) eine oder mehrere BA-IDs, auf welche sich die Frage bezieht.<br>
-Sobald das Ticket erstellt wurde erscheint ein Pop-Up-Hinweis am rechten oberen Browserrand, welcher den Titel des neuen Tickets beinhaltet. Am besten ist es, diesen direkt anzuwählen (da er nach einigen Sekunden wieder verschwindet und so das neue Ticket zur weiteren Bearbeitung umständlich angewählt werden muss).
+Im freien Textfeld "Beschreibung" kann dann das Problem beschrieben werden. Es sollte darauf geachtet werden, dass die Beschreibung möglichst verständlich und eventuell mit Beispielen versehen ist.<br>
 Ist das Ticket in der Großansicht geöffnet kann unter "zugewiesene Person" das <b>FA4_bundesarchiv</b> ausgewählt werden.
 ===Erstellen von Aufgaben===

@@ Zeile 48: / Zeile 48: @@
 <b> <span style="color:#b32425"> WICHTIG: DIE UU-ID wird nicht mehr eingetragen. Ein entsprechendes Feld dazu gibt es ab sofort nicht mehr! </span> </b>
-===Erstellen von Fragen===
+===Erstellen von Fragen=== <br>
-JIRA dient als direktes Kommunikations-Tool bei Rückfragen an den Kooperationspartner Deutsches Bundesarchiv. Hierzu kann der Vorgangstyp  Frage ausgewählt werden.
+[[Datei:Frage Jira.png]]<br><br>
+JIRA dient als direktes Kommunikations-Tool bei Rückfragen an den Kooperationspartner Deutsches Bundesarchiv. Hierzu ist der Vorgangstyp <b>Frage</b> gedacht.
 ===Erstellen von Aufgaben===
 Gibt es Aufgaben, Probleme oder Unklarheiten, welche während des Projekts anfallen, so lassen sich diese auch als JIRA-Tickets formulieren um sie dem BA zuzuweisen.
 Dabei wird wie beim Anlegen neuer Aufnahmen das + in der Sidebar angewählt und eine neue <b>Aufgabe</b> erstellt.
 [[Datei:Aufgabe-klein-neu.png]] <br>

@@ Zeile 47: / Zeile 47: @@
 Sie muss dabei den Konventionen der anderen JIRA-Tickets vollständig entsprechen. Der Titel des Tickets besteht aus Aufnahme von "TITEL" (BA-Filmwerk ID). Mehrere Titel (dazu zählen alle Titeltypen, die in der BArch BASYS3 angegeben werden und fett gedruckt sind (auch Periodika, Untertitel etc.)) werden durch ein <b>_/_</b> voneinander getrennt. Nach Anlegen des Tickets muss dieses angeklickt und mit den restlichen Informationen gefüttert werden. Dazu zählen z.B. Matching-Bearbeiter, Matchingdatum etc.
 <b> <span style="color:#b32425"> WICHTIG: DIE UU-ID wird nicht mehr eingetragen. Ein entsprechendes Feld dazu gibt es ab sofort nicht mehr! </span> </b>
 ===Erstellen von Aufgaben===
-Gibt es Aufgaben, Probleme oder Unklarheiten, welche während des Projekts anfallen, so lassen sich diese auch als JIRA-Tickets anlegen.
+Gibt es Aufgaben, Probleme oder Unklarheiten, welche während des Projekts anfallen, so lassen sich diese auch als JIRA-Tickets formulieren um sie dem BA zuzuweisen.
 Dabei wird wie beim Anlegen neuer Aufnahmen das + in der Sidebar angewählt und eine neue <b>Aufgabe</b> erstellt.
 [[Datei:Aufgabe-klein-neu.png]] <br>

@@ Zeile 79: / Zeile 79: @@
 ===Erstellen von 'Relevanz unklar' oder 'Zuordnung unklar'===
 Die Vorgangstypen <b>Relevanz unklar </b> und <b> Zuordnung unklar </b> werden nur in Sonderfällen benutzt. Diese Funktionen sollen <b><span style="color:#b32425"> KEIN ERSATZ FÜR DAS MATCHING-ANMERKUNGSFELD IN DER BASYS3 </span> </b> darstellen.
-Sie sollen zur Klärung von Sonderfällen und Problemen verwedet werden. Hier wird ebenfalls eine genaue Beschreibung des Problems im Ticket eingetragen und eine Beispiel-BA-UID angeführt.
+Sie sollen zur Klärung von Sonderfällen und Problemen verwendet werden. Hier wird ebenfalls eine genaue Beschreibung des Problems im Ticket eingetragen und eine Beispiel-BA-UID angeführt.
 ==ZDB-Issues und Bugreport in JIRA==

@@ Zeile 56: / Zeile 56: @@
 ===Erstellen von Reihen===
-Ebeneso wie neue Aufgaben und Aufnahmen können jetzt auch <b> Reihen </b> als Vorgangstyp ausgewählt werden.
+Ebenso wie neue Aufgaben und Aufnahmen können jetzt auch <b> Reihen </b> als Vorgangstyp ausgewählt werden.
 Dabei wird wie beim Anlegen neuer Aufnahmen oder Aufgaben das + in der Sidebar angewählt und eine neue <b>Reihe</b> erstellt. <br>
 [[Datei:Reihe-klein2.png]] <br><br>
@@ Zeile 76: / Zeile 76: @@
 Das fertige Aufnahmeprotokoll wird dem Ticket angehangen. Dieses wird bitte <b> NICHT innerhalb von JIRA </b> gepflegt sondern <b> erst nach Fertigstellung </b> dem Ticket hinzugefügt. Außerdem können auch Rechercheunterlagen sowie das Style sheet hochgeladen werden.
 Schließlich wird das Ticket noch mit dem Schlagwort "<b>Wochenschau</b>" versehen.
 ===Erstellen von 'Relevanz unklar' oder 'Zuordnung unklar'===

@@ Zeile 45: / Zeile 45: @@
 Wenn Filmwerke angelegt werden sollten, die noch nicht in JIRA enthalten sind kann durch das + in der Sidebar eine neue <b>Aufnahme</b> eröffnet werden.<br>
 [[Datei:Aufnahme-klein.png]]<br>
-Sie muss dabei den Konventionen der anderen JIRA-Tickets vollständig entsprechen. Der Titel des Tickets besteht aus Aufnahme von "TITEL" (BA-Filmwerk ID). Mehrere Titel (dazu zählen alle Titeltypen, die in der BArch BASYS3 angegeben werden und fett gedruckt sind (auch Periodika, Untertitel etc.)) werden durch ein <b>_/_</b> voneinander getrennt. Nach Anlegen des Tickets muss dieses angeklickt und mit den restlichen Informationen befüllt werden. Dazu zählen z.B. Matching-Bearbeiter, Matchingdatum etc.
+Sie muss dabei den Konventionen der anderen JIRA-Tickets vollständig entsprechen. Der Titel des Tickets besteht aus Aufnahme von "TITEL" (BA-Filmwerk ID). Mehrere Titel (dazu zählen alle Titeltypen, die in der BArch BASYS3 angegeben werden und fett gedruckt sind (auch Periodika, Untertitel etc.)) werden durch ein <b>_/_</b> voneinander getrennt. Nach Anlegen des Tickets muss dieses angeklickt und mit den restlichen Informationen gefüttert werden. Dazu zählen z.B. Matching-Bearbeiter, Matchingdatum etc.
 <b> <span style="color:#b32425"> WICHTIG: DIE UU-ID wird nicht mehr eingetragen. Ein entsprechendes Feld dazu gibt es ab sofort nicht mehr! </span> </b>
 ===Erstellen von Aufgaben===

@@ Zeile 40: / Zeile 40: @@
 == Erstellen von JIRA-Tickets==
 Jeder neuen Aufnahme von der BASYS3 in die ZDB entspricht in JIRA ein "Ticket". Dessen Klassifizierung richtet sich nach den Umständen. Es wird zwischen Aufnahmen, Reihen und Aufgaben unterschieden. Die Aufgaben stellen eine Möglichkeit zur Kommunikation zwischen einzelnen Bearbeitern sowie dem DIF und dem BA dar.
-Im folgenden soll eine Übersicht über die drei Tickettypen sowie deren Erstellung gegeben werden.
+Im Folgenden soll eine Übersicht über die drei Tickettypen sowie deren Erstellung gegeben werden.
 ===Erstellen von Aufnahmen===

@@ Zeile 9: / Zeile 9: @@
 [[Datei:JIRA Projektübersicht-klein.jpg]]
-==Aufbau der Jira-Tickets==
+==Aufbau der JIRA-Tickets==
 Im Projekt ''Datenkooperation BA-DIF'' befinden sich  die sogenannten Aufnahmen, umgangssprachlich JIRA-Tickets genannt.<br>
 Diese entsprechen jeweils einem mit „Aufnahme“ versehenen FW-Datensatz aus der BArch BASYS3.<br>