Skip to content

mapping.findUsingLeft ​

Finds a mapping row by its left keys.

js
mapping.findUsingLeft(mappingName, leftKeys)

Parameters ​

ParameterTypeDescription
mappingNamestringThe mapping's name or id.
leftKeysstring[]One element for each dimension on the left side, in order.

Returns ​

string | null

The row as a JSON string, with its id, left keys and right keys. Use JSON.parse() to read it. Returns null when no row matches.

Examples ​

js
const row = JSON.parse(mapping.findUsingLeft("Time to Year and Month", ["FY2017 - Jul"]));
console.log(row);
json
{
    "id": 1,
    "left": [
        "FY2017 - Jul"
    ],
    "right": [
        "2017",
        "Jul"
    ]
}