«Финансы без проблем»
Сетевая версия

1. Введение: как это работает

«Финансы без проблем» (ФБП) — учётная система клиент-серверной архитектуры. В ней есть ровно один ФБП:Сервер и сколько угодно ФБП:Клиентов. Это руководство описывает только сетевую версию и актуализировано под новые программы: ФБП:Сервер V01 для Windows и ФБП:Клиент CLWP.

1.1. Толстый сервер, тонкие клиенты

ФБП:Сервер — «толстый» процесс с собственной быстрой RAM-only СУБД. Он хранит на диске данные и правила (журналы операций, план счетов, дерево видов операций, отчётные формы), а в памяти держит вычислительное ядро. Сервер в реальном времени пересчитывает состояние базы, так что к следующему запросу клиента готов уже готовый результат. Все значимые вычисления выполняет только сервер: регистрация и удаление операций, пересчёт баланса, вычисление формул, выполнение отчётных форм, контроль прав пользователей.

ФБП:Клиент — «тонкий». Он формирует запросы к серверу и отображает ответы, но не делает значимых вычислений и не блокирует сервер, конфликтуя за данные. Сервер обрабатывает запросы всех клиентов в порядке общей очереди.

1.2. Обмен — через общий каталог, а не через сеть

Самое неочевидное и самое важное свойство платформы: «сетевая версия» обменивается данными не по сетевым протоколам, а через общий каталог обмена (историческое имя — _box_). Никаких портов, сокетов и служб удалённого доступа: достаточно, чтобы сервер и клиенты видели один и тот же каталог (например, через сетевой ресурс Windows) и имели к нему доступ на запись.

Цикл одного запроса:

1. Клиент создаёт в каталоге обмена файл-запрос со случайным именем из букв и цифр (например ZXC456A3.REQ), затем переименовывает его в ZXC456A3.IN. Переименование — атомарный сигнал «файл готов целиком».
2. Сервер постоянно сканирует каталог обмена. Найдя *.IN, он выполняет запрос, удаляет .IN, пишет ответ в ZXC456A3.ANS и по завершении переименовывает его в ZXC456A3.OUT.
3. Клиент читает ZXC456A3.OUT и при следующем запросе удаляет его.

В каталоге обмена можно создавать подкаталоги — например, отдельный для каждого клиента или для шлюзов оборудования. Сервер сканирует их наравне с корнем каталога; это также удобно для разделения прав доступа средствами ОС (см. главу 6).

Нетребовательность к сети — следствие такой схемы: типичный запрос (R OBOROTKA) занимает десятки байт, а ответ — несколько килобайт. Тем не менее рекомендуемое размещение, в порядке убывания надёжности и скорости:

• лучший вариант — сервер, данные и каталог обмена на одной машине;
• хуже — каталог обмена на другой машине;
• самый тяжёлый — данные и сервер на разных машинах.

1.3. Что из чего состоит

1.4. Язык программирования ФБП

Прикладная логика системы — план счетов, дерево видов операций с проводками и, главное, отчётные формы *.rpt — пишется на собственном языке ФБП. Формы компилирует и выполняет сервер (директивы R, E, см. главу 7); клиент дополнительно исполняет встречающиеся в тексте форм управляющие строки N: — навигацию и запросы по клавишам (см. главу 23).

1.5. Что нового в этой редакции руководства

• Описаны только сетевые программы: однопользовательские и DOS-варианты исключены как неактуальные.
• ФБП:Сервер — новая реализация V01: служба Windows, Менеджер баз, лицензирование, журналы, автоархивирование, гибернация базы (глава 3).
• ФБП:Клиент — новый клиент CLWP: современный интерфейс, поиск-выборка, экспорт в Excel, управляющие строки N:SHIFTF1:…N:SHIFTF9: и N:AUTO: (глава 4 и глава 23).
• Явно указано, какие директивы и ключевые слова старого сервера не перенесены (глава 7, глава 8, глава 29).

2. Количественные ресурсы и ограничения

В этой главе собраны пределы платформы: одни вытекают из форматов файлов данных (они неизменны — новый сервер работает с существующими базами), другие — из реализации нового ФБП:Сервера V01. Исторические ограничения старого сервера, которые в новой реализации сняты, отмечены отдельно.

2.1. Журналы операций и уникальные коды

Операции года хранятся в двенадцати файлах YYYYMM.f3p — по одному на месяц. Явно заданного ограничения на число операций нет; предел вытекает из формата уникального кода операции вида MLLL-000 (M — буква месяца A…L, далее три буквы и три цифры):

26 × 26 × 26 × 10 × 10 × 10 = 17 576 000 уникальных кодов

Суммарный размер всех двенадцати файлов *.f3p не может превышать 17 576 000 записей; реально, с учётом удалённых операций, — несколько миллионов операций в год. При старте сервер находит код с максимальным значением и продолжает нумерацию от него; код удалённой операции уже никогда не используется повторно.

Комментарий операции — до 56 литер, включая добавляемый сервером штамп (пользователь, время, уникальный код).

2.2. Операции типа null (разрыхление журналов)

При первом старте на базе, журналы которой не разрыхлены, сервер вносит в файлы *.f3p пустые операции типа null. Когда пользователь вводит операцию «в прошлое», ближайшая пустая операция заменяется новой — без пересоздания файла месяца. При десятках тысяч операций в месяц это единственное решение, дающее достаточную производительность ввода. Если пустых операций не нашлось, файл разрыхляется повторно.

2.3. План счетов, факты, экстрапараметры

• acnt.a3p (счета и субсчета) — явно заданного ограничения на число счетов нет. Обозначение счёта — от 1 до 10 символов, наименование — до 255.
• facts.b (лента фактов) и extra.b (экстрапараметры) — ограничений нет, лента, индексы фактов и экстрапараметры должны поместиться в ОЗУ сервера.
• extrd.dat (дисковая база экстрапараметров) — ограничен местом на диске; запись — до 255 байт. При наличии файла-ключа fastged в ОЗУ строится зеркало тел записей (см. главу 8).

2.4. Формы и строки языка

• Файлов форм *.rpt в каталоге данных — исторически до 500.
• Строковые значения языка форм (переменные, стек, временные строки) ограничены 255 символами — лишнее молча усекается, как в оригинальной реализации. От этого зависят, например, накопители с дедупликацией по [ps].
• Имена счетов в *-ссылках, $D/$K/$P, @-обращениях усекаются до 10 символов.

2.5. Пользователи, имена, пароли

• Имя и пароль пользователя — до 12 литер; лишние символы молча усекаются. Имя — латинские буквы и цифры, начинается с буквы, регистр не различается; пароль различает регистр.
• Новый сервер поддерживает до 1000 пользователей в файле _RIGHTS_.FBP. Лицензия нового сервера не ограничивает число имён (в прежних версиях серверы поставлялись на 2, 5, 10, 20 или 30 имён).
• Пределы описателей прав: до 80 форм в праве R, до 68 имён в правах J и D, до 15 ветвей в праве T.

2.6. Память сервера

Новый ФБП:Сервер — 64-разрядное приложение .NET; двухгигабайтный барьер 32-разрядных серверов снят. Ориентировочное потребление на большой боевой базе — порядка 2–2,5 ГБ. Понятия «контексты D и D'» и параметры их размера из командной строки старого сервера (-C/-U/-F/-X) в новом сервере отсутствуют — память управляется автоматически (см. главу 29).

2.7. Прочие пределы

2.8. Групповые (многострочные) операции

Многострочная операция оформляется в дереве видов операций ветвями { и }: все проводки между ними регистрируются как одна составная операция. Клиенты отображают такую операцию свёрнутой (одной записью) или развёрнутой — по опции «Операции свернуто».

3. ФБП:Сервер — установка и администрирование

Новый ФБП:Сервер (версия V01) — самостоятельная 64-разрядная реализация сервера платформы для Windows. Он работает со всеми существующими клиентами (CLWP, CLW32, CGI) и с существующими базами знаний без их изменения: форматы файлов данных, протокол обмена и язык форм сохранены.

3.1. Состав поставки и требования

• Fbp.Server.exe — сам сервер (консольное приложение, обычно работает как служба Windows).
• Fbp.Server.Manager.exe — Менеджер баз: графическая программа для регистрации баз, управления службами, наблюдения за состоянием и архивирования (см. п. 3.5).
• FbpServer.lic — файл лицензии (см. п. 3.3).

Требования: Windows 8.1 / 10 / 11 или Windows Server 2012 и новее, 64-разрядная версия. Для Windows Server 2012 необходим установленный пакет Visual C++ 2015–2022 Redistributable (x64). Программы самодостаточны — установка .NET на машине не требуется.

Ответ сервера на директиву V:

"Финансы без проблем" V01.01 Александр Пронин. Для Windows 8.1,10,11,Server 2012+

3.2. Установка и первый запуск

Установка сервера — это копирование каталога с программами на машину сервера. Для работы нужны два каталога:

1. Каталог данных (база знаний) — с файлами acnt.a3p, cas.rul, YYYYMM.f3p, *.rpt, _RIGHTS_.FBP и др. Если базы ещё нет, возьмите демонстрационную или боевую базу от прежнего сервера — новый сервер читает её напрямую.
2. Каталог обмена — общий каталог, доступный клиентам (историческое имя — _box_). Если каталог не существует, сервер создаст его сам при старте.

Пробный запуск из командной строки (консольный режим удобен для первой проверки):

Fbp.Server.exe <каталог_данных> <каталог_обмена>

Сервер загружает базу, строит баланс и начинает обслуживать каталог обмена. Остановка — Ctrl+C в консоли или директива W DOWN от пользователя с правом U (см. главу 7). Штатная эксплуатация — как служба Windows под управлением Менеджера баз.

3.3. Лицензирование

Лицензия — файл FbpServer.lic рядом с Fbp.Server.exe. Файл содержит код компьютера, имя владельца, ключ и электронную подпись; лицензия привязана к конкретной машине и не ограничивает число пользователей базы.

Код компьютера (16 шестнадцатеричных знаков) сервер сообщает при запуске без лицензии; по этому коду поставщик выдаёт ключ. Число лицензируемых имён пользователей, в отличие от прежних версий (серверы «на 2, 5, 10, 20, 30 имён»), не ограничивается — действует общий предел 1000 пользователей в файле прав.

3.4. Командная строка сервера

Fbp.Server <каталог_данных> <каталог_обмена> [ключи]

Коды завершения процесса сервера:

3.5. Менеджер баз

ФБП:Менеджер (Fbp.Server.Manager.exe) — постоянный инструмент администратора. Он хранит реестр баз (файл FbpManager.bases.json рядом с программой) и для каждой базы позволяет:

• установить и управлять службой Windows — установка, удаление, старт, остановка, перезапуск выполняются только через диспетчер служб (SCM); имя службы — FbpServer плюс необязательный суффикс, поэтому на одной машине может работать несколько баз;
• наблюдать состояние — по файлу heartbeat _STATUS_.FBP (см. п. 3.6): загрузка, обслуживание, пересчёт с указанием месяца и процента, память, число запросов, «лицо» сервера с подсветкой активности пользователей; двойной щелчок открывает отдельное окно активности базы;
• читать журнал запросов — встроенный просмотр хвоста журнала с поиском;
• архивировать базу — полный или инкрементный ZIP-архив по расписанию (дни и время) или немедленно, без остановки сервера; перед архивом менеджер дожидается завершения пересчёта и записи плана счетов; архивы никогда не удаляются автоматически;
• управлять гибернацией (V01.02) — см. п. 3.9.

Крестик в заголовке не закрывает менеджер, а сворачивает его в область уведомлений (трей): значок окрашивается в цвет суммарного состояния серверов (зелёный — работают; жёлтый — запуск или пересчёт; красный — проблема; серый — работающих нет), а расписания архивов исполняются и из трея. Полный выход — пункт «Выход из менеджера». На одном компьютере работает один экземпляр менеджера — повторный запуск просто поднимает уже открытое окно.

3.6. Журналы и контроль состояния

• Журнал запросов FbpServer-YYYY-MM-DD.log (в каталоге базы или по ключу --log, кодировка CP866): каждая обслуженная директива — время поступления, пользователь, длительность в миллисекундах, директива, ошибка, а при вводе новой операции — её уникальный код. Транспортные сбои (невозможность создать ответ, сорванное переименование и т.п.) также журналируются — у старого сервера они проходили молча.
• Heartbeat _STATUS_.FBP в каталоге базы (UTF-8, строки «ключ=значение», обновляется раз в 10 с, при пересчёте — каждые 0,5 с): состояние (loading/serving/stopping/down), аптайм, память, прогресс пересчёта, счётчики запросов и операций, признаки «план счетов изменён, но ещё не записан», счётчик итераций рабочего цикла и число необработанных запросов — по ним менеджер и внешние сторожа отличают живой сервер от зависшего.
• Защита от двойного запуска — файл _SRVNEW_.LCK в каталоге базы: второй сервер на той же базе завершится с кодом 3.

3.7. Сохранность данных и восстановление

• Отложенная запись плана счетов. acnt.a3p перезаписывается не при каждом изменении, а через 60 секунд после последнего изменения (при непрерывном потоке запросов — принудительно через 600 секунд), а также при штатной остановке. Запись всегда безопасная: временный файл → резервная копия → замена.
• Аварийный дамп. При аварийном завершении рабочего цикла (код 2) изменённый план счетов сохраняется в ACNT.EMG — основная база при этом не трогается; файл предназначен для ручного восстановления.
• Карантин запросов. Если ответ на запрос не удалось создать, файл запроса уходит в карантин <имя>.BAD и не теряется; сбой журналируется.
• Архивирование. Штатное средство — архивы менеджера (см. п. 3.5). Рекомендуется ежедневный инкрементный и периодический полный архив.

3.8. Пауза, перезагрузка, перекомпиляция форм

Управление работающим сервером — директивой W от пользователя с правом U (см. главу 7):

3.9. Гибернация и быстрый старт (V01.02)

Начиная с версии V01.02 сервер умеет «засыпать» и «просыпаться»:

• Ожидание старта (сон). С ключом --idle-exit-min N сервер, не получивший запросов N минут, штатно останавливается (heartbeat state=standby). Менеджер следит за каталогом обмена: как только в нём появляется запрос, служба автоматически запускается, и запрос обслуживается. Переходы в сон и пробуждения пишутся в журнал.
• Полный образ базы _BASEIMG_.FBP. При штатной остановке сервер записывает образ вычислительного состояния; при следующем старте валидный образ восстанавливается за секунды вместо полной холодной загрузки и пересчёта (на большой базе — примерно 6 секунд вместо 80). Если образ устарел или повреждён — выполняется обычный холодный старт, сервер не падает. Отключить образ можно ключом --no-base-image.
• Архивная пауза. Перед архивом менеджер может приостановить приём запросов (файл _ARCPAUSE_.FBP): сервер доделывает пересчёт, сохраняет план счетов и ждёт; по истечении срока пауза снимается сама.
• Смена суток. При смене календарного дня база автоматически перезагружается (как по W OFF); если с новой датой база не открывается, сервер остаётся на прежней дате и перепроверяет её раз в минуту.

3.10. Файл M_PLUS — сдвиг «текущего» месяца

Если в каталоге данных есть файл M_PLUS с числом N, сервер при старте считает «текущим» месяц, сдвинутый на N месяцев вперёд. Это удобно для прогонов «будущего» периода без перевода системных часов. Файл читается один раз при старте; переход через год не выполняется (сдвиг ограничен декабрём), а при наличии в каталоге журнала другого года сдвиг отменяется.

3.11. О переходе из года в год

Специальная «новогодняя» версия старого сервера (3.NY/4.NY с Новогодним Адаптером и подкаталогом обмена _ny_) в новую реализацию не перенесена. Переход из года в год выполняется традиционно: запись конечного состояния директивой Q, перенос журналов *.f3p и файлов состояния нового года, продолжение работы обычным сервером.

4. ФБП:Клиент — установка и работа

Эта глава описывает CLWP — клиентскую программу сетевой версии для Windows, написанную заново на .NET. Она полностью повторяет протокол обмена и поведение прежнего клиента CLW32, поэтому работает с тем же ФБП:Сервером и теми же отчётными формами; интерфейс и часть возможностей при этом современнее. Новшества по сравнению с CLW32 в тексте помечены пометкой НОВОЕ.

4.1. О программе и начало работы

«Финансы без проблем» работает по схеме «Сервер — Клиент»: ФБП:Сервер хранит журнал операций, дерево видов операций, счета и отчётные формы, выполняет все вычисления и следит за правами доступа; Клиент на рабочем месте показывает данные, принимает ввод и передаёт Серверу запросы (директивы) через общий сетевой каталог обмена. Устройство обмена подробно описано в главе «Архитектура и обмен», сам протокол — в главе «Протокол обмена».

Установка на рабочем месте сводится к копированию каталога с исполняемым файлом: дистрибутив может лежать на сервере, тогда достаточно скопировать каталог к себе (например, в C:\CLW) и запустить программу. Рядом с CLWP.EXE лежит то, что общее для всех баз: файл помощи CLWP_help.html и отчётные формы (*.RPT), которые администратор кладёт в поставку для всех.

Основные возможности клиента:

• журнал операций: просмотр, ввод, правка, удаление, поиск и выборка;
• ввод операций через дерево видов операций с ветвями-вопросами и выбором счетов;
• отчётные формы Сервера (оборотный баланс и любые формы из списка) с автообновлением;
• собственные формы на клиенте — локальные .RPT-файлы;
• встроенный редактор форм с компиляцией и выполнением на Сервере;
• первичные документы, проводки, отчётный период;
• печать, запись в текстовый файл, экспорт в Excel;
• калькулятор с обращением к оборотам счетов и расчётом НДС;
• кнопки-макросы Alt+F1…Alt+F9;
• избранные и недавние команды, поиск команды по названию (Ctrl+Q).

4.2. Программа и рабочий каталог базы (НОВОЕ)

Клиент отделяет саму программу от данных базы — так же, как это делал CLW32. Исполняемый файл может быть один на всех и лежать в общем каталоге, а у каждой базы — свой рабочий каталог. Тогда обновление программы сводится к замене одного CLWP.EXE, и ничьи настройки при этом не теряются.

В рабочем каталоге базы хранятся:

• CL.DIR — путь к каталогу обмена с Сервером;
• CLWP.настройки.xml — все настройки клиента для этой базы: опции, определения клавиш, аргументы и фильтры, отчётный период, шрифты, поля печати, размеры, место на экране и режим окон;
• отчётные формы этой базы (*.RPT) — см. п. 4.13;
• каталог первичных документов (TXA), если включено их хранение.

Рабочий каталог задаётся в свойствах ярлыка Windows:

Чтобы работать с несколькими базами, делают несколько ярлыков на один и тот же CLWP.EXE, у каждого — своя «Рабочая папка». Копии клиента можно держать открытыми одновременно: у каждой свой отчётный период, свои шрифты и размеры окон, и они друг другу не мешают.

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

4.3. Подключение к Серверу

При запуске программа показывает заставку и открывает окно «Подключение к Серверу». Позже его можно вызвать пунктом меню «Вход» — это вход под другим именем без перезапуска программы.

Кнопка «Регистрация» отправляет Серверу запрос на вход. Если имя или пароль неверны, в строке состояния появится сообщение об ошибке — ответы Сервера об ошибках начинаются с E-. Кнопка «Отмена» закрывает окно без подключения.

Стартовые запросы. Сразу после входа клиент выполняет форму USERS, если она есть на Сервере. Эта форма может содержать управляющие строки N:, которые автоматически откроют нужные формы или запустят внешние программы, — так администратор настраивает «рабочий стол» пользователя, например чтобы при входе сразу открывался оборотный баланс. Синтаксис управляющих строк — в главе «Управляющие строки N:».

4.4. Регистрация программы (НОВОЕ)

Не путайте с кнопкой «Регистрация» в окне подключения — та отправляет Серверу имя и пароль. Здесь речь о регистрации самой программы на вашем компьютере. Незарегистрированная копия работает 20 минут, после чего просит регистрационный ключ. Окно открывается из меню «Помощь → Регистрация программы…» и появляется само, когда время работы вышло.

В регистрации два понятия, и путать их не надо:

Как зарегистрироваться. Откройте окно регистрации: вверху — номер этого компьютера, ниже — имя компьютера в сети; кнопка «Копировать» кладёт обе строки в буфер обмена для письма разработчику. Полученный ключ положите в нижнее поле одним из трёх способов: кнопка «Из буфера», кнопка «Из файла…» или просто перетащите присланный файл мышью в окно. Набирать руками не нужно — лишние пробелы, переносы строк и дефисы программа отбрасывает сама. Нажмите «Зарегистрировать»; перезапускать программу не требуется.

Что стоит знать про ключ:

• Он привязан к компьютеру — на другой машине не подойдёт («Этот ключ выдан для другого компьютера»).
• Замена железа не страшна — номер не меняется от замены памяти, видеокарты, диска, док-станции или переименования компьютера. Меняется он только при переустановке Windows или форматировании системного диска — тогда нужен новый ключ.
• Регистрация одна на компьютер — сколько бы баз вы ни открывали с этой машины, регистрироваться нужно один раз; ключ хранится не в настройках базы, а отдельно.
• У каждого пользователя Windows свой ввод — под разными учётными записями Windows ключ вводится заново; номер компьютера одинаковый, поэтому годится тот же самый ключ — просто вставьте его ещё раз.
• Сохраните ключ — он пригодится после переустановки программы или при входе под другой учётной записью.

Ключ проверяется на самом компьютере, без обращения к Серверу и без интернета. Ограничение времени никак не связано с правами пользователя на Сервере: это разные вещи.

4.5. Главное окно

Главное окно — контейнер, внутри которого открываются все рабочие окна (журнал операций, формы, редактор). Сверху — меню и панель инструментов, снизу — строка состояния. По умолчанию главное окно открывается развёрнутым во весь экран, и дочерние окна тоже разворачиваются на всю его площадь; режим переключается в меню «Окно → Во весь экран».

Окно открывается там, где его закрыли (НОВОЕ). Размер главного окна, его место на экране и признак «развёрнуто во весь экран» запоминаются при выходе и восстанавливаются при следующем запуске — вместе с монитором: если работали на втором экране, там окно и откроется. Если того монитора больше нет (сменилось разрешение, настройки базы лежат на сетевом диске, с ней работают с разных машин), окно не потеряется за краем: клиент откроет его на имеющемся мониторе и подгонит под размер.

В заголовке главного окна — название программы, база, имя пользователя и год базы (год задаётся пунктом «Опции → Год базы…», см. п. 4.17). Имя развёрнутого рабочего окна в заголовок не дописывается: эти данные видны в самом окне.

Строка состояния копируется (НОВОЕ). В нижней строке рабочего окна показаны запрос к Серверу и имя файла ответа. Текст выделяется мышью и копируется в буфер обмена (Ctrl+C, Ctrl+A — выделить всё, либо меню по правой кнопке) — удобно, когда нужно открыть или переслать файл ответа Сервера. Пока курсор в этой строке, Пробел не пересчитывает форму; Esc возвращает курсор в список (второй Esc закрывает окно).

Меню. Пункты «Документы» перечислены в порядке горячих клавиш Alt+F2…Alt+F9:

Остальные пункты меню: Вход — окно подключения к Серверу; Избранное — часто используемые команды (п. 4.21); Опции — настройки (п. 4.17); Редактор — работа с текстом форм (п. 4.15); Окно — расположение дочерних окон (во весь экран, каскад, плитка вертикальная/горизонтальная) и список открытых окон; Помощь — содержание (F1), таблица горячих клавиш, сведения о версии, регистрация программы; Выход — завершение работы.

