xls.workbooks
Таблица xls.workbooks позволяет хранить определение книг в базе данных.
Пользователи SaveToDB могут создавать такие книги с помощью мастера создания книг приложений.
Пользователи DBEdit могут создавать книги с помощью мастера Файл, Новый с сервера....
Таблица имеет следующую структуру:
| ID | NAME | TEMPLATE | DEFINITION | TABLE_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":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 содержит объект, свойства которого задают имена параметров и их значения.