Fehlerbehebung (Troubleshooting): Symptome, Ursachen, Lösungen
Fehlerbehebung (Troubleshooting): Symptome, Ursachen, Lösungen
Suchen Sie auf dieser Seite nach dem Text der Meldung oder dem Symptom (Strg+F). Meldungen stehen so, wie die App sie anzeigt; ‹…› steht für den konkreten Wert.
Zugriff und Anzeige
| Symptom | Wahrscheinliche Ursache | Lösung |
|---|---|---|
| Die App fehlt im Jira-Menü Apps. | App nicht installiert oder Ihr Zugriff eingeschränkt. | Jira-Administrator: App installieren (mit Zustimmung zur Verbindung api.gleif.org) bzw. Zugriff prüfen. |
| Beim Öffnen erscheint statt des Cockpits eine rote Meldung oder dauerhaft ein Ladekreis. | Der erste Aufruf nach der Installation richtet die Datenbank ein; Verbindungs- oder Backend-Fehler. | Seite neu laden und erneut versuchen. Bleibt die Meldung, den Text an den Jira-Administrator geben (App-Protokolle). |
| Die Oberfläche erscheint in der falschen Sprache. | Die Sprache wird pro Browser gespeichert; Standard ist Englisch. | Einstellungen → Sprache umschalten (Erste Schritte: App öffnen, einrichten und Demo-Daten laden). |
| Einstellungen, die ein Kollege gespeichert hat, gelten auch für mich. | Alle Einstellungen außer der Sprache gelten installationsweit. | Gewollt. Nur die Sprache ist persönlich. |
Speichern, Bearbeiten, Löschen
| Symptom | Wahrscheinliche Ursache | Lösung |
|---|---|---|
| Rote Meldung im Editor, der Datensatz wird nicht gespeichert. | Eine Konsistenzprüfung ist fehlgeschlagen (Schlüssel, Duplikat, Referenz, Typ, Länge). | Meldung in der Tabelle „Konsistenzprüfung beim Speichern“ nachschlagen: Validierung und Datenqualität: Konsistenzprüfung, EBA-Regeln, GLEIF-LEI-Prüfung. |
| Eine Auswahlliste im Editor ist leer („– bitte wählen –“ ohne Einträge). | Im referenzierten Template gibt es noch keine Datensätze. | Zuerst den referenzierten Datensatz anlegen (Reihenfolge in Datensätze anlegen, bearbeiten und löschen (Register pflegen)). |
| „Löschen blockiert: … wird noch in … referenziert.“ | Der Datensatz wird von anderen Templates verwendet. | Zuerst die abhängigen Datensätze löschen (umgekehrte Erfassungsreihenfolge). |
| „Schlüssel „…“ kann nicht geändert werden …“ | Der Schlüsselwert wird referenziert. | Verweise entfernen oder neuen Datensatz anlegen und alten später löschen. |
| Ein zweiter Eintrag in B_01.01 lässt sich nicht anlegen. | B_01.01 erlaubt genau einen Datensatz. | Den bestehenden Eintrag bearbeiten. |
| In der Liste stehen nur Kennungen/LEIs statt Namen. | Die Liste zeigt Schlüsselwerte der Verweise; Namen erscheinen im Editor-Dropdown. | Datensatz öffnen oder im referenzierten Template suchen. |
Validierung
| Symptom | Wahrscheinliche Ursache | Lösung |
|---|---|---|
| „Zum Datensatz“ springt nicht zum Datensatz, sondern zur Liste. | Verhalten der App: Es wird das Template geöffnet. | Wert aus der Spalte Datensatz in das Suchfeld eintragen. |
| Befunde bleiben nach der Korrektur stehen. | Die Tabelle ist eine Momentaufnahme. | Validierung ausführen erneut klicken. |
| Waisen-Referenz (V-005) obwohl der Editor nur existierende Werte anbietet. | Der Wert stammt aus einem Import oder der referenzierte Datensatz wurde per Import verändert. | Referenzierten Datensatz anlegen oder Verweis im Editor neu auswählen. |
| „Das registerführende Unternehmen (B_01.01) ist noch nicht erfasst“ (V-006). | B_01.01 ist leer. | B_01.01 anlegen – auch Voraussetzung für einen korrekten Export-Dateinamen. |
| V-007 obwohl eine Bewertung existiert. | Die Bewertung in B_07.01 hat eine andere Vertragsreferenz oder einen anderen Dienstleister als das Vertragsdetail in B_02.02. | Bewertung mit exakt derselben Vertragsreferenz und demselben Dienstleister anlegen. |
| Die Kachel „Validierung“ im Cockpit zeigt andere Zahlen als das Validierungs-Center. | Das Cockpit rechnet beim Öffnen neu; das Validierungs-Center zeigt den letzten Lauf. | Validierung erneut ausführen. |
GLEIF-LEI-Prüfung
| Symptom | Wahrscheinliche Ursache | Lösung |
|---|---|---|
| Badge „Formal ungültiger LEI (Prüfziffern)“. | Tippfehler oder falsche Länge. | LEI korrigieren (20 Zeichen). |
| Badge „LEI ist bei GLEIF nicht registriert“. | LEI existiert nicht im GLEIF-Register (z. B. alle Demo-LEIs). | LEI beim Unternehmen erfragen. |
| Badge „LEI-Registrierungsstatus: LAPSED“ (oder anderer Status). | Registrierung nicht aktiv. | Mit dem Unternehmen klären; die App blockiert nicht. |
| Badge „GLEIF-API antwortete mit Status …“ oder eine Netzwerk-Fehlermeldung. | GLEIF-Dienst gestört/überlastet oder Verbindung nicht freigegeben. | Später erneut versuchen; bei Dauerzustand Jira-Administrator (Zustimmung zur Verbindung api.gleif.org). |
| Die GLEIF-Meldung ist deutsch, obwohl die Oberfläche englisch ist. | Bekannte Einschränkung der App. | Bedeutung in der Ergebnistabelle nachschlagen: Validierung und Datenqualität: Konsistenzprüfung, EBA-Regeln, GLEIF-LEI-Prüfung. |
xBRL-CSV-Export
| Symptom | Wahrscheinliche Ursache | Lösung |
|---|---|---|
| Keine ZIP-Datei im Download-Ordner, obwohl die Erfolgsmeldung erschien. | Der Browser hat den Download blockiert. | Downloads für Jira erlauben und erneut erzeugen (neuer Zeitstempel im Dateinamen; beide Läufe stehen in der Historie). |
| Gelbe Meldung „Paket erzeugt, enthält aber n Validierungsfehler“. | Das Register hat Fehler der Schwere „Fehler“. | Befunde beheben (Validierung und Datenqualität: Konsistenzprüfung, EBA-Regeln, GLEIF-LEI-Prüfung) und neu erzeugen; das fehlerhafte Paket nicht einreichen. |
Dateiname beginnt mit UNKNOWNLEI oder enthält das heutige Datum statt des Meldestichtags. | B_01.01 fehlt oder hat keinen LEI/Meldestichtag. | B_01.01 vervollständigen und neu erzeugen. |
In FilingIndicators.csv steht false für ein Template. | Das Template enthält keine Datensätze. | Prüfen, ob das gewollt ist; sonst Datensätze erfassen. |
Falsche Basiswährung in parameters.csv. | Basiswährung des Reports in den Einstellungen. | Einstellung ändern, speichern, neu erzeugen. |
| Rote Fehlermeldung beim Erzeugen. | Backend-Fehler. | Erneut versuchen; Meldung an den Jira-Administrator weitergeben. |
Excel-Import
| Symptom | Wahrscheinliche Ursache | Lösung |
|---|---|---|
| „Keine Templates erkannt. Erwartet werden Arbeitsblätter mit EBA-Namen (B_01.01 …) und Spaltencodes (c0010 …) in einer Kopfzeile.“ | Arbeitsblätter heißen nicht wie die EBA-Codes oder es fehlt die Kopfzeile mit c0010 … | Blattnamen und Kopfzeile anpassen (EBA-Excel-Register importieren). |
| „Datei konnte nicht gelesen werden: …“ | Keine gültige Excel-Datei (z. B. passwortgeschützt, CSV). | Als .xlsx ohne Schutz speichern. |
| Zeilenfehler „Referenz nicht gefunden …“ | Der referenzierte Datensatz fehlt in Datei und Register. | Eltern-Template in dieselbe Datei aufnehmen oder zuerst importieren. |
| Zeilenfehler „Ungültiger Wert … für Feld …“ | Klartext statt Code in einem Auswahlfeld (z. B. „Cloud-Dienste: SaaS“ statt S16). | Code aus der Codeliste verwenden (Die 15 EBA-Templates im Überblick). |
| Zeilenfehler „Ungültiges Datum „45672“ …“ | Excel-Datumszelle statt Text. | Zelle als Text JJJJ-MM-TT erfassen. |
| Datensätze wurden „aktualisiert“ statt „neu“ angelegt. | Gleicher Schlüssel existierte bereits (Upsert). | Gewollt; Werte wurden überschrieben. |
| Viele Zeilen „übersprungen“. | Leere Zeilen. | Unkritisch. |
Jira-Workflow und Issue-Panel
| Symptom | Wahrscheinliche Ursache | Lösung |
|---|---|---|
| „Kein Jira-Projekt konfiguriert (Einstellungen → Projekt-Schlüssel).“ | Projekt-Schlüssel fehlt. | Einstellungen → Projekt-Schlüssel für Workflow-Vorgänge eintragen und speichern. |
| „Jira-Vorgang konnte nicht angelegt werden (HTTP 400/403/404): …“ | Projekt-Schlüssel falsch, Vorgangstyp existiert nicht im Projekt oder die App darf dort keine Vorgänge anlegen. | Schlüssel/Vorgangstypen prüfen; Jira-Administrator (Projektberechtigungen der App). |
| Es wurden mehrere Jahresmeldung-Epics angelegt. | Mehrfach geklickt (keine Duplikatprüfung) oder Abgabetermin geändert (Automatik pro Termin-Datum). | Überzählige Epics in Jira schließen/löschen. |
| Das automatische Epic wurde nicht angelegt. | Bedingungen nicht erfüllt (Projekt-Schlüssel + Abgabetermin gesetzt, Termin innerhalb der Erinnerungsfrist, noch nicht angelegt, Tageslauf noch nicht erfolgt). | Bedingungen in Jira-Workflow: Jahresmeldung-Epic, Befund-Vorgänge und Issue-Panel „RoI Record“ prüfen; ggf. manuell anlegen. |
| Das Panel „RoI Record“ ist im Vorgang nicht zu sehen. | Alte Vorgangsansicht, Panel noch nicht eingeblendet, oder von einem Administrator ausgeblendet. | Neue Vorgangsansicht verwenden; App-Schaltfläche bzw. Menü ••• → „RoI Record“ anklicken; Administrator fragen. |
| Panel zeigt „Verknüpfter Datensatz „…“ wurde nicht gefunden (evtl. gelöscht).“ | Der verknüpfte Datensatz wurde gelöscht (auch wenn er mit gleichem Schlüssel neu angelegt wurde). | Jira-Administrator entfernt die Vorgangseigenschaft dora-roi-ref; dann neu verknüpfen. |
| Die Datensatz-Liste im Panel ist leer. | Das gewählte Template enthält keine Datensätze. | Datensätze in der App anlegen. |
Daten und Demo-Daten
| Symptom | Wahrscheinliche Ursache | Lösung |
|---|---|---|
| Alle Registerdaten wurden versehentlich gelöscht. | „Alle Registerdaten löschen“ ist unwiderruflich; es gibt keinen Papierkorb. | Mögliche Wiederherstellung aus den CSV-Dateien eines früheren xBRL-CSV-Pakets: je Template ein Arbeitsblatt B_xx.xx mit der CSV-Kopfzeile in eine Excel-Datei übernehmen und importieren. Vorher mit Demo-Daten testen. |
| Demo-Daten sollen wieder entfernt werden. | Demo-Daten liegen im normalen Register. | Einzeln löschen (Verträge und Bewertungen vor Dienstleistern/Funktionen) oder – wenn keine echten Daten vorhanden sind – „Alle Registerdaten löschen“. |
Verwandte Seiten
Aufnahmen der echten App-Oberfläche mit den eingebauten Demo-Daten („Nordpay“, fiktives Zahlungsinstitut); der umgebende Jira-Rahmen ist nicht abgebildet.
Dokumentationsstand: App-Version 2.0.0 · 2026-08-25