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

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

Реестр наборов открытых данных (CSV)

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

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

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

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

c. Файл расположен непосредственно в разделе открытых данных. Например, ваш сайт расположен по адресу "http://example.com/". Тогда, учитывая требование к названию файла и возможные адреса раздела открытых данных, файл реестра открытых данных должен быть доступен по одному из двух адресов:

i. http://example.com/opendata/list.csv

ii. http://opendata.example.com/list.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. Должен быть установлен следующий обязательный заголовок атрибута: "title".

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

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

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

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

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

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

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

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

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

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

2. Должен быть установлен следующий обязательный заголовок поля: "Версия методических рекомендаций".

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

4. Атрибут "Формат поля реестра наборов открытых данных" неприменим для этого поля, поэтому значением формата поля является пустая строка.

ii. Поле паспорта "Набор открытых данных" (данное поле повторяется столько раз, сколько опубликовано наборов открытых данных):

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

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

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

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

d. Все наборы перечислены в одном файле, постраничное представление наборов в нескольких CSV файлах не допускается. Пояснение: визуальное представление реестра наборов открытых данных может быть разбито на несколько страниц и иметь сложную навигацию в случае большого количества наборов, но при этом машинное представление должно быть представлено только одним файлом по указанному адресу и никак не зависит от страниц визуального представления.

list.csv (пример)

property,title,value,format

standardversion, Версия методических рекомендаций, http://opendata.gosmonitor.ru/standard/3.0,

7712345678-showrooms,CrracoK выставочных залов, http://example.com/opendata/7712345678-showrooms/meta.xml,xml

7712345678-libraries,Список муниципальных библиотек,http://example.com/opendata/7 712 34 5 67 8-libraries/meta.csv,csv

Реестр наборов открытых данных (XML)

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

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

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

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

c. Файл расположен непосредственно в разделе открытых данных. Например, ваш сайт расположен по адресу "http://example.com/". Тогда, учитывая требование к названию файла и возможные адреса раздела открытых данных, файл реестра открытых данных должен быть доступен по одному из следующих адресов:

i. http://example.com/opendata/list.xml

ii. http://opendata.example.com/list.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. Соответствие файлу структуры реестра наборов открытых данных - "list-schema.xsd" (Содержимое файла "list-schema.xsd" приложено ниже).

b. Все наборы перечислены в одном файле, постраничное представление наборов в нескольких XML файлах не допускается. Пояснение: визуальное представление реестра наборов открытых данных может быть разбито на несколько страниц и иметь сложную навигацию в случае большого количества наборов, но при этом машинное представление должно быть представлено только одним файлом по указанному адресу и никак не зависит от страниц визуального представления.

list.xml (пример)

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

<list>

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

<meta>

<item>

<identifier>1</identifier>

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

<link>http://example.com/opendata/7712345678-showrooms/meta.xml</lin k>

<format>xml</format>

</item> <item>

<identifier>2</identifier>

<title>Список муниципальных библиотек</title>

<link>http://example.com/opendata/7712345678-libraries/meta.csv</lin k>

<format>csv</format>

</item>

</meta>

</list>

list-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="List" name="list"/>

<xs:complexType name="List">

<xs:annotation>

<xs:documentation xml:lang="en">Opendata list.</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 list.</xs:documentation>

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

</xs:annotation>

</xs:element>

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

</xs:sequence>

</xs:complexType>

<xs:complexType name="Meta">

<xs:annotation>

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

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

</xs:annotation>

<xs:sequence>

<xs:element type="MetaItem" name="item" maxOccurs="unbounded" minOccurs="0"/>

</xs:sequence>

</xs:complexType>

<xs:complexType name="MetaItem">

<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: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:anyURI" name="link">

<xs:annotation>

<xs:documentation xml:lang="en">Opendata meta

link.</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 meta

format.</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. Файл имеет название "list.json".

c. Файл расположен непосредственно в разделе открытых данных. Например, ваш сайт расположен по адресу "http://example.com/". Тогда, учитывая требование к названию файла и возможные адреса раздела открытых данных, файл реестра открытых данных должен быть доступен по одному из следующих адресов:

i. http://example.com/opendata/list.json

ii. http://opendata.example.com/list.json

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

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

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

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

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

b. Все наборы перечислены в одном файле, постраничное представление наборов в нескольких XML файлах не допускается. Пояснение: визуальное представление реестра наборов открытых данных может быть разбито на несколько страниц и иметь сложную навигацию в случае большого количества наборов, но при этом машинное представление должно быть представлено только одним файлом по указанному адресу и никак не зависит от страниц визуального представления.

list.json (пример)

{

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

"meta": [

{

"identifier": "7712345678-showrooms",

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

"link": "http://example.com/opendata/7712345678-showrooms/meta.xml",

"format": "xml"

},

{

"identifier": "7712345678-libraries",

"title": "Список муниципальных библиотек",

"link": "http://example.com/opendata/7712345678-libraries/meta.csv",

"format": "xml"

}

]

}

list-schema.json

{

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

"title": "Opendata list",

"description": "Opendata list.",

"type": "object",

"properties": {

"standardversion": {

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

"type": "string"

},

"meta": {

"description": "Opendata metadata list.",

"type": "array",

"minItems": 1,

"items": {

"description": "Opendata metadata.",

"type": "object",

"properties": {

"identifier": {

"description": "Opendata identification number.",

"type": "string"

"title": {

"description": "Opendata title.",

"type": "string"

},

"link": {

"description": "Opendata meta link.",

"type": "string"

},

"format": {

"description": "Opendata meta format.",

"type": "string"

}

},

"required": ["identifier", "title", "link", "format"]

}

}

}

}

Реестр наборов открытых данных (HTML + RDFa)

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

1) Требования к публикации реестра наборов открытых данных в формате HTML+RDFa подробно описаны в приложении 4 данных методических рекомендаций.

list.html (пример)

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML+RDFa 1.0//EN"

"http://www.w3.org/MarkUp/DTD/xhtml-rdfa-1.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="ru"

version="XHTML+RDFa 1.0" dir="ltr"

xmlns:dc="http://purl.org/dc/terms/"

xmlns:foaf="http://xmlns.com/foaf/0.1/">

<head>

<title>Opendata</title> </head>

<body>

<div about="/opendata" typeof="dc:Collection">

<div rel="dc:conformsTo"

resource="http://opendata.gosmonitor.ru/standard/3.0"></div>

<table>

<thead><tr><th>N</th><th>Название набора данных</th> </tr></thead>

<tbody>

<tr rel="dc:hasPart" class="odd"><td>1</td><td typeof="foaf:Document" about="/opendata/7712345678-showrooms" property="dc:title" content="Список

выставочных залов"><a href="/opendata/7712345678-showrooms">Список выставочных залов</a></td> </tr>

<tr rel="dc:hasPart" class="even"><td>2</td><td typeof="foaf:Document" about="/opendata/7712345678-libraries" property="dc:title" content="Список муниципальных библиотек"><a href="/opendata/7 712 34 5 67 8-libraries">Список муниципальных библиотек</a></td> </tr>

</tbody>

</table>

</div>

</body>

</html>