Tabellarische Auflistung aller JSON-Attribute einer RAP-Datei.

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 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 – wird automatisch 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 STEHEN!

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.

Wertezeile 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, wird 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 Variantenauswahl 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ägen 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 der Output anschliessend auf 0 zurück gestellt, springt auch der Input auf 0 zurück.

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

Folgendes ist hier zu beachten:
Der Pfad zur Include-Datei muss physikalisch und rechtebezogen 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,
:
:

Im Fall einer Varianten-Definition muss sie entsprechend so aussehen:

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