Add Data Table

Add Data Table activity is used to add a data table in the document or to specified positions in the document.

Using Add Data Table Activity

  1. Make sure the prerequisites for using this activity are met.
  2. Create a new process.
  3. In the Canvas Tools pane, click Word to expand the tool and view the associated activities.
  4. Drag the Add Data Table activity and drop on to the Flowchart designer on the Canvas. 
  5. From the File Path dropdown list, select the In argument holding the file path, along with the file name and extension, of the required data table. The selected argument must be of String type.



     
  6. From the DataTable Name dropdown list, select In argument holding the data table name required data table. The selected argument must be of Datatable type.

     

    NOTE:  

    		 The argument can be created only for an existing datatable. For more information, see DataTable.
  7. From the RelativeInsert dropdown list, select the required value to insert data table with respect to the document or text.

  1. To insert data table with respect to the document: From the DocPosition dropdown list, select the position, at which, you want to insert the data table. You can choose to insert the data table at the Start or End of the document.

  2. To insert data table with respect to the text: From the Search Text dropdown list, select the In argument holding the text to be searched. The argument must be of String type.

     

    NOTE:  

    The input is case-sensitive, and the parameter needs to be defined accordingly.


  • From the Text Position dropdown list, select the position of the data table. You can choose to insert the data table after the text, before the text or you can replace the text with the data table.

  • From the Occurrence dropdown list, select the occurrence of the text you want to add the data table to. You can choose to add it to the first, last or all occurrences of the text. You can also define an index of the occurrences by selecting OccurrenceIndex.

    • From the OccurrenceIndex dropdown list, select the In argument, holding the required index of the text.
       

  1. Click the Result Mapping link and from the Output Mapping dropdown list, select the Out argument which is made available to map the status of the operation performed. The selected argument must be of Boolean type.

    The Add Data Table activity is configured.

 

Add Data Table Properties

The properties of Add Data Table activity are listed in the following table and can be edited in the Properties grid on the right pane.

 

Property Name

Usage

Control Execution

Ignore Error

When this option is set to Yes, the application ignores any error while executing the activity.

If set to NA, it bypasses the exception (if any) to let the automation flow continue; however, it marks the automation status as failure, in case of an exception.

By default, this option is set to No. 

Delay

Wait After (ms)

Specify the time delay that must occur after the activity is executed. The value must be in milliseconds.

Wait Before (ms)

Specify the time delay that must occur before the activity is executed. The value must be in milliseconds.

Misc

Breakpoint

Select this option to mark this activity as the pause point while debugging the process. At this point, the process freezes during execution allowing you to examine if the process is functioning as expected.

In large or complex processes, breakpoints help in identifying the error, if any.

Commented

Select this option to mark this activity as inactive in the entire process. When an activity is commented, it is ignored during the process execution.

DisplayName

The display name of the activity in the flowchart designer area. By default, the name is set as Add Data Table. You can change the name as required.