ICT测试日志 --2--解释日志记录
文章目录
- [ICT测试日志 --2--解释日志记录](#ICT测试日志 --2--解释日志记录)
解释日志记录
到目前为止，所有示例仅展示了记录前缀，而没有展示每个记录包含的测试数据。本节介绍数据在日志记录中的格式，并进一步说明如何将实际日志记录分组为日志数据文件。
虽然以下示例说明了实际日志记录的结构，但示例所示内容不一定完整。请参阅各个日志记录的描述以获取完整的详细信息。
每个日志记录都用大括号括起来。记录以{开头，紧跟前缀，以}结尾。例如，描述电容器测试的@A-CAP记录简化后如下所示：
{@A-CAP. . . 数据字段 . . .}
前缀后跟一个或多个可变长度的数据字段，这些字段包含描述信息。使用竖线符号 | 作为字段之间的分隔符。在上面的示例中添加字段名称，我们得到：
{@A-CAP|测试状态|测量值|子测试标识}
请查看各个日志记录的描述以获取每个日志记录相关联的字段名称。
如果我们用典型数据替换字段名称，一个@A-CAP记录可能如下所示：
{@A-CAP|1|1.246700E+01|C1}
如果某个字段是可选的，分隔符字符仍然必须出现以作为占位符。例如，如果上述@A-CAP记录没有为测量值字段分配值，它将如下所示：
{@A-CAP|1||C1}
注意竖线仍为空的测量值字段的测试状态和子测试标识字段间预留了空间。
每个字段必须包含某种类型的信息。日志记录描述在"类型"下显示，如表8-2所示。
表8-2
日志记录类型
| 类型 | 描述 |
|---|---|
| bool | 布尔型，可以为真值（1或Y）或假值（0或N） |
| fp | 浮点数，可以是一个整数，后跟小数点和任意数量的连续数字，所有这些可以选择后跟字母E（不区分大小写）和一个整数 |
| int | 整数，可以是一个可选的符号字符（+或-），后跟一个或多个连续的数字 |
| str | 字符串值，可以是任意数量的任意类型字符（除非另有说明） |
如果留空，大多数字段默认为某个预定义的值。日志记录描述在"默认值"下标记为：
0, 1, 等等，默认数值""空字符串
如果字段的默认值没有意义（即，报告值是必需的字段），则在"默认值"下有一个问号（?）。
某些日志记录包含数据列表。在这种情况下，初始分隔符字符（表示有列表跟随）是反斜杠 \，列表中的各个项目以竖线分隔。例如，@NODE日志记录包含节点标识符列表：
{@NODE\node list|item 1|item 2| . . 等等}
用值替换字段名称后，我们得到：
{@NODE\2|Node53|+5Volts}
列表中的第一个条目指明列表中出现了多少个项目。因此，2 表示列表中有两个项目：Node53和+5Volts。
某些日志记录后跟一个或多个子记录，包含附加信息。例如，@PF记录可以跟一个包含引脚列表的@PIN记录：
sh
{@PF|2
{@PIN\2|11434|22216}
}换句话说，@PF记录由其后的@PIN记录进一步描述。
注意括号的层次结构 - @PIN记录在@PF记录的整体括号内有自己的一对起始和结束括号（{和}）。还要注意，@PF记录的结束括号被放在新行上，并且@PIN记录被缩进，以使整体记录的结构更加明显。缩进和新行仅用于说明目的；它们未必在实际日志数据文件中出现。
如果您查看i3070线路测试系统生成的实际日志数据，您会发现某些情况下子记录与其关联的记录位于同一行，而其他情况下则不会。重要的是要记住，日志记录必须按正确的顺序出现，并且必须用括号准确地定义。
去掉缩进和新行，实际日志记录看起来如下：
{@PF|2{@PIN\2|11434|22216}}
这种括号和缩进的层次结构同样适用于更复杂的嵌套日志记录组。请考虑以下示例：
sh
{@TS|1|2|1|1|
{@TS-S|2|0|Node12
{@TS-D|Node25|1.678850E+00}
{@TS-D|Node26|2.543211E+00}
}
{@TS-O|Node43|Node14|-1.500000E+00}
{@TS-S|0|1|Node38
{@TS-P|-1.243853E+02}
}
}在这种情况下，一个整体@TS日志记录包含三个子记录，每个子记录分别报告与整个@TS日志记录报告的短路测试相关的短路、开路和伪短路。@TS记录中的两个子记录包含进一步描述它们的子记录。注意括号的配对；每个开始的括号对应一个结束的括号。
到目前为止，我们提到过四个可能出现在日志记录中的特殊字符：{, }, |, 和 \。但假设这些字符之一或多个必须出现在数据字段内，而不是被解释为数据字段的分隔符。另一个特殊字符，波浪号（~），用于标识应按字面解释的数据字段，即字面字段。与普通字段不同，这个字面字段必须精确定义其长度。例如：
~12|!$%(test)|!|
字段中的实际数据是!$%(test)|!|。波浪号（~）标识字段为特殊情况，12代表字段的长度为十二个字符，紧跟在12后的竖线（|）分隔了长度规格和数据。
如果此字段出现在日志记录中，它可能如下所示：
{@RPT~12|!$%(test)|!|}
注意，字面字段开始的波浪号替代了通常的竖线（|）分隔符；不要同时使用两个分隔符。
如果您生成的自定义日志记录包含换行符，即ASCII 10（CTRL-J），则必须将换行符放在字面字段中；否则，它会被误解为记录与子记录之间的可选分隔符。
如果需要使用BT-Basic操作日志记录，您应使用自由字段格式将记录的各个字段输入到变量中。
关于截断记录的注意事项
如果您使用自定义数据记录例程，请注意，数据中出现截断字符（ASCII 4，CTRL-D）将被解释为日志数据意外中断并且当前日志记录已结束。
例外情况是截断字符可以出现在用波浪号（~）标记的字面字段中；这并不表示记录已被截断。
截断字符之前的数据被视为有效，并且任何后续日志记录都将被视为正常，前提是它们不包含截断字符。
关于测试步骤的注意事项
除了类型和序列号外，电路板还可以通过测试步骤进行识别。测试步骤指的是电路板在制造过程中的哪个步骤进行测试，例如，在线测试或功能测试。@BATCH日志记录包含一个测试步骤数据字段，您可以在其中放置一个简短的代码，以识别电路板在测试过程中处于哪个步骤上进行测试。
请注意，Pushbutton Q-STATS 不使用测试步骤。然而，如果您正在生成自定义日志记录，并且预计将来会使用可选的Q‑STATS II质量管理软件（该软件确实使用测试步骤），那么您可能希望现在开始收集测试步骤信息。
关于用户定义日志记录的注意事项
"log" 和 "log using" 语句分别允许您以自由字段和图像格式创建用户定义的日志记录。用户定义的日志记录可以模拟现有日志记录，也可以从头开始创建以用于自定义应用（这需要自定义例程来处理非标准日志记录）。