Автоматизированная система расчетов за услуги связи «Fastcom» (стр. 1 )

АВТОМАТИЗИРОВАННАЯ СИСТЕМА
РАСЧЕТОВ ЗА УСЛУГИ СВЯЗИ
«Fastcom»

версия 12

Руководство администратора.

Диспетчер отчётов

Всего страниц - 34

Содержание

Термины        4

Назначение        4

Основные понятия        4

Состав Диспетчера отчётов        4

Процесс формирования отчётов        4

Действие диспетчера отчёта        5

PLSQL$ - действие в базе данных        5

PS2PDF$ - конвертация файла в формате PostScript в файл в формате Adobe PDF.        5

RW$RUN – выполнение отчёта Oracle Reports 6i        5

WIN$CMD – выполнение команды командного интерпретатора CMD        6

SQLPLUS$ - выполнение отчёта типа SQL        6

CONTENT$REPLACE – замена шаблонов в текстовом файле на значения параметров контента АСР        7

FILE$SYSTEM – действие в файловой системе        8

XML$XSLT – создание XML-отчёта, применение XSLT-преобразования        9

APACHE$FOP – форматирование XML-отчёта в выходной типографский формат        9

STORAGE$UPLOAD – загрузка файла в файловое хранилище Fastcom Agent        9

JASPER$ - выполнение отчёта Jasper Reports        10

Программа диспетчера отчётов        10

REPORT$HTM        11

REPORT$REP        12

REPORT$RTF        12

REPORT$SQL        12

REPORT$SQLDOS        13

REPORT$XML        13

REPORT$JASPER        13

Программы DD$%        14

Переопределение программы        14

Варианты действий        14

Параметры диспетчера отчётов        15

Очередь задач диспетчера отчётов        16

Очередь действий диспетчера отчётов        16

Создание и настройка программ  диспетчера отчётов        17

Вызовы, доступные в PL/SQL-блоках действий        17

Установка значения контекста задачи        17

Получение значение контекста задачи        17

Получение значения контекста задачи без вычисления        17

Получение контекста задачи в виде Fastcom-коллекции        17

Установка значение параметров текущего действия        18

Получение значения параметра действия        18

Получение значения параметра действия без вычисления        18

Получение всех значений параметров действия в виде Fastcom-коллекции        18

Получение кода текущего действия        18

Пропуск текущего действия        18

Откладывание текущего действия        18

Клонирование действия        18

Вычисление командной строки для отчёта типа SQL        19

Общие вызовы, имеющие отношение к диспетчеру отчётов        19

Создание новой задачи        19

Создание задачи по выполнению единичного отчёта        19

Генерация уникального имени файла        19

Генерация имени каталога для размещения результирующего файла        20

Получение расширения имени файла        20

Генерации имени каталога для договора при пакетном формировании отчётов для доставки абонентам        20

Администрирование диспетчера отчётов        20

Журнальные файлы        20

Очереди задач и действий        21

Сформированные файлы        21

Конфигурация Fastcom Report Dispatcher        21

Формат конфигурационного файла        22

Секция [global]        23

Секция  [constants]        23

Секция [oracle]        24

Секции [netdisk_N]        24

Секция [DEFAULT]        25

Секции [КОД_ОБРАБОТЧИКА]        26

Секция [SQLPLUS$]        26

Секция [RW$RUN]        26

Секция [PS2PDF$]        27

Секция [WIN$CMD]        27

Конфигурация программы Fastcom Report Producer        27

Секция [global]        28

Секция [constants]        28

Секция [oracle]        28

Секция [DEFAULT]        29

Секции [КОД_ОБРАБОТЧИКА]        29

Секция [APACHE$FOP]        29

Секция [SQLPLUS$]        29

Секция [JASPER$]        29

Параметры настройки АСР        30

RD$PRINTER        30

RD$SHARED_URL        31

Примеры программы диспетчера отчётов        31

Программа REPORT$HTM        31

Параметр DST$DIR        31

Параметр DST$EXTENSION        31

Параметр DST$FILE        31

Действие WIN$CMD        31

Действие CONTENT$REPLACE        32

Предварительный PL/SQL-блок        32

Завершающий PL/SQL-блок        32

Программа GENERATE INVOICES        33

Термины

