...
JSON format does not allow to specify or control order of attributes. Despite of that, as most JSON engines allow to control the order of attributes it is strongly recommended to follow the attribute order specified in details. The reason for that is that due to a possible large size of Dataset-JSON files, following the specified order will enable a software using steaming approaches to read the file to work in an efficient and fast way.
Dataset-JSON must contain only one dataset.
Top Level Attributes
At the top level of Dataset-JSON object, there are technical attributes and two main optional attributes: clinicalData and referenceData, corresponding to Dataset-XML elements. At least 1 of the main attributes must be provided. Subject data is stored in clinicalData and non-subject data is stored in referenceData.
...
Attribute | Usage | Description | Attribute order | fileOID | Required | A unique identifier for this file.1 | |
---|---|---|---|---|---|---|---|
creationDateTime | Required | Time of creation of the file containing the document. | 1 | ||||
datasetJSONVersion | Required | Version of Dataset-JSON standard | 2 | ||||
fileOID | Optional | A unique identifier for this file. | 3 | ||||
asOfDateTime | Optional | The date/time at which the source database was queried in order to create this document. | 3 | datasetJSONVersion | Required | Version of Dataset-JSON standard4 | |
originator | Optional | The organization that generated the Dataset-JSON file. | 5 | ||||
sourceSystem | Optional | The computer system or database management system that is the source of the information in this file. | 6 | ||||
sourceSystemVersion | Optional | The version of the "sourceSystem" above. | 7 | ||||
clinicalData | Optional | Contains datasets for clinical data across multiple subjects. | 8 | ||||
referenceData | Optional | Contains datasets for non-subject data domains. | 9 |
...
Attribute | Requirement | Description | Attribute order |
---|---|---|---|
studyOID | RequiredOptional | See ODM definition for study OID (ODM/Study/@OID). | 1 |
metaDataVersionOID | RequiredOptional | See ODM definition for metadata version OID (ODM/Study/MetaDataVersion/@OID). | 2 |
metaDataRef | Optional | URL for a metadata file describing the data. | 3 |
itemGroupData | Required | Object containing dataset information | 4 |
...
itemGroupData is an object with a single attribute corresponding to an individual dataset. There must be only one dataset per Dataset-JSON file. The attribute name is OID of a described dataset, which must be the same as the OID of the corresponding itemGroupDef in the Define-XML file.
...