System Manual: Siemens SIMATIC HMI (WinCCv7.0: Scripting VBS, ANSI-C, VBA)
Подождите немного. Документ загружается.
Object property Description Read/Write is used in
TlgTagOnChange Specifies whether archiving is to be carried
out
in the event of a change. Possible values
of Enum HMIGO_TLG_TAG_ON_CHANGE:
● TLG_TAG_EVERY_VALUE (0)
● TLG_TAG_RELATIVE_HYSTERESE (1)
● TLG_TAG_ABSOLUTE_HYSTERESE
(2)
Yes/yes P
TlgTagMethodType Specifies the method by which the value is
edited before archiving. Possible values of
Enum
HMIGO_TLG_TAG_METHOD_TYPE:
● TLG_TAG_ACTUAL (1)
● TLG_TAG_SUM (3)
● TLG_TAG_MaxValue (5)
● TLG_TAG_MinValue (4)
● TLG_TAG_AVERAGE (2)
Yes/yes P, V
TlgTagTriggerScan Name of the timer for the acquisition cycle Yes/yes P
TlgTagTriggerArchiving Name of the timer for the archiving cycle. Yes/yes P
TlgTagStartTriggerFunc
tion
Specifies the name of a script function by
means of which a check is carried out for a
start event for the start of archiving.
Yes/yes P
TlgTagStartTriggerMod
ule
Specifies the name of a DLL from which the
script
function is called for the checking of a
start event.
Yes/yes P
TlgTagStopTriggerFunc
tion
Specifies the name of a script function by
means of which a check is carried out for a
stop event for the start of archiving.
Yes/yes P
TlgTagTriggerFunction Specifies the name of a script function for
the
dynamic switching of the acquisition and
archiving cycles.
Yes/yes P
TlgTagNameCompress
Archive
In the case of compressed archives,
contains the name of the source archive.
Yes/yes V
TlgTagNameCompress
Tag
In the case of compressed archives,
contains the name of the source tag.
Yes/yes V
TlgTagNameRawValue In the cast of process-controlled archives,
contains the name of the raw-data tag.
Yes/yes P
TlgTagConvertModule Name of the conversion DLL used for data
conversion.
Yes/yes P
TlgTagNameProcTag Name of the process tag from which the
value to be acquired is taken
Yes/yes P
TlgTagAliasName The alternative name by means of which the
tag can be addressed (alias).
Yes/yes P
TlgTagStartEvent Name of the tag by means of which the start
of archiving is checked.
Yes/yes P
TlgTagStopEvent Name of the tag by means of which the
stopping of archiving is checked.
Yes/yes P
TlgTagTriggerFactor Contains the factor for the display cycle as
a multiple of the archiving cycle.
Yes/yes P
TlgTagUpperLimit Value for the scaling of the tag's upper limit. Yes/yes P
VBA for Automated Configuration
4.6 VBA in Other WinCC Editors
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
2441
Object property Description Read/Write is used in
TlgTagLowerLimit Value for the scaling of the tag's lower limit. Yes/yes P
TlgTagHysterese Value for the hysteresis by means of which
a
check is carried out to establish whether a
value has changed.
Yes/yes P
See also
ListTlgTag Function (Page 2463)
ListTlgArchive Function (Page 2461)
GetTlgArchive Function (Page 2458)
DeleteTlgTag Function (Page 2457)
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 Other WinCC Editors (Page 2424)
4.6.3.2 CloseTlgArchive-Funktion
Description
Closes the process value or compressed archive which is open.
Note
Modified parameters are not saved.
syntax
Expression.CloseTlgArchive()
Expression
Necessary. An expression which returns a "HMIGO" type object.
Parameters
--
VBA for Automated Configuration
4.6 VBA in Other WinCC Editors
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
2442
System Manual, 11/2008,
Example:
Sub CloseTlgArchive()
' HMIGO_006
' procedure to close 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 archive
objHMIGO.GetTlgArchive strArchiveName
'current status is "OPENED"
MsgBox objHMIGO.ObjectStateTlgArchive, vbOKOnly, "Status Tlg Archive"
'close archive
objHMIGO.CloseTlgArchive
'current status is "EMPTY"
MsgBox objHMIGO.ObjectStateTlgArchive, 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)
CreateTlgTag Function (Page 2451)
CreateTlgArchive Function (Page 2448)
CommitTlgTag Function (Page 2446)
CommitTlgArchive Function (Page 2445)
CloseTlgTag Function (Page 2443)
VBA in Tag Logging (Page 2438)
4.6.3.3 CloseTlgTag Function
Description
Closes the archive tag which is open.
VBA for Automated Configuration
4.6 VBA in Other WinCC Editors
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
2443
Note
Modified parameters are not saved.
syntax
Expression.CloseTlgTag()
Expression
Necessary. An expression which returns a "HMIGO" type object.
Parameters
--
Example:
Sub CloseTlgTag()
' HMIGO_007
' procedure to close 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"
'open/ get tag logging tag
objHMIGO.GetTlgTag strArchiveName, strTlgTagName
'current status is "OPENED"
MsgBox objHMIGO.ObjectStateTlgTag, vbOKOnly, "Status Tlg Archive"
'close tag logging tag
objHMIGO.CloseTlgTag
'current status is "EMPTY"
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)
2444
System Manual, 11/2008,
See also
ListTlgTag Function (Page 2463)
ListTlgArchive Function (Page 2461)
GetTlgArchive Function (Page 2458)
DeleteTlgTag Function (Page 2457)
DeleteTlgArchive Function (Page 2455)
CreateTlgTag Function (Page 2451)
CreateTlgArchive Function (Page 2448)
CommitTlgTag Function (Page 2446)
CommitTlgArchive Function (Page 2445)
CloseTlgArchive-Funktion (Page 2442)
VBA in Tag Logging (Page 2438)
4.6.3.4 CommitTlgArchive Function
Description
Writes the changed parameters of the specified archive to WinCC.
Note
If further parameters are changed after a CommitTlgArchive call, write the changes to WinCC
by calling this function again.
syntax
Expression.CommitTlgArchive()
Expression
Necessary. An expression which returns a "HMIGO" type object.
Parameters
--
Example:
Sub CommitTlgArchive()
' HMIGO_008
VBA for Automated Configuration
4.6 VBA in Other WinCC Editors
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
2445
' procedure to change a property of 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 archive
objHMIGO.GetTlgArchive strArchiveName
'current status is "OPENED"
MsgBox objHMIGO.ObjectStateTlgArchive, vbOKOnly, "Status Tlg Archive"
'change a property
objHMIGO.TlgArchiveArchiveState = TLG_STATE_LOCKED
'current status is "MODIFIED"
MsgBox objHMIGO.ObjectStateTlgArchive, vbOKOnly, "Status Tlg Archive"
'commit archive
objHMIGO.CommitTlgArchive
'current status is "OPENED"
MsgBox objHMIGO.ObjectStateTlgArchive, vbOKOnly, "Status Tlg Archive"
Set objHMIGO = Nothing
End Sub
See also
DeleteTlgArchive Function (Page 2455)
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)
CloseTlgTag Function (Page 2443)
CloseTlgArchive-Funktion (Page 2442)
VBA in Tag Logging (Page 2438)
4.6.3.5 CommitTlgTag Function
Description
Writes the changed parameters of the specified archive tag to WinCC.
VBA for Automated Configuration
4.6 VBA in Other WinCC Editors
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
2446
System Manual, 11/2008,
Note
If further parameters are changed after a CommitTlgTag call, write the changes to WinCC by
calling this function again.
syntax
Expression.CommitTlgTag()
Expression
Necessary. An expression which returns a "HMIGO" type object.
Parameters
--
Example:
Sub CommitTlgTag()
' HMIGO_009
' procedure to change a property of 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"
'open/ get tag logging tag
objHMIGO.GetTlgTag strArchiveName, strTlgTagName
'current status is "OPENED"
MsgBox objHMIGO.ObjectStateTlgTag, vbOKOnly, "Status Tlg Archive"
'change a property
objHMIGO.TlgTagArchiving = TLG_TAG_ON_EVERY_CHANGE
'current status is "MODIFIED"
MsgBox objHMIGO.ObjectStateTlgTag, vbOKOnly, "Status Tlg Archive"
'commit tag logging tag
objHMIGO.CommitTlgTag
'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)
System Manual, 11/2008,
2447
See also
ListTlgTag Function (Page 2463)
ListTlgArchive Function (Page 2461)
GetTlgArchive Function (Page 2458)
DeleteTlgTag Function (Page 2457)
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.6 CreateTlgArchive Function
Description
Creates a process value archive or compressed archive.
syntax
Expression.CreateTlgArchive(ArchiveName,ArchiveType)
Expression
Necessary. An expression which returns a "HMIGO" type object.
Parameters
Parameter (Data Type) Description
ArchiveName (String) Name of the archive to be created
ArchiveType (HMIGO_TLG_ARCHIVE_TYPE) Type of the archive. The possible types are:
● TLG_PROCESSARCHIVE (131073) for a
process value archive
● TLG_COMPRESSARCHIVE (131074) for a
compressed archive
VBA for Automated Configuration
4.6 VBA in Other WinCC Editors
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
2448
System Manual, 11/2008,
Default Values when Creating a New Tag Archive
The following table indicates the default values that are entered when a new process value
archive
or compressed archive is created. These values can be modified later and written using
the CommitTlgArchive function.
Property Default Value (Enum Name =>
Value)
Comment
TlgArchiveAccessLevelRe
ad
0 Without authorization level
TlgArchiveAccessLevelWri
te
0 Without authorization level
TlgArchiveArchiveState TLG_ARCHIVE_STATE_ACTIVAT
ED (0)
Archiving is started at start of
Runtime.
TlgArchiveBufferSize 1000 Number of data records
TlgArchiveBufferType TLG_ARCHIVE_BUFFER_TYPE_D
ISK (2)
The values are stored on hard disk
in the database.
TlgArchiveCompressRang
e
"1 Tag". This string must be created
individually for each language (e.g.
English: "1 day")
Corresponds to exactly one day.
Only relevant in the case of
compressed tags.
Special Feature: the user is
responsible for values >= 1 minute
TlgArchiveCompressType TLG_COMPRESS_TYPE_CALC (1) Only calculate compression
values.
Only relevant in the case of
compressed tags.
Enum HMIGO_TLG_ARCHIVE_STATE
Parameters Description
TLG_ARCHIVE_STATE_LOCKED (1) Archiving is disabled at system startup.
TLG_ARCHIVE_STATE_ACTIVATED (0) Archiving is started at start of Runtime.
Enum HMIGO_TLG_ARCHIVE_BUFFER_TYPE
Parameters Description
TLG_ARCHIVE_BUFFER_TYPE_DISK (2) The values are archived on hard disk.
TLG_ARCHIVE_BUFFER_TYPE_RAM (1) The values are only archived in working memory.
VBA for Automated Configuration
4.6 VBA in Other WinCC Editors
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
2449
Enum HMIGO_TLG_ARCHIVE_COMPRESS_TYPE
Parameters Description
TLG_COMPRESS_TYPE_CALC (1) Only the compression values are calculated.
TLG_COMPRESS_TYPE_CALC_COPY (2) The compression values are calculated and the original
values copied.
TLG_COMPRESS_TYPE_CALC_DEL (3) The compression values are calculated and the original
values then deleted.
TLG_COMPRESS_TYPE_CALC_COPY_D
EL (4)
The compression values are calculated and the original
values copied and then deleted.
Example:
Sub CreateTlgArchive()
' HMIGO_010
' procedure to create an archive
' the archive must not 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"
'create tag logging archive
objHMIGO.CreateTlgArchive strArchiveName, TLG_PROCESSARCHIVE
'current status is "OPENED"
MsgBox objHMIGO.ObjectStateTlgArchive, vbOKOnly, "Status Tlg Archive"
Set objHMIGO = Nothing
End Sub
See also
GetTlgArchive Function (Page 2458)
ListTlgTag Function (Page 2463)
ListTlgArchive Function (Page 2461)
DeleteTlgTag Function (Page 2457)
DeleteTlgArchive Function (Page 2455)
CreateTlgTag Function (Page 2451)
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)
2450
System Manual, 11/2008,