Diese Seite beschreibt Zweck und Inhalt der PlantX Agent API, die nicht nach dem REST-Prinzip implementiert ist. Die technische Dokumentation zu Architektur und Funktionalität der Agent API finden Sie auf der angehängten Referenzseite V8 Agent-Grundlagen von Q Plant. Die technische Dokumentation der Datenobjekte dieser Schnittstelle finden Sie auf der angehängten Referenzseite V8 Agent API Reference PlantX.

Zweck

Die PlantX Agent API ist eine Agent-Schnittstelle für Mischanlagen oder Wiegesysteme, welche Daten der genannten Systeme an eine Instanz von Q Plant übermitteln. Dort können diese Daten gesammelt, aggregiert und ausgewertet werden, um so Informationen über laufenden Betrieb und allfälliges Optimierungspotential zu gewinnen.

Quelle

Bitte wenden Sie sich an den Q Point Support, um die PlantX Agent Applikation sowie den access key für deren Einsatz zu erhalten.

Ressourcen

Unten sind alle Ressourcen gelistet, die über die PlantX Agent Schnittstelle übermittelt werden können. Die Ressourcen werden hier inhaltlich beschrieben. Eine technische Beschreibung dieser Ressourcen mit allen Details wie Feldern, Abhängigkeiten und Regeln der Übertragung findet sich auf der entsprechenden /wiki/spaces/~829548211/pages/122978375.

Mischanlagen

Sobald die Schnittstelle in Betrieb genommen wurde, kann der Datensatz der Mischanlage, auf deren Rechner der Agent installiert ist, einmalig hochgeladen werden. Später ist jederzeit ein Update dieser Daten möglich.

Materialkomponenten

Materialkomponenten sind Bestandteile, aus denen sich Mischrezepte zusammen setzen. Sie können als Stammdatensätze mit ID, Name und Typ an Q Plant übertragen werden.

Mischrezepte

Ein Mischrezept entspricht einer Anleitung, wie Mischgut einer bestimmten Sorte herzustellen ist. Dieses Rezept umfasst Komponenten sowie Informationen darüber, wann welche Menge der Komponente jeweils beigemischt wird.

Asphaltproduktionen

Es können Daten zu Asphaltproduktionen übermittelt werden. Eine Asphaltproduktion ist die Herstellung einer bestimmten Menge Mischgut in mehreren Chargen. Hierzu gehören einerseits allgemeine Produktionsdaten als auch Daten über die einzelnen Produktionschargen - letztere inklusive des angewendeten Rezepts und der darin enthaltenen Komponenten.

Ladetickets und Lieferscheine

Ein Ladeticket enthält alle geplanten Daten einer Mischgutverladung, während der anschliessend ausgestellte Lieferschein die Ist-Daten der Verladung enthält. Im Kontext des Lieferscheins werden zudem weitere Ressourcen wie Kunde, Baustelle, Fahrzeug, Artikel oder Wiegedaten übermittelt.

Betriebsdaten

Ein Betriebsdatum ist der Messwert eines Sensors auf der Anlage, oder eine aus Messwerten errechnete Kennzahl. Auch Betriebsdaten können im grossen Umfang an Q Plant übermittelt werden, um dort ausgewertet zu werden.