文本文件输出
组件介绍
组件作用
文本文件输出步骤将数据输出为文本文件,通常为表格文件, 如逗号分隔符文件(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 值 |