Jira-Workflow: Jahresmeldung-Epic, Befund-Vorgänge und Issue-Panel „RoI Record“

Ziel: Sie nutzen Jira für den Prozess rund um das Register: ein Epic für die Jahresmeldung (manuell oder automatisch vor dem Abgabetermin), Validierungsbefunde als Vorgänge und das Issue-Panel „RoI Record“, das Vorgänge mit Registerdatensätzen verknüpft.

Was liegt wo?

Was	Wo es liegt	Bemerkung
Registerdaten (15 Templates)	In der App (eigene, isolierte Datenbank je Installation auf Atlassian-Infrastruktur)	Nie als Jira-Vorgang – Jira bildet nur Prozesse ab.
Jahresmeldung-Epic	Jira-Vorgang im konfigurierten Projekt	Klammer für Datenerhebung, Review, Validierung, Export, Upload.
Validierungsbefund	Jira-Vorgang (Vorgangstyp „Aufgabe/Fehler“)	Auf Klick im Validierungs-Center; Rückverweis auf den Datensatz.
Rückverweis Vorgang → Datensatz	Vorgangseigenschaft `dora-roi-ref` am Jira-Vorgang	Wird vom Issue-Panel „RoI Record“ angezeigt.

Voraussetzungen

In den Einstellungen: Projekt-Schlüssel für Workflow-Vorgänge sowie die Vorgangstypen Vorgangstyp „Jahresmeldung“ (Standard Epic) und Vorgangstyp „Aufgabe/Fehler“ (Standard Task) – siehe Erste Schritte: App öffnen, einrichten und Demo-Daten laden.
Die Vorgangstypen müssen im Projekt existieren, und die App muss dort Vorgänge anlegen dürfen (sie handelt unter ihrer eigenen App-Identität, nicht unter Ihrem Benutzer). Bei Fehlern „HTTP 400/403/404“ hilft Ihr Jira-Administrator.
Für das Issue-Panel: die neue Vorgangsansicht von Jira (das Panel funktioniert nicht in der alten Ansicht).

A. Jahresmeldung-Epic manuell anlegen

Klicken Sie auf Einstellungen.
Klicken Sie auf Jahresmeldung-Epic jetzt anlegen (neben Speichern).
Erwartetes Ergebnis: grünes Badge „Epic ‹KEY› angelegt“ mit dem Jira-Schlüssel des neuen Epics. Ohne Projekt-Schlüssel erscheint stattdessen die rote Meldung „Kein Jira-Projekt konfiguriert (Einstellungen → Projekt-Schlüssel).“

Inhalt des Epics

Element	Inhalt
Vorgangstyp	Vorgangstyp „Jahresmeldung“ (Einstellungen)
Zusammenfassung	`DORA-Jahresmeldung ‹Jahr› — Informationsregister` (bei englischer Oberfläche: `DORA annual report ‹year› — Register of Information`)
Jahr	Beim manuellen Anlegen: das vorherige Kalenderjahr (z. B. 2025, wenn Sie 2026 klicken). Beim automatischen Anlegen: das Jahr des Abgabetermins minus 1.
Beschreibung	Drei Absätze: Klammer-Vorgang für die Jahresmeldung (Meldestichtag 31.12.‹Jahr›); Ablauf Datenerhebung → Review → Validierung → Export (xBRL-CSV) → Upload im BaFin-MVP-Portal; Hinweis, dass die App den Vorgang erzeugt hat.
Labels	`dora-roi`, `reporting-year-‹Jahr›`
Sprache	Die beim Klick aktive Oberflächensprache; automatisch angelegte Epics sind immer englisch.

B. Automatisches Epic vor dem Abgabetermin

Die App prüft einmal täglich, ob ein Jahresmeldung-Epic anzulegen ist (Hinweis in den Einstellungen: „Der tägliche Trigger legt dann automatisch das Jahresmeldung-Epic an.“). Es wird angelegt, wenn alle Bedingungen erfüllt sind:

Projekt-Schlüssel für Workflow-Vorgänge und Abgabetermin (BaFin) sind gespeichert.
Der Abgabetermin liegt heute oder in der Zukunft und ist höchstens Erinnerung (Tage vor Termin) Tage entfernt (Standard 30).
Für diesen Abgabetermin wurde noch kein Epic automatisch angelegt (die App merkt sich das je Termin-Datum; ändern Sie das Datum, kann ein weiteres Epic entstehen).
Der tägliche Lauf der App findet statt (er wird von der Plattform einmal pro Tag ausgelöst; der genaue Zeitpunkt ist nicht einstellbar).

