DC 5.2.0 15 isArray

Owned by Magnus Frank
Mar 27, 2019

SomeĀ value fields output data, which is 1-many, i.e. sometimes aĀ value fieldĀ can output a single data point (string or number), or one JSON object, or an array of data.

isArray signifies that aĀ value field's output isĀ always output as an array.

Example:

TheĀ value fieldĀ 


With this addedĀ value field, the returnedĀ search result is (the response contains data other than this single value field, but that data has been omitted for clarity's sake):

{
    "items": [
        {
            //The value field
            "Keywords": [
                "Keyword1",
                "Keyword2"
            ]            
        },
        {
			//The value field
            "Keywords": "Keyword2"       
        }
    ],
    "success": true,
    "total": "2"
}

TheĀ result contains two objects.Ā Each of theseĀ objects have a "Keywords" property. The firstĀ object has two keywords:

"Keywords": [
                "Keyword1",
                "Keyword2"
            ]


The secondĀ object has only one keyword:

"Keywords": "Keyword2"


If we edit theĀ value field, so thatĀ isArray is checked, the returned result is:

{
    "items": [
        {
            //The value field
            "Keywords": [
                "Keyword1",
                "Keyword2"
            ]
        },
        {
            //The value field
            "Keywords": [
                "Keyword2"
            ]
        }
    ],
    "success": true,
    "total": "2"
}

Now both of theĀ objects'Ā KeywordsĀ property is an array.