Перейти к содержанию

Общий принцип работы и запуск приложения: различия между версиями

Материал из Химсофт Вики
Нет описания правки
 
(не показано 9 промежуточных версий этого же участника)
Строка 1: Строка 1:
==Общий принцип работы==
Основной единицей измерения является готовый к использованию шаблон.  
Основной единицей измерения является готовый к использованию шаблон.  


'''Шаблон''' — это электронная настройка с точным графическим расположением текстовых подписей и таблиц, привязанных к БД, для формирования отчетов и документов.  
'''Шаблон''' — это электронная настройка с точным графическим расположением текстовых подписей и таблиц, привязанных к БД, для формирования отчетов и документов.  


Шаблоны ВЕБ ЛИС создаются отдельным инструментом – утилитой настройки.
Шаблоны WEB ЛИМС Тритея создаются отдельным инструментом – утилитой настройки.


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


В WEB ЛИС создание отчетов на основе шаблона, происходит на стороне сервера, за это отвечает отдельный микросервис генерации документов.  
В WEB ЛИМС Тритея создание отчетов на основе шаблона, происходит на стороне сервера, за это отвечает отдельный микросервис генерации документов.  


Этот же сервис используется пользователями для повседневной работы в ручном или автоматическом режиме.
Этот же сервис используется пользователями для повседневной работы в ручном или автоматическом режиме.


Микросервис стартует вместе с основным WEB ЛИС (в docker-контейнере) и выполняет фоновую генерацию документа, на основе поступившей входной информации. На выходе микросервиса получается кэшируемый объект, который можно передать на форму предпросмотра или экспорта в другие форматы (XLSX, PDF, HTML и тп).
==Запуск приложения==
 
Микросервис стартует вместе с основным WEB ЛИМС Тритея (в docker-контейнере) и выполняет фоновую генерацию документа, на основе поступившей входной информации. На выходе микросервиса получается кэшируемый объект, который можно передать на форму предпросмотра или экспорта в другие форматы (XLSX, PDF, HTML и тп).


Взаимодействие с сервером генератора возможно только для зарегистрированного пользователя ИС, у которого есть активный токен доступа.
Взаимодействие с сервером генератора возможно только для зарегистрированного пользователя ИС, у которого есть активный токен доступа.
Строка 17: Строка 21:
Особенность генератора отчетов – полная независимость от БД, т.е. любой шаблон можно переместить между табличными пространствами и настроить на получение данных из разных источников (разные БД).  
Особенность генератора отчетов – полная независимость от БД, т.е. любой шаблон можно переместить между табличными пространствами и настроить на получение данных из разных источников (разные БД).  


Например, отчет составляется по пробе из рабочей БД ЛИС, а дополнительные данные получаются из другого источника (например, файла) или корпоративной БД.  
Например, отчет составляется по пробе из рабочей БД WEB ЛИМС Тритея, а дополнительные данные получаются из другого источника (например, файла) или корпоративной БД.  


Возможности генератора позволяют использовать в качестве источника данных не только БД, но и другие источники, например, XLSX-файлы, текстовые данные, ODBC-данные.
Возможности генератора позволяют использовать в качестве источника данных не только БД, но и другие источники, например, XLSX-файлы, текстовые данные, ODBC-данные.
Строка 24: Строка 28:


'''Примечание 2:''' Выдача результатов кэшируется, что позволяет быстро обратится к нескольким последним заданиям и посмотреть или сравнить итоги генерации.
'''Примечание 2:''' Выдача результатов кэшируется, что позволяет быстро обратится к нескольким последним заданиям и посмотреть или сравнить итоги генерации.
[[Файл:scheme.png|917px|center|thumb]]
==Утилита настройки шаблонов==


'''Утилита настройки шаблонов''' и работа генератора описана подробно в данном документе. Задача утилиты – подготовка набора действий и внешнего вида шаблона при его генерации.  
'''Утилита настройки шаблонов''' и работа генератора описана подробно в данном документе. Задача утилиты – подготовка набора действий и внешнего вида шаблона при его генерации.  


Утилита предназначена только для настройщиков информационной системы, поэтому от редактора требуется специальная подготовка.
Утилита предназначена только для настройщиков информационной системы, поэтому от редактора требуется специальная подготовка.
Внимание: утилита настройки шаблонов работает только с ОС Windows 10\11 и требует предварительной установки пакета разработчика Microsoft .NET 8.
 
'''Внимание:''' утилита настройки шаблонов работает только с ОС Windows 10\11 и требует предварительной установки пакета разработчика Microsoft .NET 8.
 
==Генератор отчетов==


Генератор отчетов запускается вместе с основной системой и позволяет строить отчеты по шаблонам любой сложности в асинхронном режиме. При этом, у пользователей нет прямого доступа к этому блоку, обращения только через внешние функции (API).  
Генератор отчетов запускается вместе с основной системой и позволяет строить отчеты по шаблонам любой сложности в асинхронном режиме. При этом, у пользователей нет прямого доступа к этому блоку, обращения только через внешние функции (API).  


Список API-функций с примерами использования доступен на сайте Разработчика по адресу: https://docs.chemsoft.ru/
Список API-функций с примерами использования доступен в разделе [[Справочник разработчика ЛИС]].


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


Генератор отчетов не меняет содержимое шаблонов или БД. Исключение только если внутри отчета используется специальная функция по редактированию данных в БД(ВБД).
Генератор отчетов не меняет содержимое шаблонов или БД. Исключение только если внутри отчета используется специальная функция по редактированию данных в БД (ВБД).


