ConvertExcelToCSVProcessor

描述:

将Microcoft Excel文档的每个工作表格(worksheet)转换成csv。该组件会对每个从输入Excel文档传入的工作表生成一个新的流文件。每个输出流文件的内容都会被格式化成csv文件，其中excel工作表中的每一行都会以新行写入到csv文件中。该组件目前只能支持.xlsx(SCCF 2007 OOXML文件格式)的Excel文档，不支持旧的.xls(HSSF '97(-2007)文件格式)文档。该组件还要求格式良好的CSV内容，并且不会转义包含无效内容(如换行或附加逗号等)的单元格。

标签:

excel, csv, poi

参数:

如下列表中，必填参数则标识为加粗. 其他未加粗参数，则表示为可选参数。表中同时提到参数默认值设置, 并且 参数还支持 表达式语言.

名字	默认值	允许值列表	描述
需要提取的工作表			指定需要从Excel文档提取的工作表列表名称，该列表以逗号分隔。如果此属性为空，则将提取Excel文档中的所有工作表。列表名称区分大小写，任何未在此值中指定的工作表都会被忽略。 支持表达式语言 (支持流属性和变量)
要跳过的行数	0		指定开始处理第一行时需要跳过的行数。通过该值可以跳过工作表顶部中不属于数据集的行内容。不论此值如何设置，表格中任何位置的空数据行都会被跳过。 支持表达式语言 (支持流属性和变量)
要跳过的列			指定要跳过的列的编码列表名称，该列表名称以逗号分隔。列表名称中使用的是列号而不是字母名称。使用此项可以跳过工作表中不希望被提取的任何列。 支持表达式语言 (支持流属性和变量)
格式化单元格的值	false	- true - false	指定单元格的值应该使用Excel中应用的格式写入CSV中，还是应该打印为原始值。
CSV格式	自定义格式	- 自定义格式 - RFC 4180 - Microsoft Excel - 制表符分隔 - MySQL格式 - Informix Unload - Informix Unload转义禁用	指定CSV数据的格式，或者指定是否使用自定义格式。
值分隔符	,		用于分隔CSV记录中的值/字段的字符。 支持表达式语言 (支持流属性和变量)
包含头部行	true	- true - false	指定是否应将CSV列名写入第一行。
引用字符	"		指定用于引用值的字符，以便不必使用转义字符。 支持表达式语言 (支持流属性和变量)
转义字符	\		指定那些对CSV解析器有特定意义的字符需要使用的转义字符。 支持表达式语言 (支持流属性和变量)
注释标记			用来表示注释开始的字符。任何以该注释开头的行都将被忽略。 支持表达式语言 (支持流属性和变量)
空字符串			指定一个字符串，如果该字符串在CSV中作为值出现，则应将其视为空字段，而不是使用其文本值。
裁剪(trim)字段	true	- true - false	是否应该删除字段开头和结尾的空格。
引用模式	不引用值	- 引用所有值 - 引用最小化 - 引用非数字值 - 不引用值	指定在写入字段时应如何引用它们。
记录分隔符	\n		指定用于分隔CSV记录的字符。
包含尾部分隔符	false	- true - false	如果为真，将在写入的每个CSV记录中添加一个尾部分隔符，如果为false，则省略后面的分隔符。

连线:

名字	描述
success	Excel数据成功转换成CSV的话，流文件将被路由到此连线。
failure	未能解析Excel文档的话，流文件将被路由到此连线。
original	该组件接收到的原始Excel文档将被路由到此连线。

读取属性:

未提供。

写入属性:

名字	描述
sheetname	这一行数据来自Excel文档中的Excel工作表的名称
numrows	次Excel工作表中的行数。
sourcefilename	此数据源自的Excel文件名称。
convertexceltocsvprocessor.error	处理每个Excel工作表时遇到的错误信息。只有在处理特定工作表时发生错误时才填写该属性。将错误呈现在工作表级别，允许用户可以在更广的范围内更好地理解excel文档中哪些语法错误导致了错误的产生。

状态管理:

该组件不保存状态。

限制:

该组件没有限制

系统资源考量:

未提供。