System Manual: Siemens SIMATIC HMI (WinCCv7.0: Scripting VBS, ANSI-C, VBA)
Подождите немного. Документ загружается.
4.6.3.7 CreateTlgTag Function
Description
Creates a new archive tag.
syntax
Expression.CreateTlgTag(ArchiveName,TagName,[TagType])
Expression
Necessary. An expression which returns a "HMIGO" type object.
Parameters
Parameter (Data Type) Description
ArchiveName (String) Name of an existing archive in which the tag is to
be entered
TagName (string) Name of the tag to be created
TagType (HMIGO_TLG_TAG_TYPE, optional) Specifies the type of the tag. If no type is specified,
the default value TLG_VAR_TYP_ANALOG is
entered. The possible types are:
● TLG_VAR_TYP_ANALOG (65537) for an
analog tag.
● TLG_VAT_TYP_BINARY (65538) for a binary
tag.
● TLG_VAR_TYP_PROCESS (65544) for a
process tag.
● TLG_VAT_TYP_COMPRESS (65540) for a
compression tag.
Default Values When a New Archive Tag Is Created
The following table indicates the default values that are entered when a new archive tag is
created. These values can be modified later and written using the CommitTlgTag function.
Property Default Value (Enum Name => Value) Comment
TlgTagType TLG_VAR_TYP_ANALOG (65537) Acquired by means of an
analog data manager tag
TlgTagArchiving TLG_TAG_CYCLIC_CONTINUOUS
(8388610)
Cyclic, continuous acquisition
TlgTagArchivingState TLG_TAG_ACTIVATED (0) Archiving is started at start of
Runtime.
VBA for Automated Configuration
4.6 VBA in Other WinCC Editors
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
2451
Property Default Value (Enum Name => Value) Comment
TlgTagTriggerScan 1 second Please note that "1 second" is
only the name of the trigger.
You must ensure yourself that
the trigger exists and actually
has a cycle of 1 s.
TlgTagTriggerArchiving 1 second Please note that "1 second" is
only the name of the trigger.
You must ensure yourself that
the trigger exists and actually
has a cycle of 1 s.
TlgTagTriggerFactor 1 The display cycle and archiving
cycle are identical.
TlgTagOnError TLG_TAG_LAST_VALUE (1) The last valid value is taken as
the substitute value.
TlgTagTriggerType TLG_TAG_ALWAYS (4) Every value is archived.
TlgTagMethodType TLG_TAG_ACTUAL (1) No editing. The value is
accepted immediately.
TlgTagStartTriggerFunction No function specified --
TlgTagStopTriggerFunction
No function specified --
TlgTagTriggerFunction
No function specified --
TlgTagUpperLimit No value specified --
TlgTagLowerLimit No value specified --
TlgTagNameCompressArchi
ve
No archive name specified --
TlgTagNameCompressTag No tag name specified --
TlgTagNameRawValue No raw-data tag specified --
TlgTagStartTriggerModule No DLL name specified --
TlgTagNameProcTag Corresponds to "TagName" --
TlgTagOnChange TLG_TAG_EVERY_VALUE (0) Every value will be archived.
TlgTagHysterese 0 No check is carried out by
means of hysteresis.
TlgTagAliasName No value specified --
TlgTagStartEvent No tag specified --
TlgTagStopEvent No tag specified --
List of the enumerators for Tag Logging
Enum types Description
TLG_TAG_TYPE The passed parameter specifies the type of the tag. The possible types
are in the table Enum HMIGO_TLG_TAG_TYPE.
TLG_TAG_ARCHIVING The passed parameter specifies the acquisition type. The possible
values are in the table Enum HMIGO_TLG_TAG_ARCHIVING.
VBA for Automated Configuration
4.6 VBA in Other WinCC Editors
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
2452
System Manual, 11/2008,
Enum types Description
TLG_TAG_ARCHIVING_STA
TE
The passed parameter specifies whether archiving is disabled or
enabled
at system startup. The possible values are in the table Enum
HMIGO_TLG_TAG_ARCHIVING_STATE.
TLG_TAG_ON_ERROR The passed parameter specifies which value is stored in the event of
a problem: the most recently acquired value or the substitute value.
The possible values are in the table Enum
HMIGO_TLG_TAG_ON_ERROR.
TLG_TAG_TRIGGER_TYPE The passed parameter specifies how archiving is carried out at a signal
change. The possible values are in the table Enum
HMIGO_TLG_TAG_TRIGGER_TYPE.
TLG_TAG_METHOD_TYPE The passed parameter specifies the method by which the value is
edited before archiving. The possible values are in the table Enum
HMIGO_TLG_TAG_METHOD_TYPE.
TLG_TAG_ON_CHANGE The passed parameter specifies whether archiving is to be carried out
in the event of a change. The possible values are in the table Enum
HMIGO_TLG_TAG_ON_CHANGE.
Enum HMIGO_TLG_TAG_TYPE
Values Description
TLG_TAG_TYP_ANALOG (65537) Analog tag
TLG_TAG_TYP_BINARY (65538) Binary Tags
TLG_TAG_TYP_PROCESS (65544) Process tag
TLG_TAG_TYP_COMPRESS (65540) Compressed archive tag
Enum HMIGO_TLG_TAG_ARCHIVING
Values Description
TLG_TAG_ACYCLIC (8388609) Acyclic acquisition
TLG_TAG_CYCLIC_CONTINUOUS (8388610) Cyclic-continuous acquisition
TLG_TAG_CYCLIC_SELECTIVE (8388612) Cyclic-selective acquisition
TLG_TAG_ON_EVERY_CHANGE (8388616) Acquisition only in the event of a change
Enum HMIGO_TLG_TAG_ARCHIVING_STATE
Values Description
TLG_TAG_LOCKED (1) Acquisition disabled at system startup
TLG_TAG_ACTIVATED (0) Acquisition enabled at system startup
VBA for Automated Configuration
4.6 VBA in Other WinCC Editors
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
2453
Enum HMIGO_TLG_TAG_ON_ERROR
Values Description
TLG_TAG_LAST_VALUE (1) The most recently acquired value is used.
TLG_TAG_SUBSTITUTE (2) A substitute value is entered.
Enum HMIGO_TLG_TAG_TRIGGER_TYPE
Values Description
TLG_TAG_FROM_0_TO_1 (2) Signal change from the value 0 to 1
TLG_TAG_FROM_1_TO_0 (3) Signal change from the value 1 to 0
TLG_TAG_ALWAYS (4) Always archive.
TLG_TAG_EVERY_CHANGE (1) Archive at every signal change.
Enum HMIGO_TLG_TAG_METHOD_TYPE
Values Description
TLG_TAG_ACTUAL (1) The current value is accepted.
TLG_TAG_SUM (3) The sum is formed.
TLG_TAG_MaxValue (5) The greatest value is saved.
TLG_TAG_MinValue (4) The smallest value is saved.
TLG_TAG_AVERAGE (2) The average value is saved.
Enum HMIGO_TLG_TAG_ON_CHANGE
Values Description
TLG_TAG_EVERY_VALUE (0) The current value is accepted.
TLG_TAG_RELATIVE_HYSTERESE
(1)
A hysteresis specified as a percentage is used for the
calculation as to whether the value is to be archived.
TLG_TAG_ABSOLUTE_HYSTERES
E (2)
A hysteresis specified as an absolute value is used for the
calculation as to whether the value is to be archived.
Example:
Sub CreateTlgTag()
' HMIGO_011
' procedure to create a tag logging tag
VBA for Automated Configuration
4.6 VBA in Other WinCC Editors
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
2454
System Manual, 11/2008,
' the archive need to be created before
' the tag logging tag must not be created before
' declarations
Dim objHMIGO As HMIGO
Dim strArchiveName As String
Dim strTlgTagName As String
Set objHMIGO = New HMIGO
strArchiveName = "NewArchive"
strTlgTagName = "NewTag"
'current status is "EMPTY"
MsgBox objHMIGO.ObjectStateTlgTag, vbOKOnly, "Status Tlg Tag"
'create tag logging tag
objHMIGO.CreateTlgTag strArchiveName, strTlgTagName, TLG_TAG_TYPE_ANALOG
'current status is "OPENED"
MsgBox objHMIGO.ObjectStateTlgTag, vbOKOnly, "Status Tlg Archive"
Set objHMIGO = Nothing
End Sub
See also
ListTlgTag Function (Page 2463)
ListTlgArchive Function (Page 2461)
GetTlgArchive Function (Page 2458)
DeleteTlgTag Function (Page 2457)
DeleteTlgArchive Function (Page 2455)
CreateTlgArchive Function (Page 2448)
CommitTlgTag Function (Page 2446)
CloseTlgArchive-Funktion (Page 2442)
CloseTlgTag Function (Page 2443)
VBA in Tag Logging (Page 2438)
4.6.3.8 DeleteTlgArchive Function
Description
Deletes the specified archive.
Syntax
Expression.DeleteTlgArchive(ArchiveName)
Expression
Necessary. An expression which returns a "HMIGO" type object.
VBA for Automated Configuration
4.6 VBA in Other WinCC Editors
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
2455
Parameters
Parameter (Data Type) Description
ArchiveName (String) Name of the archive to be deleted. Archive tags
contained in the archive are also deleted.
Example:
Sub DeleteTlgArchive()
' HMIGO_012
' procedure to delete an archive
' the archive need to be created before
' declarations
Dim objHMIGO As HMIGO
Dim strArchiveName As String
Set objHMIGO = New HMIGO
strArchiveName = "NewArchive"
'current status is "EMPTY"
MsgBox objHMIGO.ObjectStateTlgArchive, vbOKOnly, "Status Tlg Archive"
'delete tag logging archive
objHMIGO.DeleteTlgArchive strArchiveName
Set objHMIGO = Nothing
End Sub
See also
ListTlgTag Function (Page 2463)
ListTlgArchive Function (Page 2461)
GetTlgArchive Function (Page 2458)
DeleteTlgTag Function (Page 2457)
CreateTlgTag Function (Page 2451)
CreateTlgArchive Function (Page 2448)
CommitTlgTag Function (Page 2446)
CommitTlgArchive Function (Page 2445)
CloseTlgTag Function (Page 2443)
CloseTlgArchive-Funktion (Page 2442)
VBA in Tag Logging (Page 2438)
VBA for Automated Configuration
4.6 VBA in Other WinCC Editors
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
2456
System Manual, 11/2008,
4.6.3.9 DeleteTlgTag Function
Description
Deletes the specified archive tag.
syntax
Expression.DeleteTlgTag(ArchiveName,TagName)
Expression
Necessary. An expression which returns a "HMIGO" type object.
Parameters
Parameter (Data Type) Description
ArchiveName (String) Name of the archive containing the archive tag to
be deleted
TagName (string) Name of the archive tag to be deleted.
Example:
Sub DeleteTlgTag()
' HMIGO_013
' procedure to delete a tag logging tag
' the archive need to be created before
' the tag logging tag need to be created before
' declarations
Dim objHMIGO As HMIGO
Dim strArchiveName As String
Dim strTlgTagName As String
Set objHMIGO = New HMIGO
strArchiveName = "NewArchive"
strTlgTagName = "NewTag"
'current status is "EMPTY"
MsgBox objHMIGO.ObjectStateTlgTag, vbOKOnly, "Status Tlg Tag"
'delete tag logging tag
objHMIGO.DeleteTlgTag strArchiveName, strTlgTagName
Set objHMIGO = Nothing
End Sub
VBA for Automated Configuration
4.6 VBA in Other WinCC Editors
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
2457
See also
ListTlgTag Function (Page 2463)
ListTlgArchive Function (Page 2461)
GetTlgArchive Function (Page 2458)
DeleteTlgArchive Function (Page 2455)
CreateTlgTag Function (Page 2451)
CreateTlgArchive Function (Page 2448)
CommitTlgTag Function (Page 2446)
CommitTlgArchive Function (Page 2445)
CloseTlgTag Function (Page 2443)
CloseTlgArchive-Funktion (Page 2442)
VBA in Tag Logging (Page 2438)
4.6.3.10 GetTlgArchive Function
Description
Reads in the parameters of the specified archive.
You can change or read the parameters by means of the object properties. You will find a list
of the available object properties in this documentation under "VBA in TagLogging".
syntax
Expression.GetTlgArchive(ArchiveName)
Expression
Necessary. An expression which returns a "HMIGO" type object.
Parameters
Parameter (Data Type) Description
ArchiveName (String) Name of the archive whose values are to be read
in.
Example:
Sub GetTlgArchive()
' HMIGO_014
VBA for Automated Configuration
4.6 VBA in Other WinCC Editors
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
2458
System Manual, 11/2008,
' procedure to open an archive
' the archive need to be created before
' declarations
Dim objHMIGO As HMIGO
Dim strArchiveName As String
Set objHMIGO = New HMIGO
strArchiveName = "NewArchive"
'current status is "EMPTY"
MsgBox objHMIGO.ObjectStateTlgArchive, vbOKOnly, "Status Tlg Archive"
'open/ get tag logging archive
objHMIGO.GetTlgArchive strArchiveName
'current status is "OPENED"
MsgBox objHMIGO.ObjectStateTlgArchive, vbOKOnly, "Status Tlg Archive"
Set objHMIGO = Nothing
End Sub
See also
CreateTlgTag Function (Page 2451)
ListTlgTag Function (Page 2463)
ListTlgArchive Function (Page 2461)
GetTlgArchive Function (Page 2458)
DeleteTlgTag Function (Page 2457)
DeleteTlgArchive Function (Page 2455)
CreateTlgArchive Function (Page 2448)
CommitTlgTag Function (Page 2446)
CommitTlgArchive Function (Page 2445)
CloseTlgTag Function (Page 2443)
CloseTlgArchive-Funktion (Page 2442)
VBA in Tag Logging (Page 2438)
4.6.3.11 GetTlgTag Function
Description
Reads in the parameters of the specified archive tag.
You can change or read the parameters by means of the object properties. You will find a list
of the available object properties in this documentation under "VBA in TagLogging".
syntax
Expression.GetTlgTag(ArchiveName,TagName)
VBA for Automated Configuration
4.6 VBA in Other WinCC Editors
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
2459
Expression
Necessary. An expression which returns a "HMIGO" type object.
Parameters
Parameter (Data Type) Description
ArchiveName (String) Name of the archive containing the archive tag.
TagName Name of the archive tag whose parameters are to
be read in.
Example:
Sub GetTlgTag()
' HMIGO_015
' procedure to close a tag logging tag
' the archive need to be created before
' the tag logging need to be created before
' declarations
Dim objHMIGO As HMIGO
Dim strArchiveName As String
Dim strTlgTagName As String
Set objHMIGO = New HMIGO
strArchiveName = "NewArchive"
strTlgTagName = "NewTag"
'current status is "EMPTY"
MsgBox objHMIGO.ObjectStateTlgTag, vbOKOnly, "Status Tlg Tag"
'open/ get tag logging tag
objHMIGO.GetTlgTag strArchiveName, strTlgTagName
'current status is "OPENED"
MsgBox objHMIGO.ObjectStateTlgTag, vbOKOnly, "Status Tlg Archive"
Set objHMIGO = Nothing
End Sub
VBA for Automated Configuration
4.6 VBA in Other WinCC Editors
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
2460
System Manual, 11/2008,