Konfiguration dpNames
Dieses Kapitel beschreibt die Funktion dpNames.
Funktionstyp auswählen
Nachdem ein neuer Datensatz angelegt und benannt wurde (siehe Datensatz erstellen), muss in diesem Fenster der Funktionstyp dpNames gewählt werden. Klicken Sie danach auf die Schaltfläche Next>.
Parameterauswahl
Hier werden die Parameter ausgewählt, die bei der weiteren Konfiguration verfügbar sein werden. Klicken Sie danach auf die Schaltfläche Next>.
Funktionsparameter
| Parameter | Beschreibung |
| dpPattern | Muster, das definiert, nach welchen Datenpunkt- oder Datenpunktelement-Bezeichnern gesucht wird. Beachten Sie, dass die Beschreibung (Description), das Alias und die Einheit (unit) nur auf DP-Element-Ebene abgefragt werden können! Im DPE Filter Parameter (dpPattern) benötigen Sie die Endung "." für die Abfrage eines DPEs der obersten Ebene, z.B. "ExampleDP*." |
| dpType | Datenpunkttyp nach dem zusätzlich gefiltert wird |
| lang | Die Projektsprache. Wenn Sie die Sprache nicht angeben, gibt die Funktion die Defaultsprache zurück. D.h. die Defaultsprache (aktive Sprache), die in der Projektkonfigurationsdatei (config file) gesetzt wurde. Wenn Sie jedoch den Parameter "lang" angeben, wird die Sprache, die über den Parameter angegeben wurde, zurückgegeben. Der Parameter "lang" ist optional. |
| descriptionMode | Modus 0: Liefert die Beschreibung am Datenpunktelement. Wenn keine Beschreibung existiert, wird der Datenpunktelement-Name (DP.EL1.EL2) geliefert. Modus 1 (Defaultoption): Liefert die Beschreibung am Datenpunktelement. Wenn keine Beschreibung existiert, wird der Text "RootKnoten-Beschreibung beim DP" und die Beschreibung vom Masterdatenpunkt-Element für den Root-DP geliefert. (Text: "RootKnoten-Beschreibung beim DP" und die Beschreibung vom Masterdatenpunkt-Element). Für andere DPs, wird der Datenpunktname des abgefragten DPs und die Beschreibung vom Masterdatenpunkt-Element geliefert (DPName + Beschreibung vom Masterdatenpunkt-Element). Wenn es für das MasterDP-Element auch keine Beschreibung gibt, wird der Datenpunktname bzw. der DPE-Name je nachdem was abgefragt wurde, geliefert. Modus 2: Liefert die Beschreibung des Datenpunktelements. Wenn es keine Beschreibung gibt, wird die Beschreibung vom Masterdatenpunkt-Element und der Text "RootKnoten-Beschreibung beim DP" für den ROOT-Dp geliefert. (die Beschreibung vom Masterdatenpunkt-Element und der Text "RootKnoten-Beschreibung beim DP"). Für andere DPs, wird die Beschreibung des MasterDp-Elements und der Datenpunktname des abgefragten Datenpunktes geliefert (die Beschreibung des MasterDp-Elements und der Datenpunktname des abgefragten Datenpunktes). Wenn es für das MasterDP-Element auch keine Beschreibung gibt, wird der Datenpunktname bzw. der DPE-Name je nachdem was abgefragt wurde, geliefert. Modus3: Liefert die Beschreibung des Datenpunktelements. Wenn es keine Beschreibung gibt, werden der Text "RootKnoten-Beschreibung beim DP <ElementName> und die Beschreibung des Masterdatenpunktelements für den ROOT-Dp geliefert. (Text: "RootKnoten-Beschreibung beim DP <ElementName>" und die Beschreibung des Masterdatenpunktelements). Für andere DPs, werden der Datenpunktname und Datenpunktelement-Name des abgefragten DPs und die Beschreibung des Masterdatenpunktelements geliefert (DPName+DPE-Name + die Beschreibung des Masterdatenpunktelements). Wenn es für das MasterDP-Element auch keine Beschreibung gibt, wird der Datenpunktname bzw. der DPE-Name je nachdem was abgefragt wurde, geliefert. |
HINWEIS
Weitere Informationen zur Funktion und den Parametern finden Sie unter der CTRL-Funktion dpNames. Beachten Sie, dass die Reporting-Funktion dpNames zusätzlich zu den Parametern der normalen Control-Funktion, die Parameter "lang" und "descriptionMode" besitzt.
SOAP Request
Klicken Sie auf die Schaltfläche Edit Parameter um die Parameter anzugeben:
Klicken Sie auf die OK-Schaltfläche und danach auf die Schaltfläche Next>. Siehe Kapitel alertGetPeriod für weitere Informationen.
SOAP Response
In diesem Fenster müssen keine Änderungen vorgenommen werden. Klicken Sie auf die Schaltfläche Next>.
Row Mapping
Selektieren Sie die Tabelle "table". Per Klick auf die > Schaltfläche kann die XPath Expression (das selektierte Element in der XML-Struktur) übergeben werden. Das Fenster "Select or edit the XPath expression" wird geöffnet. Selektieren Sie die Option "XML elements named "table" at any location" und klicken Sie auf die OK-Schaltfläche. Siehe Kapitel alertGetPeriod für weitere Informationen.
Column Mapping
Beim Column Mapping werden die Spalteneinträge der Tabellenzeile definiert. Anders als beim Row Mapping können hier mehrere Elemente ausgewählt werden. Selektieren Sie ein Element aus dem Fenster links und klicken Sie auf die > Schaltfläche. Das Fenster "Column Mapping" wird geöffnet. Selektieren Sie den Datentyp aus der Combobox sowie die Option "XML elements named "<element>" at any location". Klicken Sie auf die OK-Schaltfläche.
Column Mapping enthält die folgenden Attribute:
dpName (Datenpunktname oder Datenpunktelement-Name),
description (Datenpunktbeschreibung),
alias (Der Aliasname des Datenpunktes),
unit (Die Einheit des Datenpunktes),
lang (Die Projektsprache) Wenn Sie die Sprache nicht angeben, gibt die Funktion die Defaultsprache zurück. D.h. die Defaultsprache (aktive Sprache), die in der Projektkonfigurationsdatei (config file) gesetzt wurde. Wenn Sie jedoch den Parameter "lang" angeben, wird die Sprache, die über den Parameter angegeben wurde, zurückgegeben. Der Parameter "lang" ist optional.
Neben den Alarm-Attributen können auch Fehlercode und Fehlertext ausgegeben werden. Da sich diese jedoch auf der gleichen Ebene wie /table befinden, ist es nicht möglich diese im gleichen Datensatz auszugeben. Daher müsste ein zweiter, identischer Datensatz angelegt werden, um den errorCode auszugeben.
| Fehlercode | Beschreibung |
| -1 | DpIdentification Pointer not found |
| -2 | Error reading DP list |
Um die Show Sample Data Schaltfläche verwenden zu können, ist wie im Kapitel alertGetPeriod erwähnt, die Angabe von Defaultwerten erforderlich. Hat man diese definiert, kann man den Datensatz auf eine korrekte Konfiguration überprüfen, bevor man den Konfigurationsvorgang mit Finish abschließt.
