ParameterList
See the following sections to parse parameter-list input or format parameter-list output.
Setting Stream Properties
ParameterList streams don't have properties. To configure ParameterList streams, define the stream fields to map to parameter names and values. You can map multivalued HTTP parameters to string arrays.
Defining Stream Fields
Define the field name and data type to define a field in a ParameterList stream.
| Field name | Specify the field name. |
|---|---|
| Data type | Select String, Boolean, Integer, Double, Decimal, DateTime, Binary, or String[]. |
Validating the field names
Note the following conditions for a field name to be valid:
- / can't be used.
- There isn't a limit to the length of the name.
- The name is case sensitive.
- You can use non-ASCII characters and the single-byte blank.
Using String Arrays
You can process multivalued HTTP parameters using string arrays: select String[] for the field's Type property.
Mapping Multivalued Parameters to Records
You can use the mapper component to work with a ParameterList stream as a record. When you have selected the String[] type for one or more fields, as many records are output as the length of the longest array field.
Nonarray values are repeated in every record. If the array length is smaller than the record number, the missing fields are output as null fields.
Example
See below for an example of how you can obtain the output of a ParameterList stream that has a multivalued parameter. Shown below are parameter data that have a 3-value array and a 5-value array.
| Field name | Data type | Value |
|---|---|---|
| Field1 | String | aaa |
| Field2 | String | bbb |
| Field3 | String[] | ccc, ddd, eee |
| Field4 | String[] | fff, ggg, hhh, iii, jjj |
Below is the output for the preceding table, which contains 5 records:
aaa, bbb, ccc, fff aaa, bbb, ddd, ggg aaa, bbb, eee, hhh aaa, bbb, null, iii aaa, bbb, null, jjj
Note
If null values are input as part of string array, the Flow Service ignores the null values. For example, when a string array contains ccc, ddd, null, and eee, the output actual contents of the array are ccc, ddd, and eee.