АСР – Автоматизированная система расчётов «Fastcom» ППО – Прикладное программное обеспечение АСР, реализующее прикладные функции. Диспетчер отчётов – Приложения, отвечающие за генерацию отчётов для пользователей WEB-интерфейса пользователя АСР. Имеет две реализации:

Fastcom Report Dispatcher – win32-приложение, обеспечивающее обработку формирование Oracle Reports, SQL*Plus, HTML/RTF, XML (частично). Fastcom Report Producer – кросс-платформенное Java-приложение, обеспечивающее формирование отчётов XML, HTML/RTF.

Fastcom Apache – Сервер Apache, обеспечивающий работу WEB-интерфейса пользователя АСР Пользователь АСР – Оператор, участвующий в бизнес-процессах предприятия связи и использующий АСР для реализации возложенных на него задач. PostScript1 – язык описания страниц, в основном используемый в настольных издательских системах.

Назначение

Документ предназначен для администраторов АСР, целью которых является настройка АСР для формирования отчётов из АСР при использовании WEB - интерфейса пользователя АСР.

Основные понятия

Диспетчер отчётов является частью ППО и предназначен для формирования отчётов, заказанных пользователями WEB-интерфейса АСР, а также для подготовки множеств отчётов, предназначенных для отправки абонентам.

Состав Диспетчера отчётов

Диспетчер отчётов состоит из сервера «Fastcom Report Dispatcher», кроссплатформенной Java-программы «Fastcom Report Producer», и серверной части, расположенной в БД АСР.

Процесс формирования отчётов

Процесс формирования отчёта происходит следующим образом:

По команде пользователя в очередь задач на генерацию отчётов (таблица в схеме АСР Fastcom) добавляется задача, состоящая из последовательности элементарных действий, и имеющая параметры. Задача формирует очередь действий (таблица в схеме АСР Fastcom), различающихся по типам и параметрам. Внешнее приложение «Диспетчер отчётов» выбирает информацию из очереди действий в соответствии с порядком действий в задаче, настроенными фильтрами и приоритетами, выполняет действия и возвращает в ядро АСР результаты выполнения действия. После выполнения всех действий, входящих в задачу по генерации отчёта, отчёт считается сформированным, и может быть выведен в браузер пользователя WEB-интерфейса.

Действие диспетчера отчёта

Действие – элементарная операция, применяемая при генерации отчёта.

Действие имеет входные и выходные параметры, предварительный и завершающий PL/SQL блоки.

Просмотреть справочник действий диспетчера отчётов можно в «Меню Fastcom/Администрирование/Отчёты/Диспетчер Отчётов/Действия».

Администратор АСР не может создавать или удалять действия. В настоящее время диспетчер отчётов поддерживает действия, описанные ниже

PLSQL$ - действие в базе данных

Приложение Fastcom Report Dispatcher не выполняет никакой специфической обработки. Для действий типа PLSQL$ вычисляются параметры, выполняются предварительный и завершающий PL/SQL-блоки. Параметры действия не регламентируются. Действие должно иметь как минимум один параметр, в противном случае действие будет завершено с ошибкой.

PS2PDF$ - конвертация файла в формате PostScript в файл в формате Adobe PDF.

Конвертация производится с использованием свободно-распространяемой библиотеки Ghostscript2. Из-за ограничений текущей версии библиотеки один экземпляр приложения Fastcom Report Dispatcher не может выполнять более одного действия PS2PDF$ одновременно3.

Действие выполняется только в Win32-версии диспетчера отчётов.

Параметры действия PS2PDF$:

DST$DIR	Каталог (на сервере, исполняющем приложение Fastcom Report Dispatcher), в который будет помещен результирующий PDF-файл
DST$FILE	Имя результирующего файла (без расширения)
DST$EXTENSION	Расширение результирующего файла
SRC$DIR	Каталог (на сервере, исполняющем приложение Fastcom Report Dispatcher), в котором находится исходный PostScript-файл
SRC$FILE	Имя исходного PostScript-файла (с расширением)

RW$RUN – выполнение отчёта Oracle Reports 6i

Действие формирует один отчёт типа Oracle Reports 6i. Для выполнения этого действия на сервере, выполняющем программу Fastcom Report Dispatcher, должна быть установлена клиентская часть АСР Fastcom и Preinstalled Oracle Client согласно документации по установке АСР Fastcom на рабочие станции.