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 <1>", с точностью не ниже чем "День".

--------------------------------

<1> http://www.ietf.org/rfc/rfc1738.txt.

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/opendata/7712345678-showrooms/data-20130601T0000-structure-20130401T0000.xml

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

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

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

structure-20130401T0000,http://example.com/opendata/7712345678-showrooms/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 (пример)

      
      

http://opendata.gosmonitor.ru/standard/3.0
        7712345678-showrooms
        Список выставочных залов
        Список  выставочных  залов  с  указанием  контактных  данных
по округам и районам.
        Министерство культуры
        20130401
        20130601T0000
        Выставка,зал,выставочный зал,культура
        xml
        
          
            http://example.com/opendata/7712345678-showrooms/data-
20130601T0000-structure-20130401T0000.xml
            20130601T0000
            Исправлены   незначительные   ошибки,   добавлены   новые
выставочные залы
            201307010
            20130401T0000
          
          
            http://example.com/opendata/7712345678-showrooms/data-
20130501T0000-structure-20130401T0000.xml
            20130501T0000
            Добавлены новые выставочные залы
            20130601
            20130401T0000
          
          
              http://example.com/opendata/7712345678-showrooms/data-
20130406T0000-structure-20130401T0000.xml
              20130406T0000
              Исправление критической ошибки
              20130501
              20130401T0000
            
            
              http://example.com/opendata/7712345678-showrooms/data-
20130401T0000-structure-20130401T0000.xml
              20130401T0000
              Первичная публикация
              20130501
              20130401T0000
            
          
          
            
              http://example.com/opendata/7712345678-showrooms/structure-
20130401T0000.xsd
              20130401T0000
            
          
          
            Иванов Иван Иванович
            +74951234567
            ivanov@example.com
          
        

meta-schema.xsd

      
      
        

        
          
            Opendata
metadata.
            Паспорт      набора     открытых
данных.
          
          
            
              
                Link    to    opendata   standard
version, which corresponds to current opendata meta.
                Ссылка  на  версию   методических
рекомендаций,    которой   соответствует   публикация   этого   паспорта   набора
открытых данных.
          
        
        
          
            Opendata               identification
number.
            Идентификационный   номер   набора
данных.
          
        
        
          
            Opendata
title.
            Наименование          набора
данных.
          
        
        
          
            Opendata
description.
            Описание            набора
данных.
          
        
        
          
            Opendata
owner.
            Владелец            набора
данных.
          
        
        
          
            Date     of     first    opendata
publication in ISO 8601 format.
            Дата   первой   публикации   набора
данных в формате ISO 8601.
          
        
        
          
            Date     of     last     opendata
changing in ISO 8601 format.
            Дата     последнего     внесения
изменений в формате ISO 8601.
          
        
        
          
            Keywords    of    the     opendata
content.
            Ключевые   слова,   соответствующие
содержанию набора данных.
          
        
        
          
            Opendata
format.
            Формат
данных.
          
        
        
        
        
      
    

    
      
        Opendata
versions.
        Версии       наборов       открытых
данных.
          
          
            
          
        

        
          
            Opendata.
            Набор            открытых
данных.
          
          
            
              
                Link       to      opendata
file.
                Ссылка  на  файл набора открытых
данных.
          
        
        
          
            Date  of  opendata  creation  in ISO
8601 format.
            Дата   создания   набора   открытых
данных в формате ISO 8601.
          
        
        
          
            Description   of  changes  compared
to the previous opendata version.
            Описание   изменений  по  сравнению
с предыдущей версией набора открытых данных.
          
        
        
          
            Date  on  which  opendata  will  be
actual in ISO 8601 format.
            Дата,     до     которой     будет
актуальным набор открытых данных в формате ISO 8601.
          
        
        
          
            Creation   date   of  corresponding
opendata structure in ISO 8601 format.
            Дата    создания   соответствующей
структуры набора открытых данных в формате ISO 8601.
          
        
      
    

    
      
        Opendata             structure
