Декодирование файлов конфигураций (DBUtil)#

Утилита DBUtil.exe предназначена для конвертации файлов конфигураций IngortechSCADA из одного формата в другой.

Использование#

Утилита DBUtil.exe может быть использована для импорта конфигураций в сторонне ПО (с использованием простого текстового формата или формата XML), подготовки конфигурации для ручного редактирования и других операций.

Утилита DBUtil.exe - утилита командной строки, т.е. предназначена для выполнения из консоли. Параметры команде передаются с помощью ключей командной строки в стандартном формате.

При запуске утилиты без параметров или с ключом «-?» в окне консоли будет выведена краткая справка по использованию программы.

DBT - HDB database conversion tool.
  Reads binary HDB database and output it using specified format.


     USAGE: DBUtil <HDB file> [<options>] [<output>]


<output>:
  .      - (single dot) supress data output.
  -      - (minus) use stdout as output.
  <name> - create file with specified name.

<options>:
  -<L>ist       - out database in plain format (default)
  -<X>ml        - out database in XML format
  -ra<W>        - out database in raw binary format
  -l<Z>h        - out database in comressed binary format
  -<D>ecompress - simple write decompressed binary database to output

Ключи командной строки#

Общий формат запуска программы:

DBUtil <ФАЙЛ-КОНФИГУРАЦИИ> [<ПАРАМЕТРЫ>] [<СПОСОБ-ВЫВОДА>]

ФАЙЛ-КОНФИГУРАЦИИ

Исходный файл конфигурации IngortechSCADA в любом поддерживаемом формате.

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

ПАРАМЕТРЫ

Набор параметров, описывающих способ преобразования конфигурации.

Может быть указан любой набор ключей, если это необходимо для выполнения конфигурации.

Поддерживаемые команды:

-<L>ist

Выводит данные конфигурации в простом текстовом формате.

Текстовые поля конфигурации выводятся с использованием той кодовой таблицы, которая была использована при сохранении данных.

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

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

<X>ml

Выводит конфигурацию в формате XML.

Текстовые поля конфигурации выводятся с использованием кодовой таблицы Windows-1251.

-ra<W>

Выводит конфигурацию в простом бинарном формате.

Текстовые поля конфигурации выводятся с использованием той кодовой таблицы, которая была использована при сохранении данных.

-l<Z>h

Выводит конфигурацию в бинарном формате со сжатием.

Алгоритм сжатия, который будет использоваться при выводе конфигурации определяется автоматически из набора поддерживаемого ПО IngortechSCADA.

-<D>ecompress

Разархивирует конфигурацию сохраненную в формате со сжатием в бинарную форму.

В отличие от ключа -ra<W>, не анализирует данные конфигурации и, соответственно, может быть применен для любых данных, сохраненных со сжатием любой программой IngortechSCADA.

Этот способ вывода может быть применен только в том случае, если исходный файл сохранен в бинарном формате со сжатием. В случае, если исходный файл не сжат, будет выдано сообщение об ошибке.

СПОСОБ-ВЫВОДА

Способ вывода преобразованной конфигурации.

.

Символ «точка».

Данные выводится не будут.

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

-

Символ «минус».

В этом режиме данные декодированной конфигурации будут выведены в поток stdout окна консоли.

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

Этот режим используется по умолчанию, если ни один способ вывода не указан явно.

ИМЯ ФАЙЛА

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

Примеры использования#

DBUtil.exe 1.rtdb

Загружает файл конфигурации 1.rtdb, декодирует способом по умолчанию (текстовый формат) и выводит результат способом по умолчанию (в поток stdout окна консоли).

DBUtil.exe -x 1.rtdb

Загружает файл конфигурации 1.rtdb, декодирует данные конфигурации в формат XML и выводит его способом по умолчанию (в поток stdout окна консоли).

DBUtil.exe -x 1.rtdb out.xml

Загружает файл конфигурации 1.rtdb, декодирует данные конфигурации в формат XML и сохраняет их в файле out.xml, перезаписывая файл если он уже существует.