Skip to main content

Module: DataLog Storage CSV

The submodule DataLogStorage_CSV defines the storage format of a DataLog channel as CSV file. It can be added below a DataLog channel node. This is done by the Add Submodule Instance command and the selection of the DataLogStorage_CSV module.

Dialog: Parameters

Storage name

Name of the storage file

By default the placeholder %CHANNEL_NAME% is defined. This placeholder will be replaced by the instance name of the superior DataLog channel. The storage file name must be unique, since all storage files are stored in the same directory.by default.

Optionally a placeholder %DATE% can be added for the date of storage. The resolution is defined in the parameter Format string for replacing %DATE%, see below.

Example: With a name specification '%CHANNEL_NAME%_AT_%DATE%' for the channel DataLogChannel_1 for example the following file name results for this channel: Application_DataLogChannel_1_AT_20191211_02-10-30.csv.

Separator:

ASCII value for separator between variable name and value.

Example: ','

Buffer size:

Size of the internal buffer for temporary storage of the entries.

Example: 2000

Buffer fill level

Value in percentage.

If the buffer is filled up to this value, the content of the buffer is written to the CSV file. Specifying 0 deactivates buffering.

The entry has the following form: (with | as separator): <TimeStamp>|<InstancePath/Hash>|<Value>[|<TypeClass>]

If the storage is executed with hashed paths the data type is not stored with every entry but only once in a separate file where the assignment hash ↔ Instance path is stored. The entry in this file has the form: <InstancePath>|<TypeClass>|<Hash>.

In case of an online change the files are not deleted. The new entries are appended. In the hash file an online change is marked with a time stamp. Thus the assignment of hash ↔ instance path for entries before online change is still possible.

During initialization after a download (no online change) the data and hash files are deleted.

Enclosing characters

Add enclosing characters

TRUE: String entries will be stored with surroundings.

Example: Variable value: File1, file entry: -File1-.

FALSE: String entries are stored without enclosing characters.

Enclosing characters

Characters used for enclosing.

Example: '-'

Format string for replacing %DATE%

Date format used to replace the %DATE% which can be specified in parameter Storage Name, see above.

Examples: 'yyyyMMdd', 'yyyyMMdd_hh-mm-ss'

Dialog: Information

For details about these dialogs, see the help page in Information.