文本文件输出
组件介绍
组件作用
文本文件输出步骤将数据输出为文本文件,通常为表格文件, 如逗号分隔符文件(CSV),或者生成特定长度空格(比如Tab)分割的文件.
输入输出描述
- 输入:需要输出的文本文件
- 输出:文本文件输出到文件库
- 参数:无
组件图标
案例示例
该案例主要将Excel输入的数据文件作为csv文件输出,案例工作流如下图所示:
输入输出结果对比预览:
案例数据
数据共包括 20 条数据,主要字段分别为购药时间、社保卡号、商品编码、商品名称、销售数量、应收金额及实收金额。
案例操作
文件上传
步骤将本地文件上传到 UDI 文件库中, 为 Excel 组件提供数据输入来源。
需要上传的数据文件:朝阳医院2018年销售数据.xlsx
在 UDI 文件库中可以看到上传后的文件。
Excel输入
此步骤利用【Excel输入】组件读取 UDI 中的 xlsx 文件。
Excel输入组件使用详情见Excel文件输入
输入文件:
该组件配置主要包括 2 步:
第一步:选择要加载的文件;
注意:
- 表格类型(引擎)需要选择为 [Excel XLSX, XLS]
第二步:配置需要读取的字段;
输入结果预览:
文本文件输出
该步骤主要将输入的 Excel 数据文件以 csv 格式文件输出。
该组件配置主要分为 3 步:
第一步:设置文件输出路径,修改输出文件拓展名为 csv;
文件路径为:组件演示数据/输出数据/ 文件名为:CsvOutPutData
第二步:设置分割符及封闭符;
第三步:获取输出字段;
结果预览
执行转换,转换生成的文件会在 UDI 文件库中看到;
将输出路径下的csv文件下载至本地后查看数据,数据结果如下图所示:
页面介绍
步骤有"文件"."内容","字段"三个标签页
文件标签
页面介绍:
属性 | 属性说明 | 样例值 |
---|---|---|
步骤名称 | 步骤名称,在转换中,此名称唯一 | |
文件目录 | 指定输出文件的位置 | |
文件名称 | 指定输出文件的文件名,与文件目录一起组成文件路径,当需要附加日期和时间,并指定扩展名选项时,文件名称请勿包括文件扩展名 | |
结果输送至命令行或脚本 | 若勾选,将把结果输出到命令行或脚本 | |
输出传递到Servlet | 若勾选,使用Web服务输出流而不是写入文件来返回数据 | |
启动时不创建文件 | 若勾选,可避免转换开始前创建文件, | |
从字段中获取文件名 | 若勾选,可在“ 文件名字段”中选择输入流中字段为输出文件名 | |
文件名字段 | 在输入流中指定将在运行时包含文件名的字段 | |
扩展名 | 指定扩展名附加到文件名称中,默认为txt | |
文件名里包含步骤数 | 若勾选,当多个副本运行步骤(启动一个步骤的多个副本)时,将副本号包括在文件名中(例如_0) | |
文件名里包含数据分区号 | 若勾选,将在文件名中包括数据分区号 | |
文件名里包含日期 | 若勾选,将在文件名中包含系统日期, 例如_20201111 | |
文件名里包含时间 | 若勾选,将系统时间包含在文件名中(例如_235959) | |
指定日期时间格式 | 若勾选,将使用“日期时间格式”中的格式在文件名中包括日期时间 | |
时间日期格式 | 在下拉框中选择时间 日期的格式。 | |
结果中添加文件名 | 默认勾选,如果不想将文件名添加到输出文件,请清除 |
内容标签
页面介绍:
属性 | 属性说明 | 样例值 |
---|---|---|
追加方式 | 若勾选,数据行将被追加到文件末尾 | |
分割符 | 用于在文本单行中分割字段的字符,通常为分号或制表符。单击“ 插入TAB”以将制表符填入。默认值为分号(;) | |
封闭符 | 用一对字符将字段中的字符串括起来,允许在字段中使用分隔符,此设置是可选的,可以保留为空白。默认值为双引号(")。 | |
强制在字段周围加封闭符 | 若勾选,将强制所有字段名称都用指定的“封闭符”括起来。 | |
禁用封闭符修复 | 若勾选,将忽略字符串字段和分隔符上的封闭符。 | |
头部 | 勾选,表示输出文件中的第一行是标题行。 | |
尾部 | 若勾选,指定输出文件中的最后一行是页脚行。勾选“ 封闭符”选项时,无法在追加新行之前从文件内容中删除页脚。 | |
格式 | 指定要使用的格式类型。它可以是DOS、UNIX、CR 或 None。UNIX文件的行由换行分隔,而DOS文件的行由回车和换行分隔。默认值为CR + LF(Windows,DOS)。 | |
压缩 | 指定压缩输出文件时要使用的压缩类型(.ZIP或Gzip),单个存档中仅放置一个文件。默认值为“None”。 | |
编码 | 指定要使用的文件编码,默认空白将使用系统上的默认编码。若需要使用Unicode,请指定UTF-8或 UTF-16。首次使用时,UDI 会在系统中搜索可用的编码。 | |
字段右填充或裁剪 | 若勾选,可在字段的末尾添加空格(或在末尾删除字符),直到达到“ 字段”标签下表格中指定的长度。 | |
快速存储数据(无格式) | 若勾选,通过不包含任何格式信息来将大量数据转储到文件,将提高性能。 | |
分拆...每一行 | 如果数字N大于零,则指定将结果文件分成N行的多个部分。 | |
添加文件结束行 | 指定输出文件的替代结尾行。 |
字段标签
字段列表:
名称 | 字段名称 |
---|---|
类型 | 字段类型,可以是String、Date或Number等类型 |
格式 | 用于转换原始字段格式的可选掩码 |
长度 | 字段的长度取决于以下字段类型 Number:数字中有效数字的总数 String:字符串的总长度 Date:字符串的打印输出长度 |
精度 | 数字类型字段的浮点位数 |
货币 | 用于表示货币的符号(例如¥或$) |
小数 | 小数点可以是“.”或“,”(例如5,000.0或5.000,0 |
分组 | 分组可以使“.”或“,”(例如5,000.0或5.000,0) |
空字符串方式 | 应用于字符串中空格的修剪方法 |
Null | 该值视为 Null 值 |