Список окон с крестиками (НОВОЕ). В меню «Окно» первые девять строк списка выбираются цифрами 1…9, галочка стоит у активного окна. У правого края каждой строки стоит крестик ×: щелчок по нему закрывает это окно, не переключаясь на него, и меню остаётся открытым — так закрывают несколько ненужных окон подряд.

Значки окон (НОВОЕ). Каждое рабочее окно имеет собственный цветной значок, по которому его легко узнать в списке окон и на панели задач: Ж — журнал операций, О — отчётная форма, С — выбор счёта, Д — дерево видов операций, Р — редактор форм, Ф — формы на клиенте, З — список запросов, = — калькулятор. Клавиша Esc закрывает окна в обратном порядке их открытия — как «шаг назад».

На панели инструментов — кнопки быстрого доступа: Операции, поля начала и конца отчётного периода, Формы, Об/Бал, Период, Запросы; правее — кнопки-макросы, назначенные пользователем (см. «Определения клавиш» в п. 4.17).

4.6. Отчётный период

Отчётный период определяет, за какой промежуток показываются журнал операций и отчётные формы. Текущий период виден в двух полях панели инструментов и меняется пунктом «Документы → Отчетный Период» (Ctrl+O) или кнопкой Период. Окно сделано так же, как в старом клиенте; в нём три панели:

• Месяц — двенадцать месяцев года базы. Слева от названия — число операций в месяце и отметка «в этом месяце есть данные»; справа скобка показывает, какие месяцы попали в период и какими числами он начинается и заканчивается;
• Число — календарь показанного месяца; как и в старом клиенте, он вертикальный: недели идут столбцами, строки — дни недели (Пн…Вс);
• Пользователи — чьи операции показывать; несколько выбираются мышью с Ctrl и Shift, флажок «Операции всех» берёт сразу всех.

Под календарём — цветная плашка «Начало периода» / «Конец периода»: флаг, который говорит, какой конец периода задаст следующий выбранный день. После каждого выбора флаг сам перекидывается на другой конец, поэтому два нажатия Enter задают весь период. Ниже показаны сами даты периода и общее число операций в нём. Клавиши F4 и F5 делают подсвеченный день началом и концом периода соответственно.

Период всегда лежит внутри года базы — календарь не даёт выйти за 1 января и 31 декабря этого года. Изменения применяются только кнопкой «Подтвердить»; «Отменить» и Esc закрывают окно, оставив прежний период. Выбранный период запоминается и восстанавливается при следующем запуске клиента (НОВОЕ).

Быстрые периоды (НОВОЕ) — четыре кнопки внизу окна ставят период одним нажатием: «Месяц» — показанный месяц целиком, «Квартал» — квартал показанного месяца, «Год» — весь год базы, «С начала года» — с 1 января по конец показанного месяца.

Флажок «Операции свернуто» в этом же окне (как и в старом клиенте) управляет тем, показывать ли составные операции журнала свёрнутыми; та же настройка есть в меню «Опции».

4.7. Журнал операций

Журнал открывается пунктом «Документы → Операции», кнопкой Операции или клавишей Alt+F2. В окне — таблица операций за отчётный период; внизу строка состояния с числом строк и служебной информацией; левая её часть (запрос и имя файла ответа) копируется — Ctrl+C.

Если другой пользователь ввёл или изменил операцию, в правой части строки состояния появляется «Возможно устарело». Перечитать журнал — Пробел; при включённом автообновлении он перечитается сам, как только вы переключитесь в это окно.

Колонки (НОВОЕ). Ширина каждой колонки подбирается по самому длинному значению в ней — суммы, даты, коды и номера видны целиком. Переносится по строкам только колонка «Текст операции» (вместе с комментарием) — она занимает всю оставшуюся ширину. Любую колонку можно расширить или сузить мышью за границу заголовка; заданная вручную ширина сохраняется при обновлении журнала.

Клавиши журнала: F7 — ввести операцию, Enter — правка (перезапись), Del или F8 — удалить с подтверждением, F4 — первичный документ, F6 — проводки, F9 — курсор в строку поиска, Пробел — обновить, Esc — закрыть окно. Полный список — в п. 4.24.

Поиск и выборка (НОВОЕ). Модальный диалог фильтра старого клиента заменён встроенной панелью поиска в верхней части окна — такой же, как в отчётных формах. Панель видна всегда; F9 лишь переводит курсор в первую строку поиска. Панель содержит:

• две строки поиска и кнопку связки между ними — И / ИЛИ (щелчок переключает): при И подходят строки с обоими фрагментами, при ИЛИ — хотя бы с одним; заполнена одна строка — связка не действует;
• флажок «Учитывать регистр (Aa)»;
• переключатель «Поиск» / «Выборка»: в режиме поиска курсор переходит к следующей подходящей строке, в режиме выборки неподходящие строки скрываются;
• кнопки 🔍 (искать дальше) и ✕ (очистить и показать всё).

Отбор идёт по всем колонкам и выполняется на клиенте — Сервер не опрашивается, поэтому поиск мгновенный; результат показывается в строке состояния. В режиме «Поиск» строка ищется прямо по ходу набора; дальше Ctrl+↓ / Ctrl+↑ ходят по совпадениям вперёд и назад (работают и из таблицы, и из строки поиска, дойдя до края — продолжают с другого конца), Enter в строке поиска заканчивает поиск, оставляя курсор на найденной операции. Ctrl+Del очищает обе строки поиска, не отрываясь от набора, — работает только в строке поиска: в таблице Del удаляет операцию.

Свёрнутый показ. Опция «Операции свернуто» объединяет строки одной составной операции в одну запись — журнал становится компактнее. Разворачивать и сворачивать можно по ходу работы.

4.8. Ввод и правка операции

Ввод начинается клавишей F7 в журнале операций. Клиент показывает дерево видов операций, полученное с Сервера; видны только ветви, на которые у вас есть права. Ход ввода:

1. Выбор вида операции в дереве — Enter или двойной щелчок, отказ — Esc.
2. Ответы на вопросы: Сервер по очереди задаёт вопросы ветви — дата, сумма, текстовые пояснения, выбор счёта или субсчёта. Ответ подтверждается Enter, отказ от ввода — Esc.
3. Выбор счёта: если вопрос требует счёта, открывается окно со списком доступных счетов и субсчетов; выбор — Enter. При перезаписи операции курсор сразу стоит на прежнем ответе.
4. Запись: после последнего вопроса Сервер формирует операцию и её проводки, журнал обновляется.

Поиск-выборка в окне выбора счёта (НОВОЕ). Панель поиска есть и в окне выбора счёта, но работает только выборкой: набранный текст сразу оставляет подходящие строки. Поэтому Enter всегда означает «взять строку в операцию» — даже из строки поиска берётся первая отобранная строка. Окна вопросов и списков счетов встают правее дерева и ниже строки набираемой операции, не разворачиваясь во весь экран: до самой записи видно и дерево, и то, что уже набрано. После ввода даты и положения операции в дне курсор сам переходит в дерево — мышь не нужна.

Дерево помнит путь предыдущей операции. Однотипные операции идут подряд, поэтому после записи клиент запоминает путь по дереву и при вводе следующей операции подсвечивает на каждом уровне ту ветвь, что была в прошлый раз, — вы просто нажимаете Enter, пока путь тот же. Свернули в сторону — дальше курсор встаёт на первую ветвь уровня, как обычно. Ответы на вопросы при этом не подставляются: поля всегда пустые. Ответы ограничены длиной, заданной в дереве (в типовых конфигурациях — до 11 символов для коротких ответов); слишком длинный ответ Сервер обрежет или отклонит.

Правка операции. Enter на строке журнала запускает перезапись: Сервер задаёт те же вопросы заново, подставляя прежние ответы; изменённая операция заменяет старую вместе со всеми проводками.

Удаление. Del или F8 удаляет операцию — с запросом подтверждения, в котором показано, что именно будет удалено. Составная (групповая) операция удаляется целиком.

Многострочный ввод. Некоторые виды операций требуют ввода таблицы (например, списка позиций документа). Для них открывается многострочная форма: Enter — подтвердить строку, F2 — сохранить введённое, Esc — отказаться.

4.9. Виды операций

Дерево видов операций открывается пунктом «Документы → Виды операций» или клавишей Alt+F6. Это справочник всех хозяйственных операций, настроенный администратором на Сервере. Ветви дерева бывают:

• обычными — конечный вид операции, который можно ввести;
• ветвями-вопросами — задают вопрос и ветвятся в зависимости от ответа;
• ветвями-циклами — повторяют ввод, пока пользователь не откажется.

Кроме выбора операции, дерево служит справочником: по нему видно, какие операции предусмотрены в учёте предприятия и какие вопросы они задают. Некоторым ветвям Сервер может назначить горячие клавиши — тогда операция вводится одним нажатием, минуя дерево.

4.10. Проводки и первичные документы

Проводки. F6 на строке журнала показывает проводки, сформированные операцией: дебет, кредит, сумма, пояснение. Проводки формирует Сервер по описанию вида операции — вручную они не редактируются, изменить их можно только изменив саму операцию.

Первичные документы. F4 показывает первичный документ операции — накладную, ордер, счёт, — если он предусмотрен видом операции. Документ приходит с Сервера текстом и открывается в отдельном окне; его можно напечатать или записать в файл.

Если включена опция «Хранить первичные документы», полученные документы сохраняются в каталоге TXA. Это ускоряет повторный показ, но сохранённый документ не обновляется автоматически: если операция изменилась, документ нужно запросить заново.

4.11. Отчётные формы

Отчётная форма — основной инструмент анализа: оборотный баланс, ведомости, карточки счетов, любые отчёты, написанные для вашего предприятия. Формы хранятся на Сервере; список открывается пунктом «Документы → Формы на Сервере» (Alt+F4) или кнопкой Формы; оборотный баланс вызывается сразу — Alt+F3 или кнопка Об/Бал. Форму выбирают в списке и запускают Enter: Сервер вычисляет её за текущий отчётный период и возвращает готовый текст, который клиент показывает моноширинным шрифтом в отдельном окне. Внизу окна — строка состояния: запрос, имя файла ответа Сервера, время выполнения и число строк; левая часть строки копируется (Ctrl+C, Ctrl+A — выделить всю).

Курсор при открытии (НОВОЕ). Сразу после открытия формы курсор стоит в тексте формы, на первой значащей строке: первой строке, у которой сразу за рамкой стоит значащий знак, а не пробел (линии рамки и шапка колонок пропускаются) — в таблице это первая строка данных. Так можно сразу листать строки и выполнять действия активной строки, ничего не нажимая дополнительно. В строку поиска курсор переводится клавишей Tab: первое нажатие — первая строка, второе — вторая, дальше обход кнопок панели; Shift+Tab — назад, Esc из строки поиска — возврат в текст формы.

Поиск в форме. Над текстом формы — та же панель поиска, что в журнале операций: две строки, связка И/ИЛИ, учёт регистра, переключатель «Поиск»/«Выборка». В режиме «Поиск» строка ищется по ходу набора; Ctrl+↓ / Ctrl+↑ — следующее и предыдущее совпадение, Enter в строке поиска заканчивает поиск, оставляя курсор на найденной строке (следующий Enter выполняет её действие N:ENTER:), Ctrl+Del очищает строки поиска. Каждая форма открывается с пустой строкой поиска: отбор относится к той форме, в которой его набрали, — перейдя по кнопкам формы в другую, вы увидите её целиком. Набранное раньше не пропадает — оно в выпадающем списке строки поиска; пересчёт формы (Пробел, автообновление) строку поиска сохраняет.

Закреплённая первая строка (НОВОЕ). Если первая строка формы начинается с пробела, она считается шапкой и закрепляется вверху окна: при прокрутке остаётся на месте, как закреплённая строка в Excel (закрепляется ровно одна строка). Такая строка выделена мягкой жёлтой плашкой.

Подсказка формы (НОВОЕ). Последняя строка формы, начинающаяся с символа ■ (Alt+254), в текст не попадает — это подсказка автора формы, и клиент печатает её внизу окна на той же мягкой жёлтой плашке. Плашка появляется, только когда подсказка есть.

Отбор по значению ячейки (НОВОЕ). Ctrl + щелчок левой кнопкой по ячейке подставляет её значение в первую строку поиска, и форма тут же отбирается по нему; границы ячейки клиент определяет сам — по линиям рамки и по двойным пробелам. Режим панели при этом не меняется; чтобы снять отбор, очистите строку поиска. То же без мыши — Ctrl+Enter в тексте формы: клиент берёт текущую строку, а ячейку спрашивает маленьким списком (стрелки и Enter; одна ячейка в строке — список не появляется).

Меню строки (НОВОЕ). Правая кнопка мыши в тексте формы (или Shift+F10 с клавиатуры) открывает меню: Закрыть форму (прежнее действие правой кнопки; файл ответа Сервера удаляется), Отбор по значению ячейки, Копировать значение ячейки (то же делает Ctrl+C в тексте формы), Копировать ссылку на форму (Ctrl+Shift+C, см. п. 4.22). Пункты «по ячейке», вызванные с клавиатуры, спрашивают ячейку тем же списком, что и Ctrl+Enter.

Масштаб (НОВОЕ). Ctrl + колесо мыши увеличивает и уменьшает шрифт формы от 6 до 24 пунктов. Меняется только это окно и только до его закрытия — настройки оформления и другие окна не затрагиваются; общий шрифт задаётся в «Опции → Оформление…».

Автообновление. Данные на Сервере меняются другими пользователями, и открытая форма может устареть: клиент показывает в полосе состояния жёлтую пометку «Возможно устарело». Поведение задаётся в «Опции → Автообновление»: Нет — только предупреждение, пересчёт по Пробел; Да — форма пересчитывается сама. В режиме «Да» сама пересчитывается только форма на переднем плане (НОВОЕ); остальные окна получают пометку и пересчитываются в момент переключения на них. Пометка «Период изменен» (смена отчётного периода) снимается только вручную — Пробел. Всё это относится и к журналу операций; свою собственную запись, правку или удаление журнал подхватывает сразу, без предупреждения.

Числа. Две опции влияют на вид чисел во всех формах: «Числа с запятыми» (разделение разрядов) и «Числа с копейками» (два знака после запятой). Обе передаются Серверу вместе с запросом, поэтому пересчёт формы после их изменения обязателен.

Действия строк формы. Форма может не только показывать данные, но и действовать: реагировать на Enter, клавиши F1…F9, Shift+F1…Shift+F9, открывать другие формы и запускать внешние программы. Всё это описывается управляющими строками N: в тексте формы — их синтаксис и возможности разобраны в отдельной главе «Управляющие строки N:».

4.12. Аргументы и фильтры

Это два разных механизма сужения отчёта, и различать их важно.

• Аргумент — грубый отбор на Сервере. Передаётся Серверу вместе с запросом формы и участвует в вычислении: Сервер обрабатывает только подходящие операции. Быстро, годится для больших объёмов — например, «только склад №2».
• Фильтр — тонкий отбор на клиенте. Применяется к уже полученному тексту формы: остаются строки, содержащие заданные фрагменты. Сервер при этом считает всё, поэтому на больших отчётах фильтр медленнее аргумента, зато отбирает по любому месту строки.

Наборы задаются в «Опции → Аргументы и фильтры…»: для каждой формы можно описать до восьми аргументов и до восьми фильтров, а затем переключать их прямо в открытой форме клавишами Shift+F1…Shift+F9.

4.13. Формы на клиенте

Кроме форм Сервера, можно держать собственные формы в файлах .RPT. Список открывается пунктом «Документы → Формы на Клиенте» (Alt+F7); рядом с именем файла показывается его первая строка — обычно название отчёта.

Формы этой базы лежат в её рабочем каталоге (п. 4.2), рядом с CL.DIR и настройками — у каждой базы свой набор. В списке показываются ещё и формы из каталога программы (НОВОЕ): администратор кладёт туда формы, общие для всех баз; при совпадении имён побеждает форма своей базы.

Локальная форма выполняется Сервером так же, как серверная: текст скрипта передаётся Серверу, Сервер считает и возвращает готовый отчёт. Разница только в месте хранения — файл лежит у вас, поэтому его можно свободно править, не имея прав на изменение форм Сервера.

4.14. Список запросов

Окно «Запросы к Серверу» (Alt+F9, кнопка Запросы) позволяет отправить Серверу директиву напрямую — это инструмент опытного пользователя и администратора: с его помощью проверяют формы, права, отдельные значения. Строка запроса — текст директивы; кнопка «Отправить» или Enter выполняет её; стрелки вверх и вниз перебирают стопку ранее отправленных запросов. Запрос, начинающийся с >, запускает внешнюю программу, а не отправляется Серверу.

Список ведёт себя как журнал всех запросов (НОВОЕ). Пока окно открыто, в список попадает каждый запрос клиента к Серверу, а не только набранный здесь: открытие формы, журнал операций, кнопки формы, запросы строк N:. Любой запрос можно выбрать стрелками и повторить Enter — например, разобраться, какой директивой открылась форма, или повторить её с другими аргументами. Список держит последние 50 строк (самая старая уходит сверху); подряд идущие одинаковые запросы не повторяются. Окно разворачивается по тем же правилам, что и отчётная форма, и запоминает свой размер.

4.15. Редактор форм

Встроенный редактор служит для написания и отладки отчётных форм. Он открывается из меню «Редактор», клавишей F4 в списке форм на клиенте, переносом открытой формы (Ctrl+F4), а также клавишей Ctrl+F7 — из окна редактора и из любого другого окна клиента.

Несколько файлов одновременно (НОВОЕ). Каждый открытый файл получает своё окно редактора, поэтому строки удобно переносить из одного файла в другой через буфер обмена (Ctrl+C / Ctrl+V). Вверху каждого окна редактора — вкладки всех открытых файлов: текущий выделен жирным, щелчок по вкладке переключает на другой файл, звёздочка у имени — файл изменён и не записан. Окна видны и в меню «Окно»; там же их можно расставить рядом. Если файл уже открыт, повторное открытие просто выводит его окно вперёд — две копии одного файла затирали бы правки друг друга при записи. Пустое окно, открытое пунктом «Редактор → Новый», занимается первым открываемым файлом.

