{ "$schema": "http://json-schema.org/draft-04/schema#", "definitions": { "profile": { "title": "Profile", "description": "The profile of this descriptor.", "context": "Every Package and Resource descriptor has a profile. The default profile, if none is declared, is `data-package` for Package and `data-resource` for Resource.", "type": "string", "examples": [ "{\n \"profile\": \"tabular-data-package\"\n}\n", "{\n \"profile\": \"http://example.com/my-profiles-json-schema.json\"\n}\n" ] }, "name": { "title": "Name", "description": "An identifier string. Lower case characters with `.`, `_`, `-` and `/` are allowed.", "type": "string", "pattern": "^([-a-z0-9._/])+$", "context": "This is ideally a url-usable and human-readable name. Name `SHOULD` be invariant, meaning it `SHOULD NOT` change when its parent descriptor is updated.", "examples": ["{\n \"name\": \"my-nice-name\"\n}\n"] }, "id": { "title": "ID", "description": "A property reserved for globally unique identifiers. Examples of identifiers that are unique include UUIDs and DOIs.", "context": "A common usage pattern for Data Packages is as a packaging format within the bounds of a system or platform. In these cases, a unique identifier for a package is desired for common data handling workflows, such as updating an existing package. While at the level of the specification, global uniqueness cannot be validated, consumers using the `id` property `MUST` ensure identifiers are globally unique.", "type": "string", "examples": [ "{\n \"id\": \"b03ec84-77fd-4270-813b-0c698943f7ce\"\n}\n", "{\n \"id\": \"http://dx.doi.org/10.1594/PANGAEA.726855\"\n}\n" ] }, "title": { "title": "Title", "description": "A human-readable title.", "type": "string", "examples": ["{\n \"title\": \"My Package Title\"\n}\n"] }, "email": { "title": "Email", "description": "An email address.", "type": "string", "format": "email", "examples": ["{\n \"email\": \"example@example.com\"\n}\n"] }, "description": { "title": "Description", "description": "A text description. Markdown is encouraged.", "type": "string", "examples": ["{\n \"description\": \"# My Package description\\nAll about my package.\"\n}\n"] }, "homepage": { "title": "Home Page", "description": "The home on the web that is related to this data package.", "type": "string", "format": "uri", "examples": ["{\n \"homepage\": \"http://example.com/\"\n}\n"] }, "version": { "title": "Version", "description": "A unique version number for this descriptor.", "type": "string", "examples": [ "{\n \"version\": \"0.0.1\"\n}\n", "{\n \"version\": \"1.0.1-beta\"\n}\n" ] }, "path": { "title": "Path", "description": "A fully qualified URL, or a POSIX file path..", "type": "string", "pattern": "^(?=^[^./~])(^((?!\\.{2}).)*$).*$", "examples": [ "{\n \"path\": \"file.csv\"\n}\n", "{\n \"path\": \"http://example.com/file.csv\"\n}\n" ], "context": "Implementations need to negotiate the type of path provided, and dereference the data accordingly." }, "data": { "title": "Data", "description": "Inline data for this resource." }, "created": { "title": "Created", "description": "The datetime on which this descriptor was created.", "context": "The datetime must conform to the string formats for datetime as described in [RFC3339](https://tools.ietf.org/html/rfc3339#section-5.6)", "type": "string", "format": "date-time", "examples": ["{\n \"created\": \"1985-04-12T23:20:50.52Z\"\n}\n"] }, "keywords": { "title": "Keywords", "description": "A list of keywords that describe this package.", "type": "array", "minItems": 1, "items": {"type": "string"}, "examples": ["{\n \"keywords\": [\n \"data\",\n \"fiscal\",\n \"transparency\"\n ]\n}\n"] }, "image": { "title": "Image", "description": "A image to represent this package.", "type": "string", "examples": [ "{\n \"image\": \"http://example.com/image.jpg\"\n}\n", "{\n \"image\": \"relative/to/image.jpg\"\n}\n" ] }, "anySchema": { "title": "Schema", "description": "A schema for this resource.", "type": "object" }, "countryCode": { "title": "ISO 3166-1 Alpha-2 Country code", "description": "A valid 2-digit ISO country code (ISO 3166-1 alpha-2), or, an array of valid ISO codes.", "oneOf": [ { "type": "string", "pattern": "^[A-Z]{2}$" }, { "type": "array", "minItems": 1, "items": { "type": "string", "pattern": "^[A-Z]{2}$" } } ] }, "contributor": { "title": "Contributor", "description": "A contributor to this descriptor.", "properties": { "title": {"$ref": "#/definitions/title"}, "path": {"$ref": "#/definitions/path"}, "email": {"$ref": "#/definitions/email"}, "organisation": { "title": "Organization", "description": "An organizational affiliation for this contributor.", "type": "string" }, "role": { "type": "string", "enum": [ "publisher", "author", "maintainer", "wrangler", "contributor" ], "default": "contributor" } }, "required": ["title"], "context": "Use of this property does not imply that the person was the original creator of, or a contributor to, the data in the descriptor, but refers to the composition of the descriptor itself." }, "contributors": { "title": "Contributors", "description": "The contributors to this descriptor.", "type": "array", "minItems": 1, "items": {"$ref": "#/definitions/contributor"}, "examples": [ "{\n \"contributors\": [\n {\n \"title\": \"Joe Bloggs\"\n }\n ]\n}\n", "{\n \"contributors\": [\n {\n \"title\": \"Joe Bloggs\",\n \"email\": \"joe@example.com\",\n \"role\": \"author\"\n }\n ]\n}\n" ] }, "license": { "title": "License", "description": "A license for this descriptor.", "type": "object", "properties": { "name": { "title": "Open Definition license identifier", "description": "MUST be an Open Definition license identifier, see http://licenses.opendefinition.org/", "type": "string", "pattern": "^([-a-zA-Z0-9._])+$" }, "path": {"$ref": "#/definitions/path"}, "title": {"$ref": "#/definitions/title"} }, "context": "Use of this property does not imply that the person was the original creator of, or a contributor to, the data in the descriptor, but refers to the composition of the descriptor itself." }, "licenses": { "title": "Licenses", "description": "The license(s) under which this package is published.", "type": "array", "minItems": 1, "items": {"$ref": "#/definitions/license"}, "context": "This property is not legally binding and does not guarantee that the package is licensed under the terms defined herein.", "examples": ["{\n \"licenses\": [\n {\n \"name\": \"odc-pddl-1.0\",\n \"path\": \"http://opendatacommons.org/licenses/pddl/\",\n \"title\": \"Open Data Commons Public Domain Dedication and License v1.0\"\n }\n ]\n}\n"] }, "source": { "title": "Source", "description": "A source file.", "type": "object", "required": ["title"], "properties": { "title": {"$ref": "#/definitions/title"}, "path": {"$ref": "#/definitions/path"}, "email": {"$ref": "#/definitions/email"} } }, "sources": { "title": "Sources", "description": "The raw sources for this resource.", "type": "array", "minItems": 0, "items": {"$ref": "#/definitions/source"}, "examples": ["{\n \"sources\": [\n {\n \"title\": \"World Bank and OECD\",\n \"path\": \"http://data.worldbank.org/indicator/NY.GDP.MKTP.CD\"\n }\n ]\n}\n"] }, "fiscalMeasure": { "title": "Measure", "description": "Measure.", "type": "object", "required": [ "source", "currency" ], "properties": { "source": {"type": "string"}, "resource": {"type": "string"}, "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "factor": {"type": "number"}, "direction": { "title": "Direction of the spending", "description": "A keyword that represents the direction of the spend, either expenditure or revenue.", "type": "string", "enum": [ "expenditure", "revenue" ] }, "phase": { "title": "Budget phase", "description": "A keyword that represents the phase of the data, can be proposed for a budget proposal, approved for an approved budget, adjusted for modified budget or executed for the enacted budget", "type": "string", "enum": [ "proposed", "approved", "adjusted", "executed" ] } } }, "fiscalDimension": { "title": "Dimension", "description": "Dimension.", "type": "object", "required": [ "attributes", "primaryKey" ], "properties": { "attributes": { "title": "Attributes", "description": "Attribute objects that make up the dimension", "type": "object", "minItems": 1, "patternProperties": { "^\\w+": { "type": "object", "properties": { "source": {"type": "string"}, "resource": {"type": "string"}, "constant": { "oneOf": [ {"type": "string"}, {"type": "number"} ] }, "parent": {"type": "string"}, "labelfor": {"type": "string"} }, "required": ["source"] } } }, "primaryKey": { "title": "Primary Key", "description": "Either an array of strings corresponding to the name attributes in a set of field objects in the fields array or a single string corresponding to one of these names. The value of primaryKey indicates the primary key or primary keys for the dimension.", "oneOf": [ {"type": "string"}, { "type": "array", "minItems": 1, "items": {"type": "string"} } ] }, "dimensionType": { "title": "Dimension Type", "description": "Describes what kind of a dimension it is.", "type": "string", "enum": [ "datetime", "entity", "classification", "activity", "fact", "location", "other" ] }, "classificationType": { "title": "Classification Type", "description": "The type of the classification.", "enum": [ "functional", "administrative", "economic" ] } } }, "fiscalModel": { "title": "", "description": "", "type": "object", "required": [ "measures", "dimensions" ], "properties": { "measures": { "title": "Measures", "description": "Measures are numerical and correspond to financial amounts in the source data.", "type": "object", "patternProperties": { "^\\w+": {"$ref": "#/definitions/fiscalMeasure"} } }, "dimensions": { "title": "Dimensions", "description": "Dimensions are groups of related fields. Dimensions cover all items other than the measure.", "type": "object", "patternProperties": { "^\\w+": {"$ref": "#/definitions/fiscalDimension"} } } } }, "csvDialect": { "title": "CSV Dialect", "description": "The CSV dialect descriptor.", "type": "object", "required": [ "delimiter", "doubleQuote" ], "properties": { "csvddfVersion": {"$ref": "#/definitions/csvddfVersion"}, "delimiter": {"$ref": "#/definitions/delimiter"}, "doubleQuote": {"$ref": "#/definitions/doubleQuote"}, "lineTerminator": {"$ref": "#/definitions/lineTerminator"}, "nullSequence": {"$ref": "#/definitions/nullSequence"}, "quoteChar": {"$ref": "#/definitions/quoteChar"}, "escapeChar": {"$ref": "#/definitions/escapeChar"}, "skipInitialSpace": {"$ref": "#/definitions/skipInitialSpace"}, "header": {"$ref": "#/definitions/header"}, "caseSensitiveHeader": {"$ref": "#/definitions/caseSensitiveHeader"} }, "examples": [ "{\n \"dialect\": {\n \"delimiter\": \";\"\n }\n}\n", "{\n \"dialect\": {\n \"delimiter\": \"\\t\",\n \"quoteChar\": \"'\"\n }\n}\n" ] }, "csvddfVersion": { "title": "CSV Dialect schema version", "description": "A number to indicate the schema version of CSV Dialect. Version 1.0 was named CSV Dialect Description Format and used different field names.", "type": "number", "default": 1.2, "examples:": ["{\n \"csvddfVersion\": \"1.2\"\n} \n"] }, "delimiter": { "title": "Delimiter", "description": "A character sequence to use as the field separator.", "type": "string", "default": ",", "examples": [ "{\n \"delimiter\": \",\"\n}\n", "{\n \"delimiter\": \";\"\n}\n" ] }, "doubleQuote": { "title": "Double Quote", "description": "Specifies the handling of quotes inside fields.", "context": "If Double Quote is set to true, two consecutive quotes must be interpreted as one.", "type": "boolean", "default": true, "examples": ["{\n \"doubleQuote\": true\n}\n"] }, "lineTerminator": { "title": "Line Terminator", "description": "Specifies the character sequence that must be used to terminate rows.", "type": "string", "default": "\r\n", "examples": [ "{\n \"lineTerminator\": \"\\r\\n\"\n}\n", "{\n \"lineTerminator\": \"\\n\"\n}\n" ] }, "nullSequence": { "title": "Null Sequence", "description": "Specifies the null sequence, for example, `\\N`.", "type": "string", "examples": ["{\n \"nullSequence\": \"\\N\"\n}\n"] }, "quoteChar": { "title": "Quote Character", "description": "Specifies a one-character string to use as the quoting character.", "type": "string", "default": "\"", "examples": ["{\n \"quoteChar\": \"'\"\n}\n"] }, "escapeChar": { "title": "Escape Character", "description": "Specifies a one-character string to use as the escape character.", "type": "string", "examples": ["{\n \"escapeChar\": \"\\\\\"\n}\n"] }, "skipInitialSpace": { "title": "Skip Initial Space", "description": "Specifies the interpretation of whitespace immediately following a delimiter. If false, whitespace immediately after a delimiter should be treated as part of the subsequent field.", "type": "boolean", "default": true, "examples": ["{\n \"skipInitialSpace\": true\n}\n"] }, "header": { "title": "Header", "description": "Specifies if the file includes a header row, always as the first row in the file.", "type": "boolean", "default": true, "examples": ["{\n \"header\": true\n}\n"] }, "caseSensitiveHeader": { "title": "Case Sensitive Header", "description": "Specifies if the case of headers is meaningful.", "context": "Use of case in source CSV files is not always an intentional decision. For example, should \"CAT\" and \"Cat\" be considered to have the same meaning.", "type": "boolean", "default": false, "examples": ["{\n \"caseSensitiveHeader\": true\n}\n"] }, "dataPackage": { "title": "Data Package", "description": "Data Package", "type": "object", "required": ["resources"], "properties": { "profile": { "$ref": "#/definitions/profile", "default": "data-package", "propertyOrder": 10 }, "name": { "$ref": "#/definitions/name", "propertyOrder": 20 }, "id": { "$ref": "#/definitions/id", "propertyOrder": 30 }, "title": { "$ref": "#/definitions/title", "propertyOrder": 40 }, "description": { "$ref": "#/definitions/description", "propertyOrder": 50, "format": "textarea" }, "homepage": { "$ref": "#/definitions/homepage", "propertyOrder": 60 }, "created": { "$ref": "#/definitions/created", "propertyOrder": 70 }, "contributors": { "$ref": "#/definitions/contributors", "propertyOrder": 80 }, "keywords": { "$ref": "#/definitions/keywords", "propertyOrder": 90 }, "image": { "$ref": "#/definitions/image", "propertyOrder": 100 }, "licenses": { "$ref": "#/definitions/licenses", "propertyOrder": 110 }, "resources": { "$ref": "#/definitions/dataResources", "propertyOrder": 120 }, "sources": { "$ref": "#/definitions/sources", "propertyOrder": 200, "options": {"hidden": true} } } }, "tabularDataPackage": { "title": "Tabular Data Package", "description": "Tabular Data Package", "type": "object", "required": [ "resources", "profile" ], "properties": { "profile": { "$ref": "#/definitions/profile", "enum": ["tabular-data-package"], "propertyOrder": 10 }, "name": { "$ref": "#/definitions/name", "propertyOrder": 20 }, "id": { "$ref": "#/definitions/id", "propertyOrder": 30 }, "title": { "$ref": "#/definitions/title", "propertyOrder": 40 }, "description": { "$ref": "#/definitions/description", "propertyOrder": 50, "format": "textarea" }, "homepage": { "$ref": "#/definitions/homepage", "propertyOrder": 60 }, "created": { "$ref": "#/definitions/created", "propertyOrder": 70 }, "contributors": { "$ref": "#/definitions/contributors", "propertyOrder": 80 }, "keywords": { "$ref": "#/definitions/keywords", "propertyOrder": 90 }, "image": { "$ref": "#/definitions/image", "propertyOrder": 100 }, "licenses": { "$ref": "#/definitions/licenses", "propertyOrder": 110 }, "resources": { "$ref": "#/definitions/tabularDataResources", "propertyOrder": 120 }, "sources": { "$ref": "#/definitions/sources", "propertyOrder": 200, "options": {"hidden": true} } } }, "dataResources": { "title": "Data Resources", "description": "An `array` of Data Resource objects, each compliant with the [Data Resource](/data-resource/) specification.", "type": "array", "minItems": 1, "items": {"$ref": "#/definitions/dataResource"}, "examples": ["{\n \"resources\": [\n {\n \"name\": \"my-data\",\n \"data\": [\n \"data.csv\"\n ],\n \"mediatype\": \"text/csv\"\n }\n ]\n}\n"] }, "tabularDataResources": { "title": "Tabular Data Resources", "description": "An `array` of Tabular Data Resource objects, each compliant with the [Tabular Data Resource](/tabular-data-resource/) specification.", "type": "array", "minItems": 1, "items": {"$ref": "#/definitions/tabularDataResource"}, "examples": ["{\n \"resources\": [\n {\n \"name\": \"my-data\",\n \"data\": [\n \"data.csv\"\n ],\n \"schema\": \"tableschema.json\",\n \"mediatype\": \"text/csv\"\n }\n ]\n}\n"] }, "dataResource": { "title": "Data Resource", "description": "Data Resource.", "type": "object", "oneOf": [ { "required": [ "name", "data" ] }, { "required": [ "name", "path" ] } ], "properties": { "profile": { "$ref": "#/definitions/profile", "propertyOrder": 10, "default": "data-resource" }, "name": { "$ref": "#/definitions/name", "propertyOrder": 20 }, "path": { "$ref": "#/definitions/resourcePath", "propertyOrder": 30 }, "data": { "$ref": "#/definitions/data", "propertyOrder": 230 }, "schema": { "$ref": "#/definitions/anySchema", "propertyOrder": 40 }, "title": { "$ref": "#/definitions/title", "propertyOrder": 50 }, "description": { "$ref": "#/definitions/description", "propertyOrder": 60, "format": "textarea" }, "homepage": { "$ref": "#/definitions/homepage", "propertyOrder": 70 }, "sources": { "$ref": "#/definitions/sources", "propertyOrder": 140, "options": {"hidden": true} }, "licenses": { "$ref": "#/definitions/licenses", "description": "The license(s) under which the resource is published.", "propertyOrder": 150, "options": {"hidden": true} }, "format": { "$ref": "#/definitions/format", "propertyOrder": 80 }, "mediatype": { "$ref": "#/definitions/mediatype", "propertyOrder": 90 }, "encoding": { "$ref": "#/definitions/encoding", "propertyOrder": 100 }, "bytes": { "$ref": "#/definitions/bytes", "propertyOrder": 110, "options": {"hidden": true} }, "hash": { "$ref": "#/definitions/hash", "propertyOrder": 120, "options": {"hidden": true} } } }, "tabularDataResource": { "title": "Tabular Data Resource", "description": "A Tabular Data Resource.", "type": "object", "oneOf": [ { "required": [ "name", "data", "schema", "profile" ] }, { "required": [ "name", "path", "schema", "profile" ] } ], "properties": { "profile": { "$ref": "#/definitions/profile", "propertyOrder": 10 }, "name": { "$ref": "#/definitions/name", "propertyOrder": 20 }, "path": { "$ref": "#/definitions/resourcePath", "propertyOrder": 30 }, "data": { "$ref": "#/definitions/data", "propertyOrder": 230 }, "schema": { "$ref": "#/definitions/tableSchema", "propertyOrder": 40 }, "title": { "$ref": "#/definitions/title", "propertyOrder": 50 }, "description": { "$ref": "#/definitions/description", "propertyOrder": 60 }, "homepage": { "$ref": "#/definitions/homepage", "propertyOrder": 70 }, "sources": { "$ref": "#/definitions/sources", "propertyOrder": 140, "options": {"hidden": true} }, "licenses": { "$ref": "#/definitions/licenses", "description": "The license(s) under which the resource is published.", "propertyOrder": 150, "options": {"hidden": true} }, "dialect": { "$ref": "#/definitions/csvDialect", "propertyOrder": 50 }, "format": { "$ref": "#/definitions/format", "propertyOrder": 80 }, "mediatype": { "$ref": "#/definitions/mediatype", "propertyOrder": 90 }, "encoding": { "$ref": "#/definitions/encoding", "propertyOrder": 100 }, "bytes": { "$ref": "#/definitions/bytes", "propertyOrder": 110, "options": {"hidden": true} }, "hash": { "$ref": "#/definitions/hash", "propertyOrder": 120, "options": {"hidden": true} } } }, "pathArray": { "type": "array", "minItems": 1, "items": {"$ref": "#/definitions/path"}, "examples": [ "[ \"file.csv\" ]\n", "[ \"http://example.com/file.csv\" ]\n" ] }, "resourcePath": { "title": "Path", "description": "A reference to the data for this resource, as either a path as a string, or an array of paths as strings. of valid URIs.", "oneOf": [ {"$ref": "#/definitions/path"}, {"$ref": "#/definitions/pathArray"} ], "context": "The dereferenced value of each referenced data source in `path` `MUST` be commensurate with a native, dereferenced representation of the data the resource describes. For example, in a *Tabular* Data Resource, this means that the dereferenced value of `path` `MUST` be an array.", "examples": [ "{\n \"path\": [\n \"file.csv\",\n \"file2.csv\"\n ]\n}\n", "{\n \"path\": [\n \"http://example.com/file.csv\",\n \"http://example.com/file2.csv\"\n ]\n}\n", "{\n \"path\": \"http://example.com/file.csv\"\n}\n" ] }, "format": { "title": "Format", "description": "The file format of this resource.", "context": "`csv`, `xls`, `json` are examples of common formats.", "type": "string", "examples": ["{\n \"format\": \"xls\"\n}\n"] }, "mediatype": { "title": "Media Type", "description": "The media type of this resource. Can be any valid media type listed with [IANA](https://www.iana.org/assignments/media-types/media-types.xhtml).", "type": "string", "pattern": "^(.+)/(.+)$", "examples": ["{\n \"mediatype\": \"text/csv\"\n}\n"] }, "encoding": { "title": "Encoding", "description": "The file encoding of this resource.", "type": "string", "default": "utf-8", "examples": ["{\n \"encoding\": \"utf-8\"\n}\n"] }, "bytes": { "title": "Bytes", "description": "The size of this resource in bytes.", "type": "integer", "examples": ["{\n \"bytes\": 2082\n}\n"] }, "hash": { "title": "Hash", "type": "string", "description": "The MD5 hash of this resource. Indicate other hashing algorithms with the {algorithm}:{hash} format.", "pattern": "^([^:]+:[a-fA-F0-9]+|[a-fA-F0-9]{32}|)$", "examples": [ "{\n \"hash\": \"d25c9c77f588f5dc32059d2da1136c02\"\n}\n", "{\n \"hash\": \"SHA256:5262f12512590031bbcc9a430452bfd75c2791ad6771320bb4b5728bfb78c4d0\"\n}\n" ] }, "tableSchemaFieldName": { "title": "Name", "description": "A name for this field.", "type": "string" }, "tableSchema": { "title": "Table Schema", "description": "A Table Schema for this resource, compliant with the [Table Schema](/tableschema/) specification.", "type": "object", "required": ["fields"], "properties": { "fields": { "type": "array", "minItems": 1, "items": {"$ref": "#/definitions/tableSchemaField"}, "description": "An `array` of Table Schema Field objects.", "examples": [ "{\n \"fields\": [\n {\n \"name\": \"my-field-name\"\n }\n ]\n}\n", "{\n \"fields\": [\n {\n \"name\": \"my-field-name\",\n \"type\": \"number\"\n },\n {\n \"name\": \"my-field-name-2\",\n \"type\": \"string\",\n \"format\": \"email\"\n }\n ]\n}\n" ] }, "primaryKey": {"$ref": "#/definitions/tableSchemaPrimaryKey"}, "foreignKeys": { "type": "array", "minItems": 1, "items": {"$ref": "#/definitions/tableSchemaForeignKey"}, "examples": [ "{\n \"foreignKeys\": [\n {\n \"fields\": \"state\",\n \"reference\": {\n \"resource\": \"the-resource\",\n \"fields\": \"state_id\"\n }\n }\n ]\n}\n", "{\n \"foreignKeys\": [\n {\n \"fields\": \"state\",\n \"reference\": {\n \"resource\": \"\",\n \"fields\": \"id\"\n }\n }\n ]\n}\n" ] }, "missingValues": {"$ref": "#/definitions/tableSchemaMissingValues"} }, "examples": ["{\n \"schema\": {\n \"fields\": [\n {\n \"name\": \"first_name\",\n \"type\": \"string\"\n \"constraints\": {\n \"required\": true\n }\n },\n {\n \"name\": \"age\",\n \"type\": \"integer\"\n },\n ],\n \"primaryKey\": [\n \"name\"\n ]\n }\n}\n"] }, "tableSchemaField": { "title": "Table Schema Field", "type": "object", "anyOf": [ {"$ref": "#/definitions/tableSchemaFieldString"}, {"$ref": "#/definitions/tableSchemaFieldNumber"}, {"$ref": "#/definitions/tableSchemaFieldInteger"}, {"$ref": "#/definitions/tableSchemaFieldDate"}, {"$ref": "#/definitions/tableSchemaFieldTime"}, {"$ref": "#/definitions/tableSchemaFieldDateTime"}, {"$ref": "#/definitions/tableSchemaFieldYear"}, {"$ref": "#/definitions/tableSchemaFieldYearMonth"}, {"$ref": "#/definitions/tableSchemaFieldBoolean"}, {"$ref": "#/definitions/tableSchemaFieldObject"}, {"$ref": "#/definitions/tableSchemaFieldGeoPoint"}, {"$ref": "#/definitions/tableSchemaFieldGeoJSON"}, {"$ref": "#/definitions/tableSchemaFieldArray"}, {"$ref": "#/definitions/tableSchemaFieldDuration"}, {"$ref": "#/definitions/tableSchemaFieldAny"} ] }, "tableSchemaPrimaryKey": { "oneOf": [ { "type": "array", "minItems": 1, "uniqueItems": true, "items": {"type": "string"} }, {"type": "string"} ], "description": "A primary key is a field name or an array of field names, whose values `MUST` uniquely identify each row in the table.", "context": "Field name in the `primaryKey` `MUST` be unique, and `MUST` match a field name in the associated table. It is acceptable to have an array with a single value, indicating that the value of a single field is the primary key.", "examples": [ "{\n \"primaryKey\": [\n \"name\"\n ]\n}\n", "{\n \"primaryKey\": [\n \"first_name\",\n \"last_name\"\n ]\n}\n" ] }, "tableSchemaForeignKey": { "title": "Table Schema Foreign Key", "description": "Table Schema Foreign Key", "type": "object", "required": [ "fields", "reference" ], "oneOf": [ { "properties": { "fields": { "type": "array", "items": { "type": "string", "minItems": 1, "uniqueItems": true, "description": "Fields that make up the primary key." } }, "reference": { "type": "object", "required": [ "resource", "fields" ], "properties": { "resource": { "type": "string", "default": "" }, "fields": { "type": "array", "items": {"type": "string"}, "minItems": 1, "uniqueItems": true } } } } }, { "properties": { "fields": { "type": "string", "description": "Fields that make up the primary key." }, "reference": { "type": "object", "required": [ "resource", "fields" ], "properties": { "resource": { "type": "string", "default": "" }, "fields": {"type": "string"} } } } } ] }, "tableSchemaTrueValues": { "type": "array", "minItems": 1, "items": {"type": "string"}, "default": [ "true", "True", "TRUE", "1" ] }, "tableSchemaFalseValues": { "type": "array", "minItems": 1, "items": {"type": "string"}, "default": [ "false", "False", "FALSE", "0" ] }, "tableSchemaMissingValues": { "type": "array", "items": {"type": "string"}, "default": [""], "description": "Values that when encountered in the source, should be considered as `null`, 'not present', or 'blank' values.", "context": "Many datasets arrive with missing data values, either because a value was not collected or it never existed.\nMissing values may be indicated simply by the value being empty in other cases a special value may have been used e.g. `-`, `NaN`, `0`, `-9999` etc.\nThe `missingValues` property provides a way to indicate that these values should be interpreted as equivalent to null.\n\n`missingValues` are strings rather than being the data type of the particular field. This allows for comparison prior to casting and for fields to have missing value which are not of their type, for example a `number` field to have missing values indicated by `-`.\n\nThe default value of `missingValue` for a non-string type field is the empty string `''`. For string type fields there is no default for `missingValue` (for string fields the empty string `''` is a valid value and need not indicate null).", "examples": [ "{\n \"missingValues\": [\n \"-\",\n \"NaN\",\n \"\"\n ]\n}\n", "{\n \"missingValues\": []\n}\n" ] }, "tableSchemaFieldString": { "type": "object", "title": "String Field", "description": "The field contains strings, that is, sequences of characters.", "required": ["name"], "properties": { "name": {"$ref": "#/definitions/tableSchemaFieldName"}, "title": {"$ref": "#/definitions/title"}, "description": {"$ref": "#/definitions/description"}, "type": { "description": "The type keyword, which `MUST` be a value of `string`.", "enum": ["string"] }, "format": { "description": "The format keyword options for `string` are `default`, `email`, `uri`, `binary`, and `uuid`.", "context": "The following `format` options are supported:\n * **default**: any valid string.\n * **email**: A valid email address.\n * **uri**: A valid URI.\n * **binary**: A base64 encoded string representing binary data.\n * **uuid**: A string that is a uuid.", "enum": [ "default", "email", "uri", "binary", "uuid" ], "default": "default" }, "constraints": { "title": "Constraints", "description": "The following constraints are supported for `string` fields.", "type": "object", "properties": { "required": {"$ref": "#/definitions/tableSchemaConstraintRequired"}, "unique": {"$ref": "#/definitions/tableSchemaConstraintUnique"}, "pattern": {"$ref": "#/definitions/tableSchemaConstraintPattern"}, "enum": {"$ref": "#/definitions/tableSchemaConstraintEnumString"}, "minLength": {"$ref": "#/definitions/tableSchemaConstraintMinLength"}, "maxLength": {"$ref": "#/definitions/tableSchemaConstraintMaxLength"} } }, "rdfType": {"$ref": "#/definitions/tableSchemaRdfType"} }, "examples": [ "{\n \"name\": \"name\",\n \"type\": \"string\"\n}\n", "{\n \"name\": \"name\",\n \"type\": \"string\",\n \"format\": \"email\"\n}\n", "{\n \"name\": \"name\",\n \"type\": \"string\",\n \"constraints\": {\n \"minLength\": 3,\n \"maxLength\": 35\n }\n}\n" ] }, "tableSchemaFieldBoolean": { "type": "object", "title": "Boolean Field", "description": "The field contains boolean (true/false) data.", "required": [ "name", "type" ], "properties": { "name": {"$ref": "#/definitions/tableSchemaFieldName"}, "title": {"$ref": "#/definitions/title"}, "description": {"$ref": "#/definitions/description"}, "type": { "description": "The type keyword, which `MUST` be a value of `boolean`.", "enum": ["boolean"] }, "trueValues": {"$ref": "#/definitions/tableSchemaTrueValues"}, "falseValues": {"$ref": "#/definitions/tableSchemaFalseValues"}, "constraints": { "title": "Constraints", "description": "The following constraints are supported for `boolean` fields.", "type": "object", "properties": { "required": {"$ref": "#/definitions/tableSchemaConstraintRequired"}, "enum": {"$ref": "#/definitions/tableSchemaConstraintEnumBoolean"} } }, "rdfType": {"$ref": "#/definitions/tableSchemaRdfType"} }, "examples": ["{\n \"name\": \"registered\",\n \"type\": \"boolean\"\n}\n"] }, "tableSchemaFieldInteger": { "type": "object", "title": "Integer Field", "description": "The field contains integers - that is whole numbers.", "context": "Integer values are indicated in the standard way for any valid integer.", "required": [ "name", "type" ], "properties": { "name": {"$ref": "#/definitions/tableSchemaFieldName"}, "title": {"$ref": "#/definitions/title"}, "description": {"$ref": "#/definitions/description"}, "type": { "description": "The type keyword, which `MUST` be a value of `integer`.", "enum": ["integer"] }, "format": { "description": "There are no format keyword options for `integer`: only `default` is allowed.", "enum": ["default"], "default": "default" }, "bareNumber": {"$ref": "#/definitions/tableSchemaBareNumber"}, "constraints": { "title": "Constraints", "description": "The following constraints are supported for `integer` fields.", "type": "object", "properties": { "required": {"$ref": "#/definitions/tableSchemaConstraintRequired"}, "unique": {"$ref": "#/definitions/tableSchemaConstraintUnique"}, "pattern": {"$ref": "#/definitions/tableSchemaConstraintPattern"}, "enum": { "oneOf": [ {"$ref": "#/definitions/tableSchemaConstraintEnumString"}, {"$ref": "#/definitions/tableSchemaConstraintEnumInteger"} ] }, "minimum": { "oneOf": [ {"$ref": "#/definitions/tableSchemaConstraintMinimumString"}, {"$ref": "#/definitions/tableSchemaConstraintMinimumInteger"} ] }, "maximum": { "oneOf": [ {"$ref": "#/definitions/tableSchemaConstraintMaximumString"}, {"$ref": "#/definitions/tableSchemaConstraintMaximumInteger"} ] } } }, "rdfType": {"$ref": "#/definitions/tableSchemaRdfType"} }, "examples": ["{\n \"name\": \"age\",\n \"type\": \"integer\",\n \"constraints\": {\n \"unique\": true,\n \"minimum\": 100,\n \"maximum\": 9999\n }\n}\n"] }, "tableSchemaFieldNumber": { "type": "object", "title": "Number Field", "description": "The field contains numbers of any kind including decimals.", "context": "The lexical formatting follows that of decimal in [XMLSchema](https://www.w3.org/TR/xmlschema-2/#decimal): a non-empty finite-length sequence of decimal digits separated by a period as a decimal indicator. An optional leading sign is allowed. If the sign is omitted, '+' is assumed. Leading and trailing zeroes are optional. If the fractional part is zero, the period and following zero(es) can be omitted. For example: '-1.23', '12678967.543233', '+100000.00', '210'.\n\nThe following special string values are permitted (case does not need to be respected):\n - NaN: not a number\n - INF: positive infinity\n - -INF: negative infinity\n\nA number `MAY` also have a trailing:\n - exponent: this `MUST` consist of an E followed by an optional + or - sign followed by one or more decimal digits (0-9)\n - percentage: the percentage sign: `%`. In conversion percentages should be divided by 100.\n\nIf both exponent and percentages are present the percentage `MUST` follow the exponent e.g. '53E10%' (equals 5.3).", "required": ["name"], "properties": { "name": {"$ref": "#/definitions/tableSchemaFieldName"}, "title": {"$ref": "#/definitions/title"}, "description": {"$ref": "#/definitions/description"}, "type": { "description": "The type keyword, which `MUST` be a value of `number`.", "enum": ["number"] }, "format": { "description": "There are no format keyword options for `number`: only `default` is allowed.", "enum": ["default"], "default": "default" }, "bareNumber": {"$ref": "#/definitions/tableSchemaBareNumber"}, "decimalChar": { "type": "string", "description": "A string whose value is used to represent a decimal point within the number. The default value is `.`." }, "groupChar": { "type": "string", "description": "A string whose value is used to group digits within the number. The default value is `null`. A common value is `,` e.g. '100,000'." }, "constraints": { "title": "Constraints", "description": "The following constraints are supported for `number` fields.", "type": "object", "properties": { "required": {"$ref": "#/definitions/tableSchemaConstraintRequired"}, "unique": {"$ref": "#/definitions/tableSchemaConstraintUnique"}, "pattern": {"$ref": "#/definitions/tableSchemaConstraintPattern"}, "enum": { "oneOf": [ {"$ref": "#/definitions/tableSchemaConstraintEnumString"}, {"$ref": "#/definitions/tableSchemaConstraintEnumNumber"} ] }, "minimum": { "oneOf": [ {"$ref": "#/definitions/tableSchemaConstraintMinimumString"}, {"$ref": "#/definitions/tableSchemaConstraintMinimumNumber"} ] }, "maximum": { "oneOf": [ {"$ref": "#/definitions/tableSchemaConstraintMaximumString"}, {"$ref": "#/definitions/tableSchemaConstraintMaximumNumber"} ] } } }, "rdfType": {"$ref": "#/definitions/tableSchemaRdfType"} }, "examples": [ "{\n \"name\": \"field-name\",\n \"type\": \"number\"\n}\n", "{\n \"name\": \"field-name\",\n \"type\": \"number\",\n \"constraints\": {\n \"enum\": [ \"1.00\", \"1.50\", \"2.00\" ]\n }\n}\n" ] }, "tableSchemaFieldDate": { "type": "object", "title": "Date Field", "description": "The field contains temporal date values.", "required": [ "name", "type" ], "properties": { "name": {"$ref": "#/definitions/tableSchemaFieldName"}, "title": {"$ref": "#/definitions/title"}, "description": {"$ref": "#/definitions/description"}, "type": { "description": "The type keyword, which `MUST` be a value of `date`.", "enum": ["date"] }, "format": { "description": "The format keyword options for `date` are `default`, `any`, and `{PATTERN}`.", "context": "The following `format` options are supported:\n * **default**: An ISO8601 format string of YYYY-MM-DD.\n * **any**: Any parsable representation of a date. The implementing library can attempt to parse the datetime via a range of strategies.\n * **{PATTERN}**: The value can be parsed according to `{PATTERN}`, which `MUST` follow the date formatting syntax of C / Python [strftime](http://strftime.org/).", "default": "default" }, "constraints": { "title": "Constraints", "description": "The following constraints are supported for `date` fields.", "type": "object", "properties": { "required": {"$ref": "#/definitions/tableSchemaConstraintRequired"}, "unique": {"$ref": "#/definitions/tableSchemaConstraintUnique"}, "enum": {"$ref": "#/definitions/tableSchemaConstraintEnumString"}, "minimum": {"$ref": "#/definitions/tableSchemaConstraintMinimumString"}, "maximum": {"$ref": "#/definitions/tableSchemaConstraintMaximumString"} } }, "rdfType": {"$ref": "#/definitions/tableSchemaRdfType"} }, "examples": [ "{\n \"name\": \"date_of_birth\",\n \"type\": \"date\"\n}\n", "{\n \"name\": \"date_of_birth\",\n \"type\": \"date\",\n \"constraints\": {\n \"minimum\": \"01-01-1900\"\n }\n}\n", "{\n \"name\": \"date_of_birth\",\n \"type\": \"date\",\n \"format\": \"MM-DD-YYYY\"\n}\n" ] }, "tableSchemaFieldTime": { "type": "object", "title": "Time Field", "description": "The field contains temporal time values.", "required": [ "name", "type" ], "properties": { "name": {"$ref": "#/definitions/tableSchemaFieldName"}, "title": {"$ref": "#/definitions/title"}, "description": {"$ref": "#/definitions/description"}, "type": { "description": "The type keyword, which `MUST` be a value of `time`.", "enum": ["time"] }, "format": { "description": "The format keyword options for `time` are `default`, `any`, and `{PATTERN}`.", "context": "The following `format` options are supported:\n * **default**: An ISO8601 format string for time.\n * **any**: Any parsable representation of a date. The implementing library can attempt to parse the datetime via a range of strategies.\n * **{PATTERN}**: The value can be parsed according to `{PATTERN}`, which `MUST` follow the date formatting syntax of C / Python [strftime](http://strftime.org/).", "default": "default" }, "constraints": { "title": "Constraints", "description": "The following constraints are supported for `time` fields.", "type": "object", "properties": { "required": {"$ref": "#/definitions/tableSchemaConstraintRequired"}, "unique": {"$ref": "#/definitions/tableSchemaConstraintUnique"}, "enum": {"$ref": "#/definitions/tableSchemaConstraintEnumString"}, "minimum": {"$ref": "#/definitions/tableSchemaConstraintMinimumString"}, "maximum": {"$ref": "#/definitions/tableSchemaConstraintMaximumString"} } }, "rdfType": {"$ref": "#/definitions/tableSchemaRdfType"} }, "examples": [ "{\n \"name\": \"appointment_start\",\n \"type\": \"time\"\n}\n", "{\n \"name\": \"appointment_start\",\n \"type\": \"time\",\n \"format\": \"any\"\n}\n" ] }, "tableSchemaFieldDateTime": { "type": "object", "title": "Date Time Field", "description": "The field contains temporal datetime values.", "required": [ "name", "type" ], "properties": { "name": {"$ref": "#/definitions/tableSchemaFieldName"}, "title": {"$ref": "#/definitions/title"}, "description": {"$ref": "#/definitions/description"}, "type": { "description": "The type keyword, which `MUST` be a value of `datetime`.", "enum": ["datetime"] }, "format": { "description": "The format keyword options for `datetime` are `default`, `any`, and `{PATTERN}`.", "context": "The following `format` options are supported:\n * **default**: An ISO8601 format string for datetime.\n * **any**: Any parsable representation of a date. The implementing library can attempt to parse the datetime via a range of strategies.\n * **{PATTERN}**: The value can be parsed according to `{PATTERN}`, which `MUST` follow the date formatting syntax of C / Python [strftime](http://strftime.org/).", "default": "default" }, "constraints": { "title": "Constraints", "description": "The following constraints are supported for `datetime` fields.", "type": "object", "properties": { "required": {"$ref": "#/definitions/tableSchemaConstraintRequired"}, "unique": {"$ref": "#/definitions/tableSchemaConstraintUnique"}, "enum": {"$ref": "#/definitions/tableSchemaConstraintEnumString"}, "minimum": {"$ref": "#/definitions/tableSchemaConstraintMinimumString"}, "maximum": {"$ref": "#/definitions/tableSchemaConstraintMaximumString"} } }, "rdfType": {"$ref": "#/definitions/tableSchemaRdfType"} }, "examples": [ "{\n \"name\": \"timestamp\",\n \"type\": \"datetime\"\n}\n", "{\n \"name\": \"timestamp\",\n \"type\": \"datetime\",\n \"format\": \"default\"\n}\n" ] }, "tableSchemaFieldYear": { "type": "object", "title": "Year Field", "description": "A calendar year, being an integer with 4 digits. Equivalent to [gYear in XML Schema](https://www.w3.org/TR/xmlschema-2/#gYear)", "required": [ "name", "type" ], "properties": { "name": {"$ref": "#/definitions/tableSchemaFieldName"}, "title": {"$ref": "#/definitions/title"}, "description": {"$ref": "#/definitions/description"}, "type": { "description": "The type keyword, which `MUST` be a value of `year`.", "enum": ["year"] }, "format": { "description": "There are no format keyword options for `year`: only `default` is allowed.", "enum": ["default"], "default": "default" }, "constraints": { "title": "Constraints", "description": "The following constraints are supported for `year` fields.", "type": "object", "properties": { "required": {"$ref": "#/definitions/tableSchemaConstraintRequired"}, "unique": {"$ref": "#/definitions/tableSchemaConstraintUnique"}, "enum": { "oneOf": [ {"$ref": "#/definitions/tableSchemaConstraintEnumString"}, {"$ref": "#/definitions/tableSchemaConstraintEnumInteger"} ] }, "minimum": { "oneOf": [ {"$ref": "#/definitions/tableSchemaConstraintMinimumString"}, {"$ref": "#/definitions/tableSchemaConstraintMinimumInteger"} ] }, "maximum": { "oneOf": [ {"$ref": "#/definitions/tableSchemaConstraintMaximumString"}, {"$ref": "#/definitions/tableSchemaConstraintMaximumInteger"} ] } } }, "rdfType": {"$ref": "#/definitions/tableSchemaRdfType"} }, "examples": [ "{\n \"name\": \"year\",\n \"type\": \"year\"\n}\n", "{\n \"name\": \"year\",\n \"type\": \"year\",\n \"constraints\": {\n \"minimum\": 1970,\n \"maximum\": 2003\n }\n}\n" ] }, "tableSchemaFieldYearMonth": { "type": "object", "title": "Year Month Field", "description": "A calendar year month, being an integer with 1 or 2 digits. Equivalent to [gYearMonth in XML Schema](https://www.w3.org/TR/xmlschema-2/#gYearMonth)", "required": [ "name", "type" ], "properties": { "name": {"$ref": "#/definitions/tableSchemaFieldName"}, "title": {"$ref": "#/definitions/title"}, "description": {"$ref": "#/definitions/description"}, "type": { "description": "The type keyword, which `MUST` be a value of `yearmonth`.", "enum": ["yearmonth"] }, "format": { "description": "There are no format keyword options for `yearmonth`: only `default` is allowed.", "enum": ["default"], "default": "default" }, "constraints": { "title": "Constraints", "description": "The following constraints are supported for `yearmonth` fields.", "type": "object", "properties": { "required": {"$ref": "#/definitions/tableSchemaConstraintRequired"}, "unique": {"$ref": "#/definitions/tableSchemaConstraintUnique"}, "pattern": {"$ref": "#/definitions/tableSchemaConstraintPattern"}, "enum": {"$ref": "#/definitions/tableSchemaConstraintEnumString"}, "minimum": {"$ref": "#/definitions/tableSchemaConstraintMinimumString"}, "maximum": {"$ref": "#/definitions/tableSchemaConstraintMaximumString"} } }, "rdfType": {"$ref": "#/definitions/tableSchemaRdfType"} }, "examples": [ "{\n \"name\": \"month\",\n \"type\": \"yearmonth\"\n}\n", "{\n \"name\": \"month\",\n \"type\": \"yearmonth\",\n \"constraints\": {\n \"minimum\": 1,\n \"maximum\": 6\n }\n}\n" ] }, "tableSchemaFieldDuration": { "type": "object", "title": "Duration Field", "description": "The field contains a duration of time.", "context": "The lexical representation for duration is the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601#Durations) extended format `PnYnMnDTnHnMnS`, where `nY` represents the number of years, `nM` the number of months, `nD` the number of days, 'T' is the date/time separator, `nH` the number of hours, `nM` the number of minutes and `nS` the number of seconds. The number of seconds can include decimal digits to arbitrary precision. Date and time elements including their designator may be omitted if their value is zero, and lower order elements may also be omitted for reduced precision. Here we follow the definition of [XML Schema duration datatype](http://www.w3.org/TR/xmlschema-2/#duration) directly and that definition is implicitly inlined here.", "required": [ "name", "type" ], "properties": { "name": {"$ref": "#/definitions/tableSchemaFieldName"}, "title": {"$ref": "#/definitions/title"}, "description": {"$ref": "#/definitions/description"}, "type": { "description": "The type keyword, which `MUST` be a value of `duration`.", "enum": ["duration"] }, "format": { "description": "There are no format keyword options for `duration`: only `default` is allowed.", "enum": ["default"], "default": "default" }, "constraints": { "title": "Constraints", "description": "The following constraints are supported for `duration` fields.", "type": "object", "properties": { "required": {"$ref": "#/definitions/tableSchemaConstraintRequired"}, "unique": {"$ref": "#/definitions/tableSchemaConstraintUnique"}, "enum": {"$ref": "#/definitions/tableSchemaConstraintEnumString"}, "minimum": {"$ref": "#/definitions/tableSchemaConstraintMinimumString"}, "maximum": {"$ref": "#/definitions/tableSchemaConstraintMaximumString"} } }, "rdfType": {"$ref": "#/definitions/tableSchemaRdfType"} }, "examples": ["{\n \"name\": \"period\"\n \"type\": \"duration\"\n}\n"] }, "tableSchemaFieldObject": { "type": "object", "title": "Object Field", "description": "The field contains data which can be parsed as a valid JSON object.", "required": [ "name", "type" ], "properties": { "name": {"$ref": "#/definitions/tableSchemaFieldName"}, "title": {"$ref": "#/definitions/title"}, "description": {"$ref": "#/definitions/description"}, "type": { "description": "The type keyword, which `MUST` be a value of `object`.", "enum": ["object"] }, "format": { "description": "There are no format keyword options for `object`: only `default` is allowed.", "enum": ["default"], "default": "default" }, "constraints": { "title": "Constraints", "description": "The following constraints apply for `object` fields.", "type": "object", "properties": { "required": {"$ref": "#/definitions/tableSchemaConstraintRequired"}, "unique": {"$ref": "#/definitions/tableSchemaConstraintUnique"}, "enum": { "oneOf": [ {"$ref": "#/definitions/tableSchemaConstraintEnumString"}, {"$ref": "#/definitions/tableSchemaConstraintEnumObject"} ] }, "minLength": {"$ref": "#/definitions/tableSchemaConstraintMinLength"}, "maxLength": {"$ref": "#/definitions/tableSchemaConstraintMaxLength"} } }, "rdfType": {"$ref": "#/definitions/tableSchemaRdfType"} }, "examples": ["{\n \"name\": \"extra\"\n \"type\": \"object\"\n}\n"] }, "tableSchemaFieldArray": { "type": "object", "title": "Array Field", "description": "The field contains data which can be parsed as a valid JSON array.", "required": [ "name", "type" ], "properties": { "name": {"$ref": "#/definitions/tableSchemaFieldName"}, "title": {"$ref": "#/definitions/title"}, "description": {"$ref": "#/definitions/description"}, "type": { "description": "The type keyword, which `MUST` be a value of `array`.", "enum": ["array"] }, "format": { "description": "There are no format keyword options for `array`: only `default` is allowed.", "enum": ["default"], "default": "default" }, "constraints": { "title": "Constraints", "description": "The following constraints apply for `array` fields.", "type": "object", "properties": { "required": {"$ref": "#/definitions/tableSchemaConstraintRequired"}, "unique": {"$ref": "#/definitions/tableSchemaConstraintUnique"}, "enum": { "oneOf": [ {"$ref": "#/definitions/tableSchemaConstraintEnumString"}, {"$ref": "#/definitions/tableSchemaConstraintEnumArray"} ] }, "minLength": {"$ref": "#/definitions/tableSchemaConstraintMinLength"}, "maxLength": {"$ref": "#/definitions/tableSchemaConstraintMaxLength"} } }, "rdfType": {"$ref": "#/definitions/tableSchemaRdfType"} }, "examples": ["{\n \"name\": \"options\"\n \"type\": \"array\"\n}\n"] }, "tableSchemaFieldGeoJSON": { "type": "object", "title": "GeoJSON Field", "description": "The field contains a JSON object according to GeoJSON or TopoJSON", "required": [ "name", "type" ], "properties": { "name": {"$ref": "#/definitions/tableSchemaFieldName"}, "title": {"$ref": "#/definitions/title"}, "description": {"$ref": "#/definitions/description"}, "type": { "description": "The type keyword, which `MUST` be a value of `geojson`.", "enum": ["geojson"] }, "format": { "description": "The format keyword options for `geojson` are `default` and `topojson`.", "context": "The following `format` options are supported:\n * **default**: A geojson object as per the [GeoJSON spec](http://geojson.org/).\n * **topojson**: A topojson object as per the [TopoJSON spec](https://github.com/topojson/topojson-specification/blob/master/README.md)", "enum": [ "default", "topojson" ], "default": "default" }, "constraints": { "title": "Constraints", "description": "The following constraints are supported for `geojson` fields.", "type": "object", "properties": { "required": {"$ref": "#/definitions/tableSchemaConstraintRequired"}, "unique": {"$ref": "#/definitions/tableSchemaConstraintUnique"}, "enum": { "oneOf": [ {"$ref": "#/definitions/tableSchemaConstraintEnumString"}, {"$ref": "#/definitions/tableSchemaConstraintEnumObject"} ] }, "minLength": {"$ref": "#/definitions/tableSchemaConstraintMinLength"}, "maxLength": {"$ref": "#/definitions/tableSchemaConstraintMaxLength"} } }, "rdfType": {"$ref": "#/definitions/tableSchemaRdfType"} }, "examples": [ "{\n \"name\": \"city_limits\",\n \"type\": \"geojson\"\n}\n", "{\n \"name\": \"city_limits\",\n \"type\": \"geojson\",\n \"format\": \"topojson\"\n}\n" ] }, "tableSchemaFieldGeoPoint": { "type": "object", "title": "GeoPoint Field", "description": "The field contains data describing a geographic point.", "required": [ "name", "type" ], "properties": { "name": {"$ref": "#/definitions/tableSchemaFieldName"}, "title": {"$ref": "#/definitions/title"}, "description": {"$ref": "#/definitions/description"}, "type": { "description": "The type keyword, which `MUST` be a value of `geopoint`.", "enum": ["geopoint"] }, "format": { "description": "The format keyword options for `geopoint` are `default`,`array`, and `object`.", "context": "The following `format` options are supported:\n * **default**: A string of the pattern 'lon, lat', where `lon` is the longitude and `lat` is the latitude.\n * **array**: An array of exactly two items, where each item is either a number, or a string parsable as a number, and the first item is `lon` and the second item is `lat`.\n * **object**: A JSON object with exactly two keys, `lat` and `lon`", "notes": ["Implementations `MUST` strip all white space in the default format of `lon, lat`."], "enum": [ "default", "array", "object" ], "default": "default" }, "constraints": { "title": "Constraints", "description": "The following constraints are supported for `geopoint` fields.", "type": "object", "properties": { "required": {"$ref": "#/definitions/tableSchemaConstraintRequired"}, "unique": {"$ref": "#/definitions/tableSchemaConstraintUnique"}, "enum": { "oneOf": [ {"$ref": "#/definitions/tableSchemaConstraintEnumString"}, {"$ref": "#/definitions/tableSchemaConstraintEnumArray"}, {"$ref": "#/definitions/tableSchemaConstraintEnumObject"} ] } } }, "rdfType": {"$ref": "#/definitions/tableSchemaRdfType"} }, "examples": [ "{\n \"name\": \"post_office\",\n \"type\": \"geopoint\"\n}\n", "{\n \"name\": \"post_office\",\n \"type\": \"geopoint\",\n \"format\": \"array\"\n}\n" ] }, "tableSchemaFieldAny": { "type": "object", "title": "Any Field", "description": "Any value is accepted, including values that are not captured by the type/format/constraint requirements of the specification.", "required": [ "name", "type" ], "properties": { "name": {"$ref": "#/definitions/tableSchemaFieldName"}, "title": {"$ref": "#/definitions/title"}, "description": {"$ref": "#/definitions/description"}, "type": { "description": "The type keyword, which `MUST` be a value of `any`.", "enum": ["any"] }, "constraints": { "title": "Constraints", "description": "The following constraints apply to `any` fields.", "type": "object", "properties": { "required": {"$ref": "#/definitions/tableSchemaConstraintRequired"}, "unique": {"$ref": "#/definitions/tableSchemaConstraintUnique"}, "enum": {"$ref": "#/definitions/tableSchemaConstraintEnumAny"} } }, "rdfType": {"$ref": "#/definitions/tableSchemaRdfType"} }, "examples": ["{\n \"name\": \"notes\",\n \"type\": \"any\"\n"] }, "tableSchemaConstraintRequired": { "type": "boolean", "description": "Indicates whether a property must have a value for each instance.", "context": "An empty string is considered to be a missing value." }, "tableSchemaConstraintUnique": { "type": "boolean", "description": "When `true`, each value for the property `MUST` be unique." }, "tableSchemaConstraintPattern": { "type": "string", "description": "A regular expression pattern to test each value of the property against, where a truthy response indicates validity.", "context": "Regular expressions `SHOULD` conform to the [XML Schema regular expression syntax](http://www.w3.org/TR/xmlschema-2/#regexs)." }, "tableSchemaConstraintEnumString": { "type": "array", "minItems": 1, "uniqueItems": true, "items": {"type": "string"} }, "tableSchemaConstraintEnumBoolean": { "type": "array", "minItems": 1, "uniqueItems": true, "items": {"type": "boolean"} }, "tableSchemaConstraintEnumInteger": { "type": "array", "minItems": 1, "uniqueItems": true, "items": {"type": "integer"} }, "tableSchemaConstraintEnumNumber": { "type": "array", "minItems": 1, "uniqueItems": true, "items": {"type": "number"} }, "tableSchemaConstraintEnumArray": { "type": "array", "minItems": 1, "uniqueItems": true, "items": {"type": "array"} }, "tableSchemaConstraintEnumObject": { "type": "array", "minItems": 1, "uniqueItems": true, "items": {"type": "object"} }, "tableSchemaConstraintEnumAny": { "type": "array", "minItems": 1, "uniqueItems": true }, "tableSchemaConstraintMinLength": { "type": "integer", "description": "An integer that specifies the minimum length of a value." }, "tableSchemaConstraintMaxLength": { "type": "integer", "description": "An integer that specifies the maximum length of a value." }, "tableSchemaConstraintMinimumString": {"type": "string"}, "tableSchemaConstraintMinimumInteger": {"type": "integer"}, "tableSchemaConstraintMinimumNumber": {"type": "number"}, "tableSchemaConstraintMinimumArray": {"type": "array"}, "tableSchemaConstraintMinimumObject": {"type": "object"}, "tableSchemaConstraintMaximumString": {"type": "string"}, "tableSchemaConstraintMaximumInteger": {"type": "integer"}, "tableSchemaConstraintMaximumNumber": {"type": "number"}, "tableSchemaConstraintMaximumArray": {"type": "array"}, "tableSchemaConstraintMaximumObject": {"type": "object"}, "tableSchemaRdfType": { "type": "string", "description": "The RDF type for this field." }, "tableSchemaBareNumber": { "type": "boolean", "title": "bareNumber", "description": "a boolean field with a default of `true`. If `true` the physical contents of this field must follow the formatting constraints already set out. If `false` the contents of this field may contain leading and/or trailing non-numeric characters (which implementors MUST therefore strip). The purpose of `bareNumber` is to allow publishers to publish numeric data that contains trailing characters such as percentages e.g. `95%` or leading characters such as currencies e.g. `\u20ac95` or `EUR 95`. Note that it is entirely up to implementors what, if anything, they do with stripped text.", "default": true } } }