15. Приложение 7. Требование к представлению реестра наборов открытых данных ["Методические рекомендации по публикации открытых данных государственными органами и органами местного самоуправления, а также технические требования к публикации открытых данных. Версия 3.0" (утв. протоколом заседания Правительственной комиссии по координации деятельности Открытого Правительства от 29.05.2014 N 4)] - последняя редакция

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. Значением атрибута является формат значения поля реестра наборов открытых данных.

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

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,Список выставочных залов,http://example.com/opendata/7712345678-showrooms/meta.xml,xml

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

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

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

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

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

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

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 (пример)

      
      
http://opendata.gosmonitor.ru/standard/3.0
        
          
            1
            Список выставочных залов
            http://example.com/opendata/7712345678-
showrooms/meta.xml
            xml
          
          
            2
            Список муниципальных библиотек
            http://example.com/opendata/7712345678-
libraries/meta.csv
            csv

list-schema.xsd

Opendata list.
Реестр наборов открытых
данных.

Link to opendata standard
version, which corresponds to current opendata list.
Ссылка на версию методических
рекомендаций, которой соответствует публикация этого реестра наборов открытых
данных.

Opendata metadata
list.
Список паспортов наборов открытых
данных.

Opendata
metadata.
Паспорт набора открытых
данных.

Opendata identification
number.
Идентификационный номер набора
данных.

Opendata
title.
Наименование набора
данных.

Opendata meta
link.
Ссылка на паспорт набора
открытых данных.

Opendata meta
format.
Формат паспорта набора открытых
данных.

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

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

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

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

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

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" приложено ниже).

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 (пример)

    
    
      
        Opendata
      
      
      
        
        


          N Название набора данных  
          
          1 Список
выставочных залов  
          2 Список
муниципальных библиотек

N	Название набора данных
1	Список выставочных залов
2	Список муниципальных библиотек