Insert Rows Workbook (preview)

Insert Rows Workbook activity that inserts one or more rows into a sheet or range at a specified position.

UiPath.Excel.Activities.InsertRows

Description

Inserts one or more rows into a sheet or range at a specified position. This is the cross-platform equivalent of the Insert Rows Windows activity.

Note:

This activity does not support .xls files.

Project compatibility

Windows | Cross-platform

Properties

Common

• DisplayName - The name displayed for the activity in the Designer panel.

Input

• File - The full path of the resource workbook. To switch to a local path, select the plus icon, and then Use Local File. The current field changes to File (local path), where you can provide the full path of the workbook.
• SheetName - The name of the sheet from the workbook.
• Range - The range to insert rows into. If you don't specify a range, the used range of the sheet is used.
• Number Of Rows - The number of rows to insert. The value must be greater than zero. The default value is 1.
• Position - Select where to insert the new rows. The default value is End. You can choose from the following options:
  • Start - Inserts the rows at the beginning of the range.
  • End - Inserts the rows immediately after the last row of the range.
  • Specific index - Inserts the rows at the row index in Specific Row Index.
• Specific Row Index - The 1-based row index, relative to the start of the range, at which to insert the rows. This field is required, and displayed, only when Position is Specific index. If you bind Position to a variable or an expression, the field is always displayed. The value must be at least 1 and not beyond the last row of the range, otherwise the activity fails and nothing is inserted.

Options

• Has Headers - Select this option if the first row of the range is a header row. The header row stays on top, so the rows that you insert at the start go below it. By default, this option is not selected.

  Note:

  Unlike in the Windows Insert Rows activity, Has Headers is not selected by default. When it is not selected, Start inserts the rows at the very first row of the range.

• Password - The password of the workbook, if necessary.

Use Workbook

• Workbook - The existing workbook to use instead of a file path.

Notes

• The existing rows at and below the insertion point shift down.
• If you don't specify a range, entire sheet rows are inserted, relative to the used range of the sheet. If you specify a range, only the cells in the columns of the range shift down, as in the Windows activity. The cells below the range in those columns move down, and the other columns are not changed.
• Start and Specific index positions are counted from the first row of the range, below the header row when Has Headers is selected.

Known limitations

Inserting rows into a table is not supported yet.