Converting CSV/Excel Files to a List of Dynamic Data Rows
  • 09 Nov 2021
  • 2 Minutes to read
  • Dark
    Light
  This documentation version is deprecated, please click here for the latest version.

Converting CSV/Excel Files to a List of Dynamic Data Rows

  • Dark
    Light

Article summary

Overview 

As an addition to the host of CSV/Excel handling steps, users are provided the option to convert a user-defined Excel Files or set of CSV, into a List of Dynamic Data Rows using a single step. This allows the ability to use the Output Data values within a Flow/Decisions. 

The following document demonstrates how to properly configure and utilize this step to convert a CSV file of customer appointment dates into a List of Dynamic Data Rows. 

Version Availability 
Note that this step is only available in v.7.6+ installations.

Example: CSV File 

  1. From a Designer Project in the Decisions Studio, select CREATE FLOW from the Global Action Bar, then CREATE a new Flow
  2. From the Flow Designer, attach a Create Data step from the FAVORITE STEPS category of the Toolbox, to the Start step. 
  3. From the Properties of the Create Data step, select SHOW EDITOR. 
  4. From the Data to Create window, provide a NAME, then under TYPE, search for and select FileData.
  5. Constant map the desired CSV or Excel file (for this example CSV; then, click DONE, Save, and close via X
  6. Under Toolbox > DATA > EXCEL & CSV, attach a Convert Excel or CSV To Dynamic Data Rows step to the Outcome path of the Create Data step as well as the End step. 

  7. From the Properties tab of the Convert Excel or CSV step, Select From Flow map CSVFile to INPUTS > Input File

  8. Under Properties > INPUT DATA > Input File Type on the Convert Excel or CSV step, select the File Type that corresponds with the Input File (in this case Csv). Then select the corresponding CSV Delimiter

    About Ignore First Row 
    Note that by default the Convert Excel or CSV To Dynamic Data Rows step reads the values starting from the first Row of data. Typically, users may establish a header within this Row and therefore may want to skip this line. To do so, toggle the Ignore First Row Boolean located underneath the Input File Type property. 

  9. Save the Flow, then if desired close via X.



Debug

  1. From the Flow Designer, select the Debug link on the top Action bar.
  2. Click START DEBUGGING. 
  3. After the Flow runs, select Convert Excel or CSV To Dynamic Data Rows > Execution 1 > View Input/Output Data and verify that the step has converted each Row of the CSV into a Dynamic Data Row

Excel File

If an Excel File format (xlsx or xls) is selected as the Input File Type on a Convert Excel Or CSV To Dynamic Data Rows step, users will be provided two additional Inputs. These Inputs are as follows: 

PropertyDescription 
Worksheet Number The number that corresponds to which Worksheet from the Excel File is imported.

Numerical values start at 1, with 1 representing the first Worksheet.
Get Worksheet From Flow Allows users to dynamically map in the Worksheet Number from the Flow. 
Note on Debugging Excel Files 
Note that presently utilizing a Convert Excel Or CSV To Dynamic Data Rows step with an Excel File will convert the FileData into Dynamic Data Rows. However, these values will not show up in the Debugger



Was this article helpful?