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

Если задано имя файла XSLT-преобразования, то оно выполняется.

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

XMLQ$ID	Идентификатор XML-запроса
DST$DIR	Каталог, в который будет помещён результат выполнения запроса или XSLT-преобразования.
DST$FILE	Имя файла, в который будет помещён результат выполнения запроса или XSLT-преобразования.
DST$EXTENSION	Расширение имени файла, в который будет помещен результат выполнения запроса или XSLT-преобразования.
SRC$DIR	Путь к каталогу, содержащему файл XSLT-преобразования (не обязательный параметр)
SRC$FILE	Имя файла XSLT-преобразования (необязательный параметр)

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

Действие вызывает библиотеку Apache FOP6 для преобразования XML-файла в один из типографский форматов – PDF, PostScript. Также поддерживаются форматы RTF, PNG и TIFF, из которых рекомендуется использовать только PNG. Документы в формате RTF и изображения TIFF могут быть сгенерированы некорректно.

Исходный XML-файл должен соответствовать стандарту XSL-FO7.

Действие может быть выполнено только на Java-версии Диспетчера Отчётов.

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

DST$DIR	Каталог, в который будет помещён результирующий файл
DST$FILE	Имя результирующего файла
DST$EXTENSION	Расширение результирующего файла. Может принимать одно из следующих значений: .pdf – для формирования файла Adobe PDF .ps – для формирования файла PostScript .png – для формирования растрового изображения PNG .tiff – для формирования растрового изображения TIFF (ен рекомендуется) .rtf – для формирования документа RTF (не рекомендуется) В случае других значений параметра результатом выполнения действия будет ошибка «Renderer not supported».
SRC$DIR	Каталог, содержащий исходный XML-файл
SRC$FILE	Имя исходного XML-файла, соответствующего стандарту XSL-FO.

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

Действие позволяет поместить сгенерированный отчёт (или, при необходимости, любой другой доступный файл) в файловое хранилище, обслуживаемое сервером Fastcom Agent.

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

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

DST$DIR	Каталог назначения в формате КОД_ХРАНИЛИЩА:/каталог/каталог.
DST$FILE	Имя, под которым файл будет сохранён в хранилище. Необязательный параметр. Если не указан, то имя файла будет взято из параметра SRC$FILE
DST$EXTENSION	Расширение имени файла, под которым файл будет сохранён в файловом хранилище. Необязательный параметр. Если не указан, то будет взято расширение исходного файла из параметра SRC$FILE
SRC$DIR	Каталог, содержащий файл для загрузки в файловое хранилище
SRC$FILE	Имя файла (с расширением) для загрузки в файловое хранилище.

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

Действие запускает библиотеку Jasper Reports для формирования отчёта.

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

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

DST$DIR	Каталог, в который будет помещён результирующий файл
DST$FILE	Имя результирующего файла
DST$EXTENSION	Расширение результирующего файла.
DST$FORMAT	Формат файла, одно из следующих значений: PDF HTML8 DOCX – файл в «новом» формате Microsoft Word ODT – текстовый документ в формате OASIS Open Document (OpenOffice, LibreOffice) XLS – файл в «старом» формате Microsoft Excel XLSX – файл в «новом» формате Microsoft Excel ODS – таблица в формате OASIS Open Document (OpenOffice, LibreOffice)
SRC$DIR	Каталог исходный файлов отчётов
SRC$FILE	Исходный файл отчёта

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

Программа диспетчера отчётов – упорядоченный набор действий, решающих определенную прикладную задачу. Пользователь может инициировать исполнение программы, но не отдельного действия.

Редактирование справочника программ диспетчера отчётов осуществляется из интерфейса пользователя АСР Fastcom, «Меню Fastcom/Администрирование/Отчёты/Диспетчер Отчётов/Программы».

Программа имеет набор входных параметров. Перед выполнении программы набор входных параметров копируется в отдельную область – «контекст задачи». Действия программы могут изменять контекст задачи, передавая результаты выполнения действия последующим действиям.

Действие входит в программу со следующими атрибутами:

