"%ProgramFiles%\Traeger\Codabix\codabix-ui.exe"
Sie können die Webkonfiguration auch in Ihrem eigenen Browser anzeigen (z.B. Edge, Chrome, Firefox, Safari). Standardmäßig verwendet Codabix ein lokales HTTP-Binding (Standardport 8181), somit können Sie folgende URL verwenden:
http://localhost:8181/config/
Beispiel:
Beachten Sie: Wenn Sie auf die Codabix Webkonfiguration von einem entfernten Rechner aus zugreifen möchten, muss in den Codabix Settings ein Remote-HTTP-Binding hinzugefügt werden (bei Codabix für Linux ist dies standardmäßig der Fall).
Um auf Codabix mit einem Browser von einem entfernten Rechner zuzugreifen können Sie folgende URL verwenden:
http://<hostname>:<port>/config/
Diese Toolbar ist nur sichtbar, wenn Sie die Codabix Applikation zur Konfiguration verwenden. Diese Leiste bezieht sich also nur auf die Codabix Applikation.
Icon | Beschreibung |
---|
Öffnet den Lizenzdialog, in dem Sie die Lizenz eingeben, ändern oder löschen können | |
Öffnet den Lizenzdialog, in dem Sie die Plugin Lizenz eingeben, ändern oder löschen können | |
Siehe Codabix Projekteinstellungen | |
Backup erstellen, siehe Codabix Projekteinstellungen | |
Restore Backup, siehe Codabix Projekteinstellungen | |
Zeigt alle Informationen der Lizenz und Anwendung |
Lizenzdialog
Feld | Beschreibung |
---|---|
License Code: | Geben Sie hier Ihren Lizenzschlüssel ein |
Remove License | Entfernt die Lizenz vom Computer |
Copy Machine Code | Kopiert den Maschinencode in die Zwischenablage. Dieser wird für die Lizenzerstellung benötigt. |
OK | Die eingegebene Lizenz wird auf den Computer gespeichert. Wenn dieses Feld ausgegraut ist, wurde kein gültiger Lizenzschlüssel eingegeben. |
Über
Linker Bereich: Informationen der Anwendung
Rechter Bereich: Informationen zur aktuell installierten Lizenz
Der Arbeitsbereich besteht aus einem eingebetteten Webbrowser (rote Umrandung).
Dieser Bereich unterteilt sich, je nach Menüwahl, in 3-4 Bereiche.
In der Titelleiste sind folgende Aktionen möglich und werden folgende Daten angezeigt:
Feld | Beschreibung |
---|---|
Öffnet und schließt das Menü | |
Anzeige des aktuell ausgewählten Menüs | |
Anzeige des eingeloggten Benutzers |
Unterhalb der Titelleiste befindet Sie die Toolbar. Diese wird automatisch angepasst, je nachdem, in welchem Menü Sie sich befinden und welches Item Sie ausgewählt haben.
Foldernode:
Datenpunktode:
Benutzer:
Benutzergruppe:
Script Plugins:
Allgemeines:
Ausgegraute Icons sind für das ausgewählte Item nicht anwendbar.
Icon | Beschreibung | Sichtbar in |
---|---|---|
Ansicht auffrischen | alle Menüs | |
Codabix Folder Node | Folder Node, Datenpunkt Node | |
Codabix Datenpunkt Node | Folder Node, Datenpunkt Node | |
Codabix - verlinkte Folder Node | Folder Node, Datenpunkt Node | |
Codabix - verlinkte Datenpunkt Node | Folder Node, Datenpunkt Node | |
Alle Icons mit diesem Symbol fügen ein neues Item anhand eines Eingabedialoges hinzu | Folder Node, Datenpunkt Node, Benutzer, Benutzergruppe, Script Plugins | |
Ausgewähltes Item löschen | Folder Node, Datenpunkt Node, Benutzer, Benutzergruppe, Script Plugins | |
Aktion abbrechen | Datenpunkt Node, Benutzer, Benutzergruppe, Script Plugins | |
Speichert den bearbeiteten Datensatz bzw. Datensätze | Datenpunkt Node, Benutzer, Benutzergruppe, Script Plugins | |
Zugriff auf den selektierte Folder Node oder Datenpunkt Node | Folder Node, Datenpunkt Node | |
Ausgewähltes Item editieren | Datenpunkt Node, Benutzer, Benutzergruppe, Script Plugins | |
Benutzer hinzufügen oder entfernen | Benutzergruppe | |
Folder Node oder Datenpunkt Node hinzufügen oder abwählen | Benutzergruppe | |
Die Benutzergruppe für das ausgewählte Item setzen oder abwählen | Folder Node, Datenpunkt Node | |
Link erstellen oder entfernen | Folder Node, Datenpunkt Node | |
Dupliziert das ausgewählte Item | Folder Node, Datenpunkt Node | |
Bei Klick auf ein Folder Node werden alle Werte der Datenpunkt Nodes geupdatet. Ist ein Datenpunkt Node ausgewählt, wird nur dieser Wert geupdated | Folder Node, Datenpunkt Node | |
Datenpunkt Node Wert setzen | Datenpunkt Node | |
Wenn verfügbar, werden die historischen Daten des Datenpunkt Nodes angezeigt | Datenpunkt Node | |
Script bearbeiten | Script Plugin | |
Loganzeige des ausgewählten Scripts | Script Plugin |
Standardmäßig wird das Menü fest angezeigt.
Feld | Beschreibung |
---|---|
Nodes | Aktuelle Startseite. Folder Nodes und Datenpunkt Nodes bearbeiten |
Users | Benutzer bearbeiten |
Usergroups | Benutzergruppen bearbeiten |
Script Plugins | Leichtgewichtiges JavaScript(TypeScript)-Plugin, dass Codabix um benutzerdefinierte Funktionen erweitert. Wird in einer sicheren Umgebung ausgeführt. |
Newest History Values | Ansicht der zuletzt eingetragenen, historisch abgelegten Werte. Daten werden nur angezeigt, wenn ein Folder oder Datenpunkt Node die Speicherung von historischen Daten aktiviert hat. |
About | Informationen über die Konfigurationsseite und gegebenenfalls Codabix |
Logout | Benutzer abmelden |
Hier werden die verfügbaren Folder Nodes in einer Baumstruktur dargestellt.
Aufbau des Node Baumes:
Node | Beschreibung | Zweck |
---|---|---|
System | System Nodes | Enthält alle Nodes die für den Betrieb von Codabix nötig sind. Die meisten Nodes und Variablen sind hier nicht editierbar. Fixe Folder Nodes sind: -System -Device -Plugins -Settings -Status -Channels -Variables -Control |
Device | Device Nodes | Enthält alle Nodes der bei Codabix registrierten Devices. |
S7 TCP-IP Device | S7-Device Plugin Container | Enthält alle Daten des Plugins, die für Codabix und den Anwender benötigt werden, z.B. Status, Channels, usw. |
Settings | Einstellungen des Plugins | Mögliche Einstellungen des Devices |
Status | Status des Plugins | Zeigt allgemeine Informationen zum Plugin an, z.B. Fehler, Plugin gestartet |
Channels | Node für alle Kanäle | Enthält alle definierten Kanäle des Plugins |
Channel z.B. Rotating Cutter - 1 | Definierter Kanal im Plugin | Enthält - die allgemeinen Einstellungen des Kanals - den Status des Kanals - alle definierten Datenpunkt Nodes |
Plugin | Plugin Nodes | Sammelnode für alle Plugins, ähnlich wie Devices |
Nodes | Sammelnode für benutzerdefinerte Nodes | Enthält alle Nodes und Variablen, die der Benutzer definiert hat |
Nummer | Beschreibung |
---|---|
1 | Hier werden die Daten des ausgewählten Menüs bzw. des Folder Nodes dargestellt |
2 | Navigationsleiste, hier schalten Sie die Ansichten der jeweiligen Daten durch. Mögliche Navigation: Seitenanfang eine Seite zurück eine Seite vor Seitenende |
3 | Anzahl aller Datensätze |
Codabix ist ähnlich aufgebaut wie in OPC UA spezifiziert. Je nach Node Typ hat ein Node unterschiedliche Funktionen und Eigenschaften.
Es wird unterschieden zwischen:
Einen Folder Node kann man auch als Knoten bezeichnen, da er weitere Folder oder Datenpunktnodes enthält, aber selbst keinen Wert bereitstellen darf.
Eingestellte Eigenschaften werden automatisch auf die Child Nodes angewendet, außer diese definieren eine eigene Eigenschaft.
Der Datenpunktnode ist im Codabix wie eine Variable mit zusätzlichen Attributen (Properties).
Ein Datenpunktnode darf keine Child Nodes enthalten.
Link Nodes besitzen nur die gemeinsamen Properties.
Ein Link Node zeigt auf einen anderen, bereits angelegten Node. So ist es möglich, sich aus verschiedenen Devices, Foldern und Datenpunktnodes einen individuellen Datensatz zusammenzubauen.
Der Directory Node ist ein Folder Node, der aber direkt auf ein physikalisches Verzeichnis zeigt und die Unterstruktur automatisch repräsentiert.
Name | Beschreibung | Datentyp |
---|---|---|
Lokale ID | Eindeutiger ID im Codabix System wird z.B. beim Zugriff über das REST-Interface benutzt | Long |
Global ID | Eindeutige Codabix-übergreifende ID | GUID |
Name | eindeutiger Name innerhalb des Parent Nodes für z.B. die OPC UA-Adressierung, JSON-Interface z.B. JobNumber | String |
Display Name | Anzeigename für den Endanwender z.B. Job Nummer | String |
Path | z.B.: SPS-Adresse (nach S7-Syntax, DB1000.DBB 500, Word) OPC UA Node (3:AirConditioner_1.State) Dateipfad (R:\\MachineData) HINWEIS: Bei Typ Folder wird der Pfad nicht behandelt | String |
Max Value Age (ms) | Relevant für einen synchronen Lesevorgang. Wenn ein synchroner Lesevorgang keine Time to live angibt, wird anstelle dessen dieser Wert (in Millisekunden) benutzt. Das bedeutet, falls der derzeit gesetzte Nodewert nicht älter als diese Zeitangabe ist, wird er direkt zurückgegeben; ansonsten wird der Wert aus dem Device gelesen. | Integer |
Wenn Sie einen Folder Node anlegen, können Sie entscheiden zwischen den Typen:
Typ: Folder
Der Node ist ein regulärer Folder Node mit keinen besonderen zusätzlichen Eigenschaften.
Typ: Directory
Der Node ist ein Folder Node und repräsentiert ein physisches Verzeichnis im Dateisystem. Die Path-Eigenschaft des Nodes gibt den Verzeichnispfad an (dieser kann Umgebungsvariablen enthalten). Beim Browsen des Nodes (z.B. über die Webkonfiguration) werden Unterverzeichnisse und Dateien automatisch als entsprechende Folder Nodes (Typ Directory) sowie Datapoint Nodes (Typ File) mit dem zugehörigen Dateipfad in der Path-Eigenschaft erstellt und abgeglichen.
Hinweis: Der angegebene Pfad unterliegt den Einschränkungen der Access Security, die in den Codabix Projekteinstellungen definiert wurden.
Hinweis: Unter Windows 10 Version 1511 und älter (sowie Windows Server 2012 R2 und älter), z.B. unter Windows 7, ist die maximale Pfadlänge auf 260 Zeichen (MAX_PATH
) begrenzt. Unter Windows 10 Version 1607 und höher (sowie Windows Server 2016 und höher) können Sie längere Pfade benutzen. Dazu müssen Sie jedoch erst die Einstellung „Lange Win32-Pfade aktivieren“ in den Windows-Gruppenrichtlinien aktivieren, siehe Enabling Win32 Long Path Support.
Zusätzlich zu den oben erwähnten gemeinsamen Eigenschaften besitzt der Datenpunktnode noch folgende Eigenschaften:
Name | Beschreibung | Datentyp |
---|---|---|
Description | Beschreibung des Datenpunktes | String |
Location | Wird bei der Auswertung von Conditions verwendet. Dient zur Anzeige z.B. des Ursprungs der Meldung. Beliebig vergebbar | String |
Value Types | Datentyp des Nodes, weitere Informationen siehe unterhalb Tabelle Value Types | enum |
Min Value | Minimaler Wert, wird für die Auswertung von Conditions benötigt | Double |
Max Value | Maximaler Wert, wird für die Auswertung von Conditions benötigt | Double |
Hysteresis | Schwellenwert der bei der Auswertung von Conditions verwendet wird, wenn z.B. kleinere Temparaturschwankungen ausgeglichen werden sollen. | Double |
Scaling Factor | Faktor, der auf den aktuell gelesenen Wert aufgerechnet wird | Double |
Scaling Offset | Wert, der auf den aktuell gelesenen Wert addiert wird | Double |
Unit | Einheit des Wertes z.B. °C | String |
Precision | Anzahl der Nachkommastellen | Zahl |
History Options | Gibt an, wie für diesen Node historische Werte erfasst und in die Datenbank geschrieben werden sollen. No: Es werden keine historischen Werte für diesen Node erfasst. Yes; only on Value Change: Wenn für den Node ein History Interval festgelegt ist, werden historische Werte regelmäßig vom History Timer aus dem Istwert im angegebenen History-Intervall erfasst; ansonsten werden historische Wert beim Schreiben eines Werts in den Node erfasst. Ein erfasster historischer Wert wird nur dann in die Datenbank geschrieben, wenn dieser sich vom zuletzt geschriebenen historischen Wert dieses Nodes unterscheidet. Zusätzlich wird im Falle einer Device-Variablen eine Subscription für diesen Node erstellt. Yes: Wenn für den Node ein History Interval festgelegt ist, werden historische Werte regelmäßig vom History Timer aus dem Istwert im angegebenen History-Intervall erfasst; ansonsten werden historische Wert beim Schreiben eines Werts in den Node erfasst. Erfasste historische Werte werden in die Datenbank geschrieben. Zusätzlich wird im Falle einer Device-Variablen eine Subscription für diesen Node erstellt. | enum |
History Interval | Gibt das Intervall an, in dem historische Daten erfasst werden sollen. | Enum |
History Resolution | Gibt die Auflösung an, auf die numerische historische Werte beim Erfassen gerundet werden. | Double |
Beachten Sie:
Value
und Status
verwendet, nicht jedoch der Timestamp
(CreationTimestamp).codabix.NodeHistoryOptions.Subscription | codabix.NodeHistoryOptions.ValueChange
(enthält codabix.NodeHistoryOptions.Active
), und die Einstellung Yes entspricht dem Wert codabix.NodeHistoryOptions.Subscription
(enthält codabix.NodeHistoryOptions.Active
).
Codabix stellt folgende Werttypen bereit:
Name | entspricht Datentyp | Länge in Bits |
---|---|---|
Blob | binär, optional Angabe von Dateiname und MIME-Typ möglich | beliebig |
String | String | beliebig |
Null | ohne Wert | 0 |
Boolean | Bool | 1 |
SByte | signed Byte | 8 |
Byte | unsigend Byte | 8 |
Int16 | signed Integer | 16 |
UInt16 | unsigned Integer | 16 |
Int32 | signed Integer | 32 |
UInt32 | unsinged Integer | 32 |
Int64 | signed Integer | 64 |
UInt64 | unsigned Integer | 64 |
Single | single Floating Point | 32 |
Double | double Floating Point | 64 |
File | Der Node repräsentiert eine physische Datei, auf die mittels OPC UA Client oder per HTTP Access URL zugegriffen werden kann. Die „Path“-Eigenschaft des Nodes enthält den Dateipfad. Hinweis: Der angegebene Pfad unterliegt den Einschränkungen der Access Security, die in den Codabix Projekteinstellungen definiert wurden. |
Von jedem Datentyp kann auch ein Array erstellt werden. Ausnahmen sind die Datentypen:
Die Länge des Arrays wird beim Schreiben des Datenpunktnodes bestimmt.
Feld | Beschreibung |
---|---|
Name | intern eindeutiger Name des Foldernodes |
Display Name | Anzeigename des Nodes |
Description | Beschreibung zum Node |
Value Type | Datentyp bzw. -art des Nodes. Siehe Eigenschaften |
Path | z.B. SPS-Adresse, OPC-Node, Dateipfad zum Node. Siehe Eigenschaften |
Actual Value | Wert nach Klick auf . Es werden keine Livedaten automatisch angezeigt. Siehe (4) Toolbar |
Status | Aktueller Status des Nodes. Mögliche Stati: - Good - Bad |
Status bei Device:
Unter System / Devices / Device Plugin / Channels / Channel / Status finden Sie den Status für den einzelnen Kanal mit der dazugehörigen Meldung.
Bei einem Code >= 0 läuft der Kanal ok.
Systemnodes sind fest vorgegebene Strukturen, die für den Betrieb von Codabix und dessen Plugins nötig sind.
Benutzernodes werden vom Benutzer nach seinen Bedürfnissen angelegt und verwaltet.
Aufbau Systemnodes:
Aufbau Benutzernodes:
Siehe auch (6) Node Tree.
Folder oder Directory Nodes hinzufügen | |
Datenpunktnode hinzufügen |
Damit Sie die Unterordner und Dateien angezeigt bekommen, müssen Sie die Ansicht auffrischen, z.B. durch Klick auf „User“ und wieder zurück auf „Nodes“. Je nach Verzeichnisgröße kann es vorkommen, dass Sie nicht sofort alle Dateien und Untervezeichnisse sehen. |
* Name eingeben z.B. Pressure (bar)
Z.B. könnte die Node wie folgt aussehen:
verlinkter Folder Node | |
verlinkter Datenpunktnode |
Wird auf einen Datenpunktnode einn Folder Node verlinkt, wird dieser automatisch zum Folder Node umgewandelt.
Feld | Beschreibung |
---|---|
Local ID | Eindeutiger, Codabix-interner ID des ausgewählten Items. Siehe Abkürzungen / Glossar |
Global ID | Der GUID identifiziert den Node eindeutig über das System hinaus, z.B. Einsatz von Codabix an mehreren Standorten, die zusammen einen Datensatz bilden sollen. Abbkürzungen / Glossar |
Absolute Node Path | Pfad für den Zugriff auf den Node. Bei verlinkten Datenpunkten wird die Pfadanzeige zum Ursprung des Datenpunktes angezeigt. |
Token | Verhält sich wie ein Passwort für JSON, um Zugriff auf den Node zu erhalten. |
Access URL | Aktuellen Wert (Actual Value) über http direkt auslesen und in einem Browser anzeigen. |
Bei ausgewählten Folder Nodes erben automatisch alle darunter liegenden Nodes die Benutzergruppe.
Die Benutzergruppe wird nicht in den darunterliegenden Nodes angezeigt, wenn Sie auf klicken.
Somit haben Sie die Möglichkeit, einem bestimmten Folder bzw. Datenpunktnode explizit die Benutzergruppe zu setzten, falls z.B. dem übergeordneten Node der Zugriff für die Gruppe entzogen wird.
Alle bereits ausgewählten Folder und Datenpunktnodes werden per Haken angezeigt. Wenn Sie einen Folder Node auswählen, werden automatisch alle darunter liegenden Nodes mit aus- bzw. abgewählt.
Funktionen:
Feld | Beschreibung |
---|---|
First Name | Vorname |
Last Name | Nachname |
Login Email | Email-Adresse: Darf nur einmal vorkommen |
Phone Number | Telefonnummer: Darf nur einmal vorkommen |
Login Password | Passwort mit Wiederholung |
Es gelten dieselben Einstellungen wie bei Benutzer hinzufügen.
Funktionen:
Feld | Beschreibung |
---|---|
Name | Anzeigename der Gruppe |
Type | A oder B, aktuell nicht benutzt |
Im Moment wird der Benutzertyp nicht verwendet.
Es gelten dieselben Einstellungen wie bei Benutzergruppe hinzufügen.
Es gibt zwei Möglichkeiten einem Benutzer zur Benutzergruppe hinzuzufügen:
Über das Benutzermenü:
Folgender Dialog wird für das ausgewählte Item angezeigt:
Hier können Sie die Benuztergruppe(n) für das ausgewählte Item hinzufügen oder abwählen.
Über die Benutzergruppe:
Bei Klick auf das Benutzericon wird für die selektierte Benutzergruppe folgender Dialog angezeigt:
Alle verfügbaren Benutzer können hier an- bzw. abgewählt werden.
Alle Device Plugins verwenden das Codabix Device Model. Jedes Gerät das zur Verfügung gestellt wird, wird vom Codabix Device Manager registriert und verwaltet.
Siehe Device Plugins.
S7 Device
Verbindung zur Siemens SIMATIC S7.
Siehe S7 Device Plugin.
Alle Exchange Plugins benutzen das Codabix Storage Model. Jedes Exchange Plugin, das bereitgestellt wird, wird vom Codabix Storage Manager registriert und verwaltet.
Siehe Exchange Plugins.
Datenbank
Codabix unterstützt die Verbindung zu Datenbanken.
Weiteres finden Sie unter Datenbank Plugin. \\
CSV
Weitere Informationen zum Handling mit CSV-Dateien finden Sie unter CSV Exchange Plugin.
Codabix enthält eine API-Schnittstelle.
Weiteres unter Interface Plugins.
REST
Die REST-Schnittstelle ermöglicht den Zugriff auf den Knoten Codabix via HTTP-Request formatiert als JSON-Objekt.
Weiteres unter REST Interface Plugin
Script Plugins
Script Plugins erweitern Codabix um weitere Funktionalitäten via JavaScript Editor. Sie werden in einer sicheren Umgebung ausgeführt.
Siehe Script Interface Plugin.
OPC UA Server Interface
Codabix enthält einen OPC UA Server zum Austausch der Daten.
Weiters unter OPC UA Server Interface Plugin.