Без рубрики

Об утверждении требований к взаимодействию информационных систем органов исполнительной власти города Москвы с автоматизированной информационной системой "Общегородская платформа открытые данные"

Распоряжение Департамента информационных технологий г. Москвы от 13.12.2012 N 64-16-1107/12

В соответствии с протоколом совещания у заместителя Мэра Москвы в Правительстве Москвы — руководителя Аппарата Мэра и Правительства Москвы А.В. Раковой по реализации проекта "Открытое правительство" от 29.11.2012 б/н, в целях обеспечения технологической возможности подключения органов государственной власти города Москвы, подведомственных им организаций, а также органов местного самоуправления к АИС "Общегородская платформа открытые данные" (далее — АИС ОПОД):
1. Утвердить:
1.1. Требования к взаимодействию информационных систем органов исполнительной власти города Москвы с АИС ОПОД согласно приложению 1 к настоящему распоряжению.
2. Контроль за выполнением настоящего распоряжения возложить на заместителя руководителя департамента Белозерова А.С.

Руководитель департамента А.В. Ермолаев

Приложение 1 к распоряжению Департамента информационных технологий города Москвы от 13 декабря 2012 г. N 64-16-1107/12

ТРЕБОВАНИЯ К ВЗАИМОДЕЙСТВИЮ ИНФОРМАЦИОННЫХ СИСТЕМ ОРГАНОВ ИСПОЛНИТЕЛЬНОЙ ВЛАСТИ ГОРОДА МОСКВЫ С ПЛАТФОРМОЙ "ОТКРЫТЫЕ ДАННЫЕ"

1. Общие положения

1.1. Настоящие Требования определяют последовательность действий и механизмы взаимодействия информационных систем органов исполнительной власти города Москвы (далее — ИС ОИВ) с автоматизированной информационной системой "Общегородская платформа открытых данных" (далее — АИС ОПОД) по предоставлению органами исполнительной власти города Москвы наборов данных с помощью технологий web-сервиса и средствами АИС ОПОД в рамках следующих процессов:
размещение набора открытых данных;
обновление набора открытых данных;
отзыв опубликованного набора открытых данных.
Взаимодействие ИС ОИВ с АИС ОПОД осуществляется с помощью Региональной системы межведомственного электронного взаимодействия города Москвы (далее — РСМЭВ). Каждой ИС ОИВ при регистрации в РСМЭВ присваивается мнемоника. Отказ от использования РСМЭВ при осуществлении межведомственного электронного взаимодействия возможен только при согласовании с оператором АИС ОПОД (далее — оператор).
Взаимодействие ИС ОИВ с платформой "Открытые данные" может осуществляться в следующих режимах:
в автоматическом режиме с использованием электронных сервисов подсистемы информационного обмена АИС ОПОД с программными средствами информационных систем поставщика открытых данных или других внешних систем;
в ручном режиме с использованием графического интерфейса портала АИС ОПОД в установленном порядке.
1.2. В настоящих Требованиях используются следующие термины и определения:
размещение набора открытых данных — передача набора открытых данных поставщиком и обеспечение технической возможности их размещения оператором в АИС ОПОД в соответствии с графиком, утверждаемым заместителем Мэра Москвы в Правительстве Москвы — руководителем Аппарата Мэра и Правительства Москвы;
обновление открытых данных — актуализация открытых данных (добавление, изменение и удаление набора открытых данных) поставщиком открытых данных с периодичностью не реже установленной в графике, утверждаемом заместителем Мэра Москвы в Правительстве Москвы — руководителем Аппарата Мэра и Правительства Москвы (далее — график), а также при выявлении неактуальности открытых данных, установленной при обработке информационных сообщений пользователей;
отзыв — это прекращение доступа к открытым данным посредством информационного портала в случае обнаружения ошибок оператором в опубликованном наборе открытых данных, файле набора данных или паспорте набора открытых данных;
открытые данные (наборы открытых данных) — информация, содержащаяся в информационных системах органов исполнительной власти города Москвы, подведомственных им организаций, а также предоставляемая юридическими и физическими лицами, которая подлежит размещению в информационно-телекоммуникационной сети общего пользования "Интернет" в соответствии с законодательством Российской Федерации, законами и иными нормативными правовыми актами города Москвы, а также на основании договоров, может свободно использоваться любыми лицами с соблюдением порядка, установленного настоящим Положением, в том числе с помощью приложений, использующих открытые данные;
паспорт набора открытых данных — формализованное описание набора открытых данных;
пользователи — органы государственной и муниципальной власти, юридические и физические лица, получающие доступ к открытым данным с использованием АИС ОПОД, в том числе разработчики приложений, использующих открытые данные;
поставщики открытых данных — органы государственной власти города Москвы и подведомственные им организации;
приложения — программы, предназначенные для обработки и использования информации, решения отдельных задач или класса задач, использующих открытые данные.

