RangeTable

The RangeTable function returns the data from a CSV formatted range table associated with the specified key.

Multiple value can be output.

Range table's format is "Minumum value, Maximum value, value1, value2, ...".

Input/Output

Number of Connections: Min: 1/Max:Unlimited
InputData TypeDescription
InputNInteger,Double,Decimal,StringA key.
If String value is passed, the value is converted to a numeric value. If conversion is failed, it is handled as a invalid key.
The Boolean or DateTime value, and null is handled as a invalid key.

OutputData TypeDescription
OutputNStringThe data associated with the specified key.

Property

NameProperty TypeDescription
ModechoiceSpecifies whether the input table is to the read from a file or to be defined by the InlineTable property.
File - Read the table data from a file.
Inline - Receive the table data from InlineTable.
RangeTypechoiceSpecifies a format to define the range
min <== X < max [GELT] - Minimum <= key < Maximum
min <== X <== max [GELE] - Minimum <= key <= Maximum
HomeDirectorypathResolverSpecify the base folder of relative path of table file.
Project folder [Relative]
Start point is the same folder as the project file.
Home folder [ProjectOwner]
Start point is the projedct owner's home folder.
Executing user home folder [ExecuteUser]
Start point is the execute user's home folder.
FilePathremoteFile If Mode=File, this property specifies the file to read the table data from. If the file is specified using a relative path, then the base directory is the project owner's home directory.
FileEncodingchoiceIf Mode=File, this property specifies the table file's character encoding.

(AutoDetect) - Attempts to automatically detect and select the character code.
utf-8 - Unicode utf-8
shift_jis - Shift JIS
euc-jp - EUC-JP
iso-2022-jp - ISO-2022-JP
Windows-31J - Windows Japanese
utf-16 - Unicode utf-16
InlineTablestring

If Mode=Inline, this property specifies the table's data.

MinColumnint Specifies the columns used as a minumum value of the range.
The first column is indexed as 1.
MaxColumnint Specifies the columns used as a maximum value of the range.
The first column is indexed as 1.
ValueColumnstring Specifies the columns used as a value.
If you specifies multiple columns as values, specify the concatenated string with comma.
The first column is indexed as 1.
IllegalKeychoiceDefines what is to be output if no data exists for the specified key.

Null [Null]
A null is output. Multiple columns are selected as vakye columns, all columns are set to null.
Key [Key]
The input key is passed directly as output. Multiple keys or columns are selected, a value correspond order is set.
DefaultValue [DefaultValue]
The DefaultValue is output. The multiple value columns are defined, all value of columns are set to DefaultValue.
Exception [Exception]
An Exception is thrown.
DefaultValuestring When the IllegalKey is "DefaultValue", specify the output value.

Loading table

When Mode is set to "File", contents of table is loaded at first execution in each request. This loaded contents is used in the same function in the same request until this request ends. In another words, the same loaded table is used even if the function is in the loop or it is used in subflow. When loading a table, it is checked whether the file is updated or not. If the file is not updated, it is not loaded in next request.

Topic