Datenpunkttypen und Datenpunkte
Der DBLogger verwendet die folgenden internen Datenpunkttypen (DPT) und Datenpunkte (DP):
_IS_Database
Beinhaltet die Parametrierungen der verwendeten DBs. Der DP-Name ist mit dem DB-Namen identisch. Wird eine ODBC-DB verwendet, ist der DB-Name der DSN-Name.
| DPE | Typ | Beschreibung |
|---|---|---|
| .DbName | string | Name der Datenbank (inklusive Erweiterung, wenn vorhanden) |
| .DbPath | string | Pfad zur Datei-Datenbank (leer bei ODBC-Datenbanken) |
| .DbType | string |
Mögliche Typen: MS SQL-Server, Oracle |
| .DbUser | string | Benutzername, definiert in der DB (ausreichend Rechte erforderlich) |
| .DbPassword | string | Benutzerpasswort, definiert in der DB |
| .DbAlivePeriod | int | Zeitintervall in Sekunden, in dem die Tabelle DBL_Alive aktualisiert wird (siehe die Funktion DBL_UpdateAliveSession in DBL.ctc) |
| .DbCommitPeriod | int | Zeitintervall in Sekunden, nachdem ein Commit unmittelbar ausgeführt wird (siehe die Funktion DBL_CommitPeriodical in DBL.ctc) |
| .DbCommitCount | int | Anzahl der DB-Schreibbefehle, nach denen ein Commit unmittelbar ausgeführt wird (siehe die Funktion DBL_CommitPeriodical in DBL.ctc) |
| .DbCommitThreadNumber | int | Nummer des Threads in dem die Funktion DBL_CommitPeriodical gestartet wurde |
| .DbCommitReset | bool | Periodisches Commit neu starten (siehe die Funktion DBL_ConnectCommitReset in DBL.ctc) |
| .DbAliveThreadNumber | int | Nummer des Threads in dem die Funktion DBL_UpdateAliveSession gestartet wurde |
| .DbAliveReset | bool | Alive-Mechanismus neu starten (siehe die Funktion DBL_ConnectAliveReset in DBL.ctc) |
| .DbWritePassive | bool | Gibt an, ob bei redundanten Systemen der passive Host in eine DB schreibt. |
_IS_Table
Beinhaltet die Parametrierungen der verwendeten Tabellen. Der DP-Name wird automatisch zusammengestellt: DB-Name + "_" + Tabellenname (definiert im Laufe der Parametrierung).
| DPE | Typ | Beschreibung |
|---|---|---|
| .TableName | string | Name der Tabelle |
| .TableType | string | Typ der Tabelle: "StandardHistory" bzw. der Name der benutzerdefinierten Tabelle vom Typ "FlexTables" |
| .TableMaxLengthDpeName | int | Maximale Länge der Datenpunktnamen/Aliasnamen in der Tabelle (Hinweis: Datenpunkte mit längeren Namen/Alias werden in die Tabelle nicht aufgenommen!) |
| .TableSystemNameDpe | bool | TRUE/FALSE: der DPE-Name/Alias wird mit/ohne Systemname in der Tabelle gespeichert |
| .TableAlias | bool | TRUE/FALSE: in der Tabelle wird der Alias/DPE-Name gespeichert |
| .TableOldDays | int | Alle Datensätze älter als TableOldDays Tage werden aus der Tabelle regelmäßig gelöscht (FIFO) |
| .TableFIFOThreadNumber | int | Threadnummer für FIFO |
| .TableFIFOAtHour | int | Zeitpunkt für das Löschen alter Daten (FIFO) |
_IS_ArchiveGroup
Beinhaltet die Parametrierungen der verwendeten Archivgruppen. Der DP-Name wird automatisch aus dem Text "DBL_ArchiveGroup_" und einer laufenden Nummer zusammengestellt.
| DPE | Typ | Beschreibung |
|---|---|---|
| .AgName | string | Name der Archivgruppe |
| .AgDbName | string | Name der Zieldatenbank (DB-Datenpunktname) |
| .AgTableName | string | Name der Zieltabelle in der Datenbank |
| .AgDescription | langString | Frei definierbare, mehrsprachige Beschreibung der Archivgruppe |
| .AgTransfer | struct | |
| .Mode | int |
Übertragungsmodus: 1 = Periodisch (Periodical) 2 = TriggerDP-gesteuert (Trigger) 3 = Ereignisgesteuert (Event) |
| .Period | int |
verwendet nur bei periodischer Datenübertragung in Sekunden Vordefinierte Perioden: 3, 10, 15, 30 Minuten, 1, 6, 8, 12 Stunden, 1 Tag, 1 Monat, 1 Jahr |
| .SyncTime | time | verwendet nur bei periodischer Übertragung: Synchronzeit der regelmäßigen Datenübertragung |
| .TriggerDPE | string | verwendet nur bei Übertragungsart Trigger: wenn dieser DPE eine Änderung erfährt, wird sein Wert auf Gültigkeit geprüft und wenn die Bedingung erfüllt ist, werden die in AgItems (siehe unten) definierten Datenpunkte übertragen |
| .TriggerConditionOperator | string |
verwendet nur bei Übertragungsart Trigger: Vergleichsoperator zum Prüfen des Triggerdatenpunktes Mögliche Operatoren: <,<=,==,>,>=,!=,OnEvent |
| .TriggerConditionValue | string | verwendet nur bei Übertragungsart Trigger: Vergleichswert zum Prüfen des Triggerdatenpunktes |
| .TriggerSourceTime | int | verwendet nur bei Übertragungsart Trigger: 1=Zeit des Triggers, 2=Zeit der DPEs, 3=jüngste, 4=älteste DPE-Zeit |
| .Delay | int | verwendet nur bei periodischer Übertragungsart: Verzögerung der Übertragung in Sekunden nach dem Erreichen der Periodenzeit |
| .TimedFuncDp | string | verwendet nur bei periodischer Übertragungsart: Name des DPs vom Typ _TimedFunc, verwendet bei periodischer Übertragungsart |
| .TriggerConditionDpe | string | (nur für Type==1 relevant --> siehe DBL_TableType) 3. Art der Triggerung |
| .TransferConfirmDpe | string | (nur für Type==1 relevant) RückmeldeDP an WinCC OA nach dem Datentransfer |
| .TransferConfirmType | int | (nur für Type==1 relevant) 0=Einer der übertragenen Zellenwerte des aktuellen Datensatzes, 1=Konstante |
| .TransferConfirmSource | string | (nur für Type==1 und TriggerConfirmType==0 relevant) Quelldatenpunkt für TransferConfirmation |
| .TransferConfirmValue | string | (nur für Type==1 und TriggerConfirmType==1 relevant) Konstante für TransferConfirmation |
| .AgActive | bool | Status der AG, TRUE=aktiv |
| .AgThreadNumber | int | Nummer des Start-Threads der AG |
| .AgItems | dyn_string | Liste der in der AG verwendeten (in die DB zu schreibenden) DPE's |
| .AgStatistic | struct | |
| .Reset | bool | noch nicht implementiert |
| .TransferCounter | int | noch nicht implementiert |
| .Period | int | noch nicht implementiert |
| .MaxCount | int | noch nicht implementiert |
_IS_TableType
Beinhaltet die Parametrierungen der verwendeten benutzerdefinierten Tabellen. Für die benutzerdefinierten Tabellen des Typs FlexTables setzt sich der DP-Name zusammen aus DBLogger + "_" + Tabellentypname.
| DPE | Typ | Beschreibung |
|---|---|---|
| .TableFieldName | dyn_string | Namen der einzelnen Spalten der Tabelle |
| .TableFieldLength | dyn_int | Feldlänge der Spalten |
| .TableFieldType | dyn_string | Felddatentypen |
| .TableFieldOrigin | dyn_string | Type==1: DPE + Config + Attribut, Type==0: Config + Attribut |
| .TableFieldIndexType | dyn_int | Spalten indiziert/nicht indiziert |
| .Type | int | 0=StandardHistory, 1=FlexTables |
| .TableDataReadMode | int | nur für Type==1 relevant (0=dpGet, 1=dpGetAsynch) |
_IS_Control
Dient zum Aktivieren/Deaktivieren der Archivgruppen (siehe die Funktion
IS_ControlExitWorkFunction in DBL.ctc)
sowie zum Stoppen (Neustarten) der DBLogger Archivgruppen (siehe die Funktion
IS_ControlWorkFunction in
DBL.ctc).
| DPE | Typ | Beschreibung |
|---|---|---|
| .AgName | string | Name der Archivgruppe zum (De)Aktivieren |
| .AgActivate | bool | Schalter zum Aktivieren/Deaktivieren der Archivgruppe angegeben in AgName |
| .ManType | string | für zukünftige Verwendung |
| .ManNum | int | für zukünftige Verwendung |
| .Exit | int | Schalter zum Stoppen (Neustarten) des DBL |
| .Error | int | für zukünftige Verwendung |
| .TableName | string | Name der Tabelle zum (De)Aktivieren FIFO |
| .TableFIFO | bool | Schalter zum (De)Aktivieren FIFO der Tabelle |
| .ThreadTableName | dyn_string | Liste mit den Threadnamen (für interne Verwaltung) |
| .ThreadNr | dyn_int | Liste der zugehörigen Threadnummern (für interne Verwaltung) |