Блок работы с документами является частью основного ВЕБ ЛИС, предоставляет возможность через интернет браузер подготовить входную информацию и передать её блоку генератора документов. Подробное описание к блоку в руководстве пользователя ЛИС.  
==Блок работы с документами==
 
Блок работы с документами является частью основного WEB ЛИМС Тритея, предоставляет возможность через интернет браузер подготовить входную информацию и передать её блоку генератора документов. Подробное описание к блоку в руководстве пользователя ЛИС.  


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


Блок просмотра готовых документов, так же является основной частью WEB ЛИС, представляет возможность работы с уже построенными отчетами, через интернет-браузер. Данный блок позволяет отправить отчет на печать в бумажном виде, экспортировать данные в произвольный формат или сохранить результат в БД ЛИС.
==Блок просмотра готовых документов==
 
Блок просмотра готовых документов, так же является основной частью WEB ЛИМС Тритея, представляет возможность работы с уже построенными отчетами, через интернет-браузер. Данный блок позволяет отправить отчет на печать в бумажном виде, экспортировать данные в произвольный формат или сохранить результат в БД WEB ЛИМС Тритея.


'''Примечание:''' для локального просмотра архивов, существует версия просмотра и экспорта готовых отчетов ЛИС без доступа к интернету.
'''Примечание:''' для локального просмотра архивов, существует версия просмотра и экспорта готовых отчетов ЛИС без доступа к интернету.
Блок работы скриптов интеграций, так же является интернет-браузерной частью основного ВЕБ ЛИС и позволяет выполнять задачи с документами и документооборотом в автоматическом режиме (по расписанию), по заданному алгоритму из js-скриптов.
 
==Блок работы скриптов интеграции==
 
Блок работы скриптов интеграций, так же является интернет-браузерной частью основного WEB ЛИМС Тритея и позволяет выполнять задачи с документами и документооборотом в автоматическом режиме (по расписанию), по заданному алгоритму из js-скриптов.

Текущая версия от 08:43, 18 февраля 2026

Общий принцип работы

Основной единицей измерения является готовый к использованию шаблон.

Шаблон — это электронная настройка с точным графическим расположением текстовых подписей и таблиц, привязанных к БД, для формирования отчетов и документов.

Шаблоны WEB ЛИМС Тритея создаются отдельным инструментом – утилитой настройки.

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

В WEB ЛИМС Тритея создание отчетов на основе шаблона, происходит на стороне сервера, за это отвечает отдельный микросервис генерации документов.

Этот же сервис используется пользователями для повседневной работы в ручном или автоматическом режиме.

Запуск приложения

Микросервис стартует вместе с основным WEB ЛИМС Тритея (в docker-контейнере) и выполняет фоновую генерацию документа, на основе поступившей входной информации. На выходе микросервиса получается кэшируемый объект, который можно передать на форму предпросмотра или экспорта в другие форматы (XLSX, PDF, HTML и тп).

Взаимодействие с сервером генератора возможно только для зарегистрированного пользователя ИС, у которого есть активный токен доступа.

Особенность генератора отчетов – полная независимость от БД, т.е. любой шаблон можно переместить между табличными пространствами и настроить на получение данных из разных источников (разные БД).

Например, отчет составляется по пробе из рабочей БД WEB ЛИМС Тритея, а дополнительные данные получаются из другого источника (например, файла) или корпоративной БД.

Возможности генератора позволяют использовать в качестве источника данных не только БД, но и другие источники, например, XLSX-файлы, текстовые данные, ODBC-данные.

Примечание 1: Лицензирование ПО происходит по количеству серверов генерации документов. «Владелец версии» зашивается именно в сервере генерации.

Примечание 2: Выдача результатов кэшируется, что позволяет быстро обратится к нескольким последним заданиям и посмотреть или сравнить итоги генерации.

Утилита настройки шаблонов

Утилита настройки шаблонов и работа генератора описана подробно в данном документе. Задача утилиты – подготовка набора действий и внешнего вида шаблона при его генерации.

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

Внимание: утилита настройки шаблонов работает только с ОС Windows 10\11 и требует предварительной установки пакета разработчика Microsoft .NET 8.

Генератор отчетов

Генератор отчетов запускается вместе с основной системой и позволяет строить отчеты по шаблонам любой сложности в асинхронном режиме. При этом, у пользователей нет прямого доступа к этому блоку, обращения только через внешние функции (API).

Список API-функций с примерами использования доступен в разделе Справочник разработчика ЛИС.

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

Генератор отчетов не меняет содержимое шаблонов или БД. Исключение только если внутри отчета используется специальная функция по редактированию данных в БД (ВБД).

Блок работы с документами

Блок работы с документами является частью основного WEB ЛИМС Тритея, предоставляет возможность через интернет браузер подготовить входную информацию и передать её блоку генератора документов. Подробное описание к блоку в руководстве пользователя ЛИС.

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

Блок просмотра готовых документов

Блок просмотра готовых документов, так же является основной частью WEB ЛИМС Тритея, представляет возможность работы с уже построенными отчетами, через интернет-браузер. Данный блок позволяет отправить отчет на печать в бумажном виде, экспортировать данные в произвольный формат или сохранить результат в БД WEB ЛИМС Тритея.

Примечание: для локального просмотра архивов, существует версия просмотра и экспорта готовых отчетов ЛИС без доступа к интернету.

Блок работы скриптов интеграции

Блок работы скриптов интеграций, так же является интернет-браузерной частью основного WEB ЛИМС Тритея и позволяет выполнять задачи с документами и документооборотом в автоматическом режиме (по расписанию), по заданному алгоритму из js-скриптов.