xls.workbooks

xls.workbooks

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

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

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

Таблица имеет следующую структуру:

IDNAMETEMPLATEDEFINITIONTABLE_SCHEMA
<workbook name>[<workbook template>]<workbook definition>[<schema>]

Имя книги показывается в мастере.

Поле шаблона может содержать путь или 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":2021},"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 содержит объект, свойства которого задают имена параметров и их значения.