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.

Observação:

This activity does not support .xls files.

Compatibilidade do projeto

Windows | Multiplataforma

Propriedades

Comum

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

Entrada

• Arquivo - O caminho completo da pasta de trabalho do recurso. Para alternar para um caminho local, selecione o ícone de mais e, em seguida, Usar arquivo local. O campo atual muda para File (caminho local), onde você pode fornecer o caminho completo da pasta de trabalho.
• NomeDaPlanilha - O nome da planilha da pasta de trabalho.
• 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.

Opções

• 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.

  Observação:

  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.

• Senha - A senha da pasta de trabalho, se necessário.

Usar pasta de trabalho

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

Observações

• 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.

Restrições conhecidas

Inserting rows into a table is not supported yet.