Strategie für den Geräteexport - Online-Hilfe

Der Building X Connector verwendet einen Exporter, um ein Desigo CC-Gerät (und seine Eigenschaften) in einen oder mehrere Punkte in Building X zu übersetzen. Da Building X sein eigenes Punktmodell implementiert, muss eine Strategie für die Übersetzung von Desigo CC-Geräteeigenschaften in Building X-Punkte gewählt werden. Die Exportstrategie beeinflusst, welche Punkte in Building X dargestellt werden.

In der folgenden Tabelle sind einige der am häufigsten exportierten Geräte aufgeführt. Der Building X Connector verfügt über eingebaute Exportstrategien mit sinnvollen Voreinstellungen für diese Geräte (rechte Spalte). Da jedoch auch andere Entscheidungen für den Punkteexport möglich (und in einigen Fällen notwendig) sind, wird in den folgenden Abschnitten erörtert, wie der Exporter angepasst werden kann.

Möglicherweise stellen Sie fest, dass die oben aufgeführten Standard-Exportstrategien für Ihre Bedürfnisse nicht geeignet sind. Für diese Fälle ist es möglich, den Exporter anzupassen. Denken Sie daran, dass eine benutzerdefinierte Exportlösung zusätzliche Wartung und laufenden Support erfordert. Es gibt zwei wahrscheinliche Gründe für den Export eines benutzerdefinierten Punktesatzes in Building X:

1. Neue Geräte hinzufügen. Sie müssen Punkte von einem oder mehreren neuen Geräten exportieren, die noch nicht in der obigen Tabelle aufgeführt sind.
2. Änderung der Exportstrategie für vorhandene Geräte. Sie müssen andere Punkte von einem oder mehreren bereits bekannten Geräten exportieren, als es die in der obigen Tabelle aufgeführten Standardstrategien vorsehen.

In beiden Fällen werden die gleichen Werkzeuge verwendet, um das Standard-Exportverhalten zu ändern:

• IoT-Geräte-Tagging. Wenn Sie den Export eines oder einer kleinen Anzahl von Geräten ändern möchten, fügen Sie das IoT-Geräte-Tag zu jedem Gerät im Editor für Modelle und Funktionen hinzu. Da diese Markierung auf jedes einzelne Gerät angewendet werden muss, empfiehlt sich diese Methode, wenn der Scope der Änderung auf eine kleine Anzahl von Geräten beschränkt ist.
• Benutzerdefinierte Konfigurationsdatei. Um eine ganze Klasse von Geräten (Gerätetyp) zu ändern, liefern Sie eine JSON-Datei (CustomDevices.json) mit einer definierten Liste von Parametern. Dies funktioniert am besten, wenn der Benutzer den Exporter für viele Geräte oder für alle Geräte eines bestimmten Typs ändern oder erweitern muss.
• Filterung auf Punktebene. In bestimmten Fällen kann es erforderlich sein, den Exporter bis hinunter auf die Ebene der Angabe einzelner Punkte zu ändern. Der Filter auf Punktebene ist eine weitere Markierung, die verwendet werden kann, wenn Sie diese Ebene der feinkörnigen Kontrolle benötigen.

Im Allgemeinen müssen Sie bei jeder dieser Methoden zur Änderung des Exporters (1) angeben, welche Geräte in den Scope der Änderung fallen, und (2) eine neue Strategie für den Export angeben. Einzelheiten zu den einzelnen Methoden werden im nächsten Abschnitt, "Werkzeuge zur Anpassung des Exporters", erläutert. Der letzte Abschnitt, "Benutzerdefinierte Exportszenarien", gibt einen allgemeinen Überblick über die Schritte, die beim Hinzufügen neuer Geräte oder beim Anpassen bestehender Exportstrategien erforderlich sind.

Das nachstehende Flussdiagramm enthält eine Zusammenfassung des benutzerdefinierten Workflows für den Export:

Werkzeuge zur Anpassung des Exporters

IoT-Geräte-Tagging

Verwenden Sie das Desigo CC Objekt-Tagging, um eine einzelne Geräteinstanz mit dem IoT-Tag zu kennzeichnen. Im Editor für Modelle und Funktionen hat dies die Form:

“iotDevice=<tag>”

wobei <tag> eine der in der nachstehenden Tabelle enthaltenen Exportstrategien (gekennzeichnet durch den Tag-Wert in der linken Spalte) oder der von Haystack definierte Standardwert ("m:") ist.

Das IoT-Geräte-Tag kann sowohl auf beide (1) Geräte, die dem Exporter bereits bekannt sind, als auch auf (2) neue Geräte, die in der CustomDevices.json -Datei definiert sind, angewendet werden.

Weitere Informationen zum Tagging-Konventionen finden Sie unter Konfiguration Step-by-Step -> Objektkonfiguration -> Tags für Objekte erstellen.

Benutzerdefinierte Geräte JSON-Datei

Um den Exporter für eine ganze Klasse von Geräten ("Gerätetyp") hinzuzufügen oder zu ändern, müssen Sie eine benutzerdefinierte JSON-Konfigurationsdatei "CustomDevices.json" mit Informationen über den Gerätetyp erstellen, dessen Export Sie ändern oder modifizieren möchten. Details und Beispiele zu dieser Datei finden Sie in der README, die Ihrem Installationsprogramm beiliegt.

Im Rahmen der Definition des Geräts müssen Sie eine Punktfilterstrategie auswählen.

Der in CustomDevices.json verwendete Punktfilter ermöglicht es dem Benutzer, eine vordefinierte Exportstrategie zur Verwendung mit einem neuen Gerätetyp auszuwählen.

In der README finden Sie weitere Informationen zur Konfiguration des Punktfilters CustomDevices.json.

