Common syntax
All metadata object types are based on a common template.
The keys in this template are necessary to uniquely identify the object and store it in a database. Most of these keys are automatically generated by the application.
Syntax example
Common metadata object syntax
{
"id": "abcdefgh12345678",
"name": "my_view",
"type": "view",
"title": "My view",
"description": "In this view, you'll see a lot of interesting things.",
"origin": "https://secure.clevermaps.io/rest/projects/$projectId/md/datasets?name=view_name",
"content": {
...
},
"accessInfo": {
"createdAt": "2017-01-01T00:00:00Z",
"createdBy": "tomas.schmidl@clevermaps.io",
"modifiedAt": "2017-01-02T00:00:00Z"
"modifiedBy": "tomas.schmidl@clevermaps.io"
},
"links": [
{
"rel": "self",
"href": "/rest/projects/$projectId/md/views/abcdefgh12345678"
}
]
}
The example above is a view object that has been imported by CleverMaps Shell.
Key description
Key | Type | Optionality | Description | Constraints |
---|---|---|---|---|
| string | GENERATED | a 16-byte long unique string |
|
| string | REQUIRED | name of the object must be unique across the project, must be the same as the .json filename |
|
| string | REQUIRED | type of the object |
|
| string | OPTIONAL | human-readable title of the object |
|
| string | OPTIONAL | human-readable description of the object |
|
| string | GENERATED | URL that indicates the original location of an imported object |
|
| object | VARIES | actual content of the metadata object mandatory in all object types except datasets, they have a ref key | |
| object | GENERATED | metadata about the access to the object | |
| array | GENERATED | array containing links identifying the object ( |
accessInfo
Key | Type | Optionality | Description | Constraints |
---|---|---|---|---|
| string | GENERATED | timestamp of the first submission of the object to the project |
|
| string | GENERATED | email of the user who created the object |
|
| string | GENERATED | timestamp of the last time the object was modified |
|
| string | GENERATED | email of the user who last modified the object |
|