Scriptfähige Integration

Ab Firmware 2026.10.30 kann OV Spark Pro Daten aus Ihrer Linie entgegennehmen, mit Ihrer eigenen Logik entscheiden und Ergebnisse in Ihrem eigenen Format ausgeben – alles auf der Kamera. Es gibt vier Bausteine, und die meisten Setups verwenden nur einen oder zwei davon:

Baustein	Was es ist	Code?
Variablen	Werte, die von außen kommen, etwa eine Serien- oder Losnummer von der SPS oder per MQTT. Jede Aufnahme speichert die Werte, mit denen sie lief	Nein
Rezept-Script	JavaScript im Beurteilungsschritt, das mit einer Begründung über OK/NG entscheidet, Metadaten und Tags hinzufügt und Ihre eigenen Bytes für die SPS schreibt	Ja
Kamera-Script	Ein kameraweites Script, das an MQTT publiziert, auf eingehende Nachrichten reagiert und Zähler sowie Alarme verwaltet	Ja
MQTT	Ein integrierter MQTT-Client. Sobald ein Broker eingerichtet ist, wird jedes Prüfergebnis publiziert, ganz ohne Script	Nein

Sie befinden sich unter Integration in der linken Navigation der Kamera: Variablen, Kamera-Script und Data Connectors. Das Rezept-Script liegt im Beurteilungsschritt jedes Rezepts.

Rezept-Script oder Kamera-Script

	Rezept-Script	Kamera-Script
Gehört zu	Einem Rezept und wird mit diesem exportiert	Der Kamera und läuft über Rezeptwechsel hinweg weiter
Läuft	Bei jeder Prüfung, nach den Tools und bevor die SPS das Ergebnis sieht	Wenn etwas passiert: ein Ergebnis, eine MQTT-Nachricht, eine Änderung der PLC User Data, ein Timer
Speicher	Kein zuverlässiger Speicher: Behandeln Sie jede Prüfung so, als begänne sie neu	Behält Zustand zwischen Ereignissen, bis es neu geladen wird
Zeitlimit	25 ms standardmäßig, bis zu 200 ms	1 Sekunde bis zum ersten await eines Hooks, danach 50 ms je weiterem Teil
Kann	OK/NG und Begründung setzen, PLC-User-Results-Bytes schreiben, Metadaten und Tags hinzufügen	An MQTT publizieren, Variablen setzen, Alarme auslösen, Timer ausführen
Kann nicht	Das Netzwerk nutzen, Zustand halten, Timer verwenden	Eine Beurteilung ändern, SPS-Bytes schreiben, eine abgeschlossene Aufnahme bearbeiten

Faustregel

Wenn die SPS es braucht, sobald Inspection Completed auf High geht, gehört es in das Rezept-Script. Wenn es über das Netzwerk geht oder sich etwas über Teile hinweg merken muss, gehört es in das Kamera-Script.

Die beiden sind über Variablen verbunden: Das Kamera-Script setzt eine Variable, das Rezept-Script liest sie, und der Wert wird mit der Aufnahme gespeichert – so sehen Sie jederzeit, worauf eine Entscheidung beruhte.

Typische Setups

