Краткая инструкция по запуску в эксплуатацию подсистемы анализа и
advertisement
Краткая инструкция по запуску в эксплуатацию подсистемы анализа и
консолидации отчетности на базе МПАКО
1. Отчетные формы
МПАКО работает с отчетностью, для которой предварительно должны быть
определены отчетные формы, а их описание загружено в базу данных. Также на
основании описаний форм должны быть подготовлены сценарии для отображения
отчетных форм в различных режимах. Отдельные показатели отчетных форм могут
содержать коды, состоящие из одного или нескольких разрядов. Для таких показателей
должны быть подготовлены xml-файлы описаний кодировки.
a. Подготовка отчетных форм в редакторе FastGridEditor
Для использования формы в программе следует с помощью визуального
редактора FastGridEditor (поставляется в составе средств обеспечения
МПАКО в виде исполняемого файла) создать файлы описания форм. Файл
описания представляет собой XML-Документ, имеющий расширение "xmlf".
Данный файл содержит описание всей формы целиком или отдельного её
раздела/подраздела (в случае формы, содержащей большое число показателей).
В редакторе рисуется отчетная форма, процесс рисования напоминает работу с
MS Excel. Существует несколько слоев описания формы: визуальный слой (как
выглядит форма при редактировании и на печати), слой привязок (откуда
берутся данные в каждой ячейке), какие кодировщики используются,
аналитический слой (как происходит сортировка или группировка данных,
какие ячейки повторяются на каждой странице при печати, какие графы
«замораживаются» при горизонтальной прокрутке широких форм). В
зависимости от типа отчетной формы (таблица, список, повторяющийся
фрагмент) устанавливаются дополнительные параметры, влияющие на работу с
формой: сортировка списка, повторение заголовков таблиц при печати, задание
уникальных полей для повторяющегося фрагмента. Подбирается ширина и
высота ячеек, вставляются разбиения на страницы.
b. Создание сценариев для отображения форм и для загрузки структуры
форм в базу данных на основании описаний
Когда описания форм подготовлены, то из них, посредством программ
xmlf2html и xmlf2defs (поставляются в составе средств обеспечения МПАКО в
виде исполняемых файлов) должны быть подготовлены сценарии отображения
форм и описания структуры для загрузки в базу данных. Программа
представляют собой утилиты командной строки. В составе МПАКО
поставляются версии для операционных систем Windows и Linux.
Для нормального функционирования
следующие виды сценариев отображения:
следует
подготовить
Сценарий для просмотра формы в обозревателе
xmlf2html -D -G -F
МПАКО,
Файл_описания.xmlf
Файл_сценария.pik
Сценарий для отображения печатного варианта формы
xmlf2html -D -G -F -P Файл_описания.xmlf
Файл_сценария.pik
Сценарий для отображения сводной формы в обозревателе
xmlf2html -D -G -F -S Файл_описания.xmlf
Файл_сценария.pik
Сценарий для отображения печатного варианта сводной формы
xmlf2html -D -G -F -S -P Файл_описания.xmlf
Файлы для отображения формы с элементами выбора показателей и
условий для визуального конструктора формул
xmlf2html -G -F -C Файл_описания.xmlf
Для нормального функционирования
следующие описания структур форм:
Файл_сценария.pik
Файл_отображения.html
МПАКО,
следует
подготовить
Набор SQL-запросов (INSERT), которые произведут загрузку
структуры в базу данных
xmlf2defs Файл_описания.xmlf Вид_отчетности Период Вых_Файл.sql
JavaScript код, который будет использоваться в визуальном
конструкторе формул.
xmlf2defs Файл_описания.xmlf jscript Период Файл_сценария.js
c. Размещение сценариев для отображения форм и настройка их
использования
Подготовленные сценарии отображения и описания структуры отчетных
форм должны быть помещены в подкаталог forms основного каталога МПАКО
на сервере приложений согласно следующей схемы:
/forms
Сценарии просмотра.
/view
/Отч.период
/Вид.отчетности
...
Сценарии печати.
/print
/Отч.период
/Вид.отчетности
...
/svod
/Отч.период
/Вид.отчетности
...
/svod_print
/Отч.период
/Вид.отчетности
...
/sqls
Сценарии просмотра сводных форм
Сценарии печати сводных форм.
sql-сценарии загрузки структуры.
/Отч.период
/Вид.отчетности
...
/checks
/Отч.период
/Вид.отчетности
...
/codes
/Отч.период
/Вид.отчетности
...
Файлы для отображения с
элементами выбора;
JavaScript файлы структуры.
xml-файлы описаний кодировки
Настройка использования сценариев производится в каталоге forms/structure,
прописыванием на языке picoScripts процедур в файлах forms.pik,
содержащихся в различных подкаталогах:
/forms
/structure
forms.pik
/Отч.период
forms.pik
/Вид.отчетности
forms.pik
Задает список доступных периодов
Задает список доступных видов
Задает список доступных форм
d. Загрузка в базу данных структуры форм
Описание структуры отчетных форм, содержащееся в подготовленных sqlфайлах, должно быть загружено в базу данных МПАКО до начала работы с
соответствующей отчетностью. Для этого sql-файлы должны быть исполнены
посредством программы sqlplus, входящей в СУБД ORACLE или с
использованием средства администрирования БД сторонних разработчиков.
2. Создание пакетов хранимых процедур в базе данных для выполнения
операций над списками
После того, как список субъектов подготовлен, пользователю предоставляется
возможность выполнить над ними любые операции, которые сконфигурированы в
МПАКО. Информация о доступных заданиях для конкретного отчетного периода
содержится в таблице БД USER_TASK_TYPES. Туда она заносится при установке
пакета, выполняющего необходимые функции.
Сами задания должны быть оформлены в качестве пакетов хранимых процедур и
иметь публичный метод Pico_Install без параметров для регистрации в МПАКО. В
одном пакете может содержаться несколько заданий, оформленных в виде публичных
методов пакета. Каждый из методов должен иметь вид:
PROCEDURE
Название( AStep
AUserId
ACompId
AListId
IN
IN
IN
IN
INTEGER,
INTEGER,
INTEGER,
INTEGER,
APeriod
IN DATE)
Когда задание ставится пользователем на выполнение, то соответствующий метод
вызывается несколько раз (пошагово). При каждом вызове параметр AStep
увеличивается на единицу. Это сделано для того, чтобы пользователь мог видеть ход
выполнения заданий, выполняющихся продолжительное время. Остальные параметры
имеют следующее значение:
AUserId
ACompId
AListId
APeriod
Идентификатор пользователя, запустившего задание
Идентификатор субъекта, для которого выполняется задание
Идентификатор списка, для которого выполняется задание
Отчетный период, для которого выполняется задание
В базовой поставке МПАКО включены пакеты для выполнения заданий по
построению сводов по формам отчетности, описание которых загружено в базу
данных.
3. Добавление новых видов отчетности
Если в МПАКО планируется использовать новый вид отчетности, то в таблицу базы
данных USER_KINDS необходимо добавить соответствующую запись. Как правило,
добавление записи выполняется в методе Pico_Install одного из пакетов.
4. Добавление новых отчетных периодов
Если в МПАКО планируется использовать новый отчетный период, то в таблицу базы
данных USER_PERIODS необходимо добавить соответствующую запись. Как
правило, добавление записи выполняется в методе Pico_Install одного из пакетов.
5. Прописывание алгоритмов преобразования данных
документов в SQL-запросы для загрузки в базу данных
первичных
XML-
В состав МПАКО входит сценарий xml_to_db.js, написанный на Javascript и
периодически выполняемый с помощью среды node.js (версии не ниже 0.25).
Сценарий отслеживает изменение файлов, маршруты к которым удовлетворяют
заданным в файле to_db_models шаблонам, и вызывает процедуру согласно маркеров
шаблонов для преобразования измененных файлов в набор sql-запросов. В том случае,
если в качестве первичных данных будут использоваться xml-файлы во внутреннем
формате программ приема и проверки сведений (ПППС), то дополнительных
доработок для реализации функциональности не потребуется. Методы для обработки
шаблонов с маркерами "oct" и "work" прописаны разработчиком.
В противном случае в файл xml_to_db.js должны быть добавлены методы объекта
exports, имена которых совпадают с названиями маркеров шаблонов, например:
exports.xml_anketa = function (xmlfile, sqlfile) {
}
Здесь xmlfile - полный маршрут к исходному файлу
sqlfile - полный маршрут к файлу для записи sql-запросов.