2. Участники процесса взаимодействия в АИС ОПОД

2.1. Участниками процесса взаимодействия в АИС ОПОД являются оператор, пользователь, поставщик открытых данных.
2.2. Уполномоченный сотрудник оператора по перечню, предоставленному поставщиком открытых данных, оформляет заявку для регистрации уполномоченных сотрудников в информационной системе, обеспечивающей управление доступом к информационным ресурсам.
2.3. Ответственность за предоставление паспорта и наборов открытых данных несет поставщик (ОИВ). Контроль за публикацией предоставленного набора открытых данных осуществляет оператор.

3. Требования к форматам открытых данных

3.1. Открытые данные должны быть представлены в форме одной плоской денормализованной таблицы, в которой не используются ссылки на данные других таблиц и массивов. Элементы данных в такой денормализованной таблице могут многократно дублироваться.
3.2. В целях обеспечения человекочитаемого представления данных и снижения вероятности ошибок наборы открытых данных должны предоставляться в полном объеме. Все используемые в данных коды справочников и классификаторов должны быть расшифрованы и представлены в отдельных графах.
3.3. Если данные содержат географическую привязку, то для всех объектов в наборе открытых данных она должна быть обязательно указана. В паспорте такого набора открытых данных должен быть заполнен признак наличия географической привязки. Данные, содержащие координаты объекта, должны быть отражены в формате WGS84 — трехмерной системы координат для географического позиционирования.
3.4. Данные, содержащие дату, должны быть приведены в формате ДД.ММ.ГГГГ.
3.5. Для каждого набора открытых данных должен передаваться паспорт. Данные паспорта должны передаваться в формате XML. Описание формата открытых данных приведено в приложении 1 к настоящим Требованиям. Пример паспорта в формате XML приведен в приложении 2 (не приводится) к настоящим Требованиям.
3.6. Наборы открытых данных должны передаваться в формате XML или CSV. Тип данных представлен в приложении 3 к настоящим Требованиям, код типа набора открытых данных — в приложении 4 к настоящим Требованиям. Описание формата XML приведено в приложении 5 к настоящим Требованиям. Другие форматы данных, в том числе ненормализированные и нетипизированные, не предусматриваются.
3.7. В файлах должна использоваться кодировка UTF-8.
3.8. Все передаваемые и получаемые файлы с наборами открытых данных кодируются в формате BASE64. Паспорта и протоколы загрузки данных не кодируются.
3.9. Пакеты для передачи через РСМЭВ должны быть не более 5 Мб и должны передаваться не чаще, чем 1 раз в 5 минут.
3.10. XML-документ должен содержать только один корневой элемент.
3.11. В формате CSV:
— в файле в первой строке должны быть указаны имена полей таблицы;
— нельзя использовать символы перевода строки, не должно быть полностью повторяющихся строк и не допускается наличие пустых строк;
— в качестве разделителя должен использоваться символ "точка с запятой". Значения, содержащие зарезервированный символ "точка с запятой", обрамляются двойными кавычками ("); а если в значении встречаются кавычки — они должны быть представлены в файле в виде двух кавычек подряд;
— в файлах, содержащих одинаковые открытые данные, заданный порядок полей может не совпадать, но в пределах одного файла порядок полей должен быть одинаковым, и каждое поле в заголовке должно присутствовать не более одного раза.
3.12. Поставщик при передаче паспорта и набора данных для открытия обеспечивает преобразование формата .xls (соответствующего структурированного файла) в формат csv.

4. Порядок взаимодействия ИС ОИВ с АИС ОПОД

4.1. Органы исполнительной власти города Москвы и подведомственные им организации предоставляют наборы данных для открытия (обеспечивают доступ оператора к наборам данных для открытия) в соответствии с графиком.
4.2. Подключение информационных систем к АИС ОПОД и предоставление наборов данных для открытия осуществляется с помощью РСМЭВ или другими методами, согласованными с оператором.
4.3. Версии (релизы) наборов открытых данных хранятся в АИС ОПОД в случае наличия технической возможности у оператора.
4.4. Для каждого размещаемого (обновляемого) набора данных поставщик набора данных с использованием программно-технических средств АИС ОПОД заполняет паспорт набора данных.
4.5. Паспорта наборов открытых данных ведутся в реестре открытых данных АИС ОПОД.
4.6. Отзыв открытых данных (прекращение доступа к набору данных посредством Информационного портала) и повторная публикация отозванных открытых данных при устранении некорректности в опубликованном наборе данных, файле набора данных или в его паспорте осуществляется в течение 3 рабочих дней после получения соответствующей информации от уполномоченного сотрудника поставщика открытых данных оператором.

Штатная схема взаимодействия (автоматический режим)

4.7. Взаимодействие ИС ОИВ с АИС ОПОД осуществляется с помощью web-сервиса или посредством подсистемы нормативно-справочной информации Базового регистра с использованием протоколов взаимодействия, определяемых оператором (см., например, приложения 6 (не приводится) и 8 к настоящим Требованиям).
В случае прямого взаимодействия общегородской платформы открытых данных с ИС ОИВ должны использоваться следующие методы:
— putDataset — добавление набора открытых данных;
— PutPassport — добавление паспорта набора открытых данных;
— getDataset — получение файла набора открытых данных;
— getPassport — получение паспорта набора открытых данных;
— getList — получение списка наборов открытых данных, загруженных органами исполнительной власти города Москвы и подведомственными им организациями;
— revokeDataset — отзыв набора открытых данных;
— updateDataset — обновление набора открытых данных.
Описание методов и примеры их использования приведены в приложении 9 к настоящим Требованиям.
Каждый из методов возвращает результат в виде структуры UnifiedServiceResponse, которая имеет следующую структуру:
— Integer code — код выполнения операции (0 — успешно; остальные коды указывают типы ошибок для каждого из методов, описание кодов выполнения операций приведено в приложении 10 к настоящим Требованиям);
— String message — дополнительная информация о причинах ошибки;
— String body — строка, содержащая соответствующий методу результат.
Для размещения новых данных для публикации должен использоваться метод putDataset.
При наличии изменений данных для предыдущей версии набора открытых данных должен использоваться метод updateDataset. Изменение структуры набора открытых данных не предусматривается.
Если принято решение о снятии набора с публикации, то должен использоваться метод revokeDataset для отзыва набора открытых данных. При вызове метода необходимо указать причину отзыва.
Для получения списка наборов открытых данных, загруженных за период времени, должен использоваться метод getList.
Для загрузки паспорта конкретного набора открытых данных должен использоваться метод getPassport.
Для получения загруженного конкретного набора открытых данных должен использоваться метод getDataset.
4.8. При использовании методов, размещающих наборы открытых данных, в ответ выдается протокол загрузки.
Если в протоколе загрузки присутствуют ошибки, данные должны быть откорректированы, и нужно вызвать метод повторно.
Проверка корректности должна быть реализована на стороне ИС ОИВ. Если в протоколе загрузки отсутствуют ошибки, то можно загружать следующий набор открытых данных.
4.9. При возникновении проблем с использованием сервиса необходимо обратиться к лицу, ответственному за работу сервиса со стороны оператора.

Временная схема взаимодействия в АИС ОПОД (ручной режим)

4.10. Решение о применении временной схемы взаимодействия в АИС ОПОД между поставщиком открытых данных и оператором принимается заместителем Мэра Москвы — руководителем Аппарата Мэра и Правительства Москвы.
4.11. При предоставлении наборов данных для открытия в ручном режиме уполномоченный сотрудник поставщика открытых данных:
Обеспечивает подготовку набора данных и перевод в csv-формат.
Загружает подготовленный для загрузки набор данных.
Производит форматно-логический контроль заполнения обязательных полей паспорта набора данных, протокола загрузки набора данных с использованием программно-технических средств АИС ОПОД.
Осуществляет подписание набора данных с использованием электронной подписи, выданной в установленном порядке.
4.12. В случае некорректной загрузки набора данных — устраняет причины, вызвавшие неуспешную загрузку, и выполняет повторную загрузку набора данных.
4.13. Проверяет валидность, целостность и соответствие загруженного в АИС ОПОД машиночитаемого и человекочитаемого вида открытых данных.

Приложение 1 к Требованиям к взаимодействию информационных систем органов исполнительной власти города Москвы с платформой "Открытые данные" с помощью web-сервиса

СТРУКТУРА ПАСПОРТА НАБОРА ОТКРЫТЫХ ДАННЫХ

Типы элементов:
— E — составной;
— S — строка;
— N — число;
— B — логический;
— D — дата;
— DT — дата/время.

Название элемента
Родительский элемент
Атрибут
Обязательность
Кратность
Тип элемента
Комментарии
Уникальность
Примечание
PassportOpenData
Нет
Да
1
E
Корень
Owner
PassportOpenData
Нет
Да
1
E
Владелец данных
Key
Owner
Нет
Да
1
S
Код владельца
Код ОИВ по классификатору "Органы исполнительной власти города Москвы" в Автоматизированной системе "Единая система ведения и управления реестрами, регистрами, справочниками и классификаторами" (АС УР)
lnformationSystem
PassportOpenData
Нет
Да
1
S
Информационная система, в которой подготовлены данные
Мнемоника ИС согласно РСМЭВ
OuterID
PassportOpenData
Нет
Да
1
S
Внешний идентификатор набора открытых данных
Имеет стандартный формат GUID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx, где x — любой символ из набора 0123456789ABCDEF (http://ru.wikipedia.org/wiki/GUID). Уникальное значение формирует ИС ОИВ
Version
PassportOpenData
Нет
Да
1
N
Версия набора открытых данных
Уникальное значение формирует ИС ОИВ. Версии нумеруются целыми числами начиная с 1
Name
PassportOpenData
Нет
Да
1
S
Название набора открытых данных
GeoFlag
PassportOpenData
Нет
Да
1
B
Признак наличия географической привязки данных
OpenDataType
PassportOpenData
Нет
Да
1
E
Тип набора открытых данных
Key
OpenDataType
Да
Да
1
S
Код типа набора открытых данных
Код типа набора согласно приложению 4
Description
PassportOpenData
Нет
Да
1
S
Описание набора открытых данных
BeginReportDate
PassportOpenData
Нет
Да
1
D
Начало отчетного периода опубликованного набора открытых данных
Дата в формате ДД.ММ.ГГГГ
EndReportDate
PassportOpenData
Нет
Да
1
D
Конец отчетного периода опубликованного набора открытых данных
Дата в формате ДД.ММ.ГГГГ
Tags
PassportOpenData
Нет
Нет
1
E
Ключевые слова (теги)
Tag
Tags
Нет
Да
N
E
Ключевое слово (тег)
Да
Files
PassportOpenData
Нет
Да
1
E
Файлы с наборами открытых данных
File
Files
Нет
Да
1
E
Файл с набором открытых данных
Name
File
Нет
Да
1
S
Название файла
FormatData
File
Нет
Да
1
E
Формат файла
Name
FormatData
Да
Да
1
S
Название формата
XML, CSV
Tables
File
Нет
Нет
1
E
Структура файла с набором открытых данных
Table
Tables
Нет
Да
1
E
Таблица данных
Name
Table
Да
Да
1
S
Название таблицы
Columns
Table
Нет
Да
1
E
Графы таблицы
Column
Columns
Нет
Да
N
E
Графа таблицы
Order
Column
Да
Да
1
N
Порядковый номер графы в таблице
Да
Type
Column
Да
Да
1
E
Тип данных в графе
Key
Type
Да
Да
1
S
Код типа данных в графе
Код типа согласно приложению 3
Unique
Column
Да
Да
1
B
Признак уникальности значения в графе
Required
Column
Да
Да
1
B
Признак обязательности заполнения значения в графе
Length
Column
Да
Нет
1
N
Максимальная длина значения в графе
Decimals
Column
Да
Нет
1
N
Количество знаков после запятой для числовых значений в графе
Title
Column
Нет
Да
1
S
Наименование графы
Краткое наименование графы при отображении таблицы
Description
Column
Нет
Да
1
S
Описание графы
Полное описание информации, представленной в графе таблицы

Приложение 3 к Требованиям к взаимодействию информационных систем органов исполнительной власти города Москвы с платформой "Открытые данные" с помощью web-сервиса

ТИПЫ ДАННЫХ

N
Код
Наименование
Описание
1
string
Строка
2
integer
Целое число
Целое 8-байтовое число со знаком
3
decimal
Десятичная дробь
4
boolean
Логический
Принимает значения true/false
5
date
Дата
Дата в формате DD-MM-YYYY
6
datetime
Дата и время
Дата и время по Москве без указания часового пояса в формате DD-MM-YYYY HH:MM:SS.mmm
7
timespan
Отрезок времени
HH:MM:SS.mmm
8
float
Плавающая дробь
9
guid
GUID
Имеет стандартный формат GUID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx, где x — любой символ из набора 0123456789ABCDEF (http://ru.wikipedia.org/wiki/GUID)
10
uint
Беззнаковое целое
Целое 8-байтовое число без знака
11
layerid
Идентификатор слоя
Идентификатор слоя Единого геоинформационного пространства города Москвы для отображения на карте
12
objectid
Идентификатор объекта
Идентификатор объекта Единого геоинформационного пространства города Москвы для отображения на карте
13
point
Координата объекта
Координаты в системе WGS84 http://ru.wikipedia.org/wiki/WGS_84
14
objectname
Имя объекта
Имя объекта Единого геоинформационного пространства города Москвы для отображения на карте

Приложение 4 к Требованиям к взаимодействию информационных систем органов исполнительной власти города Москвы с платформой "Открытые данные" с помощью web-сервиса

КОД ТИПА НАБОРА ОТКРЫТЫХ ДАННЫХ

N
Код
Наименование
1
00000
Все данные. Значение по умолчанию
2
00001
Данные по земельным участкам в городской собственности, которые сдаются в аренду
3
00002
Данные по земельным участкам, переданным в собственность, с указанием типа собственника
4
00003
Данные по проведенным торгам
5
00004
Данные по планируемым торгам
6
00005
Рейтинг-топ 100 должников арендной платы
7
00006
Данные по доходам и расходам Департамента земельных ресурсов
8
00007
Маршруты и расписание наземного городского пассажирского транспорта
9
00008
Качество и состояние подвижного состава
10
00009
Объем пассажирских перевозок по маршрутам
11
00010
Сводки о задержках наземного городского пассажирского транспорта
12
00011
Информация по движению транспортных средств наземного городского пассажирского транспорта (задержки, причины, меры)
13
00012
Результаты работы контролеров
14
00013
Остановки наземного городского пассажирского транспорта
15
00014
Павильоны ожидания на остановках наземного городского пассажирского транспорта
16
00015
Точки продажи билетов для проезда в наземном городском пассажирском транспорте
17
00016
Результаты контроля работы водителей наземного городского пассажирского транспорта
18
00017
Имущество, находящееся на складе забытых вещей
19
00018
Несчастные случаи: падение в наземном городском пассажирском транспорте
20
00019
Изъятые социальные карты москвича
21
00020
Заявки на выдачу разрешений для въезда, движения, размещения, межрейсовой и технологической стоянки транспортных средств на транспортно-пересадочном узле
22
00021
Выданные пропуска на въезд, движение, размещение, межрейсовую и технологическую стоянку транспортных средств на транспортно-пересадочном узле
23
00022
Нарушение правил проезда в наземном городском пассажирском транспорте
24
00023
Нарушение перевозчиками условий эксплуатации маршрута
25
00024
Движение дел об административных правонарушениях
26
00025
Заявки на проезд грузового автотранспорта в зонах ограниченного движения (срочные, разовые)
27
00026
Суммарные данные мониторинга интенсивности и скорости транспортного потока (с датчиков)
28
00027
Нарушения правил дорожного движения, выявляемые с использованием автоматической системы видеофиксации
29
00028
Данные системы ГЛОНАСС о движении ЕС (900 маршруты)
30
00029
Реестр стационарных объектов наблюдения (датчики, камеры)
31
00030
Маршруты мобильных комплексов фиксации нарушений
32
00031
Проекты изменений порядка организации движения
33
00032
Нарушения порядка организации движения (строительные, ремонтные работы, парковка)
34
00033
Качество и состояние подвижного состава
35
00034
Станции метрополитена
36
00035
Организации, осуществляющие коммерческую деятельность на территории метрополитена
37
00036
Согласованные маршруты пассажирских перевозок коммерческими перевозчиками
38
00037
Межрегиональные и международные маршруты пассажирских перевозок
39
00038
Обращения граждан
40
00039
Тарифы на проезд в городском подземном транспорте
41
00040
Строительство новых объектов дорожно-транспортной инфраструктуры
42
00041
Мониторинг строительных объектов (ситуация в части реконструкции)
43
00042
Проданные билеты на пригородные поезда

Приложение 5 к Требованиям к взаимодействию информационных систем органов исполнительной власти города Москвы с платформой "Открытые данные" с помощью web-сервиса

СТРУКТУРА НАБОРА ОТКРЫТЫХ ДАННЫХ

Элемент
Родительский элемент
Атрибут
Обязательность
Кратность
Комментарии
OpenData
Нет
Да
1
Корень
FileName
OpenData
Да
Да
1
Имя файла
Tables
OpenData
Нет
Да
1
Таблицы
Table
Tables
Нет
Да
1
Таблица данных
Name
Table
Да
Да
1
Название таблицы
Data
Table
Нет
Да
1
Данные таблицы
Row
Data
Нет
Да
N
Строка данных
El
Row
Нет
Да
N
Значение ячейки
Status
Row
Да
Нет
1
Статус строки. Используется только при дифференциальном обновлении. Возможны статусы:
— I — вставка новой строки;
— U — обновление существующей;
— D — удаление существующей.
При вставке и обновлении обязательно передаются все элементы El строки Row, при удалении строк можно не заполнять содержимое элементов, однако их количество должно соответствовать количеству граф таблицы, указанному в паспорте
ID
Row
Нет
Да
1
Идентификатор строки. Имеет стандартный формат GUID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx, где x — любой символ из набора 0123456789ABCDEF (http://ru.wikipedia.org/wiki/GUID). Уникальное значение формирует ИС ОИВ

Приложение 7 к Требованиям к взаимодействию информационных систем органов исполнительной власти города Москвы с платформой "Открытые данные" с помощью web-сервиса

ФОРМАТ ПРОТОКОЛА ЗАГРУЗКИ

Элемент
Родительский элемент
Атрибут
Обязательность
Кратность
Тип
Комментарии
Protocol
Нет
Да
1
E
Корень
OuterID
Protocol
Нет
Да
1
S
Идентификатор паспорта данных
Status
Protocol
Нет
Да
1
N
Статус набора открытых данных. Возможные значения:
0 — загружен без ошибок;
1 — некритические ошибки в паспорте;
2 — критические ошибки в паспорте;
3 — ошибки в наборе открытых данных
Version
Protocol
Нет
Да
1
N
Номер версии набора
Passport
Protocol
Нет
Да
1
E
Список ошибок в паспорте набора открытых данных
Errors
Passport
Нет
Да
1
E
Ошибки
Error
Errors
Нет
Да
N
E
Ошибка
Text
Error
Нет
Да
1
S
Текстовое описание ошибки
FieldName
Error
Нет
Да
1
S
Поле паспорта, в котором зафиксирована ошибка
Value
Error
Нет
Да
1
S
Значение поля
Status
Error
Нет
Да
1
N
Статус ошибки:
1 — не заполнено обязательное поле;
2 — элемент отсутствует в справочнике;
3 — некорректный формат значения элемента/атрибута;
4 — неверное количество элементов одного типа
Data
Protocol
Нет
Да
1
E
Список ошибок в наборе открытых данных
Errors
Data
Нет
Да
1
E
Ошибки
Error
Errors
Нет
Да
N
E
Ошибка
Text
Error
Нет
Да
1
S
Текстовое описание ошибки
Value
Error
Нет
Нет
1
S
Значение элемента в наборе открытых данных
Status
Error
Нет
Да
1
N
Статус ошибки:
1 — не заполнено обязательное поле;
2 — превышена длина значения;
3 — некорректный формат значения элемента;
4 — неверное количество элементов в строке
ColumnKey
Error
Нет
Нет
1
S
Значение атрибута Key графы
RowID
Error
Нет
Нет
1
S
Значение атрибута ID строки
TableName
Error
Нет
Да
1
S
Значение атрибута Name таблицы
FileName
Error
Нет
Да
1
S
Значение атрибута Name файла

Приложение 8 к Требованиям к взаимодействию информационных систем органов исполнительной власти города Москвы с платформой "Открытые данные" с помощью web-сервиса

ФОРМАТ ПАКЕТА DATALIST

Название элемента
Родительский элемент
Атрибут
Обязательность
Кратность
Тип
Комментарии
Passports
Нет
Да
1
E
Корень
PassportOpenData
Passports
Нет
Да
N
E
Структура элемента полностью соответствует структуре паспорта данных

Приложение 9 к Требованиям к взаимодействию информационных систем органов исполнительной власти города Москвы с платформой "Открытые данные" с помощью web-сервиса

МЕТОДЫ ВЗАИМОДЕЙСТВИЯ ИС ОИВ С ПЛАТФОРМОЙ "ОТКРЫТЫЕ ДАННЫЕ"

N
Метод
Назначение
Аргументы
Примечание
Пример
1
putDataset (String passport, String dataFile)
Добавление набора открытых данных
— passport — файл с паспортом набора открытых данных;
— dataFile — файл с набором открытых данных
Метод возвращает XML-файл протокола загрузки. Формат протокола загрузки приведен в приложении 7
Passport passport = createPassport();
String data = readFile('c:/file.xml');
String dataFile = EncodeBase64(data);
UnifiedServiceResponse result = putDataset(passport, dataFile);
If(result.code ! = 0) {
Protocol proto = ReadFromXMLString(result.body);
} else {
// Данные загружены
}
2
getDataset (String outerID)
Получение файла набора открытых данных
— outerID — идентификатор набора открытых данных, присвоенный ОИВ
Метод возвращает файл набора открытых данных
UnifiedServiceResponse result = getDataset('3F2504E0-4F89-11D3-9A7C-0305E82C3301');
If(result.code == 0) {
SaveFile(result.body,
'c:/data.xml');
} else {
// Данные не найдены
}
3
getPassport (String outerID)
Получение паспорта набора открытых данных
— outerID — идентификатор набора открытых данных, присвоенный ОИВ
Метод возвращает XML-файл паспорта набора открытых данных в соответствии со структурой, приведенной в приложении 1
UnifiedServiceResponse result = getPassport('3F2504Е0-4F89-11D3-9A7C-0305E82C3301');
If(result.code == 0) {
SaveFile(result.body,
'c:/passport.xml');
} else {
// Данные не найдены
}
4
getList (DateTime start, DateTime end, String dataTypeKey)
Получение списка наборов открытых данных, загруженных ОИВ, с возможностью фильтрации по датам загрузки данных и по типам наборов открытых данных
— DateTime start — дата начала периода загрузки;
— DateTime end — дата окончания периода загрузки;
— dataTypeKey — тип набора открытых данных в соответствии с приложением 4. Любой из аргументов метода может быть не задан
Метод возвращает XML-пакет в соответствии со структурой, приведенной в приложении 5
UnifiedServiceResponse result = getList(null, null, '00021');
If(result.code == 0) {
List<Passport> list = ReadListFromXML(result.body);
Foreach(Passport p in list) {
SaveFile(p.toString(),
'c:/'+p.Name+'.xml');
}
} else {
// Данные не найдены
}
5
revokeDataset (String outerID, String comment)
Отзыв набора открытых данных
— outerID — идентификатор набора открытых данных, присвоенный ОИВ;
— comment — текст, содержащий причину отзыва набора открытых данных
Отзыв осуществляется согласно значению идентификатора размещенного ранее набора открытых данных. Метод не возвращает строку с результатом
UnifiedServiceResponse result = revokeDataset('3F2504Е0-4F89-11D3-9A7C-0305E82C3301');
If(result.code == 0) {
// Набор отозван
} else {
// Данные не найдены
}
6
updateDataset (String passport, String dataFile, Integer version)
Обновление набора открытых данных
— passport — файл с паспортом;
— dataFile — файл с набором открытых данных;
— version — номер предыдущей версии
Обновляется набор открытых данных, идентифицируемый по OuterID, переданному в паспорте. Метод возвращает XML-файл протокола загрузки.
Передаваемый dataFile содержит только строки, изменившиеся с предыдущей версии. Дифференциальное обновление данных регулируется полями PassportOpenData->Version и OpenData->Tables->Table->Data->Row@Status, см. приложение 5
Passport passport = createPassport();
String data = readFile('c:/file.xml');
String dataFile = EncodeBase64(data);
UnifiedServiceResponse result = updateDataset(passport, dataFile, 2);
If(result.code ! = 0) {
Protocol proto = ReadFromXMLString(result.body);
} else {
// Данные загружены
}

Приложение 10 к Требованиям к взаимодействию информационных систем органов исполнительной власти города Москвы с платформой "Открытые данные" с помощью web-сервиса

КОДЫ ВЫПОЛНЕНИЯ ОПЕРАЦИЙ

N
Метод
Код
Описание кода
Условия возникновения
1
putDataset/
getDataset/
getPassport/
getList/
revokeDataset/
updateDataset
0
Успешно
Метод выполнен успешно
2
1
Не задан обязательный аргумент
При вызове метода не был задан обязательный аргумент
3
2
Набор не найден
Набор открытых данных не найден или не принадлежит данному ОИВ
4
3
Неверный формат аргументов
При вызове метода неверно заданы форматы аргументов
5
putDataset/
updateDataset
4
Ошибка в паспорте
Файл с данными паспорта содержит ошибки
6
putDataset
5
Набор с таким идентификатором уже существует
Такой набор открытых данных уже размещен
7
getList
6
dataTypeKey отсутствует в справочнике или не принадлежит данному ОИВ
Указан неверный код типа набора открытых данных
8
putDataset/
updateDataset
7
Ошибки в наборе открытых данных
Файл с набором открытых данных содержит ошибки
9
updateDataset
8
Некорректная версия набора
Указанная версия набора открытых данных не найдена

Добавить комментарий