Fehlermeldungen

Die Meldungen, die TrakState anzeigt, wenn etwas nicht geht — und was jeweils der nächste Schritt ist.

Zwei Dinge vorweg:

Eine Ablehnung ist kein Absturz. Wo eine dieser Meldungen steht, hat das System gearbeitet und sich entschieden. Nichts ist halb geschehen.
Manche Meldungen kommen vom Server und stehen auf Englisch, unabhängig von der eingestellten Sprache. Sie sind unten mit dem Originaltext aufgeführt.

Ein Plugin installieren oder aktualisieren

Jede Ablehnung trägt genau einen Grund aus einer festen Liste. Der rohe Text des Servers wird nie angezeigt — immer nur einer dieser Sätze.

Das Paket selbst

Meldung	Was zu tun ist
Die hochgeladene Datei ist kein gültiges ZIP-Archiv.	Die falsche Datei erwischt, oder sie ist beim Übertragen beschädigt worden.
Das Paket überschreitet die maximal zulässige Größe.	Grenze ist 50 MB gepackt.
Das Archiv überschreitet eine Größen-, Eintrags- oder Kompressionsgrenze.	200 MB entpackt, 50 MB je Datei, 2000 Einträge. Meist ist es die Eintragszahl.
Das Archiv enthält einen Eintrag, der sich nicht sicher entpacken lässt.	Das Paket ist fehlerhaft gebaut. Wenden Sie sich an den Ersteller.
Das Paket-Layout ist ungültig: Es muss genau eine manifest.json in der Wurzel, einen dist/-Ordner und die im Manifest genannte Einstiegsdatei enthalten.	Ein Baufehler des Pakets.
Das Paket-Manifest ist ungültig oder beansprucht eine reservierte Identität oder ein reserviertes Recht.	Das Paket verlangt etwas, das nur der Plattform zusteht.
Das Paket benötigt eine Plattformversion, die dieser Host nicht bereitstellt.	Erst TrakState aktualisieren, dann das Plugin.

Signatur und Vertrauen

Meldung	Was zu tun ist
Dieses Paket enthält Backend-Code und braucht eine Betreiber-Signatur.	Ein Paket mit serverseitigem Code muss signiert sein. Hängen Sie die `.sig` an oder nehmen Sie eine `.tspkg`.
Die Signatur passt nicht zu diesem Paket oder zum Betreiber-Schlüssel.	Paket und Signatur gehören nicht zusammen, oder der Schlüssel ist nicht hinterlegt. Beziehen Sie beides erneut.
Der Backend-Code in diesem Paket ist mit Ihrem eigenen Schlüssel signiert … deshalb wurde das ganze Paket abgelehnt.	Ihre Signatur ist in Ordnung. Diese Instanz führt Backend-Code aus selbst signierten Paketen noch nicht aus. Ein reines Oberflächen-Paket mit Ihrem Schlüssel installiert sich normal.

Ist die Signatur einer bereits installierten Version nicht mehr prüfbar, steht in der Plugin-Liste: nicht betriebsbereit — die Signatur prüft nicht mehr gegen den aktuellen Betreiberschlüssel. Das Plugin bleibt sichtbar, sein Backend läuft nicht.

Der Zustand dieser Instanz

Meldung	Was zu tun ist
Ein Plugin mit dieser Id ist bereits installiert oder fest eingebaut.	Aktualisieren statt installieren, oder das andere zuerst entfernen.
Das Paket beschreibt eine Tabelle, die bereits existiert oder einem anderen Plugin gehört.	Zwei Pakete beanspruchen denselben Namensraum.
Die Paket-Ablage ist voll; aktuell kann kein weiteres Paket installiert werden.	Ein nicht mehr gebrauchtes Paket entfernen.
Es läuft bereits eine andere Installation. Versuchen Sie es gleich noch einmal.	Je Instanz läuft immer nur ein Lebenszyklus-Vorgang.
Diese Instanz kann keine Pakete installieren: es fehlt entweder der Paketspeicher oder die Datenbankverbindung für Plugin-Tabellen … bitte an den Betreiber wenden.	Das wird beim Einrichten der Instanz vergeben. Die Instanz bleibt sonst voll benutzbar.
Sie haben nicht das Recht, Plugins zu installieren.	Es braucht `plugin:manage`, üblicherweise ein Mandanten-Administrator.

Beim Aktualisieren und Entfernen

