16. Приложение 8. Требование к представлению паспорта набора открытых данных

16. Приложение 8. Требование к представлению паспорта набора открытых данных

Паспорт набора открытых данных (CSV)

Требования к публикации паспорта набора открытых данных в машиночитаемом формате CSV

1) Требования к расположению:

a. Машиночитаемый формат паспорта набора открытых данных представлен отдельным файлом в формате CSV.

b. Файл имеет название "meta.csv".

2) Требования к формату:

a. Соответствие файла стандарту RFC - "Common Format and MIME Type for Comma-Separated Values (CSV) Files" (http://tools.ietf.org/html/rfc4180).

b. Дополнительные требования к CSV:

i. Разделителем полей является знак "," (запятая).

ii. Ограничителем строк является знак """ (универсальная двойная кавычка).

iii. Разделителем целой и дробной части чисел является знак "." (точка).

c. Кодировка файла - "UTF-8".

3) Требование к структуре данных:

a. По горизонтали перечислены атрибуты полей паспорта набора открытых данных, по вертикали перечислены поля паспорта набора открытых данных.

b. Наличие следующих обязательных атрибутов поля паспорта набора открытых данных:

i. Атрибут поля "Наименование поля паспорта набора открытых данных":

1. Должен быть установлен следующий обязательный заголовок атрибута: "property".

2. Значением атрибута является наименование поля паспорта набора открытых данных.

ii. Атрибут поля "Значение поля паспорта набора открытых данных":

1. Должен быть установлен следующий обязательный заголовок атрибута: "value".

2. Значением атрибута является значение поля паспорта набора открытых данных.

c. Наличие следующих обязательных полей паспорта

i. Поле паспорта "Версия методических рекомендаций":

1. Должно быть установлено следующее обязательное наименование поля: "standardversion".

2. Значением поля является ссылка на версию методических рекомендаций, которой соответствует публикация этого паспорта набора открытых данных.

ii. Поле паспорта "Идентификационный номер":

1. Должно быть установлено следующее обязательное наименование поля: "identifier".

2. Значением поля является идентификационный номер набора открытых данных.

iii. Поле паспорта "Наименование набора данных":

1. Должно быть установлено следующее обязательное наименование поля: "title".

2. Значением поля является наименование набора открытых данных.

iv. Поле паспорта "Описание набора данных":

1. Должно быть установлено следующее обязательное наименование поля: "description".

2. Значением поля является подробное описание набора открытых данных.

v. Поле паспорта "Владелец набора данных":

1. Должно быть установлено следующее обязательное наименование поля: "creator".

2. Значением поля является владелец набора открытых данных, юридическое или физическое лицо, которое публикует свои данные.

vi. Поле паспорта "Дата первой публикации набора данных":

1. Должно быть установлено следующее обязательное наименование поля: "created".

2. Значением поля является дата первичной публикации набора открытых данных в формате "ISO 8601*(33)", с точностью не ниже чем "День".

vii. Поле паспорта "Дата последнего внесения изменений":

1. Должно быть установлено следующее обязательное наименование поля: "modified".

2. Значением поля является дата последнего внесения изменения в набор, структуру или паспорт открытых данных в формате "ISO 8601", с точностью не ниже чем "День" и достаточной для отделения актуальной версии набора открытых данных от предыдущей версии.

viii. Поле паспорта "Ключевые слова, соответствующие содержанию набора данных":

1. Должно быть установлено следующее обязательное наименование поля: "subject".

2. Значением поля является список ключевых слов соответствующих содержанию набора, разделенных между собой знаком "," (запятая).

ix. Поле паспорта "Формат данных":

1. Должно быть установлено следующее обязательное наименование поля: "format".

2. Значением поля является формат набора открытых данных в нижнем регистре. Например: csv, xml.

x. Поле паспорта "Содержание последних изменений":

1. Должно быть установлено следующее обязательное наименование поля: "provenance".

2. Значением поля является описание внесенных изменений в последнюю версию набора открытых данных.

xi. Поле паспорта "Дата актуальности":

1. Должно быть установлено следующее обязательное наименование поля: "valid".

2. Значением поля является дата, до которой будет актуальной последняя версия набора открытых данных в формате "ISO 8601", с точностью не ниже чем "День".

xii. Поле паспорта "Ответственное лицо":

1. Должно быть установлено следующее обязательное наименование поля: "publishername".

2. Значением поля является ФИО лица ответственного за публикацию текущего набора открытых данных.

xiii. Поле паспорта "Телефон ответственного лица":

1. Должно быть установлено следующее обязательное наименование поля: "publisherphone".

2. Значением поля является телефон лица ответственного за публикацию текущего набора открытых данных, в следующем формате: "+<код страны> <код региона><номер телефона"). Пояснение, сначала идет знак "+", потом код страны без форматирования (то есть без скобок, дефисов, и прочих знаков), затем код города (области или иного региона) без форматирования и затем номер телефона без форматирования.

xiv. Поле паспорта "Адрес электронной почты ответственного лица":

1. Должно быть установлено следующее обязательное наименование поля: "publishermbox".

2. Значением поля является электронная почта лица ответственного за публикацию текущего набора открытых данных.

xv. Поле паспорта "Файл набора открытых данных" (данное поле повторяется для каждой опубликованной версии файла набора открытых данных с учетом глубины хранения версий):

1. Должно быть установлено следующее обязательное наименование поля: "data-<data-version>-structure-<structure-version>". Где <data-version> - версия файла набора открытых данных и <structure-version> - версия соответствующего файла структуры набора открытых данных.

2. Значением поля является ссылка на файл набора открытых данных.

3. Все поля этого типа должны быть отсортированы в убывающем порядке согласно версии файла набора открытых данных.

xvi. Поле паспорта "Файл структуры набора открытых данных" (данное поле повторяется для каждой версии файла структуры набора открытых данных, для которой существует опубликованный файл набора открытых данных с учетом глубины хранения версий):

1. Должно быть установлено следующее обязательное наименование поля: "structure-<structure-version>". Где <structure-version> - версия файла структуры набора открытых данных.

2. Значением поля является ссылка на файл структуры набора открытых данных.

3. Все поля этого типа должны быть отсортированы в убывающем порядке согласно версии файла набора открытых данных.

meta.csv (пример)

property,value

standardversion,http://opendata.gosmonitor.ru/standard/3.0

identifier,7712345678-showrooms

title,Список выставочных залов

description,Список выставочных залов с указанием контактных данных по округам и районам.

creator,Министерство культуры

created,20130401

modified,20130601

subject,"Выставка,зал,выставочный зал,культура"

format,xml

provenance,"Исправлены незначительные ошибки, добавлены новые выставочные залы"

valid,20130701

publishername,Иванов Иван Иванович

publisherphone,+74951234567

publishermbox,ivanov@example.com

data-20130601T0000-structure-20130401T0000,http://example.com/openda ta/7712345678-showrooms/data-20130601T0000-structure-20130401T0000.xml

data-20130501T0000-structure-20130401T0000,http://example.com/openda ta/7712345678-showrooms/data-20130501T0000-structure-20130401T0000.xml

data-20130406T0000-structure-20130401T0000,http://example.com/openda ta/7712345678-showrooms/data-20130406T0000-structure-20130401T0000.xml

data-20130401T0000-structure-20130401T0000,http://example.com/openda ta/7712345678-showrooms/data-20130401T0000-structure-20130401T0000.xml

structure-20130401T0000,http://example.com/opendata/7712345678-showr ooms/structure-20130401T0000.xsd

Паспорт набора открытых данных (XML)

Требования к публикации паспорта набора открытых данных в машиночитаемом формате XML

1) Требования к расположению:

a. Машиночитаемый формат реестра открытых данных представлен отдельным файлом в формате XML.

b. Файл имеет название "meta.xml".

2) Требования к формату:

a. Соответствие файла стандарту W3C - "Extensible Markup Language (XML) 1.1 (Second Edition)" (http://www.w3.org/TR/xml11/).

b. Кодировка файла указывается в объявлении XML если объявление XML используется, иначе используется кодировка "UTF-8".

3) Требование к структуре данных:

a. Соответствие файлу структуры паспорта набора открытых данных - "meta-schema.xsd" (Содержимое файла "meta-schema.xsd" приложено ниже).

meta.xml (пример)

<?xml version="1.0" encoding="utf-8"?>

<meta>

<standardversion>http://opendata.gosmonitor.ru/standard/3.0</standar dversion>

<identifier>7712345678-showrooms</identifier>

<title>Список выставочных залoв</title>

<description>Список выставочных залов с указанием контактных данных по округам и районам.</description>

<creator>Министерство культуры</creator>

<created>20130401</created>

<modified>20130601T0000</modified>

<subject>Выставка,зал,выставочный зал,культура</subject>

<format>xml</format>

<data>

<dataversion>

<source>http://example.com/opendata/7712345678-showrooms/data-

20130601T0000-structure-20130401T0000.xml</source>

<created>20130601T0000</created>

<provenance>Исправлены незначительные ошибки, добавлены новые выставочные залы</provenance>

<valid>201307010</valid>

<structure>20130401T0000</structure>

</dataversion>

<dataversion>

<source>http://example.com/opendata/7712345678-showrooms/data-201305 01T0000-structure-20130401T0000.xml</source>

<created>20130501T0000</created>

<provenance>Добавлены новые выставочные залы</provenance>

<valid>20130601</valid>

<structure>20130401T0000</structure>

</dataversion>

<dataversion>

<source>http://example.com/opendata/7712345678-showrooms/data-201304 06T0000-structure-20130401T0000.xml</source>

<created>20130406T0000</created>

<provenance>Исправление критической ошибки</provenance>

<valid>20130501</valid>

<structure>20130401T0000</structure>

</dataversion>

<dataversion>

<source>http://example.com/opendata/7712345678-showrooms/data-201304 01T0000-structure-20130401T0000.xml</source>

<created>20130401T0000</created>

<provenance>Первичная публикация</provenance>

<valid>20130501</valid> <structure>20130401T0000</structure>

</dataversion>

</data>

<structure>

<structureversion>

<source>http://example.com/opendata/7712345678-showrooms/structure-2 0130401T0000.xsd</source>

<created>20130401T0000</created>

</structureversion>

</structure>

<publisher>

<name>Иванов Иван Иванович</name>

<phone>+7 4 9512 34 5 67</phone>

<mbox>ivanov@example.com</mbox>

</publisher>

</meta>

meta-schema.xsd

<?xml version="1.0" encoding="utf-8"?>

<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" attributeFormDefault="unqualified" elementFormDefault="qualified">

<xs:element type="Meta" name="meta"/>

<xs:complexType name="Meta">

<xs:annotation>

<xs:documentation xml:lang="en">Opendata metadata.</xs:documentation>

<xs:documentation xml:lang="ru">Паспорт набора открытых данных.</xs:documentation>

</xs:annotation>

<xs:sequence>

<xs:element type="xs:anyURI" name="standardversion">

<xs:annotation>

<xs:documentation xml:lang="en">Link to opendata standard version, which corresponds to current opendata meta.</xs:documentation>

<xs:documentation xml:lang="ru">Ссылка на версию методических рекомендаций, которой соответствует публикация этого паспорта набора открытых данных^/xs: documentation>

</xs:annotation>

</xs:element>

<xs:element type="xs:string" name="identifier">

<xs:annotation>

<xs:documentation xml:lang="en">Opendata identification number.</xs:documentation>

<xs:documentation xml:lang="ru">Идентификационный номер набора данных.</xs:documentation>

</xs:annotation>

</xs:element>

<xs:element type="xs:string" name="title">

<xs:annotation>

<xs:documentation xml:lang="en">Opendata title.</xs:documentation>

<xs:documentation xml:lang="ru">Наименование набора данных.</xs:documentation>

</xs:annotation>

</xs:element>

<xs:element type="xs:string" name="description">

<xs:annotation>

<xs:documentation xml:lang="en">Opendata description.</xs:documentation>

<xs:documentation xml:lang="ru">Описание набора данных.</xs:documentation>

</xs:annotation>

</xs:element>

<xs:element type="xs:string" name="creator">

<xs:annotation>

<xs:documentation xml:lang="en">Opendata owner.</xs:documentation>

<xs:documentation xml:lang="ru">Владелец набора данных.</xs:documentation>

</xs:annotation>

</xs:element>

<xs:element type="xs:string" name="created">

<xs:annotation>

<xs:documentation xml:lang="en">Date of first opendata publication in ISO 8601 format.</xs:documentation>

<xs:documentation xml:lang="ru">Дата первой публикации набора данных в формате ISO 8601.</xs:documentation>

</xs:annotation>

</xs:element>

<xs:element type="xs:string" name="modified">

<xs:annotation>

<xs:documentation xml:lang="en">Date of last opendata changing in ISO 8601 format.</xs:documentation>

<xs:documentation xml:lang="ru">Дата последнего внесения изменений в формате ISO 8601.</xs:documentation>

</xs:annotation>

</xs:element>

<xs:element type="xs:string" name="subject">

<xs:annotation>

<xs:documentation xml:lang="en">Keywords of the opendata content.</xs:documentation>

<xs:documentation xml:lang="ru">Ключевые слова, соответствующие содержанию набора данных.</xs:documentation>

</xs:annotation>

</xs:element>

<xs:element type="xs:string" name="format">

<xs:annotation>

<xs:documentation xml:lang="en">Opendata format.</xs:documentation>

<xs:documentation xml:lang="ru">Формат данных.</xs:documentation>

</xs:annotation>

</xs:element>

<xs:element type="Data" name="data"/>

<xs:element type="Structure" name="structure"/>

<xs:element type="Publisher" name="publisher"/>

</xs:sequence>

</xs:complexType>

<xs:complexType name="Data">

<xs:annotation>

<xs:documentation xml:lang="en">Opendata versions.</xs:documentation>

<xs:documentation xml:lang="ru">Версии наборов открытых данных.</xs:documentation>

</xs:annotation>

<xs:sequence>

<xs:element type="DataVersion" name="dataversion" maxOccurs="unbounded"/>

</xs:sequence>

</xs:complexType>

<xs:complexType name="DataVersion">

<xs:annotation>

<xs:documentation xml:lang="en">Opendata.</xs:documentation>

<xs:documentation xml:lang="ru">Набор открытых данных.</xs:documentation>

</xs:annotation>

<xs:sequence>

<xs:element type="xs:anyURI" name="source">

<xs:annotation>

<xs:documentation xml:lang="en">Link to opendata file.</xs:documentation>

<xs:documentation xml:lang="ru">Ссылка на файл набора открытых данных.</xs:documentation>

</xs:annotation>

</xs:element>

<xs:element type="xs:string" name="created">

<xs:annotation>

<xs:documentation xml:lang="en">Date of opendata creation in ISO 8601 format.</xs:documentation>

<xs:documentation xml:lang="ru">Дата создания набора открытых данных в формате ISO 8601.</xs:documentation>

</xs:annotation>

</xs:element>

<xs:element type="xs:string" name="provenance">

<xs:annotation>

<xs:documentation xml:lang="en">Description of changes compared to the previous opendata version.</xs:documentation>

<xs:documentation xml:lang="ru">Описание изменений по сравнению с предыдущей версией набора открытых данных.</xs:documentation>

</xs:annotation>

</xs:element>

<xs:element type="xs:string" name="valid">

<xs:annotation>

<xs:documentation xml:lang="en">Date on which opendata will be actual in ISO 8601 format.</xs:documentation>

<xs:documentation xml:lang="ru">Дата, до которой будет актуальным набор открытых данных в формате ISO 8601.</xs:documentation>

</xs:annotation>

</xs:element>

<xs:element type="xs:string" name="structure">

<xs:annotation>

<xs:documentation xml:lang="en">Creation date of corresponding opendata structure in ISO 8601 format.</xs:documentation>

<xs:documentation xml:lang="ru">Дата создания соответсвующей структуры набора открытых данных в формате ISO 8601.</xs:documentation>

</xs:annotation>

</xs:element> </xs:sequence>

</xs:complexType>

<xs:complexType name="Structure">

<xs:annotation>

<xs:documentation xml:lang="en">Opendata structure versions.</xs:documentation>

<xs:documentation xml:lang="ru">Версии структур наборов открытых данных.</xs:documentation>

</xs:annotation>

<xs:sequence>

<xs:element type="StructureVersion" name="structureversion" maxOccurs="unbounded"/>

</xs:sequence>

</xs:complexType>

<xs:complexType name="StructureVersion">

<xs:annotation>

<xs:documentation xml:lang="en">Opendata structure.</xs:documentation>

<xs:documentation xml:lang="ru">Структура набора открытых данных.</xs:documentation>

</xs:annotation>

<xs:sequence>

<xs:element type="xs:anyURI" name="source">

<xs:annotation>

<xs:documentation xml:lang="en">Link to opendata structure file.</xs:documentation>

<xs:documentation xml:lang="ru">Ссылка на файл структуры набора открытых данных.</xs:documentation>

</xs:annotation>

</xs:element>

<xs:element type="xs:string" name="created">

<xs:annotation>

<xs:documentation xml:lang="en">Date of opendata structure creation in ISO 8601 format.</xs:documentation>

<xs:documentation xml:lang="ru">Дата создания структуры набора открытых данных в формате ISO 8601.</xs:documentation>

</xs:annotation>

</xs:element>

</xs:sequence>

</xs:complexType>

<xs:complexType name="Publisher">

<xs:annotation>

<xs:documentation xml:lang="en">Opendata publisher.</xs:documentation>

<xs:documentation xml:lang="ru">Ответственное лицo.</xs:documentation>

</xs:annotation>

<xs:sequence>

<xs:element type="xs:string" name="name">

<xs:annotation>

<xs:documentation xml:lang="en">Opendata publisher name.</xs:documentation>

<xs:documentation xml:lang="ru">Имя ответственного лица.</xs:documentation>

</xs:annotation>

</xs:element>

<xs:element type="xs:string" name="phone">

<xs:annotation>

<xs:documentation xml:lang="en">Opendata publisher phone number.</xs:documentation>

<xs:documentation xml:lang="ru">Телефон ответственного лица.</xs:documentation>

</xs:annotation>

</xs:element>

<xs:element type="xs:string" name="mbox">

<xs:annotation>

<xs:documentation xml:lang="en">Opendata publisher e-mail.</xs:documentation>

<xs:documentation xml:lang="ru">Адрес электронной почты ответственного лица.</xs:documentation>

</xs:annotation>

</xs:element>

</xs:sequence>

</xs:complexType>

</xs:schema>

Паспорт набора открытых данных (JSON)

Требования к публикации паспорта набора открытых данных в машиночитаемом формате JSON

1) Требования к расположению:

a. Машиночитаемый формат паспорта открытых данных представлен отдельным файлом в формате JSON.

b. Файл имеет название "meta.json".

2) Требования к формату:

a. Соответствие файла стандарту JSON - (http://json.org/json-ru.html).

b. Кодировка файла - "UTF-8".

3) Требование к структуре данных:

a. Соответствие файлу структуры реестра наборов открытых данных - "meta-schema.json" (Содержимое файла "meta-schema.json" приложено ниже).

meta.json (пример)

{

"standardversion": "http://opendata.gosmonitor.ru/standard/3-0",

"identifier": "7712345678-showrooms",

"title": "Список выставочных залов",

"description": "Список выставочных залов с указанием контактных данных по округам и районам.",

"creator": "Министерство культуры",

"created": "20130401",

"modified": "20130601",

"subject": "Выставка,зал,выставочный зал,культура",

"format": "xml",

"data": [

{

"source": "http://example.com/opendata/7712345678-showrooms/data-20130601T0000-stru cture-20130401T0000.xml",

"created": "20130601T0000",

"provenance": "Исправлены незначительные ошибки, добавлены новые выставочные залы.",

"valid": "201307010",

"structure": "20130401T0000"

},

{

"source": "http://example.com/opendata/7712345678-showrooms/data-2 0130601T0000-structure-2 01304 01T0000.xml",

"created": "20130501T0000",

"provenance": "Добавлены новые выставочные залы.",

"valid": "20130601",

"structure": "20130401T0000"

},

{

"source": "http://example.com/opendata/7712345678-showrooms/data-20130406T0000-stru cture-20130401T0000.xml",

"created": "20130406T0000",

"provenance": "Исправление критической ошибки.",

"valid": "20130501", "structure": "20130401T0000"

},

{

"source": "http://example.com/opendata/7712345678-showrooms/data-20130401T0000-stru cture-20130401T0000.xml",

"created": "20130401T0000",

"provenance": " Первичная публикация.",

"valid": "20130501",

"structure": "20130401T0000"

],

"structure": [

{

"source": "http://example.com/opendata/7712345678-showrooms/structure-20130401T0000 .xsd",

"created": "20130401T0000"

}

],

"publisher": {

"name": " Иванов Иван Иванович",

"phone": "+74951234567",

"mbox": "ivanov@example.com"

}

}

meta-schema.json

{

"$schema": "http://json-schema.org/draft-04/schema#",

"title": "Opendata metadata",

"description": "Opendata metadata.",

"type": "object",

"properties": {

"standardversion": {

"description": "Link to opendata standard version, which corresponds to current opendata meta.",

"type":"string"

"identifier": {

"description": "Opendata identification number.",

"type":"string"

"title": {

"description": "Opendata title.",

"type": "string"

},

"description": {

"description": "Opendata description.",

"type": "string"

},

"creator": {

"description": "Opendata owner.",

"type": "string"

},

"created": {

"description": "Date of first opendata publication in ISO 8601 format.",

"type": "string" "modified": {

"description": "Date of last opendata changing in ISO 8601 format.",

"type": "string"

},

"subject": {

"description": "Keywords of the opendata content.",

"type": "string"

},

"format": {

"description": "Opendata format.",

"type": "string"

"data": {

"description": "Opendata versions.",

"type": "array",

"minItems": 1,

"items": {

"description": "Opendata.",

"type": "object",

"properties": {

"source": {

"description": "Link to opendata file.",

"type": "string"

},

"created": {

"description": "Date of opendata creation in ISO 8601 format.",

"type": "string"

"provenance": {

"description": "Description of changes compared to the previous opendata version.",

"type": "string"

"valid": {

"description": "Date on which opendata will be actual in ISO 8601 format.",

"type": "string"

"structure": {

"description": "Creation date of corresponding opendata structure in ISO 8601 format.",

"type": "string"

}

}

}

},

"structure": {

"description": "Opendata structure versions.",

"type": "array",

"minItems": 1,

"items": {

"description": "Opendata structure.",

"type": "object",

"properties": { "source": {

"description": "Link to opendata structure fil