循环Excel区域

描述：循环输出Excel中选取的数据

属性说明

通用属性

前置延时- 指可设置组件功能执行之前等待的时间，单位为“毫秒”
后置延时- 指可设置组件功能执行后等待的时间，单位为“毫秒”
备注- 指对组件进行备注说明，以便于理解和快速定位

目标属性

文件- 设置Excel文件路径，可点击右侧的图标，选择需要操作的Excel文件
注意
- 输入的是Excel文件的绝对路径
- 手动输入时要确保文件存在，如遇到斜杠转译，可以在路径字符串前添加一个“r”防转义，如 r'C:/test/data1.xlsx'
- 可使用变量代替文件路径
工作表- 设置要进行操作的Sheet页
注意
- 可输入工作表所在文件的下标（整型），默认值为0，代表了Excel文件中的第一个Sheet页，填入相应的数字代表了相应的Sheet页；
- 可使用真实的Sheet页名称（字符串），如‘测试3’，需要注意区分大小写，必须一模一样
单元格区域- 设置需要操作的单元格区域，输入为字符串。
注意
- 可点击输入框右侧在Excel中指出单元格区域按钮，在Excel选中单元格后，即可自动获取当前操作的Excel文件、工作表、单元格等数据
- 使用在Excel中指出单元格区域功能，会使用系统默认的方式打开Excel文件，请确保系统默认的打开方式可以正常打开Excel文件
- 用户可直接输入要读取的单元格范围，例如 'A1:C3' ，即表示A1到C3的单元格区域
- 可使用变量代替，或直接表达式代替，如： ’A’ + str(1) ，字符串相加
输出方式- 支持设置每次循环的输出方式，包括输出行、按输出列，输出单元格
注意
- 输出行：将单元格区域中数据，按行输出为数组，即每次循环输出为行数组
- 输出列：将单元格区域中数据，按列输出为数组，即每次循环输出为行数组
- 输出单元格：将单元格区域中数据，按单元格输出，即每次循环输出为单元格数据
打开方式- 设置进列单元格操作时，Excel文件的打开方式
注意
- 设置打开表格进行写入操作的方式，默认为应用打开，这种情况下进行写入操作的会自动打开表格文件进行写入，已经打开则不会再打开；
- 使用file的方式打开，直接在文件中写入。

返回值

输出至变量- 运行成功后，组件循环输出的单元格数据

使用示例

执行逻辑

前置条件：准备一个名为“测试数据.xlsx”的表格，使用【循环Excel区域】组件来循环输出第C列的所有值。

添加【循环Excel内容】组件后，设置待操作的Excel文件路径，可点击右侧文件选择按钮，便捷选择表格文件，此处设置属性为'C:/iS-RPA/测试数据.xlsx'

选择单元格所在工作表，以及要读取的单元格，可点击单元格右侧的按钮，在Excel文件中选中单元格范围，即会自动获取Excel文件路径、操作工作表以及选中的单元格等信息，这里我们设置单元格区域为"C2:C21"，选择输出方式为“输出为单元格”，打开方式为“文件”--->添加【输出】组件，将【循环Excel区域】组件‘’值‘’引脚连接到【输出】组件中--->执行此流程

输出结果

运行组件，即会读取目标Excel区域，并循环输出单元格值

Custom_excel0021