Excel Add-In for JSON

Build 25.0.9539

QualifyColumns

Specifies how column names are qualified to ensure uniqueness in the generated schema.

Possible Values

None, Parent, Full

Data Type

string

Default Value

"None"

Remarks

By default, the add-in qualifies column names only as much as necessary to make them unique. For example, given the following JSON document, the add-in produces the columns id (referring to the company id) and employee.id.

{
  "company": [
    {
      "id": "Smith Holdings", 
      "employee": [
        {"id": "George Smith"},
        {"id": "Mike Johnson"}
      ]
    }
  ]
}

When this option is set to Parent, the add-in uses a similar procedure to the one above. However, the add-in always qualifies columns by one level so that each includes its parent table name, even when the name is already unique. For example, the above document would generate the columns company.id and employee.id because both are unique when including their parent.

When this option is set to Full, the add-in qualifies all column names with their full JSON path, ensuring clarity about each column’s origin. This generates longer column names, but ensures that it is clear where each column name comes from within the document. For the example above, the add-in generates the columns json.company.id and json.company.employee.id.

Copyright (c) 2026 CData Software, Inc. - All rights reserved.
Build 25.0.9539