Mircrosft Excel 输出
组件介绍
步骤“Mircrosft Excel 输出”用于将数据写入 Excel 文件中。
- 输入：数据
- 输出：Excel 文件
- 参数：无
组件图标
页面介绍
文件&工作表标签
文件选项卡定义此步骤输出的基本文件属性。
参数选项
“Microsoft Excel输出”组件的文件&工作表标签页面包含如下选项：
| 选项 | 说明 | 样例值 |
|---|---|---|
| 文件名 | 您正在读取的电子表格文件的名称 | |
| 扩展名 | 文件的扩展名 | |
| 创建上级目录 | 启用以创建父文件夹 | |
| 在接收到数据前不创建文件 | 勾选这个选项使得转换只在看到一行之后才创建文件。如果这个选项被禁用，输出文件总是被创建的，不管行是否真的被写入文件。 | |
| 从字段中获取文件名 | 待输出配置文件的路径信息是否定义在上下文字段中 | 未选中 |
| 文件名字段 | 文件名对应的上下文字段名称 | |
| XSLX数据流 | 在写大的XLSX文件时，选中这个选项。它在内部使用流式API，能够在没有任何内存限制的情况下写入大文件（当然不能超过Excel的1,048,575行和16,384列的限制）。 | |
| 分割每...数据行 | 在输出n行后，通过输出到一个新文件来限制单个文件的大小或者行数 | |
| 文件名中包含 Transform 副本号 | 如果在多个副本中运行转换（参见启动一个转换的多个副本），副本编号将包含在文件名中，在扩展名（_0）之前。 | |
| 文件名包含日期 | 在文件名中包含系统日期 | |
| 文件名包含时间 | 在文件名中包括系统时间（24小时格式） | |
| 指定时间格式 | 是否选择自定义日期格式 | |
| 日期时间格式 | 选中“指定日期格式”，便可自定义日期时间的格式 | |
| 如果文件已存在 | 如果当前文件已存在，可以选择输出方式为：（1）覆盖原文件，（2）使用现有文件输出 | |
| 结果中添加文件名 | 检查是否将文件名添加到结果文件名中 |
工作表&模板标签
工作表&模板选项卡包含用于描述文件内容的选项。
参数选项
“Microsoft Excel 输出”组件的内容标签页面包含如下选项：
| 选项 | 说明 | 样例值 |
|---|---|---|
| 工作表名 | 将写入行的工作表名称。 | Sheet1 |
| 设为活动工作表 | 如果选中，在MS Excel中打开时，Excel文件将默认在上述工作表上打开。 | |
| 如果输出文件中已经存在工作表 | 输出文件已经有了这个工作表（例如，当使用模板，或写入现有文件时），你可以选择写入现有工作表，或替换它。 | |
| 保护工作表?(仅限XLS格式) | XLS文件格式允许保护整个工作表不被更改。如果选中，你需要提供一个密码。Excel将显示该工作表是由你在这里提供的用户保护的。 | |
| 保护人 | 指定用于保护的用 户 | |
| 密码 | 打开这个文件的密码 | |
| 使用模板创建新文件 | 如果选中，则在工作表上启用密码保护。您还必须在“密码”字段中指定密码 | |
| 模板文件 | 选择作为模板的文件 | template.xls |
| 使用模板创建新工作表 | 是否选择模板创建一个新的工作表 | |
| 模板工作表 | 定义模板工作表的名称 | |
| 隐藏模板工作表 | 不显示模板工作表 |
内容标签
标签指定数据 excel 的格式。
参数选项
“Microsoft Excel 输出”组件的内容标签页面包含如下选项：
| 选项 | 说明 | 样例值 |
|---|---|---|
| 开始输出自单元格 | 在Excel文件中开始写入的单元格（字母列，数字行） | A1 |
| 当输出记录时 | 转换可以覆盖现有的单元格，或将现有的单元格向下移动（在工作表的顶部添加新的行）。 | |
| 输出表头 | 如果勾选，写的第一行将包含字段名。 | |
| 输出表尾 | 如果选中，最后一行将包含字段名。 | |
| 自动调整列大小 | 如果勾 选了这个选项，转换将尝试自动调整列的大小以适应其内容。由于这不是xls(x)文件格式直接支持的功能，结果可能有所不同。 | |
| 强制公式重新计算 | 如果选中，转换将尝试确保输出文件中的所有公式字段都得到更新。 | |
| 不改变现有单元格格式 | 如果选中，转换将不会尝试设置它所写入的现有单元格的样式。这在写入预设风格的模板表时很有用。 |
字段标签
字段”选项卡定义了导出字段的属性。
字段表
该表包含以下列：
| 列名 | 说明 | 样例值 |
|---|---|---|
| 名称 | 字段名称 | |
| 类型 | 字段的数据类型；字符串，日期或数字 | |
| 格式 | 格式掩码（数字类型） | |
| 单元格样式 | 一个单元格（如A1、B3等），用来复制这一列的样式（通常是模板中的某个预设样式的单元格）。 | |
| 字段标题 | 如果设置，这将用于页眉/页脚，而不是合字段名。 | |
| 单元格表头/表位格式 | 一个用于复制页眉/页脚样式的单元格（通常是模板中的某个预设样式的单元格）。 | |
| 带 函数 | 如果该字段包含一个Excel公式，则设置为 "是"。 | |
| 超链接 | 一个字段，包含要链接的目标。支持的目标是链接到其他单元格、http、ftp、电子邮件和本地文档。 | |
| 单元格备注(XLSX) | xlsx格式允许在单元格上添加注释。如果你想生成评论，你可以为某一列指定持有评论和作者的字段。 | |
| 单元格备注作者(XLSX) | xlsx格式允许在单元格上添加注释。如果你想生成评论，你可以为某一列指定持有评论和作者的字段。 |
案例示例
案例数据
该文件共包含 6 条数据，其主要字段分别为 project_name、start_date 及 end_date。
案例操作
文件上传
该步骤将 csv 文件上传至 UDI 文件库中，为【CSV输入】组件提供 数据输入来源。
文件上传操作详情请见 文件上传
需要上传的数据文件：project.CSV
上传成功的 csv 文件可在 UDI 文件库中看到
CSV文件输入
读取 UDI 中的 csv 文件。
输入预览:
该组件配置主要分为 3 步：
第一步：选择需要加载的文件；
第二步：设置“列分隔符”与“封闭符”；
第三步：获取输入字段；
输入数据预览：
Microsoft Excel输出
作用：将数据写入 Excel 文件。
输入预览：
该组件配置主要分为 4 步：
第一步：命名 Excel 文件名，设置输出路径；
文件路径为：组件演示数据/输出数据/
文件名为：ExcelOutPutData
注意：
- 文件命名时不需要加后缀，可在“文件拓展名”处设置；
- Microsoft Excel输出组件默认创建文件输出到上级目录；
- Microsoft Excel输出时，同路径同名文件会被覆盖，可通过设置“如果文件已存在”选项进行设置，以免覆盖；
第二步：选择文件拓展名；
第三步：选择输出字段；
第四步:执行转换，转换生成的文件会在 UDI 文件库中看到
结果预览
