记录变量
记录变量包含从名称字段对的数据库、电子表格或表中提取的一行数据。这些字段可以存储布尔值、日期时间、数字或字符串数据类型。
使用记录变量
记录变量通常用于循环 action 中存储一行检索到的数据;您可以通过指定索引号或名称来访问单个值。索引号是名称字段对的位置。名称要么在变量初始化时配置,要么从源表的列标题中提取。
以下是一个示例表:
CustomerName | City |
---|---|
Dana | Pittsburgh |
Sam | Los Angeles |
Alex | Boston |
rCurrentRow
。要从每行的第一列检索值,请使用索引号 $rCurrentRow[0]$
或名称 $rCurrentRow{CustomerName}$
。架构
架构类似于记录字段的模板。它设置字段的顺序以及可在每个字段中输入的数据类型。
- 检索的值必须与已配置的字段数据类型匹配。
例如,数据集
[{"name":"Sally"},{"id":002},{"dob":03/05/1989}]
可以分配给具有架构[{"name":String},{"id":Number},{"dob":Date}]
的记录变量。 - 数据集属性必须遵循相同的顺序和大小写。
例如,数据集
[{"name":"Henry"},{"id":003},{"dob":06/13/2001}]
无法分配给使用架构[{"id":Number},{"name":String},{"dob":Date}]
或{"Name":String},[{"ID":Number},{"DOB":Date}]
的记录变量。 - 如果字段顺序相同,记录变量可接受已配置字段的超集。
例如,数据集
[{"name":"Alex"},{"id":004},{"dob":12/10/1995},{"pet":"yes"}]
可以分配给具有架构[{"name":String},{"id":Number},{"dob":Date}]
的记录变量。 - 记录变量不接受数据子集。
例如,数据集
[{"id":005},{"dob":05/21/1975}]
无法分配给使用架构[{"name":String},{"id":Number},{"dob":Date}]
的记录变量。
如果 bot 遇到不符合记录变量架构的数据行,则 bot 失败。这将防止 bot 传递不正确或无效的数据到下一个 action。