IoT-Punktfilter anwenden zum Ändern der Exportstrategie

Wenn Sie den Exporter so weit wie möglich anpassen möchten, fügen Sie das IoT-Punktfilter-Tag hinzu, um den Export bis auf die Ebene der einzelnen Punkte zu steuern.

Im Editor für Modelle und Funktionen kann das Tag IoTPointFilter entweder (1) der Name einer alternativen Exportstrategie (siehe Tabelle unten) oder (2) eine Liste von Eigenschaften sein.

Wenn der Benutzer einen Punktfilter mit einer anderen Exportstrategie auswählt, hat das Tag die Form

iotPointFilter=”<Export Strategy>”

Zum Beispiel:

iotPointFilter=OM_DEF_PROP

Die vom Benutzer auswählbaren Exportstrategien sind eine Untermenge der Standardstrategien für Geräte, die dem Ausführer bereits bekannt sind:

Wenn das Punktfilter-Tag keine der oben genannten Strategien angibt, geht der Exporter davon aus, dass er nach einer oder mehreren Eigenschaften auf dem Gerät suchen soll. Dabei kann es sich um Eigenschaften des Objekts oder der Funktion handeln, die in dieser Form vorliegen:

iotPointFilter= “<ListOfProperties>”

Zum Beispiel:

iotPointFilter=Eigenschaft1,Eigenschaft2,Eigenschaft3 (Funktion Eigenschaftskennzeichnung)

Oder:

iotPointFilter=Eigenschaft1,@Wert1,@Wert2,Eigenschaft2 (gemischte Kennzeichnung von Objekt- und Funktionseigenschaften)

Alle Beispiele erfordern eine durch Komma getrennte Liste, deren Namen entweder eine Objektmodelleigenschaft (z. B. "Present_Value") oder eine Funktionseigenschaft ("@Value") angeben können. Wenn keine der aufgelisteten Eigenschaften mit den auf dem Gerät gefundenen übereinstimmen, greift der Exporteur auf die Exportstrategie FCN_OM_DEF_PROP (siehe obige Tabelle) zurück.

Hintergrundinformationen über Exportstrategien und den Aufbau des Exporters finden Sie auch in der README zu benutzerdefinierten Geräten, die mit Ihrem Installationsprogramm mitgeliefert wird.

Weitere Informationen zum Tagging-Konventionen finden Sie unter Konfiguration Step-by-Step -> Objektkonfiguration -> Tags für Objekte erstellen.

Benutzerdefinierte Export-Szenarien

Neue Geräte hinzufügen

Ein "neues Gerät" ist jedes Gerät, das vom Exporter nicht erkannt wird und für das nicht bereits eine Exportstrategie definiert ist. Nachdem die korrekten Informationen an den Exporter übermittelt wurden, werden alle angegebenen Geräte erkannt und für den Export zugelassen.

Um ein Gerät oder eine kleine Anzahl von Geräten hinzuzufügen, wird im Allgemeinen empfohlen, das Tag "IoT" auf diese spezifischen Geräte anzuwenden. Wenn Sie dem Exporter alle Geräte eines Typs hinzufügen möchten, verwenden Sie die Datei CustomDevices.json .

Wenn Sie ein Gerät hinzufügen, das dem Exporteur bereits bekannt ist, gelten die Regeln zur Konfliktlösung. Im Allgemeinen geht das System davon aus, dass Sie die Standard-Exportstrategie ändern wollen, wenn Sie dem Exporter ein bereits bekanntes Gerät hinzufügen - es wird die benutzerdefinierte Regel gewählt. Wenn ein Konflikt zwischen einem Gerätetyp, der in der benutzerdefinierten JSON-Datei definiert ist, und einem bestimmten Gerät, das mit dem IoT-Tag gekennzeichnet ist, auftritt, gilt im Allgemeinen die enger gefasste Regel (das IoT-Tag). Die Kennzeichnung für dieses spezifische Gerät würde für den Export beibehalten.

Ändern der Exportstrategie für bestehende Geräte

Lesen Sie diesen Abschnitt, wenn Sie versuchen, entweder ein bestimmtes Gerät (Geräteinstanz) oder eine Geräteklasse (Gerätetyp) zu exportieren, die bereits vom Exporter erkannt und von einer Punktexportstrategie abgedeckt werden, Sie aber andere Punkte als die Standardpunkte nach Building X exportieren möchten.

Alle Änderungen an der Standard-Exportstrategie erfordern, dass Sie (1) die zu ändernden Geräte definieren und (2) dem Exporter eine neue Exportstrategie zur Verfügung stellen.

Wie beim Hinzufügen neuer Geräte kann die Definition der zu ändernden Geräte entweder durch (1) IoT-Geräte-Tagging pro Gerät oder (2) die CustomDevice.json-Datei zur Angabe einer ganzen Geräteklasse angegeben werden.

Sowohl für das IoT-Geräte-Tagging als auch für die CustomDevice.json-Datei gibt der Benutzer eine allgemeine Exportstrategie vor, die in einer der obigen Tabellen aufgeführt ist. Dies ist möglicherweise nicht in allen Fällen angemessen. Wenn Sie eine Exportanpassung bis auf die Ebene der einzelnen Punkte benötigen, verwenden Sie den IoT Punktfilter-Tag (siehe oben), um diese Anpassungen vorzunehmen.

Wenn Sie den Exporter anpassen, ist es möglich, dass ein Konflikt zwischen der Standardstrategie und den benutzerdefinierten Exportregeln entsteht. Wie bei den Regeln zur Konfliktlösung für neue Geräte geht das System im Allgemeinen davon aus, dass Anpassungen an bestimmten Geräten Vorrang vor allgemeineren Regeln haben sollten.