-
A record containing an employee’s
ID,NameandAddress. Since employees move from time to time, you might need to keep track of all their addresses, both current and past. Instead of creating new metadata fields each time an employee moves to a new address, you can store a list of all addresses into one field. -
You are processing an input stream of
CSVfiles, each containing a different column count. Normally, that would imply creating new metadata for each file (each column count). Instead, you can define a generic map or variant in metadata and append fields to it each time they occur.
Version
Multivalue Fields
Each metadata field commonly stores only one value, e.g. one integer, one string, one date, etc. However, you can also set one field to carry more values of the same type.
Example 8. Example situations when you could take advantage of multivalue fields
As implied above, there are three types of structures:
list - is a set containing elements of a given data type (any you want). In source code, lists are marked by the [] brackets, for example:
integer[] list1 = [1, 367, -1, 20, 5, 0, -79]; // a list of integer elements
boolean[] list2 = [true, false, randomBoolean()]; // a list of three boolean elements
string[] list3; // a just-declared empty list to be filled by stringsmap - is a pair of keys and their values.
A key is always a string while a value can be any data type - but you cannot mix them (remember a map holds values of the same type). Example:
map[string, date] dateMap; // declaration
// filling the map with values
dateMap["a"] = 2011-01-01;
dateMap["b"] = 2012-12-31;
dateMap["c"] = randomDate(2011-01-01,2012-12-31);variant - can contain any data type or complex data structure including list or map.
variant myVariant = {}; // declaration, variant containing empty map
integer[] ordersList = [1, 15, 63]; // declaration, list of integers
// filling the variant with values
myVariant["name"] = "John Doe";
myVariant["dateOfBirth"] = 2012-12-31;
myVariant["isCustomer"] = true;
myVariant["orderIds"] = ordersList;For more information about maps, lists and variants, see Data Types in CTL2.
|
To change a field from single-value to list/map:
|
Lists and Maps Support in Components
An alphabetically sorted list of components which you can use multivalue fields in:
| Component | List | Map | Variant | Note |
|---|---|---|---|---|
✓ |
✓ |
✓ |
||
✓ |
✓ |
✓ |
||
✓ |
✓ |
✓ |
||
✓ |
✓ |
✓ |
||
✓ |
⨯ |
⨯ |
||
✓ |
✓ |
✓ |
Map/Variant is not a part of key |
|
✓ |
⨯ |
⨯ |
||
✓ |
✓ |
✓ |
Map/Variant is not a part of key |
|
✓ |
⨯ |
⨯ |
Sorted input |
|
✓ |
⨯ |
✓ |
Unsorted input |
|
✓ |
✓ |
✓ |
Map is not a part of key |
|
✓ |
⨯ |
⨯ |
||
✓ |
✓ |
✓ |
Map/Variant is not a part of key |
|
✓ |
⨯ |
✓ |
||
✓ |
✓ |
✓ |
Map is not a part of key |
|
✓ |
⨯ |
⨯ |
||
✓ |
✓ |
✓ |
Map/Variant is not a part of key. |
|
✓ |
⨯ |
⨯ |
||
✓ |
✓ |
✓ |
Map/Variant is not a part of key. |
|
✓ |
✓ |
✓ |
||
✓ |
⨯ |
✓ |
||
✓ |
⨯ |
⨯ |
||
✓ |
✓ |
⨯ |
||
✓ |
⨯ |
✓ |
||
✓ |
⨯ |
⨯ |
||
✓ |
⨯ |
✓ |
||
✓ |
✓ |
✓ |
||
✓ |
✓ |
✓ |
||
✓ |
⨯ |
⨯ |
||
✓ |
✓ |
✓ |
Map/Variant is not part of key |
|
✓ |
✓ |
✓ |
||
✓ |
⨯ |
⨯ |
||
✓ |
✓ |
✓ |
Map/Variant is not part of key |
|
✓ |
✓ |
✓ |
Round robin |
|
⨯ |
⨯ |
⨯ |
Ranges |
|
✓ |
⨯ |
✓ |
Partition key |
|
✓ |
✓ |
✓ |
Partition class |
|
✓ |
✓ |
✓ |
||
✓ |
✓ |
✓ |
Round robin |
|
⨯ |
⨯ |
⨯ |
Ranges |
|
✓ |
⨯ |
✓ |
Partition key |
|
✓ |
✓ |
✓ |
Partition class |
|
✓ |
✓ |
✓ |
||
✓ |
⨯ |
⨯ |
||
✓ |
✓ |
✓ |
Map/Variant is not part of key |
|
✓ |
⨯ |
⨯ |
Sorted input |
|
✓ |
⨯ |
✓ |
Unsorted input |
|
✓ |
✓ |
✓ |
Map is not part of key |
|
✓ |
⨯ |
⨯ |
||
✓ |
✓ |
✓ |
Map/Variant is not part of key |
|
✓ |
✓ |
✓ |
||
✓ |
✓ |
✓ |
||
✓ |
✓ |
✓ |
||
✓ |
⨯ |
⨯ |
||
✓ |
✓ |
✓ |
Map/Variant is not part of key |
|
✓ |
⨯ |
⨯ |
||
✓ |
⨯ |
⨯ |
||
✓ |
✓ |
⨯ |
At the moment, map, list and variant structures cannot be extracted as metadata from flat files.
Joining on multivalue fields (Comparison Rules)
You can specify fields that are lists, maps or variants as Join keys (see Join Types) just like any other fields. The only question is when two fields are equal.
A list/map/variant can:
-
be
null- its value is not specified;map[string, date] myMap; // a just-declared map - no keys, no values -
contain empty elements
string[] myList = ["hello", ""]; // a list whose second element is empty -
contain n elements - an ordinary case described, e.g. in Example situations when you could take advantage of multivalue fields
-
variant can contain a single value or a multivalue type
variant singleValue = "hello"; // variant containing string variant multiValue = ["hello", "world"]; // variant containing list of strings
Two maps/lists/variants are equal if both of them are not null, they have the same data type, element count and all element values (keys-values in maps) are equal.
Two maps/lists/variants are not equal if either of them is null.
|
When comparing two lists, the order of their elements has to match, too. In maps and variants, there is no 'order' of elements, therefore you cannot use them in Sort key. |
Example 9. Integer lists which are (not) equal - symbolic notation
[1,2] == [1,2]
[null] != [1,2]
[1] != [1,2]
null != null // two unspecified lists
[null] == [null] // an extra case: lists which are not empty but whose elements are null