Tabellarische Auflistung aller JSON-Attribute einer RAP-Datei (Compact)

BASE Basisgerät; muss als erstes positioniert werden

LEFT Gerät kann nur LINKS vom Basisgerät positioniert werden

RIGHT Gerät kann nur RECHTS vom Basisgerät positioniert werden

LEFT_EDGE Gerät muss als als LINKES Abschlussgerät positioniert werden

RIGHT_EDGE Gerät muss als RECHTES Abschlussgerät positioniert werden

LEFT_RIGHT Gerät kann LINKS oder RECHTS vom Basisgerät positioniert werden

RIGHT_LEFT Gerät kann LINKS oder RECHTS vom Basisgerät positioniert werden

VIRTUAL Virtuelles Gerät – wir automatisches nach rechts in den virtuellen Gerätebereich plaziert

“range”:{
“type”: “tooltip_loop”,
“values”: [0,1,1]
}

Verfügbare type/values Kombinationen, siehe E.3.1 bis E.3.3

Erzeugt ein Dropdown-Feld mit Werten von 0 bis 10 in Schrittweite 1.5 (also: 0, 1.5, 3, 4.5, 6 … etc.)

list

“values”: [
“M01|1”,
“M02|2”,
“M03|3”
]

Die Einträge vor dem „|“ Symbol werden als lesbarer Text im Dropdown Feld angezeigt, die Einträge hinter dem „|“ Symbol werden als eigentlicher Arbeitswert exportiert

Hinweis: Bereich und Typ des Attributs werden in den Tags redundant zur einfacheren und performanteren Verarbeitung der RAP Datei abgelegt. SIE DÜRFEN NICHT IM WIDERSPRUCH ZUR DEN TECHNISCHEN Bereich/Typ ANGABEN SEIN!

weder Name noch Wert des Attributs editierbar
Wert des Attributs ist editierbar
Name des Attributs ist editierbar
sowohl Name als auch Wert des Attributs sind editierbar

Werte-Zeile wird in der Edit-Tabelle nicht dargestellt (für konstante, nicht änderbare Werte, die dem Anwender nicht angezeigt werden sollen)

“name”: “Input01”,
“type”:“WORD“,
“offset”: 0,
:
“name“: “Input02”,
“type“:“BYTE“,
“offset“: 2

Input01 belegt als WORD-Wert die Bytes 0 und 1; der Offset von Input02 beginnt deshalb bei Byte 2 … etc.

“name”: “Input01”,
“multi”: 3

… erzeugt Attribute Input01_1 bis Input01_3

WICHTIG:

Ist kein multi Wert enthalten wird als Standard der Wert 1 angenommen

ist bei BOOL Werten kein ‚multi‘ Wert definiert wir beim Einlesen von RAP-Dateien intern der multi-Wert automatisch fix auf ‚8‘ gesetzt, um sie auf Byte-Grenzen zu setzen. Ein in der Datei vorhandener ‚multi‘ Wert überschreibt diesen Automatismus – hier ist darauf zu achten, grundsätzlich nur Vielfache von ‚8‘ zu definieren!

“variants”: [
{
“id”: “Variante 001”,
“isDefault”: true,
“data”: [
:
:

Die Varianten „id“ wird in zukünftigen Versionen von ‚PiCtory‘ zur Varianten-Auswahl angezeigt. Hier sollte ein sprechender Text eingetragen werden, der EINDEUTIG sein muss.

„isDefault“ gibt die nach dem Einlesen der RAP-Datei in ‚PiCtory‘ voreingestellte Variante an. Bitte hier auf ggf. definierte ‚rules‘ achten und diese beim Setzen von ‚isDefault‘ berücksichtigen. ‚PiCtory‘ wendet die ‚rules‘ aktuell nur bei manueller Änderung der Variante durch den Anwender an und kann Widersprüche bei ‚isDefault‘ Einträge nicht selbst auflösen!

Innerhalb des „data“ Arrays erfolgt dann wieder die ‚normale‘ Erfassung der einzelnen Input / Output Attribute, wie sie auch ohne Varianten durchgeführt würde.

BITTE BEACHTEN: durch die Verwendung von Varianten ändert sich der Typ eines Input / Output-Eintrags von Array zu Objekt (eckige klammer zu geschweifter Klammer), d.h. von

“input”: [ …

zu

“input”: { …

Beispiel:
Arbeitswert: “lang_input”:”8″

Internationalisierungs-Bereich

“lang”:{
{
“de”: {
“input”: “Eingang”,
“output”: “Ausgang”
},
“en”: {
“input”: “Input”,
“output”: “Output”
}
}
}

Rendering im Werteeditor bei Deutscher Spracheinstellung:

Eingang: 8

“rules”: {
“IO”: [
{
“sync” : [0,0]
},
{
“sync” : [1,1]
}
]
}

In diesem Beispiel sind die 0.te Input und die 0.te Output-Variante, sowie die 1.te Input und die 1.te Output-Variante verknüft. Ändert der Anwender also den Input auf Variante 1 stellt ‚PiCtory‘ automatisch auch den Output auf Variante 1 um. Wird Output anschliessend auf 0 zurück gestellt, springt auch Input auf 0 zurück.

“input”:
{
“include”:”[Pfad zur Include-Datei]”
}

Folgendes ist hier zu beachten:
Der Pfad zur Include Datei muss physikalisch und Rechte-bezogen so definiert sein, dass er von einem Ajax-Zugriff erreicht werden kann (User-Kontext des Webservers)

Der Inhalt der Include-Datei muss im JSON-Format vorliegen; er ERSETZT den „input“ Objekt-Block {} komplett, d.h. er wird NICHT nur IN den Objekt-Block an die Stelle des „include“-Eintrags eingefügt. Dies bedeutet, dass die include-Datei für einen normalen (nicht-Varianten) Inhalt die eckigen Klammern des Arrays enthalten muss, Beispiel:

[
{
“name”: “RevPiLED”,
“type”: “BYTE”,
“offset”: 1,
:
:

Und im Fall einer Varianten-Definition entsprechend so aussehen muss:

{
“variants”: [
{
“id”: “001”,
“isDefault”: true,
:
: