Statuscodes und Ergebnisse
Zwei Arten von Antworten teilen einem Client mit, was geschehen ist:
-
das Ergebnis eines Aufrufs - ist der Schreibvorgang oder Methodenaufruf durchgegangen? -, siehe Ergebnisse eines Methodenaufrufs;
-
der Status, den die App in einen Knoten schreibt - war die Operation erfolgreich? -, siehe Modulstatus:
control/status/codeund Ausführungsstatus der Finder.
Verwenden Sie in der Programmlogik die Zahlen, niemals die Texte.
Modulstatus: control/status/code
Cam Driver, AI Object Matching und Calibration melden den Zustand jedes Moduls auf
<module>/control/status/code (int32) und control/status/text. Werte ab 0 sind normal, Werte unter 0 sind
Fehler.
| Code | Text | Bedeutung |
|---|---|---|
|
|
die letzte Funktion war erfolgreich; bereit für die nächste |
|
|
das Modul startet |
|
|
eine Funktion läuft |
|
|
wartet auf den Client, meist darauf, dass |
|
|
kein spezifischer Code |
|
|
die Einstellungen konnten nicht geladen werden |
|
|
eine Eingabe ist ungültig |
|
|
die Lizenz fehlt |
|
|
die Einstellungen wurden über |
App-spezifische Codes, aufgeführt im Handbuch der jeweiligen App:
| App | Codes |
|---|---|
Cam Driver |
|
Calibration |
|
AI Object Matching |
|
Ausführungsstatus der Finder
Template Finder, Object Finder, Area Detector und Text Reader schreiben den Ausgang jeder Methode auf
<method>/output/status-code (int16) und status-text. Diese Werte sind eigene, nicht der obige
Modulstatus:
| Code | Text |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Beachten Sie, dass -5 hier cropInvalid bedeutet, im Modulstatus dagegen restartRequired.
Ergebnisse eines Methodenaufrufs
Ein Schreibvorgang auf einen execute-Knoten meldet, ob die Operation ausgeführt werden konnte. Die Namen
unterscheiden sich zwischen den Data Layern; die Bedeutung ist dieselbe.
| LumiScan Keryx | ctrlX Data Layer | OPC UA Connector | Bedeutung und Vorgehen |
|---|---|---|---|
|
|
|
Die Operation wurde ausgeführt. Bei Cam Driver, AI Object Matching und Calibration lesen Sie für den Ausgang
|
|
|
|
Eine andere Operation des Moduls läuft. Wiederholen Sie den Aufruf |
|
|
|
Die Funktion ist nicht bereit: Ihr |
|
|
|
Die App wird beendet, ein Neustart ist erforderlich (Status |
|
|
|
Eine Eingabe ist ungültig. Nichts wurde geändert. Korrigieren Sie die Eingabe |
|
|
|
Ein Bild, eine Quelle, ein Modul oder der Knoten selbst wurde nicht gefunden. Prüfen Sie die Adresse und ihre Groß-/Kleinschreibung |
|
|
|
Etwas konnte nicht geschrieben oder angelegt werden: eine Datei, ein bereits vorhandenes Modul, eine nicht verfügbare Lizenz. Das Log nennt den Grund |
|
|
|
Die Operation ist fehlgeschlagen. Lesen Sie den Status oder das Log |
Auf dem ctrlX Data Layer erreichen Daten, die eine Methode an einen fehlgeschlagenen Aufruf anhängt, den Client nicht; ein abgelehnter Aufruf enthält daher keinen Grund. Die Apps schreiben den Grund deshalb in ihr Log und, wo vorhanden, in einen Statusknoten.