FillParamTable.Config.json

Die FillParamTable.Config.json definiert die Details der einzelnen Einträge der erzeugten Tabelle. Hierbei wird innerhalb des Pakets eine Standarddatei verwendet. Sobald der FillParamTable Funktion eine Config.json-Datei übergeben wird, werden die übergebene Datei und die interne Datei zusammengeführt. Sollten Einträge in beiden Dateien existieren, wird der Eintrag der übergebenen Datei priorisiert.

Das Grundschema der Datei ist wie folgt aufgebaut:

{
    "$schema": "./TwinCAT.HMI.Plastic.Functions/Schema/FillParamTable.Config.Schema.json",
    "UnitMappings": {
        "Default": {…},
        "Trafo": {…},
        "UnitGroup": {…},
        "Fixed": {…},
        "…": {…}
    },
    "Localizations": {…},
    "ParamInfo": {
        "Default": {…},
        "…": {…}
    },
    "ReadOnly": {
        "Map": {…},
        "Conditions": {…},
    },
    "Enums": {
        "…": [{
            "id": 0,
            "text": "…",
            "value": "…"
        },…],…
    },
    "Filters": {
        "Default": […],
        "AxisUnitGroups": […],
        "ElectricalUnitGroups": […],
        "InverterExcludes": […],
        "HydraulicExclusive": […]
    },
    "AccessRights": {
        "…": [{
            "accesright": "…",
            "group": "…",
            "permission": "…"
        },…],…
    },
    "configVersion": "1.0.0.0"
}

Element	Beschreibung	Optional
`$schema`	Referenziert die Schema-Datei, mit der Code-Editoren ein unterstütztes Editieren der Datei ermöglichen.	Ja
`UnitMappings`	Ermöglicht die Zuweisung von Einheiten pro gefundenem Tabelleneintrag. Detaillierte Informationen zum Schema werden weiter erläutert.	Ja
`Localizations`	Leitet den Namen eines PLC-Elements auf einen abweichenden LocalizationKey um. Beispiel: `"LimitH": "LimitHigh"`	Ja
`ParamInfo`	Leitet die Beschreibungsinformationen eines Tabelleneintrags auf einen abweichenden Schlüssel um. Unter `Default` können standardisierte Umleitungen definiert werden, alle anderen Elemente werden mit den PLC-Instanzen abgeglichen.	Ja
`ReadOnly`	Definiert Tabelleneinträge die zwar in die PLC geschrieben werden können, aber nicht durch die Tabelle angepasst werden sollen. Über `Conditions` ist es außerdem möglich, eine bedingte Umschaltung eines Eintrags zu realisieren. Detaillierte Informationen zum Schema werden weiter erläutert.	Ja
`Enums`	Definiert Aufzählungen für die Verwendung einer Combobox, anstelle eines numerischen Eingabefelds. Die als Array zu übergebenden Elemente müssen nach dem Schema des TcHmi.Controls.Combobox.ListItem formatiert werden.	Ja
`Filters`	Definiert für die aufgeführten Einträge eine Auflistung von Tabelleneinträgen, die für bestimmte Umstände ignoriert bzw. gefiltert werden sollen. Immer ignorierte Elemente können unter `Default` abgelegt werden.	Ja
`AccessRights`	Definiert spezifische Zugriffsrechte der Benutzerverwaltung für einen Eintrag. Die als Array zu übergebenden Elementen müssen nach dem Schema des TcHmi.AccesControl formatiert werden.	Ja
`configVersion`	Definiert die Version des verwendeten Schemas. Dieser Eintrag wird zwingend benötigt, um zukünftige Änderungen des Schemas konvertieren zu können.	Nein

Alle Auflistungen erfordern die Angabe des Namens des PLC-Elements zur Referenzierung. Beispielhafte Werte entnehmen Sie der Schemabeschreibung von UnitMappings.

UnitMappings

Das Schema der UnitMappings bietet verschiedene Gruppierungen der Zuweisung:

"UnitMappings": {
   "Default": {
      "SoftEndMin": "Length",…
   },
   "Trafo": {
      "DriveSoftEndMin": "::fbSpecific::fbTrafo::DriveUnitGroup",…
   },        
   "UnitGroup": {
      "MaxVeloApplication": "::UnitGroup~Velocity",…
   },
   "Fixed": {
      "TorqueLimitingCapacity": "Unit_Torque_Newton_Meter",…
   },
   "AnalogValue": {
      "ScalingElectricalMin": "::UnitGroupElectrical",…
   }
}

Element	Beschreibung
Default	Diese Standardzuweisungen werden verwendet, wenn keine Sonderelemente definiert sind.
Trafo	Spezifische Zuweisungen für Transformationsachsen, die vorrangig verwendet werden.
UnitGroup	Enthält das übergebene SPS-Element eine Eigenschaft namens `UnitGroup`, können in diesem Element symbolbezogene Abhängigkeiten definiert werden.
Fixed	Für Einträge, die nicht umschaltbar sein sollen, können in diesem Element feste Einheiten (Systemeinheit = Anzeigeeinheit) definiert werden.
AnalogValue (Custom)	Weitere Schlüssel (hier beispielhaft `AnalogValue` für eine PLC-Instanz `fbParamAnalogValue`) können für gruppenbezogene Sonderhandhabungen definiert werden.

ReadOnly

Einträge mit ausschließlichem Lesezugriff können über ReadOnly eingestellt werden. Dabei existieren auch bedingte Möglichkeiten, die während der Laufzeit umgeschaltet werden können.

"Map": {
   "TuningLastExecution": "true",
   "CreepDistanceM": "AsymTargeting",…
},
"Conditions": {
   "AsymTargeting": {
       "Symbol": true,
       "Inverted": true,
       "CreateLatch": false,
       "Latch": "ValueToCheck"
   },…
}

Element		Beschreibung
`Map`		Beschreibt eine Auflistung an Elementen, die immer, nie oder einen bedingten Lesezugriff erhalten sollen. Folgende Definitionen sind möglich: `true` – für die permanente Einschränkung des Schreibzugriffs `false` – für eine permanenten Freigabe des Schreibzugriffs `Custom` - eine unter `Conditions` aufzuführende benutzerspezifische Bedingung
`Conditions`		Konfiguration der Bedingungen, sofern ein Element in der `Map` auf eine Bedingung referenziert.
	`Symbol`	Die Bezeichnung der Bedingung referenziert auf ein anderes Symbol und soll mit dessen Zustand auf Lesezugriff gestellt werden.
	`Inverted`	Die Interpretation der Bedingungen wird invertiert. Beispielsweise wenn ein Symbolwert referenziert wird, führt ein `false` anstatt eines `true`’s zur Einschränkung des Lesezugriffs.
	`CreateLatch`	Der Eintrag erzeugt einen Merker in einer internen Merkertabelle. Wenn dieser Wert auf `true` gesetzt ist, wird keine Bedingung ausgelöst, sondern nur ein Merkerwert erzeugt.
	`Latch`	Merkerwert, der die Bedingung auslöst.

NuGet Paket: Beckhoff.TwinCAT.HMI.Plastic.Functions

Verfügbar: seit Version 12.22.0

Verwendung: TC3 Plastic Application HMI Projekte