versions.
        Версии   структур   наборов   открытых
данных.
      
      
        
      
    

    
      
        Opendata
structure.
        Структура набора открытых
данных.
      
      
        
          
            Link    to    opendata   structure
file.
            Ссылка   на   файл структуры набора
открытых данных.
          
        
        
          
            Date    of    opendata   structure
creation in ISO 8601 format.
            Дата   создания   структуры  набора
открытых данных в формате ISO 8601.
          
        
      
    

    
      
        Opendata
publisher.
        Ответственное
лицо.
      
      
            
              
                Opendata         publisher
name.
                Имя         ответственного
лица.
          
        
        
          
            Opendata    publisher      phone
number.
                Телефон            ответственного
лица.
              
            
            
              
                Opendata      publisher      e-
mail.
                Адрес    электронной      почты
ответственного лица.
              
            
          
        
      

Паспорт набора открытых данных (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-structure-20130401T0000.xml",
           "created": "20130601T0000",
           "provenance":   "Исправлены   незначительные  ошибки,  добавлены новые
выставочные залы.",
           "valid": "201307010",
           "structure": "20130401T0000"
         },
         {
           "source":      "http://example.com/opendata/7712345678-showrooms/data-
20130601T0000-structure-20130401T0000.xml",
           "created": "20130501T0000",
           "provenance": "Добавлены новые выставочные залы.",
           "valid": "20130601",
           "structure": "20130401T0000"
         },
         {
           "source":      "http://example.com/opendata/7712345678-showrooms/data-
20130406T0000-structure-20130401T0000.xml",
           "created": "20130406T0000",
           "provenance":  "Исправление  критической ошибки.",
           "valid": "20130501",
           "structure": "20130401T0000"
         },
         {
           "source":      "http://example.com/opendata/7712345678-showrooms/data-
20130401T0000-structure-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 file.",
                 "type": "string"
               },
               "created": {
                 "description": "Date of opendata structure creation in ISO
8601 format.",
                 "type": "string"
               }
             }
           }
         },
         "publisher": {
           "description": "Opendata publisher.",
           "type": "object",
           "properties": {
             "name": {
               "description": "Opendata publisher name.",
               "type":"string"
             },
             "phone": {
               "description": "Opendata publisher phone number.",
               "type": "string"
             },
             "mbox": {
               "description": "Opendata publisher e-mail.",
               "type": "string"
             }
           },
           "required": ["name", "phone", "mbox"]
         }
       },
       "required": ["identifier", "title", "description", "creator", "created",
"modified", "subject", "format", "data", "structure", "publisher"]
    }

Паспорт набора открытых данных (HTML + RDFa)

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

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

meta.html (пример)

      
      
      
        Opendata meta
      
      
        
/tr>
NХарактеристикаЗначение характеристики
1Идентификационный номер7712345678-showrooms
2Наименование набора данныхСписок выставочных залов
3Описание набора данныхСписок выставочных залов с указанием контактных данных по округам и районам.
4Владелец набора данныхМинэкономразвития России
5Ответственное лицоИванов Иван Иванович
6Телефон ответственного лица8 (495) 123- 45-67
7Адрес электронной почты ответственного лицаivanov@example.com
8Гиперсылка (URL) на наборdata.xml
9Формат данныхXML
10Описание структуры набора данныхstructure.xsd
11Дата первой публикации набора данных01.04.2013
12Дата последнего внесения изменений01.06.2013
13Содержание последнего измененияИсправлены незначительные ошибки, добавлены новые выставочные залы
14Периодичность актуализации набора данных01.07.2013
15Ключевые слова, соответствующие содержанию набора данныхВыставка,зал,выставочный зал,культура
16Гиперссылки (URL) на версии набора данных
  • Версия за 01.05.2013
  • Версия за 06.04.2013
  • Версия за 01.04.2013
17Гиперссылки (URL) на версии структуры набора данных