Sie möchten	Verwenden Sie
Die Serien- oder Codenummer, die die SPS mit jedem Bild sendet, speichern	Eine Variable auf PLC User Data. Kein Code: Jede Aufnahme speichert sie, die Library zeigt sie an, und Remote-Speicher-Dateinamen können sie verwenden, z. B. {camera}/{var.lot} als Ordner und {var.serial}_{capture_id} als Dateiname
Das Teil gegen das von der SPS erwartete abgleichen	Ein Rezept-Script, das den OCR-Text oder Code mit der Serienvariable vergleicht und mit serial differs auf NG setzt. Dasselbe Prinzip funktioniert für eine Zählung gegen die Auftragsmenge
Daten aus MES oder einem anderen System übernehmen	Eine Variable, an ein MQTT-Topic und JSON-Feld gebunden, oder ein Kamera-Script, das ein Feld aus einer Herstellernachricht herauspickt und die Variable setzt
Einem Bediener die Eingabe der Losnummer ermöglichen	Setzen Sie die Variable manuell auf der Variablenseite. Aufnahmen, die einen manuell eingegebenen Wert verwendet haben, erhalten ein manuell-Kennzeichen. So testen Sie auch ein Script am Prüfplatz ohne SPS
Aufnahmen später nach Los oder nach ihrer Nähe zum Fehlerfall finden	Ein Rezept-Script, das Werte als Metadaten speichert und Aufnahmen mit Tags wie near-miss oder review versieht
Eigene Daten an die SPS senden	Ein Rezept-Script, das eine Zählung, ein Bit pro Region oder einen Code pro Tool mit pack() in User Results packt
Verschiedene Prüfungen je Modell ausführen	Die SPS sendet den Teiletyp; das Rezept-Script markiert andere Teiletypen als „nicht geprüft" oder schaltet eine Prüfung ein oder aus
Eigene Pass-Logik verwenden	Zum Beispiel OK, wenn mindestens 78 von 80 Regionen bestehen, oder den Namen des fehlerhaften Tools in die Begründung schreiben
Ein Teil nicht prüfen, wenn Daten fehlen oder veraltet sind	Ein Rezept-Script, das „nicht geprüft" zurückgibt, wenn die Seriennummer nicht eingetroffen ist oder der letzte SPS-Wert zu alt ist
Jedes Ergebnis publizieren	Nichts zu schreiben: Mit einem unter Data Connectors eingerichteten Broker gehen jedes Ergebnis und ein Heartbeat an MQTT. Für ein eigenes Topic oder Nachrichtenformat nutzen Sie das Kamera-Script
Die Linie überwachen	Ein Kamera-Script, das nach N aufeinanderfolgenden Ausschüssen einen Alarm auslöst, Pass- und Fail-Zählungen pro Schicht als CSV publiziert oder einen Heartbeat sendet
Anfragen über MQTT beantworten	Ein Kamera-Script, das Anfragen wie letztes Ergebnis oder Wert einer Variablen beantwortet

Jedes oben genannte Setup, das ein Script verwendet, hat eine vorgefertigte Vorlage in der Galerie Templates des Script-Editors.

Die Script-Werkbank

Beide Scripts werden im selben Editor auf der Kamera geschrieben, mit:

• Templates: funktionierende Beispiele für jede obige Aufgabe. Wählen Sie eines und ergänzen Sie das Tool oder die Variable, die es verwendet
• Autocomplete und ein Reference-Panel, das jeden Hook, jedes Global und jeden Typ mit kurzen Anleitungen dokumentiert
• Test gegen die Live-Kamera oder kürzlich erfolgte Aufnahmen, sodass Sie nicht mehr zwischen HMI und Script-Tab wechseln müssen
• History: Ihre letzten 20 gespeicherten Versionen zum Vergleichen oder Zurückgehen
• Test führt den Entwurf gegen einen Live-Trigger oder gespeicherte Aufnahmen aus (die neueste, die letzten N bis zu 500, einen Library-Filter oder Aufnahmenummern). Für das Kamera-Script ist es ein Dry Run, der kürzliche Ergebnisse wiedergibt, ohne etwas zu senden

Vor dem Speichern testen

Ein Rezept-Script, das einen Fehler auslöst oder die Zeit überschreitet, setzt das Teil auf nicht geprüft und nullt die PLC User Results. Führen Sie Test sowohl mit einem fehlerhaften als auch mit einem guten Teil aus, bevor Sie speichern, und halten Sie das Script kurz: Seine Zeit addiert sich zu jedem Zyklus.

Gut zu wissen

• Variablen, Scripts und MQTT-Einstellungen werden mit Rezept-Exporten übernommen. Passwörter und Zertifikate werden nicht exportiert: Wenn die Quelle Zugangsdaten verwendet hat, die das Ziel nicht hat, kommt MQTT deaktiviert an; andernfalls wird die Einstellung der Quelle beibehalten
• Die HTTP-API liefert Ergebnisse jetzt im selben Format wie MQTT und die Scripts. Wenn Sie gegen 2026.10.13 integriert haben, beachten Sie die Feldänderungen auf dieser Seite
• Noch nicht vorhanden: Auslösen einer Prüfung oder Umschalten von Rezepten aus dem Kamera-Script (das übernehmen weiterhin die SPS und HTTP), TCP und OPC-UA sowie ein HMI-Widget zum Anzeigen oder Setzen einer Variable

Weiterführende Themen

• Variablen
• Rezept-Script, mit einer Spielwiese, die Sie im Browser ausprobieren können
• Kamera-Script
• MQTT