Описание структуры XML файла для загрузки данных о музейных предметах из АМС в Госкаталог
Пространства имен:
soap - http://schemas.xmlsoap.org/soap/envelope/
mf - http://goskatalog.ru/v3.0/
mfe - http://goskatalog.ru/external/v3.0/
wsa - http://www.w3.org/2005/08/addressing
|
Описание
|
Тип и длина поля
|
Примечание
|
|
|
Registration
|
Correction
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Уникальный идентификатор сообщения (GUID).Для каждого сообщения формируется свой номер.
|
String
|
1
|
1
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Версия конверта (указать ext.3.0)
|
String
|
1
|
1
|
Указывается “ext.3.0”
|
|
Тип действия, которое должно быть произведено над записью. Возможные варианты:
1. Registration - (Регистрация предметов)
2. Correction – (Техническая коррекция)
|
String
|
1
|
1
|
В XML файле содержится текст, описывающий характер действия в латинской транскрипции
|
|
Идентификатор АМС. Может принимать значения:
КАМИС- 1234
АС Музей-3 – 4321
АС-Музей-4 - 4321
АИС Музея Суворова - 1904
«МИС Третьяковская галерея" - 1856
Эйдотека РОСФОТО – 4242
Ника – 1111
ПО HiDA4 - 9999
|
Integer
|
1
|
1
|
|
|
Дата и время подготовки сообщения.
|
xsd:dateTime
|
1
|
1
|
Пример 2002-05-30T09:30:10+06:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Указание на операцию Put.
Не заполняется.
|
|
|
|
|
< mfe:Data>
|
|
|
|
|
|
|
Название предмета
|
String
|
1
|
1
|
|
|
Краткое описание предмета
|
String
|
0
|
0
|
|
|
Предметное имя (ключевое слово)
|
String
|
0
|
0
|
|
|
Номер по книге поступлений.
|
String
|
1
|
1
|
Например: предмет НГМ КП 1234/45
Логика валидации и допустимые символы номера КП описана ниже.
|
|
дата записи о предмете в книге поступлений основного фонда (главной инвентарной книге) музея.
|
xsd:dateTime
|
1
|
1
|
Если книга поступлений старая, и дата утрачена или не указана – указывается дата заполнения книги.
Пример 2002-05-30T09:30:10+06:00.
Если время записи не известно, то передается дата в формате 2002-05-30T00:00:00+00:00
|
|
Инвентарный номер.
|
String
|
0
|
0
|
|
|
Идентификатор записи о предмете в АМС
|
String
|
1
|
0
|
|
|
Место создания
|
String
|
0
|
0
|
|
|
Время создания – текст
|
String
|
1
|
1
|
|
|
Время создания – начало периода в годах.
Может содержать отрицательное значение.
|
Integer
|
0
|
0
|
|
|
Время создания – конец периода в годах.
Может содержать отрицательное значение.
|
Integer
|
0
|
0
|
|
|
Автор (мастер).
Разделитель – точка с запятой или запятая
|
String
|
0
|
0
|
|
|
Место обнаружения для археологических и этнографических материалов
|
String
|
0
|
0
|
|
|
Организация-изготовитель
Разделитель – точка с запятой или запятая
|
String
|
0
|
0
|
|
|
Материалы, техники.
Разделитель – точка с запятой или запятая
|
String
|
0
|
0
|
|
|
Масса
|
String
|
0
|
0
|
Масса вместе с единицей измерения.
|
|
краткое описание истории бытования (провенанс) предмета
|
String
|
0
|
0
|
|
|
номер предмета в Книге специального учета основного фонда музея (для предметов из драгоценных металлов и драгоценных камней)
|
String
|
0
|
0
|
Если заполнен, то требуется указание Массы
|
|
Размеры
|
String
|
1
|
1
|
|
|
Способ поступления
Принимаются только значения:
1. Дар
2. Пожертвование
3. Безвозмездная передача
4. Закупка
|
Integer
|
1
|
1
|
|
|
Источник поступления
|
String
|
1
|
1
|
|
|
№ акта и дата приема на постоянное хранение
|
String
|
0
|
0
|
|
|
Номер и дата протокола ЭФЗК, обязательные для заполнения у предметов вкл в МФ по приказам в 1996-2016 году.
|
String
|
0
|
0
|
|
|
Количество предметов в записи КП. Заполняется количеством предметов, указанным в АМС
|
Integer
|
1
|
1
|
|
|
Типология по 8-НК
1- живопись
2 - графика
3-скульптура
13-предметы прикладного искусства, быта и этнографии
5-предметы нумизматики
6-предметы археологии
14- редкие книги
8-оружие
15- документы
17-Фотографии, негативы
10-предметы естественнонаучной коллекции
18-Предметы минералогической коллекции 11-предметы техники
16- предметы печатной продукции
12-прочие
|
Integer
|
1
|
1
|
|
|
Номер Госкаталога
|
String
|
-
|
1
|
|
<mfe:OwnershipType>OwnershipType>
|
Форма собственности
1- Федеральная собственность
2- Собственность субъектов РФ
3- Муниципальная собственность
4- Частная собственность.
|
Integer
|
1
|
1
|
|
|
Ограничение на публикацию на Портале.
1 – не публиковать
0 - публиковать
|
Integer
|
0
|
0
|
Если не указан считается 0
|
|
Дата приказа на вкл в МФ
|
xsd:date
|
0
|
0
|
Только для предметов включенных в МФ по приказу
|
|
Номер приказа на вкл в МФ
|
String
|
0
|
0
|
|
категория ценности музейного предмета (1,2, 3)
|
Integer
|
1
|
1
|
|
|
|
|
|
|
|
|
|
Множественный, можно передать массив Image, каждая картинка не более 10 Мб
|
|
Изображение1
|
|
1
|
1
|
|
|
Название файла изображения
|
String
|
1
|
1
|
Image/FileName – ASCII символы
|
|
Пометка главного изображения. Может принимать значения:
- 1 – изображение главное
- 0 – не главное
|
Integer
|
0
|
0
|
Image/Main. Для главного изображения тег обязательный, для остальных может не передаваться.
Если картинка (с точностью до байта) уже есть у предмета, то она не загрузится.
|
|
Описание изображения
|
String
|
0
|
0
|
Image/Description
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Обязательность полей для типов сообщений:
“1” – обязательное, при отсутствии этого поля система вернет ошибку.
“0” – опциональное, при наличии поля данные запишутся в систему. Для корректировки - если опциональный признак указан у предмета и пришло сообщение без этого признака – система обнулит этот признак.
“-“ – не поддерживается данным типом сообщения
Валидация номера КП (ГИК) передаваемых объектов:
Проверяется на допустимые символы: 0-9, буквы русского алфавита, символы «-», «–», «—», «пробел», «№», «/», «\». Cимволы «№», «/», «\» могут встречаться только один раз. При наличии посторонних символов – ошибка недопустимых символов.
В карточке музея, указываются все возможные шифры музея за его историю (при слиянии музеев могут быть книги с разными шифрами), в пришедшем номере КП проверяется наличие этого шифра в начале номера. Если его нет – ошибка: шифр не передан или не указан на карточке музея. Для музеев, в которых старые инвентарные книги признаны книгами поступлений в шифре записывается вся дономерная часть, например для предмета «ГЭ КП Ж-1234» в шифрах музея надо указать «ГЭ КП Ж»
Далее из номера КП убирается шифр, оставшийся набор символов очищается от пробелов. В нем ищется первая цифра и от нее до конца строки - считаем числовой частью номера предмета.
В этой числовой части номера ищем разделитель «/» или «\», если есть – то разбиваем номер на две части и приводим к числу каждую половину, если не смогли привести к числу – даем ошибку: «в числовой части номера «123/12а» содержатся буквы.
Если в номере нет разделителя, он целиком приводится к числу, если не смогли привести к числу – даем ошибку: «в числовой части номера «12345а» содержатся буквы.
Проверка возможности регистрации передаваемых объектов:
Пришедший номер ГИК(КП) проверяется на соответствие выше описанным правилам.
Далее происходит поиск по музею по совпадению шифр + числовая часть номера КП в зарегистрированных, отправленных на исключение, исключенных, мигрированных из ГК 1.0 предметах. Если нашли – отказ в регистрации. Если не найдено - проверяем в отклоненных. Если есть в отклоненных – обновляем атрибуты и присваиваем номер ГК, если нет - позволяем создать предмет и присваиваем ему номер ГК.
Проверка возможности корректировки:
Происходит поиск по музею + номер ГК переданного предмета, если не нашли, ошибка: «Переданный предмет с номером ГК «12345678» не найден».
Пришедший номер ГИК(КП) проверяется на соответствие выше описанным правилам.
Проверяется совпадение Quantity сохраненного в базе и пришедшего при корректировке, если не совпало – ошибка и корректировка отклоняется.
В случае, если сохранный в ГК номер КП не удовлетворяет правилам описанным выше, проверка на совпадение номера КП пропускается и найденный по номеру ГК предмет обновляется.
Если сохранный в ГК номер КП корректный - проверяем соответствие номера КП сохраненного и переданного. При совпадении – позволяем корректировку, если не совпадает – ошибка: «переданный номер КП не совпадает с сохраненным в Госкаталоге».
Формирование названий и описание размещения передаваемых объектов:
Для каждого музейного предмета формируется свой XML-файл, структура которого приведены выше.
Название XML файла должно соответствовать содержанию тега « » в XML файле (см. файл).
Все файлы с цифровыми фиксациями, которые прилагаются к XML файлу должны размещаться в одной папке для каждого XML файла соответственно. Название папки должно соответствовать содержанию тега « » в XML файле.
Названия файлов с цифровыми фиксациями должны соответствовать содержанию тега « » по каждому изображению соответственно.
Если тег заполнить нечем (и он является не обязательным), то тег в файл не включается.
XML файлы и соответствующие им папки с изображениями группируются по 100 или 1000 штук (в зависимости от настроек АМС). Каждая партия архивируется. Формат – zip-файл. Cтруктура имени zip файла: Кодировка, в которой формируется ZIP архив (без тире и пробелов)_КОПУК2_Дата формирования zip-файла_порядковый номер zip-файла в течение дня (utf8_132435_20110223_001.zip). Дата в формате: ууууmmdd. Формат порядкового номера zip-файла от 1 до NN, 3 разряда с предстоящими нулями (Пример: 001).
Кодировка xml файлов utf-8 или windows-1251. Указывается в заголовке xml.
Описание структуры XML файла для выгрузки данных о музейных предметах из АИС Госкаталог в АМС
Пространства имен:
soap - http://schemas.xmlsoap.org/soap/envelope/
mf - http://goskatalog.ru/v3.0/
mfe - http://goskatalog.ru/external/v3.0/
wsa - http://www.w3.org/2005/08/addressing
|
Описание
|
Тип и длина поля
|
Обязательность
|
Примечание
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Уникальный идентификатор сообщения (GUID).Для каждого сообщения формируется свой номер.
|
String
|
1
|
|
|
Уникальный идентификатор сообщения (GUID), в ответ на который формируется данное сообщение.
|
String
|
1
|
Обязательный для заполнения, кроме случая когда данный файл формируется для выгрузки в новую систему, установленную в музее после регистрации данных в ГК.
|
|
Версия конверта (указывается ext.3.0)
|
String
|
1
|
Указывается “ext.3.0”
|
< /mf:Action>
|
Тип действия, которое было произведено над записью. Возможные варианты:
1. Registration - (Регистрация)
2. Correction – (Техническая коррекция)
|
String
|
1
|
Action/Name
В XML файле содержится текст, описывающий характер действия в латинской транскрипции
|
< /mf:ErrorCode>
|
Код ошибки
|
String
|
1
|
|
< /mf:ErrorDescription>
|
Описание ошибки
|
String
|
1
|
|
|
Дата и время подготовки сообщения.
|
xsd:dateTime
|
1
|
Пример 2002-05-30T09:30:10+06:00
|
< /mf:UIM>
|
Номер в реестре музеев (Уникальный идентификатор музея)
|
String
|
0
|
|
|
|
|
|
|
|
|
|
|
|
|
Указание на операцию Put. Не заполняется.
|
|
|
|
< mfe:Data>
|
|
|
|
|
|
Идентификатор записи о предмете из АМС
|
String
|
1
|
|
|
Номер Госкаталога
|
String
|
1
|
Нет, в случае ошибки при регистрации
|
< /mfe:ActionDate>
|
Дата действия (внесение изменений в госкаталог).
|
xsd:dateTime
|
1
|
Пример 2002-05-30T09:30:10+06:00
|
< /mfe:KPNumber>
|
Номер предмета по ГИК(КП)
|
String
|
1
|
|
< /mfe:OrderDate>
|
Дата приказа на включение
|
xsd:date
|
0
|
Пример 2002-05-30+06:00
|
< /mfe:OrderNumber>
|
Номер приказа на включение
|
String
|
0
|
|
< /mfe:Data>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Название XML файла должно иметь структуру: Код музея_ID записи о музейном предмете в АМС_содержание тега из отправленного из муз системы сообщения».
Если тег заполнить нечем (и он является не обязательным), то тег в файл не включается
XML файлы группируются по 100 или 1000 штук. Каждая партия архивируется. Формат – zip-файл. Имена zip-файлов должны быть уникальными и соответствовать следующей структуре: UTF8_КОПУК3_Дата формирования zip-файла_порядковый номер zip-файла в течение дня (utf8_132435_20110223_001.zip). Дата в формате: ууууmmdd. Формат порядкового номера zip-файла от 1 до NN, 3 разряда с предстоящими нулями (Пример: 001).
Кодировка utf-8. Указывается в заголовке xml.
Возможные коды ошибок и описания:
-
Код ошибки
|
Описание ошибки
|
000
|
Успешно
|
001
|
Не указан идентификатор музейной системы
|
002
|
Не указан идентификатор предмета в музейной системе
|
003
|
Дубли по номер КП: (%номер)
|
004
|
Переданный номер ГК (%номер) не соответствует указанному музею
|
005
|
Отсутствует главная картинка
|
006
|
Предмет object_id (%номер) в статусе (%статус), операция "Регистрация" не допустима
|
007
|
Предмет не найден (номер ГК (%номер)), операция "Техническая коррекция" не допустима
|
008
|
Переданное количество предметов в записи КП (%номер) не соответствует присвоенному номеру ГК (%номер)
|
009
|
Переданный номер КП (%номер) не совпадает с сохраненным в Госкаталоге (%номер)
|
010
|
Наименование предмета не должно быть пустым
|
011
|
Не задана типология по форме 8НК
|
012
|
Типология по форме 8НК (%типология) отсутствует в справочнике
|
013
|
Передано количество предметов меньше нуля
|
014
|
Не корректное значение типа собственности
|
015
|
Не указан тип собственности предмета
|
016
|
Не корректное значение категории предметов
|
017
|
Ошибки про формату КП 'Не задан шифр музея КП (%номер)', 'Не верный шифр номера КП (%номер)', 'Числовая часть номера КП (%номер) (%числовая часть) не соответствует формату'
|
018
|
Способ поступления (%переданное значение) отсутствует в справочнике
|
019
|
MessageId в названии файла не совпадает с MessageId в описании предмета
|
300
|
Способ поступления отсутствует в справочнике
|
500
|
Общая ошибка несоответсвия XSD схеме
|
|
