Import Fixed Position
  • 06 Jan 2023
  • 2 Minutes to read
  • Dark
    Light

Import Fixed Position

  • Dark
    Light

Article Summary

Step Details

Introduced in Version4.0.0
Last Modified in Version7.12.0
LocationData > Excel and CSV

The Import Fixed Position step is used to import rows from an excel file starting from a specific row and character position. Each row is treated as a single string.



Properties

Error Handling

PropertyDescriptionData Type
Extra Columns in InputWill provide an error if extra columns are found in the input (Add Outcome: provides an outcome path, Throw Exception will throw an exception on reaching error, Ignore and Continue: will add an outcome path and ignore the error.)---
Less Columns in InputWill provide an error if the columns found are less than expected (Add Outcome: provides an outcome path, Throw Exception will throw an exception on reaching error, Ignore and Continue: add an outcome path and ignore the error.)---
Value Conversion ErrorWill send an error if a value can not be converted (Add Outcome: provides an outcome path, Throw Exception will throw an exception on reaching error, Ignore and Continue: add an outcome path and ignore the error.)---

Import Raw Lines

Property
Description
Data Type
Import Raw LinesAdd data of row into the specified field---

Into PropertySpecify the mapped data field---


Input Data

PropertyDescriptionData Type
Input File TypeDefines what the data type of the input file is---
CSV DelimiterDefines the delimiter specified in the CSV file---
Ignore Quotes (Do not treat as escaped)Ignores column names that contain quotesBoolean
Input File EncodingDefines the encoding type---
Number of ColumnsSpecifies the number of columns that will be importedInt32


Output Data

PropertyDescriptionData Type
Output Data TypeDefines the output data type---

Inputs

PropertyDescriptionData Type
File DataThe CSV or Excel fileFileData
MappingThe defined settings used to map the row to the fields to the output data type---

Outputs

PropertyDescriptionData Type
Done

Imported DataReturns the data that was successfully importedList of [Data Type]
Extra Columns Error

Actual Columns NumberReturns the number of columnsInt32

Input LineReturns the input line or errorInt32

Line NumberReturns the line number of errorInt32
Less Columns Error

Actual Columns NumberReturns the number of columns
Int32

Input LineReturns the input line or error
Int32

Line NumberReturns the line number of error
Int32
Value Conversion Error

Column NumberReturns the column number of errorInt32

Error MessageReturns the error messageString

Input LineReturns the input line or error
Int32

Line NumberReturns the line number of error
Int32

Source ValueReturns what the source value isString

Target TypeReturns the expected data typeString

Example Inputs and Outputs

InputOutput
CSV FileMapped Data to a DataType
.txt FileEXCEPTION MESSAGE


Common Errors

Start position outside of the length of the string

If the start position for a mapped field is outside the specific length of the string, then the following error will be thrown. To ensure this does not occur, set the Start position to be a value that is available for all rows.

Exception Message:

Exception Stack Trace: DecisionsFramework.Design.Flow.ErrorRunningFlowStep: Error running step Import Fixed Position (Runtime Mappings) 1[ImportFixedDynamicStep] in flow [Testing Flow]: Index and length must refer to a location within the string. (Parameter 'length') ---> System.ArgumentOutOfRangeException: Index and length must refer to a location within the string. (Parameter 'length')
   at System.String.Substring(Int32 startIndex, Int32 length)
   at DecisionsFramework.Design.Flow.CoreSteps.CSV.ImportFixedDynamicStep.Run(StepStartData data)
   at DecisionsFramework.Design.Flow.FlowStep.RunStepInternal(String flowTrackingID, String stepTrackingID, KeyValuePairDataStructure[] stepRunDataValues, AbstractFlowTrackingData trackingData)
   at DecisionsFramework.Design.Flow.FlowStep.Start(String flowTrackingID, String stepTrackingID, FlowStateData data, AbstractFlowTrackingData trackingData, RunningStepData currentStepData) 
   --- End of inner exception stack trace ---


Was this article helpful?

What's Next