Набор значений параметров. Значение параметра действия, входящего в задачу, может быть переопределено, или оставлено «по умолчанию». Порядок выполнения. Действия программы выполняются в порядке возрастания числового значения атрибута «Последовательный номер действия в программе». Допустимо иметь в программе несколько действий с одинаковым номером последовательности выполнения – в этом случае такие действия могут быть выполнены диспетчером отчётов параллельно, в том числе и на разных экземплярах приложения Fastcom Report Dispatcher. Порядок выполнения таких действий не детерминирован, поэтому не рекомендуется из таких действий изменять контекст задачи. Предварительный и завершающий PL/SQL-блоки. PL/SQL-блоки могут быть переопределены, или оставлены значения по умолчанию. При выполнении действия выполнятся предварительный PL/SQL-блок, в котором можно изменить значения параметров действия, затем действие с новыми значениями параметров выполняется приложением Fastcom Report Dispatcher. Результаты действия возвращаются в контекст задачи. После выполнения действия выполняется завершающий PL/SQL-блок, в котором можно изменить контекст задачи.

При возникновении ошибки в одном из действий вся задача помечается, как завершившаяся с ошибкой, последующие действия не выполняются. Администратор имеет возможность продолжить выполнение программы с действия, завершившегося с ошибкой (после исправления причины ошибки, например, недостаточного места на диске сервера), или со следующего действия, проигнорировав ошибку.  При параллельном выполнении действий, в случае возникновения ошибки,  уже выбранные диспетчером отчётов для исполнения действия  продолжат выполняться.

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

Коллекция значений:  текстовая строка вида ЗНАЧЕНИЕ1:ОПИСАНИЕ1;ЗНАЧЕНИЕ2:ОПИСАНИЕ2;  общей длиной не более 4000 символов. SQL-запрос, возвращающий список значений. Первый столбец результата выполнения запроса должен содержать само подставляемое значение, остальные столбцы результата выполнения запроса содержат описание значения и дополнительные параметры, которые могут быть использованы пользователем для поиска необходимого значения. Пример запроса, позволяющего выбрать один из множества зарегистрированных в системе отчётов типа Oracle Reports:

SELECT  CODE "Код отчёта", NAME "Наименование отчёта"

  FROM  RP_T_REPORT

WHERE  IS_ACTIVE = 'Y'

  AND TYPE='REP'

ORDER  BY NAME

Администратор может создавать собственные программы и изменять существующие в соответствии с требованиями инфраструктуры, обслуживающей АСР Fastcom.

Удаление возможно только для самостоятельно созданных программ. Системные программы содержат в коде программы символ ‘$’,  и не могут быть удалены средствами интерфейса АСР.

В АСР используются предопределённые коды программ для формирования единичных отчётов различных типов. Каждая из этих программ после выполнения должна записать в контекст задачи параметр ‘URL’, значением которого должен быть URL (http-ссылка) на файл  сформированного отчёта.

Определены следующие программы:        

REPORT$HTM

Программа REPORT$HTM используется для формирования отчётов типа HTM. Основывается на действии CONTENT$REPLACE без дополнительного преобразования символов национального алфавита.

Параметры программы:

REPORT$CODE	Код выполняемого отчёта (по справочнику отчётов)
REPORT$TYPE	Тип отчёта  (HTM)
DST$DIR	Каталог (на сервере, исполняющем приложение Fastcom Report Dispatcher)
DST$FILE	Имя файла (без расширения), в который помещается сформированный отчёт
DST$EXTENSION	Расширение файла, в который помещается сформированный отчёт

REPORT$REP

Программа формирования отчёта Oracle Reports 6i. Отчёт может быть сохранён в файл на диске сервера, или отправлен непосредственно на принтер.

Параметры программы:

REPORT$CODE	Код выполняемого отчёта (по справочнику отчётов)
REPORT$TYPE	Тип отчёта  (REP)
DST$DIRECTION	Направление генерации. Допустимые значения:   FILE – отчёт формируется в PostScript-файл. Для работоспособности данной функциональности необходимо установить на сервере, исполняющем приложение Fastcom Report Dispatcher, фиктивный PostScript-принтер, и указать его название в конфигурационном файле   PRINTER – отчёт будет выведен непосредственно на принтер. Принтер должен быть подключен серверу, исполняющему приложение Fastcom Report Dispatcher, непосредственно или через локальную сеть. Имя, под которым принтер зарегистрирован в ОС Windows, должно быть указано в параметре FILE действия RW$RUN
DST$DIR	Каталог (на сервере, исполняющем приложение Fastcom Report Dispatcher), в который будет помещен результирующий PostScript-файл.
DST$FILE	Имя файла (без расширения), в который будет сгенерирован отчёт в формате PostScript
DST$EXTENSION	Расширение имени файла, в который будет сгенерирован отчёт.

REPORT$RTF

Программа REPORT$RTF используется для формирования отчётов типа RTF. Основывается на действии CONTENT$REPLACE с использованием предобразования символов национального алфавита к виду, принятому для формата RTF.