Руководство разработчика

Разработка типовых операций

Типовые операции хранятся в файлах с расширением *.top. В одном таком файле, как правило, содержится несколько типовых операций. Список типовых операций формируется путем объединения операций из всех найденных файлов с расширением *.top в папке типовых операций. В окне Справка/Информация Главного меню отображаются папка, количество и список используемых файлов типовых операций, количество типовых операций. Для просмотра списка типовых операций необходимо выбрать пункт Установка/Типовые операции/Открыть текст операции... Главного меню.

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

Перейти к редактированию типовых операций также можно, выбрав соответствующий файл (пункт меню Установка/Типовые операции/Открыть файл...).

Редактор типовых операций

Работа с текстом в редакторе типовых операций осуществляется аналогично работе с текстом во встроенном текстовом редакторе.

При помощи комбинации клавиш Ctrl+I в редакторе типовых операций можно вызвать окно со списком типовых операций в редактируемом файле.

Компиляция и запуск из редактора типовых операций выполняются для той операции, в определении которой находится курсор.

Структура файла типовых операций

// Первая типовая операция
ОПЕРАЦИЯ [<раздел>: [<подраздел>: [ ... ]]]
    <операция> [<[файл_кода] [, команда справки]>]
// описание граф ввода
ВЫЧИСЛИТЬ
// последовательность расчета и формирования хозяйственных операций
КОНЕЦ
// Вторая типовая операция
ОПЕРАЦИЯ ...
...
КОНЕЦ
...
раздел, подраздел
Названия разделов и подразделов.
операция
Название операции.
файл_кода
Имя файла кода (*.ibx). Указание имени файла кода является признаком того, что типовая операция будет выполняться в режиме компилятора.
команда справки
Команда справочной системы в формате Инфо-Навигатора, например:
<?*реализация>
Также может задаваться ссылки на файл справки в формате WinHelp (*.hlp), либо HtmlHelp (*.chm). Синтаксис ссылки на help-файл:
<?<имя_файла_справки>[#<номер_топика>]>
Если номер топика не указан, выводится страница содержания, если указан – топик с заданным номером. Поиск файла справки осуществляется в папке файла типовой операции. При вызове справки в формате HtmlHelp возможно задавать как номер топика, так и имя внутреннего html-файла. Например:
<?myhelp.chm::/mytopic.htm>
Для использования числовых идентификаторов топиков необходимо включить файл соответствия в секцию [MAP] проекта *.hhp. Подробности см. в справке HtmlHelp Workshop.

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

Пример:

// Для компилируемой операции
ОПЕРАЦИЯ Мои_операции: Операция_1 <myop1.ibx, ?my.hlp#101>
// Для интерпретируемой операции
ОПЕРАЦИЯ Мои_операции: Операция_2 <?my.hlp#102>

Компиляция типовых операций

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

ОПЕРАЦИЯ Зарплата: Начисление <zpnach>

В данном случае для типовой операции по начислению зарплаты будет использоваться компилятор. Для кода и визуальной формы будут созданы два файла: zpnach.ibx и zpnach.vfx.

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

Для выполнения откомпилированной типовой операции не требуется обращение к файлу типовых операций.

Использование типовых операций в качестве диалоговых окон

Запуск типовой операции возможен при помощи функции ТИП_ОПЕР с явным указанием файла, в котором находится типовая операция.

В файлах типовых операций есть поддержка ключевого слова ДИАЛОГ. Данное ключевое слово применяется так же, как ключевое слово ОПЕРАЦИЯ в файлах *.TOP.

Типовые операции, начинающиеся со слова ДИАЛОГ не отображаются в списке типовых операций при добавлении в ЖХО.

Для операций, определенных как ДИАЛОГ, отличается поведение при показе одного диалога из другого. Если для ОПЕРАЦИЯ нажатие кнопок "ОК" или "Отмена" приводят к выходу из ВВЕСТИ нижлежавшей операции, то для ДИАЛОГ – нет.

Для ОПЕРАЦИЯ данное поведение сохранено из соображений совместимости.

Пример:

// в TOP-файле  
ДИАЛОГ Диалоги : Ввод количества и цены
    Количество : &кол&&&&&&&&&
    Цена       : &цена&&&&&&&&
ВЫЧИСЛИТЬ
    ВВЕСТИ
    сумма = кол*цена
КОНЕЦ

...
// вызов диалога
ТИП_ОПЕР("Диалоги : Ввод количества и цены")

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

Загрузка типовых операций

Если папка типовых операций откладывается от базы, то при смене базы данных происходит переключение типовых операций.

При загрузке типовых операций (во время запуска программы) выводится сообщение об ошибках в типовых операциях, если таковые есть:

Файлы типовых операций по умолчанию ожидаются в кодировке OEM cp 866. Для переключения на ANSI cp 1251 для всех файлов типовых операций, можно в файле ibw.ini указать параметр:

[Options]
TipOpANSI=ON

См. также: