Текстовый просмотр отчетов (rpView)#

Утилита rpView.exe предназначена для конвертации файлов данных создаваемых Генератором Отчетов и его модулями в текстовый вид.

Утилита rpView.exe - это консольная программа, исполняемая в окне консоли и управляемая ключами командной строки.

При работе утилита выполняет указанную в командной строке команду. Если команда не указана, то параметр переданный в командной строке интерпретируется как имя файла данных. В этом случае утилита загружает указанный файл и, при успешной загрузке, выводит его содержимое в текстовой форме в текущее окно консоли.

При запуске утилиты без парамеров или с ключом «/?» она выводит справочную информацию.

--== RTS datafiles view tool ==--
USAGE: rpView <command> [-<option>] <argument>
    Where commands are:
        -TM           - decode server cfg version to time value
    Supported input files are:
        H|rth         - Stored report header file
        V|rtv         - Stored report values file
        A|agzx        - AGZ: ---- XML AGZ report
        G|agz         - AGZ: ---- Binary AGZ report
        U|usg         - Usage: -- USAGE report
        D|usd         - UsageDet: Month usage detailed
        M|muse        - Work/stop equipment report file
        V|vsr         - VSwitch:  Equipment ON/OFF report
    And options are:
        help          - print additional help info for specified command
        <O>ut=<file>  - redirect output to specified file
        AT=<fmt>      - AGZ output type (<T>xt, <H>tml)
    Header options are:
        NOSORT        - do not sort header contents on load
        COPY          - save copy of header file (makes rth file with name started with "copy")
        OEM           - Convert from OEM

Команды

Утилита поддерживается следующие команды:

-TM

Декодировать время или версию в формат даты.

ФАЙЛ

Декодировать указанный файл в текстовую форму

-TM

Декодировать время или версию в формат даты.

Аргументом команды должно быть значение времени или версии конфигурации.

ПРИМЕР

rpView.exe -tm 4514C105

Cfg version: 4514C105
Time: 23-09-2006 10:07:17

ФАЙЛ

Имя файла для декодирования в текстовую форму.

Утилита поддерживает следующие типы файлов данных:

Расширение

Ключ

Описание

rth

RT<H>

Файл заголовков значений программы Генереатор Отчетов.

rtv

RT<V>

Файл значений программы Генереатор Отчетов.

agzx

<A>GZX

Данные отчета АГЗ в сжатом или текстовом формате XML.

agz

A<G>Z

Данные отчета АГЗ в бинарном формате.

muse

<M>USE

Данные отчета «Почасовое использование оборудования».

usg

<U>SG

Данные отчета «Использование Оборудования».

usd

US<D>

Данные отчета «Использование оборудования с детализацией».

vsr

<V>SR

Данные отчета «Отключение оборудования».

Тип файла утилита определяет автоматически, используя расширение файла. В случае, если файл определился неверно или он имеет нестандартное расширение можно явно указать тип файла используя ключ командной строки.

ПРИМЕРЫ

rpView.exe "15-Сен-2006 Дискр. с детализацией 1.usd"

Декодировать файл с автоматическим определением типа (отчет «Использование оборудования с детализацией»).

rpView.exe -d "15-Сен-2006 Дискр. с детализацией 1.usd"

Декодировать файл с явным указанием типа файла как: «Использование оборудования с детализацией».

rpView.exe -u "15-Сен-2006 Дискр. с детализацией 1.usd"

; Decode file type: usg:[Usage:    USAGE report]...

ABORT: !load USAGE file
StdError: Unknown file ID 31466455

Декодировать файл с явным указанием типа файла как: «Использование Оборудования», что приводит к ошибке из-за неправильного указания типа файла данных.

Параметры

Команда загрузки файлов позволяет указать дополнительные параметры для вывода результатов.

-help

Если указано, то дополнительно выводит шапку для отображаемых данных с названиями колонок.

-<O>ut=<ФАЙЛ>

Если указана, то вместо вывода в окно консоли результат будет сохранен в файл с указанным именем.

-AT=<ФОРМАТ>

Устанавливает формат вывода для данных отчета АГЗ.

Можно указать один из следующих способов вывода:

  • <T>xt - использовать текстовый формат.

  • <H>tml - использовать формат Html.

NOSORT

Если указано, то отключает сортировку для данных файлов заголовков значений при загрузке.

COPY

Если указано, то при загрузке данных файлов заголовков, эти данные будут сохранены в файл с таким же именем и прафексом «copy».

OEM

Если указано, то при загрузке все текстовые данные будут сконвертированы из кодовой таблицы OEM (DOS866) в текущую принятую в ПО IngortechSCADA кодировку.

Этот ключ используется для загрузки данных в старом формате, когда данные текстовых полей сохранялись в кодировке DOS866.