Meldung	Was zu tun ist
Für diese Id ist kein aktives Paket installiert.	Es gibt nichts zu aktualisieren.
Die neue Version ist nicht höher als die aktive. Laden Sie das Paket mit einer höheren Versionsnummer erneut hoch.	Rückschritte gibt es nicht. Dasselbe gilt, wenn die aktive Version nicht mehr prüft: Patch-Version erhöhen, neu signieren.
Mindestens eine Änderung ist nicht zulässig.	Diese Umstellung lässt sich nicht sicher ausdrücken.
Die vorhandenen Daten passen nicht zu dieser Änderung.	Der Plan nennt die betroffenen Zeilen. Meist hilft nur eine passende Version des Pakets.
Dieser Vorgang würde Daten zerstören; bitte bestätigen Sie den gezeigten Plan.	Die Bezifferung lesen und ausdrücklich bestätigen. Bei der Ein-Klick-Aktualisierung aus dem Katalog gibt es keinen Plan zum Bestätigen: Paket hochladen… mit der Paketdatei verwenden, das zeigt ihn. Das Plugin nicht entfernen, um es zu umgehen.
Der Plan hat sich geändert; bitte prüfen Sie die aktualisierte Ansicht.	Zwischen Ansehen und Bestätigen hat sich etwas bewegt. Erneut ansehen.
Der Export dieses Vorgangs überschreitet die zulässige Größe. Sie können ohne Export fortfahren.	Dann sind die Daten unwiederbringlich weg — das ist die zweite Bestätigung.
Das gespeicherte Manifest dieser Version ist nicht mehr lesbar; eine Aktualisierung ist nicht möglich … entfernen und neu installieren.	Der Datenexport beim Entfernen läuft wie gewohnt.
Der aktualisierte Backend-Teil konnte nicht gestartet werden.	Die Aktualisierung wurde nicht angewandt, die bisherige Version bleibt aktiv.
Zwei installierte Plugins beanspruchen denselben Tabellen-Namensraum …	Eine der beiden Identitäten auflösen. Das Entfernen eines der beiden lässt die Tabellen unangetastet.

In der Plugin-Liste

Meldung	Bedeutet
Das gespeicherte Manifest ist ungültig.	Das Paket ist so nicht mehr benutzbar.
Dieses Plugin benötigt eine Plattformversion, die dieser Host nicht bereitstellt.	Nach einer TrakState-Aktualisierung kann es wieder laufen.
Die Identität dieses Plugins ist nicht eindeutig …	Zwei Pakete überschneiden sich im Namensraum.
System-Plugins sind Teil der Anwendung und können nicht abgeschaltet werden.	Kein Fehler, sondern die Antwort auf den Versuch.
Herkunft unbekannt	Es lässt sich nicht mehr feststellen, woher das Paket kam. Das ist etwas anderes als Unsigniert.

Signaturschlüssel

Meldung	Was zu tun ist
Dies ist kein lesbarer Ed25519-Öffentlicher-Schlüssel. Prüfen Sie, ob Sie den ÖFFENTLICHEN Schlüssel (nicht den privaten) als PEM eingefügt haben.	`public.pem`, nicht `private.pem`.
Bezeichnung und Schlüsselfeld dürfen nicht leer sein.	Beide Felder ausfüllen.
Sie haben diesen Schlüssel bereits hinterlegt.	—
Sie haben nicht das Recht, Signaturschlüssel zu verwalten.	—
Dieser Schlüssel existiert nicht mehr.	Er wurde inzwischen entfernt.

Beim Widerrufen: Pakete, die bereits mit „…” signiert wurden, prüfen danach nicht mehr. Das gilt rückwirkend, nicht nur für Neues.

