Table of Contents
CONSTRUCT JSON
Category: Transform / Web
Description
This action constructs a JSON object from a tabular dataset. It has two modes: Object per row, array from objects; and Array per column. A constructed JSON object is effectively a regular text value that is stored in a datagrid cell in EasyMorph.
Action settings
Mode: "Object per row"
In this mode, each row of the source dataset is used to construct a flat JSON object in which every column value corresponds to one object property. See Example #1, below.
If the source dataset contains multiple rows, they will be converted into an array of JSON objects where each object corresponds to one row. See Example #2, below.
Mode: "Array per column"
In this mode, the source dataset is converted into a new dataset in which values of each column are rolled up into a JSON array. See Example #3, below.
Remarks
Data type conversion
EasyMorph data types are converted to JSON types as follows:
EasyMorph | Example | JSON | Example |
---|---|---|---|
Text | ABC | string | "ABC" |
Number | 123.45 | number | 123.45 |
Number (formatted as date) | 2020-Jan-10 | date | 2020-01-10T00:00:00 |
Boolean | TRUE | boolean | true |
Empty | null | null | |
Error | #Division by zero | Fails to convert |
Note that the action fails if the source dataset contains an error value.
Nesting JSON objects
EasyMorph automatically detects if a text value is already a JSON object or a JSON array. In this case, the text value is inserted verbatim, i.e. without wrapping in double-quotes. This feature allows creating complex hierarchical JSON objects that nest other JSON objects. For instance, converting the table below:
Track | Country | State/province | City | Location | Hiatus |
---|---|---|---|---|---|
Circuit Gilles Villeneuve | Canada | QC | Montreal | {"lat":45.500578, "long":-73.522461} | [1987, 2009] |
would produce the following JSON:
{ "Track":"Circuit Gilles Villeneuve", "Country":"Canada", "State/province":"QC", "City":"Montreal" "Location": { "lat":45.500578, "long":-73.522461 }, "Hiatus": [1987, 2009] }
Notice that "Location" is inserted as a JSON object, not as text. Also, the field "Hiatus" is inserted as a JSON array, not as text.
Examples
Example #1
Construct a flat JSON object from the tabular dataset.
Before (source table)
Name | Kingdom | Phylum | Class |
---|---|---|---|
Rabbit | Animalia | Chordata | Mammalia |
After (result table)
{ "Name":"Rabbit", "Kingdom":"Animalia", "Phylum":"Chordata", "Class": "Mammalia", }
Action parameters
Mode: Object per row
Example #2
Create a flat JSON object from the multi-row tabular dataset.
Before (source table)
ID | Name |
---|---|
1 | Apple |
2 | Orange |
After (result table)
[ { "ID":1, "Name":"Apple" }, { "ID":2, "Name":"Orange" } ]
Action parameters
Mode: Object per row
Example #3
Convert the source table into a dataset in which values of each column are rolled up into a JSON array.
Before (source table)
ID | Name |
---|---|
1 | Apple |
2 | Orange |
After (result table)
ID | Name |
---|---|
[1,2] | [Apple,Orange] |
Action parameters
Mode: Array per column
Community examples
- Example: Constructing JSON (Project; Module: Main; Group: Tab 1; Table: comments; Action position: 2)
- How to create JSON for Airtable API (Project; Module: Main; Group: Tab 1; Table: Table 1; Action position: 6)
- Constructing JSON issue (Project; Module: Main; Group: Tab 1; Table: Construct main JSON; Action position: 4)
- How to publish real-time data to streaming dataset in Power BI (Project; Module: Main; Group: Tab 1; Table: Table 1; Action position: 5)