Connecting machines
Your machines send their data to the Smart Operations Toolkit through one HTTPS interface, the machine data API. A machine, an edge device or a connector sends:
-
measured values, for example temperatures or rotation speeds, which are shown in the Measurement Chart and watched by rules,
-
process data, for example the curve and the result of a tightening, which are shown in the Process Analysis.
Data flow
-
The client sends a message.
-
The Smart Operations Toolkit checks the request, stores the message durably and answers with
202 Accepted. -
The data are processed asynchronously. They are usually visible in the user interface after a few seconds.
Mapping to your configuration
The Smart Operations Toolkit assigns the data with the following fields:
| Message field | Must match in the configuration |
|---|---|
|
Technical ID of the device. See Creating a device. |
Name of the measured value ( |
Name of a measuring point of the device. See Measuring points. |
| Create the device and its measuring points before the machine sends data. Data with an unknown technical ID or an unknown measuring point name are not shown in the user interface. |
Sending measured values
Endpoint, headers and message format for measured values.
Maschinen anbinden
Die Maschinen senden ihre Daten über eine HTTPS-Schnittstelle an das Smart Operations Toolkit, die Maschinendaten-API. Eine Maschine, ein Edge-Gerät oder ein Konnektor sendet:
-
Messwerte, zum Beispiel Temperaturen oder Drehzahlen. Sie erscheinen im Messwerte Diagramm und werden von Regeln überwacht.
-
Prozessdaten, zum Beispiel Kurve und Ergebnis einer Verschraubung. Sie erscheinen in der Prozessanalyse.
Datenfluss
-
Der Client sendet eine Nachricht.
-
Das Smart Operations Toolkit prüft die Anfrage, speichert die Nachricht dauerhaft und antwortet mit
202 Accepted. -
Die Verarbeitung der Daten erfolgt asynchron. In der Regel sind die Daten nach wenigen Sekunden in der Benutzeroberfläche sichtbar.
Zuordnung zur Konfiguration
Das Smart Operations Toolkit ordnet die Daten über folgende Felder zu:
| Feld der Nachricht | Muss in der Konfiguration übereinstimmen mit |
|---|---|
|
Technische ID (Technical ID) des Geräts. Siehe Gerät anlegen. |
Name des Messwerts ( |
Name eines Messpunkts des Geräts. Siehe Messpunkte. |
| Gerät und Messpunkte anlegen, bevor die Maschine Daten sendet. Daten mit unbekannter technischer ID oder unbekanntem Messpunktnamen erscheinen nicht in der Benutzeroberfläche. |
Antworten und Fehlerbehebung
Statuscodes, Fehler und passende Maßnahmen.