xls.workbooks

Таблица xls.workbooks хранит определения книг в базе данных.

Пользователи SaveToDB могут создавать книги через мастер создания книг приложений.

Пользователи DBEdit могут создавать книги с помощью мастера Файл > Новый с сервера....

Структура таблицы выглядит следующим образом:

Имя книги отображается в мастере.

Поле шаблона может содержать путь или URL на книгу Microsoft Excel. Эта функция поддерживается только надстройкой SaveToDB.

Значение схемы не обязательно и используется лишь в качестве фильтра.

Определение книги

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

Вот простой пример:

cashbook=s02.cashbook
view_cashbook=s02.view_cashbook
usp_cashbook=s02.usp_cashbook
cash_by_months=s02.usp_cash_by_months

Пример с параметрами запросов:

cashbook=s02.cashbook,(Default),False,$B$3,,{"Parameters":{"account_id":null,"item_id":null,"company_id":null},"ListObjectName":"cashbook"}
view_cashbook=s02.view_cashbook,(Default),False,$B$3,,{"Parameters":{"account_id":null,"item_id":null,"company_id":null},"ListObjectName":"view_cashbook"}
usp_cashbook=s02.usp_cashbook,(Default),False,$B$3,,{"Parameters":{"account_id":null,"item_id":null,"company_id":null},"ListObjectName":"usp_cashbook"}
cash_by_months=s02.usp_cash_by_months,(Default),False,$B$3,,{"Parameters":{"year":2022},"ListObjectName":"cash_by_months"}

Надстройка SaveToDB включает мастер "Инструменты разработчика" > "Показать определение книги", который позволяет получить определение активной книги.

Формальная грамматика определения книги представлена ниже:

workbook-definition = sheet-definition | sheet-definition NEWLINE workbook-definition

sheet-definition = sheet-name "=" table-definition

table-definition = query-object
    | query-object "," query-list
    | query-object "," query-list "," query-list-enabled
    | query-object "," query-list "," query-list-enabled "," cell-address
    | query-object "," query-list "," query-list-enabled "," cell-address "," visible
    | query-object "," query-list "," query-list-enabled "," cell-address "," visible "," json-parameters

query-list = EMPTY | "(Default)" | query-list-object | schema

query-list-enabled = EMPTY | "True" | "False"

visible = EMPTY | "True" | "False"

Параметры json-parameters содержат объект JSON с двумя свойствами: Parameters и ListObjectName.

Свойство Parameters представляет собой объект, где ключи — это имена параметров, а значения — их значения.