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

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

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

SRC$DIR	Каталог (на сервере, исполняющем приложение Fastcom Report Dispatcher), содержащий скомпилированные определения отчетов Oracle Reports 6.
SRC$FILE	Имя файла определения отчёта (включая расширение)
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	Расширение имени файла, в который будет сгенерирован отчёт.

Примечание:  Замечена низкая производительность действия в операционной системе Microsoft Windows 2008 Server x86_64, а также существенная деградация производительности при параллельном выполнении нескольких действий RW$RUN параллельно. Microsoft Windows XP 32-bit и Microsoft Windows 7 x86_64 проблем с производительностью не имеют.

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

Выполняет команду CMD. EXE /C <команда пользователя>. В качестве результата возвращается код завершения программы и первые 2048 байт консольного вывода программы.

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

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

COMMAND$LINE	Командная строка для выполнения. Реально запускается процесс cmd. exe с параметрами /c $COMMAND$LINE, что эквивалентно вводу команды в командной строке.
RET$CODE	Параметр, в котором действие возвращает числовой код завершения программы
RET$TEXT	Параметр, в котором действие возвращает первые 2048 символов консольного вывода программы
SCRIPT$TIMEOUT	Время (в секундах), отведенное на выполнение команды. В случае если время выполнения команды превышает переданное в этом параметре значение, запущенная команда прерывается принудительно, и действие завершается с ошибкой. Рекомендуется устанавливать значение SCRIPT$TIMEOUT меньше значения параметра watchdog конфигурационного файла приложения Fastcom Report Dispatcher, т. к. в противном случае поток исполнения задач будет снят по watchdog-таймауту, о чем не будет сообщено в очередь действий в схеме данных АСР Fastcom.

Примечание: При использовании 32-битного приложения Fastcom Report Dispatcher в 64-битных версиях Microsoft Windows запуск через действие WIN$CMD 64-битных приложений приводит к мгновенному возврату управления из запускаемой команды, без ожидания завершения порожденного процесса, получения кода его завершения и текста консольного вывода. Рекомендуется не запускать 64-битные приложения. В случае крайней необходимости через службу поддержки может быть получена версия приложения Fastcom Report Dispatcher, обходящая данную особенность через небезопасные вызовы ОС Windows, способные повлиять на надёжность и функционирование приложения в целом.

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

Запуск на выполнение программы SQL*Plus из набора программ Oracle Client for Windows. Отличия от действия WIN$CMD:

Формируются необходимые переменные окружения (ORACLE_HOME, NLS_LANG) Не обязательно передавать реквизиты соединения с Oracle.

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

COMMAND$LINE	Часть командной строки для исполнения. Приложение Fastcom Report Dispatcher порождает процесс с командной строкой: {ORACLE_HOME}/bin/sqlplus {ORA$CONNECTION} {COMMAND$LINE}
NLS$ENCODING	Используемая кодировка символов. Допустимые значения можно получить следующим запросом: select value from V$NLS_VALID_VALUES where parameter='CHARACTERSET' and isdeprecated='FALSE' При отсутствии значения используются данные из конфигурационного файла приложения Fastcom Report Dispatcher.
NLS$LANG	Используемый язык системных сообщений и названий месяцев, дней недели и т. д. Допустимые значения можно получить следующим запросом: select value from V$NLS_VALID_VALUES where parameter='LANGUAGE' and isdeprecated='FALSE' При отсутствии значения используются данные из конфигурационного файла приложения Fastcom Report Dispatcher.
NLS$TERRITORY	Территориальные настройки – символ десятичного разделителя в дробных числах, валюта и т. д. Допустимые значения можно получить запросом: select value from V$NLS_VALID_VALUES where parameter='TERRITORY' При отсутствии значения используются данные из конфигурационного файла приложения Fastcom Report Dispatcher.
ORA$CONNECTION	Строка соединения с базой данных в формате: username/password@tns_name При отсутствии значения используются данные из конфигурационного файла приложения Fastcom Report Dispatcher.
RET$CODE	Код завершения приложения SQL*Plus, возвращаемое значение
SCRIPT$TIMEOUT	Время (в секундах), отведенное на выполнение приложения SQL*Plus. В случае если время выполнения приложения превышает переданное в этом параметре значение, приложение прерывается принудительно, и действие завершается с ошибкой. Рекомендуется устанавливать значение SCRIPT$TIMEOUT меньше значения параметра watchdog конфигурационного файла приложения Fastcom Report Dispatcher, т. к. в противном случае поток исполнения задач будет снят по watchdog-таймауту, о чем не будет сообщено в очередь действий в схеме данных АСР Fastcom.

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

