YAML 输入
组件介绍
组件“YAML 输入”用于读取 YAML 文件中的数据。
- 输入:需要读取的 YAML 文件
- 输出:读取的 YAML 文件的内容
页面介绍
文件标签
在“文件”标签卡中,可以定义要从中读取的 YAML 文件位置。
参数选项
“YAML 输入”组件的文件标签页面包含如下选项:
选项 | 说明 | 样例值 |
---|---|---|
文件名定义在字段里? | 如果勾选该选项,则此步骤会从上一个数据流中读取相应的数据并且当作 YAML 文件名读取数据 | |
是文件? | 如果文件名为YAML源文件,请选中此选项。否则,它将被视为YAML流。 | |
从字段获取文件名 | 选择从上一步骤中哪一个字段读取相应的文件名数据 | |
文件或目录 | 指定输入文本文件的位置和/或名称。 | |
正则表达式 | 在上一个选项中指定的目录中指定要用于选择文件的正则表达式。例如,您要处理所有扩展名为 .txt的文件。 |
字段表
组件底部表格为字段表,在配置好参数后,点击“添加”按钮即可根据上述配置信息自动填充字段表。该表包含以下列:
列名 | 说明 | 样例值 |
---|---|---|
文件/目录 | 文件或者目录的名称 | |
通配符(正则表达式) | 与参数中的正则表达式部分相同 | |
要求 | 是否必须 | |
包含子目录 | 是否匹配子目录 |
内容标签
在“内容”标签卡中,可以设置读取的 YAML 文件数据的内容。
参数选项
“YAML 输入”组件的内容标签页面包含如下选项:
选项 | 说明 | 样例值 |
---|---|---|
忽略空文件 | 如果希望跳过空文件,请勾选此选项。否则一旦发现空文件,该组件会停止运行 | |
忽略空路径 | 如果您想避免在没有要处理的文件时此步骤失败,您可以选择此选项。 | |
限制 | 限制结果中的行数 | |
在输出中包含文件名 | 如果选中,则会添加一个包含文件名的字段 | |
文件名字段 | 文件名字段的名称 | |
在输出中包括行数 | 如果选中,则会添加一个包含行数的字段 | |
行数名字段 | 行数名字段的名称 | |
将文件名添加到结果文件中 | 将文件名添加到结果文件中 |
字段标签
在“字段”标签卡中,可以获取到当前文件下的相关字段参数。
字段表
右击选择“获取字段”,组件可根据当前指定设置从源文件获取相应内容填充字段表。该表包含以下列:
列名 | 说明 | 样例值 |
---|---|---|
名称 | 字段名 | |
键 | 从文件中提取的路径 | |
类型 | 字段类型,可以是String、Date或Number等类型。 | |
格式 | 用于转换原始字段格式的可选掩码。 | |
长度 | 字段的长度取决于以下字段类型:Number:数字中有效数字的总数。String:字符串的总长度。Date:字符串的打印输出长度。 | |
精度 | 数字类型字段的浮点位数。 | |
货币类型 | 用于表示货币的符号(例如¥或$)。 | |
小数点符号 | 小数点可以是“.”或“,”(例如5,000.0或5.000,0)。 | |
分组符号 | 分组可以使“.”或“,”(例如5,000.0或5.000,0)。 | |
去除空格符号 | 应用于字符串中空格的修剪方法。 |
使用案例
拖拽“YAML 输入”组件至画布中,双击组件,点击“浏览文件”,选择需要上传文件的目录,这里我们使用了 Invoice.yaml 文件做示范。最后在“字段标签”下,右击空白部分并选择“获取字段”,若信息填入无误,则会在空白部分显示数据字段。参数设置和结果如下图所示。
点击“确定”,再点击左上角“运行这个转换”,组件右上角将出现绿色正确符号,表示转换执行成功,右击该组件选择“预览数据”,得到结果如下图所示,表格中的数据就是 Invoice.yaml 文件的内容。