Методические рекомендации к Порядку обмена информацией
между демонстратором фильма и оператором единой
федеральной автоматизированной системы сведений о показах
фильмов в кинозалах, включая формы ее запроса
и предоставления из этой единой системы
I. Общие положения
1. В Порядке обмена информацией между демонстратором фильма и оператором единой федеральной автоматизированной системы сведений о показах фильмов в кинозалах, включая формы ее запроса и предоставления из этой единой системы (далее – Порядок, ЕИС) используются следующие термины, определения и сокращения:
1) оператор ЕИС – лицо, осуществляющее деятельность по эксплуатации ЕИС, в том числе по обработке информации, поступающей в базы данных этой системы от демонстраторов фильма, а также разработку для этих целей программного обеспечения;
2) демонстратор фильмов – киновидеозрелищная организация, осуществляющая платный публичный показ фильмов в кинозалах;
3) киносеть – совокупность демонстраторов фильмов;
4) пользователи ЕИС – Министерство культуры Российской Федерации, а также органы государственной власти, наделенные полномочиями контроля и надзора за соблюдением законодательства Российской Федерации об авторских и смежных правах, аккредитованные организации по управлению правами на коллективной основе, лица, которым принадлежат исключительные права на конкретный фильм, а также обладатели исключительной лицензии на показ фильма на территории Российской Федерации;
5) первичные данные - данные о реализации кинобилетов, передаваемые демонстратором фильма в ЕИС;
6) ЦБД – центральная база данных;
7) СУБД – система управления базами данных;
8) хеш (хеш-сумма) – строка фиксированной длины, полученная путем преобразования входных данных произвольной длины. Используется для проверки целостности данных, их идентификации и поиска, а также заменяет собой данные, которые небезопасно хранить в явном виде;
9) XML-документ – текстовый файл, в котором при помощи специальных маркеров создаются элементы данных, последовательность и вложенность которых определяет структуру документа и его содержание, выполняющий роль универсального формата для обмена информацией между отдельными компонентами программы;
II. Рекомендации по обмену информацией между
демонстратором фильмов и оператором ЕИС
Рекомендации по созданию асинхронного алгоритма загрузки данных в ЕИС.
2. Пояснения по принципу работы сервера ЕИС.
2.1. Сервер работает в асинхронном режиме – это значит, что после загрузки на сервер файлы проходят первичную обработку (проверяется корректность имени файла, если это zip-архив, то он распаковывается) и помещаются в очередь на загрузку.
2.2. Если первичная обработка прошла успешно, то демонстратору фильмов отправляется ответ с протоколом первичной обработки.
Примеры ответов с протоколом первичной обработки:
- для одиночного xml-файла, или:
Ошибка в имени файла "ekb_000_20110123_ххххххххх.xml".]]>
- для пакета zip, который содержит несколько файлов.
2.3. Если в протоколе первичной обработки содержится запись типа:
- это не значит, что файл корректный и успешно загружен в базу, это означает, что он имеет корректное имя и успешно принят и поставлен в очередь на обработку.
2.4. На сервере работает модуль-загрузчик, который сканирует входящие папки всех демонстраторов фильмов и обрабатывает все файлы в этих папках по очереди. При обработке, по каждому файлу создается протокол обработки, который содержит все выявленные ошибки по обработанному файлу. Имя файла протокола обычно формируется так:
Пример. Если имя файла ekb_000_20110123_123456789.xml
то имя файла протокола будет: ekb_000_20110123_123456789(res).xml
2.5. Если в файле обнаружена хотя бы одна ошибка, файл не будет загружен полностью.
2.6. Протокол выкладывается в папку «исходящие» для направившей файл организации и доступен для скачивания командой «get».
2.7. Для того чтобы получить протокол обработки по загруженным файлам, необходимо сделать дополнительный запрос на сервер. Формат запроса аналогичен запросу, которым файлы загружаются на сервер: post-запрос по протоколу https со следующими параметрами:
1) login (строка, ИМЯ ПОЛЬЗОВАТЕЛЯ);
2) password (строка, ПАРОЛЬ);
3) get (list | all | ,,… ).
2.8. Параметр «get» может принимать следующие значения:
«get=list» - при этом сервер возвращает список протоколов обработки, которые находятся в папке «исходящие» для данного демонстратора фильмов, в формате XML;
«get=all» - при этом сервер ЕИС вернет zip-файл, в котором будут содержаться все протоколы обработки из папки «исходящие»;
«get=,,…» - при этом сервер ЕИС вернет zip-файл, в котором будут содержаться все протоколы обработки запрошенные командой «get».
2.9. После того как протокол запрошен командой «get» и отправлен клиенту, он будет перемещен в архив. Если клиент не запрашивает протокол более 5 суток с момента формирования, то он также будет перемещен в архив.
2.10. Рекомендуется пользоваться «групповыми» командами, это позволит минимизировать нагрузку на оборудование и линии связи.
2.11. Пример алгоритма работы программного комплекса демонстратора фильмов:
Автоматизированная билетная система демонстратора фильмов формирует XML-документы со сведениями о проданных билетах,
Сформированные XML-документы упаковываются zip-архиватором в один файл (правила наименования zip-архива описаны в Приказе №56 от 08 февраля 2011 года).
zip-архив отправляется на сервер АИС.
Пауза 5 мин (файлы обрабатываются в порядке очереди, нет смысла сразу после загрузки файлов на сервер начинать запрашивать протоколы).
Запрашивается список протоколов командой «get=list».
Проверяется, все ли отправленные файлы обработаны.
Если не все, повторяется «пауза» и запрашивается список снова.
Если все протоколы обработки присутствуют в полученном списке, делается запрос командой «get=all». При этом получаются в zip-архиве все протоколы обработки, которые есть на сервере АИС в папке «исходящие» для демонстратора фильмов.
Проводится анализ полученных наличие ошибок.
Если все файлы обработаны без ошибок, запускается все с начала, т.е. с пункта 1).
3. Справочник ошибок, которые могут быть возвращены сервером:
900 - На сервере произошла непредвиденная ошибка.
Повторите попытку позже.
101 - Запрошенный список файлов не найден на сервере.
102 - Нет файлов для загрузки.
10 - Не найден файл с данными!
11 - Ошибка при сохранении входящего файла "{Имя файла}". Сообщение: "{Сообщение}".
12 - Данный вид запроса может быть сделан только по протоколу HTTPS.
13 - Данная служба принимает только POST-запросы.
14 - Параметры "Имя пользователя" и "Пароль" должны быть указаны обязательно!
15 - Код в имени файла "{Имя файла}" не может принимать значение "{Код}" для пользователя "{Имя пользователя}".
16 - Плохой архив! Сообщение: {Сообщение}"
17 - Ошибка при распаковке файла {Имя файла}! Сообщение: {Сообщение}
2 - Ошибка в имени пользователя и/или пароле.
311 - Ошибки в структуре файла.
312 - Ошибка в билете (ряд:{0}; место:{1}). {Сообщение}
3131 - Ошибка! Должен быть указан обязательно атрибут "seans_title".
3132 - Ошибка! Должен быть указан обязательно либо атрибут "seans_title", либо "Название фильма" в элементе .
3133 - Ошибка в описании фильма (индекс:{индекс элемента }). Для сеансов, в которых демонстрируется более одного фильма, название фильма должно быть указано обязательно.
3134 - Сеанс зарегистрирован в системе для фильма "{Название фильма}"(ПУ:{номер ПУ}). Для изменения названия фильма необходимо аннулировать сеанс.
3135 - Сеанс зарегистрирован в системе для фильмов "{Список фильмов}". Для изменения списка фильмов необходимо аннулировать сеанс.
3141 - Код "org_id" внутри файла "{код организации внутри файла}" не соответствует коду в имени файла "{код организации в имени файла}".
3142 - Код "org_id" внутри файла не может принимать значение "{код организации внутри файла }" для пользователя "{Имя пользователя}"")]
315 - Для "org_id"={код организации} кинозал с именем "{Имя кинозала}" не зарегистрирован.
33 - Пакет "{Имя файла}" был загружен ранее и не может быть загружен повторно.
35 - Ошибка в имени файла "{Имя файла}".
III. Рекомендации по предоставлению информации,
содержащейся в ЕИС, пользователям
4. Оператор ЕИС осуществляет регистрацию пользователя посредством формирования регистрационной карты, содержащей следующие сведения:
1) для юридических лиц - название организации (пользователя), ее организационно-правовая форма, основной государственный регистрационный номер и идентификационный номер налогоплательщика, адрес электронной почты;
2) для физических лиц – фамилия, имя, отчество (если есть), данные паспорта или иного документа, удостоверяющего личность в соответствии с законодательством Российской Федерации (серия, номер), дата выдачи паспорта или иного документа, удостоверяющего личность в соответствии с законодательством Российской Федерации, адрес электронной почты;
3) удостоверенные копии документов, подтверждающих аккредитацию в соответствии со статьей 1244 Гражданского кодекса Российской Федерации (для организаций по управлению правами на коллективной основе);
4) удостоверенные копии документов, подтверждающих исключительное право пользователя на фильм или обладание исключительной лицензией на показ фильма на территории Российской Федерации.
5. Оператор ЕИС должен предоставить пользователю возможность заполнения и направления запроса на сайте ЕИС.
6. О получении запроса о предоставлении информации оператор ЕИС направляет пользователю электронное сообщение, содержащее дату и время поступления запроса в ЕИС.
7. О готовности информации по запросу оператор ЕИС сообщает пользователю посредством направления электронного сообщения, содержащего ссылку на соответствующий файл, содержащий запрашиваемую информацию, по указанному пользователем адресу, в формате Microsoft Excel.
8. Пользователь, переходя по указанной ссылке, загружает файл с запрашиваемой информацией.
|