底部追加
活动说明
该活动主要用于在Excel文件中添加内容,以工作表中有内容的行作为参考,将下一行作为添加的起始位置
执行逻辑:RPA查找文件的完整路径对应的Excel文件,通过设置的工作表名称定位到需要写入内容的工作表,判断追加内容的数据格式是数据表内容还是二维数组内容,将数据写入,如果追加内容选择数据表内容时,可以设置列写入顺序,同时在写入时可以为数据添加标题,根据是否添加标题选项值"是"和"否"进行判定,标题的格式为:Column_1)Column_2...
属性说明
输入项
文件的完整路径
支持三种填入方式:
填写Excel文件的完整路径
点击输入框右侧的图标,出现文件选择窗口,选择文件后自动填入完整路径
使用变量
工作表名称
填写Excel文件中已有的工作表名称如"Sheet1",如果不填,则默认在"Sheet1"工作表添加内容
追加内容
[下拉选项]
待写入到工作表中的内容,包含两个选项值,分别是数据表内容和二维数组内容
数据表内容
[数据表]
当"追加内容"选择\"数据表内容\"时显示,一般需输入数据表类型的变量,不建议直接填入数据表类型的数据(在写入时可能会出现乱序)
二维数组内容
[\< lEnumerable\
当"追加内容"选择\"二维数组内容\"时显示,输入Object[]类型的二维数组变量,也可以直接填写Object[]类型的数据,内容格式为:[[\"\",\"\",\"\"]],在输入框写入时无需在最外层添加英文引号
列写入顺序
仅在"追加内容"选择「数据表内容」时生效,追加可设置列的写入顺序
例1:当数据表类型变量数据格式为[{\"姓名\":\"小明\",\"年龄\":\"12\",\"性别\":\"男\"},{\"姓名\":\"小红\",\"年龄\":\"21\",\"性别\":\"女\"},{\"姓名\":\"小华\",\"年龄\":\"11\",\"性别\":\"男\"}]时,可自定义列写入顺序为['姓名','性别','年龄']
例2:当数据表类型变量数据格式为[{\"Column_1\":\"小明\",\"Column_2\":\"12\",\" Column_3\":\"男\"},{\"Column_1\":\"小红\",\"Column_2\":\"21\",\"Column_3\":\"女\"},{\" Column_1\":\"小华\",\"Column_2\":\"11\",\"Column_3\":\"男\"}]时,可自定义列写入顺序为['Column_3','Column_1','Column_2']或['Column_2','Column_1','Column_3']
是否添加标题
[单选框]
选择是否添加标题,若选择"是",则写入时会添加标题,第一个标题默认为"Column_1",第二标题默认为"Column_2",以此类推;若选择"否",则写入时不会添加标题,只写入内容
使用示例
该活动一般需要与其他活动如"抓取表格"、"获取指定区域内容"、"创建数据表"等活动结合使用,以"获取指定区域内容"+"底部追加"为例
[(获取指定区域内容使用说明)]
例1:追加内容选择数据表内容时
属性栏设置:
- "获取指定区域内容":
- "底部追加":
执行步骤:
如图,设置以上参数时,RPA将会进行七步操作:
通过"获取指定区域内容"活动将名称为"考试成绩"的excel文件中的内容传递到data变量中;
开始执行"底部追加"活动,根据设置的文件路径查找名为测试excel的文件;
根据设置的工作表名称查找工作表Sheet1;
4)根据选择的追加内容为数据表内容,读取数据表内容栏位data变量中表示的数据
5)判断是否指定列写入顺序,当前列写入顺序栏位为空,未进行指定
6)判断是否需要添加标题,当前设置为"否"
7)开始写入数据
运行结果:
"考试成绩"的excel文件的数据:
"测试excel"的excel文件的数据:
活动执行后,"测试excel"的excel文件的数据:
如果将"底部追加"的活动属性"是否添加标题"中设置的为\"是\"
再次执行两个活动,合并后的数据如下:
需要说明的是,因为该活动为"底部追加",并不会清除之前的数据,在使用该活动时,需要注意这一点。
由上图可知,当前"测试excel"文件中是按照【姓名,性别,年龄】顺序进行排列的,如果希望按照【姓名,年龄,性别】的顺序排列,就需要使用到属性中的"列写入顺序"
"获取指定区域内容"属性:
"底部追加"属性:
数据表类型的数据中有时候可能没有列,只有数据,因此设置了"列写入顺序"运行时会出现报错的问题,在该例中,在"获取指定区域内容"活动属性中需将"是否将第一行设置为列名"设置为"是",数据中才会有列信息,再次运行两个活动:
当追加内容选择二维数组内容:
底部追加属性:
如图,设置以上参数时,RPA将会进行五步操作:
1)通过"获取指定区域内容"活动将名称为"考试成绩"的excel文件中的内容传递到array_content变量中;
2)开始执行"底部追加"活动,根据设置的文件路径查找名为测试excel的文件;
3)根据设置的工作表名称查找工作表Sheet1;
4)根据选择的追加内容为数据表内容,读取数据表内容栏位array_content变量中表示的数据
5)开始写入数据
需要注意的是,当追加内容选择二维数组内容时,列写入顺序和是否添加标题的设置不会生效
"考试成绩"的excel文件的数据:
"测试excel"的excel文件的数据:
活动执行之后,"测试excel"的excel文件的数据:
此外,不同于数据表类型的数据,二维数组可以直接写入数据,进行执行,如图是修改后的"底部追加"的活动属性:
这样设置后,单独运行"底部追加"后,可以得到上述两个活动执行一样的效果
注意事项
执行该活动时,首先要关闭该活动用到的Excel文件,否则活动运行时会出现报错提示
属性字段"列写入顺序"和"是否添加标题"仅在"追加内容"设置为"数据表内容"时生效