Действие CONTENT$REPLACE предназначено для выполнения отчётов типа RTF АСР Fastcom. Входной файл (шаблон отчёта) читается построчно, в каждой строке шаблоны вида  {LTAG}наименование параметра контента{RTAG} заменяются на значение параметра  контента. LTAG и RTAG – произвольные строки, задаваемые как параметры отчёта. Например, при значениях LTAG = ‘qqq’ и RTAG = ‘ppp’ строка

Дата: qqqSYSDATE2ppp

Будет заменена на строку

Дата: 14 октября 2011 г.

, где 14 октября 2011 г. – вычисленное значение параметра контента SYSDATE2.

Действие применимо для формирования отчётов, не содержащих табличных частей – блоков данных, повторяющихся неизвестное на этапе разработки отчёта количество раз. Целесообразно применять для простых текстовых фалов, файлов в форматах HTML, XML,  TeX, LaTeX4, RTF5 (после ручной проверки RTF-шаблона на отсутствие команд форматирования внутри подлежащих замене шаблонов) и т. д.

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

SRC$DIR	Каталог (на сервере, исполняющем приложение Fastcom Report Dispatcher), содержащий исходный файл – шаблон отчёта
SRC$FILE	Имя исходно файла – шаблона отчёта
DST$DIR	Каталог (на сервере, исполняющем приложение Fastcom Report Dispatcher), в который будет помещён готовый отчёт
DST$FILE	Имя файла (без расширения) сформированного отчёта
DST$EXTENSION	Расширение файла сформированного отчёта
L_TAG	Левая «скобка», ограничивающая подлежащий замене шаблон
R_TAG	Правая «скобка», ограничивающая подлежащий замене шаблон
UNICODE$	Способ записи символов национальных алфавитов. Допустимые значения:   RTF – использовать формат записи, принятый для формата RTF   любое другое значение – значение параметра контента помещается в выходной файл без преобразований

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

Для создания каталога, удаления или переименования файла можно пользоваться действиями WIN$CMD и UNIX$CMD, вызывая соответствующие команды операционной системы. При этом возможны ситуации, при которых из-за временной недоступности одного из компонентов системы (например, Windows-версии диспетчера отчётов) отчёты типа XML, способные выполниться на Java-версии на ОС семейства UNIX, ожидают выполнения действия WIN$CMD, необходимого для создания целевого каталога.

Для исключения подобной ситуации предназначено действие FILE$SYSTEM, выполняющееся одинаково на Windows - и Java-реализациях диспетчера отчётов.

Также сделана более логичной обработка ошибок. Команда операционной системы для создания каталога вернёт ошибку в том случае, если такой каталог уже есть. С точки зрения действия FILE$SYSTEM это корректная ситуация, т. к. желание пользователя выполнено – каталог существует.

Параметры действия FILE$SYSTEM зависят от выполняемой команды:

COMMAND$	Одна из поддерживаемых команд: mkdir – создание каталога rmdir – удаление каталога force rmdir –удаление непустого каталога delete – удаление файла rename – переименование
mkdir	DST$DIR	Имя (путь) создаваемого каталога.
rmdir	SRC$DIR	Имя (путь) к удаляемому каталогу.
force rmdir	SRC$DIR	Имя (путь) к удаляемому каталогу.
rename	SRC$DIR	Путь к каталогу, в котором содержится переименовываемый файл
SRC$FILE	Имя переименовываемого файла, включая расширение
DST$DIR	Путь к каталогу, в который будет перемещён файл
DST$FILE	Новое имя файла (без расширения)
DST$EXTENSION	Расширение имени файла
delete	SRC$DIR	Путь к каталогу, содержащему удаляемый файл
SRC$FILE	Имя удаляемого файла

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

Действие XML$XSLT создаёт XML-файл, выполняя переданный в качестве параметра XML-запрос  и подчинённые запросы (см. документ «"Руководство программиста. Отчёты XML").  Установка параметров выполнения запроса должны быть выполнена в предварительном коде PL/SQL действия программы диспетчера отчётов.