Excel row actions DAC

The Excel row actions dynamic advanced command is part of the Excel commands. Use this command to perform actions on Excel rows, like counting rows in a column or inserting and deleting rows. You don’t need Excel installed to use this command. Drag it into a wizard from the Advanced commands view in the Nintex Wizard Editor to use it.

Before you begin:

Use the Excel row actions command to enhance your automation in various scenarios:

  • Counting the number of rows in a specified column.

  • Inserting rows into a worksheet at a specified location.

  • Deleting rows from a worksheet.

In the Nintex Wizard Editor, search for the Excel row actions command and drag it into your steps. Use the table below to configure each field and understand the settings:

When using variables in any of the fields, remember to enclose the variable name in dollar signs (e.g., $MyVar$). You can either type the variable with the dollar signs or select it from the drop-down menu, if available.
Field Description What to do
Select Excel file The Excel file you want to work with. Enter the file path (e.g., C:\Users\dev\Documents\file.xlsx), use a variable, or click Browse to select the file.
Unlock with password Option to unlock a password-protected Excel file. If the Excel file is password-protected, check this box and enter the password in the field provided.
Worksheet name or Worksheet position Method of identifying the worksheet. Specify the worksheet by name (e.g., Sheet1) or by its position (e.g., 1 for the first worksheet) within the workbook.
Action
Get Row Count Column index or letter Specifies the index or letter of the column where the row count will take place. Enter the column index (e.g., 1) or letter (e.g., A) or use a variable to represent the column for the row count.
Number of empty cells allowed Defines the maximum number of consecutive empty cells allowed before the wizard stops counting. The count ends at the last non-empty cell. Enter the maximum number of empty cells allowed before the wizard stops counting rows. The last non-empty cell will define the row count.
Return result in variable The variable to store the result. Select a variable from the dropdown or enter a new variable name to store the result of the action. Use a descriptive name (e.g., RowCount).
Delete Row From row index Identifies the starting row index where the deletion begins. Enter the index of the first row to delete or use a variable for this.
Number of rows to delete Indicates the total number of rows to delete, starting from the specified row index. Specify how many rows to delete starting from the row index or use a variable.
Insert Row Insert at row index Specifies the row index where you insert new rows. Enter the index where you want to insert the new row(s) or use a variable for this.
Number of rows to insert Defines the number of rows you will insert at the specified index. Specify how many rows to insert at the specified row index or use a variable.
Error handling
Error variable Optional error handling with customizable error messages. Enter an Error variable name to ensure errors will display in the View variable list command. Use the default error handling messages or customize the error message and response as needed.
Enable timeout monitoring Optional feature to track the command's runtime and raise an error if it exceeds a set duration. Select the checkbox to enable timeout monitoring and then set the duration (default is 1800 seconds). Customize the timeout error message, or use the default one.

Follow these best practices when using the Excel row actions command:

  • Verify the worksheet name or position to select the correct one before performing any action.

  • Use meaningful variable names to make debugging and maintenance easier.

  • Always configure error handling messages for cases where the file, worksheet, or rows are not found or accessible.

This example shows how to count the number of rows in the first column of a specified worksheet in an Excel file.

  1. Add the Excel row actions command to your wizard and complete the following fields:

    • Select Excel file: C:\Users\dev\Downloads\file_example_XLS_5000.xls

    • Worksheet name: Sheet1

    • Action: Select Get Row Count.

    • Column index or letter: A

    • Number of empty cells allowed: 5

    • Return result in variable: RowCount

    • Error variable: Error

  2. Add the View variable list command to verify the command works without errors.