Подсветка синтаксиса. Цветом различаются (НОВОЕ): строки-комментарии (начинаются со звёздочки), управляющие строки N:, ключевые слова языка форм (if, for, goto, print и прочие), обозначения функций в квадратных скобках (включая подпрограммы вида [:RTV…), текст в апострофах, вставки значений ^имя, фигурные скобки и подстановки ~N, строки вывода в файл >FILE. Подсветку можно отключить пунктом «Редактор → Синтаксис», цвета настраиваются в «Опции → Оформление…». Парные скобки (НОВОЕ): когда курсор стоит у круглой или квадратной скобки, она и её пара подсвечиваются фоном.

Тема и номера строк (НОВОЕ). Кнопка «Тема» внизу окна (или Ctrl+T) переключает светлое и тёмное оформление редактора; у тёмной темы свой набор цветов. Кнопка «№ строк» показывает или прячет полосу с номерами строк слева. Выбор запоминается и восстанавливается при следующем открытии редактора.

Позиция курсора и переход к строке (НОВОЕ). Слева в строке состояния жирным показано, где стоит курсор: «Стр 12 : Кол 5» — строка и колонка (обе считаются с единицы). Для перехода к строке держите Alt и наберите номер строки цифрами верхнего ряда клавиатуры, затем отпустите Alt — курсор встанет в начало этой строки; пока номер набирается, в строке состояния видно «Перейти к строке 12…». Если строка уже на экране, окно не сдвигается; если нет — прокручивается так, чтобы она стала пятой сверху. Номер больше числа строк ведёт на последнюю. Цифры цифрового блока с Alt по-прежнему набирают символы (Alt+250 — ·, Alt+254 — ■).

Отмена и возврат правок (НОВОЕ). Ctrl+Z отменяет последнюю правку, Ctrl+Y (или Ctrl+Shift+Z) возвращает отменённое. Отменяются только правки текста — набор, удаление, вставка, линии, символы F4/F5; подсветка синтаксиса в историю не попадает. Набранное подряд, без пауз, отменяется одним нажатием. История начинается заново при открытии файла, смене темы (Ctrl+T) и включении подсветки.

Цикл отладки формы: написать или открыть текст → F6 (компиляция: Серверу уходит запрос W FORM, его ответ открывается отчётной формой; изменённый текст перед этим сам записывается в файл) → исправить ошибки, на которые указал Сервер, и снова F6 → F8 (выполнение, проверить результат в открывшемся окне) → F2 (сохранить готовую форму в файл .RPT).

4.16. Печать, запись в файл, экспорт в Excel

Печать. «Документы → Печать» (Alt+F5) печатает содержимое активного окна — журнала операций, отчётной формы или первичного документа — сразу, без единого диалога: принтер, число комплектов и поля берутся из настроек, а ориентация листа и размер шрифта подбираются по ширине формы. Плашка в углу сообщает, на какой принтер ушёл документ.

Когда для одного документа нужны другие параметры — «Документы → Печать с параметрами…» (Ctrl+Alt+F5, НОВОЕ): один диалог, где сразу принтер, комплекты, ориентация, шрифт, поля и кнопки «Печать» и «Просмотр». Выбранное запоминается и становится умолчанием быстрой печати; те же параметры задаются заранее в «Опции → Печать…». Предлагаются только равноширинные шрифты — колонки формы держатся на одинаковой ширине знака. В окне предпросмотра F5 или Enter печатают, Esc закрывает.

Запись в файл. «Документы → Запись в файл» (Alt+F8) сохраняет содержимое активного окна в текстовый файл; имя предлагается по умолчанию, каталог — любой. Отчётные формы записываются строка в строку, журнал операций — с разбивкой длинных строк.

Экспорт в Excel (НОВОЕ). «Документы → Экспорт в Excel» (Ctrl+E) выгружает таблицу активного окна в книгу Excel (xlsx) с сохранением колонок — в отличие от записи в текстовый файл, числа остаются числами и пригодны для дальнейших расчётов.

4.17. Опции

Все настройки собраны в меню «Опции» и сохраняются между сеансами.

• Время ожидания ответа — сколько клиент ждёт ответа Сервера, прежде чем счесть запрос затянувшимся: от 30 секунд до 5 минут либо «Неограниченно» (фактически 6 минут — столько же ждал старый клиент). Увеличьте значение при медленной сети или тяжёлых отчётах. Что происходит по истечении — см. п. 4.18.
• Автообновление — Нет: формы только предупреждают об устаревании; Да: пересчитывается форма на переднем плане, фоновые — при переключении на них (п. 4.11).
• Числа с запятыми / Числа с копейками — формат чисел во всех отчётах: разделение разрядов и показ копеек; передаются Серверу с запросом.
• Хранить первичные документы — сохранять документы в каталоге TXA; ускоряет повторный показ, но копия не обновляется автоматически (п. 4.10).
• Операции свернуто — показывать составные операции одной строкой в журнале.
• Оформление… — шрифты и цвета журнала операций, отчётных форм и редактора, цвета подсветки синтаксиса и служебной информации. В старом клиенте это были три отдельных пункта; здесь они объединены в один диалог, а размеры и положение окон запоминаются автоматически.
• Тема (НОВОЕ) — оформление всего клиента: семь градаций от самой светлой к самой тёмной («Светлая — мягкая», «Светлая — обычная», «Светлая — системная», «Тёмная — мягкая», «Тёмная — обычная», «Тёмная — глубокая», «Тёмная — ночная»), отличающиеся только контрастом. Тема применяется ко всем окнам сразу, перезапуск не нужен; у каждой базы свой файл настроек, поэтому темой удобно различать базы.
• Печать… — принтер, число комплектов, ориентация, шрифт печати (равноширинный, с кеглем) и поля — всё, чем печать пользуется по Alt+F5.
• Определения клавиш… — кнопки-макросы Alt+F1…Alt+F9: для каждой задаются название (до 20 символов, оно появится на панели инструментов) и командная строка (до 41 символа — любая директива Сервера).
• Аргументы и фильтры… — наборы аргументов и фильтров по формам (п. 4.12).
• Год базы… (НОВОЕ) — год, к которому относятся данные на Сервере; от него зависят год отчётного периода, границы календаря и надпись в заголовке главного окна. Год задаётся вручную, потому что в протоколе ФБП года нет: период и директивы ввода оперируют только месяцем и днём, а на запрос текущей даты Сервер отвечает системным годом своей машины. При входе подставляется год, названный Сервером; заданное вами значение запоминается отдельно для каждого каталога обмена. На Сервер год не передаётся — он влияет только на то, что вы видите в клиенте.
• Калькулятор — открывает окно калькулятора (Ctrl+F3).

4.18. Долгий запрос к Серверу (НОВОЕ)

Тяжёлый отчёт, занятый Сервер или медленная сеть — и клиент ждёт ответа. В старом клиенте окно в это время просто замирало, отменить запрос было нельзя. Теперь ожидание видно и им можно управлять.

Если ответ не пришёл за две секунды, в правом нижнем углу главного окна появляется плашка «Запрос к Серверу»: текст запроса, бегущая полоса и счётчик секунд. Плашка не забирает фокус и ничего не блокирует — окна клиента остаются живыми, их можно двигать и листать. При коротком ответе плашка не появляется вовсе.

Кнопка «Прервать» отказывается от ожидания: если Сервер ещё не успел забрать файл запроса, запрос отменяется полностью; если уже забрал — ответ придёт «в пустоту», и клиент уберёт его сам при следующем обращении. Сообщений об ошибке при этом нет. Окно, которое только открывалось этим запросом, просто закроется; уже открытые окна останутся в прежнем виде.

Когда истекает время, заданное в «Опции → Время ожидания ответа», полоса замирает, счётчик становится красным и рядом появляется кнопка «Ждать ещё» — она добавляет столько же времени. Сам по себе клиент запрос не снимает: решение всегда за вами. Обе кнопки работают с клавиатуры из любого окна, пока плашка видна: Esc — «Прервать», Enter — «Ждать ещё».

4.19. Калькулятор

Калькулятор вызывается Ctrl+F3 или пунктом «Опции → Калькулятор». Окно немодальное (НОВОЕ): его можно оставить открытым и продолжать работать с журналом и формами. Возможности:

• обычные арифметические выражения со скобками;
• обращение к оборотам счетов — значение запрашивается у Сервера и подставляется в выражение;
• расчёт НДС — выделение и начисление;
• история вычислений; результат предыдущего доступен как «итог» / ans;
• Enter — вычислить, F10 — перенести результат в поле ввода того окна, из которого был вызван калькулятор, Esc — закрыть.

4.20. Нейросеть GigaChat (НОВОЕ)

Меню «Нейросети» → «GigaChat (Сбер)» открывает окно чата: можно спросить у нейросети то, что обычно ищут в интернете, — ставку налога, порядок заполнения отчёта, формулировку для договора, — не выходя из клиента. Окно немодальное и одно на сеанс: повторный выбор пункта меню показывает уже открытое окно, переписка не разрывается. Меню названо во множественном числе не случайно: сетей со временем будет несколько, пока подключена одна.

Как получить ключ. Доступ к GigaChat даёт не автор клиента, а Сбер, и у каждого пользователя ключ свой — он привязан к аккаунту и к личному счётчику токенов. Ключ бесплатный. Порядок: в окне чата нажмите «Настроить доступ…» и ссылку «Открыть личный кабинет developers.sber.ru»; войдите по Сбер ID и создайте проект «GigaChat API», выбрав тип доступа — для физического лица или для юридического лица / ИП; в проекте откройте «Настройки API → Авторизационные данные» и нажмите «Сгенерировать новый Client Secret»; скопируйте строку «Ключ авторизации» в поле окна «Настроить доступ…», выберите там же тот же тип доступа и нажмите «Сохранить».

Ключ и тип доступа хранятся в файле настроек рабочего каталога базы (CLWP.настройки.xml, п. 4.2); полный путь показан в окне настройки. Работаете с несколькими базами — ключ придётся вставить в каждую.

Как пользоваться. Вопрос набирается в поле внизу, Enter — отправить; пока идёт ответ, поле ввода недоступно. Переписка ведётся с памятью: к каждому новому вопросу клиент прикладывает предыдущие, поэтому можно уточнять. История сохраняется в рабочем каталоге базы в файле CLWP.ЧатИИ.История.xml и восстанавливается при следующем открытии окна. Кнопка «Очистить переписку» стирает всё — и содержимое окна, и файл на диске (с подтверждением; восстановить очищенное нельзя). F1 из окна чата открывает раздел помощи о чате.

4.21. Избранное и недавние команды (НОВОЕ)

Чтобы не набирать одни и те же запросы изо дня в день, в главном меню есть пункт «Избранное» — в нём три части: свои сохранённые команды, подменю «Недавние (Список Запросов)» и служебные пункты. Списки хранятся в профиле Windows и привязаны к имени пользователя: за одним компьютером каждый видит только своё избранное.

Недавние. Клиент запоминает команды, запущенные вручную: набранные в окне «Список Запросов», вызванные кнопкой-макросом или Alt+Fn, выбранные из самого «Избранного». Служебные обращения форм к Серверу (кнопки формы, дозапросы, автообновление) в список не попадают. Помнится до 15 штук; последняя команда стоит первой, повторный запуск поднимает её наверх. Пункт «Очистить список» стирает недавние.

Избранное. «Добавить в избранное…» открывает окно с двумя полями: в поле Команда уже подставлена последняя выполненная команда, поле Название — подпись для меню (пустое — видна сама команда). «Настроить избранное…» показывает таблицу «Название / Команда»: строки редактируются прямо в ячейках, новая добавляется в пустой строке внизу, лишняя удаляется Del по заголовку строки; порядок строк — это порядок пунктов в меню.

Поиск команды. Пункт «Найти команду…» или Ctrl+Q открывают окно, где в одном списке собраны пункты главного меню, избранные и недавние команды. Набор текста сужает список: слова могут идти в любом порядке, регистр не важен («опер журн» найдёт «Документы → Журнал операций»). Стрелки двигают выбор, Enter выполняет, Esc закрывает.

4.22. Ссылки на формы (НОВОЕ)

Чтобы показать коллеге не картинку, а ту же самую форму, у любой отчётной формы можно взять ссылку и передать её — письмом, в сообщении, запиской. Ссылка — это строка запроса формы, та самая, что видна в строке состояния внизу окна; получатель может вставить её куда угодно — в окно «Список Запросов», в макрос Alt+Fn, в «Избранное», — и она везде сработает.

Копировать ссылку — Ctrl+Shift+C в открытой форме, либо правая кнопка мыши → «Копировать ссылку на форму», либо меню «Документы → Копировать ссылку на форму». Строка кладётся в буфер обмена, внизу окна на пару секунд появляется подтверждение. Обычное Ctrl+C под ссылку не занято: оно по-прежнему копирует выделенное в строке состояния и в полях ввода.

Открыть по ссылке — Ctrl+Shift+V или «Документы → Открыть по ссылке…»: окно с одним полем, куда уже подставлено содержимое буфера обмена; Enter — выполнить, Esc — отказаться. Если ссылка пришла письмом и склеилась с подписью, берётся первая непустая строка. Строка выполняется тем же путём, что команды избранного и макросы, поэтому понимает не только отчётные формы (R), но и журнал операций (J), дерево видов операций (T), формы на клиенте (LW, FCL) и запуск внешней программы (>). Выполненная ссылка попадает в «Недавние».

4.23. Поля ввода: история, календарь, расчёт (НОВОЕ)

История ранее введённого. В вопросах отчётных форм и в строке запроса окна «Список Запросов» клиент запоминает введённое и подсказывает при наборе; полный список открывает F4 (или Ctrl+↓), выбранное подставляется в поле. История хранится между запусками и отдельно для каждого пользователя; на каждый вопрос помнится до 15 последних ответов, повтор поднимается наверх. Стереть накопленное можно пунктом «Опции → Забыть историю полей…» — он убирает только вашу историю.

Календарь у поля даты. Если вопрос спрашивает дату, рядом с полем появляется кнопка ▼, а F4 открывает календарь. Выбранная дата подставляется в том же виде, в каком поле её показывало: было две цифры года — будет две, было четыре — будет четыре. Enter в календаре берёт выделенный день, Esc закрывает без изменений. У прочих полей календаря нет: F4 там показывает историю.

Расчёт прямо в поле. В поле суммы или числа можно набрать не готовое число, а выражение — со сложением, вычитанием, умножением, делением и скобками. Первый Enter считает его и подставляет результат в поле, ничего никуда не отправляя; второй Enter подтверждает ответ. Запятую можно набирать вместо точки — считается одинаково, а в поле подставляется число с точкой, как ждёт Сервер. Деление на ноль клиент покажет сообщением и ответ не отправит. Выражения с функциями языка форм в поле не считаются — для них есть калькулятор (Ctrl+F3).

4.24. Горячие клавиши

Все клавиши клиента, разложенные по окнам.

Общие (работают в любом окне)

Пользовательский макрос, назначенный на Alt+Fn, отменяет встроенное действие этой клавиши.

Журнал операций

Отдельного окна поиска по F9, как в старом клиенте, больше нет: панель поиска постоянно находится вверху окна журнала операций.

Отчётный период

Отчётная форма

Поля ввода (вопросы операции и форм, строка запроса)

Окно выбора счёта (ввод операции)

Окно помощи

Редактор форм

Формы на клиенте

Список запросов

Калькулятор

Чат с нейросетью

Плашка «Запрос к Серверу»

4.25. Пользователи и права

Имена, пароли и права (T, R, J, D, P, E, U) заводит администратор на Сервере — см. главу «Права пользователей». Клиент лишь показывает то, что Сервер разрешает: недоступные ветви операций не видны в дереве, недоступные формы — в списке форм, а на запрещённое действие Сервер отвечает отказом E-…, который клиент показывает в строке состояния окна, в котором выполнялось действие.

4.26. Если что-то не работает

5. Имена, пароли и права пользователей

ФБП имеет собственную, не зависящую от сетевой ОС систему разделения прав. Список пользователей и их прав хранится в файле _RIGHTS_.FBP в каталоге данных сервера.

5.1. Файл _RIGHTS_.FBP

Если при первом старте сервера файла прав нет, он создаётся автоматически с единственным пользователем SUPERVISOR без пароля и с максимальными правами.

Формат файла — текстовый (допустимы строки и с CRLF, и с LF):

• строка имя_пользователя [пароль] — с начала строки, без ведущих пробелов; пароль отделяется от имени хотя бы одним пробелом;
• каждому праву предшествует хотя бы один пробел;
• имя — латинские буквы и цифры, начинается с буквы, регистр не различается; пароль — те же символы, регистр различается; предельная длина имени и пароля — 12 литер;
• всего — до 1000 пользователей.

5.2. Виды прав

Уточнения прав:

• Право T — список доступных ветвей дерева; разделитель и ограничитель — знак · (код 250, Alt+250). Все ветви: T ·ALL·. Ветви можно указывать до третьего уровня, разделитель уровней — знак ` (код 96): T ·Касса`приход·Расчетный счет·.
• Право R — список форм через пробел; все формы: R ALL. Идентифицируются только имена форм, начинающиеся с буквы, — отсюда традиционный запрет на обозначения счетов, начинающиеся с цифры.
• Права J и D — можно ограничить списком имён пользователей через запятую: J SVETA, D OLGA,SUPERVISOR.

5.3. Право P и доступ в прошлое

5.4. Пример файла прав

SUPERVISOR SUPER123 T ·ALL· R ALL J D P E U
OLGA    T ·Касса· R ALL J D P -1
SVETA   T ·ALL· R OBOROTKA,SALDO J OLGA P -2
DIMON   T ·Склад· R ALL
AUTOMAT T ·Импорт· R ALL

Здесь SUPERVISOR — администратор с полными правами; OLGA работает только с ветвью «Касса», видит чужие операции и может вводить операции в текущем месяце; AUTOMAT — технологическая учётная запись для шлюза обмена.

5.5. Директива U — просмотр прав

Встроенных средств редактирования прав нет — файл правится обычным текстовым редактором в каталоге данных. В новом сервере изменения вступают в силу после перезагрузки базы директивой W OFF (см. главу 7); директива U лишь показывает содержимое файла.

6. Протокол обмена: запросы, ответы, пожелания

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

6.1. Цикл одного запроса

1. Клиент создаёт в каталоге обмена канал — случайное имя из букв и цифр (обычно восемь знаков, например ZXC456A3), и пишет запрос в файл ZXC456A3.REQ.
2. Готовый запрос переименовывается в ZXC456A3.IN — это сигнал серверу «файл готов целиком».
3. Сервер, постоянно сканируя каталог, находит *.IN, выполняет запрос, удаляет .IN, пишет ответ в ZXC456A3.ANS и по завершении переименовывает его в ZXC456A3.OUT.
4. Клиент читает *.OUT. При следующем запросе прежний .OUT удаляется; если клиент этого не делает, сервер оставляет ответы в .ANS.

6.2. Начальный диалог

Подключившись, клиент сначала посылает директиву I: сервер проверяет имя и пароль, возвращает метку данных (первая строка файла FIN.LBL), дату и время сервера — так клиент синхронизирует свои часы с сервером — и признаки прав T и P. Затем клиент запрашивает директивой T доступные ему ветви дерева видов операций; сведения о проводках в листах дерева от клиента скрыты.

Далее клиент посылает директивы по мере действий пользователя: R — выполнить форму, J — показать журнал, O — зарегистрировать операцию и т.д. (полный список — глава 7). Несколько директив в одном файле-запросе выполняются сервером как одна транзакция.

6.3. «Пожелания» клиента

Каждая строка запроса имеет невидимую для пользователя часть — пожелания: 32 байта в начале строки после имени и пароля, затем разделитель · и сама директива:

Имя·Пароль·ABCDEFGH[f1        ][f2        ]·Директива

Результат выполнения директивы зависит от пожеланий (например, отчётный период влияет на формы и журнал), но в общем случае это не гарантируется — форма может игнорировать переданный период. Между пожеланиями и директивой могут вставляться контексты (например, ответы на вопросы операции и блок MODOKEY) — до 10 пар «имя + значение» по 10 символов; форма читает их функцией [ct 'имя'].

6.4. UPTI и автообновление отчётов

В корне каталога обмена и в каждом его подкаталоге сервер поддерживает файл UPTI: в нём — дата и время последнего изменения данных и время последнего запуска сервера. Файл обновляется при старте сервера, после каждого модифицирующего запроса (O, D, A, K, P), после завершения пересчёта, а также принудительно — директивой P ! без пересчёта состояния.

Клиент периодически проверяет UPTI: изменился — открытые отчёты помечаются устаревшими и обновляются (по настройке автообновления). Так работает «живость» отчётов у всех пользователей без рассылки сообщений.

6.5. Подкаталоги обмена

В каталоге обмена можно создавать подкаталоги — сервер сканирует их наравне с корнем (рекурсивно). Типовые применения:

• свой подкаталог каждому пользователю — вместе с правами ОС это ограничивает доступ к чужим запросам (см. п. 6.7);
• отдельные подкаталоги для шлюзов и автоматики (обмен с оборудованием, выгрузки);
• выделенные подкаталоги для «тяжёлых» клиентов.

6.6. Сбои транспорта и как их видит новый сервер

• Карантин. Если сервер не смог создать файл ответа, запрос не теряется: файл .IN переносится в карантин <имя>.BAD (с перезаписью), сбой пишется в журнал. Файлы .BAD автоматически не переобрабатываются — разбор за администратором.
• Повторная обработка. Если сервер выполнил запрос, но не смог удалить .IN, запрос будет обработан повторно — дубли модифицирующих директив возможны (так же вёл себя старый сервер); повтор виден в журнале запросов и снимается вручную.
• Сорванное переименование ответа. Если .ANS не удалось переименовать в .OUT, ответ для клиента теряется (как у старого сервера); оставшийся .ANS будет стёрт стартовой очисткой.
• Стартовая очистка. При каждом старте сервер стирает в каталоге обмена все файлы (каталоги сохраняются) и переписывает UPTI.
• Аутентификация. Неверная пара имя/пароль — ответ E-03 и обрыв обслуживания файла-запроса.

6.7. О безопасности данных

Граница защиты платформы проходит по каталогу обмена. Базовое правило:

Дополнительные меры:

• заведите каждому пользователю свой подкаталог обмена и дайте доступ только в него — тогда даже содержимое чужих запросов недоступно;
• права внутри системы (кто что может запросить) задаются файлом _RIGHTS_.FBP — см. главу 5;
• помните, что формы могут писать в файлы (переадресация вывода, printstr в файл, deletefile, renamefile) — выполняются они с правами учётной записи службы сервера; контролируйте состав форм и права R.

7. Язык запросов к серверу

Вся работа сетевой версии ФБП — это постоянный диалог клиентов и сервера, а основа диалога — запросы к серверу. Часть запросов клиент формирует автоматически (когда вы открываете журнал, вводите операцию, запускаете форму), но любой запрос можно ввести и вручную. Знание языка запросов нужно и программисту форм: управляющие строки N: (см. главу «Строки N:») конструируют именно такие запросы, а функция языка форм [jf s] интерпретирует строку как директиву J.

Глава описывает язык запросов в актуальном виде — применительно к ФБП:Серверу V01 (решение SRVNEW). Директивы, существовавшие в старом сервере (версии fnt*), но не перенесённые в новый, собраны в разделе 6.23; сводка отличий — также в главе «Отличия от старого сервера».

7.1. Общие правила

Запрос — это файл-запрос, который клиент помещает в свой канал связи в общем каталоге обмена; механика канала (.REQ → .IN → .ANS → .OUT) описана в главе «Протокол обмена». Запрос состоит из одной или нескольких строк-директив.

• Первая латинская буква строки однозначно определяет вид директивы; можно использовать и строчные, и прописные буквы. Остаток строки — аргумент директивы.
• Если файл-запрос содержит несколько строк, сервер выполняет их как одну транзакцию: все модификации (ввод, правка, удаление операций и счетов) применяются вместе.
• Разделитель и ограничитель строковых значений — знак · (средняя точка, код 250; вводится Alt+250 на цифровой клавиатуре).
• Вместо любого знака в директиве можно указывать его код — для преодоления затруднений при выводе некоторых знаков из программ. Синтаксис: //DDD//, где DDD — ровно три цифры, образующие число от 0 до 255. Директивы R AX и R //065//X эквивалентны (65 — код латинской A).
• Буфер строки запроса — 10000 байт; после всех подстановок //DDD// строка усекается до 255 байт.

Ответ сервера — одно- или многострочный текст в кодировке CP866, строки разделяются парой CRLF. Два особых случая помечаются префиксами в начале строки:

Встречающиеся коды ошибок: E-03 — доступ запрещён / нет права на действие; E-04 — неправильная команда (в том числе неизвестная или не перенесённая в новый сервер директива); E-06 — неправильно указан вид операции; E-14 — нет счёта-предка; E-18 — ошибочный ключ; E-93 — доступ к серверу монополизирован другим клиентом (см. M); E-94 — сервер находится в состоянии W ON (см. W).

7.2. Сводная таблица директив

В таблице перечислены все буквы, которые знает диспетчер запросов, а также исторические директивы старого сервера. Статусы: поддержана — директива работает в ФБП:Сервере V01; пустой ответ — запрос принимается, но ответ имеет нулевую длину; не реализована — ответ E-04: непpавильная команда; клиентская — сервером не обрабатывается.

7.3. Директива R — выполнение формы

R BALANCE
R 10 ·3·

7.4. Директива O — ввод и правка операции

O 1000000 ·Касса·приход ниоткуда···непонятно за что·

O PD=-1 DC=1 MC=1 1000000·Касса·приход ниоткуда···непонятно за что ·

O KEY=HAAA-678 1000000 ·Касса·приход ниоткуда···непонятно за что·

O ·нет такого вида операции·
E-06: неправильно указан вид операции

7.5. Директива D — удаление операции

D HAAA-678

7.6. Директива J — журнал операций

J                                " операции текущего пользователя за сегодня
J MC=1 USER=SVETA {              " свернуто, SVETA, за январь
J MC=1,8 ALL                     " все пользователи, январь..август
J 5,15                           " текущий пользователь, с 5-го по 15-е текущего месяца
J KEY=CAAA-170                   " операция с уникальным кодом CAAA-170

J MC=1,12 SUM=1000        " операции за год, сумма = 1000
J SUM=2000,3000           " сегодняшние, суммы в интервале 2000..3000
J MC=6 WORD=60-1          " июньские, с текстом "60-1"
J MC=6 WORD=·а б·         " строка с пробелами обрамляется знаками ·
J PATH=Касса·расход       " виды, начинающиеся с указанных ветвей
J MC=8 SUM=120,130 WORD=Вася PATH=Расч

7.7. Директива A — создание и правка субсчёта

A ·10·10-0001M·Особый материал·
субчет 10-0001M создан          " ответ при успехе
E-14: нет счета-предка          " ответ, если счета 10 нет

A E ·счет· BA=число
A E ·счет· N2=·строка·
A E ·счет· AA=число
A E ·счет· NP1=·строка·   ...   A E ·счет· NP9=·строка·
A E ·счет· BP1=число      ...   A E ·счет· BP9=число

7.8. Директива K — удаление субсчёта

7.9. Директива E — вычисление выражения

E 2+2                    " ответ: 4
E [ea 50] + [ea 51]      " сумма остатков в кассе и на расчетном счете

7.10. Директива F — список форм

A Ngscuf > *Это форма A
B Y..... > *Это форма B

7.11. Директива V — версия сервера

V
"Финансы без проблем" V01.01 Александр Пронин. Для Windows 8.1,10,11,Server 2012+

7.12. Директива I — синхронизация

7.13. Директива T — дерево видов операций

7.14. Директива S — статистика сервера

Статистика сеpвеpа
  Кто\запpос:│    O  │    D  │    A  │    J  │    R  │    E  │    X  │  Итого
...

7.15. Директива Q — запись конечного состояния

7.16. Директива L — первичный документ операции

L IAAB-045

7.17. Директива U — права пользователей

U
U+
U:

7.18. Директива M — монополизация доступа

M ON    " монополизировать доступ
M OFF   " отказаться от монополии

7.19. Директива W — управление сервером

W ON     " приостановить обслуживание: «отключить» сервер от данных и правил —
         " можно безопасно править правила и данные однопользовательской версией
W OFF    " снова «подключить» сервер к правилам и данным (перезагрузка базы)
W FORM   " перекомпилировать новые и изменённые формы без перезапуска
W DOWN   " штатно завершить работу сервера

7.20. Директива G — выполнение формы из тела запроса (V01.02)

7.21. Директива P — принудительный пересчёт состояния

P !            " только обновить файл(ы) upti — автообновление отчётов
               " в клиентах; пересчёта состояния НЕ происходит
P -            " выключить автоматический пересчёт состояния
P              " включить автоматический пересчёт состояния
P [MC=m] [DC=d]" пометить пересчёт с месяца m / дня d
P KEY=ключ     " пометить пересчёт с позиции операции с указанным ключом

P key=GDFG-987
P MC=1

7.22. Директива ? — помощь

?
? R

7.23. Директивы, не перенесённые в новый сервер

Следующие директивы существовали в старом ФБП:Сервере (версии fnt*), но в ФБП:Сервере V01 не реализованы — на них сервер отвечает E-04: непpавильная команда. Справки приведены для тех, кто переносит старые клиентские программы и скрипты.

7.24. О безопасности и потенциально опасных конструкциях

Справка из старого руководства. Начиная с версии 3.20 старого сервера, в ответе на директиву S был раздел «Потенциально опасные конструкции в *.rpt»: в нём перечислялись формы, где встречаются форматные вставки с переадресацией вывода в файл, оператор printstr с переадресацией в файл, операторы deletefile и renamefile. В новом сервере этот раздел статистики не перенесён, однако само перечисление остаётся полезным ориентиром при аудите форм: такие конструкции позволяют форме писать и удалять файлы на сервере, поэтому формы с ними должны быть доступны только доверенным пользователям.

Практические рекомендации прежние:

• разграничивайте права пользователей в _rights_.fbp (см. «Права пользователей») — права U, P, E давайте только доверенным лицам: право U открывает доступ к паролям (U+), управлению сервером (W, M, Q) и удалению счетов (K);
• средствами операционной системы давайте каждому пользователю сетевой доступ только к каталогу обмена (или его подкаталогу), но не к каталогу данных — см. «Архитектура»;
• помните, что строки N: в формах конструируют произвольные запросы к серверу (см. «Строки N:») — форма фактически наследует и расширяет возможности своего автора.

8. Ключевые слова (файлы-ключи) каталога данных

Ключевые слова — это файлы-ключи в каталоге данных сервера: важно само присутствие файла с нужным именем (он может быть пустым), а файл должен существовать до старта сервера.

8.1. fastfact — «быстрые факты»

Включает индексирование ленты фактов: при построении индекса учитываются прототипы и значения полей фактов. Конструкции search/news/total ускоряются во много раз. Цена — расход памяти растёт (иногда в разы), а добавление фактов (fact) замедляется примерно вдвое.

8.2. fastged — ускорение доступа к дисковой базе

В оперативной памяти строится зеркало тел записей extrd.dat (зеркало заметно меньше файла на диске). Функция [ged ...] ускоряется в 10–20 раз.

8.3. free-at — свободные @-обращения

Сервер перестаёт проверять, что субсчёт в @-обращении имеет предком счёт из листа дерева видов операций. Это компенсирует запрет *-подстановок в @-обращениях: вместо серии ветвей 50 @61, 50 @71, 50 @76 можно обойтись одной ветвью 50 @X и формой X.RPT. Подводный камень: клавиша заведения субсчёта в списке субсчетов клиента берёт имя формы как родителя счёта.

8.4. freeacnt — свободные счета

Разрешает пользователю с правом U: создавать счета первого уровня, создавать субсчета к счёту, у которого ещё нет субсчетов, и удалять счета и субсчета директивой K. Без этого файла директива K не выполняется.

8.5. M_PLUS — сдвиг текущего месяца

Файл содержит число N — сдвиг «текущего» месяца сервера вперёд при старте (см. п. 3.10). В отличие от прочих ключей, содержимое файла значимо.

8.6. Ключевые слова, не поддержанные новым сервером

8.7. О дисковом кэше ответов форм

Старый сервер умел кэшировать результаты выполнения форм в подкаталоге cache с файлом config.txt (директивы NO, ALL±, THESE±, EXCEPT±; показ и очистка — директивой H). В новом сервере дисковый кэш ответов не реализован: формы выполняются при каждом запросе, а устаревание отчётов на клиентах отслеживается через файлы UPTI (см. главу 6). Если в каталоге данных остался подкаталог cache от старого сервера, он просто не используется.

Часть II. Язык программирования ФБП

Эта часть — полное описание языка, на котором пишется настройка учётной системы: отчётные формы, первичные документы, файлы-коэффициенты, проводки в дереве видов операций. Читать можно подряд: материал идёт от простого к сложному и не требует знакомства с языком — достаточно общего представления о бухгалтерском учёте и о том, как устроена сетевая версия (часть I).

Порядок глав:

• 9–10 — введение и быстрый старт: первая форма за десять минут;
• 11–15 — файлы форм, вывод текста, переменные, операторы, массивы;
• 16 — лента фактов, главный механизм накопления данных;
• 17–19 — справочник функций языка;
• 20–22 — обращения к счетам, экстрапараметры, виды операций и проводки;
• 23 — управляющие строки N:: интерактивные отчёты в клиенте;
• 24–25 — графика и web-доступ (исторические механизмы, со статусом в новом сервере);
• 26–28 — производительность и отладка, примеры и приёмы, приложения (ограничения языка, сообщения об ошибках).

9. Введение в язык форм

«Финансы без проблем» (ФБП) — бухгалтерская система, в которой почти всё поведение определяется не жёстко зашитым кодом, а программами на встроенном языке ФБП, которые пишет сам пользователь. На этом языке описывают:

• отчётные формы (файлы *.rpt) — отчёты, списки, диалоги, документы;
• виды операций и проводки (дерево cas.rul) — что происходит со счетами при регистрации хозяйственной операции;
• файлы-коэффициенты — алгоритмы расчёта сумм проводок;
• первичные документы (формы, связанные с операциями).

Это руководство учит именно программированию: как устроены формы, какие есть операторы и функции, как обращаться к счетам и оборотам, как строить диалоги и отчёты. Установка программы и повседневная работа бухгалтера здесь не рассматриваются.

9.1. Где «живут» программы на языке ФБП

У языка ФБП есть несколько точек приложения, и важно сразу понимать, где какой код выполняется:

9.2. Кто выполняет программы: сервер и клиент

В сетевой версии ФБП есть ФБП:Сервер — единственный процесс, который хранит данные и выполняет все программы на языке ФБП: регистрирует операции, пересчитывает баланс, выполняет отчётные формы. ФБП:Клиент CLWP — «тонкий»: он лишь показывает ответы сервера и передаёт ему запросы. Поэтому форма, написанная вами, всегда работает «внутри» сервера и имеет прямой доступ ко всем данным учёта.

9.3. Главная «магия» ФБП: виртуальный пересчёт

Если вы изменили лист дерева видов операций — например, добавили проводку с расчётом налога, — то интерпретация всех ранее введённых операций этого вида изменится сразу: остатки и обороты счетов пересчитаются автоматически. Данные (операции) и правила (дерево, формы) в ФБП независимы, поэтому настройку можно менять «на живую», не переформатируя базу.

9.4. Как выглядит программа: первый пример

Отчётная форма — это обычный текстовый файл. Строки текста попадают в отчёт как есть, строки-операторы выполняются, а форматные вставки из знаков ^ заменяются значениями переменных. Вот законченная форма:

* форма hello.rpt — первая программа
X = 2 + 2
Привет! Дважды два = ^^^^X

Остаток на счете 50 (Касса): ^^^^^^^^^^[ea 50]

Запустив такую форму, вы получите примерно следующее:

Привет! Дважды два =    4

Остаток на счете 50 (Касса):      12500.00

Здесь видны сразу три базовых элемента языка: комментарий (строка со звёздочки), оператор присваивания и вызов функции [ea 50] — остаток счёта. Подробно всё это разбирается в главах «Переменные и выражения» и «Функции».

9.5. Условные обозначения в этом руководстве

• [ea X] — функции языка записываются в квадратных скобках;
• · — средняя точка (символ с кодом 250), служебный разделитель в строках директив и уточнений;
• //250// — способ записать любой символ его кодом (ровно три цифры), если сам символ неудобно вводить;
• в примерах строки, начинающиеся с *, — комментарии.

9.6. Как читать это руководство

Если вы новичок — идите подряд от главы «Быстрый старт»: каждая глава опирается на предыдущие. Если нужен конкретный оператор или функция — пользуйтесь поиском вверху страницы (клавиши Ctrl+K) или оглавлением слева; главы 17–19 образуют полный справочник функций, глава «Примеры и приёмы» — сборник готовых решений.

9.7. Где выполняется язык

• Отчётные формы *.rpt в каталоге данных компилирует и выполняет сервер (директивы R, E); результат — текст ответа в кодировке CP866, который отображает клиент.
• Первичные документы — формы, выполняемые сервером при регистрации операции (псевдопроводка «создать документ»); текст документа пишется в TXA\<месяц>\<ключ>.TXA, история версий — в файлы .DES.
• Файлы общих определений: FIRST.RPT подключается в начало каждой формы, LIBRARY.RPT и все файлы *.lib каталога данных компилируются в одну библиотеку подпрограмм.
• Управляющие строки N: в тексте форм исполняет не сервер, а клиент — см. главу 23.

9.8. Компиляция и перекомпиляция форм

Новый сервер компилирует все формы при старте (и при перезагрузке базы W OFF). Формы, добавленные или изменённые «на живую», перекомпилируются без перезапуска сервера директивой W FORM (ответ — «пеpекомпиляция фоpм завеpшена»; нужно право U). Директива старого сервера C (компиляция формы из клиента) не перенесена — взамен используйте W FORM.

9.9. Ширины строк — обязательная совместимость

Новый сервер воспроизводит ограничения оригинала, от которых зависит поведение программ:

• обозначения счетов — 10 символов: в *-ссылках, $D/$K/$P, @-обращениях имена усекаются до 10 символов; литералы разрешаются полным именем при компиляции, но проверка существования счёта — по усечённому;
• строки переменных, стека и временные строки — 255 символов с молчаливым усечением; это влияет, в частности, на накопители строк с дедупликацией по функции [ps];
• запись дисковой базы экстрапараметров extrd.dat — 255 байт.

9.10. Функции, заслуживающие отдельного упоминания

9.11. Графика в формах

Директива G, строившая в старом сервере PNG-графику из массивов формы, в новом сервере возвращает пустой ответ (графика не перенесена — она была заглушена и в последних сборках старого сервера). Формы с графикой следует переделать на текстовый вывод или на внешние средства (экспорт в Excel в клиенте CLWP).

9.12. Кодировки

Данные, формы и весь обмен с сервером — в кодировке CP866. Клиент CLWP перекодирует текст автоматически; при написании собственных программ обмена и редактировании *.rpt сторонними редакторами следите за кодировкой: путаница OEM↔Windows — типичная причина «кракозябр» в комментариях операций и отчётах. В строках запроса любой символ можно передать подстановкой //DDD// (три цифры кода).

10. Быстрый старт: ваша первая форма за 10 минут

Эта глава — практикум «с нуля до первого работающего отчёта». Мы убедимся, что сервер и клиент установлены, создадим файл формы, наберём простейшую программу, запустим её и научимся реагировать на сообщения об ошибках. Дальше по книге всё будет только дополнять эти базовые навыки.

10.1. Если программа ещё не установлена

Чтобы попробовать «Финансы без проблем» в работе, нужны две программы: ФБП:Сервер (служба Windows, управляется Менеджером баз) и ФБП:Клиент CLWP. Порядок их установки и настройки подробно описан в части I этого руководства. Для выполнения упражнений этой главы достаточно, чтобы сервер был запущен, а клиент подключался к нему.

10.2. Создаём файл формы

Формы хранятся в обычных текстовых файлах с расширением *.rpt. В сетевой версии формы бывают клиентскими — они хранятся на компьютере клиента и выполняются программой CLWP, и серверными — они хранятся на сервере. Список форм на клиенте открывается клавишами Alt+F7, список форм на сервере — Alt+F4. Начнём с клиентской формы: нажмите Alt+F7.

В списке показываются имена и первые строки отчётных форм, первичных документов, файлов-коэффициентов, форм-историй и файлов общих определений. Действия над файлами выполняются клавишами:

Создайте файл с именем, например, hello.rpt и откройте его в редакторе форм клавишей F4 из списка форм на клиенте.

10.3. Основные клавиши редактора

Встроенный редактор форм CLWP прост, но всё необходимое в нём есть. Минимум, которым вы будете пользоваться постоянно:

10.4. Первая форма: комментарий, присваивание, форматная вставка

Форма — это текстовый файл, в котором смешаны три вещи: обычный текст (он попадёт в отчёт как есть), операторы (они выполняются, но ничего не печатают сами) и форматные вставки из знаков ^ (вместо них в отчёт подставляются значения переменных). Наберите в hello.rpt такой текст:

* Первая форма: знакомимся с языком
B=234.1; A=B+12.2
Результат вычисления: ^^^^^^A^^^

Разберём по строкам:

• Строка, начинающаяся со звёздочки *, — комментарий: она никуда не выводится и нужна только для тех, кто читает форму.
• B=234.1; A=B+12.2 — два оператора присваивания в одной строке, разделённые точкой с запятой. После выполнения A станет равным 246.3. Текст после оператора в той же строке тоже считается комментарием.
• В третьей строке слова «Результат вычисления:» — обычный текст, а ^^^^^^A^^^ — форматная вставка. Шесть знаков ^ перед именем переменной отводят шесть позиций под целую часть числа, три знака после — три позиции под дробную часть.

Запустите форму (как — см. следующий подраздел) и в отчёте появится:

Результат вычисления:    246.300

Число выровнено по правому краю отведённого поля: перед 246.300 стоят три пробела, добирающие целую часть до шести знаков.

10.5. Запуск формы

В клиенте CLWP форму можно запустить двумя способами: в списке форм на клиенте (Alt+F7) подведите селектор к имени формы и нажмите Enter — или прямо из редактора клавишей F8 (текст уходит серверу директивой G, даже несохранённый). Перед выполнением форму полезно скомпилировать клавишей F6: файл записывается, сервер перекомпилирует изменённые формы (запрос W FORM) и отвечает отчётной формой с сообщениями об ошибках.

R HELLO
R 10 ·3·

10.6. Форма с вводом значения

Отчёт становится в сто раз полезнее, если перед построением спросить у пользователя параметры — дату, сумму, название. Для этого есть функции ввода; вот две самые ходовые.

A=[ir 'Введите номер поручения:',X,0]

A=[is 'Введите название фирмы:',A,20]

Соберём форму с вводом целиком:

* Форма ask.rpt — спрашиваем и считаем
S=[ir 'Введите сумму:', 100, 2]
N=[is 'Кому платим?', ' ', 30]
Получатель: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^N
Сумма: ^^^^^^^^^^^S^^
T=S*1.1
Сумма с надбавкой 10%: ^^^^^^^^^^^T^^

Есть и более простое средство — оператор вопроса:

? переменная строка

Он выводит строку на экран и запрашивает значение переменной. Но функции [ir]/[is] удобнее: у них есть значения по умолчанию и контроль формата. Все функции ввода и оформления диалогов (включая меню [im] и выбор субсчёта [ia]) подробно описаны в главе «Функции: ввод и оформление».

10.7. Если синтаксическая ошибка

Ошибаться в первых формах будете много — это нормально, язык сообщает об ошибках вполне дружелюбно. Если при компиляции (F6) или выполнении (F8) формы встретилась ошибка, сервер сообщит о ней в открывшейся отчётной форме. Исправьте строку и запустите снова — при выполнении из редактора (F8) текст можно даже не сохранять: серверу уходит содержимое окна.

Некоторые сообщения анализатора говорят сами за себя, например «@-обращение к несуществующему счету» (счёт не описан в списке счетов — введите его и его субсчета) или «Неправильно указан вид операции» (дерево изменилось после ввода операций — укажите вид операции заново). Полный перечень сообщений и способы реакции на них собраны в главе «Приложения».

10.8. Куда идти дальше

Теперь вы умеете создавать, редактировать и запускать формы. Заодно осмотритесь в клиенте: журнал операций открывается клавишами Alt+F2, ввод новой операции в нём — клавишей F7. Дальше путь такой:

11. Файлы форм: создание, компиляция, общие файлы

Программы на языке ФБП хранятся в обычных текстовых файлах с расширением .rpt в рабочем каталоге сервера (а локальные формы — на компьютере клиента). В этой главе разбирается «хозяйственная» сторона вопроса: как создавать и редактировать формы, как система проверяет и выполняет их текст, какие служебные файлы (FIRST.RPT, LIBRARY.RPT, PROTO.RPT, библиотеки *.lib) позволяют не повторять общий код в каждой форме, и как отправить результат формы не на экран, а в файл.

11.1. Списки форм в клиенте CLWP

Все тексты на языке ФБП — отчётные формы, первичные документы, файлы-коэффициенты, формы-истории, файлы общих определений — собраны в списках форм. Чтобы попасть в список форм, хранящихся на клиенте, выберите в меню Документы → Формы на Клиенте или нажмите Alt+F7 (список форм на сервере открывается по Alt+F4). Для каждого файла показываются его имя и первая строка — поэтому принято начинать форму со строки-комментария с понятным названием.

Отдельных клавиш для создания и переименования формы в списке нет: переименуйте или создайте файл .rpt средствами ОС (например, в Проводнике Windows), а новый текст можно набрать и в редакторе, сохранив его клавишей F2.

11.2. Встроенный редактор

Форму можно набрать и во внешнем редакторе (это простой текстовый файл в кодировке CP866 — см. предупреждение в главе «Введение»), но встроенный редактор клиента CLWP удобнее: он связан с серверным анализатором синтаксиса и при ошибке компиляции сам показывает место сбоя.

Обычные приёмы редактирования Windows (выделение мышью и Shift+стрелками, копирование и вставка Ctrl+C/Ctrl+V, переходы Ctrl+Home/Ctrl+End) работают как в любом текстовом редакторе. Подробное описание редактора — в разделе «Редактор форм» главы о клиенте CLWP.

11.3. Интерпретатор и компилятор

Когда вы запускаете форму, её текст не «читается построчно» в момент вывода, как в классических пакетных файлах: форма сначала компилируется в промежуточный код, который затем выполняется — это сделано ради быстродействия.

Компиляцией форм управляет ФБП:Сервер. Проверить форму можно прямо из редактора клавишей F6: изменённый текст записывается в файл, серверу уходит запрос W FORM, и ответ с сообщениями об ошибках открывается отчётной формой.

Перекомпиляция форм на сервере выполняется командой W FORM (требуется право U; подробности — в главе «Язык запросов к серверу»).

11.4. Синтаксический анализатор и его сообщения об ошибках

Проверка текста выполняется ещё до запуска формы. Редактор CLWP подсвечивает синтаксис — разными цветами раскрашиваются операторы, комментарии, текст формы и ошибочные места; клавиша F6 запускает полный анализ на сервере, включая проверку существования всех упомянутых счетов (без неё при обычном наборе проверяется формальный синтаксис — скобки, запятые и т.п.).

Компилятор дерева видов операций обнаруживает большинство формальных ошибок «на первой секунде» попытки построить баланс. В клиенте CLWP изменения в окне «Счета…» приводят к тому, что отсутствующие счета перечёркиваются и перекрашиваются в окне «Дерево…»; изменения в «Дерево…» цветом выделяют ставшие несоответствующими операции в окне «Операции…». Сообщение об ошибке выводится в нижней полосе главного окна; кнопка «Где ошибка» (мышью) или Alt+E (с клавиатуры) активирует окно с ошибкой и ставит на неё курсор. Повторное нажатие может открыть ещё одно окно с дополнительной информацией: например, при делении на нуль в операции первое нажатие покажет место в «Дерево…», второе — в «Операции…».

Полный перечень сообщений анализатора с пояснениями:

11.5. Файлы-коэффициенты

Файл-коэффициент — это обычный файл .rpt, содержащий алгоритм на языке форм, который вычисляет сумму проводки. Он нужен там, где сумма не совпадает с суммой операции: расчёт налогов, процентов, амортизации и т.п. Файл-коэффициент вызывается из листа дерева видов операций — имя файла дописывается в строке проводки после счетов (подробно о дереве — глава «Виды операций и проводки»).

Обмен данными с вызвавшей проводкой идёт через предопределённые переменные:

Создать файл-коэффициент можно двумя способами: как обычную форму — новым файлом .rpt в редакторе (F2 — сохранить) или средствами ОС — либо прямо из дерева проводок: дописать в строке проводки после пробела имя файла-коэффициента и нажать F4.

Пример. К проводке @70 68-3 (удержание подоходного налога) дописано имя файла-коэффициента TAX. Начало этого файла:

* Подоходный налог с физических лиц
*
D=[AK $D]        Доход, начисленный сотруднику с начала года
U1=[AP $D,68-3]  Уже удержанный подоходный налог (город)
U2=[AP $D,68-31] Уже удержанный подоходный налог (федеральный)
G=D*0.01         вычеты в Пенсионный фонд 1%
M=[ed MIN]       Подлежащие вычету минимумы
P=[ep @70]       Сумма льгот, накопленная к моменту начисления
if D in 0..10000 D=D-P-2*M; L=M*2
elseif D in 10000..30000 D=D-P-M; L=M
else D=D-P; L=0
endif
*
* ... далее — расчёт налога по шкале и итоговое присваивание:
$=J2

Здесь видно несколько важных приёмов файлов-коэффициентов: строки со звёздочки — комментарии (комментарий допускается и в конце оператора, после выражения); обращения к данным учёта записываются в квадратных скобках ([AK …], [AP …], [ed …], [ep …] — см. главу «Функции: данные учёта»); несколько операторов в одной строке разделяются точкой с запятой; результат возвращается присваиванием $=….

11.6. Файл общих определений FIRST.RPT

Если в рабочем каталоге сервера есть файл FIRST.RPT, он выполняется перед выполнением каждого первичного документа и отчётной формы. Туда выносят всё, что должно быть общим для форм: употребительные константы, подпрограммы, значения общих переменных — реквизиты предприятия, Esc-последовательности управления принтером и т.п.

* FIRST.RPT — общие определения
FIRMA='ОАО "Ромашка"'
ESC=[ch 27]
CONDENSED=ESC+[ch 15]   * узкий шрифт принтера

Ограничение уже упоминалось: перед файлами-коэффициентами FIRST.RPT не выполняется. Это разумно: коэффициент вызывается при каждой проводке, и лишние вычисления замедлили бы пересчёт.

11.7. Файл PROTO.RPT — прототипы фактов

Лента фактов (глава «Лента фактов») хранит записи из безымянных частей. Чтобы система могла проверять правильность операторов fact, search и им подобных, синтаксис фактов описывают в файле PROTO.RPT — в виде прототипов. Знак % отмечает место части факта, остальные символы — разделители:

**********************************
приход товара, %, %
передача товара, %, %
**********************************

Прототипы можно сделать более выразительными — тогда и операторы читаются как фразы:

************************************************
товара % есть % единиц по цене %
поставщик % передал % единиц товара % на сумму %
************************************************

с ними законны записи вида fact товара T есть Q единиц по цене P и total поставщик Z передал ?? единиц товара ?? на сумму ?S.

Сервер автоматически проверяет соответствие прототипа из PROTO.RPT и факта, использованного в файлах форм. Прототипы помогают и при вводе: в редакторе формы нажмите F4 (шаблоны), выберите прототип из списка и нажмите Enter — заготовка оператора вставится в текст.

11.8. LIBRARY.RPT и библиотеки *.lib

Подпрограммы и определяемые пользователем функции (операторы call, return (выражение), вызовы [:метка] — см. главу «Операторы») можно собрать в файле LIBRARY.RPT: они станут доступны из любой формы или файла-коэффициента.

В рабочем каталоге сервера может быть несколько файлов библиотек *.lib с функциями и подпрограммами — это позволяет разбивать общий код на тематические модули. Файлы *.lib защищаются шифрованием Enigma.

11.9. Вывод результата формы в файл

Результат выполнения отчётной формы показывается на экране клиента и может быть записан в файл клавишей Alt+F8. Но форма может и сама писать в произвольные файлы: для этого строку вывода завершают знаком > (начать файл заново) или >> (добавить в конец файла), затем пишут ключевое слово file и через пробел(ы) — имя переменной, чьё строковое значение задаёт имя файла:

строка-вывода >file переменная
строка-вывода >>file переменная

Пример из руководства (он работает и в файлах-коэффициентах):

a=[dir 0]+'1.txt'
\>file a
^^^^^^^^^^^b >>file a

Разбор по шагам:

• [dir 0] — функция, возвращающая имя каталога (см. карточку ниже); имя файла собирается строковым выражением, здесь получается 1.txt в каталоге данных;
• \>file a — выводится пустая строка с подавленным переводом строки (начальный \): файл усекается до нулевой длины;
• ^^^^^^^^^^^b >>file a — значение b дописывается в файл; оно попадает в первую строку, потому что при усечении перевода строки не было. Если бы вместо \>file a было написано >file a, первая строка файла была бы пустой, а значение b попало бы во вторую строку.

a=[dir 0]+'1.txt'      * файл 1.txt в каталоге данных
f=[dir 1]+'TXA\'+[stamp 3]+'.TXA'   * файл в подкаталоге TXA каталога обмена

Похожие возможности даёт и оператор printstr … to > file f — он описан в главе «Текст и вывод» (раздел 12.4).

12. Текст и вывод: форматные вставки

Отчётная форма — это прежде всего текст. Строки, которые не являются операторами, попадают в отчёт как есть; чтобы подставить в этот текст значения переменных, служат форматные вставки из знаков ^. В этой главе — как они устроены, как выводить длинные строки, как «склеивать» вывод в одну строку и как тонко управлять представлением чисел.

12.1. Механика ^-полей

В любом месте текста формы (но не внутри операторов) допустима форматная вставка: цепочка знаков ^, затем имя переменной, затем, возможно, ещё знаки ^:

^...^имя_переменной^...^

При выполнении формы вставка заменяется значением переменной, причём знаки ^ задают формат числа:

• количество ведущих ^ (до имени) — число знаков под целую часть;
• количество завершающих ^ (после имени) — число знаков под дробную часть.

Пример:

B=234.1; А=B+12.2
^^^^^^А^^^

После вычислений A = 246.3; в отчёт попадёт 246.300 — шесть знаков целой части (значение дополняется ведущими пробелами) и три знака дробной.

12.2. Вывод строк и растекатели

Форматные вставки работают и со строковыми значениями: строка просто занимает место вставки. Но что делать, если строка длиннее строки отчёта и должна выводиться «в несколько этажей»? Для этого служат растекатели — цепочки знаков ^ без имени переменной на строках, следующих за форматной вставкой:

S='qwertysdf ghjkzxcvbn mqwer tyuiop'
^^^^^^^^^^^^^^^^^S
^^^^^^^^^^^^^^^^^^
^^^^^^^^^^^^^^^^^^
^^^^^^^^^^^^^^^^^^

Правила растекания:

• растекатели располагаются на строках, следующих за форматной вставкой;
• общее число ^ во вставке и растекателях должно быть не меньше длины выводимой строки;
• одновременно может «растекаться» только одна форматная вставка.

12.3. Обратный слэш: вывод без перевода строки

Знак \ в конце строки формы подавляет перевод строки при выводе (сам \ не выводится). Следующая выводимая строка продолжит текущую — так можно строить вывод в одну строку из цикла, удобно для «широких» форм с заранее неизвестным числом полей.

for i=1 to 10
^^i \
endfor
-----

Результат выполнения:

1 2 3 4 5 6 7 8 9 10
-----

Пустая строка формы просто переводит строку — без неё ----- появились бы сразу после 10.

12.4. Оператор printstr

printstr 'qwerty'
printstr 'asdf'
* выведет: qwertyasdf

Если те же два оператора разделить пустой строкой, будет выведено две строки: qwerty и asdf.

Вывод printstr можно переадресовать в файл (s — выводимая строка, f — строка с именем файла):

printstr s                  * обычный вывод
printstr s to > file f      * начать новый файл f, записать строку s
printstr s to >> file f     * добавить строку s в конец файла f
printstr s to file f        * то же, что и предыдущий вариант

Сравните с перенаправлением >file / >>file для обычных строк вывода — раздел 11.9 главы «Файлы форм». Те же правила про полное имя файла действуют и здесь: используйте [dir 0] / [dir 1].

12.5. Спецкомментарии форматирования: *.on/*.off, *,on/*,off

Особые строки-комментарии позволяют глобально (в пределах формы) управлять тем, как числа превращаются в текст. Они действуют и в формах, и в файлах-коэффициентах — до конца формы либо до отменяющего комментария:

По умолчанию действует сочетание «как у *,on + *.off»: запятые есть, дробной части нет.

Полный поучительный пример (функция [sn nn,mm,kk] преобразует число в строку по формату — см. главу «Функции: строки, даты, математика»):

a=[sn 1200.345,17,3]
^^^^^^^^^^^^^^^^a
*.on
*,on
a=[sn 1200.345,17,3]
^^^^^^^^^^^^^^^^a
*.off
*,on
a=[sn 1200.345,17,3]
^^^^^^^^^^^^^^^^a
*.on
*,off
a=[sn 1200.345,17,3]
^^^^^^^^^^^^^^^^a
*.off
*,off
a=[sn 1200.345,17,3]
^^^^^^^^^^^^^^^^a

Результат выполнения формы:

1,200
1,200.345
1,200
1200.345
1200

13. Переменные, выражения и формулы

Почти вся «начинка» отчётной формы — это формулы: ими вычисляются итоги, проверяются условия, формируются суммы проводок в файлах-коэффициентах. Формула в ФБП строится из чисел, переменных, знаков операций, круглых скобок и вызовов функций — в целом всё похоже на школьную арифметику, но со своими правилами имён, приоритетов и неожиданными возможностями вроде решения систем линейных уравнений.

13.1. Калькулятор: полигон для выражений

Прежде чем писать формулы в форме, их удобно обкатать во встроенном калькуляторе клиента CLWP (вызов — Ctrl+F3). Он работает с фиксированной точкой и имеет скобочную логику, то есть понимает выражения произвольной вложенности.

• Enter — завершить ввод выражения;
• F10 — выход с переносом вычисленного значения (если калькулятор вызван при редактировании числа);
• Esc — выход без переноса.

13.2. Типы данных: числа и строки

Язык ФБП не требует объявлять типы: переменная просто получает значение при присваивании. Значений два вида — числа и строки.

Числа хранятся с фиксированной точкой. Все арифметические операции и сравнения работают с числами обычным образом. Важная тонкость — понятие истинности: выражение считается ложью, только если его абсолютное значение меньше 0.000001; любое другое значение — истина. То есть отрицательные числа в условиях трактуются как «истина», а не как «ложь».

Строки встречаются в выражениях реже, но язык их понимает: все операции сравнения (<, >, =, <> и т.д.) применимы как к числам, так и к строкам. Строковые значения появляются и как признаки ошибок: например, операторы линейной алгебры возвращают строку 'fail' при неудаче (см. 13.8). Создание и обработка строк подробно разобраны в главе «Функции: строки, даты, математика».

13.3. Имена переменных

Переменные в ФБП намеренно «короткие» — как в записи формул на бумаге. Имя переменной — это одна или две буквы либо буква и цифра. Примеры допустимых имён: Т, А1, x2, ZТ. Русские и латинские буквы равноправны.

Имена массивов — отдельная история: это одиночные латинские буквы (см. главу «Массивы»). Есть и особые предопределённые имена — о них ниже.

13.4. Предопределённые переменные

При запуске формы значения всех переменных не определены — кроме нескольких, которые сервер инициализирует сам. Это сведения об отчётном периоде и (в файлах-коэффициентах) о текущей операции.

Отдельная группа — переменные реальной даты. Они автоматически инициализируются сервером и в файлах-коэффициентах, и в отчётных формах:

13.5. Выражения и приоритет операций

Формула может содержать числа, переменные, знаки операций и круглые скобки, а также вызовы функций обращения к данным учёта — например, [ea 50] подставляет в формулу остаток счёта 50 (см. главу «Функции: данные учёта»).

Пояснения к неочевидным операциям:

• & — логическое «и»; | — логическое «или»; ~ — отрицание. Операнды трактуются по правилу истинности из 13.2: ноль (точнее, |x| < 0.000001) — ложь, остальное — истина;
• % — остаток от целочисленного деления;
• сравнения дают 0 или 1, и их низкий приоритет означает, что A + 1 > B читается как (A + 1) > B.

Типичное выражение в вычисляющем операторе (подробно об операторах — глава «Операторы»):

* сложить B с начальным дебетовым остатком счёта 01
A1 = B + [BD 01]

13.6. Строковые выражения

Строки в выражениях участвуют прежде всего в сравнениях: к ним применимы все шесть операций сравнения, результат — те же 0 или 1. Это позволяет, например, сравнивать наименования субсчетов или проверять строковые признаки ошибок:

* проверка признака неуспеха от lsolve/invertm
X = [y 1] <> 'fail'

Полный набор строковых функций (выделение подстрок, склейка, преобразования) рассматривается в главе «Функции: строки, даты, математика», а правила вывода строк в текст отчёта — в главе «Текст и вывод».

13.7. Даты в выражениях

Специального типа «дата» в языке форм нет: даты представлены числовыми переменными — год, месяц, день по отдельности. Их дают предопределённые переменные из 13.4: границы отчётного периода MF/ML, сведения о текущей операции (DC, MC, YC — в файлах-коэффициентах) и реальная дата (YR, MR, DR, WR).

Поскольку это обычные числа, с ними работает вся арифметика и все сравнения. Например, в файле-коэффициенте можно разветвить расчёт по месяцу операции:

* в файле-коэффициенте: другой процент для операций декабря
! MC = 12
P = 20
! MC <> 12
P = 10

А в отчётной форме переменные реальной даты удобны для шапки отчёта — переменная WR позволяет учесть даже день недели (0 — воскресенье). Для функций работы с датами (сдвиг даты, разность дат и т.п.) см. главу «Функции: строки, даты, математика».

13.8. Элементы линейной алгебры

В язык встроены средства для работы с квадратными матрицами: одна функция (определитель) и два оператора (решение системы линейных уравнений и обращение матрицы). Это редкость для бухгалтерских систем, но полезно, скажем, для распределения затрат по модели «затраты–выпуск».

Матрица хранится в массиве, разложенная построчно: для матрицы n × n элемент (i, j) соответствует элементу массива с номером (i-1)*n+j. Сами массивы подробно описаны в главе «Массивы»; здесь достаточно знать, что запись [a k, значение] заносит значение в k-й элемент массива a, а [a k] — читает его.

* определитель матрицы Гильберта 4x4
n=4
for i=1 to n
for j=1 to n
[a (i-1)*n+j, 1/(i+j-1)]
endfor
endfor
x=[det a,n]
^^^^^^^^^x^^^^^^^^^^^^^^

[a 1, 20, 23, 17, 90]
[a 5, 33, -4, 12, 0]
[a 9, 77, 34, 11, -2]
[a 13, 10,108, 44, 99]
[b 1, 1, 2, 3, 4]
lsolve a,b,y,4
for i=1 to 4
x=[y i]
^^^^^^^^^^x^^^^^^^^^^
endfor

0.0208762740
0.0042390130
0.1106699174
-0.0155156820

n=4
for i=1 to n
for j=1 to n
[a (i-1)*n+j, 1/(i+j-1)]
endfor
endfor
*
invertm a,b,n
*
for i=1 to 4
for j=1 to 4
x=[b (i-1)*4+j]
^^^^^^^^^x^^^^^^^^^ \
endfor
endfor

16.000000000 -120.000000000 240.000000000 -140.000000000
-120.000000000 1200.000000000 -2700.000000000 1680.000000000
240.000000000 -2700.000000000 6480.000000000 -4200.000000000
-140.000000000 1680.000000000 -4200.000000000 2800.000000000

14. Операторы управления и подпрограммы

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

14.1. Общие правила записи операторов

• Оператор начинается с ключевого слова или знака; перед ключевым словом могут идти пробелы — отступы делают форму читаемее.
• Несколько операторов можно записать в одной строке, разделив их знаком ;:

A=23; B=[EA 50]; C=[ED 68]

Операторы языка форм делятся на группы: вычисляющий оператор и ввод (эта глава), условия и циклы (эта глава), операторы для работы с массивами (глава «Массивы»), оператор выполнения проводки в файле-коэффициенте (глава «Виды операций и проводки»), операторы ленты фактов (глава «Лента фактов») и средства организации подпрограмм (эта глава).

14.2. Вычисляющий оператор

Самый частый оператор языка: вычислить формулу и присвоить результат переменной.

А1=B+[BD 01]

Если функция вызывается только ради побочного эффекта (например, [sed 1,2] сохраняет значение в дисковую базу), значение можно не присваивать — допускается сокращённая запись, где оператор начинается сразу со скобки [:

[sed 1,2]     * вместо x=[sed 1,2]

14.3. Оператор вопроса ?

Часто форме нужны сведения, которых нет в учётных данных: период, код товара, дата. Оператор вопроса запрашивает их у пользователя при выполнении формы.

?A ввести переменную A:

14.4. Условный оператор !

Условный оператор — исторически первый способ ветвления в языке форм: он включает или выключает выполнение последующих строк в зависимости от условия.

X=A>B
! X Y=25

Результат любого сравнения (<, >, =, >=, <=, <>) — число 0 или 1; сравнения применимы и к числам, и к строкам. Условия комбинируются операциями & (И), | (ИЛИ), ~ (отрицание), % (остаток от деления). Условие можно записать прямо в операторе вместе с действиями:

! A>B X=1 Y=1     * если A>B, то выполнить X=1 и Y=1

Частный случай — проверка вхождения в замкнутый интервал (границы включаются):

! A in 1000..2000          * 1000 <= A <= 2000
! (X in A..B) | (X in C..D)

14.5. Оператор if / elseif / else / endif

Более наглядная замена !: блоки ветвления, которые можно вкладывать друг в друга и в циклы.

if выражение
....
elseif выражение
....
else выражение
....
endif

14.6. Оператор цикла # — перебор субсчетов

Самая «бухгалтерская» конструкция языка: цикл, который перебирает субсчета (объекты) указанного счёта и для каждого выполняет тело цикла — так строятся ведомости и списки.

Название    Цена, ед    Остаток,руб    Остаток,шт
# 10
A=[NA #]; P=[EP #]; ER=[EA #]; EQ=ER/P
^^^^^^^^A    ^^^^^^^^P    ^^^^^^^^^ER    ^^^^^^^^^EQ
#

После # может идти не только обозначение счёта, но и *-обозначение — косвенная ссылка на счёт через переменную:

A=`70`
# *A
B=[n1 #]
^^^^^^^^^^B
#

Ключевое слово sort после обозначения счёта задаёт порядок обхода: для каждого субсчёта вычисляется выражение, и субсчета перебираются по возрастанию его значений. Пример — перечисление в порядке возрастания остатков:

#68 sort [ea #]; n=[n1 #]; m=[ea #]
^^^^^^^^n    ^^^^^^^^^^^^m^^
#

А так — сортировка по алфавиту наименований:

#70 sort [n2 #]; n=[na #]
^^^^^^^^^^^^^^^^^^^^^^^n
#

14.7. Оператор for / endfor

Классический цикл со счётчиком: повторить тело заданное число раз, наращивая или уменьшая переменную.

for i=10 downto 1
^^i
endfor

for i=1 to [get %,x]
....
endfor

n=[get %,x]     * граница зафиксирована
for i=1 to n
....
endfor

Внутри for нельзя использовать условный оператор ! — применяйте if.

14.8. Оператор while / endwhile

Цикл «пока условие истинно» — удобен, когда число повторений заранее неизвестно.

i=1
while i<10
^^i \
i=i+1
endwhile

Внутри while нельзя использовать условный оператор !.

14.9. Операторы stop и error

if Z=0
error Не задано количество!
endif

14.10. Оператор goto и метки

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

:НАЧАЛО
бесконечность
goto НАЧАЛО

14.11. Комментарии в формах

Комментарии начинаются символом *: все символы после * программой игнорируются. Звёздочку ставят и в начале отдельной строки-комментария:

* это комментарий на всю строку
A=2    * а это пояснение к оператору

14.12. Оператор printstr

Выводит строку «как есть»: без автоматического перевода строки и без лишних пробелов, которые добавляют форматные вставки ^.... Незаменим при выводе HTML-разметки и точно сформированного текста.

printstr 'qwerty'
printstr 'asdf'

printstr умеет и переадресовывать вывод в файл (s — выводимая строка, f — строка с именем файла):

printstr s                  * обычный вывод
printstr s to > file f      * начать новый файл f, записать строку s
printstr s to >> file f     * добавить строку s в конец файла f
printstr s to file f        * то же, что и предыдущий вариант

14.13. Подпрограммы: call и return

Если один и тот же фрагмент нужен в нескольких местах формы, его описывают один раз в конце формы и вызывают оператором call.

...
call L     * вызов подпрограммы
...
stop
*****
:L
это тело подпрограммы
return

Разделы, совместно используемые несколькими формами, описывают в файле общих определений first.rpt, а подпрограммы в файле LIBRARY.RPT доступны из любой формы или файла-коэффициента — см. главу «Файлы форм и общие файлы».

14.14. Параметры подпрограмм и оператор local

Подпрограмме можно передать значения: в call указывают фактические параметры, а после метки — формальные.

• В CALL после имени метки — фактические параметры: выражение или выражения через запятую в круглых скобках.
• После метки — формальные параметры: переменная или переменные через запятую в круглых скобках.
• При входе в подпрограмму формальные параметры получают значения фактических.
• Формальные параметры — локальные переменные подпрограммы; их экземпляры автоматически уничтожаются при выполнении RETURN.
• Параметры передаются «по значению»: изменение формального параметра внутри подпрограммы не меняет фактический параметр в вызывающей программе.

A=5
call P
^^A
stop
:P
local A,B
A=1; B=2
^^A ^^B
return

1 2
5

Пример подпрограммы с параметрами:

call SUM(1,2)
stop
:SUM(a,b)
local c; c = a+b
^^^^^c
return

Результат выполнения: 3.

14.15. Определяемые пользователем функции

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

[:метка]
[:метка параметры]

x=[:max 3,5]
^^^^^x
stop
:max(x,y)
if x > y return (x); else return (y); endif

Допускаются рекурсивные вызовы функций. Пример — вычисление факториала N! = N·(N−1)·…·1:

x=[:factorial 5]
^^^^^^^x
stop
:factorial(n)
if n=0 return (1); else return (n*[:factorial n-1]); endif

Результат: 120.

15. Массивы

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

15.1. Обращение к элементам: чтение и присваивание

Имя массива — одна латинская буква, записанная после открывающей квадратной скобки; далее через пробел идёт выражение-индекс. Та же запись служит и функцией чтения, и оператором присваивания — в зависимости от числа аргументов:

x = [a i]
[a j,v]

Есть и групповое присваивание: если после индекса перечислить несколько значений через запятую, они попадут в элементы подряд, начиная с указанного:

[m 1,'Jan','Feb','Mar','Apr','May','Jun']

Здесь [m 1] получит значение 'Jan', [m 2] — 'Feb' и так далее.

15.2. Индексы, имена и ограничения

• Индекс элемента — от 1 до 1000000. Значение индекса всегда округляется до ближайшего целого.
• Всего можно создать 26 массивов — по числу латинских букв.
• Малые и большие буквы в именах массивов не различаются: [A 1] и [a 1] — один и тот же элемент.
• Массив и одноимённая переменная — совершенно разные объекты: можно одновременно иметь массив z и переменную z, они никак не влияют друг на друга.
• При старте формы или файла-коэффициента все элементы всех 26 массивов получают нулевые значения — предварительная инициализация не нужна.
• В элементе с индексом 0 хранится индекс последнего элемента, которому было присвоено значение, — то есть текущая длина массива: t = [m 0].

array a,b,c

15.3. Сортировка: оператор sort array

Сортировать большие списки «вручную» не придётся — есть встроенный оператор в двух вариантах.

sort array a      * a отсортирован по возрастанию
sort array a,b    * b — таблица новых номеров, a прежний

15.4. Типичные приёмы работы с массивами

Накопление в цикле с запоминанием длины. Значение [a 0] всегда подсказывает, сколько элементов уже заполнено, — это удобная «длина массива»:

for i=1 to 10
[a i, i*i]
endfor
n=[a 0]          * n равно 10 — индекс последнего заполненного элемента

Сбор данных в форме-истории и сортировка в конце. В разделе everydebet массивы недоступны, поэтому значения копят через экстрапараметры, а в epilog переносят в массив и сортируют:

prolog
n=0
every debet
n=n+1
[set X, n, ss]
epilog
for i=1 to n
[a i,[get X, i]]
endfor
sort array a
for i=1 to n
y=[a i]
^^^^^^^^^^^y
endfor

Массив как «холст». Массивы — основа графических операторов (makepng, drawline и др.): точке изображения с координатами (x, y) соответствует элемент с индексом (y-1)*w+x. Это подробно разобрано в главе «Графика». Там же описаны и операции линейной алгебры ([det a,n], lsolve, invertm), где матрица n×n хранится в массиве по тому же правилу: элемент (i, j) — это индекс (i-1)*n+j.

16. Лента фактов и ta-факты

Остатки и обороты счетов отвечают на вопрос «сколько?», но не «что именно произошло?». Механизм фактов позволяет запоминать сами события: «пришёл товар А12 в количестве 5», «поставщик Z передал товар на сумму 100». Формы могут потом искать такие события, считать их итоги, сортировать и удалять. Механизм появился в версии ultraF.

16.1. Что такое факт и как хранится лента фактов

Факт — запись из одной или нескольких частей; каждая часть может быть числовой или строковой. Части не имеют имён и закреплённых типов — говорят просто о первой, второй и т. д. частях. Какой смысл вкладывать в каждую часть, решаете вы сами: это может быть событие, отношение между объектами, любое наблюдение.

Организация хранения:

• Все факты образуют общий список facts — «ленту фактов». Порядок фактов в ленте совпадает с порядком следования операций, породивших их.
• Каждый факт автоматически снабжается отметкой о дате операции (значения предопределённых переменных YC, MC, DC).
• При удалении операций соответствующие факты вычёркиваются из списка автоматически.
• Факты размещаются в оперативной памяти сервера и воссоздаются заново при каждом его старте.

16.2. Операторы ленты фактов: обзор

Сервер хранит указатель на «текущий» факт (current), который необходим для работы search: каждый удачный поиск сдвигает указатель дальше по ленте.

16.3. Оператор fact

fact приход товара, K, Q
fact передача товара, K, Q

Так, файл-коэффициент прихода товара заносит факт «приход товара, код, количество», а файл-коэффициент передачи — факт о передаче. Дальше отчётные формы работают уже с этой лентой.

16.4. Поиск: rewind facts и search

rewind facts

Тонкости образца:

• Если образец содержит только ?переменная — подходящим является каждый факт (так печатают всю ленту).
• Если частей в образце больше, чем частей в подходящем факте, переменным из избыточных частей присваивается строковое значение NO ELEM.
• Признак результата — функция [success] (см. 16.13): 1 при удаче, 0 при неудаче.
• Дату операции найденного факта дают функции [fact_y], [fact_m], [fact_d].

Форма list0.rpt — печать всей ленты фактов без отметок о датах:

* Все элементы списка без отметок о датах
rewind facts
:L
search ?X, ?Y, ?Z
! [success] = 1
^^^^^^^^^^^^^^^^^^^^^X ^^^^^^^^^Y ^^^^^^^^^^Z
goto L
!
* конец формы

Форма list1.rpt — поиск по образцу с константой и с датами (только передачи товара A11):

* Только передачи товара A11 с датами передач
Y='A11'
rewind facts
:L
search передача товара, Y, ?Z
! [success] = 1
M=[fact_m]; D=[fact_d]
^D ^M передача товара ^^^^^^^^^Y ^^^^^^^^^^Z
goto L
!
* конец формы

fact приход товара 'A12'
...
b1=0
rewind facts
search приход товара ?b1

16.5. Оператор news: последняя «новость»

Форма list2.rpt — когда был последний приход товара A12:

* Поиск последнего подходящего факта - "новости"
news приход товара, 'A12', ?Z
! [success] = 1
M=[fact_m]; D=[fact_d]
^D ^M приход товара A12 ^^^^^^^^^^^Z
!
* конец формы

16.6. Оператор total: суммирование по фактам

* Сколько всего было передано товара с кодом A11 ?
S=0
total передача товара, 'A11', ?S
Всего отгружено A11: ^^^^^^^^^^S
* конец формы

16.7. Вычеркивание фактов: erase и nerase

fact приход товара 'A12'
...
b1=0
rewind facts
nerase приход товара ?b1

16.8. Выборка и сортировка: select, sort buffer, rewind buffer

Лента фактов упорядочена по датам операций, а select позволяет просматривать подходящие факты в ином порядке — например, по возрастанию какой-то части факта или по алфавиту. Для этого найденные факты помещаются во временный список buffer, который можно отсортировать и обойти.

sort buffer 3    * по третьей части факта, по возрастанию

Форма list5.rpt — все передачи товара, упорядоченные по количествам:

* Перечень всех передач товара с упорядочением
* по количествам
select передача товара, ??, ??
sort buffer 3
rewind buffer
:L
search передача товара, ?Y, ?Z
! [success] = 1
M=[fact_m]; D=[fact_d]
^M ^D передача товара ^^^^^^^^Y ^^^^^^^^^Z
goto L
!
* конец формы

16.9. Интервал дат: оператор range

rewind facts range 1.06,1.06

Правила интерпретации границ:

• Границы трактуются просто как числа: DD=0 или DD=1 означают начало месяца MM; DD=31 или больше — конец месяца независимо от его реальной длины.
• news игнорирует меньшую границу и ищет от конца интервала до начала ленты.
• Обычный rewind facts границы интервала не отменяет.
• Удобно использовать предопределённые переменные MF, ML (первый и последний месяц отчётного периода) и DF, DL (первый и последний день). Границы отчётного периода каждый клиент устанавливает для себя (в CLWP — клавишами Ctrl+O).

16.10. Шаблоны поиска: {}-способ и `-способ

Образцы для search, news, erase, nerase, select и total не обязаны заново перечислять все части факта. Есть два способа формировать шаблон гибче.

{}-способ. Вместо полной записи прототипа (выражение / ?переменная / ?? для каждого поля) указывается несколько пар выражений в фигурных скобках; выражения внутри пары разделяются запятой:

• первое выражение пары — числовое: номер поля факта;
• второе — желаемое значение этого поля.

Поля, не «охваченные» парами, на поиск не влияют (эквивалентны ??). Например, вместо

search Товар ??, X, ??, Y

можно записать:

search Товар {3,X} {5,Y}

Номера полей могут быть сколь угодно сложными выражениями — это позволяет динамически формировать шаблоны:

? X по какому полю искать
? Y значение поля
news Товар {X,Y}

Прототип факта можно не указывать вообще — news {X,Y} ищет любой факт, у которого в поле с номером X значение Y. Первое слово прототипа — это просто поле факта с номером 1, поэтому записи эквивалентны:

news {1,'Товар'} {X,Y}
news Товар {X,Y}

`-способ (обратный апостроф, код 96). Наряду с традиционными указаниями полей (??, ?переменная, выражение) в шаблоне можно использовать конструкцию

`выражение

Если такое выражение выдаёт строку или число, поведение будет таким, как если бы эта строка или число находились в тексте шаблона вместо выражения — шаблон формируется косвенно, в момент поиска. Например, если на вопросы формы ничего не отвечать (три раза Enter), будет выполнен поиск search q ?A, ?B, ?C; а если на вопрос «Имя?» ответить «Вася», это будет понято как search q 'Вася', ?B, ?C.

16.11. Прототипы фактов: файл proto.rpt

Синтаксисом записи фактов можно управлять, описав в файле proto.rpt прототипы фактов. В прототипе знак % обозначает место части факта, а всё остальное (например, запятые) — разделители между частями:

**********************************
приход товара, %, %
передача товара, %, %
**********************************

Прототипы могут быть гораздо выразительнее — факт читается как обычная фраза:

************************************************
товара % есть % единиц по цене %
поставщик % передал % единиц товара % на сумму %
************************************************

Тогда в файле-коэффициенте пишут fact товара T есть Q единиц по цене P, а в форме — total поставщик Z передал ?? единиц товара ?? на сумму ?S. Сервер автоматически проверяет соответствие прототипов из proto.rpt и фактов, использованных в файлах форм.

16.12. ta-факты: детальная информация о проводках

ФБП:Сервер может самостоятельно запоминать через механизм фактов детальную информацию о каждой выполненной проводке. Это даёт возможность видеть проводки операций, анализировать счета, получать оборотные ведомости за любой период — без написания собственных fact-записей.

Пример: при обработке операции с ключом CAAA-170 выполняется проводка «дебет X, кредит Y, сумма 100», после которой остаток X становится 1100, остаток Y — 900. Сервер добавит два факта:

fact ta 'X', 100, 0, 'Y', 1100, 'CAAA-170'
fact ta 'Y', 0, 100, 'X', 900, 'CAAA-170'

Структура прототипа ta (на примере первой записи):

Для второй записи роли зеркальны: счёт Y, кредитование 100, корреспондент X, остаток 900.

На ta-фактах построены встроенные в Сервер формы:

__SYS000 * Список проводок по операции
__SYS001 * Обороты счетов
__SYS002 * Обороты субсчетов
__SYS003 * Анализ счета
__SYS004 * Анализ корреспонденции
__SYS005 * Корреспонденции счета синтетически
__SYS006 * Корреспонденции счета детально

Управление режимом:

• Сервер может работать как с запоминанием ta-фактов, так и без него; запоминать их можно не во всех месяцах — диапазон месяцев указывается при запуске Сервера.
• При включённых ta-фактах возможен просмотр проводок в операциях по F6 (в журнале операций CLWP).
• В режиме с ta-фактами потребность Сервера в оперативной памяти существенно увеличивается.
• Если ta-факты отключены, для форм __SYS... границы выбранного периода выравниваются на начало и конец указанных месяцев.

Через ta-факты можно строить собственные формы. Например, обороты между счетами X и Y за период в днях (аналог функции [op X,Y]):

**** пример формы ****
S=0
if DF=0 DF=1; endif
if DL=0 DL=31; endif
rewind facts range MF+DF/100, ML+DL/100
total ta 'X',?S, ??, 'Y', ??, ??
^^^^^^^^S^^
**** конец формы ****

А так считаются обороты по дебету счёта X (аналог [od X]):

**** пример формы ****
S=0
if DF=0 DF=1; endif
if DL=0 DL=31; endif
rewind facts range MF+DF/100, ML+DL/100
total ta 'X',?S, ??, ??, ??, ??
^^^^^^^^S^^
**** конец формы ****

16.13. Функции ленты фактов

Эти функции используются и в файлах-коэффициентах, и в отчётных формах — они сообщают о результатах операторов поиска.

news приход товара, 'A12', ?Z
! [success] = 1
Дата последнего прихода: ^[fact_d].^[fact_m]

M=[fact_m]; D=[fact_d]
^D ^M передача товара ^^^^^^^^^Y

Функция позволяет обрабатывать факт целиком, не расписывая шаблон по полям. Вместо:

news Товар ?X, ?Y, ?Z, ?T
if [success]
^^^^^^^^^^^^^^^X ^^^^^^^^^^^^^^^Y ^^^^^^^^^^^^^^^Z ^^^^^^^^^^^^^^^T
endif

можно записать:

news Товар ??,??,??,??
if [success]
for i=1 to [fact_f 0]
x=[fact_f i]
^^^^^^^^^^^^^^^x \
endfor
endif

Это особенно удобно при большом количестве полей и при записи шаблона без указаний ?переменная (форма ??) — в том числе в сочетании с {}-способом (см. 16.10).

16.14. Производительность при работе с фактами

• Файл-ключ fastfact (см. главу 8 части I; прежняя опция «Быстрые факты»): лента фактов индексируется, и search, news и другие поиски выполняются за малое постоянное время; платой служит замедление оператора fact примерно в два раза и рост расхода памяти. Внешняя логика операторов не меняется.
• Индексация по датам: rewind facts range выполняется за малое постоянное время — всегда задавайте интервал дат, если он известен.
• nerase вместо erase там, где вычёркивается один факт, — очень значительный выигрыш во времени пересчёта.

17. Функции: данные учёта

Эта глава — первая часть справочника функций языка форм. Здесь собраны функции, которые читают данные бухгалтерского учёта: остатки и обороты счетов, суммы проводок, параметры субсчетов, наименования и обозначения. Именно они — «рабочая лошадка» почти любой отчётной формы: чтобы построить отчёт, вы запрашиваете у сервера числа через эти функции и выводите их форматными вставками (см. главу «Текст и вывод»).

17.1. Как вызываются функции

Обращение к функции заключается в квадратные скобки: внутри сначала идёт имя функции (обычно двухбуквенное), затем через запятые — параметры: обозначения счетов, номера месяцев и т.п. Параметры-месяцы могут быть не только числами, но и формулами и переменными:

[EA 51]        - остаток счета 51 на конец отчетного периода
[OK 70]        - оборот счета 70 по кредиту за отчетный период
[OK 70,M,L]    - оборот счета 70 по кредиту с месяца M по месяц L
                 (M и L - имена переменных)

Три понятия, без которых нельзя читать дальше:

• отчётный период — интервал месяцев, для которого строится форма; если в функции месяц не указан, берётся именно он;
• файл-коэффициент — программа, выполняющаяся внутри регистрируемой операции; ряд функций (AD/AK/MD/MK/AP/MP) ведёт себя в нём иначе, чем в отчётной форме;
• развёрнутое сальдо — для счёта с субсчетами это сумма односторонних (только дебетовых или только кредитовых) остатков его субсчетов.

17.2. Остатки по счетам (сальдо)

Шесть функций сальдо имеют одинаковый синтаксис: [XX xx] или [XX xx, mm], где xx — обозначение счёта, mm — номер месяца (число или формула). Без mm берётся отчётный период. Мнемоника имён: B — beginning (начало), E — end (конец); вторая буква: A — остаток «со знаком», D — по дебету, K — по кредиту.

Было на счете 50 на начало: ^^^^^^^^^^[ba 50]

Остаток на счете 51: ^^^^^^^^^^^^^[ea 51]

* задолженность перед поставщиками (счет 60)
Итого мы должны: ^^^^^^^^^^^^^^^[ek 60]

17.3. Обороты по счетам

Обороты отвечают на вопрос «сколько прошло по счёту», а не «сколько на нём осталось». У функций AD/AK/MD/MK — двойная семантика: в отчётной форме они смотрят на прошлое относительно конца отчётного периода, а в файле-коэффициенте — относительно текущей проводки регистрируемой операции.

* поступления в кассу за год
Поступило: ^^^^^^^^^^^^^^^[od 50]

[OK 70,M,L]   * оборот счета 70 по кредиту с месяца M по месяц L

17.4. Суммы проводок между счетами

Эти функции отвечают на вопрос «сколько прошло между двумя конкретными счетами» — например, сколько оплатил данный покупатель через данный расчётный счёт.

* сколько оплачено поставщику 60-01 с р/счета 51
Оплачено: ^^^^^^^^^^^^^^[op 51, 60-01]

17.5. Параметры субсчетов

Субсчета могут иметь параметры — значения, задаваемые при редактировании счетов и начальных условий (например, адрес склада, договорная цена). Параметры нумеруются с 1. Это не то же самое, что экстрапараметры [set]/[get] — о них глава «Экстрапараметры и дисковая база».

[BP xx]        - значение 1-го параметра субсчета xx на начало отчетного периода
[BP xx, nn]    - значение nn-го параметра на начало отчетного периода
[BP xx, nn, mm]- значение nn-го параметра на начало месяца mm

17.6. Обозначения и наименования

Отчёт, состоящий из одних чисел, нечитаем. Эти функции возвращают строки — обозначения и наименования счетов, чтобы подписать строки и колонки отчёта.

Счет ^^^^^^^^^[n1 50] — ^^^^^^^^^^^^^^^^^^^^[n2 50]

17.7. Сведения о счетах

17.8. Доступ к журналу операций и ta-фактам

Иногда из формы нужно добраться не до итоговых цифр, а до самих операций — например, показать в отчёте документы, относящиеся к событию, или журнал операций в нестандартном виде. Для этого служат функции [ta] и [jf].

[jf 'o key=GAAA-001']
[jf 'o key=G7']
[jf 'all mc=1,12']

18. Функции: ввод данных и оформление чисел

Отчётная форма — это не только печать цифр: часто перед построением отчёта нужно спросить пользователя «за какой месяц?», «по какому контрагенту?», «продолжать?». Для таких диалогов служат функции ввода — они показывают окно или меню и возвращают ответ пользователя как обычное значение, которое можно присвоить переменной. Вторая половина главы — функция [sn] и спецкомментарии, управляющие тем, как числа превращаются в строки (разделители тысяч, дробная часть).

18.1. Функции ввода: диалоги с пользователем

Все пять функций ввода вызываются в правой части присваивания и возвращают результат — число или строку. По сравнению с оператором вопроса (см. главу «Операторы») они компактнее: вопрос, значение по умолчанию и приём ответа умещаются в одну строку. Окна ввода показывает ФБП:Клиент CLWP.

A=[IY 'Продолжить дальше?']

A=[IR 'Введите номер поручения:',X,0]

A=[IS 'Введите название фирмы:',A,20]

A=[IM 'Тип счета:','активный','пассивный','внебалансовый']

A=[IA 70]
B=[IA План]

18.2. Функция [sn]: число в строку по формату

Форматные вставки (^^^^) оформляют числа «по своему усмотрению», а [sn] позволяет задать формат явно: длину строки и количество знаков после точки. Это нужно, когда число вставляется внутрь другой строки или требуется точное выравнивание.

a=[sn 1200.345,17,3]
^^^^^^^^^^^^^^^^a

18.3. Спецкомментарии, управляющие [sn] и форматными вставками

Пять специальных комментариев переключают два независимых свойства вывода чисел: показывать ли дробную часть и разделять ли тысячи запятыми. Они действуют и в отчётных формах, и в файлах-коэффициентах — от места появления до конца формы либо до отменяющего комментария.

По умолчанию действует сочетание «запятые есть, дробной части нет» (*,on + *.off). Полный пример из руководства:

a=[sn 1200.345,17,3]
^^^^^^^^^^^^^^^^a
*.on
*,on
a=[sn 1200.345,17,3]
^^^^^^^^^^^^^^^^a
*.off
*,on
a=[sn 1200.345,17,3]
^^^^^^^^^^^^^^^^a
*.on
*,off
a=[sn 1200.345,17,3]
^^^^^^^^^^^^^^^^a
*.off
*,off
a=[sn 1200.345,17,3]
^^^^^^^^^^^^^^^^a

Результат выполнения формы:

1,200
1,200.345
1,200
1200.345
1200

19. Функции: строки, даты, математика, файлы, система

Заключительная часть справочника функций: всё, что не относится напрямую к данным учёта — работа со строками и числами, даты и время, математика, сведения о системе и пользователях, вызов внешних программ и файловые сервисы.

19.1. Строки

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

n2=[ps 'klw','ghiklwstr']
^^^n2

a=[intsn yc]
^^^^a

F1=[CH 27]+'M'
^^^^F1

19.2. Числа: целая и дробная части, округление, число прописью

[tr ([ce 12.3456]+0.5)]   = 35

19.3. Даты и время

19.4. Режим выполнения и контекст

Одна и та же программа может выполняться как отчётная форма, файл-коэффициент или первичный документ — и функции этой группы позволяют узнать, «где мы», кто пользователь и что передано форме извне.

![re]>0
Это не отчетная форма, а файл коэффициент
stop

19.5. Математика с 3.22

Группа математических функций: тригонометрия, корень, модуль и перевод между градусами и радианами. Аргументы тригонометрических функций — в радианах.

* синус 30 градусов
x=[fsin [rad 30]]

n=4
for i=1 to n
for j=1 to n
[a (i-1)*n+j, 1/(i+j-1)]
endfor
endfor
x=[det a,n]
^^^^^^^^^x^^^^^^^^^^^^^^

19.6. Кодировки и внешний мир

19.7. Файлы и система

19.8. Табличный вывод V01.02

[table 'open','T']
[table 'column','T','Код',6]
[table 'column','T','Наименование',20,'left']
[table 'header','T']
[table 'row','T','A-001','Товар первый']
[table 'row','T','A-002','Товар второй']
[table 'close','T']

┌──────┬────────────────────┐
│ Код  │    Наименование    │
├──────┼────────────────────┤
│A-001 │Товар первый        │
│A-002 │Товар второй        │
└──────┴────────────────────┘

for i=1 to n
[table 'row','T',K,N]
endfor

[table 'open','N']
[table 'column','N','Остаток',10,2]
[table 'header','N']
[table 'row','N',1250.5]
[table 'row','N',-1250.5]
[table 'close','N']

┌──────────┐
│ Остаток  │
├──────────┤
│   1250.50│
│  -1250.50│
└──────────┘

[table 'column','T','Наименование',12,'left','wrap']
[table 'column','T','Наименование',12,'wrap']  * то же самое, left по умолчанию

[table 'open','T']
[table 'column','T','Код',6]
[table 'column','T','Наименование',12,'wrap']
[table 'header','T']
[table 'rowsep','T']
[table 'row','T','A-001','Очень длинное название товара']
[table 'row','T','A-002','ABCDEFGHIJKLMNO']
[table 'close','T']

┌──────┬────────────┐
│ Код  │Наименование│
├──────┼────────────┤
│A-001 │Очень       │
│      │длинное     │
│      │название    │
│      │товара      │
├──────┼────────────┤
│A-002 │ABCDEFGHIJKL│
│      │MNO         │
└──────┴────────────┘

20. Обращения к счетам: @-обращения и контекст

Когда бухгалтер вводит операцию, дерево видов операций может потребовать уточнить, какой именно субсчёт участвует в проводке — например, какое подотчётное лицо по счёту 71 или какой товар по счёту 41. Такое требование записывается в листе дерева @-обращением — знаком @ перед обозначением счёта (@71, @41). Программа покажет список субсчетов, пользователь выберет нужный, и его обозначение будет подставлено в проводку. @-обращения позволяют держать дерево видов операций компактным: вместо отдельной ветви на каждый субсчёт достаточно одной ветви с @-обращением.

Эта глава объясняет, как устроен показ списков субсчетов (и как его программировать самому), как управлять поведением форм @-обращений словами pragma и multiline, как формы узнают об «окружении» регистрируемой операции через функцию [ct] и контексты, и как работают *-подстановки в сетевой версии ФБП.

20.1. Как выполняется @-обращение

Обнаружив в листе дерева @-обращение (скажем, @71), ФБП:Клиент посылает Серверу директиву R 71, рассчитывая, что в каталоге данных есть форма 71.RPT, которая построит список субсчетов — обычно циклом по субсчетам счёта. Если такой формы нет, список субсчетов выводится внутренними средствами Сервера — но при этом показ параметров отсутствует.

Вот типичная форма, отвечающая за @-обращение к счёту 71 (подотчётные лица):

* Список подотчетных лиц (форма 71.RPT)
#71 цикл по субсчетам
N=[n1 #] извлекаем обозначение текущего субсчета
M=[n2 #] извлекаем наименование текущего субсчета
^^^^^^^^^N ^^^^^^^^^^^^^^^^^^^M
^^^^^^^^^^^^^^^^^^^^
^^^^^^^^^^^^^^^^^^^^
^^^^^^^^^^^^^^^^^^^^
#
* конец формы

Здесь работают знакомые средства: цикл #71 … # (см. главу «Операторы»), функции [n1 #] и [n2 #] — обозначение и наименование текущего элемента цикла (см. главу «Функции: данные учёта»). Пустые строки-«рамки» из ^ внизу оставляют место, чтобы пользователь мог выбрать строку мышью или клавишами.

20.2. @-обращения в формулах и файлах-коэффициентах

@-обращение — это не только «показать список»: выбранным субсчётом можно пользоваться в формулах листа дерева. Например, в листе переоценки материалов остаток выбранного субсчёта счёта 10 получают прямо в формуле проводки:

@10 88 [EA @10] * (К-1)

В проводках, выполняемых оператором проводки в файле-коэффициенте, тоже могут участвовать @-обращения к счетам с субсчетами (наряду со счетами без субсчетов, собственно субсчетами, *-обращениями к переменным и текущим субсчётом # цикла). Но здесь действует важное правило:

20.3. Ключевое слово pragma: ответ на меню формы из дерева

Форма @-обращения может начинаться с меню (функция [im…]), и от выбранного пункта зависит дальнейший ход её выполнения. Ключевое слово pragma позволяет ответить на это меню прямо из дерева видов операций: для одного вида операции форма покажет полный список, для другого — только часть, хотя используется одна и та же форма.

Пусть форма 41.RPT начинается с меню:

* начало формы 41.RPT
A=[im 'Меню показа','весь список товаров','только имеющиеся на складе']
! A=1 goto ...
! A=2 goto ...
....
* конец формы 41.RPT

Требуется: для операции «Товары-прием на склад:» выбирать пункт 1 («весь список»), а для «Товары-резервирование:» — пункт 2. Для этого в соответствующих листьях дерева после проводок ставится псевдокомментарий с ключевым словом pragma и номером нужного пункта меню.

20.4. Ключевое слово multiline: куда вводить многострочные ответы

Если при вводе операции на вопросы (ветви-вопросы дерева или поле ввода суммы) дан неопределённый ответ — ничего не ввели, просто нажали Enter — то клиент показывает столбцы для многострочного ввода ответов. По умолчанию эти столбцы накладываются на результат выполнения формы, соответствующей первому @-обращению в листе дерева.

Слово multiline, указанное в нужном месте листа дерева, переадресует столбцы ввода ответов к другому @-обращению — например, если именно его форма (41.RPT) выводит удобный для многострочной пометки список. multiline можно сочетать со словом pragma в том же листе.

20.5. Функция [ct] и контексты операции

Контекст формируется во время ввода хозяйственной операции: с его помощью в отчётные формы, отвечающие за списки объектов учёта, передаётся «окружение», в котором регистрируется операция. Функция [ct] возвращает значение контекста в отчётной форме.

* в форме 41.rpt — результаты выбора @62 и @S
A62=[ct '62']
AS=[ct 'S']

Существует несколько видов контекстов операции:

Пример с ответами на вопросы: пусть в дереве есть ветви платежка и сумма, в баллоне к первой указано ·R FORM1, в баллоне ко второй — ·R FORM2. Тогда передать в форму FORM2 результат выбора из FORM1 можно вызовом [ct 'платежка']. (В формах FORM1 и FORM2 первая строка — заголовок, а текст формы должен быть «прижат» к левой стороне экрана.)

Контекст MODOKEY: дата и ключ регистрируемой операции

Уникальный ключ операции присутствует, если операция перебивается (штампуется). Контекст MODOKEY разбирается так (месяц, день, код операции):

CT=[ct 'MODOKEY']                  - получаем контекст
MO=[vl [cp CT,1,2]]                - месяц
DO=[vl [cp CT,3,2]]                - день
K=[ch 64+MO]+[cp CT,5,3]+'-'+[cp CT,8,3]  - код операции

Типичная задача, которую решает MODOKEY, — данные вносятся «в прошлое». Пусть цена товара зависит от курса доллара, и форма 41.rpt должна показывать курс на день регистрации операции, а не последний введённый. Фрагмент news курс доллара ?d дал бы курс на текущую дату — это неправильно. Решение — взять дату из контекста и ограничить поиск фактов (лента фактов подробно рассмотрена в главе «Лента фактов»):

* фрагмент формы 41.rpt — курс доллара на дату операции
CT=[ct 'MODOKEY']
MO=[vl [cp CT,1,2]]
DO=[vl [cp CT,3,2]]
if [type MO] MO=MC; endif
if [type DO] DO=DC; endif
rewind facts range 1.01,MO+DO/100
news курс доллара ?d
Курс доллара ^^^^d^^^ ^^^^DO

Здесь курс хранится фактами вида fact курс доллара d (в файле-коэффициенте вида операций «Новый курс доллара»). Если форма выполняется вне ввода операции, контекста нет — [vl …] вернёт строку, и проверки [type …] подставят текущие MC и DC. При регистрации операции, скажем, 12 марта форма покажет курс, действовавший именно на 12 марта.

20.6. Аргументы и фильтры форм @-обращений

Для каждой формы (*.rpt) в клиенте CLWP можно определить свой набор аргументов и связать поведение формы с их значениями — аргументы доступны форме как [f1] и [f2] (см. главу «Функции: строки, даты, математика»). Это удобно для фильтрации длинных списков: одна и та же форма показывает разные подмножества субсчетов в зависимости от выбранного аргумента.

Пример: на счёте 41 учитываются товары, а признаком группы служит пятый символ обозначения субсчёта:

Счета и начальные условия:
41 [А] Товары
41-01000 Пиво Жигулевское
41-01001 Пиво Бадаевское
41-01002 Пиво Клинское
41-02000 Колбаса вареная
41-02001 Сосиски
41-02002 Сардельки

Пятый символ 1 — группа «Напитки», 2 — «Колбаса». В клиенте (пункт «Опции → Аргументы и фильтры…», см. п. 4.12) для аргумента «Напитки» задаётся [f1]=1, для «Колбасы» — [f1]=2; переключаются аргументы прямо в открытой форме клавишами Shift+F1…Shift+F9. Форма отбирает субсчета по аргументу:

*** пример формы 41.RPT ***
Список товаров:
#41 - перебрать в цикле все субсчета счета 41;
T3=[cp[n1 #],5,1] - "вырезка" из обозначения субсчетов 5-го символа;
if [f1]=T3 - проверка аргумента [f1] и "вырезанного" символа;
T1=[n1 #] - обозначения субсчетов;
T2=[cp[n2 #],1,16] - наименования субсчетов, ограниченное 16-ю символами;
^^^^^^^T1 ^^^^^^^^^^^^^^T2
endif
#
*** конец формы 41.RPT ***

Особенности клиента CLWP:

• режим Фильтров даёт более тонкий отбор, чем один аргумент: фильтр применяется к уже полученному тексту формы и оставляет строки с заданными отрывками. Например, из группы «Колбасы» можно отобрать субсчета, начинающиеся с отрывка «Сард», и определить для них фильтр «Сардельки».

20.7. *-подстановки и файл-ключ FREE-AT

*-подстановка счёта (имя счёта подставляется из переменной или ответа на вопрос) в сочетании с @-обращением в сетевой версии ФБП ограничена:

Две типовые формы, заменяющие *-подстановку. Первая выводит сразу весь план счетов вместе с субсчетами (цикл #План, функции [as #] — число субсчетов текущего счёта, [sa #,i] — обозначение i-го субсчёта):

Счета и субсчета:
#План - перебрать в цикле весь план счетов;
b1=[n1 #] - обозначение счета;
b2=[cp[n2 #],1,25] - наименование счета, ограниченное 25-ю символами;
^^^^^^^b1 ^^^^^^^^^^^^^^^^^^^^^^^b2
...................................
if [as #]>0 - если счет имеет субсчета, то:
for i=1 to [as #] - для всех субсчетов
s1=[sa #,i] - обозначение субсчета;
s2=[cp[n2 *s1],1,25] - наименование субсчета, ограниченное 25-ю символами;
^^^^^^^s1 ^^^^^^^^^^^^^^^^^^^^^^^s2
endfor
...................................
endif
# - конец цикла по плану счетов.

Вторая форма уточняет выбор последовательно — сначала счёт, потом субсчёт ([ia …] — меню выбора из плана счетов или списка субсчетов):

Счета и субсчета:
a=[ia План] - показать меню из всего плана счетов;
if [as *a]=0 - если счет не имеет субсчетов, то
b1=[n1 *a] - обозначение счета;
b2=[cp[n2 *a],1,25] - наименование счета, ограниченное 25-ю символами;
^^^^^^^b1 ^^^^^^^^^^^^^^^^^^^^^^^^^b2
else - если счет имеет субсчета, то
a=[ia *a] - вывод меню из списка субсчетов;
s1=[n1 *a] - обозначение субсчета;
s2=[cp[n2 *a],1,25] - наименование субсчета, ограниченное 25-ю символами;
^^^^^^^s1 ^^^^^^^^^^^^^^^^^^^^^^^^^s2
endif

Пример: деньги в кассу поступают от покупателей (61), подотчётных лиц (71) и разных дебиторов (76). Без послабления нужны три ветви:

50 @61
50 @71
50 @76

С ключом FREE-AT достаточно одной ветви 50 @X и формы X.RPT, которая сначала спрашивает счёт, а затем разлистывает его субсчета (цикл #*A — по субсчетам счёта, чьё имя в переменной A):

Заголовок
A=[im 'какой счет','61','71','76']
if A=1 A='61'; elseif A=2 A='71'; else A='76'; end
*
#*A
n=[na #]
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^n
#

Условия: в плане счетов должны быть и 61, и 71, и 76, и X — все с субсчетами (для фиктивного счёта X достаточно одного фиктивного субсчёта). Выбранный субсчёт подставляется в фразу операции, а FREE-AT отключает проверку родителя. Дерево при этом сокращается втрое.

* доработанная X.RPT — запоминает счёт-родитель
Заголовок
A=[im 'какой счет','61','71','76']
if A=1 A='61'; elseif A=2 A='71'; else A='76'; endif
[sed [user] + ' parent account',A]
*
#*A
n=[na #]
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^n
#

* форма MAKESUBA.RPT — создание субсчета нужного счета
p=[ged [user] + ' parent account']
if p = 0
Форма запущена вне ввода операции
stop
endif
a=[is 'Обозначение субсчета', ' ', 9]
n=[is 'Наименование субсчета', ' ', 20]
Подтвердите создание субсчета нажатием на строку ниже
N:ENTER:a ·#1·#2·#3 #4 #5 #6·
^^^^^^^^^p ^^^^^^^^^^a ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^n
[sed [user] + ' parent account', 0]

Строка [sed [user] + ' parent account',A] запоминает, кто запустил X.RPT, и обозначение счёта-родителя; [ged …] читает значение (и возвращает 0, если ничего не записано); запись 0 тем же ключом очищает его. В директиве N:ENTER:a ·#1·#2·#3 #4 #5 #6· знак · (код 250) — разделитель, а #1, #2… — подстановки параметров фразы операции (подробно о директивах N: — в главе «Директивы N:»). Теперь для создания субсчёта используют не встроенную команду списка, а пользовательскую клавишу: MAKESUBA.RPT знает, кто запустил X.RPT и какой счёт-родитель нужен.

21. Свои данные: экстрапараметры и дисковая база

Кроме остатков, оборотов и обычных параметров счетов программа на языке ФБП может хранить собственные данные двумя способами:

• экстрапараметры — дополнительные именованные значения, привязанные к счетам и субсчетам; они живут в оперативной памяти сервера и пересчитываются вместе с балансом (функции [set], [plus], [get]);
• дисковая база extrd.dat — произвольные пары «ключ → значение», которые сразу записываются на диск и сохраняются между сеансами (функции [sed], [ged]).

Экстрапараметры подходят для величин, которые должны автоматически пересчитываться при изменении прошлого (как и весь учёт ФБП), а дисковая база — для справочной информации, не зависящей от операций: реквизитов контрагентов, настроек и т.п.

21.1. Экстрапараметры: что это и чем они отличаются от параметров

Каждому счёту/субсчёту может быть сопоставлено неограниченное количество дополнительных параметров — числовых или строковых (обычных параметров у счёта не больше девяти, и меняются они только псевдопроводками присваивания). В отличие от обычных параметров, экстрапараметры открываются и модифицируются в файлах-коэффициентах произвольно, а их значения на любой момент времени — расчётная база для показателей отчётов.

21.2. Функции [set] и [plus]: запись экстрапараметров

[set X, n, ss]          * запомнить сумму ss под номером n

[plus 50, 'Итого', SS]  * накопить сумму проводки

Обе функции могут использоваться только в листьях дерева и файлах-коэффициентах — с одной оговоркой для отчётных форм (см. 21.3). Поскольку результат всегда 0, удобна сокращённая запись вызова ради побочного эффекта — оператор сразу со скобки, без фиктивного присваивания: [set X, n, ss] вместо y = [set X, n, ss].

21.3. [set]/[plus] в отчётных формах: фиктивный счёт % и оператор array %

В отчётных формах [set] и [plus] должны ссылаться на фиктивный счёт %, который следует определить в списке счетов. Обратное тоже верно: в файлах-коэффициентах и листьях дерева [set]/[plus] на счёт % ссылаться не должны. Применение — промежуточное накопление структурированной информации в отчётных формах: например, в разделе every debet формы-истории можно собирать суммы проводок, а в epilog — переносить их в массив и сортировать:

prolog
n=0
every debet
n=n+1
[set X, n, ss]
epilog
for i=1 to n
[a i,[get X, i]];
endfor
sort array a
for i=1 to n
y=[a i]
^^^^^^^^^^^y
endfor

array %

21.4. Функция [get]: чтение экстрапараметров

n=[get %,x]            * значение, накопленное формой
for i=1 to n
...

21.5. Дисковая база extrd.dat: [sed] и [ged]

Экстрапараметры пересоздаются при каждом запуске сервера, поэтому для данных, которые должны храниться постоянно (и не зависеть от пересчёта баланса), есть другой механизм — встроенное обращение к внешней дисковой базе данных, файлу extrd.dat (он создаётся автоматически в каталоге данных сервера). Данные могут быть числовыми и строковыми.

[sed [user] + ' parent account',A]   * запомнить, кто и что выбрал
[sed 'ИНН-' + [n1 #], inn]

p=[ged [user] + ' parent account']
if p = 0
Форма запущена вне ввода операции
stop
endif

Обе функции можно использовать в листьях дерева, файлах-коэффициентах, отчётных формах и первичных документах. Типичная область применения — запоминание справочной информации (реквизиты контрагентов: ИНН, банк) для автоматического заполнения платёжек, счетов-фактур и др.: одна форма записывает реквизиты через [sed …], другая извлекает их через [ged …]. Файл extrd.dat — текстовый, его можно посмотреть любым просмотрщиком.

21.6. Замечания о быстродействии дисковой базы

Файл-ключ fastged в каталоге данных сервера включает зеркало extrd.dat в оперативной памяти — это ускоряет функцию [ged …] в 10–20 раз. Если формы много читают из дисковой базы, ключ окупается.

22. Виды операций и проводки: программируем учёт

До сих пор мы говорили о языке отчётных форм — о программах, которые читают данные учёта. Эта глава — о том, как данные в учёт попадают: о дереве видов операций. Дерево — это тоже программа на языке ФБП, только специального назначения: она определяет, какие вопросы задаст программа при вводе хозяйственной операции и какие бухгалтерские проводки выполнит по ответам. Именно здесь «программируется учёт» — схемы проводок, аналитика, расчёт сумм. Именно поэтому изменение дерева приводит к виртуальному пересчёту всего журнала операций (см. главу 9): операции хранят только ответы, а проводки вычисляются по правилам дерева каждый раз заново.

22.1. Дерево видов операций: фразы, ветви и листья

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

Например, дерево из ветвей «Расчётный счёт» → «приход» → «сдана касса» и «Расчётный счёт» → «расход» → «передано в кассу» порождает две фразы-вида операций. При вводе операции бухгалтер «выкладывает» такую фразу, выбирая пункты меню, вводит сумму — и программа выполняет проводки из листа, соответствующего выбранной фразе.

Работа с деревом. Дерево видов операций открывается в клиенте CLWP по Alt+F6; здесь создаются новые ветви и редактируются листы с проводками. Ввод операции выполняется в журнале операций (Alt+F2, затем F7). Дерево хранится на сервере, а клиент получает его запросом T (см. главу «Язык запросов к серверу»).

22.2. Формат проводки: дебет, кредит и откуда берётся сумма

Лист дерева — это список проводок. Каждая проводка записывается одной строкой простого и строгого формата:

дебет кредит коэффициент/формула/файл-коэффициент

Здесь дебет и кредит — обозначения счетов (или заменяющие их конструкции: @-обращение, *-обращение, # в цикле). Третий элемент определяет сумму проводки, и тут есть три принципиально разных способа:

Пример листа дерева для фразы «Реализация»: первая проводка с числовым коэффициентом (на сумму операции, умноженную на 1), вторая — с формулой (НДС по ставке из переменной):

62 46
46 68-2 $*I/100

Максимальное количество проводок в одном листе дерева — 15. Если этого недостаточно, используйте оператор выполнения проводок в файле-коэффициенте (см. 22.8) — там ограничения на число проводок нет.

22.3. @-обращения: выбор субсчёта при вводе операции

Аналитический учёт в ФБП ведётся по субсчетам. Чтобы не писать отдельную ветвь дерева на каждого контрагента или сотрудника, в описании проводки можно сослаться на счёт, имеющий субсчета, с префиксом @:

@76 51

При вводе операции программа покажет меню из обозначений и названий субсчетов счёта 76; выбранный субсчёт будет ассоциирован с операцией и подставлен в проводку. Такой приём избавляет от однородных ветвей дерева: одна ветвь «Оплата от покупателя» с @76 заменяет десятки ветвей по каждому покупателю.

В одном листе допускается несколько @-обращений, причём к разным счетам:

@70 @69-1
@70 68-3

Если один и тот же счёт упоминается в листе с @-обращением несколько раз (здесь — @70), список субсчетов появится при регистрации операции только один раз: во все остальные проводки подставится уже выбранный субсчёт.

22.4. Ветви-вопросы: данные, которых нет в счетах

Не всё, что нужно для проводки, хранится на счетах: ставка налога, количество, номер документа — такие данные проще спросить при вводе операции. Для этого служит ветвь-вопрос:

?I ндс,%
?N количество

Например, ветвь ?I ндс,% спросит при вводе операции ставку НДС, а проводка 46 68-2 $*I/100 использует ответ в формуле. Помните: переменная $ (сумма операции) определена всегда, остальные переменные получают значения из ответов на ветви-вопросы.

22.5. Уточнения ветвей-вопросов: ·C, ·N, ·S, ·R, ·X

По умолчанию ветвь-вопрос показывает поле редактирования, куда ответ вводят с клавиатуры. Это поведение можно изменить: вместо свободного ввода предложить меню, потребовать число в диапазоне, преобразовать ответ в строку или показать целую форму-список. Уточнения записываются в тексте баллонной помощи ветви-вопроса. Разделитель · — средняя точка, символ с кодом 250 (вводится удержанием Alt и набором 250 на цифровом блоке клавиатуры).

·C·%·20·10·
·C·тип расхода·затрата·из прибыли·

·N·10·0·20·     * число от 0 до 20, по умолчанию 10

·R L
·S

·R 70       ( ·X 70 )
·R 10 ·1·   ( ·X 10 ·1· )

22.6. *-обращения: счёт из значения переменной

В описаниях проводок наряду с обозначениями счетов и @-обращениями можно использовать обращение вида:

* ветви-вопросы дерева:
?D дебет
?K кредит
* лист дерева:
*D *K

Как это работает: при регистрации операции на вопрос «дебет» ответим @76, а на вопрос «кредит» — 51. Программа предложит список субсчетов счёта 76; выберем, скажем, 76-01 Первый. Тогда переменная D получит значение 76-01, переменная K — значение 51, и проводка *D *K эквивалентна записи 76-01 51.

22.7. Ветви-циклы: одна операция — проводки по всем субсчетам

Часто нужно проделать однотипные проводки для всех субсчетов счёта: начислить амортизацию на все объекты счёта 01, переоценить материальные запасы при изменении курса, начислить зарплату всем сотрудникам. Для этого служит ветвь-цикл:

* ветвь дерева:
# 70 начисление зарплаты всем сотрудникам
* лист дерева (выполняется для каждого субсчёта счёта 70):
# 68-3 $*0.12

Обратите внимание на масштаб: в листе может быть до 15 проводок, значит для каждого субсчёта будет выполнена вся группа проводок. В журнале — одна операция, а проводки сделаны для всех субсчетов!

continue if [ep #]=0   * пропустить, если параметр субсчёта нулевой

break if $<0           * прекратить перебор при отрицательной сумме

22.8. Файлы-коэффициенты и оператор выполнения проводки

Когда сумму проводки нельзя выразить коэффициентом или короткой формулой — например, подоходный налог со шкалой и вычетами — алгоритм расчёта выносят в файл-коэффициент: обычный файл *.rpt с программой на языке форм. В проводке после дебета и кредита указывается имя этого файла. Создать файл-коэффициент можно прямо из дерева: допишите в строке проводки после пробела имя файла и откройте его на редактирование.

Соглашение о параметрах файла-коэффициента:

Вот настоящий файл-коэффициент tax.rpt — расчёт подоходного налога (в листе дерева проводка выглядит как @70 68-3 tax):

* Подоходный налог с физических лиц
*
D=[AK $D] Доход, начисленный сотруднику с начала года;
U1=[AP $D,68-3] Уже удержанный с начала года под/налог 9%,17% (город);
U2=[AP $D,68-31] Уже удержанный с начала года под/налог 3% (федер);
G=D*0.01 вычеты в Пенсионный фонд 1%
M=[ed MIN] Подлежащие вычету минимумы;
P=[ep @70] Сумма льгот, накопленная к моменту начисления;
if D in 0..10000 D=D-P-2*M; L=M*2
elseif D in 10000..30000 D=D-P-M; L=M
else D=D-P; L=0
endif
*
D=D-G учтем вычеты 1% в Пенсионный Фонд
...
J1=[tr T1-U2+0.5] доначисленный в этом месяце подоходный налог.
J2=[tr T2-U1+0.5]
$=J2
**** конец файла-коэффициента TAX ****

Здесь видны приёмы языка форм: комментарии (* в начале строки или текст после выражения), обращения к данным учёта в квадратных скобках ([AK $D] — накопленный оборот, [AP $D,68-3] — оборот между счетами, [ed MIN] и [ep @70] — экстрапараметр и параметр счёта, подробнее — в главах 17 и 21), условный оператор с проверкой диапазона in, несколько операторов в строке через ;. Результат возвращается присваиванием $=....

▒ 50 51 ($)
▒ 68-2 46 ($*0.18)

В проводках файла-коэффициента могут участвовать счета без субсчетов, собственно субсчета, @-обращения, *-обращения к переменным и текущий субсчёт # цикла. Ограничений на количество проводок в файле-коэффициенте нет — этим и обходят лимит в 15 проводок листа. Но два ограничения есть:

• из файла-коэффициента нельзя вызвать другой файл-коэффициент;
• все требуемые @-обращения должны быть описаны в листе дерева: при повторном @-обращении в файле-коэффициенте подставляются те же субсчета, что были выбраны в листе, — дополнительного выбора не происходит. Это связано с тем, что фраза операции «складывается» максимум из 12 «кирпичиков» (ветвей дерева и @-обращений), и ограничение действует также для проводок в файле-коэффициенте.

22.9. Псевдопроводки: параметры счетов, документы, горячие клавиши

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

22.9.1. Параметры счетов и псевдопроводка «=n»

У каждого счёта есть 9 параметров, связанных со всеми его субсчетами: параметр может выражать цену единицы материала, норму амортизации основного средства, процент налога, уплаченного при покупке объекта, и т.д. В формах значения параметров читаются функциями [bp ...] и [ep ...] (см. главу «Функции: данные учёта»). А изменять значения параметров можно динамически — псевдопроводками в листьях дерева:

* записать сумму операции в параметр 1 выбранного субсчёта счёта 41:
@41 =1
* увеличить параметр 3 на 5% от суммы операции:
@41 =3 [ep @41,3]+$*0.05

Для складских задач («а сколько этого товара есть сейчас?») при вводе операции полезен расчётный параметр: в плане счетов и начальных условий задаётся наименование расчётного параметра и формула его расчёта — например, для счёта 41 «Товары» формула остатка, делённого на цену из первого параметра, — и при вводе операции программа сразу показывает вычисленное количество. Тонкость: ссылаться на расчётный параметр в файлах форм нельзя.

22.9.2. Псевдопроводка «создать документ»

С операциями могут быть связаны первичные документы — накладные, ордера, счета — автоматически создаваемые при вводе операции. Формы документов пишутся на том же языке, что и отчётные формы и файлы-коэффициенты:

создать документ nakl @41
create document order

Как это устроено. Для хранения документов в каталоге данных должен быть подкаталог TXA, а на клиентских местах включена опция «Хранить первичные». При старте сервер создаёт в TXA 12 подкаталогов — по одному на месяц (A — январь … L — декабрь), и каждый документ (*.txa) хранится в подкаталоге своего месяца. Рядом сервер ведёт файл дескриптора *.des: первая строка — дата и время операции; если при пересчёте баланса штамп операции не совпадает с дескриптором, документ создаётся заново, а предыдущая версия дописывается в дескриптор — так накапливается вся история модификации документа. Документ, созданный операцией «в прошлом» или перебивкой, можно увидеть в журнале операций клавишей F4 (с задержкой, зависящей от скорости пересчёта).

В режиме ввода и просмотра операций первичные документы можно создавать, просматривать и удалять; в журнале слева от записи операции появляется символ, означающий, что для неё есть документ на диске.

F=[dir 1]+'TXA\'+[stamp 3]+'.TXA'
ЗАГОЛОВОК ДОКУМЕНТА >file F
строки документа >>file F

22.9.3. Псевдопроводка «горячая клавиша»

Для самых частых видов операций стоит организовать ускоренный ввод:

горячая клавиша Сдана касса

Для каждого пользователя можно организовать свой набор горячих клавиш — через переопределение системных запросов в форме USERS (см. главу «Директивы N:»). В клиенте CLWP горячих клавиш может быть до восьми.

22.10. Ограничения, редактирование дерева и ошибки компилятора

Соберём в одном месте числовые ограничения дерева видов операций — их полезно помнить при проектировании:

Редактирование дерева. В дереве доступен поиск отрывка по образцу. Дерево можно резать и клеить: отрезанный фрагмент ветви со всеми проводками временно сохраняется, а затем приклеивается в новом месте. Фрагменты дерева можно сохранять в файлах с расширением rul (удобно для переноса между настройками) и распечатывать.

Компилятор дерева обнаруживает большинство формальных ошибок «на первой секунде» попытки построить баланс. Вот его сообщения и их смысл:

22.11. Сквозной пример: от плана счетов до введённой операции

Пройдём весь путь настройки на маленьком, но законченном примере: учтём движение денег между кассой и расчётным счётом.

Шаг 1. Счета. В «Счетах и начальных условиях» заводим два счёта без субсчетов:

50 Касса
51 Расчетный счет

Шаг 2. Ветви дерева. Открываем дерево видов операций (Alt+F6) и создаём ветвь первого уровня Расчетный счет. Затем добавляем ветви второго уровня, повторяя действия для всего нужного: получаем ветви приход и расход, а внутри каждой — завершающие ветви сдана касса и передано в кассу. Дерево порождает две фразы:

Расчетный счет - приход - сдана касса
Расчетный счет - расход - передано в кассу

Шаг 3. Листы с проводками. Выбираем последнюю ветвь первой фразы (сдана касса) и открываем лист дерева. Деньги пришли на расчётный счёт из кассы, поэтому записываем проводку без коэффициента (по умолчанию он равен 1 — проводка на всю сумму операции):

51 50

Аналогично для фразы «расход - передано в кассу» лист будет зеркальным:

50 51

Шаг 4. Ввод операции. Переходим в журнал операций (Alt+F2), нажимаем F7 и Enter. После ввода даты и выбора положения операции в течение дня появляется меню из ветвей первого уровня — у нас это единственная ветвь «Расчетный счет»; далее — меню второго уровня («приход» / «расход») и третьего. Выкладываем фразу «Расчетный счет - приход - сдана касса», вводим сумму — и по F6 смотрим сделанные программой проводки: дебет 51, кредит 50, сумма операции.

Шаг 5 (развиваем пример). Аналитика и вопросы. Добавим аналитику по контрагентам и ставку НДС. Заводим счёт 76 с субсчетами-покупателями и строим вторую ветвь первого уровня:

Реализация
   ?I ндс,%            * ветвь-вопрос: ставка налога
   оплачено покупателем

В баллонной помощи ветви ?I ндс,% пишем уточнение-меню, чтобы ставку выбирали, а не вводили:

·C·%·20·10·

Лист для фразы «Реализация - ?I ндс,% - оплачено покупателем»:

51 @76
@76 68-2 $*I/100
горячая клавиша Оплата от покупателя

При вводе такой операции программа покажет меню ставок НДС (20 или 10), затем список субсчетов счёта 76 (один раз, хотя @76 встречается дважды), выполнит две проводки — оплату на всю сумму и выделенный налог по формуле $*I/100, — а кнопка «Оплата от покупателя» позволит в дальнейшем выкладывать фразу одним щелчком.

23. Управляющие строки N: — навигация и запросы из форм

Обычная отчётная форма — «слепок» данных: она показывает информацию, но не умеет реагировать на действия пользователя. Управляющие строки N: превращают форму в интерактивный экран: по нажатию клавиши из неё запускаются другие формы, открывается операция в журнале, регистрируются операции и заводятся субсчета — не выходя из отчёта. Формы со взаимными ссылками образуют настоящие приложения: список накладных, из которого по Enter открывается сама накладная, и т.п.

Механика такова: строки N:... в тексте формы не выводятся в отчёт, а запоминаются клиентом. Когда пользователь нажимает привязанную клавишу, клиент конструирует из шаблона строку запроса и посылает её серверу — так, будто запрос введён вручную в списке запросов (см. главу 7).

23.1. Синтаксис и распознаваемые клавиши

Строка управляющая, если начинается с N: (или n:) — регистр имени клавиши не важен. Клиент читает текст между первым и вторым двоеточием и сравнивает со списком известных клавиш:

23.2. Новые клавиши Shift+F1…Shift+F9

В прежнем клиенте девять сочетаний Shift+F1…Shift+F9 заняты переключением аргументов и фильтров формы. В CLWP форма может перехватить эти сочетания для своих целей:

N:SHIFTF1:R OST ·#1·
N:SHIFTF2:J KEY=#1

Приоритет таков: если для выделенной строки действует строка N:SHIFTFn:, нажатие Shift+Fn выполняет её запрос; если формой строка не определена — сочетание, как и прежде, переключает n-й аргумент/фильтр (см. главу 4). Таким образом, N:SHIFTFn: — способ дать форме до девяти дополнительных действий, не трогая занятые F1…F12 и Enter.

23.3. Область действия и цепочки запросов

Управляющая строка действует не на всю форму, а на строки отчёта, следующие после неё, — до ближайшей следующей строки на ту же клавишу, которая её заменяет. Это позволяет в разных частях одной формы назначить одной клавише разные действия:

N:F9:r test1
...
N:F9:r test2
...
N:F9:

Строка без запроса (N:F9: в конце примера) только помечает конец области действия прежней привязки и сама ничего не выполняет.

Цепочки (новое в CLWP). Если на одну клавишу в одной области действия назначено несколько строк, нажатие выполняет все их подряд, сверху вниз. Классический приём — открыть журнал по значению строки и закрыть форму:

N:ENTER:J KEY=#1
N:ENTER:#CLOSE

Директивы O (регистрация операции), A (заведение субсчёта) и D (удаление) из одной цепочки копятся и уходят серверу одним пакетом в конце цепочки; если показывать нечего, окно не открывается («невидимые формы»). Отказ E-… и однострочный ответ показываются сообщением. Цепочку обрывает команда #NULL (см. п. 23.7).

23.4. Динамические ссылки на данные строки: #1…#9

Главная сила управляющих строк — запросы, построенные из содержимого строки, на которой стоит курсор. Ссылки #1…#9 — номера слов выделенной строки. «Слова» выделяются так: если в строке есть разделители псевдографики │, разбивка идёт по ним, иначе — по пробелам; #1 — слово, начинающееся с крайнего левого положения.

Подстановка выполняется посимвольно и работает в любом месте запроса — например, J KEY=#1 подставит первое слово строки, приклеенное к KEY=:

N:ENTER:R F16 ·1·#1·#3·

Форма F16.rpt получит первое и третье слова выделенной строки как ответы на свои вопросы (знак ·, код 250, обрамляет ответы) — подхватить их можно функцией [ia ...]. Другой пример — переход из отчёта в журнал операций с установкой курсора на нужную операцию (если форма вывела её уникальный код первым словом строки):

N:ENTER:J KEY=#1

Правила подстановки:

• ## — литеральный знак #;
• #N — ровно одна цифра 1…9; #10 — это слово №1 и знак 0;
• ссылка на несуществующее слово даёт пустую строку; пустой результат у первого запроса цепочки обрывает цепочку, у остальных — пропускает запрос;
• #0 — особая ссылка: команда не исполняется, если строка начинается с пробела (без учёта псевдографики);
• подстановки нет у голых строк N: и N:AUTO: — при их выполнении строка отчёта ещё не выделена.

for i=1 to n
N:ENTER:R CARD ·#1·
[table 'row','T',K,N,[sn S,15,2]]
N:ENTER:
endfor

23.5. Автозапуск: N:AUTO:

Строка N:AUTO:запрос выполняется один раз на окно, сразу при первом показе формы — без нажатия клавиш; при последующих обновлениях формы она не повторяется. Туда ставят то, что нельзя выполнить дважды, — автоматическую регистрацию операции (O), заведение субсчёта (A):

N:AUTO:#CLOSE

В сочетании с #CLOSE получаются «невидимые» формы — например, форма обнуления экстрапараметров: выполняется и закрывается, не показываясь пользователю.

23.6. «Голые» строки N:

Строка N:запрос без имени клавиши выполняется при каждой загрузке и каждом обновлении формы (в отличие от одноразовой N:AUTO:). Это удобно для служебных действий, которые должны повторяться при перечтении: поддержание экстрапараметров, регистрация фактов просмотра и т.п.

N:R test2
N:>SetFirst.bat 1

Вторая строка примера — запуск внешней программы на машине клиента: запрос, начинающийся с >, серверу не передаётся.

23.7. Специальные команды: ##, #CLOSE, #0, #NULL

Проверки #NULL комбинируются: несколько команд #NULL подряд — условие И; несколько ссылок в одной команде — ИЛИ.

23.8. Пример: взаимодействующие формы LIST и NAKL

Классическая пара «список → документ». Форма LIST разлистывает список накладных, собранный фактами; по Enter на выбранной строке открывается форма NAKL с самой накладной:

N:ENTER:R NAKL ·#1·
p0=[user]
Список чеков пользователя ^^^^^^^^^^^^^^^^^^^^^^p0
i=1
:POVTOR
search оператор p0 накл ?nk сумма ??
if [success]=1
i=i+1
¦^^^^^^^^^nk¦
goto POVTOR
endif

По Enter выполняется форма NAKL, которая получает номер накладной (#1 — первое слово выделенной строки) и ищет его в ленте фактов:

* Накладная
?nk number
^^^^^^^^^^^^^^nk
t=[type nk]
if t=0 nk=[intsn nk]; endif
rewind facts
search оператор ?? накл [strip nk] сумма ?sm
if [success]=1
Н А К Л А Д Н А Я
номер: ^^^^^^^^^^nk сумма ^^^^^^^^^^^sm^^
endif

23.9. Форма USERS и переопределение системных запросов

Особая форма USERS (users.rpt) выполняется клиентом при входе, и все её запросы клиент отправляет серверу автоматически — так пользователю настраивают «рабочее место» сразу после подключения.

К системным запросам относятся, в частности, T (дерево видов операций), F (список форм на сервере) и встроенные системные формы __SYS001…__SYS006. В форме USERS их можно переназначить — например, по имени пользователя:

* Пример отчетной формы USERS:
if [user]='anyuser'
__SYS001 = __SYS01S
__SYS002 = __SYS02S
__SYS005 = __SYS05S
__SYS006 = __SYS06S
F='R FORMS'
^^^^^^^^^^^^F
endif

Здесь для пользователя anyuser вместо встроенных __SYS001, __SYS002 и т.д. выполняются собственные формы __SYS01S, __SYS02S и т.д., а вместо стандартного ответа на запрос F — форма FORMS.

23.10. Передача контекста между формами: [ct]

Формы, обслуживающие ветви-вопросы дерева видов операций (уточнения ·R/·X в баллонах), выполняются в контексте вводимой операции. Функция [ct s] возвращает в форме значение контекста с именем s — так форма второго вопроса может использовать ответ, выбранный в форме первого вопроса.

Разбор контекста MODOKEY (позиции 1–2 — месяц, 3–4 — день, 5–7 и 8–10 — части кода операции вида CAAA-002):

CT=[ct 'MODOKEY']                    - получаем контекст;
MO=[vl [cp CT,1,2]]                  - месяц;
DO=[vl [cp CT,3,2]]                  - день;
K=[ch 64+MO]+[cp CT,5,3]+'-'+[cp CT,8,3]  - код операции;

23.11. Типичные ошибки и подводные камни

24. Графика в формах

Отчётная форма умеет не только печатать текст, но и строить картинки: диаграммы, графики, схемы. Для этого изображение рисуется в массиве (по точкам, линиям и фигурам), а затем сохраняется в файл формата PNG оператором makepng. Дальше файл можно показать пользователю — например, вставить в web-страницу, которую строит форма, выполняемая через NULLCG.CGI (см. главу «Web-приложения через NULLCG.CGI»).

Всё рисование происходит в обычном массиве (см. главу «Массивы»): каждый элемент массива отвечает за одну точку изображения. Графические операторы — это удобная «обёртка» над массивом: они сами вычисляют нужные индексы и защищают от выхода за границы картинки.

24.1. Система координат и связь с массивом

Изображение — прямоугольник шириной w и высотой h точек. Действуют простые соглашения:

• все видимые точки имеют положительные целые координаты: 1 ≤ x ≤ w, 1 ≤ y ≤ h;
• левый верхний угол изображения — точка x=1, y=1 (ось Y направлена вниз, как принято в компьютерной графике, а не в математике);
• точке (x,y) соответствует элемент массива с индексом (y-1)*w + x;
• в описаниях синтаксиса ниже: a — латинская буква (имя массива), w,h — ширина и высота в точках, c — строка (код цвета).

Если элементу массива не присваивалось значение, при создании файла он считается равным [ch 0] (чёрная непрозрачная точка). Числовое значение элемента игнорируется — вместо него тоже берётся [ch 0]: цвет задаётся только строкой.

24.2. Как кодируется цвет

Цвет точки определяется первыми четырьмя знаками строкового значения элемента массива. Каждый знак — это один байт, полученный функцией [ch n] (см. главу «Функции: строки, даты, математика»):

Если строка короче четырёх знаков, недостающие компоненты считаются равными [ch 0]. Поэтому строка из одного знака [ch 0] — чёрный цвет, а из одного [ch 255] — самый яркий красный.

[ch 255]                             - самый яркий красный
[ch 0] + [ch 255]                    - самый яркий зеленый
[ch 0] + [ch 0] + [ch 255]           - самый яркий синий
[ch 0]                                - черный
[ch 0]+[ch 0]+[ch 0]+[ch 255]         - полная прозрачность
[ch 255] + [ch 153] + [ch 153]        - розоватый

24.3. Создание файла изображения

w=127; h=127; f='c:\p1.png'
for y=1 to h
for x=1 to w
r=[ch 2*y]; g=[ch 2*x]; b=[ch x+y]
[a (y-1)*w+x, r+g+b]
endfor
endfor
makepng a,w,h,f

24.4. Рисующие операторы

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

w=127; h=127; f='c:\p1.png'
for y=1 to h
for x=1 to w
r=[ch 2*y]; g=[ch 2*x]; b=[ch x+y]
drawpixel a,w,h, x,y, r+g+b
endfor
endfor
makepng a,w,h,f

w=120; h=100
drawline a,w,h, 50,50, -20,-10, [ch 255]
drawline a,w,h, 1, 1, 100, 40, [ch 0]+[ch 0]+[ch 255]
makepng a,w,h, 'c:\p3.png'

w=120; h=100
drawbar a,w,h, 1, 1, w, h, [ch 255]
drawbar a,w,h, 20, 20, 40,50, [ch 0]+[ch 255]
makepng a,w,h, 'c:\p4.png'

w=100; h=100; c=[ch 255]+[ch 255]
drawtxt a,w,h, 10,10, 1, 'n=1', c
drawtxt a,w,h, 10,25, 2, 'n=2', c
drawtxt a,w,h, 50,50, 11, 'n=11', c
drawtxt a,w,h, 65,50, 12, 'n=12', c
drawtxt a,w,h, 10,60, 21, 'n=21', c
drawtxt a,w,h, 25,60, 22, 'n=22', c
makepng a,w,h, 'c:\p5.png'

w=130; h=130; x=65; y=65; r=60; e=1
c0=[ch 0]; c1=[ch 255]; c2=[ch 0] + [ch 255]
c3=[ch 0]+[ch 0]+[ch 255]; c4=[ch 255]+[ch 255]
c5=[ch 255]+[ch 0]+[ch 255]
drawbar a,w,h, 1,1,w,h, [ch 0]+[ch 0]+[ch 0]+[ch 255]
drawarc a,w,h, x,y, 0, 15, r,e,2, c1
drawarc a,w,h, x,y, 15, 55, r,e,2, c2
drawarc a,w,h, x,y, 55,120, r,e,2, c3
drawarc a,w,h, x,y, 120,280, r,e,2, c4
drawarc a,w,h, x,y, 280,360, r,e,2, c5
drawarc a,w,h, x,y, 0, 15, r,e,1, c0
drawarc a,w,h, x,y, 15, 55, r,e,1, c0
drawarc a,w,h, x,y, 55,120, r,e,1, c0
drawarc a,w,h, x,y, 120,280, r,e,1, c0
drawarc a,w,h, x,y, 280,360, r,e,1, c0
makepng a,w,h, 'c:\p6.png'

w=100; h=100; c=[ch 255]
drawline a,w,h, 1,30, 90,10, c
drawline a,w,h, 1,70, 90,10, c
fillarea a,w,h, 1,31, c
makepng a,w,h, 'c:\p7.png'

24.5. Другие операторы показа изображений (историческая справка)

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

showimg a,w,h,10,20

24.6. Пример: простая столбиковая диаграмма

Соберём всё вместе: нарисуем диаграмму продаж по кварталам — фон, оси, четыре столбика и подписи. Данные здесь заданы прямо в форме (массив v); в реальной форме их получают функциями оборотов [od ...], [op ...] и т.п. (см. главу «Функции: данные учёта»).

* диаграмма продаж по кварталам
w=220; h=160
[m 1,45,70,30,90]
* фон и оси
drawbar a,w,h, 1,1,w,h, [ch 255]+[ch 255]+[ch 255]
drawline a,w,h, 30,10, 30,140, [ch 0]
drawline a,w,h, 30,140, 210,140, [ch 0]
* столбики: масштаб 1 единица = 1.4 точки
for i=1 to 4
bh=[tr [m i]*1.4]
x1=40+(i-1)*45
drawbar a,w,h, x1,140-bh, x1+25,140, [ch 0]+[ch 0]+[ch 255]
drawtxt a,w,h, x1+5,145, 1, 'Q'+[intsn i], [ch 0]
endfor
drawtxt a,w,h, 5,10, 11, 'продажи', [ch 0]
makepng a,w,h, 'c:\sales.png'

Здесь виден типовой приём: «мир» диаграммы (числа 30–90) пересчитывается в точки картинки умножением на масштаб, а столбик рисуется от базовой линии y=140 вверх — то есть координата y2=140 у drawbar больше, чем y1.

24.7. Уникальные имена файлов и уборка: [unicfile] и deleteobsolete

Когда форму с картинкой запускают многие пользователи (типичный случай — web-приложение через NULLCG.CGI), каждый должен получить свой файл изображения, а отработанные файлы нужно своевременно удалять, чтобы каталог не разрастался. Для этого служат функция [unicfile] и оператор deleteobsolete.

u=[unicfile]; e='.png'
f0='c:\webshare\wwwroot\dynamic\' + u + e

deleteobsolete f1,1000

Законченный пример динамической картинки для web-страницы (Web-сервер работает с каталогом c:\webshare\wwwroot, в нём создан подкаталог dynamic с пустым index.html, чтобы браузер не показывал содержимое каталога; ФБП:Сервер работает с данными из c:\data, и при обращении к http://localhost/cgi-bin/nullcg.cgi выполняется форма c:\data\ax.rpt):

Это форма ax
*
u=[unicfile]; e='.png'
f0='c:\webshare\wwwroot\dynamic\' + u + e
f1='c:\webshare\wwwroot\dynamic\*' + e
f2='http://localhost/dynamic/' + u + e
*
deleteobsolete f1,1000
... заполняем массив a ...
makepng a,100,100,f0
printstr '<img src=' + f2 + '>'

Схема работы: deleteobsolete чистит PNG старше 1000 секунд, форма рисует новый файл с уникальным именем, а printstr вставляет в страницу тэг <img> со ссылкой на него. Подробнее о построении web-страниц — в главе «Web-приложения через NULLCG.CGI».

25. Web-приложения через NULLCG.CGI

NULLCG.CGI — это CGI-скрипт, шлюз между Web-сервером и ФБП:Сервером. Он принимает запросы браузера, передаёт их ФБП:Серверу и генерирует HTML-страницы, которые браузер видит как особое клиентское место ФБП. Так на языке форм можно строить web-приложения — с формами ввода, кнопками, таблицами и картинками — и для Internet, и для локальной офисной сети.

• Работает на Windows в комбинации с ФБП:Сервером; в отличие от старого МикроСервера, без ограничений на язык ФБП — доступен весь язык форм.
• NULLCG.CGI не входит в комплект сетевой версии — исторически это был отдельный продукт (приобретался на Расчётном Пункте). В его комплект входили исходные тексты Расчётного Пункта, Платного Консультационного Пункта и исходники nullcg.cgi на C — это одновременно и готовые образцы web-приложений.
• Нужен установленный Web-сервер с поддержкой CGI (например, Microsoft IIS).

25.1. Пользователи, имена и пароли

Количество пользователей web-приложения не ограничено, а их имена и пароли определяются программно, в самих формах — например, через факты, extrd.dat или обозначения и наименования счетов. В файле _rights_.fbp следует указать общее имя USER.

При любом запросе NULLCG.CGI передаёт серверу контекст $$TISIG (его видно при включённом logmode). Сервер извлекает имя пользователя из extrd.dat по ключу (схематично):

x=[ged ah+'.ax.who']

где ah — комбинация IP-адреса пользователя и времени первого старта NULLCG.CGI, ax — «корневая» форма ax.rpt, who — имя поля. Если x окажется числом (в том числе нулём), операции будут штамповаться именем UNKNOWN.

Приложение — это цепочка форм, передающих друг другу управление. Промежуточная информация хранится в extrd.dat индивидуально для каждого пользователя: уникальность достигается комбинацией IP-адреса и времени первого старта NULLCG.CGI (см. функции [ha] и [sf ...] ниже).

25.2. Структура web-формы

Начальная («корневая») форма приложения — AX.RPT: сразу после старта NULLCG.CGI посылает серверу запрос R AX (выполнить форму AX). Любая форма web-приложения — одновременно HTML-страница: результат выполнения формы становится содержимым страницы, а нажатие кнопки на странице передаёт управление обратно NULLCG.CGI, и выполняется предусмотренное действие (например, переход к BX.RPT через поле nextform).

При генерации страницы NULLCG.CGI вставляет тэг <pre> перед текстом из *.out-файла. Поэтому форму, содержащую конструкции HTML, надо начинать тэгом </pre> — он «закрывает» автоматически открытый preформатированный блок. Тэги <form> и </form> в формах-гибридах не используются: NULLCG.CGI предваряет страницу одним тэгом <form> автоматически.

25.3. Комментарий <!--hybride-->

Форма-гибрид — форма ввода со смесью HTML и конструкций языка ФБП. В самом начале такой формы обязателен комментарий:

<!--hybride-->

25.4. Переходы между формами и обмен данными

Переход между формами выполняется нажатием кнопки Send:

<input type=submit name=Send value="название кнопки">

После нажатия Send введённая на странице информация автоматически передаётся в EXTRD.DAT через [sed...]: запрос предваряется цепочкой директив e [sed i,v], где i — комбинация имени формы, имени HTML-поля, IP-адреса пользователя и времени первого старта NULLCG.CGI, а v — значение поля (введённый текст или имя нажатой кнопки). Таким образом, в следующей форме можно через extrd.dat прочесть всё, что произошло в предыдущей до нажатия кнопки.

Функции [ha] и [sf ...]