参数HEADER HEADER 参数为指向定义 CSV 文件标题的数据块 VARIANT 的指针，。此标题始终为 CSV 文件表示的第一行。 • 由 HEADER 预设的标头将传送到 CSV 文件中。此时，不会检查该标头是否与数据日志的其余部分相一致。而且，不会检查由逗号分隔的列数目是否与数据列的数目相匹配。 • STRING、Array of BYTE 或Array of CHAR 数据类型可用于各列名称。使用 STRING 数据类 型时，其长度不能超过 254 个字节。如果使用Array of BYTE 和 Array of CHAR，则可包含 5000 个元素。 如果未在 HEADER参数中指定一个值，或者 HEADER 位于负载存储器中，则不创建标题。如果 TIMESTAMP 的值为 1、3 和5，则在标头的开始处插入以下文本："Record, Date, UTC Time,"。 如果 TIMESTAMP 的值为 2 和4，则在标头的开始处插入以下文本："Record, Date, Loc Time,"。 参数 TIMESTAMP 下表列出了TIMESTAMP 参数可能的值。 值 DATE_AND_TIME 的格式 时间源 0 - 无时间戳 1 • S7 1200：S71500：系统时间 2 • S7-1200 CPUmm • S7-1500 CPU 固件版本 V2.6 及以上版本： 本地时间 3 • S7-1200 CPU 固件版本 V4.5 及以上版本：S7-1500 CPU 固件版本 V2.6及以上版本：系统时间 4 • S7-1200 CPU 固件版本 V4.5 及以上版本： S7-1500 CPU 固件版本V2.6 及以上版本：本地时间 5 • S7-1200 CPU 固件版本 V4.5 及以上版本：• S7-1500 CPU 固件版本V2.6 及以上版本：系统时间 参数 DATA 参数 DATA 是一个指向数据块中某个基本数据类型、结构或数组的 VARIANT指针。结构或数 组的一个元素对应于特定数据类型的数据记录中的某一列。
在创建数据块时，请注意以下事项：• 通常，列数目与 HEADER 参数中所定义的列数目相匹配，但并非强制规定。 • 该结构或数组中的各个元素与 CSV文件中的某列条目相对应。因此，在使用数据类型 STRUCT 时，不能使用嵌套结构（STRUCT 中包含 STRUCT）。在 ARRAY数据类型中通常 支持 STRUCT，但以下情况除外：不支持元素数据类型为“PLC 数据类型 (UDT)”的数组。 •数据结构可包含Zui多 256 个元素。如果有超过 256 个元素，将在 STATUS 参数处输出错 误代码 8C52。 •数据块变量可设置为保持型或非保持型变量。但是，数据块中所有变量的保持型设置都 必须相同。DataLogCreate 示例在以下示例中，将创建一个简单的数据记录，带有一个时间戳和三个过程值。 全局数据块中的变量数据记录的输入参数值将存储在全局数据块“DataLogDB”中： • DataLogName (String)：该变量包含同时用作CSV 文件名的数据日志名称。 • DataLogID (DInt)：调用该指令时，将数据记录 ID 写入该变量中。 –该指令会自动分配数据记录的 ID。 – 在其它 DataLog 指令中，可使用变量“DataLogID”寻址该数据记录。 •MyHeader (String)：该变量中包含数据日志的标头，即过程值的列标题。 • MyData(Struct)：该变量中包含将写入数据日志的 3 个过程值。每次写入一个记录（指令 “DataLogWrite(页 3318)”）时，都会将当前值写入一个新记录中。调用“DataLogCreate”指令 通过以下输入参数调用该指令：• REQ (BOOL)：REQ =“TRUE”时，创建数据日志。 • RECORD (3)：在数据日志中，Zui多可写入 3个数据记录。之后，将覆盖Zui旧的数据记录。 • FORMAT (1)：将数据日志创建为 CSV 文件。• TIMESTAMP(1)：启用：将自动创建数据记录的两个附加列（日期和时间）。每次执行 “DataLogWrite(页 3318)”时，都将当前时间戳写入数据记录中。 • NAME(VARIANT)：指向数据块“DataLogDB”中变量“DataLogName”的指针。 • ID(DWORD)：指向数据块“DataLogDB”中变量“DataLogID”的指针（仅输出）。 • HEADER(VARIANT)：指向数据块“DataLogDB”中变量“MyHeader”的指针。 • DATA(VARIANT)：指向数据块“DataLogDB”中变量“MyData”的指针。通过 Web 服务器读取数据记录 可通过 Web服务器读取创建的数据日志： • 在 CPU 的属性中激活 Web 服务器。要读取数据记录，必须激活 Web 服务器的“...读取文件”(...to read files) 权限。 • 可通过在 Internet 浏览器中输入 CPU 的 IP 地址作为 URL访问 Web 服务器。 • 系统将在“Filebrowser”下，自动创建一个包含数据记录的目录“\DataLogs”。此外，也可以查看菜单的“DataLogs”。 • 如果指令“DataLogWrite (页 3318)”尚未执行，则 DataLog中将只包含一个条目“//END”。 首次执行“DataLogWrite(页 3318)”时，系统将写入第一个数据记录。
DataLogOpen：打开数据日志(S7-1200, S7-1500) DataLogOpen： 打开数据日志 (S7-1200) 说明使用“DataLogOpen”指令，可以打开存储卡上的现有数据日志。要将新的数据记录写入数据 日志中，必须打开一个数据日志。执行“DataLogCreate (页 3303)”和“DataLogNewFile(页 3325)”指令时，将自动打开数据 日志。 Zui多可同时打开 10 个数据日志。可通过数据日志的 ID或名称，选择需打开的数据日志。 • 如果在 ID 和 NAME 参数中分别指定了数据记录的 ID 和名称，则该数据日志将通过 ID 进行标识，而不再比较数据记录的名称。 • 如果使用参数 NAME 选择数据日志并将 0 指定为 ID，则在打开数据日志时，将在 ID 参数中显示该数据日志的 ID。 • 如果使用 ID 参数选择了数据日志而未指定名称，在打开数据日志时名称将显示在 NAME 参数中。可以使用 MODE 参数指定在打开时是否删除数据日志中的数据记录。下表列出了“DataLogOpen”指令的参数： 参数 声明数据类型 存储区 说明 REQ Input BOOL I、Q、M、L、D 或常量 在上升沿执行指令。 MODE Input UIntI、Q、M、L、D 或常量 打开数据日志的方式： • MODE=“0” 保留数据日志中的数据记录 • MODE=“1”删除数据日志的数据记录，但保留标题 NAME Input VARIANT L、D 数据日志的（文件）名称。 ID InOutDWORD I、Q、M、L、D 数据日志的对象 ID。 DONE Output BOOL I、Q、M、L、D 指令已成功执行。BUSY Output BOOL I、Q、M、L、D 指令的执行尚未完成。 ERROR Output BOOL I、Q、M、L、D •0：无错误。 • 1：指令执行过程中发生错误。 详细信息将在 STATUS 参数中输出。 STATUS Output WORDI、Q、M、L、D 状态参数 该参数设置仅维持一次调用所持续的时间。因 此，要显示其状态，应将 STATUS 参数复制到可用数据区域。 有关有效数据类型的更多信息，请参见“有效数据类型概述。DataLogOpen：打开数据日志 (S7-1500) 说明使用“DataLogOpen”指令，可以打开存储卡上的现有数据日志。必须先打开一个数据记录， 才能写入新的数据记录。执行“DataLogCreate (页 3303)”和“DataLogNewFile(页 3325)”指令时，将自动打开数据 日志。Zui多可同时打开 10 个数据日志。可通过数据日志的 ID或名称，选择需打开的数据日志。 • 如果在 ID 和 NAME 参数中分别指定了数据记录的 ID 和名称，则该数据日志将通过 ID 进行标识，而不再比较数据记录的名称。 • 如果使用参数 NAME 选择数据日志并将 0 指定为 ID，则在打开数据日志时，将在 ID 参数中显示该数据日志的 ID。 • 如果使用 ID 参数选择了数据日志而未指定名称，在打开数据日志时名称将显示在 NAME 参数中。可以使用 MODE 参数指定在打开时是否删除数据日志中的数据记录。 通过 DATA参数可以检查要打开的数据记录是否与“DataLogCreate (页 3303)”指令的数据记 录定义一致。此时，系统将检查参数DATA 的数据类型是否与“DataLogCreate”的数据类型相 同。如果不相同，则在参数 STATUS 处输出错误代码W#16#8090。 说明 数据日志打开时加载修改的数据结构如果数据日志打开并加载属于该数据日志的已修改数据结构，则数据日志将损坏。下表列出了“DataLogOpen”指令的参数： 参数 声明数据类型 存储区 说明 REQ Input BOOL I、Q、M、L、D、 T、C 或常量 （对于 S7-1500， T 和 C只能在 LAD 和 FBD 中使用） 在上升沿执行指令。 MODE Input UInt I、Q、M、L、D 或常量打开数据日志的方式： • MODE =“0” 保留数据日志中的数据记录 • MODE=“1” 删除数据日志的数据记录，但保留标题NAME Input VARIANT L、D 数据日志的（文件）名称。 ID InOut DWORD I、Q、M、L、D数据日志的对象 ID。