Referenzkonfiguration
Wenn ein Datenpunktelement ein Referenztyp ist, enthält der resultierende Datenpunkttyp alle Eigenschaften (DPEs) des referenzierten Typs.
In diesem Fall muss die JSON-Datei die Definition des referenzierten Typs nicht enthalten. Trotzdem kann es notwendig sein, einige dieser Eigenschaften (DPEs) zu konfigurieren.
Um die Eigenschaften der referenzierten Datenpunkttypen zu konfigurieren, muss die JSON-Datei ein Element (Eigenschaft) mit dem Namen REFS und ein Element namens DPTS enthalten, das eine Liste der referenzierten Datenpunkttypen mit der Konfiguration ihrer Eigenschaften ist.
Beispiel
{
"DPTData": {
"DPTS": [ ...<list of DPTs description>...]
},
"REFS": {
"DPTS": [ ...<list of Referenced DPTs configuration>...]
}
}
Für jeden referenzierten Datenpunkttyp muss Folgendes angegeben werden:
Referenzierte Daten eines Datenpunkttyps | ||
Daten | Verwendung | Beschreibung |
Name | Notwendig | Name des referenzierten Datenpunkttyps. |
DPES | Notwendig | Liste der Datenpunktelemente. In der Datei werden nur die Eigenschaften definiert, die konfiguriert werden müssen. |
Beispiel
{
"DPTData": {
"DPTS": [ ...<list of DPTs description>...]
},
"REFS": {
"DPTS": [
{ "Name": "_GmsMyMandatoryFields",
"DPES": [
{ "Name": "MandatoryText", "PvssType": { "PvssType": "STRING"},
"VL": true, "AL": true,
"Persist": true, "GroupId": "CONFIG",
"Description":[{"Culture":"en-US", "Text":"Mandatory Text"}],
"Display": {
"Valid": true,
"Icon": {
"Library": "Global_Base_HQ_1",
"Name": "Op_DP_Generic_None_001.png"
}
}
}
]
}
]
}
}
Die Konfiguration der Datenpunktelemente entspricht der Beschreibung in Abschnitt Datenpunktelement.
Die Konfiguration eines referenzierten Datenpunkttyps wird auf alle Datenpunkttypen (definiert in der JSON-Datei) angewendet, die auf sie verweist.
Da die Verweise auf _GmsRelatedItems und _GmsStatusPropagation während des Imports automatisch hinzugefügt werden, wenn sie nicht in der JSON-Datei vorhanden sind, müssen sie in der JSON-Datei nicht konfiguriert werden. Die referenzierten DPTs enthalten interne Eigenschaften, für die keine Konfiguration erforderlich ist. Nur die Eigenschaft AggregatedSummaryStatus wird beim Import automatisch konfiguriert. Wenn für die Eigenschaft AggregatedSummaryStatus andere Werte festgelegt werden müssen, muss die Referenz _GmsStatusPropagation zur Definition des Datenpunkttyps in der JSON-Datei und dem REFS-Element die Konfiguration der Eigenschaft hinzugefügt werden.
