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)
