Ausführungsstatus

Jede Operation meldet ihr Ergebnis auf zwei Knoten neben sich: output/status-code für Ihr Programm und output/status-text für einen Menschen.

Statuscodes

Code Bedeutung Wann er auftritt

Code	Bedeutung	Wann er auftritt
`0`	Idle	Die Operation wurde seit dem Start der Anwendung nicht ausgeführt
`1`	OK	Die Operation wurde abgeschlossen. Eine Suche kann trotzdem nichts gefunden haben - das ist ein normales Ergebnis, kein Fehler
`-1`	Belegt	Eine andere Operation desselben Moduls lief noch. Es wurde nichts getan; versuchen Sie es erneut, sobald sie abgeschlossen ist
`-2`	Ungültige Eingabe	Ein Eingabewert kann nicht verwendet werden - ein erforderlicher Knoten ist leer, ein unbekannter Matching-Modus, eine Bildadresse, die auf diese Anwendung selbst zeigt, oder ein Verzeichnispfad, der absolut ist oder aus dem Konfigurationsverzeichnis hinausführt
`-3`	Bild konnte nicht gelesen werden	Der Bildknoten an der angegebenen Adresse fehlt, ist leer oder inkonsistent oder verwendet ein nicht unterstütztes Pixelformat. Prüfen Sie, dass die Kameraanwendung läuft und ein Bild aufgenommen hat
`-4`	Quelle nicht gefunden	Das Vorlagenverzeichnis oder die Vorlagendatei fehlt oder ist nicht lesbar. Prüfen Sie den Namen anhand von `system/templates` und prüfen Sie `system/template-dir`: Alle Module teilen sich ein Vorlagenverzeichnis
`-5`	Ungültige Ausschnittsregion	Die Region of Interest passt nicht in das Bild. Die Meldung nennt die tatsächliche Bildgröße
`-6`	Schreiben fehlgeschlagen	Eine Datei konnte nicht geschrieben werden - meist ein Berechtigungsproblem oder ein voller Datenträger
`-7`	Algorithmus fehlgeschlagen	Das Matching selbst ist fehlgeschlagen
`-8`	Veröffentlichen fehlgeschlagen	Das Ergebnis konnte nicht auf den Data Layer zurückgeschrieben werden
`-9`	Modul nicht gefunden	Das genannte Modul existiert nicht. Prüfen Sie `system/modules` auf die aktuelle Liste
`-10`	Modul existiert bereits	Ein Modul mit diesem Namen ist bereits vorhanden
`-11`	Lizenz nicht verfügbar	Keine Lizenz deckt das Modul ab. Siehe Modulverwaltung

0

Idle

Die Operation wurde seit dem Start der Anwendung nicht ausgeführt

1

Die Operation wurde abgeschlossen. Eine Suche kann trotzdem nichts gefunden haben - das ist ein normales Ergebnis, kein Fehler

-1

Belegt

Eine andere Operation desselben Moduls lief noch. Es wurde nichts getan; versuchen Sie es erneut, sobald sie abgeschlossen ist

-2

Ungültige Eingabe

Ein Eingabewert kann nicht verwendet werden - ein erforderlicher Knoten ist leer, ein unbekannter Matching-Modus, eine Bildadresse, die auf diese Anwendung selbst zeigt, oder ein Verzeichnispfad, der absolut ist oder aus dem Konfigurationsverzeichnis hinausführt

-3

Bild konnte nicht gelesen werden

Der Bildknoten an der angegebenen Adresse fehlt, ist leer oder inkonsistent oder verwendet ein nicht unterstütztes Pixelformat. Prüfen Sie, dass die Kameraanwendung läuft und ein Bild aufgenommen hat

-4

Quelle nicht gefunden

Das Vorlagenverzeichnis oder die Vorlagendatei fehlt oder ist nicht lesbar. Prüfen Sie den Namen anhand von system/templates und prüfen Sie system/template-dir: Alle Module teilen sich ein Vorlagenverzeichnis

-5

Ungültige Ausschnittsregion

Die Region of Interest passt nicht in das Bild. Die Meldung nennt die tatsächliche Bildgröße

-6

Schreiben fehlgeschlagen

Eine Datei konnte nicht geschrieben werden - meist ein Berechtigungsproblem oder ein voller Datenträger

-7

Algorithmus fehlgeschlagen

Das Matching selbst ist fehlgeschlagen

-8

Veröffentlichen fehlgeschlagen

Das Ergebnis konnte nicht auf den Data Layer zurückgeschrieben werden

-9

Modul nicht gefunden

Das genannte Modul existiert nicht. Prüfen Sie system/modules auf die aktuelle Liste

-10

Modul existiert bereits

Ein Modul mit diesem Namen ist bereits vorhanden

-11

Lizenz nicht verfügbar

Keine Lizenz deckt das Modul ab. Siehe Modulverwaltung

Diese Codes sind der eigene Ausführungsstatus der Finder, nicht die Modul-Statuscodes des Cam Driver oder von AI Object Matching: -5 bedeutet hier eine ungültige Ausschnittsregion. Siehe Ausführungsstatus der Finder.

Diese Zahlen sind Teil der Schnittstelle der Anwendung. In späteren Releases können neue Codes hinzukommen, aber bestehende ändern nie ihre Bedeutung; Logik, die auf ihnen aufbaut, funktioniert nach einem Update weiter.

Deshalb ist die Prüfung des Vorzeichens der robustere Test: status-code < 0 bleibt auch dann richtig, wenn ein Release einen Fehler einführt, den Ihr Programm noch nie gesehen hat.

Welche Operation welche Codes meldet

Operation Mögliche Codes

Operation	Mögliche Codes
Eine Vorlage finden	`1`, `-1`, `-2`, `-3`, `-4`, `-7`, `-8`
Eine Vorlage erstellen	`1`, `-1`, `-2`, `-3`, `-5`, `-6`
`system/save-module-inputs`	`1`, `-6`, `-9`

Eine Vorlage finden

1, -1, -2, -3, -4, -7, -8

Eine Vorlage erstellen

1, -1, -2, -3, -5, -6

system/save-module-inputs

1, -6, -9

Statustext

output/status-text beginnt immer mit ok: oder error: und nennt den Grund in Worten. Er wird zur selben Zeit wie der Statuscode geschrieben, sodass beide immer übereinstimmen.

Jede Operation hat ihr eigenes Knotenpaar, und die Werte bleiben erhalten, bis diese Operation erneut ausgeführt wird. Eine fehlgeschlagene Vorlagenerstellung stört daher nicht das Ergebnis der letzten Suche.