Meldung	Was los ist
Unsicher (Verlässlichkeit)	Der Wert lässt sich gerade nicht ermitteln. Kein Absturz — ein Zustand.
Unbrauchbar	Der Wert ist da, aber nicht zu gebrauchen.
Kein Zugriff	Ihnen fehlt das Recht auf diesen Wert.
Wert nicht verfügbar	Die Anzeige konnte den Wert nicht laden.
Noch kein Konnektor gewählt — das Tag existiert, sein Wert bleibt unsicher.	Kein Fehler, sondern der ehrliche Zwischenstand eines noch nicht fertig eingerichteten Tags.
Für diesen Konnektor gibt es noch keine Verbindung. Unter Einstellungen → Verbindungen anlegen.	Der genaue nächste Schritt steht in der Meldung.
`this tag writes to a machine, but no connector is running here`	Das Tag schreibt nach außen, aber auf dieser Instanz läuft kein Konnektor dafür. Ein Schreiben nach außen muss ankommen oder scheitern — es wird nie stillschweigend nur vermerkt.
`tag of kind '…' is not writable`	Diese Tag-Art nimmt keinen geschriebenen Wert an.
`this tag has no setter: add on_write(value) to its script`	Ein Skript-Tag wird erst beschreibbar, wenn es `on_write(value)` hat.
`no tag at '…'` / `tag not found`	Der Pfad zeigt ins Leere — meist nach einer Umbenennung an einer Stelle, die den Pfad statt der Kennung führt.
… hängt bereits von diesem Tag ab.	Die Bindung würde einen Kreis schließen und wird abgelehnt.
Änderung konnte nicht gespeichert werden.	Der Schreibvorgang kam nicht durch.
Ein Tag dieser Art kann keinen Verlauf haben: sein Wert entsteht bei jedem Lesen neu, gespeichert wird nichts.	Kein Fehler — eine Eigenschaft der Tag-Art.

Abfragen

Meldung	Was zu tun ist
Die Abfrage lief nicht	Darunter steht der Text der Datenbank. Der Probelauf ist der Ort, an dem das auffallen soll.
Die Abfrage lief. Diese Auswahl enthält nichts.	Kein Fehler. Die Abfrage ist in Ordnung, der Zeitraum oder der Filter ist leer.
Diese Abfrage liest N Feld(er), die es nicht mehr gibt: … Sie stehen unter ihrem internen Namen, weil kein anderer mehr existiert.	Das Datenmodell hat sich unter der Abfrage verändert.
die ersten N werden gezeigt	Die Vorschau ist gekappt, nicht das Ergebnis.

Skripte

Meldung	Was zu tun ist
Das Skript ist gescheitert.	Die Zeilennummer steht daneben.
Kein Wert hinter: … — diese gingen leer hinein.	Ein Eingang ist nicht gebunden oder liefert nichts.
Wählen Sie mindestens ein Tag, sonst sieht dies eingerichtet aus und löst nie aus.	Ein Auslöser auf Tag-Änderung ohne Tags ist wirkungslos.
`system.tag.write()` wirkt in einem Skript-Tag nur innerhalb von `on_write(value)`.	Außerhalb tut der Aufruf nichts.
`AttributeError: no '…' here - this namespace has: …`	Ein Vertipper im Namensraum. Die Meldung nennt, was es an dieser Stelle wirklich gibt: `system.tag.raed(...)` antwortet mit read, write.
`NameError: name 'read_tag' is not defined`	Die früheren Namen `read_tag()`/`write_tag()` gibt es nicht mehr. Ersetzen Sie sie durch `system.tag.read()` und `system.tag.write()`.
Auf dieser Instanz läuft nichts von selbst — es gibt hier keine Auslöserschleife. Skripte lassen sich bearbeiten und von Hand ausführen.	Kein Fehler, sondern eine Eigenschaft dieser Installation.
Kein Skript hier heißt so. Das kann völlig richtig sein …	Ein Import, den TrakState nicht kennt. Eine Anlage darf Python-Pakete haben, die wir nicht kennen.

Datenmodell und Erfassung

Meldung	Was zu tun ist
N Datensatz/Datensätze haben keinen Wert — erst Standardwert setzen.	Ein Feld lässt sich erst zur Pflicht machen, wenn keine Zeile ohne Wert übrig ist.
Feld „…” löschen? N Datensatz/Datensätze tragen einen Wert — nicht umkehrbar.	Die Bezifferung steht vor der Entscheidung, nicht danach.
Nur ein Tenant-Admin kann das Datenmodell ändern.	—
Diese Datensatz-Art hat noch keine Felder.	Erst Felder anlegen, dann erfassen.
Datensatz-Arten konnten nicht geladen werden.	Die Verbindung zum Server.

Ein Plugin lässt sich nicht anzeigen

Zeigt eine Plugin-Seite nichts, liegt es fast immer an einer dieser drei Lagen: Das Plugin ist installiert, aber nicht eingeschaltet; seine Version ist mit dieser TrakState-Version nicht verträglich; oder das Paket bringt gar keine Oberfläche mit. Die Plugin-Liste unter Einstellungen → Plugins sagt in allen drei Fällen, welche es ist.