C. Validierungsbefund als Jira-Vorgang anlegen

Führen Sie im Validierungs-Center die Validierung aus (Validierung und Datenqualität: Konsistenzprüfung, EBA-Regeln, GLEIF-LEI-Prüfung).
Klicken Sie in der Zeile des Befunds auf Jira-Vorgang.
Erwartetes Ergebnis: Die Schaltfläche wird durch ein blaues Badge mit dem Jira-Schlüssel (z. B. DORA-12) ersetzt. Ohne Projekt-Schlüssel erscheint eine rote Meldung (Abbildung 1).
Öffnen Sie den Vorgang in Jira; im Issue-Panel „RoI Record“ ist der betroffene Datensatz bereits verknüpft (sofern der Befund einen konkreten Datensatz betrifft – bei V-006 z. B. nicht).

Abbildung 1: Klick auf „Jira-Vorgang“ ohne konfigurierten Projekt-Schlüssel.

Inhalt des Befund-Vorgangs

Element	Inhalt
Vorgangstyp	Vorgangstyp „Aufgabe/Fehler“ (Einstellungen)
Zusammenfassung	`[RoI B_xx.xx] ‹Meldung des Befunds›` (Meldung auf 180 Zeichen gekürzt)
Beschreibung	Validierungsregel (z. B. V-010, Fehler/Warnung), Template und Spalte, Datensatz (Schlüsselwerte), Meldung, Hinweis „Nach Korrektur im RoI-Cockpit die Validierung erneut ausführen.“
Labels	`dora-roi`, `validierungsfehler` (bei englischer Oberfläche `validation-finding`), Regel-ID in Kleinbuchstaben (z. B. `v-010`)
Rückverweis	Vorgangseigenschaft `dora-roi-ref` mit Template und Datensatz (nur wenn der Befund einen Datensatz betrifft).

D. Issue-Panel „RoI Record“

Panel öffnen

Öffnen Sie einen Jira-Vorgang in der neuen Vorgangsansicht.
Klicken Sie auf die Schaltfläche der App (App-Symbol in der Vorgangsansicht; der Paneltitel RoI Record erscheint auch im Menü ••• des Vorgangs). Das Panel RoI Record wird oberhalb des Bereichs Aktivität eingeblendet. Jira-Administratoren können das Panel über dessen Menü für alle Vorgänge ein- oder ausblenden.

Datensatz verknüpfen

Ist noch kein Datensatz verknüpft, zeigt das Panel RoI-Datensatz verknüpfen mit zwei Auswahllisten (Abbildung 2).
Wählen Sie in der ersten Liste das Template: Vertragliche Vereinbarungen – Allgemein (B_02.01), IKT-Drittdienstleister (B_05.01) oder Geschäftsfunktionen (B_06.01) – andere Templates sind nicht verknüpfbar.
Wählen Sie in der zweiten Liste („– Datensatz wählen –“) den Datensatz; Einträge haben die Form Schlüssel — Name (bei Verträgen erscheint die Vertragsreferenz zweimal).
Klicken Sie auf Verknüpfen („Verknüpft…“ während des Verknüpfens).
Erwartetes Ergebnis: Das Panel zeigt den Template-Namen mit Code und darunter alle Felder des Datensatzes mit ihren Werten (Auswahlfelder als Klartext, Ja/Nein, leere Felder als „–“; Abbildung 3).

Abbildung 2: Panel-Inhalt vor der Verknüpfung (nur der Inhalt des Panels, ohne Jira-Vorgangsansicht).

Panel-Inhalt mit verknüpftem Vertrag und dessen Feldern — Abbildung 3: Panel-Inhalt nach der Verknüpfung eines Vertrags (B_02.01).

Hinweise

Eine bestehende Verknüpfung kann im Panel nicht geändert oder gelöst werden. Ein Jira-Administrator kann die Vorgangseigenschaft dora-roi-ref entfernen; danach erscheint das Verknüpfungsformular wieder.
Wurde der verknüpfte Datensatz gelöscht, zeigt das Panel „Verknüpfter Datensatz „…“ wurde nicht gefunden (evtl. gelöscht).“.
Das Panel zeigt nur an; bearbeitet wird in der App. Es gibt keinen Link vom Panel in die App.
Sprache: wie in der App eingestellt (pro Browser). Fehlermeldungen des Verknüpfens sind immer deutsch (z. B. „Datensatz nicht gefunden“).