https://wiki.chemsoft.ru/api.php?action=feedcontributions&feedformat=atom&user=Arhidiman
Химсофт Вики - Вклад [ru]
2026-04-17T21:14:20Z
Вклад
MediaWiki 1.45.1
https://wiki.chemsoft.ru/index.php?title=%D0%90%D0%B4%D0%B4%D0%BE%D0%BD%D1%8B&diff=2382
Аддоны
2026-04-03T06:48:03Z
<p>Arhidiman: /* Деление данных. copy-journal-record */</p>
<hr />
<div>Список демонстрационных аддонов, показывающих возможности интеграционного сервиса.<br />
<br />
== Проверка даты регистрации. <code>check-registration-date</code> ==<br />
[[Файл:check-registration-date.png|frame]]<br />
Проверяет, не истёк ли срок регистрации пробы. Сравнивает дату регистрации из указанного поля с текущей датой. Если прошло более заданного количества дней (по умолчанию — 10), выдаёт ошибку. В противном случае показывает сообщение об успешной проверке.<br />
<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { MessageBoxResults } from "@triteia/types-integration-gui"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { DialogType } from "@triteia/types-integration-gui"<br />
import type { FetchApiClient } from "../../src/servivces/worker/api/ApiClient"<br />
import { apiInstance } from "../../src/servivces/worker/api/interactors/ApiInstance"<br />
<br />
// Конфигурация аддона:<br />
// - Поле "Дата регистрации" — контрольная точка для расчёта срока<br />
// - expirationLimit: 10 дней — максимальный допустимый срок хранения пробы<br />
// - journalRecordId: 201 — запись из журнала "Лаб. воздуха / Анализы завершены"<br />
const config = {<br />
dateField: 'Дата регистрации',<br />
expirationLimit: 10,<br />
journalRecordId: 201,<br />
integrationResult: { message: 'Срок регистрации пробы не истёк!' }<br />
}<br />
<br />
// Сообщения для пользовательских уведомлений и ошибок<br />
const messages = {<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
// Успех: информирует пользователя, что срок не вышел<br />
success: (recordId) => `Срок регистрации пробы не истёк! Id записи ${recordId}`,<br />
// Ошибка: превышен лимит хранения<br />
expired: (limit, recordId) => `Срок регистрации пробы истёк!\nПрошло более ${limit} дней с момента регистрации. Id записи: ${recordId}`,<br />
// Ошибка: отсутствует дата в нужном поле<br />
dateField: (dateField, stageName, journalRecordId) => [<br />
`Не заполнено либо отсутствует поле "${dateField}"`,<br />
`в этапе "${stageName || ''}".\nId записи: ${journalRecordId}`<br />
].join(' ')<br />
}<br />
<br />
// Централизованные обработчики ошибок — обеспечивают единообразие и чистоту основной логики<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
},<br />
// Вызывается, если поле с датой не заполнено<br />
dateError: (dateField, stageName, journalRecordId) => {<br />
throw new Error(messages.dateField(dateField, stageName, journalRecordId))<br />
},<br />
// Вызывается при превышении срока хранения<br />
expirationError: () => {<br />
throw new Error(messages.expired(config.expirationLimit, config.journalRecordId))<br />
}<br />
}<br />
<br />
// Извлекает socketId из queryParams — необходим для отправки диалогов в GUI<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
// Переводит дату в количество дней с начала эпохи (для арифметики дат)<br />
const getDaysByDate = (date: Date) => {<br />
const dayMs = 60 * 60 * 24 * 1000<br />
const timestamp = date.getTime()<br />
return timestamp / dayMs<br />
}<br />
<br />
// Формирует конфиг диалога: тип, заголовок и сообщение для отображения в GUI<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
// Рассчитывает, сколько дней прошло с момента регистрации пробы<br />
const getExpirationOffset = (registrationDate: string) => {<br />
const regDate = new Date(registrationDate)<br />
const today = new Date()<br />
return getDaysByDate(today) - getDaysByDate(regDate)<br />
}<br />
<br />
// Показывает пользователю сообщение об ошибке<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
// Показывает пользователю уведомление об успешной проверке<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
/**<br />
* Основная функция аддона:<br />
* Проверяет, не истёк ли срок хранения пробы (с момента "Дата регистрации").<br />
* <br />
* Логика:<br />
* 1. Получает значение поля "Дата регистрации" из записи журнала.<br />
* 2. Если дата не указана — ошибка.<br />
* 3. Если с даты регистрации прошло >= 10 дней — ошибка.<br />
* 4. Иначе — успех, показываем подтверждение.<br />
*/<br />
async function main({ queryParams, ...apiInstance }) {<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
// Получаем доступ к данным записи журнала<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
// Извлекаем значение поля "Дата регистрации"<br />
const date = journalRecordManager.getFieldValue(config.dateField)<br />
<br />
// Если дата не заполнена — прерываем с пояснением<br />
if (!date) {<br />
errorHandlers.dateError(config.dateField, journalRecordManager?.data?.stage?.stage?.name, config.journalRecordId)<br />
}<br />
<br />
// Считаем, сколько дней прошло с регистрации<br />
const expirationOffset = getExpirationOffset(date as string)<br />
<br />
// Если срок хранения превышен — ошибка<br />
if (expirationOffset >= config.expirationLimit) {<br />
errorHandlers.expirationError()<br />
}<br />
<br />
// Всё в порядке — информируем пользователя<br />
await showSuccessMessage(messages.success(config.journalRecordId), socketId)<br />
<br />
return config.integrationResult<br />
} catch (err) {<br />
// При любой ошибке — показываем её в модальном окне<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка заполненности полей показателей. <code>check-indicator-fields-filled</code> ==<br />
[[Файл:Check-indicator-fields-filled.png|frame]]<br />
Проверяет заполненность полей показателей в записи журнала по настраиваемому списку. Проверяет наличие определённых показателей (например, "Аммоний-ион") и заполненность у них таких полей, как исполнители, методики, средний результат и др. Выдаёт ошибку, если показатели отсутствуют или не все поля заполнены.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import type { DialogType } from "@triteia/types-integration-gui"<br />
import type { JournalRecordIndicatorResponse } from "../../src/servivces/worker/api/controllers/journal-records"<br />
import type { IJournalRecordManager } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
<br />
// Описание свойств показателя (индикатора), которые нужно проверить<br />
// Каждое свойство имеет метку (для отображения пользователю) и геттер значения<br />
type IndicatorProp = { label: string, get: () => unknown }<br />
type IndicatorPropsConfig = Record<string, IndicatorProp><br />
<br />
// Конфигурация полей, которые проверяются у каждого показателя<br />
// Например: "Исполнители", "Методики", "Средний результат" и т.д.<br />
const indicatorPropsConfig = (indicator): IndicatorPropsConfig => {<br />
return {<br />
executors: {<br />
label: 'Исполнители', <br />
get: () => indicator?.result?.executors<br />
},<br />
methodic: {<br />
label: 'Методики', <br />
get: () => indicator?.methodics<br />
},<br />
averageResult: {<br />
label: 'Средний результат', <br />
get: () => indicator?.result?.averageValue<br />
},<br />
averageRoundedValue: {<br />
label: 'Средний округлённый результат', <br />
get: () => indicator?.result?.averageRoundedValue<br />
}<br />
}<br />
}<br />
<br />
// Конфигурация аддона:<br />
// - indicatorsList: список обязательных показателей (например, "Аммоний-ион")<br />
// - journalRecordId: 144 — тестовая запись ("Мк / Тест_Ушакова")<br />
const config = {<br />
indicatorsList: [<br />
'Аммоний-ион'<br />
],<br />
journalRecordId: 144,<br />
integrationResult: { message: 'Все поля заполнены!' }<br />
}<br />
<br />
// Сообщения для пользовательских уведомлений и ошибок<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: 'Все необходимые поля заполнены!',<br />
emptyIndicators: (recordId) => `в записи с Id ${recordId} отсутствуют показатели`,<br />
emptyFieldsError: (fields, recordId) => `Поля ${fields.map(f => `"${f}"`).join(', ')} не заполнены в записи с ID ${recordId}`,<br />
indicators: (indicators: string[], recordId) => `Показатели ${indicators.map(f => `"${f}"`).join(', ')} отсутствуют в записи с ID ${recordId}`,<br />
// Формирует детализированное сообщение о незаполненных полях внутри показателей<br />
emptyIndicatorsProps: (props: Record<string, string[]>, recordId) => {<br />
const propsString = Object.keys(props).map(prop => !isEmptyArray(props[prop]) ? `${prop}: ${props[prop].map(p => `"${p}"`).join(', ')}` : '').join('; ')<br />
return `В записи с Id ${recordId} отсутствуют либо не заполнены следующие поля у показателей: ${propsString}`<br />
}<br />
}<br />
<br />
// Централизованные обработчики ошибок — обеспечивают единообразие и чистоту основной логики<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
fieldsError: (emptyFields, recordId) => {<br />
throw new Error(messages.emptyFieldsError(emptyFields, recordId))<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
},<br />
indicatorsError: (recordId) => {<br />
throw new Error(messages.emptyIndicators(recordId))<br />
},<br />
notFoundIndicators: (indicators: string[], recordId: number) => {<br />
throw new Error(messages.indicators(indicators, recordId))<br />
},<br />
notFilledIndicatorProps: (props: Record<string, string[]>) => {<br />
throw new Error(messages.emptyIndicatorsProps(props, config.journalRecordId))<br />
}<br />
}<br />
<br />
// Формирует конфиг диалога для отправки в GUI: тип, заголовок и сообщение<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
// Извлекает socketId из queryParams — необходим для связи с интерфейсом<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
// Показывает пользователю модальное окно с ошибкой<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
// Показывает уведомление об успешной проверке<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
// Универсальная проверка: является ли массив пустым (с учётом типа)<br />
const isEmptyArray = (arr: unknown[]) => {<br />
return Array.isArray(arr) && arr.length === 0<br />
}<br />
<br />
// Проверяет, есть ли у записи хотя бы один показатель<br />
const hasIndicators = (journalRecordManager: IJournalRecordManager) => {<br />
const indicators = journalRecordManager?.data?.indicators<br />
return Array.isArray(indicators) && indicators.length > 0<br />
}<br />
<br />
// Определяет, какие из требуемых показателей отсутствуют в записи<br />
const getNotFoundIndicators = (indicators: JournalRecordIndicatorResponse[], indicatorsList = config.indicatorsList) => {<br />
return indicatorsList.filter(ind => <br />
indicators.every(ljInd => ljInd?.indicator?.name?.toLowerCase() !== ind.toLowerCase())<br />
)<br />
} <br />
<br />
// Собирает список незаполненных полей для каждого показателя<br />
// Возвращает объект: { "Аммоний-ион": ["Исполнители", "Средний результат"] }<br />
const getNotFilledResultsFields = (indicators: JournalRecordIndicatorResponse[]): Record<string, string[]> => {<br />
return indicators.reduce((acc, indicator) => {<br />
const config = indicatorPropsConfig(indicator)<br />
return {<br />
...acc,<br />
[indicator?.indicator?.name]: Object.keys(config).reduce((acc, prop) => {<br />
if (!config[prop].get()) return [...acc, config[prop].label]<br />
return acc<br />
}, [] as string[])<br />
}<br />
}, {}) as Record<string, string[]><br />
}<br />
<br />
// Проверяет, есть ли хотя бы один показатель с незаполненными полями<br />
const hasNotFilledProps = (indicatorsProps: Record<string, string[]>) => {<br />
return Object.keys(indicatorsProps).some(indicator => !isEmptyArray(indicatorsProps[indicator]))<br />
}<br />
<br />
// Проверяет, есть ли отсутствующие показатели в списке<br />
const hasNotFoundIndicators = (indicators: string[]) => !isEmptyArray(indicators)<br />
<br />
/**<br />
* Основная функция аддона:<br />
* Проверяет заполненность:<br />
* 1. Наличие указанных показателей (например, "Аммоний-ион").<br />
* 2. Заполненность внутренних полей каждого показателя (исполнители, методики и т.д.).<br />
* <br />
* При обнаружении проблем — прерывает выполнение и показывает детализированную ошибку.<br />
*/<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
<br />
// Проверка: есть ли вообще показатели в записи?<br />
if (!hasIndicators(journalRecordManager)) {<br />
errorHandlers.indicatorsError(journalRecordManager.journalRecordId)<br />
}<br />
<br />
const indicators = journalRecordManager?.data?.indicators<br />
<br />
// Проверка: все ли требуемые показатели присутствуют?<br />
const notFoundIndicators = getNotFoundIndicators(indicators)<br />
if (hasNotFoundIndicators(notFoundIndicators)) { <br />
errorHandlers.notFoundIndicators(notFoundIndicators, journalRecordManager.journalRecordId)<br />
}<br />
<br />
// Проверка: все ли поля у показателей заполнены?<br />
const emptyIndicatorProps = getNotFilledResultsFields(indicators)<br />
if (hasNotFilledProps(emptyIndicatorProps)) {<br />
errorHandlers.notFilledIndicatorProps(emptyIndicatorProps)<br />
}<br />
<br />
// Все проверки пройдены — информируем пользователя<br />
showSuccessMessage(messages.success, socketId)<br />
} catch (err) {<br />
// При любой ошибке — показываем её в модальном окне<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка заполненности атрибутов записи ЛЖ. <code>check-record-fields-filled</code> ==<br />
[[Файл:Check-record-fields-filled.png|frame]]<br />
Проверяет заполненность заданных полей в записи журнала (например, "Источник", "Место отбора", "Дата регистрации" и др.). Если какое-либо из обязательных полей не заполнено, выдаётся соответствующая ошибка.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { DialogType } from "@triteia/types-integration-gui"<br />
import { IJournalRecordManager } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
<br />
const config = {<br />
requiredFields: [<br />
'Источник',<br />
'Список. Целое число',<br />
'Строка',<br />
'Целое число',<br />
'Вещественное число',<br />
'Логический тип',<br />
'Дата',<br />
'Время',<br />
],<br />
journalRecordId: 144, // Мк / Тест_Ушакова<br />
integrationResult: { message: 'Все поля заполнены!' }<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: 'Все необходимые поля заполнены!',<br />
emptyFieldsError: (fields, recordId) => `Поля ${fields.map(f => `"${f}"`).join(', ')} не заполнены в записи с ID ${recordId}`,<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
fieldsError: (emptyFields, recordId) => {<br />
throw new Error(messages.emptyFieldsError(emptyFields, recordId))<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const isEmptyArray = (arr: unknown[]) => {<br />
return arr.length === 0<br />
}<br />
<br />
const getNotFilledFields = (fields: string[], journalRecordsManager: IJournalRecordManager) => {<br />
console.log(journalRecordsManager.data.attributes, 'data.attributes')<br />
return fields.filter(f => !journalRecordsManager.getFieldValue(f))<br />
}<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
const emptyFields = getNotFilledFields(config.requiredFields, journalRecordManager)<br />
<br />
if (isEmptyArray(emptyFields)) {<br />
showSuccessMessage(messages.success, socketId)<br />
return config.integrationResult<br />
} else errorHandlers.fieldsError(emptyFields, config.journalRecordId)<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка движения пробы. <code>check-sample-moving</code> ==<br />
[[Файл:Check-sample-moving.png|frame]]<br />
Проверяет маршрут движения пробы по этапам. Получает историю перемещений записи и определяет, происходило ли движение (нахождение более чем на одном этапе). Отображает маршрут или сообщает, что движение не происходило.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { JournalsRecordRouteController } from "../../src/servivces/worker/api/controllers/journals-record-route"<br />
import { apiInstance } from "../../src/servivces/worker/api/interactors/ApiInstance"<br />
import type { DialogType } from "@triteia/types-integration-gui"<br />
import type { JournalRecordRouteDto } from "../../src/servivces/worker/api/controllers/journal-records"<br />
<br />
// Конфигурация аддона:<br />
// - journalRecordId: 114 — запись из журнала "Лаб. воздуха / Анализы завершены"<br />
// Аддон анализирует маршрут движения пробы по этапам ЛЖ<br />
const config = {<br />
journalRecordId: 114<br />
}<br />
<br />
// Сообщения для отображения пользователю<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
// Формирует строку с маршрутом пробы: этапы через " -> "<br />
route: (routes: JournalRecordRouteDto[], recordId: number) => <br />
`Маршрут пробы: ${routes.map(r => `"${r.stageName}"`).join(' -> ')}. Id записи ЛЖ: ${recordId}`,<br />
// Сообщение, если проба не перемещалась между этапами<br />
notMoved: (recordId: number) => <br />
`Движение пробы не происходило. Id записи ЛЖ: ${recordId}`<br />
}<br />
<br />
// Обработчики ошибок — централизованно выбрасывают исключения с понятными сообщениями<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
// Формирует конфиг диалога для GUI: тип (confirm), заголовок и текст<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
// Извлекает socketId из параметров запроса — необходим для отправки ответа в интерфейс<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
// Показывает пользователю модальное окно с ошибкой<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
// Показывает информационное сообщение (успех или статус)<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
// Определяет, перемещалась ли проба: если более одного этапа — значит, было движение<br />
const isSampleMoved = (moves: JournalRecordRouteDto[]) => {<br />
return Array.isArray(moves) && moves.length > 1<br />
}<br />
<br />
/**<br />
* Основная функция аддона:<br />
* Получает маршрут пробы по этапам лабораторного журнала и отображает его пользователю.<br />
* <br />
* Логика:<br />
* 1. Проверяет наличие параметров и подключение клиента (socketId).<br />
* 2. Запрашивает историю перемещений пробы через API.<br />
* 3. Если проба прошла более одного этапа — отображает маршрут.<br />
* 4. Если осталась на одном этапе — сообщает, что движения не было.<br />
*/<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
// Контроллер для работы с маршрутом записи (история этапов)<br />
const journalsRecordRouteController = new JournalsRecordRouteController(apiInstance)<br />
// Получаем список этапов, через которые прошла проба<br />
const sampleMoves = await journalsRecordRouteController.getJournalRecordRoute(config.journalRecordId)<br />
<br />
if (isSampleMoved(sampleMoves)) {<br />
// Проба перемещалась — показываем полный маршрут<br />
showSuccessMessage(messages.route(sampleMoves, config.journalRecordId), socketId)<br />
} else {<br />
// Проба не покидала исходный этап<br />
showSuccessMessage(messages.notMoved(config.journalRecordId), socketId)<br />
}<br />
} catch (err) {<br />
// При любой ошибке (сеть, доступ, данные) — показываем её пользователю<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка прав пользователя. <code>check-user-rights</code> ==<br />
[[Файл:Check-user-rights.png|frame]]<br />
Проверяет права доступа пользователя к определённым ресурсам (объекты анализа, методики, записи ЛЖ). Отображает таблицу с типами доступа (чтение, запись и т.д.) и наличием прав по каждому ресурсу.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { apiInstance } from "../../src/servivces/worker/api/interactors/ApiInstance"<br />
import { <br />
PermissionController, <br />
PermissionResource, <br />
PermissionRwAccess<br />
} from "../../src/servivces/worker/api/controllers/permisson"<br />
<br />
import { TableBuilder } from "../../src/gui/builder"<br />
import type { DialogType, TableConfig } from "@triteia/types-integration-gui"<br />
import type { JournalRecordRouteDto } from "../../src/servivces/worker/api/controllers/journal-records"<br />
<br />
// Отображение типов доступа в понятные пользователю названия<br />
const accessNamesMap = {<br />
[PermissionRwAccess.EXEC]: 'Выполнение',<br />
[PermissionRwAccess.READ]: 'Чтение',<br />
[PermissionRwAccess.WRITE]: 'Запись',<br />
}<br />
<br />
// Список ресурсов, права на которые необходимо проверить<br />
const requiredResources = [<br />
PermissionResource.ANALYSIS_OBJECT, <br />
PermissionResource.METHODOLOGY,<br />
PermissionResource.JOURNAL_RECORD<br />
]<br />
<br />
// Отображение идентификаторов ресурсов в читаемые названия для отображения в таблице<br />
const resourcesNamesMap = {<br />
[PermissionResource.ANALYSIS_OBJECT]: 'Объекты анализа', <br />
[PermissionResource.METHODOLOGY]: 'Методики', <br />
[PermissionResource.JOURNAL_RECORD]: 'Записи ЛЖ'<br />
}<br />
<br />
/**<br />
* Формирует конфигурацию таблицы с правами доступа:<br />
* - Для каждого ресурса проверяются все типы доступа (чтение, запись, выполнение).<br />
* - Возвращает готовую конфигурацию таблицы для отображения в GUI.<br />
*/<br />
const getAccessRightsTable = async (tableBuilder: TableBuilder, permissionController: PermissionController): Promise<TableConfig> => {<br />
// Получаем список строк: комбинация "ресурс + тип доступа + наличие права"<br />
const rows = (await Promise.all(requiredResources.map(async (source: PermissionResource) => {<br />
const sourceCombinations = await Promise.all(Object.keys(PermissionRwAccess).map(async (action) => {<br />
const access = await permissionController.getSourcePermission(source, PermissionRwAccess[action])<br />
return { <br />
source: resourcesNamesMap[source], <br />
action: accessNamesMap[PermissionRwAccess[action]], <br />
access: access.hasPermission <br />
}<br />
}))<br />
return sourceCombinations<br />
} <br />
))).flat()<br />
<br />
// Строим таблицу с помощью TableBuilder<br />
const table = tableBuilder<br />
.name('simpleTable')<br />
.label('Таблица')<br />
.isAddable(false) // Нельзя добавлять строки<br />
.actionsCol(false) // Скрыть колонку действий<br />
.addColumn('Ресурс', 'source', false)<br />
.config('input', { name: 'source', rules: [{ required: true }] }, { placeholder: '', disabled: false })<br />
.next()<br />
.addColumn('Тип доступа', 'action', false)<br />
.config('input', { name: 'action' }, { type: 'string', placeholder: '', disabled: false })<br />
.next()<br />
.addColumn('Доступ', 'access', false)<br />
.config('checkbox', { name: 'access' }, { type: 'boolean', placeholder: '', disabled: true }) // Только для просмотра<br />
.next()<br />
.setRows(rows)<br />
.build();<br />
<br />
return table<br />
}<br />
<br />
// Сообщения для пользователя<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
}<br />
<br />
// Обработчики ошибок — централизованно выбрасывают исключения<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
// Формирует конфиг диалога для отправки в GUI<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
// Извлекает socketId из параметров — необходим для обратной связи с интерфейсом<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
return socketId<br />
}<br />
<br />
// Показывает пользователю сообщение об ошибке<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
<br />
// Показывает таблицу с правами доступа в модальном окне<br />
const showTable = async (builder: TableBuilder, controller: PermissionController, socketId: string) => <br />
await getDataFromDialog({ type: 'input-data', config: [await getAccessRightsTable(builder, controller)] }, socketId)<br />
<br />
/**<br />
* Основная функция аддона:<br />
* Отображает пользователю таблицу с текущими правами доступа на ключевые ресурсы системы.<br />
* <br />
* Логика:<br />
* 1. Проверяет наличие параметров и активное соединение (socketId).<br />
* 2. Запрашивает права для каждого ресурса и типа доступа.<br />
* 3. Формирует таблицу через TableBuilder.<br />
* 4. Показывает её в модальном окне.<br />
* <br />
* Результат: пользователь видит, какие действия разрешены для "Объектов анализа", "Методик" и "Записей ЛЖ".<br />
*/<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
// Создаём экземпляры билдера и контроллера прав доступа<br />
await showTable(new TableBuilder(), new PermissionController(apiInstance), socketId)<br />
} catch (err) {<br />
// При любой ошибке — показываем её в модальном окне<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Заполнение атрибутов записи ЛЖ. <code>fill-record-fields</code> ==<br />
[[Файл:Fill-record-fields.png|frame]]<br />
Автоматически заполняет заданные поля в записи журнала (например, даты, место отбора, шифр пробы и др.). Есть возможность использования ключевых слов для сопоставления полей, если точные названия не совпадают.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { DialogType } from "@triteia/types-integration-gui"<br />
import { IJournalRecordManager } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
import { JournalRecordAttributeFieldResponse } from "../../src/servivces/worker/api/controllers/lj-eav-attribute-fields"<br />
import { FieldMatch } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
<br />
// Текущая дата в формате YYYY-MM-DD — используется как значение по умолчанию для полей с датой<br />
const date = new Date().toISOString().split('T')[0]<br />
<br />
// Конфигурация аддона:<br />
// - requiredFields: список полей, которые нужно заполнить<br />
// Каждое поле содержит:<br />
// • name — отображаемое имя<br />
// • value — значение, которое будет установлено<br />
// • keywords — ключевые слова для поиска соответствующего поля в записи<br />
// - journalRecordId: 118 — тестовая запись ("Мк / 111")<br />
// - Результат при успехе: сообщение о завершении<br />
const config = {<br />
requiredFields: [<br />
{ name: 'Дата регистрации', value: date, keywords: ['дат', 'регистр'] },<br />
{ name: 'Место отбора', value: 'Скважина 516563Г ', keywords: ['мест', 'отбор'] },<br />
{ name: 'Дата отбора', value: date, keywords: ['дат', 'отбор'] },<br />
{ name: 'Шифр пробы', value: 'shifr 123', keywords: ['дат', 'регистр']},<br />
{ name: 'Список. Целое число', value: 666, keywords: ['спис', 'цел', 'числ'] },<br />
{ name: 'Помещение', value: 'помещение', keywords: ['помещ']},<br />
] as FieldMatch[],<br />
journalRecordId: 118, // Мк / 111<br />
integrationResult: { message: 'Все поля заполнены!' }<br />
}<br />
<br />
// Сообщения для пользователя<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: (recordId) => `Все необходимые поля заполнены! Id записи: ${recordId}`,<br />
emptyFieldsError: (fields, recordId) => `Поля ${fields.map(f => `"${f}"`).join(', ')} не заполнены в записи с ID ${recordId}`,<br />
}<br />
<br />
// Обработчики ошибок — централизованно выбрасывают исключения<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
// Формирует конфиг диалога для отправки в GUI: тип, заголовок и сообщение<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
// Извлекает socketId из параметров — необходим для обратной связи с интерфейсом<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
return socketId<br />
}<br />
<br />
// Показывает пользователю сообщение об ошибке<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
// Показывает уведомление об успешном заполнении<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
// Сопоставляет поле из записи (по имени) с требуемым полем через ключевые слова<br />
// Например: если имя поля содержит "дат" и "регистр" → подходит под "Дата регистрации"<br />
const fieldsMatcher = (field: JournalRecordAttributeFieldResponse, searchField: FieldMatch) => {<br />
return searchField.keywords.every(k => <br />
String(field.name).toLocaleLowerCase().includes(k.toLocaleLowerCase())<br />
)<br />
}<br />
<br />
// Заполняет указанные поля в записи журнала с использованием кастомного механизма сопоставления<br />
const fillFields = async (fields: FieldMatch[], journalRecordsManager: IJournalRecordManager) => {<br />
await journalRecordsManager.setFieldsValues(fields, journalRecordsManager, fieldsMatcher)<br />
}<br />
<br />
/**<br />
* Основная функция аддона:<br />
* Автоматически заполняет заданные поля в записи лабораторного журнала.<br />
* <br />
* Особенности:<br />
* - Поля ищутся не по точному имени, а по ключевым словам (гибкое сопоставление).<br />
* - Поддерживает разные типы значений: строки, числа, даты.<br />
* - Используется в тестовых или демонстрационных целях.<br />
* <br />
* Логика:<br />
* 1. Проверяет наличие параметров и активное соединение.<br />
* 2. Загружает запись журнала.<br />
* 3. Для каждого поля из config.requiredFields:<br />
* - Находит соответствующее поле в записи по ключевым словам.<br />
* - Устанавливает указанное значение.<br />
* 4. Сообщает пользователю об успехе.<br />
*/<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
// Получаем менеджер для работы с записью<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
// Заполняем поля по ключевым словам<br />
await fillFields(config.requiredFields, journalRecordManager)<br />
// Информируем пользователя о завершении<br />
showSuccessMessage(messages.success(journalRecordManager.journalRecordId), socketId)<br />
return config.integrationResult<br />
} catch (err) {<br />
// При любой ошибке — показываем её в модальном окне<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Деление данных. <code>copy-journal-record</code> ==<br />
[[Файл:Copy-journal-record.png|frame]]<br />
Создаёт копию записи журнала на заданном этапе маршрута. Выводит сообщение с ID новой записи.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { JournalRecordsController } from "../../src/servivces/worker/api/controllers/journal-records"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { apiInstance } from "../../src/servivces/worker/api/interactors/ApiInstance"<br />
import type { DialogType } from "@triteia/types-integration-gui"<br />
import type { JournalRecordRequest, JournalRecordResponse } from "../../src/servivces/worker/api/controllers/journal-records"<br />
import type { JournalRecordAttributeResponse } from "../../src/servivces/worker/api/controllers/journal-records"<br />
<br />
// Тип данных поля (DATE, TIME, STRING и т.д.) — используется для корректной обработки значений при копировании<br />
type DataType = JournalRecordAttributeResponse['field']['dataType']<br />
<br />
// Конфигурация аддона:<br />
// - journalRecordId: 208 — исходная запись ("Лаб. воздуха / Регистрация")<br />
// - nextJournalRecordStage: 2 — ID этапа, на который нужно скопировать запись ("Анализ")<br />
// - nextStageName: отображаемое имя целевого этапа<br />
// - integrationResult: сообщение при успешном копировании<br />
const config = {<br />
journalRecordId: 208, // Лаб. воздуха / Регистрация<br />
nextJournalRecordStage: 2, // Лаб. воздуха / Анализ<br />
nextStageName: 'Анализ',<br />
integrationResult: { message: 'Запись ЛЖ скопирована успешно!' }<br />
}<br />
<br />
// Сообщения для пользователя<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: 'Все необходимые поля заполнены!',<br />
}<br />
<br />
// Обработчики ошибок — централизованно выбрасывают исключения<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
// Формирует конфиг диалога для отправки в GUI: тип, заголовок и сообщение<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
// Извлекает socketId из параметров — необходим для обратной связи с интерфейсом<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
return socketId<br />
}<br />
<br />
// Показывает пользователю сообщение об ошибке<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
// Показывает уведомление об успешном копировании<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
// Преобразует ISO-дату в строку формата YYYY-MM-DD (без времени)<br />
const getDateString = (ISODate: unknown | null = null) => {<br />
return new Date(String(ISODate)).toISOString().split('T')[0]<br />
}<br />
<br />
// Преобразует ISO-дату в строку формата HH:mm:ss (без миллисекунд)<br />
const getTimeString = (ISODate: unknown | null = null) => {<br />
return new Date(String(ISODate)).toISOString().split('T')[1].split('.')[0]<br />
}<br />
<br />
/**<br />
* Создаёт новую запись лабораторного журнала на основе существующей.<br />
* <br />
* Особенности:<br />
* - Копирует все атрибуты (поля) из исходной записи.<br />
* - Автоматически корректирует значения полей типа DATE и TIME.<br />
* - Устанавливает новый этап.<br />
*/<br />
const createRecord = async (<br />
journalRecordController: JournalRecordsController,<br />
baseRecord: JournalRecordResponse,<br />
newStageId: number<br />
) => {<br />
// Корректирует значение поля в зависимости от его типа<br />
const getAttrValue = (value: unknown, dataType: DataType) => {<br />
if (dataType === "DATE") return getDateString(value)<br />
if (dataType === "TIME") return getTimeString(value)<br />
return value<br />
}<br />
<br />
// Извлекает ID привязок уровня компании (если есть)<br />
const getBindings = (baseRecord: JournalRecordResponse): number[] | null => {<br />
return baseRecord?.companyLevelBindings?.map(b => b?.id) || null<br />
} <br />
<br />
// Формирует объект запроса для создания новой записи<br />
const getRecordRequest = (baseRecord: JournalRecordResponse, newStageId: number): JournalRecordRequest => {<br />
return {<br />
routeId: baseRecord?.route?.id,<br />
stageId: newStageId,<br />
analysisObjectId: baseRecord?.analysisObject?.id,<br />
sampleTypeId: baseRecord.sampleType.id,<br />
attributes: baseRecord.attributes.map(attr => ({<br />
fieldId: attr.field.id,<br />
stageId: newStageId,<br />
data: {<br />
...attr.data, <br />
value: getAttrValue(attr?.data?.value, attr?.field?.dataType),<br />
id: undefined // Убираем ID, чтобы создать новое значение<br />
},<br />
statusId: null<br />
})),<br />
companyLevelBindings: getBindings(baseRecord)<br />
}<br />
}<br />
<br />
// Отправляет запрос на создание новой записи<br />
return await journalRecordController.createRecord(getRecordRequest(baseRecord, newStageId))<br />
}<br />
<br />
/**<br />
* Основная функция аддона:<br />
* Копирует запись лабораторного журнала на следующий этап (например, с "Регистрации" на "Анализ").<br />
* <br />
* Логика:<br />
* 1. Загружает исходную запись через JournalRecordManager.<br />
* 2. Формирует новую запись с теми же данными, но на новом этапе.<br />
* 3. Особое внимание — полям типа DATE и TIME: они преобразуются в нужный формат.<br />
* 4. Создаёт новую запись через API.<br />
* 5. Показывает пользователю ID старой и новой записи.<br />
* <br />
* Используется для автоматизации деления данных.<br />
*/<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
// Получаем данные исходной записи<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
const journalRecordController = new JournalRecordsController(apiInstance)<br />
<br />
// Создаём копию записи на новом этапе<br />
const newRecord = await createRecord(<br />
journalRecordController, <br />
journalRecordManager.data, <br />
config.nextJournalRecordStage<br />
)<br />
<br />
// Уведомляем пользователя об успехе с деталями<br />
showSuccessMessage(<br />
`${messages.success}. Id изначальной записи: ${config.journalRecordId}. ` +<br />
`Id новой записи ЛЖ: ${newRecord.id}. Этап: ${config.nextStageName}`, <br />
socketId<br />
)<br />
<br />
return config.integrationResult<br />
} catch (err) {<br />
// При любой ошибке — показываем её в модальном окне<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
</syntaxhighlight><br />
<br />
</div><br />
</div></div>
Arhidiman
https://wiki.chemsoft.ru/index.php?title=%D0%90%D0%B4%D0%B4%D0%BE%D0%BD%D1%8B&diff=2381
Аддоны
2026-04-03T06:41:34Z
<p>Arhidiman: /* Заполнение атрибутов записи ЛЖ. fill-record-fields */</p>
<hr />
<div>Список демонстрационных аддонов, показывающих возможности интеграционного сервиса.<br />
<br />
== Проверка даты регистрации. <code>check-registration-date</code> ==<br />
[[Файл:check-registration-date.png|frame]]<br />
Проверяет, не истёк ли срок регистрации пробы. Сравнивает дату регистрации из указанного поля с текущей датой. Если прошло более заданного количества дней (по умолчанию — 10), выдаёт ошибку. В противном случае показывает сообщение об успешной проверке.<br />
<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { MessageBoxResults } from "@triteia/types-integration-gui"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { DialogType } from "@triteia/types-integration-gui"<br />
import type { FetchApiClient } from "../../src/servivces/worker/api/ApiClient"<br />
import { apiInstance } from "../../src/servivces/worker/api/interactors/ApiInstance"<br />
<br />
// Конфигурация аддона:<br />
// - Поле "Дата регистрации" — контрольная точка для расчёта срока<br />
// - expirationLimit: 10 дней — максимальный допустимый срок хранения пробы<br />
// - journalRecordId: 201 — запись из журнала "Лаб. воздуха / Анализы завершены"<br />
const config = {<br />
dateField: 'Дата регистрации',<br />
expirationLimit: 10,<br />
journalRecordId: 201,<br />
integrationResult: { message: 'Срок регистрации пробы не истёк!' }<br />
}<br />
<br />
// Сообщения для пользовательских уведомлений и ошибок<br />
const messages = {<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
// Успех: информирует пользователя, что срок не вышел<br />
success: (recordId) => `Срок регистрации пробы не истёк! Id записи ${recordId}`,<br />
// Ошибка: превышен лимит хранения<br />
expired: (limit, recordId) => `Срок регистрации пробы истёк!\nПрошло более ${limit} дней с момента регистрации. Id записи: ${recordId}`,<br />
// Ошибка: отсутствует дата в нужном поле<br />
dateField: (dateField, stageName, journalRecordId) => [<br />
`Не заполнено либо отсутствует поле "${dateField}"`,<br />
`в этапе "${stageName || ''}".\nId записи: ${journalRecordId}`<br />
].join(' ')<br />
}<br />
<br />
// Централизованные обработчики ошибок — обеспечивают единообразие и чистоту основной логики<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
},<br />
// Вызывается, если поле с датой не заполнено<br />
dateError: (dateField, stageName, journalRecordId) => {<br />
throw new Error(messages.dateField(dateField, stageName, journalRecordId))<br />
},<br />
// Вызывается при превышении срока хранения<br />
expirationError: () => {<br />
throw new Error(messages.expired(config.expirationLimit, config.journalRecordId))<br />
}<br />
}<br />
<br />
// Извлекает socketId из queryParams — необходим для отправки диалогов в GUI<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
// Переводит дату в количество дней с начала эпохи (для арифметики дат)<br />
const getDaysByDate = (date: Date) => {<br />
const dayMs = 60 * 60 * 24 * 1000<br />
const timestamp = date.getTime()<br />
return timestamp / dayMs<br />
}<br />
<br />
// Формирует конфиг диалога: тип, заголовок и сообщение для отображения в GUI<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
// Рассчитывает, сколько дней прошло с момента регистрации пробы<br />
const getExpirationOffset = (registrationDate: string) => {<br />
const regDate = new Date(registrationDate)<br />
const today = new Date()<br />
return getDaysByDate(today) - getDaysByDate(regDate)<br />
}<br />
<br />
// Показывает пользователю сообщение об ошибке<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
// Показывает пользователю уведомление об успешной проверке<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
/**<br />
* Основная функция аддона:<br />
* Проверяет, не истёк ли срок хранения пробы (с момента "Дата регистрации").<br />
* <br />
* Логика:<br />
* 1. Получает значение поля "Дата регистрации" из записи журнала.<br />
* 2. Если дата не указана — ошибка.<br />
* 3. Если с даты регистрации прошло >= 10 дней — ошибка.<br />
* 4. Иначе — успех, показываем подтверждение.<br />
*/<br />
async function main({ queryParams, ...apiInstance }) {<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
// Получаем доступ к данным записи журнала<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
// Извлекаем значение поля "Дата регистрации"<br />
const date = journalRecordManager.getFieldValue(config.dateField)<br />
<br />
// Если дата не заполнена — прерываем с пояснением<br />
if (!date) {<br />
errorHandlers.dateError(config.dateField, journalRecordManager?.data?.stage?.stage?.name, config.journalRecordId)<br />
}<br />
<br />
// Считаем, сколько дней прошло с регистрации<br />
const expirationOffset = getExpirationOffset(date as string)<br />
<br />
// Если срок хранения превышен — ошибка<br />
if (expirationOffset >= config.expirationLimit) {<br />
errorHandlers.expirationError()<br />
}<br />
<br />
// Всё в порядке — информируем пользователя<br />
await showSuccessMessage(messages.success(config.journalRecordId), socketId)<br />
<br />
return config.integrationResult<br />
} catch (err) {<br />
// При любой ошибке — показываем её в модальном окне<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка заполненности полей показателей. <code>check-indicator-fields-filled</code> ==<br />
[[Файл:Check-indicator-fields-filled.png|frame]]<br />
Проверяет заполненность полей показателей в записи журнала по настраиваемому списку. Проверяет наличие определённых показателей (например, "Аммоний-ион") и заполненность у них таких полей, как исполнители, методики, средний результат и др. Выдаёт ошибку, если показатели отсутствуют или не все поля заполнены.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import type { DialogType } from "@triteia/types-integration-gui"<br />
import type { JournalRecordIndicatorResponse } from "../../src/servivces/worker/api/controllers/journal-records"<br />
import type { IJournalRecordManager } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
<br />
// Описание свойств показателя (индикатора), которые нужно проверить<br />
// Каждое свойство имеет метку (для отображения пользователю) и геттер значения<br />
type IndicatorProp = { label: string, get: () => unknown }<br />
type IndicatorPropsConfig = Record<string, IndicatorProp><br />
<br />
// Конфигурация полей, которые проверяются у каждого показателя<br />
// Например: "Исполнители", "Методики", "Средний результат" и т.д.<br />
const indicatorPropsConfig = (indicator): IndicatorPropsConfig => {<br />
return {<br />
executors: {<br />
label: 'Исполнители', <br />
get: () => indicator?.result?.executors<br />
},<br />
methodic: {<br />
label: 'Методики', <br />
get: () => indicator?.methodics<br />
},<br />
averageResult: {<br />
label: 'Средний результат', <br />
get: () => indicator?.result?.averageValue<br />
},<br />
averageRoundedValue: {<br />
label: 'Средний округлённый результат', <br />
get: () => indicator?.result?.averageRoundedValue<br />
}<br />
}<br />
}<br />
<br />
// Конфигурация аддона:<br />
// - indicatorsList: список обязательных показателей (например, "Аммоний-ион")<br />
// - journalRecordId: 144 — тестовая запись ("Мк / Тест_Ушакова")<br />
const config = {<br />
indicatorsList: [<br />
'Аммоний-ион'<br />
],<br />
journalRecordId: 144,<br />
integrationResult: { message: 'Все поля заполнены!' }<br />
}<br />
<br />
// Сообщения для пользовательских уведомлений и ошибок<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: 'Все необходимые поля заполнены!',<br />
emptyIndicators: (recordId) => `в записи с Id ${recordId} отсутствуют показатели`,<br />
emptyFieldsError: (fields, recordId) => `Поля ${fields.map(f => `"${f}"`).join(', ')} не заполнены в записи с ID ${recordId}`,<br />
indicators: (indicators: string[], recordId) => `Показатели ${indicators.map(f => `"${f}"`).join(', ')} отсутствуют в записи с ID ${recordId}`,<br />
// Формирует детализированное сообщение о незаполненных полях внутри показателей<br />
emptyIndicatorsProps: (props: Record<string, string[]>, recordId) => {<br />
const propsString = Object.keys(props).map(prop => !isEmptyArray(props[prop]) ? `${prop}: ${props[prop].map(p => `"${p}"`).join(', ')}` : '').join('; ')<br />
return `В записи с Id ${recordId} отсутствуют либо не заполнены следующие поля у показателей: ${propsString}`<br />
}<br />
}<br />
<br />
// Централизованные обработчики ошибок — обеспечивают единообразие и чистоту основной логики<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
fieldsError: (emptyFields, recordId) => {<br />
throw new Error(messages.emptyFieldsError(emptyFields, recordId))<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
},<br />
indicatorsError: (recordId) => {<br />
throw new Error(messages.emptyIndicators(recordId))<br />
},<br />
notFoundIndicators: (indicators: string[], recordId: number) => {<br />
throw new Error(messages.indicators(indicators, recordId))<br />
},<br />
notFilledIndicatorProps: (props: Record<string, string[]>) => {<br />
throw new Error(messages.emptyIndicatorsProps(props, config.journalRecordId))<br />
}<br />
}<br />
<br />
// Формирует конфиг диалога для отправки в GUI: тип, заголовок и сообщение<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
// Извлекает socketId из queryParams — необходим для связи с интерфейсом<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
// Показывает пользователю модальное окно с ошибкой<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
// Показывает уведомление об успешной проверке<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
// Универсальная проверка: является ли массив пустым (с учётом типа)<br />
const isEmptyArray = (arr: unknown[]) => {<br />
return Array.isArray(arr) && arr.length === 0<br />
}<br />
<br />
// Проверяет, есть ли у записи хотя бы один показатель<br />
const hasIndicators = (journalRecordManager: IJournalRecordManager) => {<br />
const indicators = journalRecordManager?.data?.indicators<br />
return Array.isArray(indicators) && indicators.length > 0<br />
}<br />
<br />
// Определяет, какие из требуемых показателей отсутствуют в записи<br />
const getNotFoundIndicators = (indicators: JournalRecordIndicatorResponse[], indicatorsList = config.indicatorsList) => {<br />
return indicatorsList.filter(ind => <br />
indicators.every(ljInd => ljInd?.indicator?.name?.toLowerCase() !== ind.toLowerCase())<br />
)<br />
} <br />
<br />
// Собирает список незаполненных полей для каждого показателя<br />
// Возвращает объект: { "Аммоний-ион": ["Исполнители", "Средний результат"] }<br />
const getNotFilledResultsFields = (indicators: JournalRecordIndicatorResponse[]): Record<string, string[]> => {<br />
return indicators.reduce((acc, indicator) => {<br />
const config = indicatorPropsConfig(indicator)<br />
return {<br />
...acc,<br />
[indicator?.indicator?.name]: Object.keys(config).reduce((acc, prop) => {<br />
if (!config[prop].get()) return [...acc, config[prop].label]<br />
return acc<br />
}, [] as string[])<br />
}<br />
}, {}) as Record<string, string[]><br />
}<br />
<br />
// Проверяет, есть ли хотя бы один показатель с незаполненными полями<br />
const hasNotFilledProps = (indicatorsProps: Record<string, string[]>) => {<br />
return Object.keys(indicatorsProps).some(indicator => !isEmptyArray(indicatorsProps[indicator]))<br />
}<br />
<br />
// Проверяет, есть ли отсутствующие показатели в списке<br />
const hasNotFoundIndicators = (indicators: string[]) => !isEmptyArray(indicators)<br />
<br />
/**<br />
* Основная функция аддона:<br />
* Проверяет заполненность:<br />
* 1. Наличие указанных показателей (например, "Аммоний-ион").<br />
* 2. Заполненность внутренних полей каждого показателя (исполнители, методики и т.д.).<br />
* <br />
* При обнаружении проблем — прерывает выполнение и показывает детализированную ошибку.<br />
*/<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
<br />
// Проверка: есть ли вообще показатели в записи?<br />
if (!hasIndicators(journalRecordManager)) {<br />
errorHandlers.indicatorsError(journalRecordManager.journalRecordId)<br />
}<br />
<br />
const indicators = journalRecordManager?.data?.indicators<br />
<br />
// Проверка: все ли требуемые показатели присутствуют?<br />
const notFoundIndicators = getNotFoundIndicators(indicators)<br />
if (hasNotFoundIndicators(notFoundIndicators)) { <br />
errorHandlers.notFoundIndicators(notFoundIndicators, journalRecordManager.journalRecordId)<br />
}<br />
<br />
// Проверка: все ли поля у показателей заполнены?<br />
const emptyIndicatorProps = getNotFilledResultsFields(indicators)<br />
if (hasNotFilledProps(emptyIndicatorProps)) {<br />
errorHandlers.notFilledIndicatorProps(emptyIndicatorProps)<br />
}<br />
<br />
// Все проверки пройдены — информируем пользователя<br />
showSuccessMessage(messages.success, socketId)<br />
} catch (err) {<br />
// При любой ошибке — показываем её в модальном окне<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка заполненности атрибутов записи ЛЖ. <code>check-record-fields-filled</code> ==<br />
[[Файл:Check-record-fields-filled.png|frame]]<br />
Проверяет заполненность заданных полей в записи журнала (например, "Источник", "Место отбора", "Дата регистрации" и др.). Если какое-либо из обязательных полей не заполнено, выдаётся соответствующая ошибка.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { DialogType } from "@triteia/types-integration-gui"<br />
import { IJournalRecordManager } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
<br />
const config = {<br />
requiredFields: [<br />
'Источник',<br />
'Список. Целое число',<br />
'Строка',<br />
'Целое число',<br />
'Вещественное число',<br />
'Логический тип',<br />
'Дата',<br />
'Время',<br />
],<br />
journalRecordId: 144, // Мк / Тест_Ушакова<br />
integrationResult: { message: 'Все поля заполнены!' }<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: 'Все необходимые поля заполнены!',<br />
emptyFieldsError: (fields, recordId) => `Поля ${fields.map(f => `"${f}"`).join(', ')} не заполнены в записи с ID ${recordId}`,<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
fieldsError: (emptyFields, recordId) => {<br />
throw new Error(messages.emptyFieldsError(emptyFields, recordId))<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const isEmptyArray = (arr: unknown[]) => {<br />
return arr.length === 0<br />
}<br />
<br />
const getNotFilledFields = (fields: string[], journalRecordsManager: IJournalRecordManager) => {<br />
console.log(journalRecordsManager.data.attributes, 'data.attributes')<br />
return fields.filter(f => !journalRecordsManager.getFieldValue(f))<br />
}<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
const emptyFields = getNotFilledFields(config.requiredFields, journalRecordManager)<br />
<br />
if (isEmptyArray(emptyFields)) {<br />
showSuccessMessage(messages.success, socketId)<br />
return config.integrationResult<br />
} else errorHandlers.fieldsError(emptyFields, config.journalRecordId)<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка движения пробы. <code>check-sample-moving</code> ==<br />
[[Файл:Check-sample-moving.png|frame]]<br />
Проверяет маршрут движения пробы по этапам. Получает историю перемещений записи и определяет, происходило ли движение (нахождение более чем на одном этапе). Отображает маршрут или сообщает, что движение не происходило.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { JournalsRecordRouteController } from "../../src/servivces/worker/api/controllers/journals-record-route"<br />
import { apiInstance } from "../../src/servivces/worker/api/interactors/ApiInstance"<br />
import type { DialogType } from "@triteia/types-integration-gui"<br />
import type { JournalRecordRouteDto } from "../../src/servivces/worker/api/controllers/journal-records"<br />
<br />
// Конфигурация аддона:<br />
// - journalRecordId: 114 — запись из журнала "Лаб. воздуха / Анализы завершены"<br />
// Аддон анализирует маршрут движения пробы по этапам ЛЖ<br />
const config = {<br />
journalRecordId: 114<br />
}<br />
<br />
// Сообщения для отображения пользователю<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
// Формирует строку с маршрутом пробы: этапы через " -> "<br />
route: (routes: JournalRecordRouteDto[], recordId: number) => <br />
`Маршрут пробы: ${routes.map(r => `"${r.stageName}"`).join(' -> ')}. Id записи ЛЖ: ${recordId}`,<br />
// Сообщение, если проба не перемещалась между этапами<br />
notMoved: (recordId: number) => <br />
`Движение пробы не происходило. Id записи ЛЖ: ${recordId}`<br />
}<br />
<br />
// Обработчики ошибок — централизованно выбрасывают исключения с понятными сообщениями<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
// Формирует конфиг диалога для GUI: тип (confirm), заголовок и текст<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
// Извлекает socketId из параметров запроса — необходим для отправки ответа в интерфейс<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
// Показывает пользователю модальное окно с ошибкой<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
// Показывает информационное сообщение (успех или статус)<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
// Определяет, перемещалась ли проба: если более одного этапа — значит, было движение<br />
const isSampleMoved = (moves: JournalRecordRouteDto[]) => {<br />
return Array.isArray(moves) && moves.length > 1<br />
}<br />
<br />
/**<br />
* Основная функция аддона:<br />
* Получает маршрут пробы по этапам лабораторного журнала и отображает его пользователю.<br />
* <br />
* Логика:<br />
* 1. Проверяет наличие параметров и подключение клиента (socketId).<br />
* 2. Запрашивает историю перемещений пробы через API.<br />
* 3. Если проба прошла более одного этапа — отображает маршрут.<br />
* 4. Если осталась на одном этапе — сообщает, что движения не было.<br />
*/<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
// Контроллер для работы с маршрутом записи (история этапов)<br />
const journalsRecordRouteController = new JournalsRecordRouteController(apiInstance)<br />
// Получаем список этапов, через которые прошла проба<br />
const sampleMoves = await journalsRecordRouteController.getJournalRecordRoute(config.journalRecordId)<br />
<br />
if (isSampleMoved(sampleMoves)) {<br />
// Проба перемещалась — показываем полный маршрут<br />
showSuccessMessage(messages.route(sampleMoves, config.journalRecordId), socketId)<br />
} else {<br />
// Проба не покидала исходный этап<br />
showSuccessMessage(messages.notMoved(config.journalRecordId), socketId)<br />
}<br />
} catch (err) {<br />
// При любой ошибке (сеть, доступ, данные) — показываем её пользователю<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка прав пользователя. <code>check-user-rights</code> ==<br />
[[Файл:Check-user-rights.png|frame]]<br />
Проверяет права доступа пользователя к определённым ресурсам (объекты анализа, методики, записи ЛЖ). Отображает таблицу с типами доступа (чтение, запись и т.д.) и наличием прав по каждому ресурсу.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { apiInstance } from "../../src/servivces/worker/api/interactors/ApiInstance"<br />
import { <br />
PermissionController, <br />
PermissionResource, <br />
PermissionRwAccess<br />
} from "../../src/servivces/worker/api/controllers/permisson"<br />
<br />
import { TableBuilder } from "../../src/gui/builder"<br />
import type { DialogType, TableConfig } from "@triteia/types-integration-gui"<br />
import type { JournalRecordRouteDto } from "../../src/servivces/worker/api/controllers/journal-records"<br />
<br />
// Отображение типов доступа в понятные пользователю названия<br />
const accessNamesMap = {<br />
[PermissionRwAccess.EXEC]: 'Выполнение',<br />
[PermissionRwAccess.READ]: 'Чтение',<br />
[PermissionRwAccess.WRITE]: 'Запись',<br />
}<br />
<br />
// Список ресурсов, права на которые необходимо проверить<br />
const requiredResources = [<br />
PermissionResource.ANALYSIS_OBJECT, <br />
PermissionResource.METHODOLOGY,<br />
PermissionResource.JOURNAL_RECORD<br />
]<br />
<br />
// Отображение идентификаторов ресурсов в читаемые названия для отображения в таблице<br />
const resourcesNamesMap = {<br />
[PermissionResource.ANALYSIS_OBJECT]: 'Объекты анализа', <br />
[PermissionResource.METHODOLOGY]: 'Методики', <br />
[PermissionResource.JOURNAL_RECORD]: 'Записи ЛЖ'<br />
}<br />
<br />
/**<br />
* Формирует конфигурацию таблицы с правами доступа:<br />
* - Для каждого ресурса проверяются все типы доступа (чтение, запись, выполнение).<br />
* - Возвращает готовую конфигурацию таблицы для отображения в GUI.<br />
*/<br />
const getAccessRightsTable = async (tableBuilder: TableBuilder, permissionController: PermissionController): Promise<TableConfig> => {<br />
// Получаем список строк: комбинация "ресурс + тип доступа + наличие права"<br />
const rows = (await Promise.all(requiredResources.map(async (source: PermissionResource) => {<br />
const sourceCombinations = await Promise.all(Object.keys(PermissionRwAccess).map(async (action) => {<br />
const access = await permissionController.getSourcePermission(source, PermissionRwAccess[action])<br />
return { <br />
source: resourcesNamesMap[source], <br />
action: accessNamesMap[PermissionRwAccess[action]], <br />
access: access.hasPermission <br />
}<br />
}))<br />
return sourceCombinations<br />
} <br />
))).flat()<br />
<br />
// Строим таблицу с помощью TableBuilder<br />
const table = tableBuilder<br />
.name('simpleTable')<br />
.label('Таблица')<br />
.isAddable(false) // Нельзя добавлять строки<br />
.actionsCol(false) // Скрыть колонку действий<br />
.addColumn('Ресурс', 'source', false)<br />
.config('input', { name: 'source', rules: [{ required: true }] }, { placeholder: '', disabled: false })<br />
.next()<br />
.addColumn('Тип доступа', 'action', false)<br />
.config('input', { name: 'action' }, { type: 'string', placeholder: '', disabled: false })<br />
.next()<br />
.addColumn('Доступ', 'access', false)<br />
.config('checkbox', { name: 'access' }, { type: 'boolean', placeholder: '', disabled: true }) // Только для просмотра<br />
.next()<br />
.setRows(rows)<br />
.build();<br />
<br />
return table<br />
}<br />
<br />
// Сообщения для пользователя<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
}<br />
<br />
// Обработчики ошибок — централизованно выбрасывают исключения<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
// Формирует конфиг диалога для отправки в GUI<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
// Извлекает socketId из параметров — необходим для обратной связи с интерфейсом<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
return socketId<br />
}<br />
<br />
// Показывает пользователю сообщение об ошибке<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
<br />
// Показывает таблицу с правами доступа в модальном окне<br />
const showTable = async (builder: TableBuilder, controller: PermissionController, socketId: string) => <br />
await getDataFromDialog({ type: 'input-data', config: [await getAccessRightsTable(builder, controller)] }, socketId)<br />
<br />
/**<br />
* Основная функция аддона:<br />
* Отображает пользователю таблицу с текущими правами доступа на ключевые ресурсы системы.<br />
* <br />
* Логика:<br />
* 1. Проверяет наличие параметров и активное соединение (socketId).<br />
* 2. Запрашивает права для каждого ресурса и типа доступа.<br />
* 3. Формирует таблицу через TableBuilder.<br />
* 4. Показывает её в модальном окне.<br />
* <br />
* Результат: пользователь видит, какие действия разрешены для "Объектов анализа", "Методик" и "Записей ЛЖ".<br />
*/<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
// Создаём экземпляры билдера и контроллера прав доступа<br />
await showTable(new TableBuilder(), new PermissionController(apiInstance), socketId)<br />
} catch (err) {<br />
// При любой ошибке — показываем её в модальном окне<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Заполнение атрибутов записи ЛЖ. <code>fill-record-fields</code> ==<br />
[[Файл:Fill-record-fields.png|frame]]<br />
Автоматически заполняет заданные поля в записи журнала (например, даты, место отбора, шифр пробы и др.). Есть возможность использования ключевых слов для сопоставления полей, если точные названия не совпадают.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { DialogType } from "@triteia/types-integration-gui"<br />
import { IJournalRecordManager } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
import { JournalRecordAttributeFieldResponse } from "../../src/servivces/worker/api/controllers/lj-eav-attribute-fields"<br />
import { FieldMatch } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
<br />
// Текущая дата в формате YYYY-MM-DD — используется как значение по умолчанию для полей с датой<br />
const date = new Date().toISOString().split('T')[0]<br />
<br />
// Конфигурация аддона:<br />
// - requiredFields: список полей, которые нужно заполнить<br />
// Каждое поле содержит:<br />
// • name — отображаемое имя<br />
// • value — значение, которое будет установлено<br />
// • keywords — ключевые слова для поиска соответствующего поля в записи<br />
// - journalRecordId: 118 — тестовая запись ("Мк / 111")<br />
// - Результат при успехе: сообщение о завершении<br />
const config = {<br />
requiredFields: [<br />
{ name: 'Дата регистрации', value: date, keywords: ['дат', 'регистр'] },<br />
{ name: 'Место отбора', value: 'Скважина 516563Г ', keywords: ['мест', 'отбор'] },<br />
{ name: 'Дата отбора', value: date, keywords: ['дат', 'отбор'] },<br />
{ name: 'Шифр пробы', value: 'shifr 123', keywords: ['дат', 'регистр']},<br />
{ name: 'Список. Целое число', value: 666, keywords: ['спис', 'цел', 'числ'] },<br />
{ name: 'Помещение', value: 'помещение', keywords: ['помещ']},<br />
] as FieldMatch[],<br />
journalRecordId: 118, // Мк / 111<br />
integrationResult: { message: 'Все поля заполнены!' }<br />
}<br />
<br />
// Сообщения для пользователя<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: (recordId) => `Все необходимые поля заполнены! Id записи: ${recordId}`,<br />
emptyFieldsError: (fields, recordId) => `Поля ${fields.map(f => `"${f}"`).join(', ')} не заполнены в записи с ID ${recordId}`,<br />
}<br />
<br />
// Обработчики ошибок — централизованно выбрасывают исключения<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
// Формирует конфиг диалога для отправки в GUI: тип, заголовок и сообщение<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
// Извлекает socketId из параметров — необходим для обратной связи с интерфейсом<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
return socketId<br />
}<br />
<br />
// Показывает пользователю сообщение об ошибке<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
// Показывает уведомление об успешном заполнении<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
// Сопоставляет поле из записи (по имени) с требуемым полем через ключевые слова<br />
// Например: если имя поля содержит "дат" и "регистр" → подходит под "Дата регистрации"<br />
const fieldsMatcher = (field: JournalRecordAttributeFieldResponse, searchField: FieldMatch) => {<br />
return searchField.keywords.every(k => <br />
String(field.name).toLocaleLowerCase().includes(k.toLocaleLowerCase())<br />
)<br />
}<br />
<br />
// Заполняет указанные поля в записи журнала с использованием кастомного механизма сопоставления<br />
const fillFields = async (fields: FieldMatch[], journalRecordsManager: IJournalRecordManager) => {<br />
await journalRecordsManager.setFieldsValues(fields, journalRecordsManager, fieldsMatcher)<br />
}<br />
<br />
/**<br />
* Основная функция аддона:<br />
* Автоматически заполняет заданные поля в записи лабораторного журнала.<br />
* <br />
* Особенности:<br />
* - Поля ищутся не по точному имени, а по ключевым словам (гибкое сопоставление).<br />
* - Поддерживает разные типы значений: строки, числа, даты.<br />
* - Используется в тестовых или демонстрационных целях.<br />
* <br />
* Логика:<br />
* 1. Проверяет наличие параметров и активное соединение.<br />
* 2. Загружает запись журнала.<br />
* 3. Для каждого поля из config.requiredFields:<br />
* - Находит соответствующее поле в записи по ключевым словам.<br />
* - Устанавливает указанное значение.<br />
* 4. Сообщает пользователю об успехе.<br />
*/<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
// Получаем менеджер для работы с записью<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
// Заполняем поля по ключевым словам<br />
await fillFields(config.requiredFields, journalRecordManager)<br />
// Информируем пользователя о завершении<br />
showSuccessMessage(messages.success(journalRecordManager.journalRecordId), socketId)<br />
return config.integrationResult<br />
} catch (err) {<br />
// При любой ошибке — показываем её в модальном окне<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Деление данных. <code>copy-journal-record</code> ==<br />
[[Файл:Copy-journal-record.png|frame]]<br />
Создаёт копию записи журнала на заданном этапе маршрута. Выводит сообщение с ID новой записи.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { JournalRecordsController } from "../../src/servivces/worker/api/controllers/journal-records"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { apiInstance } from "../../src/servivces/worker/api/interactors/ApiInstance"<br />
import type { DialogType } from "@triteia/types-integration-gui"<br />
import type { JournalRecordRequest, JournalRecordResponse } from "../../src/servivces/worker/api/controllers/journal-records"<br />
import type { JournalRecordAttributeResponse } from "../../src/servivces/worker/api/controllers/journal-records"<br />
<br />
type DataType = JournalRecordAttributeResponse['field']['dataType']<br />
<br />
const config = {<br />
journalRecordId: 208, // Лаб. воздуха / Регистрация<br />
nextJournalRecordStage: 2, // Лаб. воздуха / Анализ<br />
nextStageName: 'Анализ',<br />
nextRouteId: 50,<br />
integrationResult: { message: 'Запись ЛЖ скопирована успешно!' }<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: 'Все необходимые поля заполнены!',<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const getDateString = (ISODate: unknown | null = null) => {<br />
return new Date(String(ISODate)).toISOString().split('T')[0]<br />
}<br />
<br />
const getTimeString = (ISODate: unknown | null = null) => {<br />
return new Date(String(ISODate)).toISOString().split('T')[1].split('.')[0]<br />
}<br />
<br />
const createRecord = async (journalRecordController: JournalRecordsController, baseRecord: JournalRecordResponse, newStageId) => {<br />
const getAttrValue = (value: unknown, dataType: DataType) => {<br />
if (dataType === "DATE") return getDateString(value)<br />
if (dataType === "TIME") return getTimeString(value)<br />
return value<br />
}<br />
<br />
const getBindings = (baseRecord: JournalRecordResponse): number[] | null => {<br />
return baseRecord?.companyLevelBindings?.map(b => b?.id) || null<br />
} <br />
<br />
const getRecordRequest = (baseRecord: JournalRecordResponse, newStageId: number): JournalRecordRequest => {<br />
return {<br />
routeId: baseRecord?.route?.id,<br />
stageId: newStageId,<br />
analysisObjectId: baseRecord?.analysisObject?.id,<br />
sampleTypeId: baseRecord.sampleType.id,<br />
attributes: baseRecord.attributes.map(attr => {<br />
return {<br />
fieldId: attr.field.id,<br />
stageId: newStageId,<br />
data: {<br />
...attr.data, <br />
value: getAttrValue(attr?.data?.value, attr?.field?.dataType),<br />
id: undefined<br />
},<br />
statusId: null<br />
}<br />
}),<br />
companyLevelBindings: getBindings(baseRecord)<br />
}<br />
}<br />
return await journalRecordController.createRecord(getRecordRequest(baseRecord, newStageId))<br />
}<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
const journalRecordController = new JournalRecordsController(apiInstance)<br />
const newRecord = await createRecord(journalRecordController, journalRecordManager.data, config.nextJournalRecordStage)<br />
showSuccessMessage(`${messages.success}. Id изначальной записи: ${config.journalRecordId}. Id новой записи ЛЖ: ${newRecord.id}. Этап: ${config.nextStageName}`, socketId)<br />
return config.integrationResult<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
</div><br />
</div></div>
Arhidiman
https://wiki.chemsoft.ru/index.php?title=%D0%90%D0%B4%D0%B4%D0%BE%D0%BD%D1%8B&diff=2380
Аддоны
2026-04-03T06:37:23Z
<p>Arhidiman: /* Проверка прав пользователя. check-user-rights */</p>
<hr />
<div>Список демонстрационных аддонов, показывающих возможности интеграционного сервиса.<br />
<br />
== Проверка даты регистрации. <code>check-registration-date</code> ==<br />
[[Файл:check-registration-date.png|frame]]<br />
Проверяет, не истёк ли срок регистрации пробы. Сравнивает дату регистрации из указанного поля с текущей датой. Если прошло более заданного количества дней (по умолчанию — 10), выдаёт ошибку. В противном случае показывает сообщение об успешной проверке.<br />
<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { MessageBoxResults } from "@triteia/types-integration-gui"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { DialogType } from "@triteia/types-integration-gui"<br />
import type { FetchApiClient } from "../../src/servivces/worker/api/ApiClient"<br />
import { apiInstance } from "../../src/servivces/worker/api/interactors/ApiInstance"<br />
<br />
// Конфигурация аддона:<br />
// - Поле "Дата регистрации" — контрольная точка для расчёта срока<br />
// - expirationLimit: 10 дней — максимальный допустимый срок хранения пробы<br />
// - journalRecordId: 201 — запись из журнала "Лаб. воздуха / Анализы завершены"<br />
const config = {<br />
dateField: 'Дата регистрации',<br />
expirationLimit: 10,<br />
journalRecordId: 201,<br />
integrationResult: { message: 'Срок регистрации пробы не истёк!' }<br />
}<br />
<br />
// Сообщения для пользовательских уведомлений и ошибок<br />
const messages = {<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
// Успех: информирует пользователя, что срок не вышел<br />
success: (recordId) => `Срок регистрации пробы не истёк! Id записи ${recordId}`,<br />
// Ошибка: превышен лимит хранения<br />
expired: (limit, recordId) => `Срок регистрации пробы истёк!\nПрошло более ${limit} дней с момента регистрации. Id записи: ${recordId}`,<br />
// Ошибка: отсутствует дата в нужном поле<br />
dateField: (dateField, stageName, journalRecordId) => [<br />
`Не заполнено либо отсутствует поле "${dateField}"`,<br />
`в этапе "${stageName || ''}".\nId записи: ${journalRecordId}`<br />
].join(' ')<br />
}<br />
<br />
// Централизованные обработчики ошибок — обеспечивают единообразие и чистоту основной логики<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
},<br />
// Вызывается, если поле с датой не заполнено<br />
dateError: (dateField, stageName, journalRecordId) => {<br />
throw new Error(messages.dateField(dateField, stageName, journalRecordId))<br />
},<br />
// Вызывается при превышении срока хранения<br />
expirationError: () => {<br />
throw new Error(messages.expired(config.expirationLimit, config.journalRecordId))<br />
}<br />
}<br />
<br />
// Извлекает socketId из queryParams — необходим для отправки диалогов в GUI<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
// Переводит дату в количество дней с начала эпохи (для арифметики дат)<br />
const getDaysByDate = (date: Date) => {<br />
const dayMs = 60 * 60 * 24 * 1000<br />
const timestamp = date.getTime()<br />
return timestamp / dayMs<br />
}<br />
<br />
// Формирует конфиг диалога: тип, заголовок и сообщение для отображения в GUI<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
// Рассчитывает, сколько дней прошло с момента регистрации пробы<br />
const getExpirationOffset = (registrationDate: string) => {<br />
const regDate = new Date(registrationDate)<br />
const today = new Date()<br />
return getDaysByDate(today) - getDaysByDate(regDate)<br />
}<br />
<br />
// Показывает пользователю сообщение об ошибке<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
// Показывает пользователю уведомление об успешной проверке<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
/**<br />
* Основная функция аддона:<br />
* Проверяет, не истёк ли срок хранения пробы (с момента "Дата регистрации").<br />
* <br />
* Логика:<br />
* 1. Получает значение поля "Дата регистрации" из записи журнала.<br />
* 2. Если дата не указана — ошибка.<br />
* 3. Если с даты регистрации прошло >= 10 дней — ошибка.<br />
* 4. Иначе — успех, показываем подтверждение.<br />
*/<br />
async function main({ queryParams, ...apiInstance }) {<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
// Получаем доступ к данным записи журнала<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
// Извлекаем значение поля "Дата регистрации"<br />
const date = journalRecordManager.getFieldValue(config.dateField)<br />
<br />
// Если дата не заполнена — прерываем с пояснением<br />
if (!date) {<br />
errorHandlers.dateError(config.dateField, journalRecordManager?.data?.stage?.stage?.name, config.journalRecordId)<br />
}<br />
<br />
// Считаем, сколько дней прошло с регистрации<br />
const expirationOffset = getExpirationOffset(date as string)<br />
<br />
// Если срок хранения превышен — ошибка<br />
if (expirationOffset >= config.expirationLimit) {<br />
errorHandlers.expirationError()<br />
}<br />
<br />
// Всё в порядке — информируем пользователя<br />
await showSuccessMessage(messages.success(config.journalRecordId), socketId)<br />
<br />
return config.integrationResult<br />
} catch (err) {<br />
// При любой ошибке — показываем её в модальном окне<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка заполненности полей показателей. <code>check-indicator-fields-filled</code> ==<br />
[[Файл:Check-indicator-fields-filled.png|frame]]<br />
Проверяет заполненность полей показателей в записи журнала по настраиваемому списку. Проверяет наличие определённых показателей (например, "Аммоний-ион") и заполненность у них таких полей, как исполнители, методики, средний результат и др. Выдаёт ошибку, если показатели отсутствуют или не все поля заполнены.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import type { DialogType } from "@triteia/types-integration-gui"<br />
import type { JournalRecordIndicatorResponse } from "../../src/servivces/worker/api/controllers/journal-records"<br />
import type { IJournalRecordManager } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
<br />
// Описание свойств показателя (индикатора), которые нужно проверить<br />
// Каждое свойство имеет метку (для отображения пользователю) и геттер значения<br />
type IndicatorProp = { label: string, get: () => unknown }<br />
type IndicatorPropsConfig = Record<string, IndicatorProp><br />
<br />
// Конфигурация полей, которые проверяются у каждого показателя<br />
// Например: "Исполнители", "Методики", "Средний результат" и т.д.<br />
const indicatorPropsConfig = (indicator): IndicatorPropsConfig => {<br />
return {<br />
executors: {<br />
label: 'Исполнители', <br />
get: () => indicator?.result?.executors<br />
},<br />
methodic: {<br />
label: 'Методики', <br />
get: () => indicator?.methodics<br />
},<br />
averageResult: {<br />
label: 'Средний результат', <br />
get: () => indicator?.result?.averageValue<br />
},<br />
averageRoundedValue: {<br />
label: 'Средний округлённый результат', <br />
get: () => indicator?.result?.averageRoundedValue<br />
}<br />
}<br />
}<br />
<br />
// Конфигурация аддона:<br />
// - indicatorsList: список обязательных показателей (например, "Аммоний-ион")<br />
// - journalRecordId: 144 — тестовая запись ("Мк / Тест_Ушакова")<br />
const config = {<br />
indicatorsList: [<br />
'Аммоний-ион'<br />
],<br />
journalRecordId: 144,<br />
integrationResult: { message: 'Все поля заполнены!' }<br />
}<br />
<br />
// Сообщения для пользовательских уведомлений и ошибок<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: 'Все необходимые поля заполнены!',<br />
emptyIndicators: (recordId) => `в записи с Id ${recordId} отсутствуют показатели`,<br />
emptyFieldsError: (fields, recordId) => `Поля ${fields.map(f => `"${f}"`).join(', ')} не заполнены в записи с ID ${recordId}`,<br />
indicators: (indicators: string[], recordId) => `Показатели ${indicators.map(f => `"${f}"`).join(', ')} отсутствуют в записи с ID ${recordId}`,<br />
// Формирует детализированное сообщение о незаполненных полях внутри показателей<br />
emptyIndicatorsProps: (props: Record<string, string[]>, recordId) => {<br />
const propsString = Object.keys(props).map(prop => !isEmptyArray(props[prop]) ? `${prop}: ${props[prop].map(p => `"${p}"`).join(', ')}` : '').join('; ')<br />
return `В записи с Id ${recordId} отсутствуют либо не заполнены следующие поля у показателей: ${propsString}`<br />
}<br />
}<br />
<br />
// Централизованные обработчики ошибок — обеспечивают единообразие и чистоту основной логики<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
fieldsError: (emptyFields, recordId) => {<br />
throw new Error(messages.emptyFieldsError(emptyFields, recordId))<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
},<br />
indicatorsError: (recordId) => {<br />
throw new Error(messages.emptyIndicators(recordId))<br />
},<br />
notFoundIndicators: (indicators: string[], recordId: number) => {<br />
throw new Error(messages.indicators(indicators, recordId))<br />
},<br />
notFilledIndicatorProps: (props: Record<string, string[]>) => {<br />
throw new Error(messages.emptyIndicatorsProps(props, config.journalRecordId))<br />
}<br />
}<br />
<br />
// Формирует конфиг диалога для отправки в GUI: тип, заголовок и сообщение<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
// Извлекает socketId из queryParams — необходим для связи с интерфейсом<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
// Показывает пользователю модальное окно с ошибкой<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
// Показывает уведомление об успешной проверке<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
// Универсальная проверка: является ли массив пустым (с учётом типа)<br />
const isEmptyArray = (arr: unknown[]) => {<br />
return Array.isArray(arr) && arr.length === 0<br />
}<br />
<br />
// Проверяет, есть ли у записи хотя бы один показатель<br />
const hasIndicators = (journalRecordManager: IJournalRecordManager) => {<br />
const indicators = journalRecordManager?.data?.indicators<br />
return Array.isArray(indicators) && indicators.length > 0<br />
}<br />
<br />
// Определяет, какие из требуемых показателей отсутствуют в записи<br />
const getNotFoundIndicators = (indicators: JournalRecordIndicatorResponse[], indicatorsList = config.indicatorsList) => {<br />
return indicatorsList.filter(ind => <br />
indicators.every(ljInd => ljInd?.indicator?.name?.toLowerCase() !== ind.toLowerCase())<br />
)<br />
} <br />
<br />
// Собирает список незаполненных полей для каждого показателя<br />
// Возвращает объект: { "Аммоний-ион": ["Исполнители", "Средний результат"] }<br />
const getNotFilledResultsFields = (indicators: JournalRecordIndicatorResponse[]): Record<string, string[]> => {<br />
return indicators.reduce((acc, indicator) => {<br />
const config = indicatorPropsConfig(indicator)<br />
return {<br />
...acc,<br />
[indicator?.indicator?.name]: Object.keys(config).reduce((acc, prop) => {<br />
if (!config[prop].get()) return [...acc, config[prop].label]<br />
return acc<br />
}, [] as string[])<br />
}<br />
}, {}) as Record<string, string[]><br />
}<br />
<br />
// Проверяет, есть ли хотя бы один показатель с незаполненными полями<br />
const hasNotFilledProps = (indicatorsProps: Record<string, string[]>) => {<br />
return Object.keys(indicatorsProps).some(indicator => !isEmptyArray(indicatorsProps[indicator]))<br />
}<br />
<br />
// Проверяет, есть ли отсутствующие показатели в списке<br />
const hasNotFoundIndicators = (indicators: string[]) => !isEmptyArray(indicators)<br />
<br />
/**<br />
* Основная функция аддона:<br />
* Проверяет заполненность:<br />
* 1. Наличие указанных показателей (например, "Аммоний-ион").<br />
* 2. Заполненность внутренних полей каждого показателя (исполнители, методики и т.д.).<br />
* <br />
* При обнаружении проблем — прерывает выполнение и показывает детализированную ошибку.<br />
*/<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
<br />
// Проверка: есть ли вообще показатели в записи?<br />
if (!hasIndicators(journalRecordManager)) {<br />
errorHandlers.indicatorsError(journalRecordManager.journalRecordId)<br />
}<br />
<br />
const indicators = journalRecordManager?.data?.indicators<br />
<br />
// Проверка: все ли требуемые показатели присутствуют?<br />
const notFoundIndicators = getNotFoundIndicators(indicators)<br />
if (hasNotFoundIndicators(notFoundIndicators)) { <br />
errorHandlers.notFoundIndicators(notFoundIndicators, journalRecordManager.journalRecordId)<br />
}<br />
<br />
// Проверка: все ли поля у показателей заполнены?<br />
const emptyIndicatorProps = getNotFilledResultsFields(indicators)<br />
if (hasNotFilledProps(emptyIndicatorProps)) {<br />
errorHandlers.notFilledIndicatorProps(emptyIndicatorProps)<br />
}<br />
<br />
// Все проверки пройдены — информируем пользователя<br />
showSuccessMessage(messages.success, socketId)<br />
} catch (err) {<br />
// При любой ошибке — показываем её в модальном окне<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка заполненности атрибутов записи ЛЖ. <code>check-record-fields-filled</code> ==<br />
[[Файл:Check-record-fields-filled.png|frame]]<br />
Проверяет заполненность заданных полей в записи журнала (например, "Источник", "Место отбора", "Дата регистрации" и др.). Если какое-либо из обязательных полей не заполнено, выдаётся соответствующая ошибка.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { DialogType } from "@triteia/types-integration-gui"<br />
import { IJournalRecordManager } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
<br />
const config = {<br />
requiredFields: [<br />
'Источник',<br />
'Список. Целое число',<br />
'Строка',<br />
'Целое число',<br />
'Вещественное число',<br />
'Логический тип',<br />
'Дата',<br />
'Время',<br />
],<br />
journalRecordId: 144, // Мк / Тест_Ушакова<br />
integrationResult: { message: 'Все поля заполнены!' }<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: 'Все необходимые поля заполнены!',<br />
emptyFieldsError: (fields, recordId) => `Поля ${fields.map(f => `"${f}"`).join(', ')} не заполнены в записи с ID ${recordId}`,<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
fieldsError: (emptyFields, recordId) => {<br />
throw new Error(messages.emptyFieldsError(emptyFields, recordId))<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const isEmptyArray = (arr: unknown[]) => {<br />
return arr.length === 0<br />
}<br />
<br />
const getNotFilledFields = (fields: string[], journalRecordsManager: IJournalRecordManager) => {<br />
console.log(journalRecordsManager.data.attributes, 'data.attributes')<br />
return fields.filter(f => !journalRecordsManager.getFieldValue(f))<br />
}<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
const emptyFields = getNotFilledFields(config.requiredFields, journalRecordManager)<br />
<br />
if (isEmptyArray(emptyFields)) {<br />
showSuccessMessage(messages.success, socketId)<br />
return config.integrationResult<br />
} else errorHandlers.fieldsError(emptyFields, config.journalRecordId)<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка движения пробы. <code>check-sample-moving</code> ==<br />
[[Файл:Check-sample-moving.png|frame]]<br />
Проверяет маршрут движения пробы по этапам. Получает историю перемещений записи и определяет, происходило ли движение (нахождение более чем на одном этапе). Отображает маршрут или сообщает, что движение не происходило.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { JournalsRecordRouteController } from "../../src/servivces/worker/api/controllers/journals-record-route"<br />
import { apiInstance } from "../../src/servivces/worker/api/interactors/ApiInstance"<br />
import type { DialogType } from "@triteia/types-integration-gui"<br />
import type { JournalRecordRouteDto } from "../../src/servivces/worker/api/controllers/journal-records"<br />
<br />
// Конфигурация аддона:<br />
// - journalRecordId: 114 — запись из журнала "Лаб. воздуха / Анализы завершены"<br />
// Аддон анализирует маршрут движения пробы по этапам ЛЖ<br />
const config = {<br />
journalRecordId: 114<br />
}<br />
<br />
// Сообщения для отображения пользователю<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
// Формирует строку с маршрутом пробы: этапы через " -> "<br />
route: (routes: JournalRecordRouteDto[], recordId: number) => <br />
`Маршрут пробы: ${routes.map(r => `"${r.stageName}"`).join(' -> ')}. Id записи ЛЖ: ${recordId}`,<br />
// Сообщение, если проба не перемещалась между этапами<br />
notMoved: (recordId: number) => <br />
`Движение пробы не происходило. Id записи ЛЖ: ${recordId}`<br />
}<br />
<br />
// Обработчики ошибок — централизованно выбрасывают исключения с понятными сообщениями<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
// Формирует конфиг диалога для GUI: тип (confirm), заголовок и текст<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
// Извлекает socketId из параметров запроса — необходим для отправки ответа в интерфейс<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
// Показывает пользователю модальное окно с ошибкой<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
// Показывает информационное сообщение (успех или статус)<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
// Определяет, перемещалась ли проба: если более одного этапа — значит, было движение<br />
const isSampleMoved = (moves: JournalRecordRouteDto[]) => {<br />
return Array.isArray(moves) && moves.length > 1<br />
}<br />
<br />
/**<br />
* Основная функция аддона:<br />
* Получает маршрут пробы по этапам лабораторного журнала и отображает его пользователю.<br />
* <br />
* Логика:<br />
* 1. Проверяет наличие параметров и подключение клиента (socketId).<br />
* 2. Запрашивает историю перемещений пробы через API.<br />
* 3. Если проба прошла более одного этапа — отображает маршрут.<br />
* 4. Если осталась на одном этапе — сообщает, что движения не было.<br />
*/<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
// Контроллер для работы с маршрутом записи (история этапов)<br />
const journalsRecordRouteController = new JournalsRecordRouteController(apiInstance)<br />
// Получаем список этапов, через которые прошла проба<br />
const sampleMoves = await journalsRecordRouteController.getJournalRecordRoute(config.journalRecordId)<br />
<br />
if (isSampleMoved(sampleMoves)) {<br />
// Проба перемещалась — показываем полный маршрут<br />
showSuccessMessage(messages.route(sampleMoves, config.journalRecordId), socketId)<br />
} else {<br />
// Проба не покидала исходный этап<br />
showSuccessMessage(messages.notMoved(config.journalRecordId), socketId)<br />
}<br />
} catch (err) {<br />
// При любой ошибке (сеть, доступ, данные) — показываем её пользователю<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка прав пользователя. <code>check-user-rights</code> ==<br />
[[Файл:Check-user-rights.png|frame]]<br />
Проверяет права доступа пользователя к определённым ресурсам (объекты анализа, методики, записи ЛЖ). Отображает таблицу с типами доступа (чтение, запись и т.д.) и наличием прав по каждому ресурсу.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { apiInstance } from "../../src/servivces/worker/api/interactors/ApiInstance"<br />
import { <br />
PermissionController, <br />
PermissionResource, <br />
PermissionRwAccess<br />
} from "../../src/servivces/worker/api/controllers/permisson"<br />
<br />
import { TableBuilder } from "../../src/gui/builder"<br />
import type { DialogType, TableConfig } from "@triteia/types-integration-gui"<br />
import type { JournalRecordRouteDto } from "../../src/servivces/worker/api/controllers/journal-records"<br />
<br />
// Отображение типов доступа в понятные пользователю названия<br />
const accessNamesMap = {<br />
[PermissionRwAccess.EXEC]: 'Выполнение',<br />
[PermissionRwAccess.READ]: 'Чтение',<br />
[PermissionRwAccess.WRITE]: 'Запись',<br />
}<br />
<br />
// Список ресурсов, права на которые необходимо проверить<br />
const requiredResources = [<br />
PermissionResource.ANALYSIS_OBJECT, <br />
PermissionResource.METHODOLOGY,<br />
PermissionResource.JOURNAL_RECORD<br />
]<br />
<br />
// Отображение идентификаторов ресурсов в читаемые названия для отображения в таблице<br />
const resourcesNamesMap = {<br />
[PermissionResource.ANALYSIS_OBJECT]: 'Объекты анализа', <br />
[PermissionResource.METHODOLOGY]: 'Методики', <br />
[PermissionResource.JOURNAL_RECORD]: 'Записи ЛЖ'<br />
}<br />
<br />
/**<br />
* Формирует конфигурацию таблицы с правами доступа:<br />
* - Для каждого ресурса проверяются все типы доступа (чтение, запись, выполнение).<br />
* - Возвращает готовую конфигурацию таблицы для отображения в GUI.<br />
*/<br />
const getAccessRightsTable = async (tableBuilder: TableBuilder, permissionController: PermissionController): Promise<TableConfig> => {<br />
// Получаем список строк: комбинация "ресурс + тип доступа + наличие права"<br />
const rows = (await Promise.all(requiredResources.map(async (source: PermissionResource) => {<br />
const sourceCombinations = await Promise.all(Object.keys(PermissionRwAccess).map(async (action) => {<br />
const access = await permissionController.getSourcePermission(source, PermissionRwAccess[action])<br />
return { <br />
source: resourcesNamesMap[source], <br />
action: accessNamesMap[PermissionRwAccess[action]], <br />
access: access.hasPermission <br />
}<br />
}))<br />
return sourceCombinations<br />
} <br />
))).flat()<br />
<br />
// Строим таблицу с помощью TableBuilder<br />
const table = tableBuilder<br />
.name('simpleTable')<br />
.label('Таблица')<br />
.isAddable(false) // Нельзя добавлять строки<br />
.actionsCol(false) // Скрыть колонку действий<br />
.addColumn('Ресурс', 'source', false)<br />
.config('input', { name: 'source', rules: [{ required: true }] }, { placeholder: '', disabled: false })<br />
.next()<br />
.addColumn('Тип доступа', 'action', false)<br />
.config('input', { name: 'action' }, { type: 'string', placeholder: '', disabled: false })<br />
.next()<br />
.addColumn('Доступ', 'access', false)<br />
.config('checkbox', { name: 'access' }, { type: 'boolean', placeholder: '', disabled: true }) // Только для просмотра<br />
.next()<br />
.setRows(rows)<br />
.build();<br />
<br />
return table<br />
}<br />
<br />
// Сообщения для пользователя<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
}<br />
<br />
// Обработчики ошибок — централизованно выбрасывают исключения<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
// Формирует конфиг диалога для отправки в GUI<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
// Извлекает socketId из параметров — необходим для обратной связи с интерфейсом<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
return socketId<br />
}<br />
<br />
// Показывает пользователю сообщение об ошибке<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
<br />
// Показывает таблицу с правами доступа в модальном окне<br />
const showTable = async (builder: TableBuilder, controller: PermissionController, socketId: string) => <br />
await getDataFromDialog({ type: 'input-data', config: [await getAccessRightsTable(builder, controller)] }, socketId)<br />
<br />
/**<br />
* Основная функция аддона:<br />
* Отображает пользователю таблицу с текущими правами доступа на ключевые ресурсы системы.<br />
* <br />
* Логика:<br />
* 1. Проверяет наличие параметров и активное соединение (socketId).<br />
* 2. Запрашивает права для каждого ресурса и типа доступа.<br />
* 3. Формирует таблицу через TableBuilder.<br />
* 4. Показывает её в модальном окне.<br />
* <br />
* Результат: пользователь видит, какие действия разрешены для "Объектов анализа", "Методик" и "Записей ЛЖ".<br />
*/<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
// Создаём экземпляры билдера и контроллера прав доступа<br />
await showTable(new TableBuilder(), new PermissionController(apiInstance), socketId)<br />
} catch (err) {<br />
// При любой ошибке — показываем её в модальном окне<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Заполнение атрибутов записи ЛЖ. <code>fill-record-fields</code> ==<br />
[[Файл:Fill-record-fields.png|frame]]<br />
Автоматически заполняет заданные поля в записи журнала (например, даты, место отбора, шифр пробы и др.). Есть возможность использования ключевых слов для сопоставления полей, если точные названия не совпадают.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { DialogType } from "@triteia/types-integration-gui"<br />
import { IJournalRecordManager } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
import { JournalRecordAttributeFieldResponse } from "../../src/servivces/worker/api/controllers/lj-eav-attribute-fields"<br />
import { FieldMatch } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
<br />
const date = new Date().toISOString().split('T')[0]<br />
const config = {<br />
requiredFields: [<br />
{ name: 'Дата регистрации', value: date, keywords: ['дат', 'регистр'] },<br />
{ name: 'Место отбора', value: 'Скважина 516563Г ', keywords: ['мест', 'отбор'] },<br />
{ name: 'Дата отбора', value: date, keywords: ['дат', 'отбор'] },<br />
{ name: 'Шифр пробы', value: 'shifr 123', keywords: ['дат', 'регистр']},<br />
{ name: 'Список. Целое число', value: 666, keywords: ['спис', 'цел', 'числ'] },<br />
{ name: 'Помещение', value: 'помещение', keywords: ['помещ']},<br />
] as FieldMatch[],<br />
journalRecordId: 118, // Мк / 111<br />
integrationResult: { message: 'Все поля заполнены!' }<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: (recordId) => `Все необходимые поля заполнены! Id записи: ${recordId}`,<br />
emptyFieldsError: (fields, recordId) => `Поля ${fields.map(f => `"${f}"`).join(', ')} не заполнены в записи с ID ${recordId}`,<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const fieldsMatcher = (field: JournalRecordAttributeFieldResponse, searchField: FieldMatch) => {<br />
return searchField.keywords.every(k => String(field.name).toLocaleLowerCase().includes(k.toLocaleLowerCase()))<br />
}<br />
<br />
const fillFields = async (fields: FieldMatch[], journalRecordsManager: IJournalRecordManager) => {<br />
await journalRecordsManager.setFieldsValues(fields, journalRecordsManager, fieldsMatcher)<br />
}<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
await fillFields(config.requiredFields, journalRecordManager)<br />
showSuccessMessage(messages.success(journalRecordManager.journalRecordId), socketId)<br />
return config.integrationResult<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Деление данных. <code>copy-journal-record</code> ==<br />
[[Файл:Copy-journal-record.png|frame]]<br />
Создаёт копию записи журнала на заданном этапе маршрута. Выводит сообщение с ID новой записи.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { JournalRecordsController } from "../../src/servivces/worker/api/controllers/journal-records"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { apiInstance } from "../../src/servivces/worker/api/interactors/ApiInstance"<br />
import type { DialogType } from "@triteia/types-integration-gui"<br />
import type { JournalRecordRequest, JournalRecordResponse } from "../../src/servivces/worker/api/controllers/journal-records"<br />
import type { JournalRecordAttributeResponse } from "../../src/servivces/worker/api/controllers/journal-records"<br />
<br />
type DataType = JournalRecordAttributeResponse['field']['dataType']<br />
<br />
const config = {<br />
journalRecordId: 208, // Лаб. воздуха / Регистрация<br />
nextJournalRecordStage: 2, // Лаб. воздуха / Анализ<br />
nextStageName: 'Анализ',<br />
nextRouteId: 50,<br />
integrationResult: { message: 'Запись ЛЖ скопирована успешно!' }<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: 'Все необходимые поля заполнены!',<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const getDateString = (ISODate: unknown | null = null) => {<br />
return new Date(String(ISODate)).toISOString().split('T')[0]<br />
}<br />
<br />
const getTimeString = (ISODate: unknown | null = null) => {<br />
return new Date(String(ISODate)).toISOString().split('T')[1].split('.')[0]<br />
}<br />
<br />
const createRecord = async (journalRecordController: JournalRecordsController, baseRecord: JournalRecordResponse, newStageId) => {<br />
const getAttrValue = (value: unknown, dataType: DataType) => {<br />
if (dataType === "DATE") return getDateString(value)<br />
if (dataType === "TIME") return getTimeString(value)<br />
return value<br />
}<br />
<br />
const getBindings = (baseRecord: JournalRecordResponse): number[] | null => {<br />
return baseRecord?.companyLevelBindings?.map(b => b?.id) || null<br />
} <br />
<br />
const getRecordRequest = (baseRecord: JournalRecordResponse, newStageId: number): JournalRecordRequest => {<br />
return {<br />
routeId: baseRecord?.route?.id,<br />
stageId: newStageId,<br />
analysisObjectId: baseRecord?.analysisObject?.id,<br />
sampleTypeId: baseRecord.sampleType.id,<br />
attributes: baseRecord.attributes.map(attr => {<br />
return {<br />
fieldId: attr.field.id,<br />
stageId: newStageId,<br />
data: {<br />
...attr.data, <br />
value: getAttrValue(attr?.data?.value, attr?.field?.dataType),<br />
id: undefined<br />
},<br />
statusId: null<br />
}<br />
}),<br />
companyLevelBindings: getBindings(baseRecord)<br />
}<br />
}<br />
return await journalRecordController.createRecord(getRecordRequest(baseRecord, newStageId))<br />
}<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
const journalRecordController = new JournalRecordsController(apiInstance)<br />
const newRecord = await createRecord(journalRecordController, journalRecordManager.data, config.nextJournalRecordStage)<br />
showSuccessMessage(`${messages.success}. Id изначальной записи: ${config.journalRecordId}. Id новой записи ЛЖ: ${newRecord.id}. Этап: ${config.nextStageName}`, socketId)<br />
return config.integrationResult<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
</div><br />
</div></div>
Arhidiman
https://wiki.chemsoft.ru/index.php?title=%D0%90%D0%B4%D0%B4%D0%BE%D0%BD%D1%8B&diff=2379
Аддоны
2026-04-03T06:29:12Z
<p>Arhidiman: /* Проверка движения пробы. check-sample-moving */</p>
<hr />
<div>Список демонстрационных аддонов, показывающих возможности интеграционного сервиса.<br />
<br />
== Проверка даты регистрации. <code>check-registration-date</code> ==<br />
[[Файл:check-registration-date.png|frame]]<br />
Проверяет, не истёк ли срок регистрации пробы. Сравнивает дату регистрации из указанного поля с текущей датой. Если прошло более заданного количества дней (по умолчанию — 10), выдаёт ошибку. В противном случае показывает сообщение об успешной проверке.<br />
<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { MessageBoxResults } from "@triteia/types-integration-gui"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { DialogType } from "@triteia/types-integration-gui"<br />
import type { FetchApiClient } from "../../src/servivces/worker/api/ApiClient"<br />
import { apiInstance } from "../../src/servivces/worker/api/interactors/ApiInstance"<br />
<br />
// Конфигурация аддона:<br />
// - Поле "Дата регистрации" — контрольная точка для расчёта срока<br />
// - expirationLimit: 10 дней — максимальный допустимый срок хранения пробы<br />
// - journalRecordId: 201 — запись из журнала "Лаб. воздуха / Анализы завершены"<br />
const config = {<br />
dateField: 'Дата регистрации',<br />
expirationLimit: 10,<br />
journalRecordId: 201,<br />
integrationResult: { message: 'Срок регистрации пробы не истёк!' }<br />
}<br />
<br />
// Сообщения для пользовательских уведомлений и ошибок<br />
const messages = {<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
// Успех: информирует пользователя, что срок не вышел<br />
success: (recordId) => `Срок регистрации пробы не истёк! Id записи ${recordId}`,<br />
// Ошибка: превышен лимит хранения<br />
expired: (limit, recordId) => `Срок регистрации пробы истёк!\nПрошло более ${limit} дней с момента регистрации. Id записи: ${recordId}`,<br />
// Ошибка: отсутствует дата в нужном поле<br />
dateField: (dateField, stageName, journalRecordId) => [<br />
`Не заполнено либо отсутствует поле "${dateField}"`,<br />
`в этапе "${stageName || ''}".\nId записи: ${journalRecordId}`<br />
].join(' ')<br />
}<br />
<br />
// Централизованные обработчики ошибок — обеспечивают единообразие и чистоту основной логики<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
},<br />
// Вызывается, если поле с датой не заполнено<br />
dateError: (dateField, stageName, journalRecordId) => {<br />
throw new Error(messages.dateField(dateField, stageName, journalRecordId))<br />
},<br />
// Вызывается при превышении срока хранения<br />
expirationError: () => {<br />
throw new Error(messages.expired(config.expirationLimit, config.journalRecordId))<br />
}<br />
}<br />
<br />
// Извлекает socketId из queryParams — необходим для отправки диалогов в GUI<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
// Переводит дату в количество дней с начала эпохи (для арифметики дат)<br />
const getDaysByDate = (date: Date) => {<br />
const dayMs = 60 * 60 * 24 * 1000<br />
const timestamp = date.getTime()<br />
return timestamp / dayMs<br />
}<br />
<br />
// Формирует конфиг диалога: тип, заголовок и сообщение для отображения в GUI<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
// Рассчитывает, сколько дней прошло с момента регистрации пробы<br />
const getExpirationOffset = (registrationDate: string) => {<br />
const regDate = new Date(registrationDate)<br />
const today = new Date()<br />
return getDaysByDate(today) - getDaysByDate(regDate)<br />
}<br />
<br />
// Показывает пользователю сообщение об ошибке<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
// Показывает пользователю уведомление об успешной проверке<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
/**<br />
* Основная функция аддона:<br />
* Проверяет, не истёк ли срок хранения пробы (с момента "Дата регистрации").<br />
* <br />
* Логика:<br />
* 1. Получает значение поля "Дата регистрации" из записи журнала.<br />
* 2. Если дата не указана — ошибка.<br />
* 3. Если с даты регистрации прошло >= 10 дней — ошибка.<br />
* 4. Иначе — успех, показываем подтверждение.<br />
*/<br />
async function main({ queryParams, ...apiInstance }) {<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
// Получаем доступ к данным записи журнала<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
// Извлекаем значение поля "Дата регистрации"<br />
const date = journalRecordManager.getFieldValue(config.dateField)<br />
<br />
// Если дата не заполнена — прерываем с пояснением<br />
if (!date) {<br />
errorHandlers.dateError(config.dateField, journalRecordManager?.data?.stage?.stage?.name, config.journalRecordId)<br />
}<br />
<br />
// Считаем, сколько дней прошло с регистрации<br />
const expirationOffset = getExpirationOffset(date as string)<br />
<br />
// Если срок хранения превышен — ошибка<br />
if (expirationOffset >= config.expirationLimit) {<br />
errorHandlers.expirationError()<br />
}<br />
<br />
// Всё в порядке — информируем пользователя<br />
await showSuccessMessage(messages.success(config.journalRecordId), socketId)<br />
<br />
return config.integrationResult<br />
} catch (err) {<br />
// При любой ошибке — показываем её в модальном окне<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка заполненности полей показателей. <code>check-indicator-fields-filled</code> ==<br />
[[Файл:Check-indicator-fields-filled.png|frame]]<br />
Проверяет заполненность полей показателей в записи журнала по настраиваемому списку. Проверяет наличие определённых показателей (например, "Аммоний-ион") и заполненность у них таких полей, как исполнители, методики, средний результат и др. Выдаёт ошибку, если показатели отсутствуют или не все поля заполнены.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import type { DialogType } from "@triteia/types-integration-gui"<br />
import type { JournalRecordIndicatorResponse } from "../../src/servivces/worker/api/controllers/journal-records"<br />
import type { IJournalRecordManager } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
<br />
// Описание свойств показателя (индикатора), которые нужно проверить<br />
// Каждое свойство имеет метку (для отображения пользователю) и геттер значения<br />
type IndicatorProp = { label: string, get: () => unknown }<br />
type IndicatorPropsConfig = Record<string, IndicatorProp><br />
<br />
// Конфигурация полей, которые проверяются у каждого показателя<br />
// Например: "Исполнители", "Методики", "Средний результат" и т.д.<br />
const indicatorPropsConfig = (indicator): IndicatorPropsConfig => {<br />
return {<br />
executors: {<br />
label: 'Исполнители', <br />
get: () => indicator?.result?.executors<br />
},<br />
methodic: {<br />
label: 'Методики', <br />
get: () => indicator?.methodics<br />
},<br />
averageResult: {<br />
label: 'Средний результат', <br />
get: () => indicator?.result?.averageValue<br />
},<br />
averageRoundedValue: {<br />
label: 'Средний округлённый результат', <br />
get: () => indicator?.result?.averageRoundedValue<br />
}<br />
}<br />
}<br />
<br />
// Конфигурация аддона:<br />
// - indicatorsList: список обязательных показателей (например, "Аммоний-ион")<br />
// - journalRecordId: 144 — тестовая запись ("Мк / Тест_Ушакова")<br />
const config = {<br />
indicatorsList: [<br />
'Аммоний-ион'<br />
],<br />
journalRecordId: 144,<br />
integrationResult: { message: 'Все поля заполнены!' }<br />
}<br />
<br />
// Сообщения для пользовательских уведомлений и ошибок<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: 'Все необходимые поля заполнены!',<br />
emptyIndicators: (recordId) => `в записи с Id ${recordId} отсутствуют показатели`,<br />
emptyFieldsError: (fields, recordId) => `Поля ${fields.map(f => `"${f}"`).join(', ')} не заполнены в записи с ID ${recordId}`,<br />
indicators: (indicators: string[], recordId) => `Показатели ${indicators.map(f => `"${f}"`).join(', ')} отсутствуют в записи с ID ${recordId}`,<br />
// Формирует детализированное сообщение о незаполненных полях внутри показателей<br />
emptyIndicatorsProps: (props: Record<string, string[]>, recordId) => {<br />
const propsString = Object.keys(props).map(prop => !isEmptyArray(props[prop]) ? `${prop}: ${props[prop].map(p => `"${p}"`).join(', ')}` : '').join('; ')<br />
return `В записи с Id ${recordId} отсутствуют либо не заполнены следующие поля у показателей: ${propsString}`<br />
}<br />
}<br />
<br />
// Централизованные обработчики ошибок — обеспечивают единообразие и чистоту основной логики<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
fieldsError: (emptyFields, recordId) => {<br />
throw new Error(messages.emptyFieldsError(emptyFields, recordId))<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
},<br />
indicatorsError: (recordId) => {<br />
throw new Error(messages.emptyIndicators(recordId))<br />
},<br />
notFoundIndicators: (indicators: string[], recordId: number) => {<br />
throw new Error(messages.indicators(indicators, recordId))<br />
},<br />
notFilledIndicatorProps: (props: Record<string, string[]>) => {<br />
throw new Error(messages.emptyIndicatorsProps(props, config.journalRecordId))<br />
}<br />
}<br />
<br />
// Формирует конфиг диалога для отправки в GUI: тип, заголовок и сообщение<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
// Извлекает socketId из queryParams — необходим для связи с интерфейсом<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
// Показывает пользователю модальное окно с ошибкой<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
// Показывает уведомление об успешной проверке<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
// Универсальная проверка: является ли массив пустым (с учётом типа)<br />
const isEmptyArray = (arr: unknown[]) => {<br />
return Array.isArray(arr) && arr.length === 0<br />
}<br />
<br />
// Проверяет, есть ли у записи хотя бы один показатель<br />
const hasIndicators = (journalRecordManager: IJournalRecordManager) => {<br />
const indicators = journalRecordManager?.data?.indicators<br />
return Array.isArray(indicators) && indicators.length > 0<br />
}<br />
<br />
// Определяет, какие из требуемых показателей отсутствуют в записи<br />
const getNotFoundIndicators = (indicators: JournalRecordIndicatorResponse[], indicatorsList = config.indicatorsList) => {<br />
return indicatorsList.filter(ind => <br />
indicators.every(ljInd => ljInd?.indicator?.name?.toLowerCase() !== ind.toLowerCase())<br />
)<br />
} <br />
<br />
// Собирает список незаполненных полей для каждого показателя<br />
// Возвращает объект: { "Аммоний-ион": ["Исполнители", "Средний результат"] }<br />
const getNotFilledResultsFields = (indicators: JournalRecordIndicatorResponse[]): Record<string, string[]> => {<br />
return indicators.reduce((acc, indicator) => {<br />
const config = indicatorPropsConfig(indicator)<br />
return {<br />
...acc,<br />
[indicator?.indicator?.name]: Object.keys(config).reduce((acc, prop) => {<br />
if (!config[prop].get()) return [...acc, config[prop].label]<br />
return acc<br />
}, [] as string[])<br />
}<br />
}, {}) as Record<string, string[]><br />
}<br />
<br />
// Проверяет, есть ли хотя бы один показатель с незаполненными полями<br />
const hasNotFilledProps = (indicatorsProps: Record<string, string[]>) => {<br />
return Object.keys(indicatorsProps).some(indicator => !isEmptyArray(indicatorsProps[indicator]))<br />
}<br />
<br />
// Проверяет, есть ли отсутствующие показатели в списке<br />
const hasNotFoundIndicators = (indicators: string[]) => !isEmptyArray(indicators)<br />
<br />
/**<br />
* Основная функция аддона:<br />
* Проверяет заполненность:<br />
* 1. Наличие указанных показателей (например, "Аммоний-ион").<br />
* 2. Заполненность внутренних полей каждого показателя (исполнители, методики и т.д.).<br />
* <br />
* При обнаружении проблем — прерывает выполнение и показывает детализированную ошибку.<br />
*/<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
<br />
// Проверка: есть ли вообще показатели в записи?<br />
if (!hasIndicators(journalRecordManager)) {<br />
errorHandlers.indicatorsError(journalRecordManager.journalRecordId)<br />
}<br />
<br />
const indicators = journalRecordManager?.data?.indicators<br />
<br />
// Проверка: все ли требуемые показатели присутствуют?<br />
const notFoundIndicators = getNotFoundIndicators(indicators)<br />
if (hasNotFoundIndicators(notFoundIndicators)) { <br />
errorHandlers.notFoundIndicators(notFoundIndicators, journalRecordManager.journalRecordId)<br />
}<br />
<br />
// Проверка: все ли поля у показателей заполнены?<br />
const emptyIndicatorProps = getNotFilledResultsFields(indicators)<br />
if (hasNotFilledProps(emptyIndicatorProps)) {<br />
errorHandlers.notFilledIndicatorProps(emptyIndicatorProps)<br />
}<br />
<br />
// Все проверки пройдены — информируем пользователя<br />
showSuccessMessage(messages.success, socketId)<br />
} catch (err) {<br />
// При любой ошибке — показываем её в модальном окне<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка заполненности атрибутов записи ЛЖ. <code>check-record-fields-filled</code> ==<br />
[[Файл:Check-record-fields-filled.png|frame]]<br />
Проверяет заполненность заданных полей в записи журнала (например, "Источник", "Место отбора", "Дата регистрации" и др.). Если какое-либо из обязательных полей не заполнено, выдаётся соответствующая ошибка.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { DialogType } from "@triteia/types-integration-gui"<br />
import { IJournalRecordManager } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
<br />
const config = {<br />
requiredFields: [<br />
'Источник',<br />
'Список. Целое число',<br />
'Строка',<br />
'Целое число',<br />
'Вещественное число',<br />
'Логический тип',<br />
'Дата',<br />
'Время',<br />
],<br />
journalRecordId: 144, // Мк / Тест_Ушакова<br />
integrationResult: { message: 'Все поля заполнены!' }<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: 'Все необходимые поля заполнены!',<br />
emptyFieldsError: (fields, recordId) => `Поля ${fields.map(f => `"${f}"`).join(', ')} не заполнены в записи с ID ${recordId}`,<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
fieldsError: (emptyFields, recordId) => {<br />
throw new Error(messages.emptyFieldsError(emptyFields, recordId))<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const isEmptyArray = (arr: unknown[]) => {<br />
return arr.length === 0<br />
}<br />
<br />
const getNotFilledFields = (fields: string[], journalRecordsManager: IJournalRecordManager) => {<br />
console.log(journalRecordsManager.data.attributes, 'data.attributes')<br />
return fields.filter(f => !journalRecordsManager.getFieldValue(f))<br />
}<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
const emptyFields = getNotFilledFields(config.requiredFields, journalRecordManager)<br />
<br />
if (isEmptyArray(emptyFields)) {<br />
showSuccessMessage(messages.success, socketId)<br />
return config.integrationResult<br />
} else errorHandlers.fieldsError(emptyFields, config.journalRecordId)<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка движения пробы. <code>check-sample-moving</code> ==<br />
[[Файл:Check-sample-moving.png|frame]]<br />
Проверяет маршрут движения пробы по этапам. Получает историю перемещений записи и определяет, происходило ли движение (нахождение более чем на одном этапе). Отображает маршрут или сообщает, что движение не происходило.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { JournalsRecordRouteController } from "../../src/servivces/worker/api/controllers/journals-record-route"<br />
import { apiInstance } from "../../src/servivces/worker/api/interactors/ApiInstance"<br />
import type { DialogType } from "@triteia/types-integration-gui"<br />
import type { JournalRecordRouteDto } from "../../src/servivces/worker/api/controllers/journal-records"<br />
<br />
// Конфигурация аддона:<br />
// - journalRecordId: 114 — запись из журнала "Лаб. воздуха / Анализы завершены"<br />
// Аддон анализирует маршрут движения пробы по этапам ЛЖ<br />
const config = {<br />
journalRecordId: 114<br />
}<br />
<br />
// Сообщения для отображения пользователю<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
// Формирует строку с маршрутом пробы: этапы через " -> "<br />
route: (routes: JournalRecordRouteDto[], recordId: number) => <br />
`Маршрут пробы: ${routes.map(r => `"${r.stageName}"`).join(' -> ')}. Id записи ЛЖ: ${recordId}`,<br />
// Сообщение, если проба не перемещалась между этапами<br />
notMoved: (recordId: number) => <br />
`Движение пробы не происходило. Id записи ЛЖ: ${recordId}`<br />
}<br />
<br />
// Обработчики ошибок — централизованно выбрасывают исключения с понятными сообщениями<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
// Формирует конфиг диалога для GUI: тип (confirm), заголовок и текст<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
// Извлекает socketId из параметров запроса — необходим для отправки ответа в интерфейс<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
// Показывает пользователю модальное окно с ошибкой<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
// Показывает информационное сообщение (успех или статус)<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
// Определяет, перемещалась ли проба: если более одного этапа — значит, было движение<br />
const isSampleMoved = (moves: JournalRecordRouteDto[]) => {<br />
return Array.isArray(moves) && moves.length > 1<br />
}<br />
<br />
/**<br />
* Основная функция аддона:<br />
* Получает маршрут пробы по этапам лабораторного журнала и отображает его пользователю.<br />
* <br />
* Логика:<br />
* 1. Проверяет наличие параметров и подключение клиента (socketId).<br />
* 2. Запрашивает историю перемещений пробы через API.<br />
* 3. Если проба прошла более одного этапа — отображает маршрут.<br />
* 4. Если осталась на одном этапе — сообщает, что движения не было.<br />
*/<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
// Контроллер для работы с маршрутом записи (история этапов)<br />
const journalsRecordRouteController = new JournalsRecordRouteController(apiInstance)<br />
// Получаем список этапов, через которые прошла проба<br />
const sampleMoves = await journalsRecordRouteController.getJournalRecordRoute(config.journalRecordId)<br />
<br />
if (isSampleMoved(sampleMoves)) {<br />
// Проба перемещалась — показываем полный маршрут<br />
showSuccessMessage(messages.route(sampleMoves, config.journalRecordId), socketId)<br />
} else {<br />
// Проба не покидала исходный этап<br />
showSuccessMessage(messages.notMoved(config.journalRecordId), socketId)<br />
}<br />
} catch (err) {<br />
// При любой ошибке (сеть, доступ, данные) — показываем её пользователю<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка прав пользователя. <code>check-user-rights</code> ==<br />
[[Файл:Check-user-rights.png|frame]]<br />
Проверяет права доступа пользователя к определённым ресурсам (объекты анализа, методики, записи ЛЖ). Отображает таблицу с типами доступа (чтение, запись и т.д.) и наличием прав по каждому ресурсу.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { apiInstance } from "../../src/servivces/worker/api/interactors/ApiInstance"<br />
import { <br />
PermissionController, <br />
PermissionResource, <br />
PermissionRwAccess<br />
} from "../../src/servivces/worker/api/controllers/permisson"<br />
<br />
import { TableBuilder } from "../../src/gui/builder"<br />
import type { DialogType, TableConfig } from "@triteia/types-integration-gui"<br />
import type { JournalRecordRouteDto } from "../../src/servivces/worker/api/controllers/journal-records"<br />
<br />
const accessNamesMap = {<br />
[PermissionRwAccess.EXEC]: 'Выполнение',<br />
[PermissionRwAccess.READ]: 'Чтение',<br />
[PermissionRwAccess.WRITE]: 'Запись',<br />
}<br />
<br />
const requiredResources = [<br />
PermissionResource.ANALYSIS_OBJECT, <br />
PermissionResource.METHODOLOGY,<br />
PermissionResource.JOURNAL_RECORD<br />
]<br />
<br />
const resourcesNamesMap = {<br />
[PermissionResource.ANALYSIS_OBJECT]: 'Объекты анализа', <br />
[PermissionResource.METHODOLOGY]: 'Методики', <br />
[PermissionResource.JOURNAL_RECORD]: 'Записи ЛЖ'<br />
}<br />
<br />
const getAccessRightsTable = async (tableBuilder: TableBuilder, permissionController: PermissionController): Promise<TableConfig> => {<br />
const rows = (await Promise.all(requiredResources.map(async (source: PermissionResource) => {<br />
const sourceCombinations = await Promise.all(Object.keys(PermissionRwAccess).map(async (action) => {<br />
const access = await permissionController.getSourcePermission(source, PermissionRwAccess[action])<br />
return { source: resourcesNamesMap[source], action: accessNamesMap[PermissionRwAccess[action]], access: access.hasPermission }<br />
}))<br />
return sourceCombinations<br />
} <br />
))).flat()<br />
const table = tableBuilder<br />
.name('simpleTable')<br />
.label('Таблица')<br />
.isAddable(false)<br />
.actionsCol(false)<br />
.addColumn('Ресурс', 'source', false)<br />
.config('input', { name: 'source', rules: [{ required: true }] }, { placeholder: '', disabled: false })<br />
.next()<br />
.addColumn('Тип доступа', 'action', false)<br />
.config('input', { name: 'action' }, { type: 'string', placeholder: '', disabled: false })<br />
.next()<br />
.addColumn('Доступ', 'access', false)<br />
.config('checkbox', { name: 'access' }, { type: 'boolean', placeholder: '', disabled: false })<br />
.next()<br />
.setRows(rows)<br />
.build();<br />
return table<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
route: (routes: JournalRecordRouteDto[], recordId: number) => `Маршрут пробы: ${routes.map(r => `"${r.stageName}"`).join(' -> ')}. Id записи ЛЖ: ${recordId}`, <br />
notMoved: (recordId: number) => `Движение пробы не происходило. Id записи ЛЖ: ${recordId}`, <br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
<br />
const showTable = async (builder: TableBuilder, controller: PermissionController, socketId: string) => <br />
await getDataFromDialog({ type: 'input-data', config: [await getAccessRightsTable(builder, controller)] }, socketId)<br />
<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
try {<br />
await showTable(new TableBuilder, new PermissionController(apiInstance), socketId)<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Заполнение атрибутов записи ЛЖ. <code>fill-record-fields</code> ==<br />
[[Файл:Fill-record-fields.png|frame]]<br />
Автоматически заполняет заданные поля в записи журнала (например, даты, место отбора, шифр пробы и др.). Есть возможность использования ключевых слов для сопоставления полей, если точные названия не совпадают.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { DialogType } from "@triteia/types-integration-gui"<br />
import { IJournalRecordManager } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
import { JournalRecordAttributeFieldResponse } from "../../src/servivces/worker/api/controllers/lj-eav-attribute-fields"<br />
import { FieldMatch } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
<br />
const date = new Date().toISOString().split('T')[0]<br />
const config = {<br />
requiredFields: [<br />
{ name: 'Дата регистрации', value: date, keywords: ['дат', 'регистр'] },<br />
{ name: 'Место отбора', value: 'Скважина 516563Г ', keywords: ['мест', 'отбор'] },<br />
{ name: 'Дата отбора', value: date, keywords: ['дат', 'отбор'] },<br />
{ name: 'Шифр пробы', value: 'shifr 123', keywords: ['дат', 'регистр']},<br />
{ name: 'Список. Целое число', value: 666, keywords: ['спис', 'цел', 'числ'] },<br />
{ name: 'Помещение', value: 'помещение', keywords: ['помещ']},<br />
] as FieldMatch[],<br />
journalRecordId: 118, // Мк / 111<br />
integrationResult: { message: 'Все поля заполнены!' }<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: (recordId) => `Все необходимые поля заполнены! Id записи: ${recordId}`,<br />
emptyFieldsError: (fields, recordId) => `Поля ${fields.map(f => `"${f}"`).join(', ')} не заполнены в записи с ID ${recordId}`,<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const fieldsMatcher = (field: JournalRecordAttributeFieldResponse, searchField: FieldMatch) => {<br />
return searchField.keywords.every(k => String(field.name).toLocaleLowerCase().includes(k.toLocaleLowerCase()))<br />
}<br />
<br />
const fillFields = async (fields: FieldMatch[], journalRecordsManager: IJournalRecordManager) => {<br />
await journalRecordsManager.setFieldsValues(fields, journalRecordsManager, fieldsMatcher)<br />
}<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
await fillFields(config.requiredFields, journalRecordManager)<br />
showSuccessMessage(messages.success(journalRecordManager.journalRecordId), socketId)<br />
return config.integrationResult<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Деление данных. <code>copy-journal-record</code> ==<br />
[[Файл:Copy-journal-record.png|frame]]<br />
Создаёт копию записи журнала на заданном этапе маршрута. Выводит сообщение с ID новой записи.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { JournalRecordsController } from "../../src/servivces/worker/api/controllers/journal-records"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { apiInstance } from "../../src/servivces/worker/api/interactors/ApiInstance"<br />
import type { DialogType } from "@triteia/types-integration-gui"<br />
import type { JournalRecordRequest, JournalRecordResponse } from "../../src/servivces/worker/api/controllers/journal-records"<br />
import type { JournalRecordAttributeResponse } from "../../src/servivces/worker/api/controllers/journal-records"<br />
<br />
type DataType = JournalRecordAttributeResponse['field']['dataType']<br />
<br />
const config = {<br />
journalRecordId: 208, // Лаб. воздуха / Регистрация<br />
nextJournalRecordStage: 2, // Лаб. воздуха / Анализ<br />
nextStageName: 'Анализ',<br />
nextRouteId: 50,<br />
integrationResult: { message: 'Запись ЛЖ скопирована успешно!' }<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: 'Все необходимые поля заполнены!',<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const getDateString = (ISODate: unknown | null = null) => {<br />
return new Date(String(ISODate)).toISOString().split('T')[0]<br />
}<br />
<br />
const getTimeString = (ISODate: unknown | null = null) => {<br />
return new Date(String(ISODate)).toISOString().split('T')[1].split('.')[0]<br />
}<br />
<br />
const createRecord = async (journalRecordController: JournalRecordsController, baseRecord: JournalRecordResponse, newStageId) => {<br />
const getAttrValue = (value: unknown, dataType: DataType) => {<br />
if (dataType === "DATE") return getDateString(value)<br />
if (dataType === "TIME") return getTimeString(value)<br />
return value<br />
}<br />
<br />
const getBindings = (baseRecord: JournalRecordResponse): number[] | null => {<br />
return baseRecord?.companyLevelBindings?.map(b => b?.id) || null<br />
} <br />
<br />
const getRecordRequest = (baseRecord: JournalRecordResponse, newStageId: number): JournalRecordRequest => {<br />
return {<br />
routeId: baseRecord?.route?.id,<br />
stageId: newStageId,<br />
analysisObjectId: baseRecord?.analysisObject?.id,<br />
sampleTypeId: baseRecord.sampleType.id,<br />
attributes: baseRecord.attributes.map(attr => {<br />
return {<br />
fieldId: attr.field.id,<br />
stageId: newStageId,<br />
data: {<br />
...attr.data, <br />
value: getAttrValue(attr?.data?.value, attr?.field?.dataType),<br />
id: undefined<br />
},<br />
statusId: null<br />
}<br />
}),<br />
companyLevelBindings: getBindings(baseRecord)<br />
}<br />
}<br />
return await journalRecordController.createRecord(getRecordRequest(baseRecord, newStageId))<br />
}<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
const journalRecordController = new JournalRecordsController(apiInstance)<br />
const newRecord = await createRecord(journalRecordController, journalRecordManager.data, config.nextJournalRecordStage)<br />
showSuccessMessage(`${messages.success}. Id изначальной записи: ${config.journalRecordId}. Id новой записи ЛЖ: ${newRecord.id}. Этап: ${config.nextStageName}`, socketId)<br />
return config.integrationResult<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
</div><br />
</div></div>
Arhidiman
https://wiki.chemsoft.ru/index.php?title=%D0%90%D0%B4%D0%B4%D0%BE%D0%BD%D1%8B&diff=2378
Аддоны
2026-04-03T06:22:21Z
<p>Arhidiman: /* Проверка заполненности полей показателей. check-indicator-fields-filled */</p>
<hr />
<div>Список демонстрационных аддонов, показывающих возможности интеграционного сервиса.<br />
<br />
== Проверка даты регистрации. <code>check-registration-date</code> ==<br />
[[Файл:check-registration-date.png|frame]]<br />
Проверяет, не истёк ли срок регистрации пробы. Сравнивает дату регистрации из указанного поля с текущей датой. Если прошло более заданного количества дней (по умолчанию — 10), выдаёт ошибку. В противном случае показывает сообщение об успешной проверке.<br />
<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { MessageBoxResults } from "@triteia/types-integration-gui"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { DialogType } from "@triteia/types-integration-gui"<br />
import type { FetchApiClient } from "../../src/servivces/worker/api/ApiClient"<br />
import { apiInstance } from "../../src/servivces/worker/api/interactors/ApiInstance"<br />
<br />
// Конфигурация аддона:<br />
// - Поле "Дата регистрации" — контрольная точка для расчёта срока<br />
// - expirationLimit: 10 дней — максимальный допустимый срок хранения пробы<br />
// - journalRecordId: 201 — запись из журнала "Лаб. воздуха / Анализы завершены"<br />
const config = {<br />
dateField: 'Дата регистрации',<br />
expirationLimit: 10,<br />
journalRecordId: 201,<br />
integrationResult: { message: 'Срок регистрации пробы не истёк!' }<br />
}<br />
<br />
// Сообщения для пользовательских уведомлений и ошибок<br />
const messages = {<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
// Успех: информирует пользователя, что срок не вышел<br />
success: (recordId) => `Срок регистрации пробы не истёк! Id записи ${recordId}`,<br />
// Ошибка: превышен лимит хранения<br />
expired: (limit, recordId) => `Срок регистрации пробы истёк!\nПрошло более ${limit} дней с момента регистрации. Id записи: ${recordId}`,<br />
// Ошибка: отсутствует дата в нужном поле<br />
dateField: (dateField, stageName, journalRecordId) => [<br />
`Не заполнено либо отсутствует поле "${dateField}"`,<br />
`в этапе "${stageName || ''}".\nId записи: ${journalRecordId}`<br />
].join(' ')<br />
}<br />
<br />
// Централизованные обработчики ошибок — обеспечивают единообразие и чистоту основной логики<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
},<br />
// Вызывается, если поле с датой не заполнено<br />
dateError: (dateField, stageName, journalRecordId) => {<br />
throw new Error(messages.dateField(dateField, stageName, journalRecordId))<br />
},<br />
// Вызывается при превышении срока хранения<br />
expirationError: () => {<br />
throw new Error(messages.expired(config.expirationLimit, config.journalRecordId))<br />
}<br />
}<br />
<br />
// Извлекает socketId из queryParams — необходим для отправки диалогов в GUI<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
// Переводит дату в количество дней с начала эпохи (для арифметики дат)<br />
const getDaysByDate = (date: Date) => {<br />
const dayMs = 60 * 60 * 24 * 1000<br />
const timestamp = date.getTime()<br />
return timestamp / dayMs<br />
}<br />
<br />
// Формирует конфиг диалога: тип, заголовок и сообщение для отображения в GUI<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
// Рассчитывает, сколько дней прошло с момента регистрации пробы<br />
const getExpirationOffset = (registrationDate: string) => {<br />
const regDate = new Date(registrationDate)<br />
const today = new Date()<br />
return getDaysByDate(today) - getDaysByDate(regDate)<br />
}<br />
<br />
// Показывает пользователю сообщение об ошибке<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
// Показывает пользователю уведомление об успешной проверке<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
/**<br />
* Основная функция аддона:<br />
* Проверяет, не истёк ли срок хранения пробы (с момента "Дата регистрации").<br />
* <br />
* Логика:<br />
* 1. Получает значение поля "Дата регистрации" из записи журнала.<br />
* 2. Если дата не указана — ошибка.<br />
* 3. Если с даты регистрации прошло >= 10 дней — ошибка.<br />
* 4. Иначе — успех, показываем подтверждение.<br />
*/<br />
async function main({ queryParams, ...apiInstance }) {<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
// Получаем доступ к данным записи журнала<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
// Извлекаем значение поля "Дата регистрации"<br />
const date = journalRecordManager.getFieldValue(config.dateField)<br />
<br />
// Если дата не заполнена — прерываем с пояснением<br />
if (!date) {<br />
errorHandlers.dateError(config.dateField, journalRecordManager?.data?.stage?.stage?.name, config.journalRecordId)<br />
}<br />
<br />
// Считаем, сколько дней прошло с регистрации<br />
const expirationOffset = getExpirationOffset(date as string)<br />
<br />
// Если срок хранения превышен — ошибка<br />
if (expirationOffset >= config.expirationLimit) {<br />
errorHandlers.expirationError()<br />
}<br />
<br />
// Всё в порядке — информируем пользователя<br />
await showSuccessMessage(messages.success(config.journalRecordId), socketId)<br />
<br />
return config.integrationResult<br />
} catch (err) {<br />
// При любой ошибке — показываем её в модальном окне<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка заполненности полей показателей. <code>check-indicator-fields-filled</code> ==<br />
[[Файл:Check-indicator-fields-filled.png|frame]]<br />
Проверяет заполненность полей показателей в записи журнала по настраиваемому списку. Проверяет наличие определённых показателей (например, "Аммоний-ион") и заполненность у них таких полей, как исполнители, методики, средний результат и др. Выдаёт ошибку, если показатели отсутствуют или не все поля заполнены.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import type { DialogType } from "@triteia/types-integration-gui"<br />
import type { JournalRecordIndicatorResponse } from "../../src/servivces/worker/api/controllers/journal-records"<br />
import type { IJournalRecordManager } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
<br />
// Описание свойств показателя (индикатора), которые нужно проверить<br />
// Каждое свойство имеет метку (для отображения пользователю) и геттер значения<br />
type IndicatorProp = { label: string, get: () => unknown }<br />
type IndicatorPropsConfig = Record<string, IndicatorProp><br />
<br />
// Конфигурация полей, которые проверяются у каждого показателя<br />
// Например: "Исполнители", "Методики", "Средний результат" и т.д.<br />
const indicatorPropsConfig = (indicator): IndicatorPropsConfig => {<br />
return {<br />
executors: {<br />
label: 'Исполнители', <br />
get: () => indicator?.result?.executors<br />
},<br />
methodic: {<br />
label: 'Методики', <br />
get: () => indicator?.methodics<br />
},<br />
averageResult: {<br />
label: 'Средний результат', <br />
get: () => indicator?.result?.averageValue<br />
},<br />
averageRoundedValue: {<br />
label: 'Средний округлённый результат', <br />
get: () => indicator?.result?.averageRoundedValue<br />
}<br />
}<br />
}<br />
<br />
// Конфигурация аддона:<br />
// - indicatorsList: список обязательных показателей (например, "Аммоний-ион")<br />
// - journalRecordId: 144 — тестовая запись ("Мк / Тест_Ушакова")<br />
const config = {<br />
indicatorsList: [<br />
'Аммоний-ион'<br />
],<br />
journalRecordId: 144,<br />
integrationResult: { message: 'Все поля заполнены!' }<br />
}<br />
<br />
// Сообщения для пользовательских уведомлений и ошибок<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: 'Все необходимые поля заполнены!',<br />
emptyIndicators: (recordId) => `в записи с Id ${recordId} отсутствуют показатели`,<br />
emptyFieldsError: (fields, recordId) => `Поля ${fields.map(f => `"${f}"`).join(', ')} не заполнены в записи с ID ${recordId}`,<br />
indicators: (indicators: string[], recordId) => `Показатели ${indicators.map(f => `"${f}"`).join(', ')} отсутствуют в записи с ID ${recordId}`,<br />
// Формирует детализированное сообщение о незаполненных полях внутри показателей<br />
emptyIndicatorsProps: (props: Record<string, string[]>, recordId) => {<br />
const propsString = Object.keys(props).map(prop => !isEmptyArray(props[prop]) ? `${prop}: ${props[prop].map(p => `"${p}"`).join(', ')}` : '').join('; ')<br />
return `В записи с Id ${recordId} отсутствуют либо не заполнены следующие поля у показателей: ${propsString}`<br />
}<br />
}<br />
<br />
// Централизованные обработчики ошибок — обеспечивают единообразие и чистоту основной логики<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
fieldsError: (emptyFields, recordId) => {<br />
throw new Error(messages.emptyFieldsError(emptyFields, recordId))<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
},<br />
indicatorsError: (recordId) => {<br />
throw new Error(messages.emptyIndicators(recordId))<br />
},<br />
notFoundIndicators: (indicators: string[], recordId: number) => {<br />
throw new Error(messages.indicators(indicators, recordId))<br />
},<br />
notFilledIndicatorProps: (props: Record<string, string[]>) => {<br />
throw new Error(messages.emptyIndicatorsProps(props, config.journalRecordId))<br />
}<br />
}<br />
<br />
// Формирует конфиг диалога для отправки в GUI: тип, заголовок и сообщение<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
// Извлекает socketId из queryParams — необходим для связи с интерфейсом<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
// Показывает пользователю модальное окно с ошибкой<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
// Показывает уведомление об успешной проверке<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
// Универсальная проверка: является ли массив пустым (с учётом типа)<br />
const isEmptyArray = (arr: unknown[]) => {<br />
return Array.isArray(arr) && arr.length === 0<br />
}<br />
<br />
// Проверяет, есть ли у записи хотя бы один показатель<br />
const hasIndicators = (journalRecordManager: IJournalRecordManager) => {<br />
const indicators = journalRecordManager?.data?.indicators<br />
return Array.isArray(indicators) && indicators.length > 0<br />
}<br />
<br />
// Определяет, какие из требуемых показателей отсутствуют в записи<br />
const getNotFoundIndicators = (indicators: JournalRecordIndicatorResponse[], indicatorsList = config.indicatorsList) => {<br />
return indicatorsList.filter(ind => <br />
indicators.every(ljInd => ljInd?.indicator?.name?.toLowerCase() !== ind.toLowerCase())<br />
)<br />
} <br />
<br />
// Собирает список незаполненных полей для каждого показателя<br />
// Возвращает объект: { "Аммоний-ион": ["Исполнители", "Средний результат"] }<br />
const getNotFilledResultsFields = (indicators: JournalRecordIndicatorResponse[]): Record<string, string[]> => {<br />
return indicators.reduce((acc, indicator) => {<br />
const config = indicatorPropsConfig(indicator)<br />
return {<br />
...acc,<br />
[indicator?.indicator?.name]: Object.keys(config).reduce((acc, prop) => {<br />
if (!config[prop].get()) return [...acc, config[prop].label]<br />
return acc<br />
}, [] as string[])<br />
}<br />
}, {}) as Record<string, string[]><br />
}<br />
<br />
// Проверяет, есть ли хотя бы один показатель с незаполненными полями<br />
const hasNotFilledProps = (indicatorsProps: Record<string, string[]>) => {<br />
return Object.keys(indicatorsProps).some(indicator => !isEmptyArray(indicatorsProps[indicator]))<br />
}<br />
<br />
// Проверяет, есть ли отсутствующие показатели в списке<br />
const hasNotFoundIndicators = (indicators: string[]) => !isEmptyArray(indicators)<br />
<br />
/**<br />
* Основная функция аддона:<br />
* Проверяет заполненность:<br />
* 1. Наличие указанных показателей (например, "Аммоний-ион").<br />
* 2. Заполненность внутренних полей каждого показателя (исполнители, методики и т.д.).<br />
* <br />
* При обнаружении проблем — прерывает выполнение и показывает детализированную ошибку.<br />
*/<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
<br />
// Проверка: есть ли вообще показатели в записи?<br />
if (!hasIndicators(journalRecordManager)) {<br />
errorHandlers.indicatorsError(journalRecordManager.journalRecordId)<br />
}<br />
<br />
const indicators = journalRecordManager?.data?.indicators<br />
<br />
// Проверка: все ли требуемые показатели присутствуют?<br />
const notFoundIndicators = getNotFoundIndicators(indicators)<br />
if (hasNotFoundIndicators(notFoundIndicators)) { <br />
errorHandlers.notFoundIndicators(notFoundIndicators, journalRecordManager.journalRecordId)<br />
}<br />
<br />
// Проверка: все ли поля у показателей заполнены?<br />
const emptyIndicatorProps = getNotFilledResultsFields(indicators)<br />
if (hasNotFilledProps(emptyIndicatorProps)) {<br />
errorHandlers.notFilledIndicatorProps(emptyIndicatorProps)<br />
}<br />
<br />
// Все проверки пройдены — информируем пользователя<br />
showSuccessMessage(messages.success, socketId)<br />
} catch (err) {<br />
// При любой ошибке — показываем её в модальном окне<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка заполненности атрибутов записи ЛЖ. <code>check-record-fields-filled</code> ==<br />
[[Файл:Check-record-fields-filled.png|frame]]<br />
Проверяет заполненность заданных полей в записи журнала (например, "Источник", "Место отбора", "Дата регистрации" и др.). Если какое-либо из обязательных полей не заполнено, выдаётся соответствующая ошибка.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { DialogType } from "@triteia/types-integration-gui"<br />
import { IJournalRecordManager } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
<br />
const config = {<br />
requiredFields: [<br />
'Источник',<br />
'Список. Целое число',<br />
'Строка',<br />
'Целое число',<br />
'Вещественное число',<br />
'Логический тип',<br />
'Дата',<br />
'Время',<br />
],<br />
journalRecordId: 144, // Мк / Тест_Ушакова<br />
integrationResult: { message: 'Все поля заполнены!' }<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: 'Все необходимые поля заполнены!',<br />
emptyFieldsError: (fields, recordId) => `Поля ${fields.map(f => `"${f}"`).join(', ')} не заполнены в записи с ID ${recordId}`,<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
fieldsError: (emptyFields, recordId) => {<br />
throw new Error(messages.emptyFieldsError(emptyFields, recordId))<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const isEmptyArray = (arr: unknown[]) => {<br />
return arr.length === 0<br />
}<br />
<br />
const getNotFilledFields = (fields: string[], journalRecordsManager: IJournalRecordManager) => {<br />
console.log(journalRecordsManager.data.attributes, 'data.attributes')<br />
return fields.filter(f => !journalRecordsManager.getFieldValue(f))<br />
}<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
const emptyFields = getNotFilledFields(config.requiredFields, journalRecordManager)<br />
<br />
if (isEmptyArray(emptyFields)) {<br />
showSuccessMessage(messages.success, socketId)<br />
return config.integrationResult<br />
} else errorHandlers.fieldsError(emptyFields, config.journalRecordId)<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка движения пробы. <code>check-sample-moving</code> ==<br />
[[Файл:Check-sample-moving.png|frame]]<br />
Проверяет маршрут движения пробы по этапам. Получает историю перемещений записи и определяет, происходило ли движение (нахождение более чем на одном этапе). Отображает маршрут или сообщает, что движение не происходило.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { JournalsRecordRouteController } from "../../src/servivces/worker/api/controllers/journals-record-route"<br />
import { apiInstance } from "../../src/servivces/worker/api/interactors/ApiInstance"<br />
import type { DialogType } from "@triteia/types-integration-gui"<br />
import type { JournalRecordRouteDto } from "../../src/servivces/worker/api/controllers/journal-records"<br />
<br />
const config = {<br />
journalRecordId: 114 // Лаб. воздуха / Анализы завершены<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
route: (routes: JournalRecordRouteDto[], recordId: number) => `Машрут пробы: ${routes.map(r => `"${r.stageName}"`).join(' -> ')}. Id записи ЛЖ: ${recordId}`, <br />
notMoved: (recordId: number) => `Движение пробы не происходило. Id записи ЛЖ: ${recordId}`, <br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const isSampleMoved = (moves: JournalRecordRouteDto[]) => {<br />
return Array.isArray(moves) && moves.length > 1<br />
}<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalsRecordRouteController = new JournalsRecordRouteController(apiInstance)<br />
const sampleMoves = await journalsRecordRouteController.getJournalRecordRoute(config.journalRecordId)<br />
<br />
if (isSampleMoved(sampleMoves)) {<br />
showSuccessMessage(messages.route(sampleMoves, config.journalRecordId), socketId)<br />
} else {<br />
showSuccessMessage(messages.notMoved(config.journalRecordId), socketId)<br />
}<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка прав пользователя. <code>check-user-rights</code> ==<br />
[[Файл:Check-user-rights.png|frame]]<br />
Проверяет права доступа пользователя к определённым ресурсам (объекты анализа, методики, записи ЛЖ). Отображает таблицу с типами доступа (чтение, запись и т.д.) и наличием прав по каждому ресурсу.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { apiInstance } from "../../src/servivces/worker/api/interactors/ApiInstance"<br />
import { <br />
PermissionController, <br />
PermissionResource, <br />
PermissionRwAccess<br />
} from "../../src/servivces/worker/api/controllers/permisson"<br />
<br />
import { TableBuilder } from "../../src/gui/builder"<br />
import type { DialogType, TableConfig } from "@triteia/types-integration-gui"<br />
import type { JournalRecordRouteDto } from "../../src/servivces/worker/api/controllers/journal-records"<br />
<br />
const accessNamesMap = {<br />
[PermissionRwAccess.EXEC]: 'Выполнение',<br />
[PermissionRwAccess.READ]: 'Чтение',<br />
[PermissionRwAccess.WRITE]: 'Запись',<br />
}<br />
<br />
const requiredResources = [<br />
PermissionResource.ANALYSIS_OBJECT, <br />
PermissionResource.METHODOLOGY,<br />
PermissionResource.JOURNAL_RECORD<br />
]<br />
<br />
const resourcesNamesMap = {<br />
[PermissionResource.ANALYSIS_OBJECT]: 'Объекты анализа', <br />
[PermissionResource.METHODOLOGY]: 'Методики', <br />
[PermissionResource.JOURNAL_RECORD]: 'Записи ЛЖ'<br />
}<br />
<br />
const getAccessRightsTable = async (tableBuilder: TableBuilder, permissionController: PermissionController): Promise<TableConfig> => {<br />
const rows = (await Promise.all(requiredResources.map(async (source: PermissionResource) => {<br />
const sourceCombinations = await Promise.all(Object.keys(PermissionRwAccess).map(async (action) => {<br />
const access = await permissionController.getSourcePermission(source, PermissionRwAccess[action])<br />
return { source: resourcesNamesMap[source], action: accessNamesMap[PermissionRwAccess[action]], access: access.hasPermission }<br />
}))<br />
return sourceCombinations<br />
} <br />
))).flat()<br />
const table = tableBuilder<br />
.name('simpleTable')<br />
.label('Таблица')<br />
.isAddable(false)<br />
.actionsCol(false)<br />
.addColumn('Ресурс', 'source', false)<br />
.config('input', { name: 'source', rules: [{ required: true }] }, { placeholder: '', disabled: false })<br />
.next()<br />
.addColumn('Тип доступа', 'action', false)<br />
.config('input', { name: 'action' }, { type: 'string', placeholder: '', disabled: false })<br />
.next()<br />
.addColumn('Доступ', 'access', false)<br />
.config('checkbox', { name: 'access' }, { type: 'boolean', placeholder: '', disabled: false })<br />
.next()<br />
.setRows(rows)<br />
.build();<br />
return table<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
route: (routes: JournalRecordRouteDto[], recordId: number) => `Маршрут пробы: ${routes.map(r => `"${r.stageName}"`).join(' -> ')}. Id записи ЛЖ: ${recordId}`, <br />
notMoved: (recordId: number) => `Движение пробы не происходило. Id записи ЛЖ: ${recordId}`, <br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
<br />
const showTable = async (builder: TableBuilder, controller: PermissionController, socketId: string) => <br />
await getDataFromDialog({ type: 'input-data', config: [await getAccessRightsTable(builder, controller)] }, socketId)<br />
<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
try {<br />
await showTable(new TableBuilder, new PermissionController(apiInstance), socketId)<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Заполнение атрибутов записи ЛЖ. <code>fill-record-fields</code> ==<br />
[[Файл:Fill-record-fields.png|frame]]<br />
Автоматически заполняет заданные поля в записи журнала (например, даты, место отбора, шифр пробы и др.). Есть возможность использования ключевых слов для сопоставления полей, если точные названия не совпадают.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { DialogType } from "@triteia/types-integration-gui"<br />
import { IJournalRecordManager } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
import { JournalRecordAttributeFieldResponse } from "../../src/servivces/worker/api/controllers/lj-eav-attribute-fields"<br />
import { FieldMatch } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
<br />
const date = new Date().toISOString().split('T')[0]<br />
const config = {<br />
requiredFields: [<br />
{ name: 'Дата регистрации', value: date, keywords: ['дат', 'регистр'] },<br />
{ name: 'Место отбора', value: 'Скважина 516563Г ', keywords: ['мест', 'отбор'] },<br />
{ name: 'Дата отбора', value: date, keywords: ['дат', 'отбор'] },<br />
{ name: 'Шифр пробы', value: 'shifr 123', keywords: ['дат', 'регистр']},<br />
{ name: 'Список. Целое число', value: 666, keywords: ['спис', 'цел', 'числ'] },<br />
{ name: 'Помещение', value: 'помещение', keywords: ['помещ']},<br />
] as FieldMatch[],<br />
journalRecordId: 118, // Мк / 111<br />
integrationResult: { message: 'Все поля заполнены!' }<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: (recordId) => `Все необходимые поля заполнены! Id записи: ${recordId}`,<br />
emptyFieldsError: (fields, recordId) => `Поля ${fields.map(f => `"${f}"`).join(', ')} не заполнены в записи с ID ${recordId}`,<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const fieldsMatcher = (field: JournalRecordAttributeFieldResponse, searchField: FieldMatch) => {<br />
return searchField.keywords.every(k => String(field.name).toLocaleLowerCase().includes(k.toLocaleLowerCase()))<br />
}<br />
<br />
const fillFields = async (fields: FieldMatch[], journalRecordsManager: IJournalRecordManager) => {<br />
await journalRecordsManager.setFieldsValues(fields, journalRecordsManager, fieldsMatcher)<br />
}<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
await fillFields(config.requiredFields, journalRecordManager)<br />
showSuccessMessage(messages.success(journalRecordManager.journalRecordId), socketId)<br />
return config.integrationResult<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Деление данных. <code>copy-journal-record</code> ==<br />
[[Файл:Copy-journal-record.png|frame]]<br />
Создаёт копию записи журнала на заданном этапе маршрута. Выводит сообщение с ID новой записи.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { JournalRecordsController } from "../../src/servivces/worker/api/controllers/journal-records"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { apiInstance } from "../../src/servivces/worker/api/interactors/ApiInstance"<br />
import type { DialogType } from "@triteia/types-integration-gui"<br />
import type { JournalRecordRequest, JournalRecordResponse } from "../../src/servivces/worker/api/controllers/journal-records"<br />
import type { JournalRecordAttributeResponse } from "../../src/servivces/worker/api/controllers/journal-records"<br />
<br />
type DataType = JournalRecordAttributeResponse['field']['dataType']<br />
<br />
const config = {<br />
journalRecordId: 208, // Лаб. воздуха / Регистрация<br />
nextJournalRecordStage: 2, // Лаб. воздуха / Анализ<br />
nextStageName: 'Анализ',<br />
nextRouteId: 50,<br />
integrationResult: { message: 'Запись ЛЖ скопирована успешно!' }<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: 'Все необходимые поля заполнены!',<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const getDateString = (ISODate: unknown | null = null) => {<br />
return new Date(String(ISODate)).toISOString().split('T')[0]<br />
}<br />
<br />
const getTimeString = (ISODate: unknown | null = null) => {<br />
return new Date(String(ISODate)).toISOString().split('T')[1].split('.')[0]<br />
}<br />
<br />
const createRecord = async (journalRecordController: JournalRecordsController, baseRecord: JournalRecordResponse, newStageId) => {<br />
const getAttrValue = (value: unknown, dataType: DataType) => {<br />
if (dataType === "DATE") return getDateString(value)<br />
if (dataType === "TIME") return getTimeString(value)<br />
return value<br />
}<br />
<br />
const getBindings = (baseRecord: JournalRecordResponse): number[] | null => {<br />
return baseRecord?.companyLevelBindings?.map(b => b?.id) || null<br />
} <br />
<br />
const getRecordRequest = (baseRecord: JournalRecordResponse, newStageId: number): JournalRecordRequest => {<br />
return {<br />
routeId: baseRecord?.route?.id,<br />
stageId: newStageId,<br />
analysisObjectId: baseRecord?.analysisObject?.id,<br />
sampleTypeId: baseRecord.sampleType.id,<br />
attributes: baseRecord.attributes.map(attr => {<br />
return {<br />
fieldId: attr.field.id,<br />
stageId: newStageId,<br />
data: {<br />
...attr.data, <br />
value: getAttrValue(attr?.data?.value, attr?.field?.dataType),<br />
id: undefined<br />
},<br />
statusId: null<br />
}<br />
}),<br />
companyLevelBindings: getBindings(baseRecord)<br />
}<br />
}<br />
return await journalRecordController.createRecord(getRecordRequest(baseRecord, newStageId))<br />
}<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
const journalRecordController = new JournalRecordsController(apiInstance)<br />
const newRecord = await createRecord(journalRecordController, journalRecordManager.data, config.nextJournalRecordStage)<br />
showSuccessMessage(`${messages.success}. Id изначальной записи: ${config.journalRecordId}. Id новой записи ЛЖ: ${newRecord.id}. Этап: ${config.nextStageName}`, socketId)<br />
return config.integrationResult<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
</div><br />
</div></div>
Arhidiman
https://wiki.chemsoft.ru/index.php?title=%D0%90%D0%B4%D0%B4%D0%BE%D0%BD%D1%8B&diff=2377
Аддоны
2026-04-03T06:12:05Z
<p>Arhidiman: /* Проверка заполненности полей показателей. check-indicator-fields-filled */</p>
<hr />
<div>Список демонстрационных аддонов, показывающих возможности интеграционного сервиса.<br />
<br />
== Проверка даты регистрации. <code>check-registration-date</code> ==<br />
[[Файл:check-registration-date.png|frame]]<br />
Проверяет, не истёк ли срок регистрации пробы. Сравнивает дату регистрации из указанного поля с текущей датой. Если прошло более заданного количества дней (по умолчанию — 10), выдаёт ошибку. В противном случае показывает сообщение об успешной проверке.<br />
<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { MessageBoxResults } from "@triteia/types-integration-gui"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { DialogType } from "@triteia/types-integration-gui"<br />
import type { FetchApiClient } from "../../src/servivces/worker/api/ApiClient"<br />
import { apiInstance } from "../../src/servivces/worker/api/interactors/ApiInstance"<br />
<br />
// Конфигурация аддона:<br />
// - Поле "Дата регистрации" — контрольная точка для расчёта срока<br />
// - expirationLimit: 10 дней — максимальный допустимый срок хранения пробы<br />
// - journalRecordId: 201 — запись из журнала "Лаб. воздуха / Анализы завершены"<br />
const config = {<br />
dateField: 'Дата регистрации',<br />
expirationLimit: 10,<br />
journalRecordId: 201,<br />
integrationResult: { message: 'Срок регистрации пробы не истёк!' }<br />
}<br />
<br />
// Сообщения для пользовательских уведомлений и ошибок<br />
const messages = {<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
// Успех: информирует пользователя, что срок не вышел<br />
success: (recordId) => `Срок регистрации пробы не истёк! Id записи ${recordId}`,<br />
// Ошибка: превышен лимит хранения<br />
expired: (limit, recordId) => `Срок регистрации пробы истёк!\nПрошло более ${limit} дней с момента регистрации. Id записи: ${recordId}`,<br />
// Ошибка: отсутствует дата в нужном поле<br />
dateField: (dateField, stageName, journalRecordId) => [<br />
`Не заполнено либо отсутствует поле "${dateField}"`,<br />
`в этапе "${stageName || ''}".\nId записи: ${journalRecordId}`<br />
].join(' ')<br />
}<br />
<br />
// Централизованные обработчики ошибок — обеспечивают единообразие и чистоту основной логики<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
},<br />
// Вызывается, если поле с датой не заполнено<br />
dateError: (dateField, stageName, journalRecordId) => {<br />
throw new Error(messages.dateField(dateField, stageName, journalRecordId))<br />
},<br />
// Вызывается при превышении срока хранения<br />
expirationError: () => {<br />
throw new Error(messages.expired(config.expirationLimit, config.journalRecordId))<br />
}<br />
}<br />
<br />
// Извлекает socketId из queryParams — необходим для отправки диалогов в GUI<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
// Переводит дату в количество дней с начала эпохи (для арифметики дат)<br />
const getDaysByDate = (date: Date) => {<br />
const dayMs = 60 * 60 * 24 * 1000<br />
const timestamp = date.getTime()<br />
return timestamp / dayMs<br />
}<br />
<br />
// Формирует конфиг диалога: тип, заголовок и сообщение для отображения в GUI<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
// Рассчитывает, сколько дней прошло с момента регистрации пробы<br />
const getExpirationOffset = (registrationDate: string) => {<br />
const regDate = new Date(registrationDate)<br />
const today = new Date()<br />
return getDaysByDate(today) - getDaysByDate(regDate)<br />
}<br />
<br />
// Показывает пользователю сообщение об ошибке<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
// Показывает пользователю уведомление об успешной проверке<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
/**<br />
* Основная функция аддона:<br />
* Проверяет, не истёк ли срок хранения пробы (с момента "Дата регистрации").<br />
* <br />
* Логика:<br />
* 1. Получает значение поля "Дата регистрации" из записи журнала.<br />
* 2. Если дата не указана — ошибка.<br />
* 3. Если с даты регистрации прошло >= 10 дней — ошибка.<br />
* 4. Иначе — успех, показываем подтверждение.<br />
*/<br />
async function main({ queryParams, ...apiInstance }) {<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
// Получаем доступ к данным записи журнала<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
// Извлекаем значение поля "Дата регистрации"<br />
const date = journalRecordManager.getFieldValue(config.dateField)<br />
<br />
// Если дата не заполнена — прерываем с пояснением<br />
if (!date) {<br />
errorHandlers.dateError(config.dateField, journalRecordManager?.data?.stage?.stage?.name, config.journalRecordId)<br />
}<br />
<br />
// Считаем, сколько дней прошло с регистрации<br />
const expirationOffset = getExpirationOffset(date as string)<br />
<br />
// Если срок хранения превышен — ошибка<br />
if (expirationOffset >= config.expirationLimit) {<br />
errorHandlers.expirationError()<br />
}<br />
<br />
// Всё в порядке — информируем пользователя<br />
await showSuccessMessage(messages.success(config.journalRecordId), socketId)<br />
<br />
return config.integrationResult<br />
} catch (err) {<br />
// При любой ошибке — показываем её в модальном окне<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка заполненности полей показателей. <code>check-indicator-fields-filled</code> ==<br />
[[Файл:Check-indicator-fields-filled.png|frame]]<br />
Проверяет заполненность полей показателей в записи журнала по настраиваемому списку. Проверяет наличие определённых показателей (например, "Аммоний-ион") и заполненность у них таких полей, как исполнители, методики, средний результат и др. Выдаёт ошибку, если показатели отсутствуют или не все поля заполнены.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { DialogType } from "@triteia/types-integration-gui"<br />
import { IJournalRecordManager } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
<br />
// Конфигурация аддона:<br />
// - Список полей, обязательных для проверки заполненности<br />
// - journalRecordId: 144 — тестовая запись ("Мк / Тест_Ушакова")<br />
// - Результат при успехе: сообщение о полной заполненности<br />
const config = {<br />
requiredFields: [<br />
'Источник',<br />
'Список. Целое число',<br />
'Строка',<br />
'Целое число',<br />
'Вещественное число',<br />
'Логический тип',<br />
'Дата',<br />
'Время',<br />
],<br />
journalRecordId: 144, // Используется для доступа к данным записи<br />
integrationResult: { message: 'Все поля заполнены!' }<br />
}<br />
<br />
// Сообщения, отображаемые пользователю или используемые в ошибках<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: 'Все необходимые поля заполнены!',<br />
// Динамическое сообщение: перечисляет незаполненные поля и ID записи<br />
emptyFieldsError: (fields, recordId) => `Поля ${fields.map(f => `"${f}"`).join(', ')} не заполнены в записи с ID ${recordId}`,<br />
}<br />
<br />
// Централизованные обработчики ошибок — обеспечивают единообразие и чистоту основной логики<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
fieldsError: (emptyFields, recordId) => {<br />
throw new Error(messages.emptyFieldsError(emptyFields, recordId))<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
// Формирует конфиг диалога для GUI: тип, заголовок и сообщение<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
// Извлекает socketId из queryParams — он нужен для отправки диалогов обратно в интерфейс<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
// Показывает пользователю модальное окно с ошибкой<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
// Показывает уведомление об успешной проверке<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
// Удобная проверка на пустой массив — повышает читаемость кода<br />
const isEmptyArray = (arr: unknown[]) => {<br />
return arr.length === 0<br />
}<br />
<br />
// Определяет, какие из обязательных полей не заполнены в записи журнала<br />
const getNotFilledFields = (fields: string[], journalRecordsManager: IJournalRecordManager) => {<br />
console.log(journalRecordsManager.data.attributes, 'data.attributes') // Отладка: структура данных записи<br />
return fields.filter(f => !journalRecordsManager.getFieldValue(f))<br />
}<br />
<br />
/**<br />
* Основная функция аддона:<br />
* Проверяет, что все указанные поля в записи журнала заполнены.<br />
* <br />
* Логика:<br />
* 1. Получает socketId для связи с GUI.<br />
* 2. Загружает данные записи через JournalRecordManager.<br />
* 3. Проверяет каждое поле из requiredFields.<br />
* 4. Если все поля заполнены — показывает успех.<br />
* 5. Если есть пустые поля — прерывает выполнение с ошибкой.<br />
*/<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
// Получаем менеджер для работы с конкретной записью журнала<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
// Определяем, какие обязательные поля не заполнены<br />
const emptyFields = getNotFilledFields(config.requiredFields, journalRecordManager)<br />
<br />
if (isEmptyArray(emptyFields)) {<br />
// Все поля заполнены — информируем пользователя<br />
showSuccessMessage(messages.success, socketId)<br />
return config.integrationResult<br />
} else {<br />
// Есть незаполненные поля — прерываем с детализацией<br />
errorHandlers.fieldsError(emptyFields, config.journalRecordId)<br />
}<br />
} catch (err) {<br />
// При любой ошибке — показываем её в модальном окне<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка заполненности атрибутов записи ЛЖ. <code>check-record-fields-filled</code> ==<br />
[[Файл:Check-record-fields-filled.png|frame]]<br />
Проверяет заполненность заданных полей в записи журнала (например, "Источник", "Место отбора", "Дата регистрации" и др.). Если какое-либо из обязательных полей не заполнено, выдаётся соответствующая ошибка.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { DialogType } from "@triteia/types-integration-gui"<br />
import { IJournalRecordManager } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
<br />
const config = {<br />
requiredFields: [<br />
'Источник',<br />
'Список. Целое число',<br />
'Строка',<br />
'Целое число',<br />
'Вещественное число',<br />
'Логический тип',<br />
'Дата',<br />
'Время',<br />
],<br />
journalRecordId: 144, // Мк / Тест_Ушакова<br />
integrationResult: { message: 'Все поля заполнены!' }<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: 'Все необходимые поля заполнены!',<br />
emptyFieldsError: (fields, recordId) => `Поля ${fields.map(f => `"${f}"`).join(', ')} не заполнены в записи с ID ${recordId}`,<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
fieldsError: (emptyFields, recordId) => {<br />
throw new Error(messages.emptyFieldsError(emptyFields, recordId))<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const isEmptyArray = (arr: unknown[]) => {<br />
return arr.length === 0<br />
}<br />
<br />
const getNotFilledFields = (fields: string[], journalRecordsManager: IJournalRecordManager) => {<br />
console.log(journalRecordsManager.data.attributes, 'data.attributes')<br />
return fields.filter(f => !journalRecordsManager.getFieldValue(f))<br />
}<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
const emptyFields = getNotFilledFields(config.requiredFields, journalRecordManager)<br />
<br />
if (isEmptyArray(emptyFields)) {<br />
showSuccessMessage(messages.success, socketId)<br />
return config.integrationResult<br />
} else errorHandlers.fieldsError(emptyFields, config.journalRecordId)<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка движения пробы. <code>check-sample-moving</code> ==<br />
[[Файл:Check-sample-moving.png|frame]]<br />
Проверяет маршрут движения пробы по этапам. Получает историю перемещений записи и определяет, происходило ли движение (нахождение более чем на одном этапе). Отображает маршрут или сообщает, что движение не происходило.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { JournalsRecordRouteController } from "../../src/servivces/worker/api/controllers/journals-record-route"<br />
import { apiInstance } from "../../src/servivces/worker/api/interactors/ApiInstance"<br />
import type { DialogType } from "@triteia/types-integration-gui"<br />
import type { JournalRecordRouteDto } from "../../src/servivces/worker/api/controllers/journal-records"<br />
<br />
const config = {<br />
journalRecordId: 114 // Лаб. воздуха / Анализы завершены<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
route: (routes: JournalRecordRouteDto[], recordId: number) => `Машрут пробы: ${routes.map(r => `"${r.stageName}"`).join(' -> ')}. Id записи ЛЖ: ${recordId}`, <br />
notMoved: (recordId: number) => `Движение пробы не происходило. Id записи ЛЖ: ${recordId}`, <br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const isSampleMoved = (moves: JournalRecordRouteDto[]) => {<br />
return Array.isArray(moves) && moves.length > 1<br />
}<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalsRecordRouteController = new JournalsRecordRouteController(apiInstance)<br />
const sampleMoves = await journalsRecordRouteController.getJournalRecordRoute(config.journalRecordId)<br />
<br />
if (isSampleMoved(sampleMoves)) {<br />
showSuccessMessage(messages.route(sampleMoves, config.journalRecordId), socketId)<br />
} else {<br />
showSuccessMessage(messages.notMoved(config.journalRecordId), socketId)<br />
}<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка прав пользователя. <code>check-user-rights</code> ==<br />
[[Файл:Check-user-rights.png|frame]]<br />
Проверяет права доступа пользователя к определённым ресурсам (объекты анализа, методики, записи ЛЖ). Отображает таблицу с типами доступа (чтение, запись и т.д.) и наличием прав по каждому ресурсу.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { apiInstance } from "../../src/servivces/worker/api/interactors/ApiInstance"<br />
import { <br />
PermissionController, <br />
PermissionResource, <br />
PermissionRwAccess<br />
} from "../../src/servivces/worker/api/controllers/permisson"<br />
<br />
import { TableBuilder } from "../../src/gui/builder"<br />
import type { DialogType, TableConfig } from "@triteia/types-integration-gui"<br />
import type { JournalRecordRouteDto } from "../../src/servivces/worker/api/controllers/journal-records"<br />
<br />
const accessNamesMap = {<br />
[PermissionRwAccess.EXEC]: 'Выполнение',<br />
[PermissionRwAccess.READ]: 'Чтение',<br />
[PermissionRwAccess.WRITE]: 'Запись',<br />
}<br />
<br />
const requiredResources = [<br />
PermissionResource.ANALYSIS_OBJECT, <br />
PermissionResource.METHODOLOGY,<br />
PermissionResource.JOURNAL_RECORD<br />
]<br />
<br />
const resourcesNamesMap = {<br />
[PermissionResource.ANALYSIS_OBJECT]: 'Объекты анализа', <br />
[PermissionResource.METHODOLOGY]: 'Методики', <br />
[PermissionResource.JOURNAL_RECORD]: 'Записи ЛЖ'<br />
}<br />
<br />
const getAccessRightsTable = async (tableBuilder: TableBuilder, permissionController: PermissionController): Promise<TableConfig> => {<br />
const rows = (await Promise.all(requiredResources.map(async (source: PermissionResource) => {<br />
const sourceCombinations = await Promise.all(Object.keys(PermissionRwAccess).map(async (action) => {<br />
const access = await permissionController.getSourcePermission(source, PermissionRwAccess[action])<br />
return { source: resourcesNamesMap[source], action: accessNamesMap[PermissionRwAccess[action]], access: access.hasPermission }<br />
}))<br />
return sourceCombinations<br />
} <br />
))).flat()<br />
const table = tableBuilder<br />
.name('simpleTable')<br />
.label('Таблица')<br />
.isAddable(false)<br />
.actionsCol(false)<br />
.addColumn('Ресурс', 'source', false)<br />
.config('input', { name: 'source', rules: [{ required: true }] }, { placeholder: '', disabled: false })<br />
.next()<br />
.addColumn('Тип доступа', 'action', false)<br />
.config('input', { name: 'action' }, { type: 'string', placeholder: '', disabled: false })<br />
.next()<br />
.addColumn('Доступ', 'access', false)<br />
.config('checkbox', { name: 'access' }, { type: 'boolean', placeholder: '', disabled: false })<br />
.next()<br />
.setRows(rows)<br />
.build();<br />
return table<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
route: (routes: JournalRecordRouteDto[], recordId: number) => `Маршрут пробы: ${routes.map(r => `"${r.stageName}"`).join(' -> ')}. Id записи ЛЖ: ${recordId}`, <br />
notMoved: (recordId: number) => `Движение пробы не происходило. Id записи ЛЖ: ${recordId}`, <br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
<br />
const showTable = async (builder: TableBuilder, controller: PermissionController, socketId: string) => <br />
await getDataFromDialog({ type: 'input-data', config: [await getAccessRightsTable(builder, controller)] }, socketId)<br />
<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
try {<br />
await showTable(new TableBuilder, new PermissionController(apiInstance), socketId)<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Заполнение атрибутов записи ЛЖ. <code>fill-record-fields</code> ==<br />
[[Файл:Fill-record-fields.png|frame]]<br />
Автоматически заполняет заданные поля в записи журнала (например, даты, место отбора, шифр пробы и др.). Есть возможность использования ключевых слов для сопоставления полей, если точные названия не совпадают.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { DialogType } from "@triteia/types-integration-gui"<br />
import { IJournalRecordManager } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
import { JournalRecordAttributeFieldResponse } from "../../src/servivces/worker/api/controllers/lj-eav-attribute-fields"<br />
import { FieldMatch } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
<br />
const date = new Date().toISOString().split('T')[0]<br />
const config = {<br />
requiredFields: [<br />
{ name: 'Дата регистрации', value: date, keywords: ['дат', 'регистр'] },<br />
{ name: 'Место отбора', value: 'Скважина 516563Г ', keywords: ['мест', 'отбор'] },<br />
{ name: 'Дата отбора', value: date, keywords: ['дат', 'отбор'] },<br />
{ name: 'Шифр пробы', value: 'shifr 123', keywords: ['дат', 'регистр']},<br />
{ name: 'Список. Целое число', value: 666, keywords: ['спис', 'цел', 'числ'] },<br />
{ name: 'Помещение', value: 'помещение', keywords: ['помещ']},<br />
] as FieldMatch[],<br />
journalRecordId: 118, // Мк / 111<br />
integrationResult: { message: 'Все поля заполнены!' }<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: (recordId) => `Все необходимые поля заполнены! Id записи: ${recordId}`,<br />
emptyFieldsError: (fields, recordId) => `Поля ${fields.map(f => `"${f}"`).join(', ')} не заполнены в записи с ID ${recordId}`,<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const fieldsMatcher = (field: JournalRecordAttributeFieldResponse, searchField: FieldMatch) => {<br />
return searchField.keywords.every(k => String(field.name).toLocaleLowerCase().includes(k.toLocaleLowerCase()))<br />
}<br />
<br />
const fillFields = async (fields: FieldMatch[], journalRecordsManager: IJournalRecordManager) => {<br />
await journalRecordsManager.setFieldsValues(fields, journalRecordsManager, fieldsMatcher)<br />
}<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
await fillFields(config.requiredFields, journalRecordManager)<br />
showSuccessMessage(messages.success(journalRecordManager.journalRecordId), socketId)<br />
return config.integrationResult<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Деление данных. <code>copy-journal-record</code> ==<br />
[[Файл:Copy-journal-record.png|frame]]<br />
Создаёт копию записи журнала на заданном этапе маршрута. Выводит сообщение с ID новой записи.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { JournalRecordsController } from "../../src/servivces/worker/api/controllers/journal-records"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { apiInstance } from "../../src/servivces/worker/api/interactors/ApiInstance"<br />
import type { DialogType } from "@triteia/types-integration-gui"<br />
import type { JournalRecordRequest, JournalRecordResponse } from "../../src/servivces/worker/api/controllers/journal-records"<br />
import type { JournalRecordAttributeResponse } from "../../src/servivces/worker/api/controllers/journal-records"<br />
<br />
type DataType = JournalRecordAttributeResponse['field']['dataType']<br />
<br />
const config = {<br />
journalRecordId: 208, // Лаб. воздуха / Регистрация<br />
nextJournalRecordStage: 2, // Лаб. воздуха / Анализ<br />
nextStageName: 'Анализ',<br />
nextRouteId: 50,<br />
integrationResult: { message: 'Запись ЛЖ скопирована успешно!' }<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: 'Все необходимые поля заполнены!',<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const getDateString = (ISODate: unknown | null = null) => {<br />
return new Date(String(ISODate)).toISOString().split('T')[0]<br />
}<br />
<br />
const getTimeString = (ISODate: unknown | null = null) => {<br />
return new Date(String(ISODate)).toISOString().split('T')[1].split('.')[0]<br />
}<br />
<br />
const createRecord = async (journalRecordController: JournalRecordsController, baseRecord: JournalRecordResponse, newStageId) => {<br />
const getAttrValue = (value: unknown, dataType: DataType) => {<br />
if (dataType === "DATE") return getDateString(value)<br />
if (dataType === "TIME") return getTimeString(value)<br />
return value<br />
}<br />
<br />
const getBindings = (baseRecord: JournalRecordResponse): number[] | null => {<br />
return baseRecord?.companyLevelBindings?.map(b => b?.id) || null<br />
} <br />
<br />
const getRecordRequest = (baseRecord: JournalRecordResponse, newStageId: number): JournalRecordRequest => {<br />
return {<br />
routeId: baseRecord?.route?.id,<br />
stageId: newStageId,<br />
analysisObjectId: baseRecord?.analysisObject?.id,<br />
sampleTypeId: baseRecord.sampleType.id,<br />
attributes: baseRecord.attributes.map(attr => {<br />
return {<br />
fieldId: attr.field.id,<br />
stageId: newStageId,<br />
data: {<br />
...attr.data, <br />
value: getAttrValue(attr?.data?.value, attr?.field?.dataType),<br />
id: undefined<br />
},<br />
statusId: null<br />
}<br />
}),<br />
companyLevelBindings: getBindings(baseRecord)<br />
}<br />
}<br />
return await journalRecordController.createRecord(getRecordRequest(baseRecord, newStageId))<br />
}<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
const journalRecordController = new JournalRecordsController(apiInstance)<br />
const newRecord = await createRecord(journalRecordController, journalRecordManager.data, config.nextJournalRecordStage)<br />
showSuccessMessage(`${messages.success}. Id изначальной записи: ${config.journalRecordId}. Id новой записи ЛЖ: ${newRecord.id}. Этап: ${config.nextStageName}`, socketId)<br />
return config.integrationResult<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
</div><br />
</div></div>
Arhidiman
https://wiki.chemsoft.ru/index.php?title=%D0%90%D0%B4%D0%B4%D0%BE%D0%BD%D1%8B&diff=2376
Аддоны
2026-04-03T06:05:20Z
<p>Arhidiman: /* Проверка даты регистрации. check-registration-date */</p>
<hr />
<div>Список демонстрационных аддонов, показывающих возможности интеграционного сервиса.<br />
<br />
== Проверка даты регистрации. <code>check-registration-date</code> ==<br />
[[Файл:check-registration-date.png|frame]]<br />
Проверяет, не истёк ли срок регистрации пробы. Сравнивает дату регистрации из указанного поля с текущей датой. Если прошло более заданного количества дней (по умолчанию — 10), выдаёт ошибку. В противном случае показывает сообщение об успешной проверке.<br />
<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { MessageBoxResults } from "@triteia/types-integration-gui"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { DialogType } from "@triteia/types-integration-gui"<br />
import type { FetchApiClient } from "../../src/servivces/worker/api/ApiClient"<br />
import { apiInstance } from "../../src/servivces/worker/api/interactors/ApiInstance"<br />
<br />
// Конфигурация аддона:<br />
// - Поле "Дата регистрации" — контрольная точка для расчёта срока<br />
// - expirationLimit: 10 дней — максимальный допустимый срок хранения пробы<br />
// - journalRecordId: 201 — запись из журнала "Лаб. воздуха / Анализы завершены"<br />
const config = {<br />
dateField: 'Дата регистрации',<br />
expirationLimit: 10,<br />
journalRecordId: 201,<br />
integrationResult: { message: 'Срок регистрации пробы не истёк!' }<br />
}<br />
<br />
// Сообщения для пользовательских уведомлений и ошибок<br />
const messages = {<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
// Успех: информирует пользователя, что срок не вышел<br />
success: (recordId) => `Срок регистрации пробы не истёк! Id записи ${recordId}`,<br />
// Ошибка: превышен лимит хранения<br />
expired: (limit, recordId) => `Срок регистрации пробы истёк!\nПрошло более ${limit} дней с момента регистрации. Id записи: ${recordId}`,<br />
// Ошибка: отсутствует дата в нужном поле<br />
dateField: (dateField, stageName, journalRecordId) => [<br />
`Не заполнено либо отсутствует поле "${dateField}"`,<br />
`в этапе "${stageName || ''}".\nId записи: ${journalRecordId}`<br />
].join(' ')<br />
}<br />
<br />
// Централизованные обработчики ошибок — обеспечивают единообразие и чистоту основной логики<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
},<br />
// Вызывается, если поле с датой не заполнено<br />
dateError: (dateField, stageName, journalRecordId) => {<br />
throw new Error(messages.dateField(dateField, stageName, journalRecordId))<br />
},<br />
// Вызывается при превышении срока хранения<br />
expirationError: () => {<br />
throw new Error(messages.expired(config.expirationLimit, config.journalRecordId))<br />
}<br />
}<br />
<br />
// Извлекает socketId из queryParams — необходим для отправки диалогов в GUI<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
// Переводит дату в количество дней с начала эпохи (для арифметики дат)<br />
const getDaysByDate = (date: Date) => {<br />
const dayMs = 60 * 60 * 24 * 1000<br />
const timestamp = date.getTime()<br />
return timestamp / dayMs<br />
}<br />
<br />
// Формирует конфиг диалога: тип, заголовок и сообщение для отображения в GUI<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
// Рассчитывает, сколько дней прошло с момента регистрации пробы<br />
const getExpirationOffset = (registrationDate: string) => {<br />
const regDate = new Date(registrationDate)<br />
const today = new Date()<br />
return getDaysByDate(today) - getDaysByDate(regDate)<br />
}<br />
<br />
// Показывает пользователю сообщение об ошибке<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
// Показывает пользователю уведомление об успешной проверке<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
/**<br />
* Основная функция аддона:<br />
* Проверяет, не истёк ли срок хранения пробы (с момента "Дата регистрации").<br />
* <br />
* Логика:<br />
* 1. Получает значение поля "Дата регистрации" из записи журнала.<br />
* 2. Если дата не указана — ошибка.<br />
* 3. Если с даты регистрации прошло >= 10 дней — ошибка.<br />
* 4. Иначе — успех, показываем подтверждение.<br />
*/<br />
async function main({ queryParams, ...apiInstance }) {<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
// Получаем доступ к данным записи журнала<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
// Извлекаем значение поля "Дата регистрации"<br />
const date = journalRecordManager.getFieldValue(config.dateField)<br />
<br />
// Если дата не заполнена — прерываем с пояснением<br />
if (!date) {<br />
errorHandlers.dateError(config.dateField, journalRecordManager?.data?.stage?.stage?.name, config.journalRecordId)<br />
}<br />
<br />
// Считаем, сколько дней прошло с регистрации<br />
const expirationOffset = getExpirationOffset(date as string)<br />
<br />
// Если срок хранения превышен — ошибка<br />
if (expirationOffset >= config.expirationLimit) {<br />
errorHandlers.expirationError()<br />
}<br />
<br />
// Всё в порядке — информируем пользователя<br />
await showSuccessMessage(messages.success(config.journalRecordId), socketId)<br />
<br />
return config.integrationResult<br />
} catch (err) {<br />
// При любой ошибке — показываем её в модальном окне<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка заполненности полей показателей. <code>check-indicator-fields-filled</code> ==<br />
[[Файл:Check-indicator-fields-filled.png|frame]]<br />
Проверяет заполненность полей показателей в записи журнала по настраиваемому списку. Проверяет наличие определённых показателей (например, "Аммоний-ион") и заполненность у них таких полей, как исполнители, методики, средний результат и др. Выдаёт ошибку, если показатели отсутствуют или не все поля заполнены.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import type { DialogType } from "@triteia/types-integration-gui"<br />
import type { JournalRecordIndicatorResponse } from "../../src/servivces/worker/api/controllers/journal-records"<br />
import type { IJournalRecordManager } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
<br />
type IndicatorProp = { label: string, get: () => unknown }<br />
type IndicatorPropsConfig = Record<string, IndicatorProp><br />
<br />
const indicatorPropsConfig = (indicator): IndicatorPropsConfig => {<br />
return {<br />
executors: {<br />
label: 'Исполнители', <br />
get: () => indicator?.result?.executors<br />
},<br />
methodic: {<br />
label: 'Методики', <br />
get: () => indicator?.methodics<br />
},<br />
averageResult: {<br />
label: 'Средний результат', <br />
get: () => indicator?.result?.averageValue<br />
},<br />
averageRoundedValue: {<br />
label: 'Средний округлённый результат', <br />
get: () => indicator?.result?.averageRoundedValue<br />
}<br />
}<br />
}<br />
<br />
const config = {<br />
requiredFields: [<br />
'Источник',<br />
'Место отбора',<br />
'Дата регистрации',<br />
'Шифр пробы',<br />
'Время регистрации'<br />
],<br />
indicatorsList: [<br />
'Аммоний-ион'<br />
],<br />
journalRecordId: 144, // Мк / Тест_Ушакова<br />
integrationResult: { message: 'Все поля заполнены!' }<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: 'Все необходимые поля заполнены!',<br />
emptyIndicators: (recordId) => `в записи с Id ${recordId} отсутствуют показатели`,<br />
emptyFieldsError: (fields, recordId) => `Поля ${fields.map(f => `"${f}"`).join(', ')} не заполнены в записи с ID ${recordId}`,<br />
indicators: (indicators: string[], recordId) => `Показатели ${indicators.map(f => `"${f}"`).join(', ')} отсутствуют в записи с ID ${recordId}`,<br />
emptyIndicatorsProps: (props: Record<string, string[]>, recordId) => {<br />
const propsString = Object.keys(props).map(prop => !isEmptyArray(props[prop]) ? `${prop}: ${props[prop].map(p => `"${p}"`).join(', ')}` : '').join('; ')<br />
return `В записи с Id ${recordId} отсутствуют либо не заполнены следующие поля у показателей: ${propsString}`<br />
}<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
fieldsError: (emptyFields, recordId) => {<br />
throw new Error(messages.emptyFieldsError(emptyFields, recordId))<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
},<br />
indicatorsError: (recordId) =>{<br />
throw new Error(messages.emptyIndicators(recordId))<br />
},<br />
notFoundIndicators: (indicators: string[], recordId: number) => {<br />
throw new Error(messages.indicators(indicators, recordId))<br />
},<br />
notFilledIndicatorProps: (props: Record<string, string[]>) => {<br />
throw new Error(messages.emptyIndicatorsProps(props, config.journalRecordId))<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const isEmptyArray = (arr: unknown[]) => {<br />
return Array.isArray(arr) && arr.length === 0<br />
}<br />
<br />
const hasIndicators = (journalRecordManager: IJournalRecordManager) => {<br />
const indicators = journalRecordManager?.data?.indicators<br />
return Array.isArray(indicators) && indicators.length > 0<br />
}<br />
<br />
const getNotFoundIndicators = (indicators: JournalRecordIndicatorResponse[], indicatorsList = config.indicatorsList) => {<br />
return indicatorsList.filter(ind => indicators.every(ljInd => ljInd?.indicator?.name?.toLowerCase() !== ind.toLocaleLowerCase()))<br />
} <br />
<br />
const getNotFilledResultsFields = (indicators: JournalRecordIndicatorResponse[]): Record<string, string[]> => {<br />
return indicators.reduce((acc, indicator) => {<br />
const config = indicatorPropsConfig(indicator)<br />
return {<br />
...acc,<br />
[indicator?.indicator?.name]: Object.keys(config).reduce((acc, prop) => {<br />
if (!config[prop].get()) return [...acc, config[prop].label]<br />
return acc<br />
}, [] as string[])<br />
}<br />
}, {}) as Record<string, string[]><br />
}<br />
<br />
const hasNotFilledProps = (indicatorsProps: Record<string, string[]>) => {<br />
return Object.keys(indicatorsProps).some(indicator => !isEmptyArray(indicatorsProps[indicator]))<br />
}<br />
<br />
const hasNotFoundIndicators = (indicators: string[]) => !isEmptyArray(indicators)<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
<br />
if (!hasIndicators(journalRecordManager)) {<br />
errorHandlers.indicatorsError(journalRecordManager.journalRecordId)<br />
}<br />
<br />
const indicators = journalRecordManager?.data?.indicators<br />
<br />
const notFoundIndicators = getNotFoundIndicators(indicators)<br />
if (hasNotFoundIndicators(notFoundIndicators)) { <br />
errorHandlers.notFoundIndicators(notFoundIndicators, journalRecordManager.journalRecordId)<br />
}<br />
<br />
const emptyIndicatorProps = getNotFilledResultsFields(indicators)<br />
if (hasNotFilledProps(emptyIndicatorProps)) {<br />
errorHandlers.notFilledIndicatorProps(emptyIndicatorProps)<br />
}<br />
<br />
showSuccessMessage(messages.success, socketId)<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка заполненности атрибутов записи ЛЖ. <code>check-record-fields-filled</code> ==<br />
[[Файл:Check-record-fields-filled.png|frame]]<br />
Проверяет заполненность заданных полей в записи журнала (например, "Источник", "Место отбора", "Дата регистрации" и др.). Если какое-либо из обязательных полей не заполнено, выдаётся соответствующая ошибка.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { DialogType } from "@triteia/types-integration-gui"<br />
import { IJournalRecordManager } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
<br />
const config = {<br />
requiredFields: [<br />
'Источник',<br />
'Список. Целое число',<br />
'Строка',<br />
'Целое число',<br />
'Вещественное число',<br />
'Логический тип',<br />
'Дата',<br />
'Время',<br />
],<br />
journalRecordId: 144, // Мк / Тест_Ушакова<br />
integrationResult: { message: 'Все поля заполнены!' }<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: 'Все необходимые поля заполнены!',<br />
emptyFieldsError: (fields, recordId) => `Поля ${fields.map(f => `"${f}"`).join(', ')} не заполнены в записи с ID ${recordId}`,<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
fieldsError: (emptyFields, recordId) => {<br />
throw new Error(messages.emptyFieldsError(emptyFields, recordId))<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const isEmptyArray = (arr: unknown[]) => {<br />
return arr.length === 0<br />
}<br />
<br />
const getNotFilledFields = (fields: string[], journalRecordsManager: IJournalRecordManager) => {<br />
console.log(journalRecordsManager.data.attributes, 'data.attributes')<br />
return fields.filter(f => !journalRecordsManager.getFieldValue(f))<br />
}<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
const emptyFields = getNotFilledFields(config.requiredFields, journalRecordManager)<br />
<br />
if (isEmptyArray(emptyFields)) {<br />
showSuccessMessage(messages.success, socketId)<br />
return config.integrationResult<br />
} else errorHandlers.fieldsError(emptyFields, config.journalRecordId)<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка движения пробы. <code>check-sample-moving</code> ==<br />
[[Файл:Check-sample-moving.png|frame]]<br />
Проверяет маршрут движения пробы по этапам. Получает историю перемещений записи и определяет, происходило ли движение (нахождение более чем на одном этапе). Отображает маршрут или сообщает, что движение не происходило.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { JournalsRecordRouteController } from "../../src/servivces/worker/api/controllers/journals-record-route"<br />
import { apiInstance } from "../../src/servivces/worker/api/interactors/ApiInstance"<br />
import type { DialogType } from "@triteia/types-integration-gui"<br />
import type { JournalRecordRouteDto } from "../../src/servivces/worker/api/controllers/journal-records"<br />
<br />
const config = {<br />
journalRecordId: 114 // Лаб. воздуха / Анализы завершены<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
route: (routes: JournalRecordRouteDto[], recordId: number) => `Машрут пробы: ${routes.map(r => `"${r.stageName}"`).join(' -> ')}. Id записи ЛЖ: ${recordId}`, <br />
notMoved: (recordId: number) => `Движение пробы не происходило. Id записи ЛЖ: ${recordId}`, <br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const isSampleMoved = (moves: JournalRecordRouteDto[]) => {<br />
return Array.isArray(moves) && moves.length > 1<br />
}<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalsRecordRouteController = new JournalsRecordRouteController(apiInstance)<br />
const sampleMoves = await journalsRecordRouteController.getJournalRecordRoute(config.journalRecordId)<br />
<br />
if (isSampleMoved(sampleMoves)) {<br />
showSuccessMessage(messages.route(sampleMoves, config.journalRecordId), socketId)<br />
} else {<br />
showSuccessMessage(messages.notMoved(config.journalRecordId), socketId)<br />
}<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка прав пользователя. <code>check-user-rights</code> ==<br />
[[Файл:Check-user-rights.png|frame]]<br />
Проверяет права доступа пользователя к определённым ресурсам (объекты анализа, методики, записи ЛЖ). Отображает таблицу с типами доступа (чтение, запись и т.д.) и наличием прав по каждому ресурсу.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { apiInstance } from "../../src/servivces/worker/api/interactors/ApiInstance"<br />
import { <br />
PermissionController, <br />
PermissionResource, <br />
PermissionRwAccess<br />
} from "../../src/servivces/worker/api/controllers/permisson"<br />
<br />
import { TableBuilder } from "../../src/gui/builder"<br />
import type { DialogType, TableConfig } from "@triteia/types-integration-gui"<br />
import type { JournalRecordRouteDto } from "../../src/servivces/worker/api/controllers/journal-records"<br />
<br />
const accessNamesMap = {<br />
[PermissionRwAccess.EXEC]: 'Выполнение',<br />
[PermissionRwAccess.READ]: 'Чтение',<br />
[PermissionRwAccess.WRITE]: 'Запись',<br />
}<br />
<br />
const requiredResources = [<br />
PermissionResource.ANALYSIS_OBJECT, <br />
PermissionResource.METHODOLOGY,<br />
PermissionResource.JOURNAL_RECORD<br />
]<br />
<br />
const resourcesNamesMap = {<br />
[PermissionResource.ANALYSIS_OBJECT]: 'Объекты анализа', <br />
[PermissionResource.METHODOLOGY]: 'Методики', <br />
[PermissionResource.JOURNAL_RECORD]: 'Записи ЛЖ'<br />
}<br />
<br />
const getAccessRightsTable = async (tableBuilder: TableBuilder, permissionController: PermissionController): Promise<TableConfig> => {<br />
const rows = (await Promise.all(requiredResources.map(async (source: PermissionResource) => {<br />
const sourceCombinations = await Promise.all(Object.keys(PermissionRwAccess).map(async (action) => {<br />
const access = await permissionController.getSourcePermission(source, PermissionRwAccess[action])<br />
return { source: resourcesNamesMap[source], action: accessNamesMap[PermissionRwAccess[action]], access: access.hasPermission }<br />
}))<br />
return sourceCombinations<br />
} <br />
))).flat()<br />
const table = tableBuilder<br />
.name('simpleTable')<br />
.label('Таблица')<br />
.isAddable(false)<br />
.actionsCol(false)<br />
.addColumn('Ресурс', 'source', false)<br />
.config('input', { name: 'source', rules: [{ required: true }] }, { placeholder: '', disabled: false })<br />
.next()<br />
.addColumn('Тип доступа', 'action', false)<br />
.config('input', { name: 'action' }, { type: 'string', placeholder: '', disabled: false })<br />
.next()<br />
.addColumn('Доступ', 'access', false)<br />
.config('checkbox', { name: 'access' }, { type: 'boolean', placeholder: '', disabled: false })<br />
.next()<br />
.setRows(rows)<br />
.build();<br />
return table<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
route: (routes: JournalRecordRouteDto[], recordId: number) => `Маршрут пробы: ${routes.map(r => `"${r.stageName}"`).join(' -> ')}. Id записи ЛЖ: ${recordId}`, <br />
notMoved: (recordId: number) => `Движение пробы не происходило. Id записи ЛЖ: ${recordId}`, <br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
<br />
const showTable = async (builder: TableBuilder, controller: PermissionController, socketId: string) => <br />
await getDataFromDialog({ type: 'input-data', config: [await getAccessRightsTable(builder, controller)] }, socketId)<br />
<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
try {<br />
await showTable(new TableBuilder, new PermissionController(apiInstance), socketId)<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Заполнение атрибутов записи ЛЖ. <code>fill-record-fields</code> ==<br />
[[Файл:Fill-record-fields.png|frame]]<br />
Автоматически заполняет заданные поля в записи журнала (например, даты, место отбора, шифр пробы и др.). Есть возможность использования ключевых слов для сопоставления полей, если точные названия не совпадают.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { DialogType } from "@triteia/types-integration-gui"<br />
import { IJournalRecordManager } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
import { JournalRecordAttributeFieldResponse } from "../../src/servivces/worker/api/controllers/lj-eav-attribute-fields"<br />
import { FieldMatch } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
<br />
const date = new Date().toISOString().split('T')[0]<br />
const config = {<br />
requiredFields: [<br />
{ name: 'Дата регистрации', value: date, keywords: ['дат', 'регистр'] },<br />
{ name: 'Место отбора', value: 'Скважина 516563Г ', keywords: ['мест', 'отбор'] },<br />
{ name: 'Дата отбора', value: date, keywords: ['дат', 'отбор'] },<br />
{ name: 'Шифр пробы', value: 'shifr 123', keywords: ['дат', 'регистр']},<br />
{ name: 'Список. Целое число', value: 666, keywords: ['спис', 'цел', 'числ'] },<br />
{ name: 'Помещение', value: 'помещение', keywords: ['помещ']},<br />
] as FieldMatch[],<br />
journalRecordId: 118, // Мк / 111<br />
integrationResult: { message: 'Все поля заполнены!' }<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: (recordId) => `Все необходимые поля заполнены! Id записи: ${recordId}`,<br />
emptyFieldsError: (fields, recordId) => `Поля ${fields.map(f => `"${f}"`).join(', ')} не заполнены в записи с ID ${recordId}`,<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const fieldsMatcher = (field: JournalRecordAttributeFieldResponse, searchField: FieldMatch) => {<br />
return searchField.keywords.every(k => String(field.name).toLocaleLowerCase().includes(k.toLocaleLowerCase()))<br />
}<br />
<br />
const fillFields = async (fields: FieldMatch[], journalRecordsManager: IJournalRecordManager) => {<br />
await journalRecordsManager.setFieldsValues(fields, journalRecordsManager, fieldsMatcher)<br />
}<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
await fillFields(config.requiredFields, journalRecordManager)<br />
showSuccessMessage(messages.success(journalRecordManager.journalRecordId), socketId)<br />
return config.integrationResult<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Деление данных. <code>copy-journal-record</code> ==<br />
[[Файл:Copy-journal-record.png|frame]]<br />
Создаёт копию записи журнала на заданном этапе маршрута. Выводит сообщение с ID новой записи.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { JournalRecordsController } from "../../src/servivces/worker/api/controllers/journal-records"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { apiInstance } from "../../src/servivces/worker/api/interactors/ApiInstance"<br />
import type { DialogType } from "@triteia/types-integration-gui"<br />
import type { JournalRecordRequest, JournalRecordResponse } from "../../src/servivces/worker/api/controllers/journal-records"<br />
import type { JournalRecordAttributeResponse } from "../../src/servivces/worker/api/controllers/journal-records"<br />
<br />
type DataType = JournalRecordAttributeResponse['field']['dataType']<br />
<br />
const config = {<br />
journalRecordId: 208, // Лаб. воздуха / Регистрация<br />
nextJournalRecordStage: 2, // Лаб. воздуха / Анализ<br />
nextStageName: 'Анализ',<br />
nextRouteId: 50,<br />
integrationResult: { message: 'Запись ЛЖ скопирована успешно!' }<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: 'Все необходимые поля заполнены!',<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const getDateString = (ISODate: unknown | null = null) => {<br />
return new Date(String(ISODate)).toISOString().split('T')[0]<br />
}<br />
<br />
const getTimeString = (ISODate: unknown | null = null) => {<br />
return new Date(String(ISODate)).toISOString().split('T')[1].split('.')[0]<br />
}<br />
<br />
const createRecord = async (journalRecordController: JournalRecordsController, baseRecord: JournalRecordResponse, newStageId) => {<br />
const getAttrValue = (value: unknown, dataType: DataType) => {<br />
if (dataType === "DATE") return getDateString(value)<br />
if (dataType === "TIME") return getTimeString(value)<br />
return value<br />
}<br />
<br />
const getBindings = (baseRecord: JournalRecordResponse): number[] | null => {<br />
return baseRecord?.companyLevelBindings?.map(b => b?.id) || null<br />
} <br />
<br />
const getRecordRequest = (baseRecord: JournalRecordResponse, newStageId: number): JournalRecordRequest => {<br />
return {<br />
routeId: baseRecord?.route?.id,<br />
stageId: newStageId,<br />
analysisObjectId: baseRecord?.analysisObject?.id,<br />
sampleTypeId: baseRecord.sampleType.id,<br />
attributes: baseRecord.attributes.map(attr => {<br />
return {<br />
fieldId: attr.field.id,<br />
stageId: newStageId,<br />
data: {<br />
...attr.data, <br />
value: getAttrValue(attr?.data?.value, attr?.field?.dataType),<br />
id: undefined<br />
},<br />
statusId: null<br />
}<br />
}),<br />
companyLevelBindings: getBindings(baseRecord)<br />
}<br />
}<br />
return await journalRecordController.createRecord(getRecordRequest(baseRecord, newStageId))<br />
}<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
const journalRecordController = new JournalRecordsController(apiInstance)<br />
const newRecord = await createRecord(journalRecordController, journalRecordManager.data, config.nextJournalRecordStage)<br />
showSuccessMessage(`${messages.success}. Id изначальной записи: ${config.journalRecordId}. Id новой записи ЛЖ: ${newRecord.id}. Этап: ${config.nextStageName}`, socketId)<br />
return config.integrationResult<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
</div><br />
</div></div>
Arhidiman
https://wiki.chemsoft.ru/index.php?title=%D0%90%D0%B4%D0%B4%D0%BE%D0%BD%D1%8B&diff=2375
Аддоны
2026-04-03T04:59:05Z
<p>Arhidiman: /* Проверка даты регистрации. check-registration-date */</p>
<hr />
<div>Список демонстрационных аддонов, показывающих возможности интеграционного сервиса.<br />
<br />
== Проверка даты регистрации. <code>check-registration-date</code> ==<br />
[[Файл:check-registration-date.png|frame]]<br />
Проверяет, не истёк ли срок регистрации пробы. Сравнивает дату регистрации из указанного поля с текущей датой. Если прошло более заданного количества дней (по умолчанию — 10), выдаёт ошибку. В противном случае показывает сообщение об успешной проверке.<br />
<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { MessageBoxResults } from "@triteia/types-integration-gui"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { DialogType } from "@triteia/types-integration-gui"<br />
<br />
const config = {<br />
dateField: 'Дата регистрации',<br />
expirationLimit: 10,<br />
journalRecordId: 201, // Лаб. воздуха / Анализы завершены<br />
integrationResult: { message: 'Срок регистрации пробы не истёк !'}<br />
}<br />
<br />
const messages = {<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
success: (recordId) => `Срок регистрации пробы не истёк ! Id записи ${recordId}`,<br />
expired: (limit, recordId) => `Срок регистрации пробы истёк!\nПрошло более ${ limit } дней с момента регистрации. Id записи: ${recordId}`,<br />
dateField: (dateField, stageName, journalRecordId) => [<br />
`Не заполнено либо отсутствует поле "${dateField}"`,<br />
`в этапе "${stageName || ''}".\nId записи: ${journalRecordId}`<br />
].join(' ')<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
},<br />
dateError: (dateField, stageName, journalRecordId) => {<br />
throw new Error(messages.dateField(dateField, stageName, journalRecordId))<br />
},<br />
expirationError: () => {<br />
throw new Error(messages.expired(config.expirationLimit, config.journalRecordId))<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const getDaysByDate = (date: Date) => {<br />
const dayMs = 60 * 60 * 24 * 1000<br />
const timestamp = date.getTime()<br />
return timestamp/dayMs<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getExpirationOffset = (registrationDate: string) => {<br />
const regDate = new Date(registrationDate)<br />
const today = new Date()<br />
return getDaysByDate(today) - getDaysByDate(regDate)<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
async function main({ queryParams }) {<br />
<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
const date = journalRecordManager.getFieldValue(config.dateField)<br />
<br />
if (!date) errorHandlers.dateError(config.dateField, journalRecordManager?.data?.stage?.stage?.name, config.journalRecordId)<br />
<br />
const expirationOffset = getExpirationOffset(date as string)<br />
<br />
if (expirationOffset >= config.expirationLimit) errorHandlers.expirationError()<br />
<br />
await showSuccessMessage(messages.success(config.journalRecordId), socketId)<br />
<br />
return config.integrationResult<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка заполненности полей показателей. <code>check-indicator-fields-filled</code> ==<br />
[[Файл:Check-indicator-fields-filled.png|frame]]<br />
Проверяет заполненность полей показателей в записи журнала по настраиваемому списку. Проверяет наличие определённых показателей (например, "Аммоний-ион") и заполненность у них таких полей, как исполнители, методики, средний результат и др. Выдаёт ошибку, если показатели отсутствуют или не все поля заполнены.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import type { DialogType } from "@triteia/types-integration-gui"<br />
import type { JournalRecordIndicatorResponse } from "../../src/servivces/worker/api/controllers/journal-records"<br />
import type { IJournalRecordManager } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
<br />
type IndicatorProp = { label: string, get: () => unknown }<br />
type IndicatorPropsConfig = Record<string, IndicatorProp><br />
<br />
const indicatorPropsConfig = (indicator): IndicatorPropsConfig => {<br />
return {<br />
executors: {<br />
label: 'Исполнители', <br />
get: () => indicator?.result?.executors<br />
},<br />
methodic: {<br />
label: 'Методики', <br />
get: () => indicator?.methodics<br />
},<br />
averageResult: {<br />
label: 'Средний результат', <br />
get: () => indicator?.result?.averageValue<br />
},<br />
averageRoundedValue: {<br />
label: 'Средний округлённый результат', <br />
get: () => indicator?.result?.averageRoundedValue<br />
}<br />
}<br />
}<br />
<br />
const config = {<br />
requiredFields: [<br />
'Источник',<br />
'Место отбора',<br />
'Дата регистрации',<br />
'Шифр пробы',<br />
'Время регистрации'<br />
],<br />
indicatorsList: [<br />
'Аммоний-ион'<br />
],<br />
journalRecordId: 144, // Мк / Тест_Ушакова<br />
integrationResult: { message: 'Все поля заполнены!' }<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: 'Все необходимые поля заполнены!',<br />
emptyIndicators: (recordId) => `в записи с Id ${recordId} отсутствуют показатели`,<br />
emptyFieldsError: (fields, recordId) => `Поля ${fields.map(f => `"${f}"`).join(', ')} не заполнены в записи с ID ${recordId}`,<br />
indicators: (indicators: string[], recordId) => `Показатели ${indicators.map(f => `"${f}"`).join(', ')} отсутствуют в записи с ID ${recordId}`,<br />
emptyIndicatorsProps: (props: Record<string, string[]>, recordId) => {<br />
const propsString = Object.keys(props).map(prop => !isEmptyArray(props[prop]) ? `${prop}: ${props[prop].map(p => `"${p}"`).join(', ')}` : '').join('; ')<br />
return `В записи с Id ${recordId} отсутствуют либо не заполнены следующие поля у показателей: ${propsString}`<br />
}<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
fieldsError: (emptyFields, recordId) => {<br />
throw new Error(messages.emptyFieldsError(emptyFields, recordId))<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
},<br />
indicatorsError: (recordId) =>{<br />
throw new Error(messages.emptyIndicators(recordId))<br />
},<br />
notFoundIndicators: (indicators: string[], recordId: number) => {<br />
throw new Error(messages.indicators(indicators, recordId))<br />
},<br />
notFilledIndicatorProps: (props: Record<string, string[]>) => {<br />
throw new Error(messages.emptyIndicatorsProps(props, config.journalRecordId))<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const isEmptyArray = (arr: unknown[]) => {<br />
return Array.isArray(arr) && arr.length === 0<br />
}<br />
<br />
const hasIndicators = (journalRecordManager: IJournalRecordManager) => {<br />
const indicators = journalRecordManager?.data?.indicators<br />
return Array.isArray(indicators) && indicators.length > 0<br />
}<br />
<br />
const getNotFoundIndicators = (indicators: JournalRecordIndicatorResponse[], indicatorsList = config.indicatorsList) => {<br />
return indicatorsList.filter(ind => indicators.every(ljInd => ljInd?.indicator?.name?.toLowerCase() !== ind.toLocaleLowerCase()))<br />
} <br />
<br />
const getNotFilledResultsFields = (indicators: JournalRecordIndicatorResponse[]): Record<string, string[]> => {<br />
return indicators.reduce((acc, indicator) => {<br />
const config = indicatorPropsConfig(indicator)<br />
return {<br />
...acc,<br />
[indicator?.indicator?.name]: Object.keys(config).reduce((acc, prop) => {<br />
if (!config[prop].get()) return [...acc, config[prop].label]<br />
return acc<br />
}, [] as string[])<br />
}<br />
}, {}) as Record<string, string[]><br />
}<br />
<br />
const hasNotFilledProps = (indicatorsProps: Record<string, string[]>) => {<br />
return Object.keys(indicatorsProps).some(indicator => !isEmptyArray(indicatorsProps[indicator]))<br />
}<br />
<br />
const hasNotFoundIndicators = (indicators: string[]) => !isEmptyArray(indicators)<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
<br />
if (!hasIndicators(journalRecordManager)) {<br />
errorHandlers.indicatorsError(journalRecordManager.journalRecordId)<br />
}<br />
<br />
const indicators = journalRecordManager?.data?.indicators<br />
<br />
const notFoundIndicators = getNotFoundIndicators(indicators)<br />
if (hasNotFoundIndicators(notFoundIndicators)) { <br />
errorHandlers.notFoundIndicators(notFoundIndicators, journalRecordManager.journalRecordId)<br />
}<br />
<br />
const emptyIndicatorProps = getNotFilledResultsFields(indicators)<br />
if (hasNotFilledProps(emptyIndicatorProps)) {<br />
errorHandlers.notFilledIndicatorProps(emptyIndicatorProps)<br />
}<br />
<br />
showSuccessMessage(messages.success, socketId)<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка заполненности атрибутов записи ЛЖ. <code>check-record-fields-filled</code> ==<br />
[[Файл:Check-record-fields-filled.png|frame]]<br />
Проверяет заполненность заданных полей в записи журнала (например, "Источник", "Место отбора", "Дата регистрации" и др.). Если какое-либо из обязательных полей не заполнено, выдаётся соответствующая ошибка.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { DialogType } from "@triteia/types-integration-gui"<br />
import { IJournalRecordManager } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
<br />
const config = {<br />
requiredFields: [<br />
'Источник',<br />
'Список. Целое число',<br />
'Строка',<br />
'Целое число',<br />
'Вещественное число',<br />
'Логический тип',<br />
'Дата',<br />
'Время',<br />
],<br />
journalRecordId: 144, // Мк / Тест_Ушакова<br />
integrationResult: { message: 'Все поля заполнены!' }<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: 'Все необходимые поля заполнены!',<br />
emptyFieldsError: (fields, recordId) => `Поля ${fields.map(f => `"${f}"`).join(', ')} не заполнены в записи с ID ${recordId}`,<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
fieldsError: (emptyFields, recordId) => {<br />
throw new Error(messages.emptyFieldsError(emptyFields, recordId))<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const isEmptyArray = (arr: unknown[]) => {<br />
return arr.length === 0<br />
}<br />
<br />
const getNotFilledFields = (fields: string[], journalRecordsManager: IJournalRecordManager) => {<br />
console.log(journalRecordsManager.data.attributes, 'data.attributes')<br />
return fields.filter(f => !journalRecordsManager.getFieldValue(f))<br />
}<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
const emptyFields = getNotFilledFields(config.requiredFields, journalRecordManager)<br />
<br />
if (isEmptyArray(emptyFields)) {<br />
showSuccessMessage(messages.success, socketId)<br />
return config.integrationResult<br />
} else errorHandlers.fieldsError(emptyFields, config.journalRecordId)<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка движения пробы. <code>check-sample-moving</code> ==<br />
[[Файл:Check-sample-moving.png|frame]]<br />
Проверяет маршрут движения пробы по этапам. Получает историю перемещений записи и определяет, происходило ли движение (нахождение более чем на одном этапе). Отображает маршрут или сообщает, что движение не происходило.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { JournalsRecordRouteController } from "../../src/servivces/worker/api/controllers/journals-record-route"<br />
import { apiInstance } from "../../src/servivces/worker/api/interactors/ApiInstance"<br />
import type { DialogType } from "@triteia/types-integration-gui"<br />
import type { JournalRecordRouteDto } from "../../src/servivces/worker/api/controllers/journal-records"<br />
<br />
const config = {<br />
journalRecordId: 114 // Лаб. воздуха / Анализы завершены<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
route: (routes: JournalRecordRouteDto[], recordId: number) => `Машрут пробы: ${routes.map(r => `"${r.stageName}"`).join(' -> ')}. Id записи ЛЖ: ${recordId}`, <br />
notMoved: (recordId: number) => `Движение пробы не происходило. Id записи ЛЖ: ${recordId}`, <br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const isSampleMoved = (moves: JournalRecordRouteDto[]) => {<br />
return Array.isArray(moves) && moves.length > 1<br />
}<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalsRecordRouteController = new JournalsRecordRouteController(apiInstance)<br />
const sampleMoves = await journalsRecordRouteController.getJournalRecordRoute(config.journalRecordId)<br />
<br />
if (isSampleMoved(sampleMoves)) {<br />
showSuccessMessage(messages.route(sampleMoves, config.journalRecordId), socketId)<br />
} else {<br />
showSuccessMessage(messages.notMoved(config.journalRecordId), socketId)<br />
}<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка прав пользователя. <code>check-user-rights</code> ==<br />
[[Файл:Check-user-rights.png|frame]]<br />
Проверяет права доступа пользователя к определённым ресурсам (объекты анализа, методики, записи ЛЖ). Отображает таблицу с типами доступа (чтение, запись и т.д.) и наличием прав по каждому ресурсу.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { apiInstance } from "../../src/servivces/worker/api/interactors/ApiInstance"<br />
import { <br />
PermissionController, <br />
PermissionResource, <br />
PermissionRwAccess<br />
} from "../../src/servivces/worker/api/controllers/permisson"<br />
<br />
import { TableBuilder } from "../../src/gui/builder"<br />
import type { DialogType, TableConfig } from "@triteia/types-integration-gui"<br />
import type { JournalRecordRouteDto } from "../../src/servivces/worker/api/controllers/journal-records"<br />
<br />
const accessNamesMap = {<br />
[PermissionRwAccess.EXEC]: 'Выполнение',<br />
[PermissionRwAccess.READ]: 'Чтение',<br />
[PermissionRwAccess.WRITE]: 'Запись',<br />
}<br />
<br />
const requiredResources = [<br />
PermissionResource.ANALYSIS_OBJECT, <br />
PermissionResource.METHODOLOGY,<br />
PermissionResource.JOURNAL_RECORD<br />
]<br />
<br />
const resourcesNamesMap = {<br />
[PermissionResource.ANALYSIS_OBJECT]: 'Объекты анализа', <br />
[PermissionResource.METHODOLOGY]: 'Методики', <br />
[PermissionResource.JOURNAL_RECORD]: 'Записи ЛЖ'<br />
}<br />
<br />
const getAccessRightsTable = async (tableBuilder: TableBuilder, permissionController: PermissionController): Promise<TableConfig> => {<br />
const rows = (await Promise.all(requiredResources.map(async (source: PermissionResource) => {<br />
const sourceCombinations = await Promise.all(Object.keys(PermissionRwAccess).map(async (action) => {<br />
const access = await permissionController.getSourcePermission(source, PermissionRwAccess[action])<br />
return { source: resourcesNamesMap[source], action: accessNamesMap[PermissionRwAccess[action]], access: access.hasPermission }<br />
}))<br />
return sourceCombinations<br />
} <br />
))).flat()<br />
const table = tableBuilder<br />
.name('simpleTable')<br />
.label('Таблица')<br />
.isAddable(false)<br />
.actionsCol(false)<br />
.addColumn('Ресурс', 'source', false)<br />
.config('input', { name: 'source', rules: [{ required: true }] }, { placeholder: '', disabled: false })<br />
.next()<br />
.addColumn('Тип доступа', 'action', false)<br />
.config('input', { name: 'action' }, { type: 'string', placeholder: '', disabled: false })<br />
.next()<br />
.addColumn('Доступ', 'access', false)<br />
.config('checkbox', { name: 'access' }, { type: 'boolean', placeholder: '', disabled: false })<br />
.next()<br />
.setRows(rows)<br />
.build();<br />
return table<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
route: (routes: JournalRecordRouteDto[], recordId: number) => `Маршрут пробы: ${routes.map(r => `"${r.stageName}"`).join(' -> ')}. Id записи ЛЖ: ${recordId}`, <br />
notMoved: (recordId: number) => `Движение пробы не происходило. Id записи ЛЖ: ${recordId}`, <br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
<br />
const showTable = async (builder: TableBuilder, controller: PermissionController, socketId: string) => <br />
await getDataFromDialog({ type: 'input-data', config: [await getAccessRightsTable(builder, controller)] }, socketId)<br />
<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
try {<br />
await showTable(new TableBuilder, new PermissionController(apiInstance), socketId)<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Заполнение атрибутов записи ЛЖ. <code>fill-record-fields</code> ==<br />
[[Файл:Fill-record-fields.png|frame]]<br />
Автоматически заполняет заданные поля в записи журнала (например, даты, место отбора, шифр пробы и др.). Есть возможность использования ключевых слов для сопоставления полей, если точные названия не совпадают.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { DialogType } from "@triteia/types-integration-gui"<br />
import { IJournalRecordManager } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
import { JournalRecordAttributeFieldResponse } from "../../src/servivces/worker/api/controllers/lj-eav-attribute-fields"<br />
import { FieldMatch } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
<br />
const date = new Date().toISOString().split('T')[0]<br />
const config = {<br />
requiredFields: [<br />
{ name: 'Дата регистрации', value: date, keywords: ['дат', 'регистр'] },<br />
{ name: 'Место отбора', value: 'Скважина 516563Г ', keywords: ['мест', 'отбор'] },<br />
{ name: 'Дата отбора', value: date, keywords: ['дат', 'отбор'] },<br />
{ name: 'Шифр пробы', value: 'shifr 123', keywords: ['дат', 'регистр']},<br />
{ name: 'Список. Целое число', value: 666, keywords: ['спис', 'цел', 'числ'] },<br />
{ name: 'Помещение', value: 'помещение', keywords: ['помещ']},<br />
] as FieldMatch[],<br />
journalRecordId: 118, // Мк / 111<br />
integrationResult: { message: 'Все поля заполнены!' }<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: (recordId) => `Все необходимые поля заполнены! Id записи: ${recordId}`,<br />
emptyFieldsError: (fields, recordId) => `Поля ${fields.map(f => `"${f}"`).join(', ')} не заполнены в записи с ID ${recordId}`,<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const fieldsMatcher = (field: JournalRecordAttributeFieldResponse, searchField: FieldMatch) => {<br />
return searchField.keywords.every(k => String(field.name).toLocaleLowerCase().includes(k.toLocaleLowerCase()))<br />
}<br />
<br />
const fillFields = async (fields: FieldMatch[], journalRecordsManager: IJournalRecordManager) => {<br />
await journalRecordsManager.setFieldsValues(fields, journalRecordsManager, fieldsMatcher)<br />
}<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
await fillFields(config.requiredFields, journalRecordManager)<br />
showSuccessMessage(messages.success(journalRecordManager.journalRecordId), socketId)<br />
return config.integrationResult<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Деление данных. <code>copy-journal-record</code> ==<br />
[[Файл:Copy-journal-record.png|frame]]<br />
Создаёт копию записи журнала на заданном этапе маршрута. Выводит сообщение с ID новой записи.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { JournalRecordsController } from "../../src/servivces/worker/api/controllers/journal-records"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { apiInstance } from "../../src/servivces/worker/api/interactors/ApiInstance"<br />
import type { DialogType } from "@triteia/types-integration-gui"<br />
import type { JournalRecordRequest, JournalRecordResponse } from "../../src/servivces/worker/api/controllers/journal-records"<br />
import type { JournalRecordAttributeResponse } from "../../src/servivces/worker/api/controllers/journal-records"<br />
<br />
type DataType = JournalRecordAttributeResponse['field']['dataType']<br />
<br />
const config = {<br />
journalRecordId: 208, // Лаб. воздуха / Регистрация<br />
nextJournalRecordStage: 2, // Лаб. воздуха / Анализ<br />
nextStageName: 'Анализ',<br />
nextRouteId: 50,<br />
integrationResult: { message: 'Запись ЛЖ скопирована успешно!' }<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: 'Все необходимые поля заполнены!',<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const getDateString = (ISODate: unknown | null = null) => {<br />
return new Date(String(ISODate)).toISOString().split('T')[0]<br />
}<br />
<br />
const getTimeString = (ISODate: unknown | null = null) => {<br />
return new Date(String(ISODate)).toISOString().split('T')[1].split('.')[0]<br />
}<br />
<br />
const createRecord = async (journalRecordController: JournalRecordsController, baseRecord: JournalRecordResponse, newStageId) => {<br />
const getAttrValue = (value: unknown, dataType: DataType) => {<br />
if (dataType === "DATE") return getDateString(value)<br />
if (dataType === "TIME") return getTimeString(value)<br />
return value<br />
}<br />
<br />
const getBindings = (baseRecord: JournalRecordResponse): number[] | null => {<br />
return baseRecord?.companyLevelBindings?.map(b => b?.id) || null<br />
} <br />
<br />
const getRecordRequest = (baseRecord: JournalRecordResponse, newStageId: number): JournalRecordRequest => {<br />
return {<br />
routeId: baseRecord?.route?.id,<br />
stageId: newStageId,<br />
analysisObjectId: baseRecord?.analysisObject?.id,<br />
sampleTypeId: baseRecord.sampleType.id,<br />
attributes: baseRecord.attributes.map(attr => {<br />
return {<br />
fieldId: attr.field.id,<br />
stageId: newStageId,<br />
data: {<br />
...attr.data, <br />
value: getAttrValue(attr?.data?.value, attr?.field?.dataType),<br />
id: undefined<br />
},<br />
statusId: null<br />
}<br />
}),<br />
companyLevelBindings: getBindings(baseRecord)<br />
}<br />
}<br />
return await journalRecordController.createRecord(getRecordRequest(baseRecord, newStageId))<br />
}<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
const journalRecordController = new JournalRecordsController(apiInstance)<br />
const newRecord = await createRecord(journalRecordController, journalRecordManager.data, config.nextJournalRecordStage)<br />
showSuccessMessage(`${messages.success}. Id изначальной записи: ${config.journalRecordId}. Id новой записи ЛЖ: ${newRecord.id}. Этап: ${config.nextStageName}`, socketId)<br />
return config.integrationResult<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
</div><br />
</div></div>
Arhidiman
https://wiki.chemsoft.ru/index.php?title=%D0%90%D0%B4%D0%B4%D0%BE%D0%BD%D1%8B&diff=2374
Аддоны
2026-04-03T04:36:45Z
<p>Arhidiman: /* Проверка даты регистрации. check-registration-date */</p>
<hr />
<div>Список демонстрационных аддонов, показывающих возможности интеграционного сервиса.<br />
<br />
== Проверка даты регистрации. <code>check-registration-date</code> ==<br />
[[Файл:check-registration-date.png|frame]]<br />
Проверяет, не истёк ли срок регистрации пробы. Сравнивает дату регистрации из указанного поля с текущей датой. Если прошло более заданного количества дней (по умолчанию — 10), выдаёт ошибку. В противном случае показывает сообщение об успешной проверке.<br />
<br />
<div class="toccolours mw-collapsible" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Код</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { MessageBoxResults } from "@triteia/types-integration-gui"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { DialogType } from "@triteia/types-integration-gui"<br />
<br />
const config = {<br />
dateField: 'Дата регистрации',<br />
expirationLimit: 10,<br />
journalRecordId: 201, // Лаб. воздуха / Анализы завершены<br />
integrationResult: { message: 'Срок регистрации пробы не истёк !'}<br />
}<br />
<br />
const messages = {<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
success: (recordId) => `Срок регистрации пробы не истёк ! Id записи ${recordId}`,<br />
expired: (limit, recordId) => `Срок регистрации пробы истёк!\nПрошло более ${ limit } дней с момента регистрации. Id записи: ${recordId}`,<br />
dateField: (dateField, stageName, journalRecordId) => [<br />
`Не заполнено либо отсутствует поле "${dateField}"`,<br />
`в этапе "${stageName || ''}".\nId записи: ${journalRecordId}`<br />
].join(' ')<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
},<br />
dateError: (dateField, stageName, journalRecordId) => {<br />
throw new Error(messages.dateField(dateField, stageName, journalRecordId))<br />
},<br />
expirationError: () => {<br />
throw new Error(messages.expired(config.expirationLimit, config.journalRecordId))<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const getDaysByDate = (date: Date) => {<br />
const dayMs = 60 * 60 * 24 * 1000<br />
const timestamp = date.getTime()<br />
return timestamp/dayMs<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getExpirationOffset = (registrationDate: string) => {<br />
const regDate = new Date(registrationDate)<br />
const today = new Date()<br />
return getDaysByDate(today) - getDaysByDate(regDate)<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
async function main({ queryParams }) {<br />
<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
const date = journalRecordManager.getFieldValue(config.dateField)<br />
<br />
if (!date) errorHandlers.dateError(config.dateField, journalRecordManager?.data?.stage?.stage?.name, config.journalRecordId)<br />
<br />
const expirationOffset = getExpirationOffset(date as string)<br />
<br />
if (expirationOffset >= config.expirationLimit) errorHandlers.expirationError()<br />
<br />
await showSuccessMessage(messages.success(config.journalRecordId), socketId)<br />
<br />
return config.integrationResult<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
</syntaxhighlight><br />
</div></div><br />
<br />
== Проверка заполненности полей показателей. <code>check-indicator-fields-filled</code> ==<br />
[[Файл:Check-indicator-fields-filled.png|frame]]<br />
Проверяет заполненность полей показателей в записи журнала по настраиваемому списку. Проверяет наличие определённых показателей (например, "Аммоний-ион") и заполненность у них таких полей, как исполнители, методики, средний результат и др. Выдаёт ошибку, если показатели отсутствуют или не все поля заполнены.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import type { DialogType } from "@triteia/types-integration-gui"<br />
import type { JournalRecordIndicatorResponse } from "../../src/servivces/worker/api/controllers/journal-records"<br />
import type { IJournalRecordManager } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
<br />
type IndicatorProp = { label: string, get: () => unknown }<br />
type IndicatorPropsConfig = Record<string, IndicatorProp><br />
<br />
const indicatorPropsConfig = (indicator): IndicatorPropsConfig => {<br />
return {<br />
executors: {<br />
label: 'Исполнители', <br />
get: () => indicator?.result?.executors<br />
},<br />
methodic: {<br />
label: 'Методики', <br />
get: () => indicator?.methodics<br />
},<br />
averageResult: {<br />
label: 'Средний результат', <br />
get: () => indicator?.result?.averageValue<br />
},<br />
averageRoundedValue: {<br />
label: 'Средний округлённый результат', <br />
get: () => indicator?.result?.averageRoundedValue<br />
}<br />
}<br />
}<br />
<br />
const config = {<br />
requiredFields: [<br />
'Источник',<br />
'Место отбора',<br />
'Дата регистрации',<br />
'Шифр пробы',<br />
'Время регистрации'<br />
],<br />
indicatorsList: [<br />
'Аммоний-ион'<br />
],<br />
journalRecordId: 144, // Мк / Тест_Ушакова<br />
integrationResult: { message: 'Все поля заполнены!' }<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: 'Все необходимые поля заполнены!',<br />
emptyIndicators: (recordId) => `в записи с Id ${recordId} отсутствуют показатели`,<br />
emptyFieldsError: (fields, recordId) => `Поля ${fields.map(f => `"${f}"`).join(', ')} не заполнены в записи с ID ${recordId}`,<br />
indicators: (indicators: string[], recordId) => `Показатели ${indicators.map(f => `"${f}"`).join(', ')} отсутствуют в записи с ID ${recordId}`,<br />
emptyIndicatorsProps: (props: Record<string, string[]>, recordId) => {<br />
const propsString = Object.keys(props).map(prop => !isEmptyArray(props[prop]) ? `${prop}: ${props[prop].map(p => `"${p}"`).join(', ')}` : '').join('; ')<br />
return `В записи с Id ${recordId} отсутствуют либо не заполнены следующие поля у показателей: ${propsString}`<br />
}<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
fieldsError: (emptyFields, recordId) => {<br />
throw new Error(messages.emptyFieldsError(emptyFields, recordId))<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
},<br />
indicatorsError: (recordId) =>{<br />
throw new Error(messages.emptyIndicators(recordId))<br />
},<br />
notFoundIndicators: (indicators: string[], recordId: number) => {<br />
throw new Error(messages.indicators(indicators, recordId))<br />
},<br />
notFilledIndicatorProps: (props: Record<string, string[]>) => {<br />
throw new Error(messages.emptyIndicatorsProps(props, config.journalRecordId))<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const isEmptyArray = (arr: unknown[]) => {<br />
return Array.isArray(arr) && arr.length === 0<br />
}<br />
<br />
const hasIndicators = (journalRecordManager: IJournalRecordManager) => {<br />
const indicators = journalRecordManager?.data?.indicators<br />
return Array.isArray(indicators) && indicators.length > 0<br />
}<br />
<br />
const getNotFoundIndicators = (indicators: JournalRecordIndicatorResponse[], indicatorsList = config.indicatorsList) => {<br />
return indicatorsList.filter(ind => indicators.every(ljInd => ljInd?.indicator?.name?.toLowerCase() !== ind.toLocaleLowerCase()))<br />
} <br />
<br />
const getNotFilledResultsFields = (indicators: JournalRecordIndicatorResponse[]): Record<string, string[]> => {<br />
return indicators.reduce((acc, indicator) => {<br />
const config = indicatorPropsConfig(indicator)<br />
return {<br />
...acc,<br />
[indicator?.indicator?.name]: Object.keys(config).reduce((acc, prop) => {<br />
if (!config[prop].get()) return [...acc, config[prop].label]<br />
return acc<br />
}, [] as string[])<br />
}<br />
}, {}) as Record<string, string[]><br />
}<br />
<br />
const hasNotFilledProps = (indicatorsProps: Record<string, string[]>) => {<br />
return Object.keys(indicatorsProps).some(indicator => !isEmptyArray(indicatorsProps[indicator]))<br />
}<br />
<br />
const hasNotFoundIndicators = (indicators: string[]) => !isEmptyArray(indicators)<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
<br />
if (!hasIndicators(journalRecordManager)) {<br />
errorHandlers.indicatorsError(journalRecordManager.journalRecordId)<br />
}<br />
<br />
const indicators = journalRecordManager?.data?.indicators<br />
<br />
const notFoundIndicators = getNotFoundIndicators(indicators)<br />
if (hasNotFoundIndicators(notFoundIndicators)) { <br />
errorHandlers.notFoundIndicators(notFoundIndicators, journalRecordManager.journalRecordId)<br />
}<br />
<br />
const emptyIndicatorProps = getNotFilledResultsFields(indicators)<br />
if (hasNotFilledProps(emptyIndicatorProps)) {<br />
errorHandlers.notFilledIndicatorProps(emptyIndicatorProps)<br />
}<br />
<br />
showSuccessMessage(messages.success, socketId)<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка заполненности атрибутов записи ЛЖ. <code>check-record-fields-filled</code> ==<br />
[[Файл:Check-record-fields-filled.png|frame]]<br />
Проверяет заполненность заданных полей в записи журнала (например, "Источник", "Место отбора", "Дата регистрации" и др.). Если какое-либо из обязательных полей не заполнено, выдаётся соответствующая ошибка.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { DialogType } from "@triteia/types-integration-gui"<br />
import { IJournalRecordManager } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
<br />
const config = {<br />
requiredFields: [<br />
'Источник',<br />
'Список. Целое число',<br />
'Строка',<br />
'Целое число',<br />
'Вещественное число',<br />
'Логический тип',<br />
'Дата',<br />
'Время',<br />
],<br />
journalRecordId: 144, // Мк / Тест_Ушакова<br />
integrationResult: { message: 'Все поля заполнены!' }<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: 'Все необходимые поля заполнены!',<br />
emptyFieldsError: (fields, recordId) => `Поля ${fields.map(f => `"${f}"`).join(', ')} не заполнены в записи с ID ${recordId}`,<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
fieldsError: (emptyFields, recordId) => {<br />
throw new Error(messages.emptyFieldsError(emptyFields, recordId))<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const isEmptyArray = (arr: unknown[]) => {<br />
return arr.length === 0<br />
}<br />
<br />
const getNotFilledFields = (fields: string[], journalRecordsManager: IJournalRecordManager) => {<br />
console.log(journalRecordsManager.data.attributes, 'data.attributes')<br />
return fields.filter(f => !journalRecordsManager.getFieldValue(f))<br />
}<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
const emptyFields = getNotFilledFields(config.requiredFields, journalRecordManager)<br />
<br />
if (isEmptyArray(emptyFields)) {<br />
showSuccessMessage(messages.success, socketId)<br />
return config.integrationResult<br />
} else errorHandlers.fieldsError(emptyFields, config.journalRecordId)<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка движения пробы. <code>check-sample-moving</code> ==<br />
[[Файл:Check-sample-moving.png|frame]]<br />
Проверяет маршрут движения пробы по этапам. Получает историю перемещений записи и определяет, происходило ли движение (нахождение более чем на одном этапе). Отображает маршрут или сообщает, что движение не происходило.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { JournalsRecordRouteController } from "../../src/servivces/worker/api/controllers/journals-record-route"<br />
import { apiInstance } from "../../src/servivces/worker/api/interactors/ApiInstance"<br />
import type { DialogType } from "@triteia/types-integration-gui"<br />
import type { JournalRecordRouteDto } from "../../src/servivces/worker/api/controllers/journal-records"<br />
<br />
const config = {<br />
journalRecordId: 114 // Лаб. воздуха / Анализы завершены<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
route: (routes: JournalRecordRouteDto[], recordId: number) => `Машрут пробы: ${routes.map(r => `"${r.stageName}"`).join(' -> ')}. Id записи ЛЖ: ${recordId}`, <br />
notMoved: (recordId: number) => `Движение пробы не происходило. Id записи ЛЖ: ${recordId}`, <br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const isSampleMoved = (moves: JournalRecordRouteDto[]) => {<br />
return Array.isArray(moves) && moves.length > 1<br />
}<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalsRecordRouteController = new JournalsRecordRouteController(apiInstance)<br />
const sampleMoves = await journalsRecordRouteController.getJournalRecordRoute(config.journalRecordId)<br />
<br />
if (isSampleMoved(sampleMoves)) {<br />
showSuccessMessage(messages.route(sampleMoves, config.journalRecordId), socketId)<br />
} else {<br />
showSuccessMessage(messages.notMoved(config.journalRecordId), socketId)<br />
}<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка прав пользователя. <code>check-user-rights</code> ==<br />
[[Файл:Check-user-rights.png|frame]]<br />
Проверяет права доступа пользователя к определённым ресурсам (объекты анализа, методики, записи ЛЖ). Отображает таблицу с типами доступа (чтение, запись и т.д.) и наличием прав по каждому ресурсу.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { apiInstance } from "../../src/servivces/worker/api/interactors/ApiInstance"<br />
import { <br />
PermissionController, <br />
PermissionResource, <br />
PermissionRwAccess<br />
} from "../../src/servivces/worker/api/controllers/permisson"<br />
<br />
import { TableBuilder } from "../../src/gui/builder"<br />
import type { DialogType, TableConfig } from "@triteia/types-integration-gui"<br />
import type { JournalRecordRouteDto } from "../../src/servivces/worker/api/controllers/journal-records"<br />
<br />
const accessNamesMap = {<br />
[PermissionRwAccess.EXEC]: 'Выполнение',<br />
[PermissionRwAccess.READ]: 'Чтение',<br />
[PermissionRwAccess.WRITE]: 'Запись',<br />
}<br />
<br />
const requiredResources = [<br />
PermissionResource.ANALYSIS_OBJECT, <br />
PermissionResource.METHODOLOGY,<br />
PermissionResource.JOURNAL_RECORD<br />
]<br />
<br />
const resourcesNamesMap = {<br />
[PermissionResource.ANALYSIS_OBJECT]: 'Объекты анализа', <br />
[PermissionResource.METHODOLOGY]: 'Методики', <br />
[PermissionResource.JOURNAL_RECORD]: 'Записи ЛЖ'<br />
}<br />
<br />
const getAccessRightsTable = async (tableBuilder: TableBuilder, permissionController: PermissionController): Promise<TableConfig> => {<br />
const rows = (await Promise.all(requiredResources.map(async (source: PermissionResource) => {<br />
const sourceCombinations = await Promise.all(Object.keys(PermissionRwAccess).map(async (action) => {<br />
const access = await permissionController.getSourcePermission(source, PermissionRwAccess[action])<br />
return { source: resourcesNamesMap[source], action: accessNamesMap[PermissionRwAccess[action]], access: access.hasPermission }<br />
}))<br />
return sourceCombinations<br />
} <br />
))).flat()<br />
const table = tableBuilder<br />
.name('simpleTable')<br />
.label('Таблица')<br />
.isAddable(false)<br />
.actionsCol(false)<br />
.addColumn('Ресурс', 'source', false)<br />
.config('input', { name: 'source', rules: [{ required: true }] }, { placeholder: '', disabled: false })<br />
.next()<br />
.addColumn('Тип доступа', 'action', false)<br />
.config('input', { name: 'action' }, { type: 'string', placeholder: '', disabled: false })<br />
.next()<br />
.addColumn('Доступ', 'access', false)<br />
.config('checkbox', { name: 'access' }, { type: 'boolean', placeholder: '', disabled: false })<br />
.next()<br />
.setRows(rows)<br />
.build();<br />
return table<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
route: (routes: JournalRecordRouteDto[], recordId: number) => `Маршрут пробы: ${routes.map(r => `"${r.stageName}"`).join(' -> ')}. Id записи ЛЖ: ${recordId}`, <br />
notMoved: (recordId: number) => `Движение пробы не происходило. Id записи ЛЖ: ${recordId}`, <br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
<br />
const showTable = async (builder: TableBuilder, controller: PermissionController, socketId: string) => <br />
await getDataFromDialog({ type: 'input-data', config: [await getAccessRightsTable(builder, controller)] }, socketId)<br />
<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
try {<br />
await showTable(new TableBuilder, new PermissionController(apiInstance), socketId)<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Заполнение атрибутов записи ЛЖ. <code>fill-record-fields</code> ==<br />
[[Файл:Fill-record-fields.png|frame]]<br />
Автоматически заполняет заданные поля в записи журнала (например, даты, место отбора, шифр пробы и др.). Есть возможность использования ключевых слов для сопоставления полей, если точные названия не совпадают.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { DialogType } from "@triteia/types-integration-gui"<br />
import { IJournalRecordManager } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
import { JournalRecordAttributeFieldResponse } from "../../src/servivces/worker/api/controllers/lj-eav-attribute-fields"<br />
import { FieldMatch } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
<br />
const date = new Date().toISOString().split('T')[0]<br />
const config = {<br />
requiredFields: [<br />
{ name: 'Дата регистрации', value: date, keywords: ['дат', 'регистр'] },<br />
{ name: 'Место отбора', value: 'Скважина 516563Г ', keywords: ['мест', 'отбор'] },<br />
{ name: 'Дата отбора', value: date, keywords: ['дат', 'отбор'] },<br />
{ name: 'Шифр пробы', value: 'shifr 123', keywords: ['дат', 'регистр']},<br />
{ name: 'Список. Целое число', value: 666, keywords: ['спис', 'цел', 'числ'] },<br />
{ name: 'Помещение', value: 'помещение', keywords: ['помещ']},<br />
] as FieldMatch[],<br />
journalRecordId: 118, // Мк / 111<br />
integrationResult: { message: 'Все поля заполнены!' }<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: (recordId) => `Все необходимые поля заполнены! Id записи: ${recordId}`,<br />
emptyFieldsError: (fields, recordId) => `Поля ${fields.map(f => `"${f}"`).join(', ')} не заполнены в записи с ID ${recordId}`,<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const fieldsMatcher = (field: JournalRecordAttributeFieldResponse, searchField: FieldMatch) => {<br />
return searchField.keywords.every(k => String(field.name).toLocaleLowerCase().includes(k.toLocaleLowerCase()))<br />
}<br />
<br />
const fillFields = async (fields: FieldMatch[], journalRecordsManager: IJournalRecordManager) => {<br />
await journalRecordsManager.setFieldsValues(fields, journalRecordsManager, fieldsMatcher)<br />
}<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
await fillFields(config.requiredFields, journalRecordManager)<br />
showSuccessMessage(messages.success(journalRecordManager.journalRecordId), socketId)<br />
return config.integrationResult<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Деление данных. <code>copy-journal-record</code> ==<br />
[[Файл:Copy-journal-record.png|frame]]<br />
Создаёт копию записи журнала на заданном этапе маршрута. Выводит сообщение с ID новой записи.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { JournalRecordsController } from "../../src/servivces/worker/api/controllers/journal-records"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { apiInstance } from "../../src/servivces/worker/api/interactors/ApiInstance"<br />
import type { DialogType } from "@triteia/types-integration-gui"<br />
import type { JournalRecordRequest, JournalRecordResponse } from "../../src/servivces/worker/api/controllers/journal-records"<br />
import type { JournalRecordAttributeResponse } from "../../src/servivces/worker/api/controllers/journal-records"<br />
<br />
type DataType = JournalRecordAttributeResponse['field']['dataType']<br />
<br />
const config = {<br />
journalRecordId: 208, // Лаб. воздуха / Регистрация<br />
nextJournalRecordStage: 2, // Лаб. воздуха / Анализ<br />
nextStageName: 'Анализ',<br />
nextRouteId: 50,<br />
integrationResult: { message: 'Запись ЛЖ скопирована успешно!' }<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: 'Все необходимые поля заполнены!',<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const getDateString = (ISODate: unknown | null = null) => {<br />
return new Date(String(ISODate)).toISOString().split('T')[0]<br />
}<br />
<br />
const getTimeString = (ISODate: unknown | null = null) => {<br />
return new Date(String(ISODate)).toISOString().split('T')[1].split('.')[0]<br />
}<br />
<br />
const createRecord = async (journalRecordController: JournalRecordsController, baseRecord: JournalRecordResponse, newStageId) => {<br />
const getAttrValue = (value: unknown, dataType: DataType) => {<br />
if (dataType === "DATE") return getDateString(value)<br />
if (dataType === "TIME") return getTimeString(value)<br />
return value<br />
}<br />
<br />
const getBindings = (baseRecord: JournalRecordResponse): number[] | null => {<br />
return baseRecord?.companyLevelBindings?.map(b => b?.id) || null<br />
} <br />
<br />
const getRecordRequest = (baseRecord: JournalRecordResponse, newStageId: number): JournalRecordRequest => {<br />
return {<br />
routeId: baseRecord?.route?.id,<br />
stageId: newStageId,<br />
analysisObjectId: baseRecord?.analysisObject?.id,<br />
sampleTypeId: baseRecord.sampleType.id,<br />
attributes: baseRecord.attributes.map(attr => {<br />
return {<br />
fieldId: attr.field.id,<br />
stageId: newStageId,<br />
data: {<br />
...attr.data, <br />
value: getAttrValue(attr?.data?.value, attr?.field?.dataType),<br />
id: undefined<br />
},<br />
statusId: null<br />
}<br />
}),<br />
companyLevelBindings: getBindings(baseRecord)<br />
}<br />
}<br />
return await journalRecordController.createRecord(getRecordRequest(baseRecord, newStageId))<br />
}<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
const journalRecordController = new JournalRecordsController(apiInstance)<br />
const newRecord = await createRecord(journalRecordController, journalRecordManager.data, config.nextJournalRecordStage)<br />
showSuccessMessage(`${messages.success}. Id изначальной записи: ${config.journalRecordId}. Id новой записи ЛЖ: ${newRecord.id}. Этап: ${config.nextStageName}`, socketId)<br />
return config.integrationResult<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
</div><br />
</div></div>
Arhidiman
https://wiki.chemsoft.ru/index.php?title=%D0%90%D0%B4%D0%B4%D0%BE%D0%BD%D1%8B&diff=2372
Аддоны
2026-04-02T01:39:08Z
<p>Arhidiman: /* Деление данных. copy-journal-record */</p>
<hr />
<div>Список демонстрационных аддонов, показывающих возможности интеграционного сервиса.<br />
<br />
== Проверка даты регистрации. <code>check-registration-date</code> ==<br />
[[Файл:check-registration-date.png|frame]]<br />
Проверяет, не истёк ли срок регистрации пробы. Сравнивает дату регистрации из указанного поля с текущей датой. Если прошло более заданного количества дней (по умолчанию — 10), выдаёт ошибку. В противном случае показывает сообщение об успешной проверке.<br />
<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { MessageBoxResults } from "@triteia/types-integration-gui"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { DialogType } from "@triteia/types-integration-gui"<br />
<br />
const config = {<br />
dateField: 'Дата регистрации',<br />
expirationLimit: 10,<br />
journalRecordId: 201, // Лаб. воздуха / Анализы завершены<br />
integrationResult: { message: 'Срок регистрации пробы не истёк !'}<br />
}<br />
<br />
const messages = {<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
success: (recordId) => `Срок регистрации пробы не истёк ! Id записи ${recordId}`,<br />
expired: (limit, recordId) => `Срок регистрации пробы истёк!\nПрошло более ${ limit } дней с момента регистрации. Id записи: ${recordId}`,<br />
dateField: (dateField, stageName, journalRecordId) => [<br />
`Не заполнено либо отсутствует поле "${dateField}"`,<br />
`в этапе "${stageName || ''}".\nId записи: ${journalRecordId}`<br />
].join(' ')<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
},<br />
dateError: (dateField, stageName, journalRecordId) => {<br />
throw new Error(messages.dateField(dateField, stageName, journalRecordId))<br />
},<br />
expirationError: () => {<br />
throw new Error(messages.expired(config.expirationLimit, config.journalRecordId))<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const getDaysByDate = (date: Date) => {<br />
const dayMs = 60 * 60 * 24 * 1000<br />
const timestamp = date.getTime()<br />
return timestamp/dayMs<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getExpirationOffset = (registrationDate: string) => {<br />
const regDate = new Date(registrationDate)<br />
const today = new Date()<br />
return getDaysByDate(today) - getDaysByDate(regDate)<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
async function main({ queryParams }) {<br />
<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
const date = journalRecordManager.getFieldValue(config.dateField)<br />
<br />
if (!date) errorHandlers.dateError(config.dateField, journalRecordManager?.data?.stage?.stage?.name, config.journalRecordId)<br />
<br />
const expirationOffset = getExpirationOffset(date as string)<br />
<br />
if (expirationOffset >= config.expirationLimit) errorHandlers.expirationError()<br />
<br />
await showSuccessMessage(messages.success(config.journalRecordId), socketId)<br />
<br />
return config.integrationResult<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка заполненности полей показателей. <code>check-indicator-fields-filled</code> ==<br />
[[Файл:Check-indicator-fields-filled.png|frame]]<br />
Проверяет заполненность полей показателей в записи журнала по настраиваемому списку. Проверяет наличие определённых показателей (например, "Аммоний-ион") и заполненность у них таких полей, как исполнители, методики, средний результат и др. Выдаёт ошибку, если показатели отсутствуют или не все поля заполнены.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import type { DialogType } from "@triteia/types-integration-gui"<br />
import type { JournalRecordIndicatorResponse } from "../../src/servivces/worker/api/controllers/journal-records"<br />
import type { IJournalRecordManager } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
<br />
type IndicatorProp = { label: string, get: () => unknown }<br />
type IndicatorPropsConfig = Record<string, IndicatorProp><br />
<br />
const indicatorPropsConfig = (indicator): IndicatorPropsConfig => {<br />
return {<br />
executors: {<br />
label: 'Исполнители', <br />
get: () => indicator?.result?.executors<br />
},<br />
methodic: {<br />
label: 'Методики', <br />
get: () => indicator?.methodics<br />
},<br />
averageResult: {<br />
label: 'Средний результат', <br />
get: () => indicator?.result?.averageValue<br />
},<br />
averageRoundedValue: {<br />
label: 'Средний округлённый результат', <br />
get: () => indicator?.result?.averageRoundedValue<br />
}<br />
}<br />
}<br />
<br />
const config = {<br />
requiredFields: [<br />
'Источник',<br />
'Место отбора',<br />
'Дата регистрации',<br />
'Шифр пробы',<br />
'Время регистрации'<br />
],<br />
indicatorsList: [<br />
'Аммоний-ион'<br />
],<br />
journalRecordId: 144, // Мк / Тест_Ушакова<br />
integrationResult: { message: 'Все поля заполнены!' }<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: 'Все необходимые поля заполнены!',<br />
emptyIndicators: (recordId) => `в записи с Id ${recordId} отсутствуют показатели`,<br />
emptyFieldsError: (fields, recordId) => `Поля ${fields.map(f => `"${f}"`).join(', ')} не заполнены в записи с ID ${recordId}`,<br />
indicators: (indicators: string[], recordId) => `Показатели ${indicators.map(f => `"${f}"`).join(', ')} отсутствуют в записи с ID ${recordId}`,<br />
emptyIndicatorsProps: (props: Record<string, string[]>, recordId) => {<br />
const propsString = Object.keys(props).map(prop => !isEmptyArray(props[prop]) ? `${prop}: ${props[prop].map(p => `"${p}"`).join(', ')}` : '').join('; ')<br />
return `В записи с Id ${recordId} отсутствуют либо не заполнены следующие поля у показателей: ${propsString}`<br />
}<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
fieldsError: (emptyFields, recordId) => {<br />
throw new Error(messages.emptyFieldsError(emptyFields, recordId))<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
},<br />
indicatorsError: (recordId) =>{<br />
throw new Error(messages.emptyIndicators(recordId))<br />
},<br />
notFoundIndicators: (indicators: string[], recordId: number) => {<br />
throw new Error(messages.indicators(indicators, recordId))<br />
},<br />
notFilledIndicatorProps: (props: Record<string, string[]>) => {<br />
throw new Error(messages.emptyIndicatorsProps(props, config.journalRecordId))<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const isEmptyArray = (arr: unknown[]) => {<br />
return Array.isArray(arr) && arr.length === 0<br />
}<br />
<br />
const hasIndicators = (journalRecordManager: IJournalRecordManager) => {<br />
const indicators = journalRecordManager?.data?.indicators<br />
return Array.isArray(indicators) && indicators.length > 0<br />
}<br />
<br />
const getNotFoundIndicators = (indicators: JournalRecordIndicatorResponse[], indicatorsList = config.indicatorsList) => {<br />
return indicatorsList.filter(ind => indicators.every(ljInd => ljInd?.indicator?.name?.toLowerCase() !== ind.toLocaleLowerCase()))<br />
} <br />
<br />
const getNotFilledResultsFields = (indicators: JournalRecordIndicatorResponse[]): Record<string, string[]> => {<br />
return indicators.reduce((acc, indicator) => {<br />
const config = indicatorPropsConfig(indicator)<br />
return {<br />
...acc,<br />
[indicator?.indicator?.name]: Object.keys(config).reduce((acc, prop) => {<br />
if (!config[prop].get()) return [...acc, config[prop].label]<br />
return acc<br />
}, [] as string[])<br />
}<br />
}, {}) as Record<string, string[]><br />
}<br />
<br />
const hasNotFilledProps = (indicatorsProps: Record<string, string[]>) => {<br />
return Object.keys(indicatorsProps).some(indicator => !isEmptyArray(indicatorsProps[indicator]))<br />
}<br />
<br />
const hasNotFoundIndicators = (indicators: string[]) => !isEmptyArray(indicators)<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
<br />
if (!hasIndicators(journalRecordManager)) {<br />
errorHandlers.indicatorsError(journalRecordManager.journalRecordId)<br />
}<br />
<br />
const indicators = journalRecordManager?.data?.indicators<br />
<br />
const notFoundIndicators = getNotFoundIndicators(indicators)<br />
if (hasNotFoundIndicators(notFoundIndicators)) { <br />
errorHandlers.notFoundIndicators(notFoundIndicators, journalRecordManager.journalRecordId)<br />
}<br />
<br />
const emptyIndicatorProps = getNotFilledResultsFields(indicators)<br />
if (hasNotFilledProps(emptyIndicatorProps)) {<br />
errorHandlers.notFilledIndicatorProps(emptyIndicatorProps)<br />
}<br />
<br />
showSuccessMessage(messages.success, socketId)<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка заполненности атрибутов записи ЛЖ. <code>check-record-fields-filled</code> ==<br />
[[Файл:Check-record-fields-filled.png|frame]]<br />
Проверяет заполненность заданных полей в записи журнала (например, "Источник", "Место отбора", "Дата регистрации" и др.). Если какое-либо из обязательных полей не заполнено, выдаётся соответствующая ошибка.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { DialogType } from "@triteia/types-integration-gui"<br />
import { IJournalRecordManager } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
<br />
const config = {<br />
requiredFields: [<br />
'Источник',<br />
'Список. Целое число',<br />
'Строка',<br />
'Целое число',<br />
'Вещественное число',<br />
'Логический тип',<br />
'Дата',<br />
'Время',<br />
],<br />
journalRecordId: 144, // Мк / Тест_Ушакова<br />
integrationResult: { message: 'Все поля заполнены!' }<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: 'Все необходимые поля заполнены!',<br />
emptyFieldsError: (fields, recordId) => `Поля ${fields.map(f => `"${f}"`).join(', ')} не заполнены в записи с ID ${recordId}`,<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
fieldsError: (emptyFields, recordId) => {<br />
throw new Error(messages.emptyFieldsError(emptyFields, recordId))<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const isEmptyArray = (arr: unknown[]) => {<br />
return arr.length === 0<br />
}<br />
<br />
const getNotFilledFields = (fields: string[], journalRecordsManager: IJournalRecordManager) => {<br />
console.log(journalRecordsManager.data.attributes, 'data.attributes')<br />
return fields.filter(f => !journalRecordsManager.getFieldValue(f))<br />
}<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
const emptyFields = getNotFilledFields(config.requiredFields, journalRecordManager)<br />
<br />
if (isEmptyArray(emptyFields)) {<br />
showSuccessMessage(messages.success, socketId)<br />
return config.integrationResult<br />
} else errorHandlers.fieldsError(emptyFields, config.journalRecordId)<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка движения пробы. <code>check-sample-moving</code> ==<br />
[[Файл:Check-sample-moving.png|frame]]<br />
Проверяет маршрут движения пробы по этапам. Получает историю перемещений записи и определяет, происходило ли движение (нахождение более чем на одном этапе). Отображает маршрут или сообщает, что движение не происходило.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { JournalsRecordRouteController } from "../../src/servivces/worker/api/controllers/journals-record-route"<br />
import { apiInstance } from "../../src/servivces/worker/api/interactors/ApiInstance"<br />
import type { DialogType } from "@triteia/types-integration-gui"<br />
import type { JournalRecordRouteDto } from "../../src/servivces/worker/api/controllers/journal-records"<br />
<br />
const config = {<br />
journalRecordId: 114 // Лаб. воздуха / Анализы завершены<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
route: (routes: JournalRecordRouteDto[], recordId: number) => `Машрут пробы: ${routes.map(r => `"${r.stageName}"`).join(' -> ')}. Id записи ЛЖ: ${recordId}`, <br />
notMoved: (recordId: number) => `Движение пробы не происходило. Id записи ЛЖ: ${recordId}`, <br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const isSampleMoved = (moves: JournalRecordRouteDto[]) => {<br />
return Array.isArray(moves) && moves.length > 1<br />
}<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalsRecordRouteController = new JournalsRecordRouteController(apiInstance)<br />
const sampleMoves = await journalsRecordRouteController.getJournalRecordRoute(config.journalRecordId)<br />
<br />
if (isSampleMoved(sampleMoves)) {<br />
showSuccessMessage(messages.route(sampleMoves, config.journalRecordId), socketId)<br />
} else {<br />
showSuccessMessage(messages.notMoved(config.journalRecordId), socketId)<br />
}<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка прав пользователя. <code>check-user-rights</code> ==<br />
[[Файл:Check-user-rights.png|frame]]<br />
Проверяет права доступа пользователя к определённым ресурсам (объекты анализа, методики, записи ЛЖ). Отображает таблицу с типами доступа (чтение, запись и т.д.) и наличием прав по каждому ресурсу.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { apiInstance } from "../../src/servivces/worker/api/interactors/ApiInstance"<br />
import { <br />
PermissionController, <br />
PermissionResource, <br />
PermissionRwAccess<br />
} from "../../src/servivces/worker/api/controllers/permisson"<br />
<br />
import { TableBuilder } from "../../src/gui/builder"<br />
import type { DialogType, TableConfig } from "@triteia/types-integration-gui"<br />
import type { JournalRecordRouteDto } from "../../src/servivces/worker/api/controllers/journal-records"<br />
<br />
const accessNamesMap = {<br />
[PermissionRwAccess.EXEC]: 'Выполнение',<br />
[PermissionRwAccess.READ]: 'Чтение',<br />
[PermissionRwAccess.WRITE]: 'Запись',<br />
}<br />
<br />
const requiredResources = [<br />
PermissionResource.ANALYSIS_OBJECT, <br />
PermissionResource.METHODOLOGY,<br />
PermissionResource.JOURNAL_RECORD<br />
]<br />
<br />
const resourcesNamesMap = {<br />
[PermissionResource.ANALYSIS_OBJECT]: 'Объекты анализа', <br />
[PermissionResource.METHODOLOGY]: 'Методики', <br />
[PermissionResource.JOURNAL_RECORD]: 'Записи ЛЖ'<br />
}<br />
<br />
const getAccessRightsTable = async (tableBuilder: TableBuilder, permissionController: PermissionController): Promise<TableConfig> => {<br />
const rows = (await Promise.all(requiredResources.map(async (source: PermissionResource) => {<br />
const sourceCombinations = await Promise.all(Object.keys(PermissionRwAccess).map(async (action) => {<br />
const access = await permissionController.getSourcePermission(source, PermissionRwAccess[action])<br />
return { source: resourcesNamesMap[source], action: accessNamesMap[PermissionRwAccess[action]], access: access.hasPermission }<br />
}))<br />
return sourceCombinations<br />
} <br />
))).flat()<br />
const table = tableBuilder<br />
.name('simpleTable')<br />
.label('Таблица')<br />
.isAddable(false)<br />
.actionsCol(false)<br />
.addColumn('Ресурс', 'source', false)<br />
.config('input', { name: 'source', rules: [{ required: true }] }, { placeholder: '', disabled: false })<br />
.next()<br />
.addColumn('Тип доступа', 'action', false)<br />
.config('input', { name: 'action' }, { type: 'string', placeholder: '', disabled: false })<br />
.next()<br />
.addColumn('Доступ', 'access', false)<br />
.config('checkbox', { name: 'access' }, { type: 'boolean', placeholder: '', disabled: false })<br />
.next()<br />
.setRows(rows)<br />
.build();<br />
return table<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
route: (routes: JournalRecordRouteDto[], recordId: number) => `Маршрут пробы: ${routes.map(r => `"${r.stageName}"`).join(' -> ')}. Id записи ЛЖ: ${recordId}`, <br />
notMoved: (recordId: number) => `Движение пробы не происходило. Id записи ЛЖ: ${recordId}`, <br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
<br />
const showTable = async (builder: TableBuilder, controller: PermissionController, socketId: string) => <br />
await getDataFromDialog({ type: 'input-data', config: [await getAccessRightsTable(builder, controller)] }, socketId)<br />
<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
try {<br />
await showTable(new TableBuilder, new PermissionController(apiInstance), socketId)<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Заполнение атрибутов записи ЛЖ. <code>fill-record-fields</code> ==<br />
[[Файл:Fill-record-fields.png|frame]]<br />
Автоматически заполняет заданные поля в записи журнала (например, даты, место отбора, шифр пробы и др.). Есть возможность использования ключевых слов для сопоставления полей, если точные названия не совпадают.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { DialogType } from "@triteia/types-integration-gui"<br />
import { IJournalRecordManager } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
import { JournalRecordAttributeFieldResponse } from "../../src/servivces/worker/api/controllers/lj-eav-attribute-fields"<br />
import { FieldMatch } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
<br />
const date = new Date().toISOString().split('T')[0]<br />
const config = {<br />
requiredFields: [<br />
{ name: 'Дата регистрации', value: date, keywords: ['дат', 'регистр'] },<br />
{ name: 'Место отбора', value: 'Скважина 516563Г ', keywords: ['мест', 'отбор'] },<br />
{ name: 'Дата отбора', value: date, keywords: ['дат', 'отбор'] },<br />
{ name: 'Шифр пробы', value: 'shifr 123', keywords: ['дат', 'регистр']},<br />
{ name: 'Список. Целое число', value: 666, keywords: ['спис', 'цел', 'числ'] },<br />
{ name: 'Помещение', value: 'помещение', keywords: ['помещ']},<br />
] as FieldMatch[],<br />
journalRecordId: 118, // Мк / 111<br />
integrationResult: { message: 'Все поля заполнены!' }<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: (recordId) => `Все необходимые поля заполнены! Id записи: ${recordId}`,<br />
emptyFieldsError: (fields, recordId) => `Поля ${fields.map(f => `"${f}"`).join(', ')} не заполнены в записи с ID ${recordId}`,<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const fieldsMatcher = (field: JournalRecordAttributeFieldResponse, searchField: FieldMatch) => {<br />
return searchField.keywords.every(k => String(field.name).toLocaleLowerCase().includes(k.toLocaleLowerCase()))<br />
}<br />
<br />
const fillFields = async (fields: FieldMatch[], journalRecordsManager: IJournalRecordManager) => {<br />
await journalRecordsManager.setFieldsValues(fields, journalRecordsManager, fieldsMatcher)<br />
}<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
await fillFields(config.requiredFields, journalRecordManager)<br />
showSuccessMessage(messages.success(journalRecordManager.journalRecordId), socketId)<br />
return config.integrationResult<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Деление данных. <code>copy-journal-record</code> ==<br />
[[Файл:Copy-journal-record.png|frame]]<br />
Создаёт копию записи журнала на заданном этапе маршрута. Выводит сообщение с ID новой записи.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { JournalRecordsController } from "../../src/servivces/worker/api/controllers/journal-records"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { apiInstance } from "../../src/servivces/worker/api/interactors/ApiInstance"<br />
import type { DialogType } from "@triteia/types-integration-gui"<br />
import type { JournalRecordRequest, JournalRecordResponse } from "../../src/servivces/worker/api/controllers/journal-records"<br />
import type { JournalRecordAttributeResponse } from "../../src/servivces/worker/api/controllers/journal-records"<br />
<br />
type DataType = JournalRecordAttributeResponse['field']['dataType']<br />
<br />
const config = {<br />
journalRecordId: 208, // Лаб. воздуха / Регистрация<br />
nextJournalRecordStage: 2, // Лаб. воздуха / Анализ<br />
nextStageName: 'Анализ',<br />
nextRouteId: 50,<br />
integrationResult: { message: 'Запись ЛЖ скопирована успешно!' }<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: 'Все необходимые поля заполнены!',<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const getDateString = (ISODate: unknown | null = null) => {<br />
return new Date(String(ISODate)).toISOString().split('T')[0]<br />
}<br />
<br />
const getTimeString = (ISODate: unknown | null = null) => {<br />
return new Date(String(ISODate)).toISOString().split('T')[1].split('.')[0]<br />
}<br />
<br />
const createRecord = async (journalRecordController: JournalRecordsController, baseRecord: JournalRecordResponse, newStageId) => {<br />
const getAttrValue = (value: unknown, dataType: DataType) => {<br />
if (dataType === "DATE") return getDateString(value)<br />
if (dataType === "TIME") return getTimeString(value)<br />
return value<br />
}<br />
<br />
const getBindings = (baseRecord: JournalRecordResponse): number[] | null => {<br />
return baseRecord?.companyLevelBindings?.map(b => b?.id) || null<br />
} <br />
<br />
const getRecordRequest = (baseRecord: JournalRecordResponse, newStageId: number): JournalRecordRequest => {<br />
return {<br />
routeId: baseRecord?.route?.id,<br />
stageId: newStageId,<br />
analysisObjectId: baseRecord?.analysisObject?.id,<br />
sampleTypeId: baseRecord.sampleType.id,<br />
attributes: baseRecord.attributes.map(attr => {<br />
return {<br />
fieldId: attr.field.id,<br />
stageId: newStageId,<br />
data: {<br />
...attr.data, <br />
value: getAttrValue(attr?.data?.value, attr?.field?.dataType),<br />
id: undefined<br />
},<br />
statusId: null<br />
}<br />
}),<br />
companyLevelBindings: getBindings(baseRecord)<br />
}<br />
}<br />
return await journalRecordController.createRecord(getRecordRequest(baseRecord, newStageId))<br />
}<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
const journalRecordController = new JournalRecordsController(apiInstance)<br />
const newRecord = await createRecord(journalRecordController, journalRecordManager.data, config.nextJournalRecordStage)<br />
showSuccessMessage(`${messages.success}. Id изначальной записи: ${config.journalRecordId}. Id новой записи ЛЖ: ${newRecord.id}. Этап: ${config.nextStageName}`, socketId)<br />
return config.integrationResult<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
</div><br />
</div></div>
Arhidiman
https://wiki.chemsoft.ru/index.php?title=%D0%90%D0%B4%D0%B4%D0%BE%D0%BD%D1%8B&diff=2371
Аддоны
2026-04-02T01:38:40Z
<p>Arhidiman: /* Заполнение атрибутов записи ЛЖ. fill-record-fields */</p>
<hr />
<div>Список демонстрационных аддонов, показывающих возможности интеграционного сервиса.<br />
<br />
== Проверка даты регистрации. <code>check-registration-date</code> ==<br />
[[Файл:check-registration-date.png|frame]]<br />
Проверяет, не истёк ли срок регистрации пробы. Сравнивает дату регистрации из указанного поля с текущей датой. Если прошло более заданного количества дней (по умолчанию — 10), выдаёт ошибку. В противном случае показывает сообщение об успешной проверке.<br />
<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { MessageBoxResults } from "@triteia/types-integration-gui"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { DialogType } from "@triteia/types-integration-gui"<br />
<br />
const config = {<br />
dateField: 'Дата регистрации',<br />
expirationLimit: 10,<br />
journalRecordId: 201, // Лаб. воздуха / Анализы завершены<br />
integrationResult: { message: 'Срок регистрации пробы не истёк !'}<br />
}<br />
<br />
const messages = {<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
success: (recordId) => `Срок регистрации пробы не истёк ! Id записи ${recordId}`,<br />
expired: (limit, recordId) => `Срок регистрации пробы истёк!\nПрошло более ${ limit } дней с момента регистрации. Id записи: ${recordId}`,<br />
dateField: (dateField, stageName, journalRecordId) => [<br />
`Не заполнено либо отсутствует поле "${dateField}"`,<br />
`в этапе "${stageName || ''}".\nId записи: ${journalRecordId}`<br />
].join(' ')<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
},<br />
dateError: (dateField, stageName, journalRecordId) => {<br />
throw new Error(messages.dateField(dateField, stageName, journalRecordId))<br />
},<br />
expirationError: () => {<br />
throw new Error(messages.expired(config.expirationLimit, config.journalRecordId))<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const getDaysByDate = (date: Date) => {<br />
const dayMs = 60 * 60 * 24 * 1000<br />
const timestamp = date.getTime()<br />
return timestamp/dayMs<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getExpirationOffset = (registrationDate: string) => {<br />
const regDate = new Date(registrationDate)<br />
const today = new Date()<br />
return getDaysByDate(today) - getDaysByDate(regDate)<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
async function main({ queryParams }) {<br />
<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
const date = journalRecordManager.getFieldValue(config.dateField)<br />
<br />
if (!date) errorHandlers.dateError(config.dateField, journalRecordManager?.data?.stage?.stage?.name, config.journalRecordId)<br />
<br />
const expirationOffset = getExpirationOffset(date as string)<br />
<br />
if (expirationOffset >= config.expirationLimit) errorHandlers.expirationError()<br />
<br />
await showSuccessMessage(messages.success(config.journalRecordId), socketId)<br />
<br />
return config.integrationResult<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка заполненности полей показателей. <code>check-indicator-fields-filled</code> ==<br />
[[Файл:Check-indicator-fields-filled.png|frame]]<br />
Проверяет заполненность полей показателей в записи журнала по настраиваемому списку. Проверяет наличие определённых показателей (например, "Аммоний-ион") и заполненность у них таких полей, как исполнители, методики, средний результат и др. Выдаёт ошибку, если показатели отсутствуют или не все поля заполнены.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import type { DialogType } from "@triteia/types-integration-gui"<br />
import type { JournalRecordIndicatorResponse } from "../../src/servivces/worker/api/controllers/journal-records"<br />
import type { IJournalRecordManager } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
<br />
type IndicatorProp = { label: string, get: () => unknown }<br />
type IndicatorPropsConfig = Record<string, IndicatorProp><br />
<br />
const indicatorPropsConfig = (indicator): IndicatorPropsConfig => {<br />
return {<br />
executors: {<br />
label: 'Исполнители', <br />
get: () => indicator?.result?.executors<br />
},<br />
methodic: {<br />
label: 'Методики', <br />
get: () => indicator?.methodics<br />
},<br />
averageResult: {<br />
label: 'Средний результат', <br />
get: () => indicator?.result?.averageValue<br />
},<br />
averageRoundedValue: {<br />
label: 'Средний округлённый результат', <br />
get: () => indicator?.result?.averageRoundedValue<br />
}<br />
}<br />
}<br />
<br />
const config = {<br />
requiredFields: [<br />
'Источник',<br />
'Место отбора',<br />
'Дата регистрации',<br />
'Шифр пробы',<br />
'Время регистрации'<br />
],<br />
indicatorsList: [<br />
'Аммоний-ион'<br />
],<br />
journalRecordId: 144, // Мк / Тест_Ушакова<br />
integrationResult: { message: 'Все поля заполнены!' }<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: 'Все необходимые поля заполнены!',<br />
emptyIndicators: (recordId) => `в записи с Id ${recordId} отсутствуют показатели`,<br />
emptyFieldsError: (fields, recordId) => `Поля ${fields.map(f => `"${f}"`).join(', ')} не заполнены в записи с ID ${recordId}`,<br />
indicators: (indicators: string[], recordId) => `Показатели ${indicators.map(f => `"${f}"`).join(', ')} отсутствуют в записи с ID ${recordId}`,<br />
emptyIndicatorsProps: (props: Record<string, string[]>, recordId) => {<br />
const propsString = Object.keys(props).map(prop => !isEmptyArray(props[prop]) ? `${prop}: ${props[prop].map(p => `"${p}"`).join(', ')}` : '').join('; ')<br />
return `В записи с Id ${recordId} отсутствуют либо не заполнены следующие поля у показателей: ${propsString}`<br />
}<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
fieldsError: (emptyFields, recordId) => {<br />
throw new Error(messages.emptyFieldsError(emptyFields, recordId))<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
},<br />
indicatorsError: (recordId) =>{<br />
throw new Error(messages.emptyIndicators(recordId))<br />
},<br />
notFoundIndicators: (indicators: string[], recordId: number) => {<br />
throw new Error(messages.indicators(indicators, recordId))<br />
},<br />
notFilledIndicatorProps: (props: Record<string, string[]>) => {<br />
throw new Error(messages.emptyIndicatorsProps(props, config.journalRecordId))<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const isEmptyArray = (arr: unknown[]) => {<br />
return Array.isArray(arr) && arr.length === 0<br />
}<br />
<br />
const hasIndicators = (journalRecordManager: IJournalRecordManager) => {<br />
const indicators = journalRecordManager?.data?.indicators<br />
return Array.isArray(indicators) && indicators.length > 0<br />
}<br />
<br />
const getNotFoundIndicators = (indicators: JournalRecordIndicatorResponse[], indicatorsList = config.indicatorsList) => {<br />
return indicatorsList.filter(ind => indicators.every(ljInd => ljInd?.indicator?.name?.toLowerCase() !== ind.toLocaleLowerCase()))<br />
} <br />
<br />
const getNotFilledResultsFields = (indicators: JournalRecordIndicatorResponse[]): Record<string, string[]> => {<br />
return indicators.reduce((acc, indicator) => {<br />
const config = indicatorPropsConfig(indicator)<br />
return {<br />
...acc,<br />
[indicator?.indicator?.name]: Object.keys(config).reduce((acc, prop) => {<br />
if (!config[prop].get()) return [...acc, config[prop].label]<br />
return acc<br />
}, [] as string[])<br />
}<br />
}, {}) as Record<string, string[]><br />
}<br />
<br />
const hasNotFilledProps = (indicatorsProps: Record<string, string[]>) => {<br />
return Object.keys(indicatorsProps).some(indicator => !isEmptyArray(indicatorsProps[indicator]))<br />
}<br />
<br />
const hasNotFoundIndicators = (indicators: string[]) => !isEmptyArray(indicators)<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
<br />
if (!hasIndicators(journalRecordManager)) {<br />
errorHandlers.indicatorsError(journalRecordManager.journalRecordId)<br />
}<br />
<br />
const indicators = journalRecordManager?.data?.indicators<br />
<br />
const notFoundIndicators = getNotFoundIndicators(indicators)<br />
if (hasNotFoundIndicators(notFoundIndicators)) { <br />
errorHandlers.notFoundIndicators(notFoundIndicators, journalRecordManager.journalRecordId)<br />
}<br />
<br />
const emptyIndicatorProps = getNotFilledResultsFields(indicators)<br />
if (hasNotFilledProps(emptyIndicatorProps)) {<br />
errorHandlers.notFilledIndicatorProps(emptyIndicatorProps)<br />
}<br />
<br />
showSuccessMessage(messages.success, socketId)<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка заполненности атрибутов записи ЛЖ. <code>check-record-fields-filled</code> ==<br />
[[Файл:Check-record-fields-filled.png|frame]]<br />
Проверяет заполненность заданных полей в записи журнала (например, "Источник", "Место отбора", "Дата регистрации" и др.). Если какое-либо из обязательных полей не заполнено, выдаётся соответствующая ошибка.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { DialogType } from "@triteia/types-integration-gui"<br />
import { IJournalRecordManager } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
<br />
const config = {<br />
requiredFields: [<br />
'Источник',<br />
'Список. Целое число',<br />
'Строка',<br />
'Целое число',<br />
'Вещественное число',<br />
'Логический тип',<br />
'Дата',<br />
'Время',<br />
],<br />
journalRecordId: 144, // Мк / Тест_Ушакова<br />
integrationResult: { message: 'Все поля заполнены!' }<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: 'Все необходимые поля заполнены!',<br />
emptyFieldsError: (fields, recordId) => `Поля ${fields.map(f => `"${f}"`).join(', ')} не заполнены в записи с ID ${recordId}`,<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
fieldsError: (emptyFields, recordId) => {<br />
throw new Error(messages.emptyFieldsError(emptyFields, recordId))<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const isEmptyArray = (arr: unknown[]) => {<br />
return arr.length === 0<br />
}<br />
<br />
const getNotFilledFields = (fields: string[], journalRecordsManager: IJournalRecordManager) => {<br />
console.log(journalRecordsManager.data.attributes, 'data.attributes')<br />
return fields.filter(f => !journalRecordsManager.getFieldValue(f))<br />
}<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
const emptyFields = getNotFilledFields(config.requiredFields, journalRecordManager)<br />
<br />
if (isEmptyArray(emptyFields)) {<br />
showSuccessMessage(messages.success, socketId)<br />
return config.integrationResult<br />
} else errorHandlers.fieldsError(emptyFields, config.journalRecordId)<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка движения пробы. <code>check-sample-moving</code> ==<br />
[[Файл:Check-sample-moving.png|frame]]<br />
Проверяет маршрут движения пробы по этапам. Получает историю перемещений записи и определяет, происходило ли движение (нахождение более чем на одном этапе). Отображает маршрут или сообщает, что движение не происходило.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { JournalsRecordRouteController } from "../../src/servivces/worker/api/controllers/journals-record-route"<br />
import { apiInstance } from "../../src/servivces/worker/api/interactors/ApiInstance"<br />
import type { DialogType } from "@triteia/types-integration-gui"<br />
import type { JournalRecordRouteDto } from "../../src/servivces/worker/api/controllers/journal-records"<br />
<br />
const config = {<br />
journalRecordId: 114 // Лаб. воздуха / Анализы завершены<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
route: (routes: JournalRecordRouteDto[], recordId: number) => `Машрут пробы: ${routes.map(r => `"${r.stageName}"`).join(' -> ')}. Id записи ЛЖ: ${recordId}`, <br />
notMoved: (recordId: number) => `Движение пробы не происходило. Id записи ЛЖ: ${recordId}`, <br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const isSampleMoved = (moves: JournalRecordRouteDto[]) => {<br />
return Array.isArray(moves) && moves.length > 1<br />
}<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalsRecordRouteController = new JournalsRecordRouteController(apiInstance)<br />
const sampleMoves = await journalsRecordRouteController.getJournalRecordRoute(config.journalRecordId)<br />
<br />
if (isSampleMoved(sampleMoves)) {<br />
showSuccessMessage(messages.route(sampleMoves, config.journalRecordId), socketId)<br />
} else {<br />
showSuccessMessage(messages.notMoved(config.journalRecordId), socketId)<br />
}<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка прав пользователя. <code>check-user-rights</code> ==<br />
[[Файл:Check-user-rights.png|frame]]<br />
Проверяет права доступа пользователя к определённым ресурсам (объекты анализа, методики, записи ЛЖ). Отображает таблицу с типами доступа (чтение, запись и т.д.) и наличием прав по каждому ресурсу.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { apiInstance } from "../../src/servivces/worker/api/interactors/ApiInstance"<br />
import { <br />
PermissionController, <br />
PermissionResource, <br />
PermissionRwAccess<br />
} from "../../src/servivces/worker/api/controllers/permisson"<br />
<br />
import { TableBuilder } from "../../src/gui/builder"<br />
import type { DialogType, TableConfig } from "@triteia/types-integration-gui"<br />
import type { JournalRecordRouteDto } from "../../src/servivces/worker/api/controllers/journal-records"<br />
<br />
const accessNamesMap = {<br />
[PermissionRwAccess.EXEC]: 'Выполнение',<br />
[PermissionRwAccess.READ]: 'Чтение',<br />
[PermissionRwAccess.WRITE]: 'Запись',<br />
}<br />
<br />
const requiredResources = [<br />
PermissionResource.ANALYSIS_OBJECT, <br />
PermissionResource.METHODOLOGY,<br />
PermissionResource.JOURNAL_RECORD<br />
]<br />
<br />
const resourcesNamesMap = {<br />
[PermissionResource.ANALYSIS_OBJECT]: 'Объекты анализа', <br />
[PermissionResource.METHODOLOGY]: 'Методики', <br />
[PermissionResource.JOURNAL_RECORD]: 'Записи ЛЖ'<br />
}<br />
<br />
const getAccessRightsTable = async (tableBuilder: TableBuilder, permissionController: PermissionController): Promise<TableConfig> => {<br />
const rows = (await Promise.all(requiredResources.map(async (source: PermissionResource) => {<br />
const sourceCombinations = await Promise.all(Object.keys(PermissionRwAccess).map(async (action) => {<br />
const access = await permissionController.getSourcePermission(source, PermissionRwAccess[action])<br />
return { source: resourcesNamesMap[source], action: accessNamesMap[PermissionRwAccess[action]], access: access.hasPermission }<br />
}))<br />
return sourceCombinations<br />
} <br />
))).flat()<br />
const table = tableBuilder<br />
.name('simpleTable')<br />
.label('Таблица')<br />
.isAddable(false)<br />
.actionsCol(false)<br />
.addColumn('Ресурс', 'source', false)<br />
.config('input', { name: 'source', rules: [{ required: true }] }, { placeholder: '', disabled: false })<br />
.next()<br />
.addColumn('Тип доступа', 'action', false)<br />
.config('input', { name: 'action' }, { type: 'string', placeholder: '', disabled: false })<br />
.next()<br />
.addColumn('Доступ', 'access', false)<br />
.config('checkbox', { name: 'access' }, { type: 'boolean', placeholder: '', disabled: false })<br />
.next()<br />
.setRows(rows)<br />
.build();<br />
return table<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
route: (routes: JournalRecordRouteDto[], recordId: number) => `Маршрут пробы: ${routes.map(r => `"${r.stageName}"`).join(' -> ')}. Id записи ЛЖ: ${recordId}`, <br />
notMoved: (recordId: number) => `Движение пробы не происходило. Id записи ЛЖ: ${recordId}`, <br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
<br />
const showTable = async (builder: TableBuilder, controller: PermissionController, socketId: string) => <br />
await getDataFromDialog({ type: 'input-data', config: [await getAccessRightsTable(builder, controller)] }, socketId)<br />
<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
try {<br />
await showTable(new TableBuilder, new PermissionController(apiInstance), socketId)<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Заполнение атрибутов записи ЛЖ. <code>fill-record-fields</code> ==<br />
[[Файл:Fill-record-fields.png|frame]]<br />
Автоматически заполняет заданные поля в записи журнала (например, даты, место отбора, шифр пробы и др.). Есть возможность использования ключевых слов для сопоставления полей, если точные названия не совпадают.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { DialogType } from "@triteia/types-integration-gui"<br />
import { IJournalRecordManager } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
import { JournalRecordAttributeFieldResponse } from "../../src/servivces/worker/api/controllers/lj-eav-attribute-fields"<br />
import { FieldMatch } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
<br />
const date = new Date().toISOString().split('T')[0]<br />
const config = {<br />
requiredFields: [<br />
{ name: 'Дата регистрации', value: date, keywords: ['дат', 'регистр'] },<br />
{ name: 'Место отбора', value: 'Скважина 516563Г ', keywords: ['мест', 'отбор'] },<br />
{ name: 'Дата отбора', value: date, keywords: ['дат', 'отбор'] },<br />
{ name: 'Шифр пробы', value: 'shifr 123', keywords: ['дат', 'регистр']},<br />
{ name: 'Список. Целое число', value: 666, keywords: ['спис', 'цел', 'числ'] },<br />
{ name: 'Помещение', value: 'помещение', keywords: ['помещ']},<br />
] as FieldMatch[],<br />
journalRecordId: 118, // Мк / 111<br />
integrationResult: { message: 'Все поля заполнены!' }<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: (recordId) => `Все необходимые поля заполнены! Id записи: ${recordId}`,<br />
emptyFieldsError: (fields, recordId) => `Поля ${fields.map(f => `"${f}"`).join(', ')} не заполнены в записи с ID ${recordId}`,<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const fieldsMatcher = (field: JournalRecordAttributeFieldResponse, searchField: FieldMatch) => {<br />
return searchField.keywords.every(k => String(field.name).toLocaleLowerCase().includes(k.toLocaleLowerCase()))<br />
}<br />
<br />
const fillFields = async (fields: FieldMatch[], journalRecordsManager: IJournalRecordManager) => {<br />
await journalRecordsManager.setFieldsValues(fields, journalRecordsManager, fieldsMatcher)<br />
}<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
await fillFields(config.requiredFields, journalRecordManager)<br />
showSuccessMessage(messages.success(journalRecordManager.journalRecordId), socketId)<br />
return config.integrationResult<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Деление данных. <code>copy-journal-record</code> ==<br />
[[Файл:Copy-journal-record.png|frame]]<br />
Создаёт копию записи журнала на заданном этапе маршрута. Выводит сообщение с ID новой записи.</div>
Arhidiman
https://wiki.chemsoft.ru/index.php?title=%D0%90%D0%B4%D0%B4%D0%BE%D0%BD%D1%8B&diff=2370
Аддоны
2026-04-02T01:38:03Z
<p>Arhidiman: /* Проверка прав пользователя. check-user-rights */</p>
<hr />
<div>Список демонстрационных аддонов, показывающих возможности интеграционного сервиса.<br />
<br />
== Проверка даты регистрации. <code>check-registration-date</code> ==<br />
[[Файл:check-registration-date.png|frame]]<br />
Проверяет, не истёк ли срок регистрации пробы. Сравнивает дату регистрации из указанного поля с текущей датой. Если прошло более заданного количества дней (по умолчанию — 10), выдаёт ошибку. В противном случае показывает сообщение об успешной проверке.<br />
<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { MessageBoxResults } from "@triteia/types-integration-gui"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { DialogType } from "@triteia/types-integration-gui"<br />
<br />
const config = {<br />
dateField: 'Дата регистрации',<br />
expirationLimit: 10,<br />
journalRecordId: 201, // Лаб. воздуха / Анализы завершены<br />
integrationResult: { message: 'Срок регистрации пробы не истёк !'}<br />
}<br />
<br />
const messages = {<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
success: (recordId) => `Срок регистрации пробы не истёк ! Id записи ${recordId}`,<br />
expired: (limit, recordId) => `Срок регистрации пробы истёк!\nПрошло более ${ limit } дней с момента регистрации. Id записи: ${recordId}`,<br />
dateField: (dateField, stageName, journalRecordId) => [<br />
`Не заполнено либо отсутствует поле "${dateField}"`,<br />
`в этапе "${stageName || ''}".\nId записи: ${journalRecordId}`<br />
].join(' ')<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
},<br />
dateError: (dateField, stageName, journalRecordId) => {<br />
throw new Error(messages.dateField(dateField, stageName, journalRecordId))<br />
},<br />
expirationError: () => {<br />
throw new Error(messages.expired(config.expirationLimit, config.journalRecordId))<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const getDaysByDate = (date: Date) => {<br />
const dayMs = 60 * 60 * 24 * 1000<br />
const timestamp = date.getTime()<br />
return timestamp/dayMs<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getExpirationOffset = (registrationDate: string) => {<br />
const regDate = new Date(registrationDate)<br />
const today = new Date()<br />
return getDaysByDate(today) - getDaysByDate(regDate)<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
async function main({ queryParams }) {<br />
<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
const date = journalRecordManager.getFieldValue(config.dateField)<br />
<br />
if (!date) errorHandlers.dateError(config.dateField, journalRecordManager?.data?.stage?.stage?.name, config.journalRecordId)<br />
<br />
const expirationOffset = getExpirationOffset(date as string)<br />
<br />
if (expirationOffset >= config.expirationLimit) errorHandlers.expirationError()<br />
<br />
await showSuccessMessage(messages.success(config.journalRecordId), socketId)<br />
<br />
return config.integrationResult<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка заполненности полей показателей. <code>check-indicator-fields-filled</code> ==<br />
[[Файл:Check-indicator-fields-filled.png|frame]]<br />
Проверяет заполненность полей показателей в записи журнала по настраиваемому списку. Проверяет наличие определённых показателей (например, "Аммоний-ион") и заполненность у них таких полей, как исполнители, методики, средний результат и др. Выдаёт ошибку, если показатели отсутствуют или не все поля заполнены.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import type { DialogType } from "@triteia/types-integration-gui"<br />
import type { JournalRecordIndicatorResponse } from "../../src/servivces/worker/api/controllers/journal-records"<br />
import type { IJournalRecordManager } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
<br />
type IndicatorProp = { label: string, get: () => unknown }<br />
type IndicatorPropsConfig = Record<string, IndicatorProp><br />
<br />
const indicatorPropsConfig = (indicator): IndicatorPropsConfig => {<br />
return {<br />
executors: {<br />
label: 'Исполнители', <br />
get: () => indicator?.result?.executors<br />
},<br />
methodic: {<br />
label: 'Методики', <br />
get: () => indicator?.methodics<br />
},<br />
averageResult: {<br />
label: 'Средний результат', <br />
get: () => indicator?.result?.averageValue<br />
},<br />
averageRoundedValue: {<br />
label: 'Средний округлённый результат', <br />
get: () => indicator?.result?.averageRoundedValue<br />
}<br />
}<br />
}<br />
<br />
const config = {<br />
requiredFields: [<br />
'Источник',<br />
'Место отбора',<br />
'Дата регистрации',<br />
'Шифр пробы',<br />
'Время регистрации'<br />
],<br />
indicatorsList: [<br />
'Аммоний-ион'<br />
],<br />
journalRecordId: 144, // Мк / Тест_Ушакова<br />
integrationResult: { message: 'Все поля заполнены!' }<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: 'Все необходимые поля заполнены!',<br />
emptyIndicators: (recordId) => `в записи с Id ${recordId} отсутствуют показатели`,<br />
emptyFieldsError: (fields, recordId) => `Поля ${fields.map(f => `"${f}"`).join(', ')} не заполнены в записи с ID ${recordId}`,<br />
indicators: (indicators: string[], recordId) => `Показатели ${indicators.map(f => `"${f}"`).join(', ')} отсутствуют в записи с ID ${recordId}`,<br />
emptyIndicatorsProps: (props: Record<string, string[]>, recordId) => {<br />
const propsString = Object.keys(props).map(prop => !isEmptyArray(props[prop]) ? `${prop}: ${props[prop].map(p => `"${p}"`).join(', ')}` : '').join('; ')<br />
return `В записи с Id ${recordId} отсутствуют либо не заполнены следующие поля у показателей: ${propsString}`<br />
}<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
fieldsError: (emptyFields, recordId) => {<br />
throw new Error(messages.emptyFieldsError(emptyFields, recordId))<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
},<br />
indicatorsError: (recordId) =>{<br />
throw new Error(messages.emptyIndicators(recordId))<br />
},<br />
notFoundIndicators: (indicators: string[], recordId: number) => {<br />
throw new Error(messages.indicators(indicators, recordId))<br />
},<br />
notFilledIndicatorProps: (props: Record<string, string[]>) => {<br />
throw new Error(messages.emptyIndicatorsProps(props, config.journalRecordId))<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const isEmptyArray = (arr: unknown[]) => {<br />
return Array.isArray(arr) && arr.length === 0<br />
}<br />
<br />
const hasIndicators = (journalRecordManager: IJournalRecordManager) => {<br />
const indicators = journalRecordManager?.data?.indicators<br />
return Array.isArray(indicators) && indicators.length > 0<br />
}<br />
<br />
const getNotFoundIndicators = (indicators: JournalRecordIndicatorResponse[], indicatorsList = config.indicatorsList) => {<br />
return indicatorsList.filter(ind => indicators.every(ljInd => ljInd?.indicator?.name?.toLowerCase() !== ind.toLocaleLowerCase()))<br />
} <br />
<br />
const getNotFilledResultsFields = (indicators: JournalRecordIndicatorResponse[]): Record<string, string[]> => {<br />
return indicators.reduce((acc, indicator) => {<br />
const config = indicatorPropsConfig(indicator)<br />
return {<br />
...acc,<br />
[indicator?.indicator?.name]: Object.keys(config).reduce((acc, prop) => {<br />
if (!config[prop].get()) return [...acc, config[prop].label]<br />
return acc<br />
}, [] as string[])<br />
}<br />
}, {}) as Record<string, string[]><br />
}<br />
<br />
const hasNotFilledProps = (indicatorsProps: Record<string, string[]>) => {<br />
return Object.keys(indicatorsProps).some(indicator => !isEmptyArray(indicatorsProps[indicator]))<br />
}<br />
<br />
const hasNotFoundIndicators = (indicators: string[]) => !isEmptyArray(indicators)<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
<br />
if (!hasIndicators(journalRecordManager)) {<br />
errorHandlers.indicatorsError(journalRecordManager.journalRecordId)<br />
}<br />
<br />
const indicators = journalRecordManager?.data?.indicators<br />
<br />
const notFoundIndicators = getNotFoundIndicators(indicators)<br />
if (hasNotFoundIndicators(notFoundIndicators)) { <br />
errorHandlers.notFoundIndicators(notFoundIndicators, journalRecordManager.journalRecordId)<br />
}<br />
<br />
const emptyIndicatorProps = getNotFilledResultsFields(indicators)<br />
if (hasNotFilledProps(emptyIndicatorProps)) {<br />
errorHandlers.notFilledIndicatorProps(emptyIndicatorProps)<br />
}<br />
<br />
showSuccessMessage(messages.success, socketId)<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка заполненности атрибутов записи ЛЖ. <code>check-record-fields-filled</code> ==<br />
[[Файл:Check-record-fields-filled.png|frame]]<br />
Проверяет заполненность заданных полей в записи журнала (например, "Источник", "Место отбора", "Дата регистрации" и др.). Если какое-либо из обязательных полей не заполнено, выдаётся соответствующая ошибка.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { DialogType } from "@triteia/types-integration-gui"<br />
import { IJournalRecordManager } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
<br />
const config = {<br />
requiredFields: [<br />
'Источник',<br />
'Список. Целое число',<br />
'Строка',<br />
'Целое число',<br />
'Вещественное число',<br />
'Логический тип',<br />
'Дата',<br />
'Время',<br />
],<br />
journalRecordId: 144, // Мк / Тест_Ушакова<br />
integrationResult: { message: 'Все поля заполнены!' }<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: 'Все необходимые поля заполнены!',<br />
emptyFieldsError: (fields, recordId) => `Поля ${fields.map(f => `"${f}"`).join(', ')} не заполнены в записи с ID ${recordId}`,<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
fieldsError: (emptyFields, recordId) => {<br />
throw new Error(messages.emptyFieldsError(emptyFields, recordId))<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const isEmptyArray = (arr: unknown[]) => {<br />
return arr.length === 0<br />
}<br />
<br />
const getNotFilledFields = (fields: string[], journalRecordsManager: IJournalRecordManager) => {<br />
console.log(journalRecordsManager.data.attributes, 'data.attributes')<br />
return fields.filter(f => !journalRecordsManager.getFieldValue(f))<br />
}<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
const emptyFields = getNotFilledFields(config.requiredFields, journalRecordManager)<br />
<br />
if (isEmptyArray(emptyFields)) {<br />
showSuccessMessage(messages.success, socketId)<br />
return config.integrationResult<br />
} else errorHandlers.fieldsError(emptyFields, config.journalRecordId)<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка движения пробы. <code>check-sample-moving</code> ==<br />
[[Файл:Check-sample-moving.png|frame]]<br />
Проверяет маршрут движения пробы по этапам. Получает историю перемещений записи и определяет, происходило ли движение (нахождение более чем на одном этапе). Отображает маршрут или сообщает, что движение не происходило.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { JournalsRecordRouteController } from "../../src/servivces/worker/api/controllers/journals-record-route"<br />
import { apiInstance } from "../../src/servivces/worker/api/interactors/ApiInstance"<br />
import type { DialogType } from "@triteia/types-integration-gui"<br />
import type { JournalRecordRouteDto } from "../../src/servivces/worker/api/controllers/journal-records"<br />
<br />
const config = {<br />
journalRecordId: 114 // Лаб. воздуха / Анализы завершены<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
route: (routes: JournalRecordRouteDto[], recordId: number) => `Машрут пробы: ${routes.map(r => `"${r.stageName}"`).join(' -> ')}. Id записи ЛЖ: ${recordId}`, <br />
notMoved: (recordId: number) => `Движение пробы не происходило. Id записи ЛЖ: ${recordId}`, <br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const isSampleMoved = (moves: JournalRecordRouteDto[]) => {<br />
return Array.isArray(moves) && moves.length > 1<br />
}<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalsRecordRouteController = new JournalsRecordRouteController(apiInstance)<br />
const sampleMoves = await journalsRecordRouteController.getJournalRecordRoute(config.journalRecordId)<br />
<br />
if (isSampleMoved(sampleMoves)) {<br />
showSuccessMessage(messages.route(sampleMoves, config.journalRecordId), socketId)<br />
} else {<br />
showSuccessMessage(messages.notMoved(config.journalRecordId), socketId)<br />
}<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка прав пользователя. <code>check-user-rights</code> ==<br />
[[Файл:Check-user-rights.png|frame]]<br />
Проверяет права доступа пользователя к определённым ресурсам (объекты анализа, методики, записи ЛЖ). Отображает таблицу с типами доступа (чтение, запись и т.д.) и наличием прав по каждому ресурсу.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { apiInstance } from "../../src/servivces/worker/api/interactors/ApiInstance"<br />
import { <br />
PermissionController, <br />
PermissionResource, <br />
PermissionRwAccess<br />
} from "../../src/servivces/worker/api/controllers/permisson"<br />
<br />
import { TableBuilder } from "../../src/gui/builder"<br />
import type { DialogType, TableConfig } from "@triteia/types-integration-gui"<br />
import type { JournalRecordRouteDto } from "../../src/servivces/worker/api/controllers/journal-records"<br />
<br />
const accessNamesMap = {<br />
[PermissionRwAccess.EXEC]: 'Выполнение',<br />
[PermissionRwAccess.READ]: 'Чтение',<br />
[PermissionRwAccess.WRITE]: 'Запись',<br />
}<br />
<br />
const requiredResources = [<br />
PermissionResource.ANALYSIS_OBJECT, <br />
PermissionResource.METHODOLOGY,<br />
PermissionResource.JOURNAL_RECORD<br />
]<br />
<br />
const resourcesNamesMap = {<br />
[PermissionResource.ANALYSIS_OBJECT]: 'Объекты анализа', <br />
[PermissionResource.METHODOLOGY]: 'Методики', <br />
[PermissionResource.JOURNAL_RECORD]: 'Записи ЛЖ'<br />
}<br />
<br />
const getAccessRightsTable = async (tableBuilder: TableBuilder, permissionController: PermissionController): Promise<TableConfig> => {<br />
const rows = (await Promise.all(requiredResources.map(async (source: PermissionResource) => {<br />
const sourceCombinations = await Promise.all(Object.keys(PermissionRwAccess).map(async (action) => {<br />
const access = await permissionController.getSourcePermission(source, PermissionRwAccess[action])<br />
return { source: resourcesNamesMap[source], action: accessNamesMap[PermissionRwAccess[action]], access: access.hasPermission }<br />
}))<br />
return sourceCombinations<br />
} <br />
))).flat()<br />
const table = tableBuilder<br />
.name('simpleTable')<br />
.label('Таблица')<br />
.isAddable(false)<br />
.actionsCol(false)<br />
.addColumn('Ресурс', 'source', false)<br />
.config('input', { name: 'source', rules: [{ required: true }] }, { placeholder: '', disabled: false })<br />
.next()<br />
.addColumn('Тип доступа', 'action', false)<br />
.config('input', { name: 'action' }, { type: 'string', placeholder: '', disabled: false })<br />
.next()<br />
.addColumn('Доступ', 'access', false)<br />
.config('checkbox', { name: 'access' }, { type: 'boolean', placeholder: '', disabled: false })<br />
.next()<br />
.setRows(rows)<br />
.build();<br />
return table<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
route: (routes: JournalRecordRouteDto[], recordId: number) => `Маршрут пробы: ${routes.map(r => `"${r.stageName}"`).join(' -> ')}. Id записи ЛЖ: ${recordId}`, <br />
notMoved: (recordId: number) => `Движение пробы не происходило. Id записи ЛЖ: ${recordId}`, <br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
<br />
const showTable = async (builder: TableBuilder, controller: PermissionController, socketId: string) => <br />
await getDataFromDialog({ type: 'input-data', config: [await getAccessRightsTable(builder, controller)] }, socketId)<br />
<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
try {<br />
await showTable(new TableBuilder, new PermissionController(apiInstance), socketId)<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Заполнение атрибутов записи ЛЖ. <code>fill-record-fields</code> ==<br />
[[Файл:Fill-record-fields.png|frame]]<br />
Автоматически заполняет заданные поля в записи журнала (например, даты, место отбора, шифр пробы и др.). Есть возможность использования ключевых слов для сопоставления полей, если точные названия не совпадают.<br />
<br />
== Деление данных. <code>copy-journal-record</code> ==<br />
[[Файл:Copy-journal-record.png|frame]]<br />
Создаёт копию записи журнала на заданном этапе маршрута. Выводит сообщение с ID новой записи.</div>
Arhidiman
https://wiki.chemsoft.ru/index.php?title=%D0%90%D0%B4%D0%B4%D0%BE%D0%BD%D1%8B&diff=2369
Аддоны
2026-04-02T01:36:44Z
<p>Arhidiman: /* Проверка движения пробы. check-sample-moving */</p>
<hr />
<div>Список демонстрационных аддонов, показывающих возможности интеграционного сервиса.<br />
<br />
== Проверка даты регистрации. <code>check-registration-date</code> ==<br />
[[Файл:check-registration-date.png|frame]]<br />
Проверяет, не истёк ли срок регистрации пробы. Сравнивает дату регистрации из указанного поля с текущей датой. Если прошло более заданного количества дней (по умолчанию — 10), выдаёт ошибку. В противном случае показывает сообщение об успешной проверке.<br />
<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { MessageBoxResults } from "@triteia/types-integration-gui"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { DialogType } from "@triteia/types-integration-gui"<br />
<br />
const config = {<br />
dateField: 'Дата регистрации',<br />
expirationLimit: 10,<br />
journalRecordId: 201, // Лаб. воздуха / Анализы завершены<br />
integrationResult: { message: 'Срок регистрации пробы не истёк !'}<br />
}<br />
<br />
const messages = {<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
success: (recordId) => `Срок регистрации пробы не истёк ! Id записи ${recordId}`,<br />
expired: (limit, recordId) => `Срок регистрации пробы истёк!\nПрошло более ${ limit } дней с момента регистрации. Id записи: ${recordId}`,<br />
dateField: (dateField, stageName, journalRecordId) => [<br />
`Не заполнено либо отсутствует поле "${dateField}"`,<br />
`в этапе "${stageName || ''}".\nId записи: ${journalRecordId}`<br />
].join(' ')<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
},<br />
dateError: (dateField, stageName, journalRecordId) => {<br />
throw new Error(messages.dateField(dateField, stageName, journalRecordId))<br />
},<br />
expirationError: () => {<br />
throw new Error(messages.expired(config.expirationLimit, config.journalRecordId))<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const getDaysByDate = (date: Date) => {<br />
const dayMs = 60 * 60 * 24 * 1000<br />
const timestamp = date.getTime()<br />
return timestamp/dayMs<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getExpirationOffset = (registrationDate: string) => {<br />
const regDate = new Date(registrationDate)<br />
const today = new Date()<br />
return getDaysByDate(today) - getDaysByDate(regDate)<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
async function main({ queryParams }) {<br />
<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
const date = journalRecordManager.getFieldValue(config.dateField)<br />
<br />
if (!date) errorHandlers.dateError(config.dateField, journalRecordManager?.data?.stage?.stage?.name, config.journalRecordId)<br />
<br />
const expirationOffset = getExpirationOffset(date as string)<br />
<br />
if (expirationOffset >= config.expirationLimit) errorHandlers.expirationError()<br />
<br />
await showSuccessMessage(messages.success(config.journalRecordId), socketId)<br />
<br />
return config.integrationResult<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка заполненности полей показателей. <code>check-indicator-fields-filled</code> ==<br />
[[Файл:Check-indicator-fields-filled.png|frame]]<br />
Проверяет заполненность полей показателей в записи журнала по настраиваемому списку. Проверяет наличие определённых показателей (например, "Аммоний-ион") и заполненность у них таких полей, как исполнители, методики, средний результат и др. Выдаёт ошибку, если показатели отсутствуют или не все поля заполнены.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import type { DialogType } from "@triteia/types-integration-gui"<br />
import type { JournalRecordIndicatorResponse } from "../../src/servivces/worker/api/controllers/journal-records"<br />
import type { IJournalRecordManager } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
<br />
type IndicatorProp = { label: string, get: () => unknown }<br />
type IndicatorPropsConfig = Record<string, IndicatorProp><br />
<br />
const indicatorPropsConfig = (indicator): IndicatorPropsConfig => {<br />
return {<br />
executors: {<br />
label: 'Исполнители', <br />
get: () => indicator?.result?.executors<br />
},<br />
methodic: {<br />
label: 'Методики', <br />
get: () => indicator?.methodics<br />
},<br />
averageResult: {<br />
label: 'Средний результат', <br />
get: () => indicator?.result?.averageValue<br />
},<br />
averageRoundedValue: {<br />
label: 'Средний округлённый результат', <br />
get: () => indicator?.result?.averageRoundedValue<br />
}<br />
}<br />
}<br />
<br />
const config = {<br />
requiredFields: [<br />
'Источник',<br />
'Место отбора',<br />
'Дата регистрации',<br />
'Шифр пробы',<br />
'Время регистрации'<br />
],<br />
indicatorsList: [<br />
'Аммоний-ион'<br />
],<br />
journalRecordId: 144, // Мк / Тест_Ушакова<br />
integrationResult: { message: 'Все поля заполнены!' }<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: 'Все необходимые поля заполнены!',<br />
emptyIndicators: (recordId) => `в записи с Id ${recordId} отсутствуют показатели`,<br />
emptyFieldsError: (fields, recordId) => `Поля ${fields.map(f => `"${f}"`).join(', ')} не заполнены в записи с ID ${recordId}`,<br />
indicators: (indicators: string[], recordId) => `Показатели ${indicators.map(f => `"${f}"`).join(', ')} отсутствуют в записи с ID ${recordId}`,<br />
emptyIndicatorsProps: (props: Record<string, string[]>, recordId) => {<br />
const propsString = Object.keys(props).map(prop => !isEmptyArray(props[prop]) ? `${prop}: ${props[prop].map(p => `"${p}"`).join(', ')}` : '').join('; ')<br />
return `В записи с Id ${recordId} отсутствуют либо не заполнены следующие поля у показателей: ${propsString}`<br />
}<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
fieldsError: (emptyFields, recordId) => {<br />
throw new Error(messages.emptyFieldsError(emptyFields, recordId))<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
},<br />
indicatorsError: (recordId) =>{<br />
throw new Error(messages.emptyIndicators(recordId))<br />
},<br />
notFoundIndicators: (indicators: string[], recordId: number) => {<br />
throw new Error(messages.indicators(indicators, recordId))<br />
},<br />
notFilledIndicatorProps: (props: Record<string, string[]>) => {<br />
throw new Error(messages.emptyIndicatorsProps(props, config.journalRecordId))<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const isEmptyArray = (arr: unknown[]) => {<br />
return Array.isArray(arr) && arr.length === 0<br />
}<br />
<br />
const hasIndicators = (journalRecordManager: IJournalRecordManager) => {<br />
const indicators = journalRecordManager?.data?.indicators<br />
return Array.isArray(indicators) && indicators.length > 0<br />
}<br />
<br />
const getNotFoundIndicators = (indicators: JournalRecordIndicatorResponse[], indicatorsList = config.indicatorsList) => {<br />
return indicatorsList.filter(ind => indicators.every(ljInd => ljInd?.indicator?.name?.toLowerCase() !== ind.toLocaleLowerCase()))<br />
} <br />
<br />
const getNotFilledResultsFields = (indicators: JournalRecordIndicatorResponse[]): Record<string, string[]> => {<br />
return indicators.reduce((acc, indicator) => {<br />
const config = indicatorPropsConfig(indicator)<br />
return {<br />
...acc,<br />
[indicator?.indicator?.name]: Object.keys(config).reduce((acc, prop) => {<br />
if (!config[prop].get()) return [...acc, config[prop].label]<br />
return acc<br />
}, [] as string[])<br />
}<br />
}, {}) as Record<string, string[]><br />
}<br />
<br />
const hasNotFilledProps = (indicatorsProps: Record<string, string[]>) => {<br />
return Object.keys(indicatorsProps).some(indicator => !isEmptyArray(indicatorsProps[indicator]))<br />
}<br />
<br />
const hasNotFoundIndicators = (indicators: string[]) => !isEmptyArray(indicators)<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
<br />
if (!hasIndicators(journalRecordManager)) {<br />
errorHandlers.indicatorsError(journalRecordManager.journalRecordId)<br />
}<br />
<br />
const indicators = journalRecordManager?.data?.indicators<br />
<br />
const notFoundIndicators = getNotFoundIndicators(indicators)<br />
if (hasNotFoundIndicators(notFoundIndicators)) { <br />
errorHandlers.notFoundIndicators(notFoundIndicators, journalRecordManager.journalRecordId)<br />
}<br />
<br />
const emptyIndicatorProps = getNotFilledResultsFields(indicators)<br />
if (hasNotFilledProps(emptyIndicatorProps)) {<br />
errorHandlers.notFilledIndicatorProps(emptyIndicatorProps)<br />
}<br />
<br />
showSuccessMessage(messages.success, socketId)<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка заполненности атрибутов записи ЛЖ. <code>check-record-fields-filled</code> ==<br />
[[Файл:Check-record-fields-filled.png|frame]]<br />
Проверяет заполненность заданных полей в записи журнала (например, "Источник", "Место отбора", "Дата регистрации" и др.). Если какое-либо из обязательных полей не заполнено, выдаётся соответствующая ошибка.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { DialogType } from "@triteia/types-integration-gui"<br />
import { IJournalRecordManager } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
<br />
const config = {<br />
requiredFields: [<br />
'Источник',<br />
'Список. Целое число',<br />
'Строка',<br />
'Целое число',<br />
'Вещественное число',<br />
'Логический тип',<br />
'Дата',<br />
'Время',<br />
],<br />
journalRecordId: 144, // Мк / Тест_Ушакова<br />
integrationResult: { message: 'Все поля заполнены!' }<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: 'Все необходимые поля заполнены!',<br />
emptyFieldsError: (fields, recordId) => `Поля ${fields.map(f => `"${f}"`).join(', ')} не заполнены в записи с ID ${recordId}`,<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
fieldsError: (emptyFields, recordId) => {<br />
throw new Error(messages.emptyFieldsError(emptyFields, recordId))<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const isEmptyArray = (arr: unknown[]) => {<br />
return arr.length === 0<br />
}<br />
<br />
const getNotFilledFields = (fields: string[], journalRecordsManager: IJournalRecordManager) => {<br />
console.log(journalRecordsManager.data.attributes, 'data.attributes')<br />
return fields.filter(f => !journalRecordsManager.getFieldValue(f))<br />
}<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
const emptyFields = getNotFilledFields(config.requiredFields, journalRecordManager)<br />
<br />
if (isEmptyArray(emptyFields)) {<br />
showSuccessMessage(messages.success, socketId)<br />
return config.integrationResult<br />
} else errorHandlers.fieldsError(emptyFields, config.journalRecordId)<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка движения пробы. <code>check-sample-moving</code> ==<br />
[[Файл:Check-sample-moving.png|frame]]<br />
Проверяет маршрут движения пробы по этапам. Получает историю перемещений записи и определяет, происходило ли движение (нахождение более чем на одном этапе). Отображает маршрут или сообщает, что движение не происходило.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { JournalsRecordRouteController } from "../../src/servivces/worker/api/controllers/journals-record-route"<br />
import { apiInstance } from "../../src/servivces/worker/api/interactors/ApiInstance"<br />
import type { DialogType } from "@triteia/types-integration-gui"<br />
import type { JournalRecordRouteDto } from "../../src/servivces/worker/api/controllers/journal-records"<br />
<br />
const config = {<br />
journalRecordId: 114 // Лаб. воздуха / Анализы завершены<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
route: (routes: JournalRecordRouteDto[], recordId: number) => `Машрут пробы: ${routes.map(r => `"${r.stageName}"`).join(' -> ')}. Id записи ЛЖ: ${recordId}`, <br />
notMoved: (recordId: number) => `Движение пробы не происходило. Id записи ЛЖ: ${recordId}`, <br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const isSampleMoved = (moves: JournalRecordRouteDto[]) => {<br />
return Array.isArray(moves) && moves.length > 1<br />
}<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalsRecordRouteController = new JournalsRecordRouteController(apiInstance)<br />
const sampleMoves = await journalsRecordRouteController.getJournalRecordRoute(config.journalRecordId)<br />
<br />
if (isSampleMoved(sampleMoves)) {<br />
showSuccessMessage(messages.route(sampleMoves, config.journalRecordId), socketId)<br />
} else {<br />
showSuccessMessage(messages.notMoved(config.journalRecordId), socketId)<br />
}<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка прав пользователя. <code>check-user-rights</code> ==<br />
[[Файл:Check-user-rights.png|frame]]<br />
Проверяет права доступа пользователя к определённым ресурсам (объекты анализа, методики, записи ЛЖ). Отображает таблицу с типами доступа (чтение, запись и т.д.) и наличием прав по каждому ресурсу.<br />
<br />
== Заполнение атрибутов записи ЛЖ. <code>fill-record-fields</code> ==<br />
[[Файл:Fill-record-fields.png|frame]]<br />
Автоматически заполняет заданные поля в записи журнала (например, даты, место отбора, шифр пробы и др.). Есть возможность использования ключевых слов для сопоставления полей, если точные названия не совпадают.<br />
<br />
== Деление данных. <code>copy-journal-record</code> ==<br />
[[Файл:Copy-journal-record.png|frame]]<br />
Создаёт копию записи журнала на заданном этапе маршрута. Выводит сообщение с ID новой записи.</div>
Arhidiman
https://wiki.chemsoft.ru/index.php?title=%D0%90%D0%B4%D0%B4%D0%BE%D0%BD%D1%8B&diff=2368
Аддоны
2026-04-02T01:35:51Z
<p>Arhidiman: /* Проверка заполненности атрибутов записи ЛЖ. check-record-fields-filled */</p>
<hr />
<div>Список демонстрационных аддонов, показывающих возможности интеграционного сервиса.<br />
<br />
== Проверка даты регистрации. <code>check-registration-date</code> ==<br />
[[Файл:check-registration-date.png|frame]]<br />
Проверяет, не истёк ли срок регистрации пробы. Сравнивает дату регистрации из указанного поля с текущей датой. Если прошло более заданного количества дней (по умолчанию — 10), выдаёт ошибку. В противном случае показывает сообщение об успешной проверке.<br />
<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { MessageBoxResults } from "@triteia/types-integration-gui"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { DialogType } from "@triteia/types-integration-gui"<br />
<br />
const config = {<br />
dateField: 'Дата регистрации',<br />
expirationLimit: 10,<br />
journalRecordId: 201, // Лаб. воздуха / Анализы завершены<br />
integrationResult: { message: 'Срок регистрации пробы не истёк !'}<br />
}<br />
<br />
const messages = {<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
success: (recordId) => `Срок регистрации пробы не истёк ! Id записи ${recordId}`,<br />
expired: (limit, recordId) => `Срок регистрации пробы истёк!\nПрошло более ${ limit } дней с момента регистрации. Id записи: ${recordId}`,<br />
dateField: (dateField, stageName, journalRecordId) => [<br />
`Не заполнено либо отсутствует поле "${dateField}"`,<br />
`в этапе "${stageName || ''}".\nId записи: ${journalRecordId}`<br />
].join(' ')<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
},<br />
dateError: (dateField, stageName, journalRecordId) => {<br />
throw new Error(messages.dateField(dateField, stageName, journalRecordId))<br />
},<br />
expirationError: () => {<br />
throw new Error(messages.expired(config.expirationLimit, config.journalRecordId))<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const getDaysByDate = (date: Date) => {<br />
const dayMs = 60 * 60 * 24 * 1000<br />
const timestamp = date.getTime()<br />
return timestamp/dayMs<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getExpirationOffset = (registrationDate: string) => {<br />
const regDate = new Date(registrationDate)<br />
const today = new Date()<br />
return getDaysByDate(today) - getDaysByDate(regDate)<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
async function main({ queryParams }) {<br />
<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
const date = journalRecordManager.getFieldValue(config.dateField)<br />
<br />
if (!date) errorHandlers.dateError(config.dateField, journalRecordManager?.data?.stage?.stage?.name, config.journalRecordId)<br />
<br />
const expirationOffset = getExpirationOffset(date as string)<br />
<br />
if (expirationOffset >= config.expirationLimit) errorHandlers.expirationError()<br />
<br />
await showSuccessMessage(messages.success(config.journalRecordId), socketId)<br />
<br />
return config.integrationResult<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка заполненности полей показателей. <code>check-indicator-fields-filled</code> ==<br />
[[Файл:Check-indicator-fields-filled.png|frame]]<br />
Проверяет заполненность полей показателей в записи журнала по настраиваемому списку. Проверяет наличие определённых показателей (например, "Аммоний-ион") и заполненность у них таких полей, как исполнители, методики, средний результат и др. Выдаёт ошибку, если показатели отсутствуют или не все поля заполнены.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import type { DialogType } from "@triteia/types-integration-gui"<br />
import type { JournalRecordIndicatorResponse } from "../../src/servivces/worker/api/controllers/journal-records"<br />
import type { IJournalRecordManager } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
<br />
type IndicatorProp = { label: string, get: () => unknown }<br />
type IndicatorPropsConfig = Record<string, IndicatorProp><br />
<br />
const indicatorPropsConfig = (indicator): IndicatorPropsConfig => {<br />
return {<br />
executors: {<br />
label: 'Исполнители', <br />
get: () => indicator?.result?.executors<br />
},<br />
methodic: {<br />
label: 'Методики', <br />
get: () => indicator?.methodics<br />
},<br />
averageResult: {<br />
label: 'Средний результат', <br />
get: () => indicator?.result?.averageValue<br />
},<br />
averageRoundedValue: {<br />
label: 'Средний округлённый результат', <br />
get: () => indicator?.result?.averageRoundedValue<br />
}<br />
}<br />
}<br />
<br />
const config = {<br />
requiredFields: [<br />
'Источник',<br />
'Место отбора',<br />
'Дата регистрации',<br />
'Шифр пробы',<br />
'Время регистрации'<br />
],<br />
indicatorsList: [<br />
'Аммоний-ион'<br />
],<br />
journalRecordId: 144, // Мк / Тест_Ушакова<br />
integrationResult: { message: 'Все поля заполнены!' }<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: 'Все необходимые поля заполнены!',<br />
emptyIndicators: (recordId) => `в записи с Id ${recordId} отсутствуют показатели`,<br />
emptyFieldsError: (fields, recordId) => `Поля ${fields.map(f => `"${f}"`).join(', ')} не заполнены в записи с ID ${recordId}`,<br />
indicators: (indicators: string[], recordId) => `Показатели ${indicators.map(f => `"${f}"`).join(', ')} отсутствуют в записи с ID ${recordId}`,<br />
emptyIndicatorsProps: (props: Record<string, string[]>, recordId) => {<br />
const propsString = Object.keys(props).map(prop => !isEmptyArray(props[prop]) ? `${prop}: ${props[prop].map(p => `"${p}"`).join(', ')}` : '').join('; ')<br />
return `В записи с Id ${recordId} отсутствуют либо не заполнены следующие поля у показателей: ${propsString}`<br />
}<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
fieldsError: (emptyFields, recordId) => {<br />
throw new Error(messages.emptyFieldsError(emptyFields, recordId))<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
},<br />
indicatorsError: (recordId) =>{<br />
throw new Error(messages.emptyIndicators(recordId))<br />
},<br />
notFoundIndicators: (indicators: string[], recordId: number) => {<br />
throw new Error(messages.indicators(indicators, recordId))<br />
},<br />
notFilledIndicatorProps: (props: Record<string, string[]>) => {<br />
throw new Error(messages.emptyIndicatorsProps(props, config.journalRecordId))<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const isEmptyArray = (arr: unknown[]) => {<br />
return Array.isArray(arr) && arr.length === 0<br />
}<br />
<br />
const hasIndicators = (journalRecordManager: IJournalRecordManager) => {<br />
const indicators = journalRecordManager?.data?.indicators<br />
return Array.isArray(indicators) && indicators.length > 0<br />
}<br />
<br />
const getNotFoundIndicators = (indicators: JournalRecordIndicatorResponse[], indicatorsList = config.indicatorsList) => {<br />
return indicatorsList.filter(ind => indicators.every(ljInd => ljInd?.indicator?.name?.toLowerCase() !== ind.toLocaleLowerCase()))<br />
} <br />
<br />
const getNotFilledResultsFields = (indicators: JournalRecordIndicatorResponse[]): Record<string, string[]> => {<br />
return indicators.reduce((acc, indicator) => {<br />
const config = indicatorPropsConfig(indicator)<br />
return {<br />
...acc,<br />
[indicator?.indicator?.name]: Object.keys(config).reduce((acc, prop) => {<br />
if (!config[prop].get()) return [...acc, config[prop].label]<br />
return acc<br />
}, [] as string[])<br />
}<br />
}, {}) as Record<string, string[]><br />
}<br />
<br />
const hasNotFilledProps = (indicatorsProps: Record<string, string[]>) => {<br />
return Object.keys(indicatorsProps).some(indicator => !isEmptyArray(indicatorsProps[indicator]))<br />
}<br />
<br />
const hasNotFoundIndicators = (indicators: string[]) => !isEmptyArray(indicators)<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
<br />
if (!hasIndicators(journalRecordManager)) {<br />
errorHandlers.indicatorsError(journalRecordManager.journalRecordId)<br />
}<br />
<br />
const indicators = journalRecordManager?.data?.indicators<br />
<br />
const notFoundIndicators = getNotFoundIndicators(indicators)<br />
if (hasNotFoundIndicators(notFoundIndicators)) { <br />
errorHandlers.notFoundIndicators(notFoundIndicators, journalRecordManager.journalRecordId)<br />
}<br />
<br />
const emptyIndicatorProps = getNotFilledResultsFields(indicators)<br />
if (hasNotFilledProps(emptyIndicatorProps)) {<br />
errorHandlers.notFilledIndicatorProps(emptyIndicatorProps)<br />
}<br />
<br />
showSuccessMessage(messages.success, socketId)<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка заполненности атрибутов записи ЛЖ. <code>check-record-fields-filled</code> ==<br />
[[Файл:Check-record-fields-filled.png|frame]]<br />
Проверяет заполненность заданных полей в записи журнала (например, "Источник", "Место отбора", "Дата регистрации" и др.). Если какое-либо из обязательных полей не заполнено, выдаётся соответствующая ошибка.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { DialogType } from "@triteia/types-integration-gui"<br />
import { IJournalRecordManager } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
<br />
const config = {<br />
requiredFields: [<br />
'Источник',<br />
'Список. Целое число',<br />
'Строка',<br />
'Целое число',<br />
'Вещественное число',<br />
'Логический тип',<br />
'Дата',<br />
'Время',<br />
],<br />
journalRecordId: 144, // Мк / Тест_Ушакова<br />
integrationResult: { message: 'Все поля заполнены!' }<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: 'Все необходимые поля заполнены!',<br />
emptyFieldsError: (fields, recordId) => `Поля ${fields.map(f => `"${f}"`).join(', ')} не заполнены в записи с ID ${recordId}`,<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
fieldsError: (emptyFields, recordId) => {<br />
throw new Error(messages.emptyFieldsError(emptyFields, recordId))<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const isEmptyArray = (arr: unknown[]) => {<br />
return arr.length === 0<br />
}<br />
<br />
const getNotFilledFields = (fields: string[], journalRecordsManager: IJournalRecordManager) => {<br />
console.log(journalRecordsManager.data.attributes, 'data.attributes')<br />
return fields.filter(f => !journalRecordsManager.getFieldValue(f))<br />
}<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
const emptyFields = getNotFilledFields(config.requiredFields, journalRecordManager)<br />
<br />
if (isEmptyArray(emptyFields)) {<br />
showSuccessMessage(messages.success, socketId)<br />
return config.integrationResult<br />
} else errorHandlers.fieldsError(emptyFields, config.journalRecordId)<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка движения пробы. <code>check-sample-moving</code> ==<br />
[[Файл:Check-sample-moving.png|frame]]<br />
Проверяет маршрут движения пробы по этапам. Получает историю перемещений записи и определяет, происходило ли движение (нахождение более чем на одном этапе). Отображает маршрут или сообщает, что движение не происходило.<br />
<br />
== Проверка прав пользователя. <code>check-user-rights</code> ==<br />
[[Файл:Check-user-rights.png|frame]]<br />
Проверяет права доступа пользователя к определённым ресурсам (объекты анализа, методики, записи ЛЖ). Отображает таблицу с типами доступа (чтение, запись и т.д.) и наличием прав по каждому ресурсу.<br />
<br />
== Заполнение атрибутов записи ЛЖ. <code>fill-record-fields</code> ==<br />
[[Файл:Fill-record-fields.png|frame]]<br />
Автоматически заполняет заданные поля в записи журнала (например, даты, место отбора, шифр пробы и др.). Есть возможность использования ключевых слов для сопоставления полей, если точные названия не совпадают.<br />
<br />
== Деление данных. <code>copy-journal-record</code> ==<br />
[[Файл:Copy-journal-record.png|frame]]<br />
Создаёт копию записи журнала на заданном этапе маршрута. Выводит сообщение с ID новой записи.</div>
Arhidiman
https://wiki.chemsoft.ru/index.php?title=%D0%90%D0%B4%D0%B4%D0%BE%D0%BD%D1%8B&diff=2367
Аддоны
2026-04-02T01:33:57Z
<p>Arhidiman: /* Проверка заполненности полей показателей. check-indicator-fields-filled */</p>
<hr />
<div>Список демонстрационных аддонов, показывающих возможности интеграционного сервиса.<br />
<br />
== Проверка даты регистрации. <code>check-registration-date</code> ==<br />
[[Файл:check-registration-date.png|frame]]<br />
Проверяет, не истёк ли срок регистрации пробы. Сравнивает дату регистрации из указанного поля с текущей датой. Если прошло более заданного количества дней (по умолчанию — 10), выдаёт ошибку. В противном случае показывает сообщение об успешной проверке.<br />
<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { MessageBoxResults } from "@triteia/types-integration-gui"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { DialogType } from "@triteia/types-integration-gui"<br />
<br />
const config = {<br />
dateField: 'Дата регистрации',<br />
expirationLimit: 10,<br />
journalRecordId: 201, // Лаб. воздуха / Анализы завершены<br />
integrationResult: { message: 'Срок регистрации пробы не истёк !'}<br />
}<br />
<br />
const messages = {<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
success: (recordId) => `Срок регистрации пробы не истёк ! Id записи ${recordId}`,<br />
expired: (limit, recordId) => `Срок регистрации пробы истёк!\nПрошло более ${ limit } дней с момента регистрации. Id записи: ${recordId}`,<br />
dateField: (dateField, stageName, journalRecordId) => [<br />
`Не заполнено либо отсутствует поле "${dateField}"`,<br />
`в этапе "${stageName || ''}".\nId записи: ${journalRecordId}`<br />
].join(' ')<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
},<br />
dateError: (dateField, stageName, journalRecordId) => {<br />
throw new Error(messages.dateField(dateField, stageName, journalRecordId))<br />
},<br />
expirationError: () => {<br />
throw new Error(messages.expired(config.expirationLimit, config.journalRecordId))<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const getDaysByDate = (date: Date) => {<br />
const dayMs = 60 * 60 * 24 * 1000<br />
const timestamp = date.getTime()<br />
return timestamp/dayMs<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getExpirationOffset = (registrationDate: string) => {<br />
const regDate = new Date(registrationDate)<br />
const today = new Date()<br />
return getDaysByDate(today) - getDaysByDate(regDate)<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
async function main({ queryParams }) {<br />
<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
const date = journalRecordManager.getFieldValue(config.dateField)<br />
<br />
if (!date) errorHandlers.dateError(config.dateField, journalRecordManager?.data?.stage?.stage?.name, config.journalRecordId)<br />
<br />
const expirationOffset = getExpirationOffset(date as string)<br />
<br />
if (expirationOffset >= config.expirationLimit) errorHandlers.expirationError()<br />
<br />
await showSuccessMessage(messages.success(config.journalRecordId), socketId)<br />
<br />
return config.integrationResult<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка заполненности полей показателей. <code>check-indicator-fields-filled</code> ==<br />
[[Файл:Check-indicator-fields-filled.png|frame]]<br />
Проверяет заполненность полей показателей в записи журнала по настраиваемому списку. Проверяет наличие определённых показателей (например, "Аммоний-ион") и заполненность у них таких полей, как исполнители, методики, средний результат и др. Выдаёт ошибку, если показатели отсутствуют или не все поля заполнены.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import type { DialogType } from "@triteia/types-integration-gui"<br />
import type { JournalRecordIndicatorResponse } from "../../src/servivces/worker/api/controllers/journal-records"<br />
import type { IJournalRecordManager } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
<br />
type IndicatorProp = { label: string, get: () => unknown }<br />
type IndicatorPropsConfig = Record<string, IndicatorProp><br />
<br />
const indicatorPropsConfig = (indicator): IndicatorPropsConfig => {<br />
return {<br />
executors: {<br />
label: 'Исполнители', <br />
get: () => indicator?.result?.executors<br />
},<br />
methodic: {<br />
label: 'Методики', <br />
get: () => indicator?.methodics<br />
},<br />
averageResult: {<br />
label: 'Средний результат', <br />
get: () => indicator?.result?.averageValue<br />
},<br />
averageRoundedValue: {<br />
label: 'Средний округлённый результат', <br />
get: () => indicator?.result?.averageRoundedValue<br />
}<br />
}<br />
}<br />
<br />
const config = {<br />
requiredFields: [<br />
'Источник',<br />
'Место отбора',<br />
'Дата регистрации',<br />
'Шифр пробы',<br />
'Время регистрации'<br />
],<br />
indicatorsList: [<br />
'Аммоний-ион'<br />
],<br />
journalRecordId: 144, // Мк / Тест_Ушакова<br />
integrationResult: { message: 'Все поля заполнены!' }<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: 'Все необходимые поля заполнены!',<br />
emptyIndicators: (recordId) => `в записи с Id ${recordId} отсутствуют показатели`,<br />
emptyFieldsError: (fields, recordId) => `Поля ${fields.map(f => `"${f}"`).join(', ')} не заполнены в записи с ID ${recordId}`,<br />
indicators: (indicators: string[], recordId) => `Показатели ${indicators.map(f => `"${f}"`).join(', ')} отсутствуют в записи с ID ${recordId}`,<br />
emptyIndicatorsProps: (props: Record<string, string[]>, recordId) => {<br />
const propsString = Object.keys(props).map(prop => !isEmptyArray(props[prop]) ? `${prop}: ${props[prop].map(p => `"${p}"`).join(', ')}` : '').join('; ')<br />
return `В записи с Id ${recordId} отсутствуют либо не заполнены следующие поля у показателей: ${propsString}`<br />
}<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
fieldsError: (emptyFields, recordId) => {<br />
throw new Error(messages.emptyFieldsError(emptyFields, recordId))<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
},<br />
indicatorsError: (recordId) =>{<br />
throw new Error(messages.emptyIndicators(recordId))<br />
},<br />
notFoundIndicators: (indicators: string[], recordId: number) => {<br />
throw new Error(messages.indicators(indicators, recordId))<br />
},<br />
notFilledIndicatorProps: (props: Record<string, string[]>) => {<br />
throw new Error(messages.emptyIndicatorsProps(props, config.journalRecordId))<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const isEmptyArray = (arr: unknown[]) => {<br />
return Array.isArray(arr) && arr.length === 0<br />
}<br />
<br />
const hasIndicators = (journalRecordManager: IJournalRecordManager) => {<br />
const indicators = journalRecordManager?.data?.indicators<br />
return Array.isArray(indicators) && indicators.length > 0<br />
}<br />
<br />
const getNotFoundIndicators = (indicators: JournalRecordIndicatorResponse[], indicatorsList = config.indicatorsList) => {<br />
return indicatorsList.filter(ind => indicators.every(ljInd => ljInd?.indicator?.name?.toLowerCase() !== ind.toLocaleLowerCase()))<br />
} <br />
<br />
const getNotFilledResultsFields = (indicators: JournalRecordIndicatorResponse[]): Record<string, string[]> => {<br />
return indicators.reduce((acc, indicator) => {<br />
const config = indicatorPropsConfig(indicator)<br />
return {<br />
...acc,<br />
[indicator?.indicator?.name]: Object.keys(config).reduce((acc, prop) => {<br />
if (!config[prop].get()) return [...acc, config[prop].label]<br />
return acc<br />
}, [] as string[])<br />
}<br />
}, {}) as Record<string, string[]><br />
}<br />
<br />
const hasNotFilledProps = (indicatorsProps: Record<string, string[]>) => {<br />
return Object.keys(indicatorsProps).some(indicator => !isEmptyArray(indicatorsProps[indicator]))<br />
}<br />
<br />
const hasNotFoundIndicators = (indicators: string[]) => !isEmptyArray(indicators)<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
<br />
if (!hasIndicators(journalRecordManager)) {<br />
errorHandlers.indicatorsError(journalRecordManager.journalRecordId)<br />
}<br />
<br />
const indicators = journalRecordManager?.data?.indicators<br />
<br />
const notFoundIndicators = getNotFoundIndicators(indicators)<br />
if (hasNotFoundIndicators(notFoundIndicators)) { <br />
errorHandlers.notFoundIndicators(notFoundIndicators, journalRecordManager.journalRecordId)<br />
}<br />
<br />
const emptyIndicatorProps = getNotFilledResultsFields(indicators)<br />
if (hasNotFilledProps(emptyIndicatorProps)) {<br />
errorHandlers.notFilledIndicatorProps(emptyIndicatorProps)<br />
}<br />
<br />
showSuccessMessage(messages.success, socketId)<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка заполненности атрибутов записи ЛЖ. <code>check-record-fields-filled</code> ==<br />
[[Файл:Check-record-fields-filled.png|frame]]<br />
Проверяет заполненность заданных полей в записи журнала (например, "Источник", "Место отбора", "Дата регистрации" и др.). Если какое-либо из обязательных полей не заполнено, выдаётся соответствующая ошибка.<br />
<br />
== Проверка движения пробы. <code>check-sample-moving</code> ==<br />
[[Файл:Check-sample-moving.png|frame]]<br />
Проверяет маршрут движения пробы по этапам. Получает историю перемещений записи и определяет, происходило ли движение (нахождение более чем на одном этапе). Отображает маршрут или сообщает, что движение не происходило.<br />
<br />
== Проверка прав пользователя. <code>check-user-rights</code> ==<br />
[[Файл:Check-user-rights.png|frame]]<br />
Проверяет права доступа пользователя к определённым ресурсам (объекты анализа, методики, записи ЛЖ). Отображает таблицу с типами доступа (чтение, запись и т.д.) и наличием прав по каждому ресурсу.<br />
<br />
== Заполнение атрибутов записи ЛЖ. <code>fill-record-fields</code> ==<br />
[[Файл:Fill-record-fields.png|frame]]<br />
Автоматически заполняет заданные поля в записи журнала (например, даты, место отбора, шифр пробы и др.). Есть возможность использования ключевых слов для сопоставления полей, если точные названия не совпадают.<br />
<br />
== Деление данных. <code>copy-journal-record</code> ==<br />
[[Файл:Copy-journal-record.png|frame]]<br />
Создаёт копию записи журнала на заданном этапе маршрута. Выводит сообщение с ID новой записи.</div>
Arhidiman
https://wiki.chemsoft.ru/index.php?title=%D0%90%D0%B4%D0%B4%D0%BE%D0%BD%D1%8B&diff=2366
Аддоны
2026-04-02T01:31:54Z
<p>Arhidiman: /* Проверка даты регистрации. check-registration-date */</p>
<hr />
<div>Список демонстрационных аддонов, показывающих возможности интеграционного сервиса.<br />
<br />
== Проверка даты регистрации. <code>check-registration-date</code> ==<br />
[[Файл:check-registration-date.png|frame]]<br />
Проверяет, не истёк ли срок регистрации пробы. Сравнивает дату регистрации из указанного поля с текущей датой. Если прошло более заданного количества дней (по умолчанию — 10), выдаёт ошибку. В противном случае показывает сообщение об успешной проверке.<br />
<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Просмотр кода</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { MessageBoxResults } from "@triteia/types-integration-gui"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { DialogType } from "@triteia/types-integration-gui"<br />
<br />
const config = {<br />
dateField: 'Дата регистрации',<br />
expirationLimit: 10,<br />
journalRecordId: 201, // Лаб. воздуха / Анализы завершены<br />
integrationResult: { message: 'Срок регистрации пробы не истёк !'}<br />
}<br />
<br />
const messages = {<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
success: (recordId) => `Срок регистрации пробы не истёк ! Id записи ${recordId}`,<br />
expired: (limit, recordId) => `Срок регистрации пробы истёк!\nПрошло более ${ limit } дней с момента регистрации. Id записи: ${recordId}`,<br />
dateField: (dateField, stageName, journalRecordId) => [<br />
`Не заполнено либо отсутствует поле "${dateField}"`,<br />
`в этапе "${stageName || ''}".\nId записи: ${journalRecordId}`<br />
].join(' ')<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
},<br />
dateError: (dateField, stageName, journalRecordId) => {<br />
throw new Error(messages.dateField(dateField, stageName, journalRecordId))<br />
},<br />
expirationError: () => {<br />
throw new Error(messages.expired(config.expirationLimit, config.journalRecordId))<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const getDaysByDate = (date: Date) => {<br />
const dayMs = 60 * 60 * 24 * 1000<br />
const timestamp = date.getTime()<br />
return timestamp/dayMs<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getExpirationOffset = (registrationDate: string) => {<br />
const regDate = new Date(registrationDate)<br />
const today = new Date()<br />
return getDaysByDate(today) - getDaysByDate(regDate)<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
async function main({ queryParams }) {<br />
<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
const date = journalRecordManager.getFieldValue(config.dateField)<br />
<br />
if (!date) errorHandlers.dateError(config.dateField, journalRecordManager?.data?.stage?.stage?.name, config.journalRecordId)<br />
<br />
const expirationOffset = getExpirationOffset(date as string)<br />
<br />
if (expirationOffset >= config.expirationLimit) errorHandlers.expirationError()<br />
<br />
await showSuccessMessage(messages.success(config.journalRecordId), socketId)<br />
<br />
return config.integrationResult<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка заполненности полей показателей. <code>check-indicator-fields-filled</code> ==<br />
[[Файл:Check-indicator-fields-filled.png|frame]]<br />
Проверяет заполненность полей показателей в записи журнала по настраиваемому списку. Проверяет наличие определённых показателей (например, "Аммоний-ион") и заполненность у них таких полей, как исполнители, методики, средний результат и др. Выдаёт ошибку, если показатели отсутствуют или не все поля заполнены.<br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import type { DialogType } from "@triteia/types-integration-gui"<br />
import type { JournalRecordIndicatorResponse } from "../../src/servivces/worker/api/controllers/journal-records"<br />
import type { IJournalRecordManager } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
<br />
type IndicatorProp = { label: string, get: () => unknown }<br />
type IndicatorPropsConfig = Record<string, IndicatorProp><br />
<br />
const indicatorPropsConfig = (indicator): IndicatorPropsConfig => {<br />
return {<br />
executors: {<br />
label: 'Исполнители', <br />
get: () => indicator?.result?.executors<br />
},<br />
methodic: {<br />
label: 'Методики', <br />
get: () => indicator?.methodics<br />
},<br />
averageResult: {<br />
label: 'Средний результат', <br />
get: () => indicator?.result?.averageValue<br />
},<br />
averageRoundedValue: {<br />
label: 'Средний округлённый результат', <br />
get: () => indicator?.result?.averageRoundedValue<br />
}<br />
}<br />
}<br />
<br />
const config = {<br />
requiredFields: [<br />
'Источник',<br />
'Место отбора',<br />
'Дата регистрации',<br />
'Шифр пробы',<br />
'Время регистрации'<br />
],<br />
indicatorsList: [<br />
'Аммоний-ион'<br />
],<br />
journalRecordId: 144, // Мк / Тест_Ушакова<br />
integrationResult: { message: 'Все поля заполнены!' }<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: 'Все необходимые поля заполнены!',<br />
emptyIndicators: (recordId) => `в записи с Id ${recordId} отсутствуют показатели`,<br />
emptyFieldsError: (fields, recordId) => `Поля ${fields.map(f => `"${f}"`).join(', ')} не заполнены в записи с ID ${recordId}`,<br />
indicators: (indicators: string[], recordId) => `Показатели ${indicators.map(f => `"${f}"`).join(', ')} отсутствуют в записи с ID ${recordId}`,<br />
emptyIndicatorsProps: (props: Record<string, string[]>, recordId) => {<br />
const propsString = Object.keys(props).map(prop => !isEmptyArray(props[prop]) ? `${prop}: ${props[prop].map(p => `"${p}"`).join(', ')}` : '').join('; ')<br />
return `В записи с Id ${recordId} отсутствуют либо не заполнены следующие поля у показателей: ${propsString}`<br />
}<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
fieldsError: (emptyFields, recordId) => {<br />
throw new Error(messages.emptyFieldsError(emptyFields, recordId))<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
},<br />
indicatorsError: (recordId) =>{<br />
throw new Error(messages.emptyIndicators(recordId))<br />
},<br />
notFoundIndicators: (indicators: string[], recordId: number) => {<br />
throw new Error(messages.indicators(indicators, recordId))<br />
},<br />
notFilledIndicatorProps: (props: Record<string, string[]>) => {<br />
throw new Error(messages.emptyIndicatorsProps(props, config.journalRecordId))<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const isEmptyArray = (arr: unknown[]) => {<br />
return Array.isArray(arr) && arr.length === 0<br />
}<br />
<br />
const hasIndicators = (journalRecordManager: IJournalRecordManager) => {<br />
const indicators = journalRecordManager?.data?.indicators<br />
return Array.isArray(indicators) && indicators.length > 0<br />
}<br />
<br />
const getNotFoundIndicators = (indicators: JournalRecordIndicatorResponse[], indicatorsList = config.indicatorsList) => {<br />
return indicatorsList.filter(ind => indicators.every(ljInd => ljInd?.indicator?.name?.toLowerCase() !== ind.toLocaleLowerCase()))<br />
} <br />
<br />
const getNotFilledResultsFields = (indicators: JournalRecordIndicatorResponse[]): Record<string, string[]> => {<br />
return indicators.reduce((acc, indicator) => {<br />
const config = indicatorPropsConfig(indicator)<br />
return {<br />
...acc,<br />
[indicator?.indicator?.name]: Object.keys(config).reduce((acc, prop) => {<br />
if (!config[prop].get()) return [...acc, config[prop].label]<br />
return acc<br />
}, [] as string[])<br />
}<br />
}, {}) as Record<string, string[]><br />
}<br />
<br />
const hasNotFilledProps = (indicatorsProps: Record<string, string[]>) => {<br />
return Object.keys(indicatorsProps).some(indicator => !isEmptyArray(indicatorsProps[indicator]))<br />
}<br />
<br />
const hasNotFoundIndicators = (indicators: string[]) => !isEmptyArray(indicators)<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
<br />
if (!hasIndicators(journalRecordManager)) {<br />
errorHandlers.indicatorsError(journalRecordManager.journalRecordId)<br />
}<br />
<br />
const indicators = journalRecordManager?.data?.indicators<br />
<br />
const notFoundIndicators = getNotFoundIndicators(indicators)<br />
if (hasNotFoundIndicators(notFoundIndicators)) { <br />
errorHandlers.notFoundIndicators(notFoundIndicators, journalRecordManager.journalRecordId)<br />
}<br />
<br />
const emptyIndicatorProps = getNotFilledResultsFields(indicators)<br />
if (hasNotFilledProps(emptyIndicatorProps)) {<br />
errorHandlers.notFilledIndicatorProps(emptyIndicatorProps)<br />
}<br />
<br />
showSuccessMessage(messages.success, socketId)<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
<br />
== Проверка заполненности атрибутов записи ЛЖ. <code>check-record-fields-filled</code> ==<br />
[[Файл:Check-record-fields-filled.png|frame]]<br />
Проверяет заполненность заданных полей в записи журнала (например, "Источник", "Место отбора", "Дата регистрации" и др.). Если какое-либо из обязательных полей не заполнено, выдаётся соответствующая ошибка.<br />
<br />
== Проверка движения пробы. <code>check-sample-moving</code> ==<br />
[[Файл:Check-sample-moving.png|frame]]<br />
Проверяет маршрут движения пробы по этапам. Получает историю перемещений записи и определяет, происходило ли движение (нахождение более чем на одном этапе). Отображает маршрут или сообщает, что движение не происходило.<br />
<br />
== Проверка прав пользователя. <code>check-user-rights</code> ==<br />
[[Файл:Check-user-rights.png|frame]]<br />
Проверяет права доступа пользователя к определённым ресурсам (объекты анализа, методики, записи ЛЖ). Отображает таблицу с типами доступа (чтение, запись и т.д.) и наличием прав по каждому ресурсу.<br />
<br />
== Заполнение атрибутов записи ЛЖ. <code>fill-record-fields</code> ==<br />
[[Файл:Fill-record-fields.png|frame]]<br />
Автоматически заполняет заданные поля в записи журнала (например, даты, место отбора, шифр пробы и др.). Есть возможность использования ключевых слов для сопоставления полей, если точные названия не совпадают.<br />
<br />
== Деление данных. <code>copy-journal-record</code> ==<br />
[[Файл:Copy-journal-record.png|frame]]<br />
Создаёт копию записи журнала на заданном этапе маршрута. Выводит сообщение с ID новой записи.</div>
Arhidiman
https://wiki.chemsoft.ru/index.php?title=%D0%90%D0%B4%D0%B4%D0%BE%D0%BD%D1%8B&diff=2365
Аддоны
2026-04-02T01:15:01Z
<p>Arhidiman: /* Проверка даты регистрации. check-registration-date */</p>
<hr />
<div>Список демонстрационных аддонов, показывающих возможности интеграционного сервиса.<br />
<br />
== Проверка даты регистрации. <code>check-registration-date</code> ==<br />
[[Файл:check-registration-date.png|frame]]<br />
Проверяет, не истёк ли срок регистрации пробы. Сравнивает дату регистрации из указанного поля с текущей датой. Если прошло более заданного количества дней (по умолчанию — 10), выдаёт ошибку. В противном случае показывает сообщение об успешной проверке.<br />
<br />
<br />
{{Collapse<br />
| title=Посмотреть код<br />
| content=<syntaxhighlight lang="cpp"><br />
#include <iostream><br />
int main() {<br />
std::cout << "Hello, World!" << std::endl;<br />
return 0;<br />
}<br />
</syntaxhighlight><br />
}}<br />
<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Код</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { MessageBoxResults } from "@triteia/types-integration-gui"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { DialogType } from "@triteia/types-integration-gui"<br />
<br />
const config = {<br />
dateField: 'Дата регистрации',<br />
expirationLimit: 10,<br />
journalRecordId: 201, // Лаб. воздуха / Анализы завершены<br />
integrationResult: { message: 'Срок регистрации пробы не истёк !'}<br />
}<br />
<br />
const messages = {<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
success: (recordId) => `Срок регистрации пробы не истёк ! Id записи ${recordId}`,<br />
expired: (limit, recordId) => `Срок регистрации пробы истёк!\nПрошло более ${ limit } дней с момента регистрации. Id записи: ${recordId}`,<br />
dateField: (dateField, stageName, journalRecordId) => [<br />
`Не заполнено либо отсутствует поле "${dateField}"`,<br />
`в этапе "${stageName || ''}".\nId записи: ${journalRecordId}`<br />
].join(' ')<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
},<br />
dateError: (dateField, stageName, journalRecordId) => {<br />
throw new Error(messages.dateField(dateField, stageName, journalRecordId))<br />
},<br />
expirationError: () => {<br />
throw new Error(messages.expired(config.expirationLimit, config.journalRecordId))<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const getDaysByDate = (date: Date) => {<br />
const dayMs = 60 * 60 * 24 * 1000<br />
const timestamp = date.getTime()<br />
return timestamp/dayMs<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getExpirationOffset = (registrationDate: string) => {<br />
const regDate = new Date(registrationDate)<br />
const today = new Date()<br />
return getDaysByDate(today) - getDaysByDate(regDate)<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
async function main({ queryParams }) {<br />
<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
const date = journalRecordManager.getFieldValue(config.dateField)<br />
<br />
if (!date) errorHandlers.dateError(config.dateField, journalRecordManager?.data?.stage?.stage?.name, config.journalRecordId)<br />
<br />
const expirationOffset = getExpirationOffset(date as string)<br />
<br />
if (expirationOffset >= config.expirationLimit) errorHandlers.expirationError()<br />
<br />
await showSuccessMessage(messages.success(config.journalRecordId), socketId)<br />
<br />
return config.integrationResult<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка заполненности полей показателей. <code>check-indicator-fields-filled</code> ==<br />
[[Файл:Check-indicator-fields-filled.png|frame]]<br />
Проверяет заполненность полей показателей в записи журнала по настраиваемому списку. Проверяет наличие определённых показателей (например, "Аммоний-ион") и заполненность у них таких полей, как исполнители, методики, средний результат и др. Выдаёт ошибку, если показатели отсутствуют или не все поля заполнены.<br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import type { DialogType } from "@triteia/types-integration-gui"<br />
import type { JournalRecordIndicatorResponse } from "../../src/servivces/worker/api/controllers/journal-records"<br />
import type { IJournalRecordManager } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
<br />
type IndicatorProp = { label: string, get: () => unknown }<br />
type IndicatorPropsConfig = Record<string, IndicatorProp><br />
<br />
const indicatorPropsConfig = (indicator): IndicatorPropsConfig => {<br />
return {<br />
executors: {<br />
label: 'Исполнители', <br />
get: () => indicator?.result?.executors<br />
},<br />
methodic: {<br />
label: 'Методики', <br />
get: () => indicator?.methodics<br />
},<br />
averageResult: {<br />
label: 'Средний результат', <br />
get: () => indicator?.result?.averageValue<br />
},<br />
averageRoundedValue: {<br />
label: 'Средний округлённый результат', <br />
get: () => indicator?.result?.averageRoundedValue<br />
}<br />
}<br />
}<br />
<br />
const config = {<br />
requiredFields: [<br />
'Источник',<br />
'Место отбора',<br />
'Дата регистрации',<br />
'Шифр пробы',<br />
'Время регистрации'<br />
],<br />
indicatorsList: [<br />
'Аммоний-ион'<br />
],<br />
journalRecordId: 144, // Мк / Тест_Ушакова<br />
integrationResult: { message: 'Все поля заполнены!' }<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: 'Все необходимые поля заполнены!',<br />
emptyIndicators: (recordId) => `в записи с Id ${recordId} отсутствуют показатели`,<br />
emptyFieldsError: (fields, recordId) => `Поля ${fields.map(f => `"${f}"`).join(', ')} не заполнены в записи с ID ${recordId}`,<br />
indicators: (indicators: string[], recordId) => `Показатели ${indicators.map(f => `"${f}"`).join(', ')} отсутствуют в записи с ID ${recordId}`,<br />
emptyIndicatorsProps: (props: Record<string, string[]>, recordId) => {<br />
const propsString = Object.keys(props).map(prop => !isEmptyArray(props[prop]) ? `${prop}: ${props[prop].map(p => `"${p}"`).join(', ')}` : '').join('; ')<br />
return `В записи с Id ${recordId} отсутствуют либо не заполнены следующие поля у показателей: ${propsString}`<br />
}<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
fieldsError: (emptyFields, recordId) => {<br />
throw new Error(messages.emptyFieldsError(emptyFields, recordId))<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
},<br />
indicatorsError: (recordId) =>{<br />
throw new Error(messages.emptyIndicators(recordId))<br />
},<br />
notFoundIndicators: (indicators: string[], recordId: number) => {<br />
throw new Error(messages.indicators(indicators, recordId))<br />
},<br />
notFilledIndicatorProps: (props: Record<string, string[]>) => {<br />
throw new Error(messages.emptyIndicatorsProps(props, config.journalRecordId))<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const isEmptyArray = (arr: unknown[]) => {<br />
return Array.isArray(arr) && arr.length === 0<br />
}<br />
<br />
const hasIndicators = (journalRecordManager: IJournalRecordManager) => {<br />
const indicators = journalRecordManager?.data?.indicators<br />
return Array.isArray(indicators) && indicators.length > 0<br />
}<br />
<br />
const getNotFoundIndicators = (indicators: JournalRecordIndicatorResponse[], indicatorsList = config.indicatorsList) => {<br />
return indicatorsList.filter(ind => indicators.every(ljInd => ljInd?.indicator?.name?.toLowerCase() !== ind.toLocaleLowerCase()))<br />
} <br />
<br />
const getNotFilledResultsFields = (indicators: JournalRecordIndicatorResponse[]): Record<string, string[]> => {<br />
return indicators.reduce((acc, indicator) => {<br />
const config = indicatorPropsConfig(indicator)<br />
return {<br />
...acc,<br />
[indicator?.indicator?.name]: Object.keys(config).reduce((acc, prop) => {<br />
if (!config[prop].get()) return [...acc, config[prop].label]<br />
return acc<br />
}, [] as string[])<br />
}<br />
}, {}) as Record<string, string[]><br />
}<br />
<br />
const hasNotFilledProps = (indicatorsProps: Record<string, string[]>) => {<br />
return Object.keys(indicatorsProps).some(indicator => !isEmptyArray(indicatorsProps[indicator]))<br />
}<br />
<br />
const hasNotFoundIndicators = (indicators: string[]) => !isEmptyArray(indicators)<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
<br />
if (!hasIndicators(journalRecordManager)) {<br />
errorHandlers.indicatorsError(journalRecordManager.journalRecordId)<br />
}<br />
<br />
const indicators = journalRecordManager?.data?.indicators<br />
<br />
const notFoundIndicators = getNotFoundIndicators(indicators)<br />
if (hasNotFoundIndicators(notFoundIndicators)) { <br />
errorHandlers.notFoundIndicators(notFoundIndicators, journalRecordManager.journalRecordId)<br />
}<br />
<br />
const emptyIndicatorProps = getNotFilledResultsFields(indicators)<br />
if (hasNotFilledProps(emptyIndicatorProps)) {<br />
errorHandlers.notFilledIndicatorProps(emptyIndicatorProps)<br />
}<br />
<br />
showSuccessMessage(messages.success, socketId)<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
<br />
== Проверка заполненности атрибутов записи ЛЖ. <code>check-record-fields-filled</code> ==<br />
[[Файл:Check-record-fields-filled.png|frame]]<br />
Проверяет заполненность заданных полей в записи журнала (например, "Источник", "Место отбора", "Дата регистрации" и др.). Если какое-либо из обязательных полей не заполнено, выдаётся соответствующая ошибка.<br />
<br />
== Проверка движения пробы. <code>check-sample-moving</code> ==<br />
[[Файл:Check-sample-moving.png|frame]]<br />
Проверяет маршрут движения пробы по этапам. Получает историю перемещений записи и определяет, происходило ли движение (нахождение более чем на одном этапе). Отображает маршрут или сообщает, что движение не происходило.<br />
<br />
== Проверка прав пользователя. <code>check-user-rights</code> ==<br />
[[Файл:Check-user-rights.png|frame]]<br />
Проверяет права доступа пользователя к определённым ресурсам (объекты анализа, методики, записи ЛЖ). Отображает таблицу с типами доступа (чтение, запись и т.д.) и наличием прав по каждому ресурсу.<br />
<br />
== Заполнение атрибутов записи ЛЖ. <code>fill-record-fields</code> ==<br />
[[Файл:Fill-record-fields.png|frame]]<br />
Автоматически заполняет заданные поля в записи журнала (например, даты, место отбора, шифр пробы и др.). Есть возможность использования ключевых слов для сопоставления полей, если точные названия не совпадают.<br />
<br />
== Деление данных. <code>copy-journal-record</code> ==<br />
[[Файл:Copy-journal-record.png|frame]]<br />
Создаёт копию записи журнала на заданном этапе маршрута. Выводит сообщение с ID новой записи.</div>
Arhidiman
https://wiki.chemsoft.ru/index.php?title=%D0%90%D0%B4%D0%B4%D0%BE%D0%BD%D1%8B&diff=2364
Аддоны
2026-04-02T01:13:12Z
<p>Arhidiman: /* Проверка даты регистрации. check-registration-date */</p>
<hr />
<div>Список демонстрационных аддонов, показывающих возможности интеграционного сервиса.<br />
<br />
== Проверка даты регистрации. <code>check-registration-date</code> ==<br />
[[Файл:check-registration-date.png|frame]]<br />
Проверяет, не истёк ли срок регистрации пробы. Сравнивает дату регистрации из указанного поля с текущей датой. Если прошло более заданного количества дней (по умолчанию — 10), выдаёт ошибку. В противном случае показывает сообщение об успешной проверке.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 2px;"><br />
<strong>Код</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { MessageBoxResults } from "@triteia/types-integration-gui"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { DialogType } from "@triteia/types-integration-gui"<br />
<br />
const config = {<br />
dateField: 'Дата регистрации',<br />
expirationLimit: 10,<br />
journalRecordId: 201, // Лаб. воздуха / Анализы завершены<br />
integrationResult: { message: 'Срок регистрации пробы не истёк !'}<br />
}<br />
<br />
const messages = {<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
success: (recordId) => `Срок регистрации пробы не истёк ! Id записи ${recordId}`,<br />
expired: (limit, recordId) => `Срок регистрации пробы истёк!\nПрошло более ${ limit } дней с момента регистрации. Id записи: ${recordId}`,<br />
dateField: (dateField, stageName, journalRecordId) => [<br />
`Не заполнено либо отсутствует поле "${dateField}"`,<br />
`в этапе "${stageName || ''}".\nId записи: ${journalRecordId}`<br />
].join(' ')<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
},<br />
dateError: (dateField, stageName, journalRecordId) => {<br />
throw new Error(messages.dateField(dateField, stageName, journalRecordId))<br />
},<br />
expirationError: () => {<br />
throw new Error(messages.expired(config.expirationLimit, config.journalRecordId))<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const getDaysByDate = (date: Date) => {<br />
const dayMs = 60 * 60 * 24 * 1000<br />
const timestamp = date.getTime()<br />
return timestamp/dayMs<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getExpirationOffset = (registrationDate: string) => {<br />
const regDate = new Date(registrationDate)<br />
const today = new Date()<br />
return getDaysByDate(today) - getDaysByDate(regDate)<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
async function main({ queryParams }) {<br />
<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
const date = journalRecordManager.getFieldValue(config.dateField)<br />
<br />
if (!date) errorHandlers.dateError(config.dateField, journalRecordManager?.data?.stage?.stage?.name, config.journalRecordId)<br />
<br />
const expirationOffset = getExpirationOffset(date as string)<br />
<br />
if (expirationOffset >= config.expirationLimit) errorHandlers.expirationError()<br />
<br />
await showSuccessMessage(messages.success(config.journalRecordId), socketId)<br />
<br />
return config.integrationResult<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка заполненности полей показателей. <code>check-indicator-fields-filled</code> ==<br />
[[Файл:Check-indicator-fields-filled.png|frame]]<br />
Проверяет заполненность полей показателей в записи журнала по настраиваемому списку. Проверяет наличие определённых показателей (например, "Аммоний-ион") и заполненность у них таких полей, как исполнители, методики, средний результат и др. Выдаёт ошибку, если показатели отсутствуют или не все поля заполнены.<br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import type { DialogType } from "@triteia/types-integration-gui"<br />
import type { JournalRecordIndicatorResponse } from "../../src/servivces/worker/api/controllers/journal-records"<br />
import type { IJournalRecordManager } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
<br />
type IndicatorProp = { label: string, get: () => unknown }<br />
type IndicatorPropsConfig = Record<string, IndicatorProp><br />
<br />
const indicatorPropsConfig = (indicator): IndicatorPropsConfig => {<br />
return {<br />
executors: {<br />
label: 'Исполнители', <br />
get: () => indicator?.result?.executors<br />
},<br />
methodic: {<br />
label: 'Методики', <br />
get: () => indicator?.methodics<br />
},<br />
averageResult: {<br />
label: 'Средний результат', <br />
get: () => indicator?.result?.averageValue<br />
},<br />
averageRoundedValue: {<br />
label: 'Средний округлённый результат', <br />
get: () => indicator?.result?.averageRoundedValue<br />
}<br />
}<br />
}<br />
<br />
const config = {<br />
requiredFields: [<br />
'Источник',<br />
'Место отбора',<br />
'Дата регистрации',<br />
'Шифр пробы',<br />
'Время регистрации'<br />
],<br />
indicatorsList: [<br />
'Аммоний-ион'<br />
],<br />
journalRecordId: 144, // Мк / Тест_Ушакова<br />
integrationResult: { message: 'Все поля заполнены!' }<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: 'Все необходимые поля заполнены!',<br />
emptyIndicators: (recordId) => `в записи с Id ${recordId} отсутствуют показатели`,<br />
emptyFieldsError: (fields, recordId) => `Поля ${fields.map(f => `"${f}"`).join(', ')} не заполнены в записи с ID ${recordId}`,<br />
indicators: (indicators: string[], recordId) => `Показатели ${indicators.map(f => `"${f}"`).join(', ')} отсутствуют в записи с ID ${recordId}`,<br />
emptyIndicatorsProps: (props: Record<string, string[]>, recordId) => {<br />
const propsString = Object.keys(props).map(prop => !isEmptyArray(props[prop]) ? `${prop}: ${props[prop].map(p => `"${p}"`).join(', ')}` : '').join('; ')<br />
return `В записи с Id ${recordId} отсутствуют либо не заполнены следующие поля у показателей: ${propsString}`<br />
}<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
fieldsError: (emptyFields, recordId) => {<br />
throw new Error(messages.emptyFieldsError(emptyFields, recordId))<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
},<br />
indicatorsError: (recordId) =>{<br />
throw new Error(messages.emptyIndicators(recordId))<br />
},<br />
notFoundIndicators: (indicators: string[], recordId: number) => {<br />
throw new Error(messages.indicators(indicators, recordId))<br />
},<br />
notFilledIndicatorProps: (props: Record<string, string[]>) => {<br />
throw new Error(messages.emptyIndicatorsProps(props, config.journalRecordId))<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const isEmptyArray = (arr: unknown[]) => {<br />
return Array.isArray(arr) && arr.length === 0<br />
}<br />
<br />
const hasIndicators = (journalRecordManager: IJournalRecordManager) => {<br />
const indicators = journalRecordManager?.data?.indicators<br />
return Array.isArray(indicators) && indicators.length > 0<br />
}<br />
<br />
const getNotFoundIndicators = (indicators: JournalRecordIndicatorResponse[], indicatorsList = config.indicatorsList) => {<br />
return indicatorsList.filter(ind => indicators.every(ljInd => ljInd?.indicator?.name?.toLowerCase() !== ind.toLocaleLowerCase()))<br />
} <br />
<br />
const getNotFilledResultsFields = (indicators: JournalRecordIndicatorResponse[]): Record<string, string[]> => {<br />
return indicators.reduce((acc, indicator) => {<br />
const config = indicatorPropsConfig(indicator)<br />
return {<br />
...acc,<br />
[indicator?.indicator?.name]: Object.keys(config).reduce((acc, prop) => {<br />
if (!config[prop].get()) return [...acc, config[prop].label]<br />
return acc<br />
}, [] as string[])<br />
}<br />
}, {}) as Record<string, string[]><br />
}<br />
<br />
const hasNotFilledProps = (indicatorsProps: Record<string, string[]>) => {<br />
return Object.keys(indicatorsProps).some(indicator => !isEmptyArray(indicatorsProps[indicator]))<br />
}<br />
<br />
const hasNotFoundIndicators = (indicators: string[]) => !isEmptyArray(indicators)<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
<br />
if (!hasIndicators(journalRecordManager)) {<br />
errorHandlers.indicatorsError(journalRecordManager.journalRecordId)<br />
}<br />
<br />
const indicators = journalRecordManager?.data?.indicators<br />
<br />
const notFoundIndicators = getNotFoundIndicators(indicators)<br />
if (hasNotFoundIndicators(notFoundIndicators)) { <br />
errorHandlers.notFoundIndicators(notFoundIndicators, journalRecordManager.journalRecordId)<br />
}<br />
<br />
const emptyIndicatorProps = getNotFilledResultsFields(indicators)<br />
if (hasNotFilledProps(emptyIndicatorProps)) {<br />
errorHandlers.notFilledIndicatorProps(emptyIndicatorProps)<br />
}<br />
<br />
showSuccessMessage(messages.success, socketId)<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
<br />
== Проверка заполненности атрибутов записи ЛЖ. <code>check-record-fields-filled</code> ==<br />
[[Файл:Check-record-fields-filled.png|frame]]<br />
Проверяет заполненность заданных полей в записи журнала (например, "Источник", "Место отбора", "Дата регистрации" и др.). Если какое-либо из обязательных полей не заполнено, выдаётся соответствующая ошибка.<br />
<br />
== Проверка движения пробы. <code>check-sample-moving</code> ==<br />
[[Файл:Check-sample-moving.png|frame]]<br />
Проверяет маршрут движения пробы по этапам. Получает историю перемещений записи и определяет, происходило ли движение (нахождение более чем на одном этапе). Отображает маршрут или сообщает, что движение не происходило.<br />
<br />
== Проверка прав пользователя. <code>check-user-rights</code> ==<br />
[[Файл:Check-user-rights.png|frame]]<br />
Проверяет права доступа пользователя к определённым ресурсам (объекты анализа, методики, записи ЛЖ). Отображает таблицу с типами доступа (чтение, запись и т.д.) и наличием прав по каждому ресурсу.<br />
<br />
== Заполнение атрибутов записи ЛЖ. <code>fill-record-fields</code> ==<br />
[[Файл:Fill-record-fields.png|frame]]<br />
Автоматически заполняет заданные поля в записи журнала (например, даты, место отбора, шифр пробы и др.). Есть возможность использования ключевых слов для сопоставления полей, если точные названия не совпадают.<br />
<br />
== Деление данных. <code>copy-journal-record</code> ==<br />
[[Файл:Copy-journal-record.png|frame]]<br />
Создаёт копию записи журнала на заданном этапе маршрута. Выводит сообщение с ID новой записи.</div>
Arhidiman
https://wiki.chemsoft.ru/index.php?title=%D0%90%D0%B4%D0%B4%D0%BE%D0%BD%D1%8B&diff=2362
Аддоны
2026-04-02T01:11:21Z
<p>Arhidiman: /* Проверка даты регистрации. check-registration-date */</p>
<hr />
<div>Список демонстрационных аддонов, показывающих возможности интеграционного сервиса.<br />
<br />
== Проверка даты регистрации. <code>check-registration-date</code> ==<br />
[[Файл:check-registration-date.png|frame]]<br />
Проверяет, не истёк ли срок регистрации пробы. Сравнивает дату регистрации из указанного поля с текущей датой. Если прошло более заданного количества дней (по умолчанию — 10), выдаёт ошибку. В противном случае показывает сообщение об успешной проверке.<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 10px;"><br />
<strong>Код</strong><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { MessageBoxResults } from "@triteia/types-integration-gui"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { DialogType } from "@triteia/types-integration-gui"<br />
<br />
const config = {<br />
dateField: 'Дата регистрации',<br />
expirationLimit: 10,<br />
journalRecordId: 201, // Лаб. воздуха / Анализы завершены<br />
integrationResult: { message: 'Срок регистрации пробы не истёк !'}<br />
}<br />
<br />
const messages = {<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
success: (recordId) => `Срок регистрации пробы не истёк ! Id записи ${recordId}`,<br />
expired: (limit, recordId) => `Срок регистрации пробы истёк!\nПрошло более ${ limit } дней с момента регистрации. Id записи: ${recordId}`,<br />
dateField: (dateField, stageName, journalRecordId) => [<br />
`Не заполнено либо отсутствует поле "${dateField}"`,<br />
`в этапе "${stageName || ''}".\nId записи: ${journalRecordId}`<br />
].join(' ')<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
},<br />
dateError: (dateField, stageName, journalRecordId) => {<br />
throw new Error(messages.dateField(dateField, stageName, journalRecordId))<br />
},<br />
expirationError: () => {<br />
throw new Error(messages.expired(config.expirationLimit, config.journalRecordId))<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const getDaysByDate = (date: Date) => {<br />
const dayMs = 60 * 60 * 24 * 1000<br />
const timestamp = date.getTime()<br />
return timestamp/dayMs<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getExpirationOffset = (registrationDate: string) => {<br />
const regDate = new Date(registrationDate)<br />
const today = new Date()<br />
return getDaysByDate(today) - getDaysByDate(regDate)<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
async function main({ queryParams }) {<br />
<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
const date = journalRecordManager.getFieldValue(config.dateField)<br />
<br />
if (!date) errorHandlers.dateError(config.dateField, journalRecordManager?.data?.stage?.stage?.name, config.journalRecordId)<br />
<br />
const expirationOffset = getExpirationOffset(date as string)<br />
<br />
if (expirationOffset >= config.expirationLimit) errorHandlers.expirationError()<br />
<br />
await showSuccessMessage(messages.success(config.journalRecordId), socketId)<br />
<br />
return config.integrationResult<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка заполненности полей показателей. <code>check-indicator-fields-filled</code> ==<br />
[[Файл:Check-indicator-fields-filled.png|frame]]<br />
Проверяет заполненность полей показателей в записи журнала по настраиваемому списку. Проверяет наличие определённых показателей (например, "Аммоний-ион") и заполненность у них таких полей, как исполнители, методики, средний результат и др. Выдаёт ошибку, если показатели отсутствуют или не все поля заполнены.<br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import type { DialogType } from "@triteia/types-integration-gui"<br />
import type { JournalRecordIndicatorResponse } from "../../src/servivces/worker/api/controllers/journal-records"<br />
import type { IJournalRecordManager } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
<br />
type IndicatorProp = { label: string, get: () => unknown }<br />
type IndicatorPropsConfig = Record<string, IndicatorProp><br />
<br />
const indicatorPropsConfig = (indicator): IndicatorPropsConfig => {<br />
return {<br />
executors: {<br />
label: 'Исполнители', <br />
get: () => indicator?.result?.executors<br />
},<br />
methodic: {<br />
label: 'Методики', <br />
get: () => indicator?.methodics<br />
},<br />
averageResult: {<br />
label: 'Средний результат', <br />
get: () => indicator?.result?.averageValue<br />
},<br />
averageRoundedValue: {<br />
label: 'Средний округлённый результат', <br />
get: () => indicator?.result?.averageRoundedValue<br />
}<br />
}<br />
}<br />
<br />
const config = {<br />
requiredFields: [<br />
'Источник',<br />
'Место отбора',<br />
'Дата регистрации',<br />
'Шифр пробы',<br />
'Время регистрации'<br />
],<br />
indicatorsList: [<br />
'Аммоний-ион'<br />
],<br />
journalRecordId: 144, // Мк / Тест_Ушакова<br />
integrationResult: { message: 'Все поля заполнены!' }<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: 'Все необходимые поля заполнены!',<br />
emptyIndicators: (recordId) => `в записи с Id ${recordId} отсутствуют показатели`,<br />
emptyFieldsError: (fields, recordId) => `Поля ${fields.map(f => `"${f}"`).join(', ')} не заполнены в записи с ID ${recordId}`,<br />
indicators: (indicators: string[], recordId) => `Показатели ${indicators.map(f => `"${f}"`).join(', ')} отсутствуют в записи с ID ${recordId}`,<br />
emptyIndicatorsProps: (props: Record<string, string[]>, recordId) => {<br />
const propsString = Object.keys(props).map(prop => !isEmptyArray(props[prop]) ? `${prop}: ${props[prop].map(p => `"${p}"`).join(', ')}` : '').join('; ')<br />
return `В записи с Id ${recordId} отсутствуют либо не заполнены следующие поля у показателей: ${propsString}`<br />
}<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
fieldsError: (emptyFields, recordId) => {<br />
throw new Error(messages.emptyFieldsError(emptyFields, recordId))<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
},<br />
indicatorsError: (recordId) =>{<br />
throw new Error(messages.emptyIndicators(recordId))<br />
},<br />
notFoundIndicators: (indicators: string[], recordId: number) => {<br />
throw new Error(messages.indicators(indicators, recordId))<br />
},<br />
notFilledIndicatorProps: (props: Record<string, string[]>) => {<br />
throw new Error(messages.emptyIndicatorsProps(props, config.journalRecordId))<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const isEmptyArray = (arr: unknown[]) => {<br />
return Array.isArray(arr) && arr.length === 0<br />
}<br />
<br />
const hasIndicators = (journalRecordManager: IJournalRecordManager) => {<br />
const indicators = journalRecordManager?.data?.indicators<br />
return Array.isArray(indicators) && indicators.length > 0<br />
}<br />
<br />
const getNotFoundIndicators = (indicators: JournalRecordIndicatorResponse[], indicatorsList = config.indicatorsList) => {<br />
return indicatorsList.filter(ind => indicators.every(ljInd => ljInd?.indicator?.name?.toLowerCase() !== ind.toLocaleLowerCase()))<br />
} <br />
<br />
const getNotFilledResultsFields = (indicators: JournalRecordIndicatorResponse[]): Record<string, string[]> => {<br />
return indicators.reduce((acc, indicator) => {<br />
const config = indicatorPropsConfig(indicator)<br />
return {<br />
...acc,<br />
[indicator?.indicator?.name]: Object.keys(config).reduce((acc, prop) => {<br />
if (!config[prop].get()) return [...acc, config[prop].label]<br />
return acc<br />
}, [] as string[])<br />
}<br />
}, {}) as Record<string, string[]><br />
}<br />
<br />
const hasNotFilledProps = (indicatorsProps: Record<string, string[]>) => {<br />
return Object.keys(indicatorsProps).some(indicator => !isEmptyArray(indicatorsProps[indicator]))<br />
}<br />
<br />
const hasNotFoundIndicators = (indicators: string[]) => !isEmptyArray(indicators)<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
<br />
if (!hasIndicators(journalRecordManager)) {<br />
errorHandlers.indicatorsError(journalRecordManager.journalRecordId)<br />
}<br />
<br />
const indicators = journalRecordManager?.data?.indicators<br />
<br />
const notFoundIndicators = getNotFoundIndicators(indicators)<br />
if (hasNotFoundIndicators(notFoundIndicators)) { <br />
errorHandlers.notFoundIndicators(notFoundIndicators, journalRecordManager.journalRecordId)<br />
}<br />
<br />
const emptyIndicatorProps = getNotFilledResultsFields(indicators)<br />
if (hasNotFilledProps(emptyIndicatorProps)) {<br />
errorHandlers.notFilledIndicatorProps(emptyIndicatorProps)<br />
}<br />
<br />
showSuccessMessage(messages.success, socketId)<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
<br />
== Проверка заполненности атрибутов записи ЛЖ. <code>check-record-fields-filled</code> ==<br />
[[Файл:Check-record-fields-filled.png|frame]]<br />
Проверяет заполненность заданных полей в записи журнала (например, "Источник", "Место отбора", "Дата регистрации" и др.). Если какое-либо из обязательных полей не заполнено, выдаётся соответствующая ошибка.<br />
<br />
== Проверка движения пробы. <code>check-sample-moving</code> ==<br />
[[Файл:Check-sample-moving.png|frame]]<br />
Проверяет маршрут движения пробы по этапам. Получает историю перемещений записи и определяет, происходило ли движение (нахождение более чем на одном этапе). Отображает маршрут или сообщает, что движение не происходило.<br />
<br />
== Проверка прав пользователя. <code>check-user-rights</code> ==<br />
[[Файл:Check-user-rights.png|frame]]<br />
Проверяет права доступа пользователя к определённым ресурсам (объекты анализа, методики, записи ЛЖ). Отображает таблицу с типами доступа (чтение, запись и т.д.) и наличием прав по каждому ресурсу.<br />
<br />
== Заполнение атрибутов записи ЛЖ. <code>fill-record-fields</code> ==<br />
[[Файл:Fill-record-fields.png|frame]]<br />
Автоматически заполняет заданные поля в записи журнала (например, даты, место отбора, шифр пробы и др.). Есть возможность использования ключевых слов для сопоставления полей, если точные названия не совпадают.<br />
<br />
== Деление данных. <code>copy-journal-record</code> ==<br />
[[Файл:Copy-journal-record.png|frame]]<br />
Создаёт копию записи журнала на заданном этапе маршрута. Выводит сообщение с ID новой записи.</div>
Arhidiman
https://wiki.chemsoft.ru/index.php?title=%D0%90%D0%B4%D0%B4%D0%BE%D0%BD%D1%8B&diff=2361
Аддоны
2026-04-02T01:10:21Z
<p>Arhidiman: /* Проверка даты регистрации. check-registration-date */</p>
<hr />
<div>Список демонстрационных аддонов, показывающих возможности интеграционного сервиса.<br />
<br />
== Проверка даты регистрации. <code>check-registration-date</code> ==<br />
[[Файл:check-registration-date.png|frame]]<br />
Проверяет, не истёк ли срок регистрации пробы. Сравнивает дату регистрации из указанного поля с текущей датой. Если прошло более заданного количества дней (по умолчанию — 10), выдаёт ошибку. В противном случае показывает сообщение об успешной проверке.<br />
<br />
<br />
<div class="mw-collapsible mw-collapsed"><br />
<div style="display: flex; align-items: center; gap: 10px;"><br />
<span class="mw-collapsible-toggle-placeholder"></span><br />
<strong>Код [свернуть]</strong><br />
</div><br />
<div class="mw-collapsible-content"><br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { MessageBoxResults } from "@triteia/types-integration-gui"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { DialogType } from "@triteia/types-integration-gui"<br />
<br />
const config = {<br />
dateField: 'Дата регистрации',<br />
expirationLimit: 10,<br />
journalRecordId: 201, // Лаб. воздуха / Анализы завершены<br />
integrationResult: { message: 'Срок регистрации пробы не истёк !'}<br />
}<br />
<br />
const messages = {<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
success: (recordId) => `Срок регистрации пробы не истёк ! Id записи ${recordId}`,<br />
expired: (limit, recordId) => `Срок регистрации пробы истёк!\nПрошло более ${ limit } дней с момента регистрации. Id записи: ${recordId}`,<br />
dateField: (dateField, stageName, journalRecordId) => [<br />
`Не заполнено либо отсутствует поле "${dateField}"`,<br />
`в этапе "${stageName || ''}".\nId записи: ${journalRecordId}`<br />
].join(' ')<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
},<br />
dateError: (dateField, stageName, journalRecordId) => {<br />
throw new Error(messages.dateField(dateField, stageName, journalRecordId))<br />
},<br />
expirationError: () => {<br />
throw new Error(messages.expired(config.expirationLimit, config.journalRecordId))<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const getDaysByDate = (date: Date) => {<br />
const dayMs = 60 * 60 * 24 * 1000<br />
const timestamp = date.getTime()<br />
return timestamp/dayMs<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getExpirationOffset = (registrationDate: string) => {<br />
const regDate = new Date(registrationDate)<br />
const today = new Date()<br />
return getDaysByDate(today) - getDaysByDate(regDate)<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
async function main({ queryParams }) {<br />
<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
const date = journalRecordManager.getFieldValue(config.dateField)<br />
<br />
if (!date) errorHandlers.dateError(config.dateField, journalRecordManager?.data?.stage?.stage?.name, config.journalRecordId)<br />
<br />
const expirationOffset = getExpirationOffset(date as string)<br />
<br />
if (expirationOffset >= config.expirationLimit) errorHandlers.expirationError()<br />
<br />
await showSuccessMessage(messages.success(config.journalRecordId), socketId)<br />
<br />
return config.integrationResult<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
</syntaxhighlight><br />
</div><br />
</div><br />
<br />
== Проверка заполненности полей показателей. <code>check-indicator-fields-filled</code> ==<br />
[[Файл:Check-indicator-fields-filled.png|frame]]<br />
Проверяет заполненность полей показателей в записи журнала по настраиваемому списку. Проверяет наличие определённых показателей (например, "Аммоний-ион") и заполненность у них таких полей, как исполнители, методики, средний результат и др. Выдаёт ошибку, если показатели отсутствуют или не все поля заполнены.<br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import type { DialogType } from "@triteia/types-integration-gui"<br />
import type { JournalRecordIndicatorResponse } from "../../src/servivces/worker/api/controllers/journal-records"<br />
import type { IJournalRecordManager } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
<br />
type IndicatorProp = { label: string, get: () => unknown }<br />
type IndicatorPropsConfig = Record<string, IndicatorProp><br />
<br />
const indicatorPropsConfig = (indicator): IndicatorPropsConfig => {<br />
return {<br />
executors: {<br />
label: 'Исполнители', <br />
get: () => indicator?.result?.executors<br />
},<br />
methodic: {<br />
label: 'Методики', <br />
get: () => indicator?.methodics<br />
},<br />
averageResult: {<br />
label: 'Средний результат', <br />
get: () => indicator?.result?.averageValue<br />
},<br />
averageRoundedValue: {<br />
label: 'Средний округлённый результат', <br />
get: () => indicator?.result?.averageRoundedValue<br />
}<br />
}<br />
}<br />
<br />
const config = {<br />
requiredFields: [<br />
'Источник',<br />
'Место отбора',<br />
'Дата регистрации',<br />
'Шифр пробы',<br />
'Время регистрации'<br />
],<br />
indicatorsList: [<br />
'Аммоний-ион'<br />
],<br />
journalRecordId: 144, // Мк / Тест_Ушакова<br />
integrationResult: { message: 'Все поля заполнены!' }<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: 'Все необходимые поля заполнены!',<br />
emptyIndicators: (recordId) => `в записи с Id ${recordId} отсутствуют показатели`,<br />
emptyFieldsError: (fields, recordId) => `Поля ${fields.map(f => `"${f}"`).join(', ')} не заполнены в записи с ID ${recordId}`,<br />
indicators: (indicators: string[], recordId) => `Показатели ${indicators.map(f => `"${f}"`).join(', ')} отсутствуют в записи с ID ${recordId}`,<br />
emptyIndicatorsProps: (props: Record<string, string[]>, recordId) => {<br />
const propsString = Object.keys(props).map(prop => !isEmptyArray(props[prop]) ? `${prop}: ${props[prop].map(p => `"${p}"`).join(', ')}` : '').join('; ')<br />
return `В записи с Id ${recordId} отсутствуют либо не заполнены следующие поля у показателей: ${propsString}`<br />
}<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
fieldsError: (emptyFields, recordId) => {<br />
throw new Error(messages.emptyFieldsError(emptyFields, recordId))<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
},<br />
indicatorsError: (recordId) =>{<br />
throw new Error(messages.emptyIndicators(recordId))<br />
},<br />
notFoundIndicators: (indicators: string[], recordId: number) => {<br />
throw new Error(messages.indicators(indicators, recordId))<br />
},<br />
notFilledIndicatorProps: (props: Record<string, string[]>) => {<br />
throw new Error(messages.emptyIndicatorsProps(props, config.journalRecordId))<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const isEmptyArray = (arr: unknown[]) => {<br />
return Array.isArray(arr) && arr.length === 0<br />
}<br />
<br />
const hasIndicators = (journalRecordManager: IJournalRecordManager) => {<br />
const indicators = journalRecordManager?.data?.indicators<br />
return Array.isArray(indicators) && indicators.length > 0<br />
}<br />
<br />
const getNotFoundIndicators = (indicators: JournalRecordIndicatorResponse[], indicatorsList = config.indicatorsList) => {<br />
return indicatorsList.filter(ind => indicators.every(ljInd => ljInd?.indicator?.name?.toLowerCase() !== ind.toLocaleLowerCase()))<br />
} <br />
<br />
const getNotFilledResultsFields = (indicators: JournalRecordIndicatorResponse[]): Record<string, string[]> => {<br />
return indicators.reduce((acc, indicator) => {<br />
const config = indicatorPropsConfig(indicator)<br />
return {<br />
...acc,<br />
[indicator?.indicator?.name]: Object.keys(config).reduce((acc, prop) => {<br />
if (!config[prop].get()) return [...acc, config[prop].label]<br />
return acc<br />
}, [] as string[])<br />
}<br />
}, {}) as Record<string, string[]><br />
}<br />
<br />
const hasNotFilledProps = (indicatorsProps: Record<string, string[]>) => {<br />
return Object.keys(indicatorsProps).some(indicator => !isEmptyArray(indicatorsProps[indicator]))<br />
}<br />
<br />
const hasNotFoundIndicators = (indicators: string[]) => !isEmptyArray(indicators)<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
<br />
if (!hasIndicators(journalRecordManager)) {<br />
errorHandlers.indicatorsError(journalRecordManager.journalRecordId)<br />
}<br />
<br />
const indicators = journalRecordManager?.data?.indicators<br />
<br />
const notFoundIndicators = getNotFoundIndicators(indicators)<br />
if (hasNotFoundIndicators(notFoundIndicators)) { <br />
errorHandlers.notFoundIndicators(notFoundIndicators, journalRecordManager.journalRecordId)<br />
}<br />
<br />
const emptyIndicatorProps = getNotFilledResultsFields(indicators)<br />
if (hasNotFilledProps(emptyIndicatorProps)) {<br />
errorHandlers.notFilledIndicatorProps(emptyIndicatorProps)<br />
}<br />
<br />
showSuccessMessage(messages.success, socketId)<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
<br />
== Проверка заполненности атрибутов записи ЛЖ. <code>check-record-fields-filled</code> ==<br />
[[Файл:Check-record-fields-filled.png|frame]]<br />
Проверяет заполненность заданных полей в записи журнала (например, "Источник", "Место отбора", "Дата регистрации" и др.). Если какое-либо из обязательных полей не заполнено, выдаётся соответствующая ошибка.<br />
<br />
== Проверка движения пробы. <code>check-sample-moving</code> ==<br />
[[Файл:Check-sample-moving.png|frame]]<br />
Проверяет маршрут движения пробы по этапам. Получает историю перемещений записи и определяет, происходило ли движение (нахождение более чем на одном этапе). Отображает маршрут или сообщает, что движение не происходило.<br />
<br />
== Проверка прав пользователя. <code>check-user-rights</code> ==<br />
[[Файл:Check-user-rights.png|frame]]<br />
Проверяет права доступа пользователя к определённым ресурсам (объекты анализа, методики, записи ЛЖ). Отображает таблицу с типами доступа (чтение, запись и т.д.) и наличием прав по каждому ресурсу.<br />
<br />
== Заполнение атрибутов записи ЛЖ. <code>fill-record-fields</code> ==<br />
[[Файл:Fill-record-fields.png|frame]]<br />
Автоматически заполняет заданные поля в записи журнала (например, даты, место отбора, шифр пробы и др.). Есть возможность использования ключевых слов для сопоставления полей, если точные названия не совпадают.<br />
<br />
== Деление данных. <code>copy-journal-record</code> ==<br />
[[Файл:Copy-journal-record.png|frame]]<br />
Создаёт копию записи журнала на заданном этапе маршрута. Выводит сообщение с ID новой записи.</div>
Arhidiman
https://wiki.chemsoft.ru/index.php?title=%D0%90%D0%B4%D0%B4%D0%BE%D0%BD%D1%8B&diff=2359
Аддоны
2026-04-02T01:06:43Z
<p>Arhidiman: /* Проверка даты регистрации. check-registration-date */</p>
<hr />
<div>Список демонстрационных аддонов, показывающих возможности интеграционного сервиса.<br />
<br />
== Проверка даты регистрации. <code>check-registration-date</code> ==<br />
[[Файл:check-registration-date.png|frame]]<br />
Проверяет, не истёк ли срок регистрации пробы. Сравнивает дату регистрации из указанного поля с текущей датой. Если прошло более заданного количества дней (по умолчанию — 10), выдаёт ошибку. В противном случае показывает сообщение об успешной проверке.<br />
<br />
<div class="mw-collapsible"><br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { MessageBoxResults } from "@triteia/types-integration-gui"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { DialogType } from "@triteia/types-integration-gui"<br />
<br />
const config = {<br />
dateField: 'Дата регистрации',<br />
expirationLimit: 10,<br />
journalRecordId: 201, // Лаб. воздуха / Анализы завершены<br />
integrationResult: { message: 'Срок регистрации пробы не истёк !'}<br />
}<br />
<br />
const messages = {<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
success: (recordId) => `Срок регистрации пробы не истёк ! Id записи ${recordId}`,<br />
expired: (limit, recordId) => `Срок регистрации пробы истёк!\nПрошло более ${ limit } дней с момента регистрации. Id записи: ${recordId}`,<br />
dateField: (dateField, stageName, journalRecordId) => [<br />
`Не заполнено либо отсутствует поле "${dateField}"`,<br />
`в этапе "${stageName || ''}".\nId записи: ${journalRecordId}`<br />
].join(' ')<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
},<br />
dateError: (dateField, stageName, journalRecordId) => {<br />
throw new Error(messages.dateField(dateField, stageName, journalRecordId))<br />
},<br />
expirationError: () => {<br />
throw new Error(messages.expired(config.expirationLimit, config.journalRecordId))<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const getDaysByDate = (date: Date) => {<br />
const dayMs = 60 * 60 * 24 * 1000<br />
const timestamp = date.getTime()<br />
return timestamp/dayMs<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getExpirationOffset = (registrationDate: string) => {<br />
const regDate = new Date(registrationDate)<br />
const today = new Date()<br />
return getDaysByDate(today) - getDaysByDate(regDate)<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
async function main({ queryParams }) {<br />
<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
const date = journalRecordManager.getFieldValue(config.dateField)<br />
<br />
if (!date) errorHandlers.dateError(config.dateField, journalRecordManager?.data?.stage?.stage?.name, config.journalRecordId)<br />
<br />
const expirationOffset = getExpirationOffset(date as string)<br />
<br />
if (expirationOffset >= config.expirationLimit) errorHandlers.expirationError()<br />
<br />
await showSuccessMessage(messages.success(config.journalRecordId), socketId)<br />
<br />
return config.integrationResult<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
</syntaxhighlight><br />
</div><br />
<br />
== Проверка заполненности полей показателей. <code>check-indicator-fields-filled</code> ==<br />
[[Файл:Check-indicator-fields-filled.png|frame]]<br />
Проверяет заполненность полей показателей в записи журнала по настраиваемому списку. Проверяет наличие определённых показателей (например, "Аммоний-ион") и заполненность у них таких полей, как исполнители, методики, средний результат и др. Выдаёт ошибку, если показатели отсутствуют или не все поля заполнены.<br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import type { DialogType } from "@triteia/types-integration-gui"<br />
import type { JournalRecordIndicatorResponse } from "../../src/servivces/worker/api/controllers/journal-records"<br />
import type { IJournalRecordManager } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
<br />
type IndicatorProp = { label: string, get: () => unknown }<br />
type IndicatorPropsConfig = Record<string, IndicatorProp><br />
<br />
const indicatorPropsConfig = (indicator): IndicatorPropsConfig => {<br />
return {<br />
executors: {<br />
label: 'Исполнители', <br />
get: () => indicator?.result?.executors<br />
},<br />
methodic: {<br />
label: 'Методики', <br />
get: () => indicator?.methodics<br />
},<br />
averageResult: {<br />
label: 'Средний результат', <br />
get: () => indicator?.result?.averageValue<br />
},<br />
averageRoundedValue: {<br />
label: 'Средний округлённый результат', <br />
get: () => indicator?.result?.averageRoundedValue<br />
}<br />
}<br />
}<br />
<br />
const config = {<br />
requiredFields: [<br />
'Источник',<br />
'Место отбора',<br />
'Дата регистрации',<br />
'Шифр пробы',<br />
'Время регистрации'<br />
],<br />
indicatorsList: [<br />
'Аммоний-ион'<br />
],<br />
journalRecordId: 144, // Мк / Тест_Ушакова<br />
integrationResult: { message: 'Все поля заполнены!' }<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: 'Все необходимые поля заполнены!',<br />
emptyIndicators: (recordId) => `в записи с Id ${recordId} отсутствуют показатели`,<br />
emptyFieldsError: (fields, recordId) => `Поля ${fields.map(f => `"${f}"`).join(', ')} не заполнены в записи с ID ${recordId}`,<br />
indicators: (indicators: string[], recordId) => `Показатели ${indicators.map(f => `"${f}"`).join(', ')} отсутствуют в записи с ID ${recordId}`,<br />
emptyIndicatorsProps: (props: Record<string, string[]>, recordId) => {<br />
const propsString = Object.keys(props).map(prop => !isEmptyArray(props[prop]) ? `${prop}: ${props[prop].map(p => `"${p}"`).join(', ')}` : '').join('; ')<br />
return `В записи с Id ${recordId} отсутствуют либо не заполнены следующие поля у показателей: ${propsString}`<br />
}<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
fieldsError: (emptyFields, recordId) => {<br />
throw new Error(messages.emptyFieldsError(emptyFields, recordId))<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
},<br />
indicatorsError: (recordId) =>{<br />
throw new Error(messages.emptyIndicators(recordId))<br />
},<br />
notFoundIndicators: (indicators: string[], recordId: number) => {<br />
throw new Error(messages.indicators(indicators, recordId))<br />
},<br />
notFilledIndicatorProps: (props: Record<string, string[]>) => {<br />
throw new Error(messages.emptyIndicatorsProps(props, config.journalRecordId))<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const isEmptyArray = (arr: unknown[]) => {<br />
return Array.isArray(arr) && arr.length === 0<br />
}<br />
<br />
const hasIndicators = (journalRecordManager: IJournalRecordManager) => {<br />
const indicators = journalRecordManager?.data?.indicators<br />
return Array.isArray(indicators) && indicators.length > 0<br />
}<br />
<br />
const getNotFoundIndicators = (indicators: JournalRecordIndicatorResponse[], indicatorsList = config.indicatorsList) => {<br />
return indicatorsList.filter(ind => indicators.every(ljInd => ljInd?.indicator?.name?.toLowerCase() !== ind.toLocaleLowerCase()))<br />
} <br />
<br />
const getNotFilledResultsFields = (indicators: JournalRecordIndicatorResponse[]): Record<string, string[]> => {<br />
return indicators.reduce((acc, indicator) => {<br />
const config = indicatorPropsConfig(indicator)<br />
return {<br />
...acc,<br />
[indicator?.indicator?.name]: Object.keys(config).reduce((acc, prop) => {<br />
if (!config[prop].get()) return [...acc, config[prop].label]<br />
return acc<br />
}, [] as string[])<br />
}<br />
}, {}) as Record<string, string[]><br />
}<br />
<br />
const hasNotFilledProps = (indicatorsProps: Record<string, string[]>) => {<br />
return Object.keys(indicatorsProps).some(indicator => !isEmptyArray(indicatorsProps[indicator]))<br />
}<br />
<br />
const hasNotFoundIndicators = (indicators: string[]) => !isEmptyArray(indicators)<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
<br />
if (!hasIndicators(journalRecordManager)) {<br />
errorHandlers.indicatorsError(journalRecordManager.journalRecordId)<br />
}<br />
<br />
const indicators = journalRecordManager?.data?.indicators<br />
<br />
const notFoundIndicators = getNotFoundIndicators(indicators)<br />
if (hasNotFoundIndicators(notFoundIndicators)) { <br />
errorHandlers.notFoundIndicators(notFoundIndicators, journalRecordManager.journalRecordId)<br />
}<br />
<br />
const emptyIndicatorProps = getNotFilledResultsFields(indicators)<br />
if (hasNotFilledProps(emptyIndicatorProps)) {<br />
errorHandlers.notFilledIndicatorProps(emptyIndicatorProps)<br />
}<br />
<br />
showSuccessMessage(messages.success, socketId)<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
<br />
== Проверка заполненности атрибутов записи ЛЖ. <code>check-record-fields-filled</code> ==<br />
[[Файл:Check-record-fields-filled.png|frame]]<br />
Проверяет заполненность заданных полей в записи журнала (например, "Источник", "Место отбора", "Дата регистрации" и др.). Если какое-либо из обязательных полей не заполнено, выдаётся соответствующая ошибка.<br />
<br />
== Проверка движения пробы. <code>check-sample-moving</code> ==<br />
[[Файл:Check-sample-moving.png|frame]]<br />
Проверяет маршрут движения пробы по этапам. Получает историю перемещений записи и определяет, происходило ли движение (нахождение более чем на одном этапе). Отображает маршрут или сообщает, что движение не происходило.<br />
<br />
== Проверка прав пользователя. <code>check-user-rights</code> ==<br />
[[Файл:Check-user-rights.png|frame]]<br />
Проверяет права доступа пользователя к определённым ресурсам (объекты анализа, методики, записи ЛЖ). Отображает таблицу с типами доступа (чтение, запись и т.д.) и наличием прав по каждому ресурсу.<br />
<br />
== Заполнение атрибутов записи ЛЖ. <code>fill-record-fields</code> ==<br />
[[Файл:Fill-record-fields.png|frame]]<br />
Автоматически заполняет заданные поля в записи журнала (например, даты, место отбора, шифр пробы и др.). Есть возможность использования ключевых слов для сопоставления полей, если точные названия не совпадают.<br />
<br />
== Деление данных. <code>copy-journal-record</code> ==<br />
[[Файл:Copy-journal-record.png|frame]]<br />
Создаёт копию записи журнала на заданном этапе маршрута. Выводит сообщение с ID новой записи.</div>
Arhidiman
https://wiki.chemsoft.ru/index.php?title=%D0%90%D0%B4%D0%B4%D0%BE%D0%BD%D1%8B&diff=2358
Аддоны
2026-04-02T01:05:54Z
<p>Arhidiman: /* Проверка даты регистрации. check-registration-date */</p>
<hr />
<div>Список демонстрационных аддонов, показывающих возможности интеграционного сервиса.<br />
<br />
== Проверка даты регистрации. <code>check-registration-date</code> ==<br />
[[Файл:check-registration-date.png|frame]]<br />
Проверяет, не истёк ли срок регистрации пробы. Сравнивает дату регистрации из указанного поля с текущей датой. Если прошло более заданного количества дней (по умолчанию — 10), выдаёт ошибку. В противном случае показывает сообщение об успешной проверке.<br />
<br />
<br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { MessageBoxResults } from "@triteia/types-integration-gui"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { DialogType } from "@triteia/types-integration-gui"<br />
<br />
const config = {<br />
dateField: 'Дата регистрации',<br />
expirationLimit: 10,<br />
journalRecordId: 201, // Лаб. воздуха / Анализы завершены<br />
integrationResult: { message: 'Срок регистрации пробы не истёк !'}<br />
}<br />
<br />
const messages = {<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
success: (recordId) => `Срок регистрации пробы не истёк ! Id записи ${recordId}`,<br />
expired: (limit, recordId) => `Срок регистрации пробы истёк!\nПрошло более ${ limit } дней с момента регистрации. Id записи: ${recordId}`,<br />
dateField: (dateField, stageName, journalRecordId) => [<br />
`Не заполнено либо отсутствует поле "${dateField}"`,<br />
`в этапе "${stageName || ''}".\nId записи: ${journalRecordId}`<br />
].join(' ')<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
},<br />
dateError: (dateField, stageName, journalRecordId) => {<br />
throw new Error(messages.dateField(dateField, stageName, journalRecordId))<br />
},<br />
expirationError: () => {<br />
throw new Error(messages.expired(config.expirationLimit, config.journalRecordId))<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const getDaysByDate = (date: Date) => {<br />
const dayMs = 60 * 60 * 24 * 1000<br />
const timestamp = date.getTime()<br />
return timestamp/dayMs<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getExpirationOffset = (registrationDate: string) => {<br />
const regDate = new Date(registrationDate)<br />
const today = new Date()<br />
return getDaysByDate(today) - getDaysByDate(regDate)<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
async function main({ queryParams }) {<br />
<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
const date = journalRecordManager.getFieldValue(config.dateField)<br />
<br />
if (!date) errorHandlers.dateError(config.dateField, journalRecordManager?.data?.stage?.stage?.name, config.journalRecordId)<br />
<br />
const expirationOffset = getExpirationOffset(date as string)<br />
<br />
if (expirationOffset >= config.expirationLimit) errorHandlers.expirationError()<br />
<br />
await showSuccessMessage(messages.success(config.journalRecordId), socketId)<br />
<br />
return config.integrationResult<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
</syntaxhighlight><br />
<br />
== Проверка заполненности полей показателей. <code>check-indicator-fields-filled</code> ==<br />
[[Файл:Check-indicator-fields-filled.png|frame]]<br />
Проверяет заполненность полей показателей в записи журнала по настраиваемому списку. Проверяет наличие определённых показателей (например, "Аммоний-ион") и заполненность у них таких полей, как исполнители, методики, средний результат и др. Выдаёт ошибку, если показатели отсутствуют или не все поля заполнены.<br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import type { DialogType } from "@triteia/types-integration-gui"<br />
import type { JournalRecordIndicatorResponse } from "../../src/servivces/worker/api/controllers/journal-records"<br />
import type { IJournalRecordManager } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
<br />
type IndicatorProp = { label: string, get: () => unknown }<br />
type IndicatorPropsConfig = Record<string, IndicatorProp><br />
<br />
const indicatorPropsConfig = (indicator): IndicatorPropsConfig => {<br />
return {<br />
executors: {<br />
label: 'Исполнители', <br />
get: () => indicator?.result?.executors<br />
},<br />
methodic: {<br />
label: 'Методики', <br />
get: () => indicator?.methodics<br />
},<br />
averageResult: {<br />
label: 'Средний результат', <br />
get: () => indicator?.result?.averageValue<br />
},<br />
averageRoundedValue: {<br />
label: 'Средний округлённый результат', <br />
get: () => indicator?.result?.averageRoundedValue<br />
}<br />
}<br />
}<br />
<br />
const config = {<br />
requiredFields: [<br />
'Источник',<br />
'Место отбора',<br />
'Дата регистрации',<br />
'Шифр пробы',<br />
'Время регистрации'<br />
],<br />
indicatorsList: [<br />
'Аммоний-ион'<br />
],<br />
journalRecordId: 144, // Мк / Тест_Ушакова<br />
integrationResult: { message: 'Все поля заполнены!' }<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: 'Все необходимые поля заполнены!',<br />
emptyIndicators: (recordId) => `в записи с Id ${recordId} отсутствуют показатели`,<br />
emptyFieldsError: (fields, recordId) => `Поля ${fields.map(f => `"${f}"`).join(', ')} не заполнены в записи с ID ${recordId}`,<br />
indicators: (indicators: string[], recordId) => `Показатели ${indicators.map(f => `"${f}"`).join(', ')} отсутствуют в записи с ID ${recordId}`,<br />
emptyIndicatorsProps: (props: Record<string, string[]>, recordId) => {<br />
const propsString = Object.keys(props).map(prop => !isEmptyArray(props[prop]) ? `${prop}: ${props[prop].map(p => `"${p}"`).join(', ')}` : '').join('; ')<br />
return `В записи с Id ${recordId} отсутствуют либо не заполнены следующие поля у показателей: ${propsString}`<br />
}<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
fieldsError: (emptyFields, recordId) => {<br />
throw new Error(messages.emptyFieldsError(emptyFields, recordId))<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
},<br />
indicatorsError: (recordId) =>{<br />
throw new Error(messages.emptyIndicators(recordId))<br />
},<br />
notFoundIndicators: (indicators: string[], recordId: number) => {<br />
throw new Error(messages.indicators(indicators, recordId))<br />
},<br />
notFilledIndicatorProps: (props: Record<string, string[]>) => {<br />
throw new Error(messages.emptyIndicatorsProps(props, config.journalRecordId))<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const isEmptyArray = (arr: unknown[]) => {<br />
return Array.isArray(arr) && arr.length === 0<br />
}<br />
<br />
const hasIndicators = (journalRecordManager: IJournalRecordManager) => {<br />
const indicators = journalRecordManager?.data?.indicators<br />
return Array.isArray(indicators) && indicators.length > 0<br />
}<br />
<br />
const getNotFoundIndicators = (indicators: JournalRecordIndicatorResponse[], indicatorsList = config.indicatorsList) => {<br />
return indicatorsList.filter(ind => indicators.every(ljInd => ljInd?.indicator?.name?.toLowerCase() !== ind.toLocaleLowerCase()))<br />
} <br />
<br />
const getNotFilledResultsFields = (indicators: JournalRecordIndicatorResponse[]): Record<string, string[]> => {<br />
return indicators.reduce((acc, indicator) => {<br />
const config = indicatorPropsConfig(indicator)<br />
return {<br />
...acc,<br />
[indicator?.indicator?.name]: Object.keys(config).reduce((acc, prop) => {<br />
if (!config[prop].get()) return [...acc, config[prop].label]<br />
return acc<br />
}, [] as string[])<br />
}<br />
}, {}) as Record<string, string[]><br />
}<br />
<br />
const hasNotFilledProps = (indicatorsProps: Record<string, string[]>) => {<br />
return Object.keys(indicatorsProps).some(indicator => !isEmptyArray(indicatorsProps[indicator]))<br />
}<br />
<br />
const hasNotFoundIndicators = (indicators: string[]) => !isEmptyArray(indicators)<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
<br />
if (!hasIndicators(journalRecordManager)) {<br />
errorHandlers.indicatorsError(journalRecordManager.journalRecordId)<br />
}<br />
<br />
const indicators = journalRecordManager?.data?.indicators<br />
<br />
const notFoundIndicators = getNotFoundIndicators(indicators)<br />
if (hasNotFoundIndicators(notFoundIndicators)) { <br />
errorHandlers.notFoundIndicators(notFoundIndicators, journalRecordManager.journalRecordId)<br />
}<br />
<br />
const emptyIndicatorProps = getNotFilledResultsFields(indicators)<br />
if (hasNotFilledProps(emptyIndicatorProps)) {<br />
errorHandlers.notFilledIndicatorProps(emptyIndicatorProps)<br />
}<br />
<br />
showSuccessMessage(messages.success, socketId)<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
<br />
== Проверка заполненности атрибутов записи ЛЖ. <code>check-record-fields-filled</code> ==<br />
[[Файл:Check-record-fields-filled.png|frame]]<br />
Проверяет заполненность заданных полей в записи журнала (например, "Источник", "Место отбора", "Дата регистрации" и др.). Если какое-либо из обязательных полей не заполнено, выдаётся соответствующая ошибка.<br />
<br />
== Проверка движения пробы. <code>check-sample-moving</code> ==<br />
[[Файл:Check-sample-moving.png|frame]]<br />
Проверяет маршрут движения пробы по этапам. Получает историю перемещений записи и определяет, происходило ли движение (нахождение более чем на одном этапе). Отображает маршрут или сообщает, что движение не происходило.<br />
<br />
== Проверка прав пользователя. <code>check-user-rights</code> ==<br />
[[Файл:Check-user-rights.png|frame]]<br />
Проверяет права доступа пользователя к определённым ресурсам (объекты анализа, методики, записи ЛЖ). Отображает таблицу с типами доступа (чтение, запись и т.д.) и наличием прав по каждому ресурсу.<br />
<br />
== Заполнение атрибутов записи ЛЖ. <code>fill-record-fields</code> ==<br />
[[Файл:Fill-record-fields.png|frame]]<br />
Автоматически заполняет заданные поля в записи журнала (например, даты, место отбора, шифр пробы и др.). Есть возможность использования ключевых слов для сопоставления полей, если точные названия не совпадают.<br />
<br />
== Деление данных. <code>copy-journal-record</code> ==<br />
[[Файл:Copy-journal-record.png|frame]]<br />
Создаёт копию записи журнала на заданном этапе маршрута. Выводит сообщение с ID новой записи.</div>
Arhidiman
https://wiki.chemsoft.ru/index.php?title=%D0%90%D0%B4%D0%B4%D0%BE%D0%BD%D1%8B&diff=2348
Аддоны
2026-04-01T09:53:24Z
<p>Arhidiman: /* Проверка заполненности полей показателей. check-indicator-fields-filled */</p>
<hr />
<div>Список демонстрационных аддонов, показывающих возможности интеграционного сервиса.<br />
<br />
== Проверка даты регистрации. <code>check-registration-date</code> ==<br />
[[Файл:check-registration-date.png|frame]]<br />
Проверяет, не истёк ли срок регистрации пробы. Сравнивает дату регистрации из указанного поля с текущей датой. Если прошло более заданного количества дней (по умолчанию — 10), выдаёт ошибку. В противном случае показывает сообщение об успешной проверке.<br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { MessageBoxResults } from "@triteia/types-integration-gui"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { DialogType } from "@triteia/types-integration-gui"<br />
<br />
const config = {<br />
dateField: 'Дата регистрации',<br />
expirationLimit: 10,<br />
journalRecordId: 201, // Лаб. воздуха / Анализы завершены<br />
integrationResult: { message: 'Срок регистрации пробы не истёк !'}<br />
}<br />
<br />
const messages = {<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
success: (recordId) => `Срок регистрации пробы не истёк ! Id записи ${recordId}`,<br />
expired: (limit, recordId) => `Срок регистрации пробы истёк!\nПрошло более ${ limit } дней с момента регистрации. Id записи: ${recordId}`,<br />
dateField: (dateField, stageName, journalRecordId) => [<br />
`Не заполнено либо отсутствует поле "${dateField}"`,<br />
`в этапе "${stageName || ''}".\nId записи: ${journalRecordId}`<br />
].join(' ')<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
},<br />
dateError: (dateField, stageName, journalRecordId) => {<br />
throw new Error(messages.dateField(dateField, stageName, journalRecordId))<br />
},<br />
expirationError: () => {<br />
throw new Error(messages.expired(config.expirationLimit, config.journalRecordId))<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const getDaysByDate = (date: Date) => {<br />
const dayMs = 60 * 60 * 24 * 1000<br />
const timestamp = date.getTime()<br />
return timestamp/dayMs<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getExpirationOffset = (registrationDate: string) => {<br />
const regDate = new Date(registrationDate)<br />
const today = new Date()<br />
return getDaysByDate(today) - getDaysByDate(regDate)<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
async function main({ queryParams }) {<br />
<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
const date = journalRecordManager.getFieldValue(config.dateField)<br />
<br />
if (!date) errorHandlers.dateError(config.dateField, journalRecordManager?.data?.stage?.stage?.name, config.journalRecordId)<br />
<br />
const expirationOffset = getExpirationOffset(date as string)<br />
<br />
if (expirationOffset >= config.expirationLimit) errorHandlers.expirationError()<br />
<br />
await showSuccessMessage(messages.success(config.journalRecordId), socketId)<br />
<br />
return config.integrationResult<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
</syntaxhighlight><br />
<br />
== Проверка заполненности полей показателей. <code>check-indicator-fields-filled</code> ==<br />
[[Файл:Check-indicator-fields-filled.png|frame]]<br />
Проверяет заполненность полей показателей в записи журнала по настраиваемому списку. Проверяет наличие определённых показателей (например, "Аммоний-ион") и заполненность у них таких полей, как исполнители, методики, средний результат и др. Выдаёт ошибку, если показатели отсутствуют или не все поля заполнены.<br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import type { DialogType } from "@triteia/types-integration-gui"<br />
import type { JournalRecordIndicatorResponse } from "../../src/servivces/worker/api/controllers/journal-records"<br />
import type { IJournalRecordManager } from "../../src/servivces/worker/api/interactors/JournalRecordManager/interface"<br />
<br />
type IndicatorProp = { label: string, get: () => unknown }<br />
type IndicatorPropsConfig = Record<string, IndicatorProp><br />
<br />
const indicatorPropsConfig = (indicator): IndicatorPropsConfig => {<br />
return {<br />
executors: {<br />
label: 'Исполнители', <br />
get: () => indicator?.result?.executors<br />
},<br />
methodic: {<br />
label: 'Методики', <br />
get: () => indicator?.methodics<br />
},<br />
averageResult: {<br />
label: 'Средний результат', <br />
get: () => indicator?.result?.averageValue<br />
},<br />
averageRoundedValue: {<br />
label: 'Средний округлённый результат', <br />
get: () => indicator?.result?.averageRoundedValue<br />
}<br />
}<br />
}<br />
<br />
const config = {<br />
requiredFields: [<br />
'Источник',<br />
'Место отбора',<br />
'Дата регистрации',<br />
'Шифр пробы',<br />
'Время регистрации'<br />
],<br />
indicatorsList: [<br />
'Аммоний-ион'<br />
],<br />
journalRecordId: 144, // Мк / Тест_Ушакова<br />
integrationResult: { message: 'Все поля заполнены!' }<br />
}<br />
<br />
const messages = {<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
success: 'Все необходимые поля заполнены!',<br />
emptyIndicators: (recordId) => `в записи с Id ${recordId} отсутствуют показатели`,<br />
emptyFieldsError: (fields, recordId) => `Поля ${fields.map(f => `"${f}"`).join(', ')} не заполнены в записи с ID ${recordId}`,<br />
indicators: (indicators: string[], recordId) => `Показатели ${indicators.map(f => `"${f}"`).join(', ')} отсутствуют в записи с ID ${recordId}`,<br />
emptyIndicatorsProps: (props: Record<string, string[]>, recordId) => {<br />
const propsString = Object.keys(props).map(prop => !isEmptyArray(props[prop]) ? `${prop}: ${props[prop].map(p => `"${p}"`).join(', ')}` : '').join('; ')<br />
return `В записи с Id ${recordId} отсутствуют либо не заполнены следующие поля у показателей: ${propsString}`<br />
}<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
fieldsError: (emptyFields, recordId) => {<br />
throw new Error(messages.emptyFieldsError(emptyFields, recordId))<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
},<br />
indicatorsError: (recordId) =>{<br />
throw new Error(messages.emptyIndicators(recordId))<br />
},<br />
notFoundIndicators: (indicators: string[], recordId: number) => {<br />
throw new Error(messages.indicators(indicators, recordId))<br />
},<br />
notFilledIndicatorProps: (props: Record<string, string[]>) => {<br />
throw new Error(messages.emptyIndicatorsProps(props, config.journalRecordId))<br />
}<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
const isEmptyArray = (arr: unknown[]) => {<br />
return Array.isArray(arr) && arr.length === 0<br />
}<br />
<br />
const hasIndicators = (journalRecordManager: IJournalRecordManager) => {<br />
const indicators = journalRecordManager?.data?.indicators<br />
return Array.isArray(indicators) && indicators.length > 0<br />
}<br />
<br />
const getNotFoundIndicators = (indicators: JournalRecordIndicatorResponse[], indicatorsList = config.indicatorsList) => {<br />
return indicatorsList.filter(ind => indicators.every(ljInd => ljInd?.indicator?.name?.toLowerCase() !== ind.toLocaleLowerCase()))<br />
} <br />
<br />
const getNotFilledResultsFields = (indicators: JournalRecordIndicatorResponse[]): Record<string, string[]> => {<br />
return indicators.reduce((acc, indicator) => {<br />
const config = indicatorPropsConfig(indicator)<br />
return {<br />
...acc,<br />
[indicator?.indicator?.name]: Object.keys(config).reduce((acc, prop) => {<br />
if (!config[prop].get()) return [...acc, config[prop].label]<br />
return acc<br />
}, [] as string[])<br />
}<br />
}, {}) as Record<string, string[]><br />
}<br />
<br />
const hasNotFilledProps = (indicatorsProps: Record<string, string[]>) => {<br />
return Object.keys(indicatorsProps).some(indicator => !isEmptyArray(indicatorsProps[indicator]))<br />
}<br />
<br />
const hasNotFoundIndicators = (indicators: string[]) => !isEmptyArray(indicators)<br />
<br />
async function main({ queryParams }) {<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
<br />
if (!hasIndicators(journalRecordManager)) {<br />
errorHandlers.indicatorsError(journalRecordManager.journalRecordId)<br />
}<br />
<br />
const indicators = journalRecordManager?.data?.indicators<br />
<br />
const notFoundIndicators = getNotFoundIndicators(indicators)<br />
if (hasNotFoundIndicators(notFoundIndicators)) { <br />
errorHandlers.notFoundIndicators(notFoundIndicators, journalRecordManager.journalRecordId)<br />
}<br />
<br />
const emptyIndicatorProps = getNotFilledResultsFields(indicators)<br />
if (hasNotFilledProps(emptyIndicatorProps)) {<br />
errorHandlers.notFilledIndicatorProps(emptyIndicatorProps)<br />
}<br />
<br />
showSuccessMessage(messages.success, socketId)<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
<br />
<br />
<br />
</syntaxhighlight><br />
<br />
== Проверка заполненности атрибутов записи ЛЖ. <code>check-record-fields-filled</code> ==<br />
[[Файл:Check-record-fields-filled.png|frame]]<br />
Проверяет заполненность заданных полей в записи журнала (например, "Источник", "Место отбора", "Дата регистрации" и др.). Если какое-либо из обязательных полей не заполнено, выдаётся соответствующая ошибка.<br />
<br />
== Проверка движения пробы. <code>check-sample-moving</code> ==<br />
[[Файл:Check-sample-moving.png|frame]]<br />
Проверяет маршрут движения пробы по этапам. Получает историю перемещений записи и определяет, происходило ли движение (нахождение более чем на одном этапе). Отображает маршрут или сообщает, что движение не происходило.<br />
<br />
== Проверка прав пользователя. <code>check-user-rights</code> ==<br />
[[Файл:Check-user-rights.png|frame]]<br />
Проверяет права доступа пользователя к определённым ресурсам (объекты анализа, методики, записи ЛЖ). Отображает таблицу с типами доступа (чтение, запись и т.д.) и наличием прав по каждому ресурсу.<br />
<br />
== Заполнение атрибутов записи ЛЖ. <code>fill-record-fields</code> ==<br />
[[Файл:Fill-record-fields.png|frame]]<br />
Автоматически заполняет заданные поля в записи журнала (например, даты, место отбора, шифр пробы и др.). Есть возможность использования ключевых слов для сопоставления полей, если точные названия не совпадают.<br />
<br />
== Деление данных. <code>copy-journal-record</code> ==<br />
[[Файл:Copy-journal-record.png|frame]]<br />
Создаёт копию записи журнала на заданном этапе маршрута. Выводит сообщение с ID новой записи.</div>
Arhidiman
https://wiki.chemsoft.ru/index.php?title=%D0%90%D0%B4%D0%B4%D0%BE%D0%BD%D1%8B&diff=2347
Аддоны
2026-04-01T09:52:11Z
<p>Arhidiman: /* Проверка даты регистрации. check-registration-date */</p>
<hr />
<div>Список демонстрационных аддонов, показывающих возможности интеграционного сервиса.<br />
<br />
== Проверка даты регистрации. <code>check-registration-date</code> ==<br />
[[Файл:check-registration-date.png|frame]]<br />
Проверяет, не истёк ли срок регистрации пробы. Сравнивает дату регистрации из указанного поля с текущей датой. Если прошло более заданного количества дней (по умолчанию — 10), выдаёт ошибку. В противном случае показывает сообщение об успешной проверке.<br />
<syntaxhighlight lang="typescript"><br />
import { JournalRecordManager } from "../../src/servivces/worker/api/interactors"<br />
import { MessageBoxResults } from "@triteia/types-integration-gui"<br />
import { getDataFromDialog } from "../../src/gui/api"<br />
import { DialogType } from "@triteia/types-integration-gui"<br />
<br />
const config = {<br />
dateField: 'Дата регистрации',<br />
expirationLimit: 10,<br />
journalRecordId: 201, // Лаб. воздуха / Анализы завершены<br />
integrationResult: { message: 'Срок регистрации пробы не истёк !'}<br />
}<br />
<br />
const messages = {<br />
queryParamsNotFound: 'Отсутствуют необходимые параметры для выполнения аддона. Дальнейшее выполнение невозможно',<br />
socketNotFound: 'Отсутствует соединение с клиентом. Дальнейшее выполнение аддона невозможно',<br />
success: (recordId) => `Срок регистрации пробы не истёк ! Id записи ${recordId}`,<br />
expired: (limit, recordId) => `Срок регистрации пробы истёк!\nПрошло более ${ limit } дней с момента регистрации. Id записи: ${recordId}`,<br />
dateField: (dateField, stageName, journalRecordId) => [<br />
`Не заполнено либо отсутствует поле "${dateField}"`,<br />
`в этапе "${stageName || ''}".\nId записи: ${journalRecordId}`<br />
].join(' ')<br />
}<br />
<br />
const errorHandlers = {<br />
queryParamsError: () => {<br />
throw new Error(messages.queryParamsNotFound)<br />
},<br />
socketError: () => {<br />
throw new Error(messages.socketNotFound)<br />
},<br />
dateError: (dateField, stageName, journalRecordId) => {<br />
throw new Error(messages.dateField(dateField, stageName, journalRecordId))<br />
},<br />
expirationError: () => {<br />
throw new Error(messages.expired(config.expirationLimit, config.journalRecordId))<br />
}<br />
}<br />
<br />
const getSocketId = (queryParams: any) => {<br />
const socketId = Array.isArray(queryParams?.socketId) && queryParams?.socketId?.length ? queryParams?.socketId[0] : '';<br />
<br />
if (!queryParams) errorHandlers.queryParamsError()<br />
if (!socketId) errorHandlers.socketError()<br />
<br />
return socketId<br />
}<br />
<br />
const getDaysByDate = (date: Date) => {<br />
const dayMs = 60 * 60 * 24 * 1000<br />
const timestamp = date.getTime()<br />
return timestamp/dayMs<br />
}<br />
<br />
const getConfig = (type: DialogType, title: string, message) => {<br />
return {<br />
type,<br />
config: {<br />
title,<br />
message<br />
}<br />
}<br />
}<br />
<br />
const getExpirationOffset = (registrationDate: string) => {<br />
const regDate = new Date(registrationDate)<br />
const today = new Date()<br />
return getDaysByDate(today) - getDaysByDate(regDate)<br />
}<br />
<br />
const showErrorMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Ошибка', message), socketId);<br />
const showSuccessMessage = async (message: string, socketId) => getDataFromDialog(getConfig('confirm', 'Внимание', message), socketId);<br />
<br />
async function main({ queryParams }) {<br />
<br />
const socketId = getSocketId(queryParams)<br />
<br />
try {<br />
const journalRecordManager = await JournalRecordManager(config.journalRecordId)<br />
const date = journalRecordManager.getFieldValue(config.dateField)<br />
<br />
if (!date) errorHandlers.dateError(config.dateField, journalRecordManager?.data?.stage?.stage?.name, config.journalRecordId)<br />
<br />
const expirationOffset = getExpirationOffset(date as string)<br />
<br />
if (expirationOffset >= config.expirationLimit) errorHandlers.expirationError()<br />
<br />
await showSuccessMessage(messages.success(config.journalRecordId), socketId)<br />
<br />
return config.integrationResult<br />
} catch (err) {<br />
await showErrorMessage(err.message, socketId)<br />
return { error: err.message }<br />
}<br />
}<br />
<br />
module.exports = { main }<br />
</syntaxhighlight><br />
<br />
== Проверка заполненности полей показателей. <code>check-indicator-fields-filled</code> ==<br />
[[Файл:Check-indicator-fields-filled.png|frame]]<br />
Проверяет заполненность полей показателей в записи журнала по настраиваемому списку. Проверяет наличие определённых показателей (например, "Аммоний-ион") и заполненность у них таких полей, как исполнители, методики, средний результат и др. Выдаёт ошибку, если показатели отсутствуют или не все поля заполнены.<br />
<br />
== Проверка заполненности атрибутов записи ЛЖ. <code>check-record-fields-filled</code> ==<br />
[[Файл:Check-record-fields-filled.png|frame]]<br />
Проверяет заполненность заданных полей в записи журнала (например, "Источник", "Место отбора", "Дата регистрации" и др.). Если какое-либо из обязательных полей не заполнено, выдаётся соответствующая ошибка.<br />
<br />
== Проверка движения пробы. <code>check-sample-moving</code> ==<br />
[[Файл:Check-sample-moving.png|frame]]<br />
Проверяет маршрут движения пробы по этапам. Получает историю перемещений записи и определяет, происходило ли движение (нахождение более чем на одном этапе). Отображает маршрут или сообщает, что движение не происходило.<br />
<br />
== Проверка прав пользователя. <code>check-user-rights</code> ==<br />
[[Файл:Check-user-rights.png|frame]]<br />
Проверяет права доступа пользователя к определённым ресурсам (объекты анализа, методики, записи ЛЖ). Отображает таблицу с типами доступа (чтение, запись и т.д.) и наличием прав по каждому ресурсу.<br />
<br />
== Заполнение атрибутов записи ЛЖ. <code>fill-record-fields</code> ==<br />
[[Файл:Fill-record-fields.png|frame]]<br />
Автоматически заполняет заданные поля в записи журнала (например, даты, место отбора, шифр пробы и др.). Есть возможность использования ключевых слов для сопоставления полей, если точные названия не совпадают.<br />
<br />
== Деление данных. <code>copy-journal-record</code> ==<br />
[[Файл:Copy-journal-record.png|frame]]<br />
Создаёт копию записи журнала на заданном этапе маршрута. Выводит сообщение с ID новой записи.</div>
Arhidiman
https://wiki.chemsoft.ru/index.php?title=%D0%90%D0%B4%D0%B4%D0%BE%D0%BD%D1%8B&diff=2346
Аддоны
2026-04-01T09:28:28Z
<p>Arhidiman: /* Проверка заполненности атрибутов записи ЛЖ. check-record-fields-filled */</p>
<hr />
<div>Список демонстрационных аддонов, показывающих возможности интеграционного сервиса.<br />
<br />
== Проверка даты регистрации. <code>check-registration-date</code> ==<br />
[[Файл:check-registration-date.png|frame]]<br />
Проверяет, не истёк ли срок регистрации пробы. Сравнивает дату регистрации из указанного поля с текущей датой. Если прошло более заданного количества дней (по умолчанию — 10), выдаёт ошибку. В противном случае показывает сообщение об успешной проверке.<br />
<br />
== Проверка заполненности полей показателей. <code>check-indicator-fields-filled</code> ==<br />
[[Файл:Check-indicator-fields-filled.png|frame]]<br />
Проверяет заполненность полей показателей в записи журнала по настраиваемому списку. Проверяет наличие определённых показателей (например, "Аммоний-ион") и заполненность у них таких полей, как исполнители, методики, средний результат и др. Выдаёт ошибку, если показатели отсутствуют или не все поля заполнены.<br />
<br />
== Проверка заполненности атрибутов записи ЛЖ. <code>check-record-fields-filled</code> ==<br />
[[Файл:Check-record-fields-filled.png|frame]]<br />
Проверяет заполненность заданных полей в записи журнала (например, "Источник", "Место отбора", "Дата регистрации" и др.). Если какое-либо из обязательных полей не заполнено, выдаётся соответствующая ошибка.<br />
<br />
== Проверка движения пробы. <code>check-sample-moving</code> ==<br />
[[Файл:Check-sample-moving.png|frame]]<br />
Проверяет маршрут движения пробы по этапам. Получает историю перемещений записи и определяет, происходило ли движение (нахождение более чем на одном этапе). Отображает маршрут или сообщает, что движение не происходило.<br />
<br />
== Проверка прав пользователя. <code>check-user-rights</code> ==<br />
[[Файл:Check-user-rights.png|frame]]<br />
Проверяет права доступа пользователя к определённым ресурсам (объекты анализа, методики, записи ЛЖ). Отображает таблицу с типами доступа (чтение, запись и т.д.) и наличием прав по каждому ресурсу.<br />
<br />
== Заполнение атрибутов записи ЛЖ. <code>fill-record-fields</code> ==<br />
[[Файл:Fill-record-fields.png|frame]]<br />
Автоматически заполняет заданные поля в записи журнала (например, даты, место отбора, шифр пробы и др.). Есть возможность использования ключевых слов для сопоставления полей, если точные названия не совпадают.<br />
<br />
== Деление данных. <code>copy-journal-record</code> ==<br />
[[Файл:Copy-journal-record.png|frame]]<br />
Создаёт копию записи журнала на заданном этапе маршрута. Выводит сообщение с ID новой записи.</div>
Arhidiman
https://wiki.chemsoft.ru/index.php?title=%D0%90%D0%B4%D0%B4%D0%BE%D0%BD%D1%8B&diff=2345
Аддоны
2026-04-01T09:25:51Z
<p>Arhidiman: /* Деление данных. copy-journal-record */</p>
<hr />
<div>Список демонстрационных аддонов, показывающих возможности интеграционного сервиса.<br />
<br />
== Проверка даты регистрации. <code>check-registration-date</code> ==<br />
[[Файл:check-registration-date.png|frame]]<br />
Проверяет, не истёк ли срок регистрации пробы. Сравнивает дату регистрации из указанного поля с текущей датой. Если прошло более заданного количества дней (по умолчанию — 10), выдаёт ошибку. В противном случае показывает сообщение об успешной проверке.<br />
<br />
== Проверка заполненности полей показателей. <code>check-indicator-fields-filled</code> ==<br />
[[Файл:Check-indicator-fields-filled.png|frame]]<br />
Проверяет заполненность полей показателей в записи журнала по настраиваемому списку. Проверяет наличие определённых показателей (например, "Аммоний-ион") и заполненность у них таких полей, как исполнители, методики, средний результат и др. Выдаёт ошибку, если показатели отсутствуют или не все поля заполнены.<br />
<br />
== Проверка заполненности атрибутов записи ЛЖ. <code>check-record-fields-filled</code> ==<br />
Проверяет заполненность заданных полей в записи журнала (например, "Источник", "Место отбора", "Дата регистрации" и др.). Если какое-либо из обязательных полей не заполнено, выдаётся соответствующая ошибка.<br />
<br />
== Проверка движения пробы. <code>check-sample-moving</code> ==<br />
[[Файл:Check-sample-moving.png|frame]]<br />
Проверяет маршрут движения пробы по этапам. Получает историю перемещений записи и определяет, происходило ли движение (нахождение более чем на одном этапе). Отображает маршрут или сообщает, что движение не происходило.<br />
<br />
== Проверка прав пользователя. <code>check-user-rights</code> ==<br />
[[Файл:Check-user-rights.png|frame]]<br />
Проверяет права доступа пользователя к определённым ресурсам (объекты анализа, методики, записи ЛЖ). Отображает таблицу с типами доступа (чтение, запись и т.д.) и наличием прав по каждому ресурсу.<br />
<br />
== Заполнение атрибутов записи ЛЖ. <code>fill-record-fields</code> ==<br />
[[Файл:Fill-record-fields.png|frame]]<br />
Автоматически заполняет заданные поля в записи журнала (например, даты, место отбора, шифр пробы и др.). Есть возможность использования ключевых слов для сопоставления полей, если точные названия не совпадают.<br />
<br />
== Деление данных. <code>copy-journal-record</code> ==<br />
[[Файл:Copy-journal-record.png|frame]]<br />
Создаёт копию записи журнала на заданном этапе маршрута. Выводит сообщение с ID новой записи.</div>
Arhidiman
https://wiki.chemsoft.ru/index.php?title=%D0%90%D0%B4%D0%B4%D0%BE%D0%BD%D1%8B&diff=2344
Аддоны
2026-04-01T09:24:54Z
<p>Arhidiman: /* Заполнение атрибутов записи ЛЖ. fill-record-fields */</p>
<hr />
<div>Список демонстрационных аддонов, показывающих возможности интеграционного сервиса.<br />
<br />
== Проверка даты регистрации. <code>check-registration-date</code> ==<br />
[[Файл:check-registration-date.png|frame]]<br />
Проверяет, не истёк ли срок регистрации пробы. Сравнивает дату регистрации из указанного поля с текущей датой. Если прошло более заданного количества дней (по умолчанию — 10), выдаёт ошибку. В противном случае показывает сообщение об успешной проверке.<br />
<br />
== Проверка заполненности полей показателей. <code>check-indicator-fields-filled</code> ==<br />
[[Файл:Check-indicator-fields-filled.png|frame]]<br />
Проверяет заполненность полей показателей в записи журнала по настраиваемому списку. Проверяет наличие определённых показателей (например, "Аммоний-ион") и заполненность у них таких полей, как исполнители, методики, средний результат и др. Выдаёт ошибку, если показатели отсутствуют или не все поля заполнены.<br />
<br />
== Проверка заполненности атрибутов записи ЛЖ. <code>check-record-fields-filled</code> ==<br />
Проверяет заполненность заданных полей в записи журнала (например, "Источник", "Место отбора", "Дата регистрации" и др.). Если какое-либо из обязательных полей не заполнено, выдаётся соответствующая ошибка.<br />
<br />
== Проверка движения пробы. <code>check-sample-moving</code> ==<br />
[[Файл:Check-sample-moving.png|frame]]<br />
Проверяет маршрут движения пробы по этапам. Получает историю перемещений записи и определяет, происходило ли движение (нахождение более чем на одном этапе). Отображает маршрут или сообщает, что движение не происходило.<br />
<br />
== Проверка прав пользователя. <code>check-user-rights</code> ==<br />
[[Файл:Check-user-rights.png|frame]]<br />
Проверяет права доступа пользователя к определённым ресурсам (объекты анализа, методики, записи ЛЖ). Отображает таблицу с типами доступа (чтение, запись и т.д.) и наличием прав по каждому ресурсу.<br />
<br />
== Заполнение атрибутов записи ЛЖ. <code>fill-record-fields</code> ==<br />
[[Файл:Fill-record-fields.png|frame]]<br />
Автоматически заполняет заданные поля в записи журнала (например, даты, место отбора, шифр пробы и др.). Есть возможность использования ключевых слов для сопоставления полей, если точные названия не совпадают.<br />
<br />
== Деление данных. <code>copy-journal-record</code> ==<br />
Создаёт копию записи журнала на заданном этапе маршрута. Выводит сообщение с ID новой записи.</div>
Arhidiman
https://wiki.chemsoft.ru/index.php?title=%D0%90%D0%B4%D0%B4%D0%BE%D0%BD%D1%8B&diff=2343
Аддоны
2026-04-01T09:23:26Z
<p>Arhidiman: /* Проверка прав пользователя. check-user-rights */</p>
<hr />
<div>Список демонстрационных аддонов, показывающих возможности интеграционного сервиса.<br />
<br />
== Проверка даты регистрации. <code>check-registration-date</code> ==<br />
[[Файл:check-registration-date.png|frame]]<br />
Проверяет, не истёк ли срок регистрации пробы. Сравнивает дату регистрации из указанного поля с текущей датой. Если прошло более заданного количества дней (по умолчанию — 10), выдаёт ошибку. В противном случае показывает сообщение об успешной проверке.<br />
<br />
== Проверка заполненности полей показателей. <code>check-indicator-fields-filled</code> ==<br />
[[Файл:Check-indicator-fields-filled.png|frame]]<br />
Проверяет заполненность полей показателей в записи журнала по настраиваемому списку. Проверяет наличие определённых показателей (например, "Аммоний-ион") и заполненность у них таких полей, как исполнители, методики, средний результат и др. Выдаёт ошибку, если показатели отсутствуют или не все поля заполнены.<br />
<br />
== Проверка заполненности атрибутов записи ЛЖ. <code>check-record-fields-filled</code> ==<br />
Проверяет заполненность заданных полей в записи журнала (например, "Источник", "Место отбора", "Дата регистрации" и др.). Если какое-либо из обязательных полей не заполнено, выдаётся соответствующая ошибка.<br />
<br />
== Проверка движения пробы. <code>check-sample-moving</code> ==<br />
[[Файл:Check-sample-moving.png|frame]]<br />
Проверяет маршрут движения пробы по этапам. Получает историю перемещений записи и определяет, происходило ли движение (нахождение более чем на одном этапе). Отображает маршрут или сообщает, что движение не происходило.<br />
<br />
== Проверка прав пользователя. <code>check-user-rights</code> ==<br />
[[Файл:Check-user-rights.png|frame]]<br />
Проверяет права доступа пользователя к определённым ресурсам (объекты анализа, методики, записи ЛЖ). Отображает таблицу с типами доступа (чтение, запись и т.д.) и наличием прав по каждому ресурсу.<br />
<br />
== Заполнение атрибутов записи ЛЖ. <code>fill-record-fields</code> ==<br />
Автоматически заполняет заданные поля в записи журнала (например, даты, место отбора, шифр пробы и др.). Есть возможность использования ключевых слов для сопоставления полей, если точные названия не совпадают.<br />
<br />
== Деление данных. <code>copy-journal-record</code> ==<br />
Создаёт копию записи журнала на заданном этапе маршрута. Выводит сообщение с ID новой записи.</div>
Arhidiman
https://wiki.chemsoft.ru/index.php?title=%D0%A4%D0%B0%D0%B9%D0%BB:Check-user-rights.png&diff=2342
Файл:Check-user-rights.png
2026-04-01T09:23:08Z
<p>Arhidiman: </p>
<hr />
<div></div>
Arhidiman
https://wiki.chemsoft.ru/index.php?title=%D0%90%D0%B4%D0%B4%D0%BE%D0%BD%D1%8B&diff=2341
Аддоны
2026-04-01T09:22:36Z
<p>Arhidiman: /* Проверка движения пробы. check-sample-moving */</p>
<hr />
<div>Список демонстрационных аддонов, показывающих возможности интеграционного сервиса.<br />
<br />
== Проверка даты регистрации. <code>check-registration-date</code> ==<br />
[[Файл:check-registration-date.png|frame]]<br />
Проверяет, не истёк ли срок регистрации пробы. Сравнивает дату регистрации из указанного поля с текущей датой. Если прошло более заданного количества дней (по умолчанию — 10), выдаёт ошибку. В противном случае показывает сообщение об успешной проверке.<br />
<br />
== Проверка заполненности полей показателей. <code>check-indicator-fields-filled</code> ==<br />
[[Файл:Check-indicator-fields-filled.png|frame]]<br />
Проверяет заполненность полей показателей в записи журнала по настраиваемому списку. Проверяет наличие определённых показателей (например, "Аммоний-ион") и заполненность у них таких полей, как исполнители, методики, средний результат и др. Выдаёт ошибку, если показатели отсутствуют или не все поля заполнены.<br />
<br />
== Проверка заполненности атрибутов записи ЛЖ. <code>check-record-fields-filled</code> ==<br />
Проверяет заполненность заданных полей в записи журнала (например, "Источник", "Место отбора", "Дата регистрации" и др.). Если какое-либо из обязательных полей не заполнено, выдаётся соответствующая ошибка.<br />
<br />
== Проверка движения пробы. <code>check-sample-moving</code> ==<br />
[[Файл:Check-sample-moving.png|frame]]<br />
Проверяет маршрут движения пробы по этапам. Получает историю перемещений записи и определяет, происходило ли движение (нахождение более чем на одном этапе). Отображает маршрут или сообщает, что движение не происходило.<br />
<br />
== Проверка прав пользователя. <code>check-user-rights</code> ==<br />
Проверяет права доступа пользователя к определённым ресурсам (объекты анализа, методики, записи ЛЖ). Отображает таблицу с типами доступа (чтение, запись и т.д.) и наличием прав по каждому ресурсу.<br />
<br />
== Заполнение атрибутов записи ЛЖ. <code>fill-record-fields</code> ==<br />
Автоматически заполняет заданные поля в записи журнала (например, даты, место отбора, шифр пробы и др.). Есть возможность использования ключевых слов для сопоставления полей, если точные названия не совпадают.<br />
<br />
== Деление данных. <code>copy-journal-record</code> ==<br />
Создаёт копию записи журнала на заданном этапе маршрута. Выводит сообщение с ID новой записи.</div>
Arhidiman
https://wiki.chemsoft.ru/index.php?title=%D0%90%D0%B4%D0%B4%D0%BE%D0%BD%D1%8B&diff=2340
Аддоны
2026-04-01T09:21:59Z
<p>Arhidiman: /* Проверка заполненности полей показателей. check-indicator-fields-filled */</p>
<hr />
<div>Список демонстрационных аддонов, показывающих возможности интеграционного сервиса.<br />
<br />
== Проверка даты регистрации. <code>check-registration-date</code> ==<br />
[[Файл:check-registration-date.png|frame]]<br />
Проверяет, не истёк ли срок регистрации пробы. Сравнивает дату регистрации из указанного поля с текущей датой. Если прошло более заданного количества дней (по умолчанию — 10), выдаёт ошибку. В противном случае показывает сообщение об успешной проверке.<br />
<br />
== Проверка заполненности полей показателей. <code>check-indicator-fields-filled</code> ==<br />
[[Файл:Check-indicator-fields-filled.png|frame]]<br />
Проверяет заполненность полей показателей в записи журнала по настраиваемому списку. Проверяет наличие определённых показателей (например, "Аммоний-ион") и заполненность у них таких полей, как исполнители, методики, средний результат и др. Выдаёт ошибку, если показатели отсутствуют или не все поля заполнены.<br />
<br />
== Проверка заполненности атрибутов записи ЛЖ. <code>check-record-fields-filled</code> ==<br />
Проверяет заполненность заданных полей в записи журнала (например, "Источник", "Место отбора", "Дата регистрации" и др.). Если какое-либо из обязательных полей не заполнено, выдаётся соответствующая ошибка.<br />
<br />
== Проверка движения пробы. <code>check-sample-moving</code> ==<br />
Проверяет маршрут движения пробы по этапам. Получает историю перемещений записи и определяет, происходило ли движение (нахождение более чем на одном этапе). Отображает маршрут или сообщает, что движение не происходило.<br />
<br />
== Проверка прав пользователя. <code>check-user-rights</code> ==<br />
Проверяет права доступа пользователя к определённым ресурсам (объекты анализа, методики, записи ЛЖ). Отображает таблицу с типами доступа (чтение, запись и т.д.) и наличием прав по каждому ресурсу.<br />
<br />
== Заполнение атрибутов записи ЛЖ. <code>fill-record-fields</code> ==<br />
Автоматически заполняет заданные поля в записи журнала (например, даты, место отбора, шифр пробы и др.). Есть возможность использования ключевых слов для сопоставления полей, если точные названия не совпадают.<br />
<br />
== Деление данных. <code>copy-journal-record</code> ==<br />
Создаёт копию записи журнала на заданном этапе маршрута. Выводит сообщение с ID новой записи.</div>
Arhidiman
https://wiki.chemsoft.ru/index.php?title=%D0%A4%D0%B0%D0%B9%D0%BB:Fill-record-fields.png&diff=2339
Файл:Fill-record-fields.png
2026-04-01T09:19:55Z
<p>Arhidiman: </p>
<hr />
<div></div>
Arhidiman
https://wiki.chemsoft.ru/index.php?title=%D0%A4%D0%B0%D0%B9%D0%BB:Copy-journal-record.png&diff=2338
Файл:Copy-journal-record.png
2026-04-01T09:19:23Z
<p>Arhidiman: </p>
<hr />
<div></div>
Arhidiman
https://wiki.chemsoft.ru/index.php?title=%D0%A4%D0%B0%D0%B9%D0%BB:Check-sample-moving.png&diff=2337
Файл:Check-sample-moving.png
2026-04-01T09:19:07Z
<p>Arhidiman: </p>
<hr />
<div></div>
Arhidiman
https://wiki.chemsoft.ru/index.php?title=%D0%A4%D0%B0%D0%B9%D0%BB:Check-record-fields-filled.png&diff=2336
Файл:Check-record-fields-filled.png
2026-04-01T09:18:54Z
<p>Arhidiman: </p>
<hr />
<div></div>
Arhidiman
https://wiki.chemsoft.ru/index.php?title=%D0%A4%D0%B0%D0%B9%D0%BB:Check-indicator-fields-filled.png&diff=2335
Файл:Check-indicator-fields-filled.png
2026-04-01T09:18:27Z
<p>Arhidiman: </p>
<hr />
<div></div>
Arhidiman
https://wiki.chemsoft.ru/index.php?title=%D0%90%D0%B4%D0%B4%D0%BE%D0%BD%D1%8B&diff=2334
Аддоны
2026-04-01T09:14:40Z
<p>Arhidiman: /* Проверка даты регистрации. check-registration-date */</p>
<hr />
<div>Список демонстрационных аддонов, показывающих возможности интеграционного сервиса.<br />
<br />
== Проверка даты регистрации. <code>check-registration-date</code> ==<br />
[[Файл:check-registration-date.png|frame]]<br />
Проверяет, не истёк ли срок регистрации пробы. Сравнивает дату регистрации из указанного поля с текущей датой. Если прошло более заданного количества дней (по умолчанию — 10), выдаёт ошибку. В противном случае показывает сообщение об успешной проверке.<br />
<br />
== Проверка заполненности полей показателей. <code>check-indicator-fields-filled</code> ==<br />
Проверяет заполненность полей показателей в записи журнала по настраиваемому списку. Проверяет наличие определённых показателей (например, "Аммоний-ион") и заполненность у них таких полей, как исполнители, методики, средний результат и др. Выдаёт ошибку, если показатели отсутствуют или не все поля заполнены.<br />
<br />
== Проверка заполненности атрибутов записи ЛЖ. <code>check-record-fields-filled</code> ==<br />
Проверяет заполненность заданных полей в записи журнала (например, "Источник", "Место отбора", "Дата регистрации" и др.). Если какое-либо из обязательных полей не заполнено, выдаётся соответствующая ошибка.<br />
<br />
== Проверка движения пробы. <code>check-sample-moving</code> ==<br />
Проверяет маршрут движения пробы по этапам. Получает историю перемещений записи и определяет, происходило ли движение (нахождение более чем на одном этапе). Отображает маршрут или сообщает, что движение не происходило.<br />
<br />
== Проверка прав пользователя. <code>check-user-rights</code> ==<br />
Проверяет права доступа пользователя к определённым ресурсам (объекты анализа, методики, записи ЛЖ). Отображает таблицу с типами доступа (чтение, запись и т.д.) и наличием прав по каждому ресурсу.<br />
<br />
== Заполнение атрибутов записи ЛЖ. <code>fill-record-fields</code> ==<br />
Автоматически заполняет заданные поля в записи журнала (например, даты, место отбора, шифр пробы и др.). Есть возможность использования ключевых слов для сопоставления полей, если точные названия не совпадают.<br />
<br />
== Деление данных. <code>copy-journal-record</code> ==<br />
Создаёт копию записи журнала на заданном этапе маршрута. Выводит сообщение с ID новой записи.</div>
Arhidiman
https://wiki.chemsoft.ru/index.php?title=%D0%90%D0%B4%D0%B4%D0%BE%D0%BD%D1%8B&diff=2333
Аддоны
2026-04-01T09:14:25Z
<p>Arhidiman: </p>
<hr />
<div>Список демонстрационных аддонов, показывающих возможности интеграционного сервиса.<br />
<br />
== Проверка даты регистрации. <code>check-registration-date</code> ==<br />
<br />
Проверяет, не истёк ли срок регистрации пробы. Сравнивает дату регистрации из указанного поля с текущей датой. Если прошло более заданного количества дней (по умолчанию — 10), выдаёт ошибку. В противном случае показывает сообщение об успешной проверке.[[Файл:check-registration-date.png|frame]]<br />
<br />
== Проверка заполненности полей показателей. <code>check-indicator-fields-filled</code> ==<br />
Проверяет заполненность полей показателей в записи журнала по настраиваемому списку. Проверяет наличие определённых показателей (например, "Аммоний-ион") и заполненность у них таких полей, как исполнители, методики, средний результат и др. Выдаёт ошибку, если показатели отсутствуют или не все поля заполнены.<br />
<br />
== Проверка заполненности атрибутов записи ЛЖ. <code>check-record-fields-filled</code> ==<br />
Проверяет заполненность заданных полей в записи журнала (например, "Источник", "Место отбора", "Дата регистрации" и др.). Если какое-либо из обязательных полей не заполнено, выдаётся соответствующая ошибка.<br />
<br />
== Проверка движения пробы. <code>check-sample-moving</code> ==<br />
Проверяет маршрут движения пробы по этапам. Получает историю перемещений записи и определяет, происходило ли движение (нахождение более чем на одном этапе). Отображает маршрут или сообщает, что движение не происходило.<br />
<br />
== Проверка прав пользователя. <code>check-user-rights</code> ==<br />
Проверяет права доступа пользователя к определённым ресурсам (объекты анализа, методики, записи ЛЖ). Отображает таблицу с типами доступа (чтение, запись и т.д.) и наличием прав по каждому ресурсу.<br />
<br />
== Заполнение атрибутов записи ЛЖ. <code>fill-record-fields</code> ==<br />
Автоматически заполняет заданные поля в записи журнала (например, даты, место отбора, шифр пробы и др.). Есть возможность использования ключевых слов для сопоставления полей, если точные названия не совпадают.<br />
<br />
== Деление данных. <code>copy-journal-record</code> ==<br />
Создаёт копию записи журнала на заданном этапе маршрута. Выводит сообщение с ID новой записи.</div>
Arhidiman
https://wiki.chemsoft.ru/index.php?title=%D0%90%D0%B4%D0%B4%D0%BE%D0%BD%D1%8B&diff=2332
Аддоны
2026-04-01T09:14:06Z
<p>Arhidiman: /* Проверка даты регистрации. check-registration-date */</p>
<hr />
<div>Список демонстрационных аддонов, показывающих возможности интеграционного сервиса.<br />
<br />
== Проверка даты регистрации. <code>check-registration-date</code> ==<br />
[[Файл:check-registration-date.png|frame]]<br />
Проверяет, не истёк ли срок регистрации пробы. Сравнивает дату регистрации из указанного поля с текущей датой. Если прошло более заданного количества дней (по умолчанию — 10), выдаёт ошибку. В противном случае показывает сообщение об успешной проверке.<br />
<br />
== Проверка заполненности полей показателей. <code>check-indicator-fields-filled</code> ==<br />
Проверяет заполненность полей показателей в записи журнала по настраиваемому списку. Проверяет наличие определённых показателей (например, "Аммоний-ион") и заполненность у них таких полей, как исполнители, методики, средний результат и др. Выдаёт ошибку, если показатели отсутствуют или не все поля заполнены.<br />
<br />
== Проверка заполненности атрибутов записи ЛЖ. <code>check-record-fields-filled</code> ==<br />
Проверяет заполненность заданных полей в записи журнала (например, "Источник", "Место отбора", "Дата регистрации" и др.). Если какое-либо из обязательных полей не заполнено, выдаётся соответствующая ошибка.<br />
<br />
== Проверка движения пробы. <code>check-sample-moving</code> ==<br />
Проверяет маршрут движения пробы по этапам. Получает историю перемещений записи и определяет, происходило ли движение (нахождение более чем на одном этапе). Отображает маршрут или сообщает, что движение не происходило.<br />
<br />
== Проверка прав пользователя. <code>check-user-rights</code> ==<br />
Проверяет права доступа пользователя к определённым ресурсам (объекты анализа, методики, записи ЛЖ). Отображает таблицу с типами доступа (чтение, запись и т.д.) и наличием прав по каждому ресурсу.<br />
<br />
== Заполнение атрибутов записи ЛЖ. <code>fill-record-fields</code> ==<br />
Автоматически заполняет заданные поля в записи журнала (например, даты, место отбора, шифр пробы и др.). Есть возможность использования ключевых слов для сопоставления полей, если точные названия не совпадают.<br />
<br />
== Деление данных. <code>copy-journal-record</code> ==<br />
Создаёт копию записи журнала на заданном этапе маршрута. Выводит сообщение с ID новой записи.</div>
Arhidiman
https://wiki.chemsoft.ru/index.php?title=%D0%90%D0%B4%D0%B4%D0%BE%D0%BD%D1%8B&diff=2331
Аддоны
2026-04-01T09:13:46Z
<p>Arhidiman: /* Проверка даты регистрации. check-registration-date */</p>
<hr />
<div>Список демонстрационных аддонов, показывающих возможности интеграционного сервиса.<br />
<br />
== Проверка даты регистрации. <code>check-registration-date</code> ==<br />
Проверяет, не истёк ли срок регистрации пробы. Сравнивает дату регистрации из указанного поля с текущей датой. Если прошло более заданного количества дней (по умолчанию — 10), выдаёт ошибку. В противном случае показывает сообщение об успешной проверке.[[Файл:check-registration-date.png|frame]]<br />
<br />
== Проверка заполненности полей показателей. <code>check-indicator-fields-filled</code> ==<br />
Проверяет заполненность полей показателей в записи журнала по настраиваемому списку. Проверяет наличие определённых показателей (например, "Аммоний-ион") и заполненность у них таких полей, как исполнители, методики, средний результат и др. Выдаёт ошибку, если показатели отсутствуют или не все поля заполнены.<br />
<br />
== Проверка заполненности атрибутов записи ЛЖ. <code>check-record-fields-filled</code> ==<br />
Проверяет заполненность заданных полей в записи журнала (например, "Источник", "Место отбора", "Дата регистрации" и др.). Если какое-либо из обязательных полей не заполнено, выдаётся соответствующая ошибка.<br />
<br />
== Проверка движения пробы. <code>check-sample-moving</code> ==<br />
Проверяет маршрут движения пробы по этапам. Получает историю перемещений записи и определяет, происходило ли движение (нахождение более чем на одном этапе). Отображает маршрут или сообщает, что движение не происходило.<br />
<br />
== Проверка прав пользователя. <code>check-user-rights</code> ==<br />
Проверяет права доступа пользователя к определённым ресурсам (объекты анализа, методики, записи ЛЖ). Отображает таблицу с типами доступа (чтение, запись и т.д.) и наличием прав по каждому ресурсу.<br />
<br />
== Заполнение атрибутов записи ЛЖ. <code>fill-record-fields</code> ==<br />
Автоматически заполняет заданные поля в записи журнала (например, даты, место отбора, шифр пробы и др.). Есть возможность использования ключевых слов для сопоставления полей, если точные названия не совпадают.<br />
<br />
== Деление данных. <code>copy-journal-record</code> ==<br />
Создаёт копию записи журнала на заданном этапе маршрута. Выводит сообщение с ID новой записи.</div>
Arhidiman
https://wiki.chemsoft.ru/index.php?title=%D0%90%D0%B4%D0%B4%D0%BE%D0%BD%D1%8B&diff=2330
Аддоны
2026-04-01T09:13:01Z
<p>Arhidiman: /* Проверка даты регистрации. check-registration-date */</p>
<hr />
<div>Список демонстрационных аддонов, показывающих возможности интеграционного сервиса.<br />
<br />
== Проверка даты регистрации. <code>check-registration-date</code> ==<br />
Проверяет, не истёк ли срок регистрации пробы. Сравнивает дату регистрации из указанного поля с текущей датой. Если прошло более заданного количества дней (по умолчанию — 10), выдаёт ошибку. В противном случае показывает сообщение об успешной проверке.<br />
[[Файл:check-registration-date.png|frame]]<br />
<br />
== Проверка заполненности полей показателей. <code>check-indicator-fields-filled</code> ==<br />
Проверяет заполненность полей показателей в записи журнала по настраиваемому списку. Проверяет наличие определённых показателей (например, "Аммоний-ион") и заполненность у них таких полей, как исполнители, методики, средний результат и др. Выдаёт ошибку, если показатели отсутствуют или не все поля заполнены.<br />
<br />
== Проверка заполненности атрибутов записи ЛЖ. <code>check-record-fields-filled</code> ==<br />
Проверяет заполненность заданных полей в записи журнала (например, "Источник", "Место отбора", "Дата регистрации" и др.). Если какое-либо из обязательных полей не заполнено, выдаётся соответствующая ошибка.<br />
<br />
== Проверка движения пробы. <code>check-sample-moving</code> ==<br />
Проверяет маршрут движения пробы по этапам. Получает историю перемещений записи и определяет, происходило ли движение (нахождение более чем на одном этапе). Отображает маршрут или сообщает, что движение не происходило.<br />
<br />
== Проверка прав пользователя. <code>check-user-rights</code> ==<br />
Проверяет права доступа пользователя к определённым ресурсам (объекты анализа, методики, записи ЛЖ). Отображает таблицу с типами доступа (чтение, запись и т.д.) и наличием прав по каждому ресурсу.<br />
<br />
== Заполнение атрибутов записи ЛЖ. <code>fill-record-fields</code> ==<br />
Автоматически заполняет заданные поля в записи журнала (например, даты, место отбора, шифр пробы и др.). Есть возможность использования ключевых слов для сопоставления полей, если точные названия не совпадают.<br />
<br />
== Деление данных. <code>copy-journal-record</code> ==<br />
Создаёт копию записи журнала на заданном этапе маршрута. Выводит сообщение с ID новой записи.</div>
Arhidiman
https://wiki.chemsoft.ru/index.php?title=%D0%A4%D0%B0%D0%B9%D0%BB:Check-registration-date.png&diff=2327
Файл:Check-registration-date.png
2026-04-01T09:10:20Z
<p>Arhidiman: </p>
<hr />
<div></div>
Arhidiman
https://wiki.chemsoft.ru/index.php?title=%D0%90%D0%B4%D0%B4%D0%BE%D0%BD%D1%8B&diff=2275
Аддоны
2026-03-31T08:32:41Z
<p>Arhidiman: </p>
<hr />
<div>Список демонстрационных аддонов, показывающих возможности интеграционного сервиса.<br />
<br />
== Проверка даты регистрации. <code>check-registration-date</code> ==<br />
Проверяет, не истёк ли срок регистрации пробы. Сравнивает дату регистрации из указанного поля с текущей датой. Если прошло более заданного количества дней (по умолчанию — 10), выдаёт ошибку. В противном случае показывает сообщение об успешной проверке.<br />
<br />
== Проверка заполненности полей показателей. <code>check-indicator-fields-filled</code> ==<br />
Проверяет заполненность полей показателей в записи журнала по настраиваемому списку. Проверяет наличие определённых показателей (например, "Аммоний-ион") и заполненность у них таких полей, как исполнители, методики, средний результат и др. Выдаёт ошибку, если показатели отсутствуют или не все поля заполнены.<br />
<br />
== Проверка заполненности атрибутов записи ЛЖ. <code>check-record-fields-filled</code> ==<br />
Проверяет заполненность заданных полей в записи журнала (например, "Источник", "Место отбора", "Дата регистрации" и др.). Если какое-либо из обязательных полей не заполнено, выдаётся соответствующая ошибка.<br />
<br />
== Проверка движения пробы. <code>check-sample-moving</code> ==<br />
Проверяет маршрут движения пробы по этапам. Получает историю перемещений записи и определяет, происходило ли движение (нахождение более чем на одном этапе). Отображает маршрут или сообщает, что движение не происходило.<br />
<br />
== Проверка прав пользователя. <code>check-user-rights</code> ==<br />
Проверяет права доступа пользователя к определённым ресурсам (объекты анализа, методики, записи ЛЖ). Отображает таблицу с типами доступа (чтение, запись и т.д.) и наличием прав по каждому ресурсу.<br />
<br />
== Заполнение атрибутов записи ЛЖ. <code>fill-record-fields</code> ==<br />
Автоматически заполняет заданные поля в записи журнала (например, даты, место отбора, шифр пробы и др.). Есть возможность использования ключевых слов для сопоставления полей, если точные названия не совпадают.<br />
<br />
== Деление данных. <code>copy-journal-record</code> ==<br />
Создаёт копию записи журнала на заданном этапе маршрута. Выводит сообщение с ID новой записи.</div>
Arhidiman
https://wiki.chemsoft.ru/index.php?title=%D0%90%D0%B4%D0%B4%D0%BE%D0%BD%D1%8B&diff=2274
Аддоны
2026-03-31T08:11:43Z
<p>Arhidiman: </p>
<hr />
<div>Список демонстрационных аддонов, показывающих возможности интеграционного сервиса.<br />
<br />
== Проверка даты регистрации. <code>check-registration-date</code> ==<br />
Проверяет, не истёк ли срок регистрации пробы. Сравнивает дату регистрации из указанного поля с текущей датой. Если прошло более заданного количества дней (по умолчанию — 10), выдаёт ошибку. В противном случае показывает сообщение об успешной проверке.<br />
<br />
== Проверка заполненности полей показателей. <code>check-indicator-fields-filled</code> ==<br />
Проверяет заполненность полей показателей (индикаторов) в записи журнала по настраиваемому списку. Проверяет наличие определённых показателей (например, "Аммоний-ион") и заполненность у них таких полей, как исполнители, методики, средний результат и др. Выдаёт ошибку, если показатели отсутствуют или не все поля заполнены.<br />
<br />
== Проверка заполненности атрибутов записи ЛЖ. <code>check-record-fields-filled</code> ==<br />
Проверяет заполненность заданных полей в записи журнала (например, "Источник", "Место отбора", "Дата регистрации" и др.). Если какое-либо из обязательных полей не заполнено, выдаётся соответствующая ошибка.<br />
<br />
== Проверка движения пробы. <code>check-sample-moving</code> ==<br />
Проверяет маршрут движения пробы по этапам. Получает историю перемещений записи и определяет, происходило ли движение (нахождение более чем на одном этапе). Отображает маршрут или сообщает, что движение не происходило.<br />
<br />
== Проверка прав пользователя. <code>check-user-rights</code> ==<br />
Проверяет права доступа пользователя к определённым ресурсам (объекты анализа, методики, записи ЛЖ). Отображает таблицу с типами доступа (чтение, запись и т.д.) и наличием прав по каждому ресурсу.<br />
<br />
== Заполнение атрибутов записи ЛЖ. <code>fill-record-fields</code> ==<br />
Автоматически заполняет заданные поля в записи журнала (например, даты, место отбора, шифр пробы и др.). Есть возможность использования ключевых слов для сопоставления полей, если точные названия не совпадают.<br />
<br />
== Деление данных. <code>copy-journal-record</code> ==<br />
Создаёт копию записи журнала на заданном этапе маршрута. Выводит сообщение с ID новой записи.</div>
Arhidiman
https://wiki.chemsoft.ru/index.php?title=%D0%98%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D0%B8_WEB_%D0%9B%D0%98%D0%9C%D0%A1_%D0%A2%D1%80%D0%B8%D1%82%D0%B5%D1%8F&diff=2273
Интеграции WEB ЛИМС Тритея
2026-03-31T08:03:57Z
<p>Arhidiman: Arhidiman переименовал страницу Интеграции WEB ЛИМС Тритея в Аддоны WEB ЛИМС Тритея</p>
<hr />
<div>#перенаправление [[Аддоны WEB ЛИМС Тритея]]</div>
Arhidiman
https://wiki.chemsoft.ru/index.php?title=%D0%90%D0%B4%D0%B4%D0%BE%D0%BD%D1%8B&diff=2272
Аддоны
2026-03-31T08:03:57Z
<p>Arhidiman: Arhidiman переименовал страницу Интеграции WEB ЛИМС Тритея в Аддоны WEB ЛИМС Тритея</p>
<hr />
<div>Список демонстрационных аддонов, показывающих возможности интеграционного сервиса.<br />
<br />
== Проверка даты регистрации. <code>check-registration-date</code> ==<br />
Проверяет, не истёк ли срок регистрации пробы. Сравнивает дату регистрации из указанного поля с текущей датой. Если прошло более заданного количества дней (по умолчанию — 10), выдаёт ошибку. В противном случае показывает сообщение об успешной проверке.<br />
<br />
== Проверка заполненности полей показателей. <code>check-indicator-fields-filled</code> ==<br />
Проверяет заполненность полей показателей (индикаторов) в записи журнала. Проверяет наличие определённых показателей (например, "Аммоний-ион") и заполненность у них таких полей, как исполнители, методики, средний результат и др. Выдаёт ошибку, если показатели отсутствуют или не все поля заполнены.<br />
<br />
== Проверка заполненности атрибутов записи ЛЖ. <code>check-record-fields-filled</code> ==<br />
Проверяет заполненность заданных полей в записи журнала (например, "Источник", "Место отбора", "Дата регистрации" и др.). Если какое-либо из обязательных полей не заполнено, выдаётся соответствующая ошибка.<br />
<br />
== Проверка движения пробы. <code>check-sample-moving</code> ==<br />
Проверяет маршрут движения пробы по этапам. Получает историю перемещений записи и определяет, происходило ли движение (более одного этапа). Отображает маршрут или сообщает, что движение не происходило.<br />
<br />
== Проверка прав пользователя. <code>check-user-rights</code> ==<br />
Проверяет права доступа пользователя к определённым ресурсам (объекты анализа, методики, записи ЛЖ). Отображает таблицу с типами доступа (чтение, запись и т.д.) и наличием прав по каждому ресурсу.<br />
<br />
== Заполнение атрибутов записи ЛЖ. <code>fill-record-fields</code> ==<br />
Автоматически заполняет заданные поля в записи журнала (например, даты, место отбора, шифр пробы и др.). Использует ключевые слова для сопоставления полей, если точные имена не совпадают.<br />
<br />
== Копирование записи журнала. <code>copy-journal-record</code> ==<br />
Создаёт копию записи журнала на следующем этапе маршрута. Копирует все атрибуты и данные, корректируя даты и время при необходимости. Возвращает ID новой записи.</div>
Arhidiman
https://wiki.chemsoft.ru/index.php?title=%D0%90%D0%B4%D0%B4%D0%BE%D0%BD%D1%8B&diff=2271
Аддоны
2026-03-31T08:03:39Z
<p>Arhidiman: </p>
<hr />
<div>Список демонстрационных аддонов, показывающих возможности интеграционного сервиса.<br />
<br />
== Проверка даты регистрации. <code>check-registration-date</code> ==<br />
Проверяет, не истёк ли срок регистрации пробы. Сравнивает дату регистрации из указанного поля с текущей датой. Если прошло более заданного количества дней (по умолчанию — 10), выдаёт ошибку. В противном случае показывает сообщение об успешной проверке.<br />
<br />
== Проверка заполненности полей показателей. <code>check-indicator-fields-filled</code> ==<br />
Проверяет заполненность полей показателей (индикаторов) в записи журнала. Проверяет наличие определённых показателей (например, "Аммоний-ион") и заполненность у них таких полей, как исполнители, методики, средний результат и др. Выдаёт ошибку, если показатели отсутствуют или не все поля заполнены.<br />
<br />
== Проверка заполненности атрибутов записи ЛЖ. <code>check-record-fields-filled</code> ==<br />
Проверяет заполненность заданных полей в записи журнала (например, "Источник", "Место отбора", "Дата регистрации" и др.). Если какое-либо из обязательных полей не заполнено, выдаётся соответствующая ошибка.<br />
<br />
== Проверка движения пробы. <code>check-sample-moving</code> ==<br />
Проверяет маршрут движения пробы по этапам. Получает историю перемещений записи и определяет, происходило ли движение (более одного этапа). Отображает маршрут или сообщает, что движение не происходило.<br />
<br />
== Проверка прав пользователя. <code>check-user-rights</code> ==<br />
Проверяет права доступа пользователя к определённым ресурсам (объекты анализа, методики, записи ЛЖ). Отображает таблицу с типами доступа (чтение, запись и т.д.) и наличием прав по каждому ресурсу.<br />
<br />
== Заполнение атрибутов записи ЛЖ. <code>fill-record-fields</code> ==<br />
Автоматически заполняет заданные поля в записи журнала (например, даты, место отбора, шифр пробы и др.). Использует ключевые слова для сопоставления полей, если точные имена не совпадают.<br />
<br />
== Копирование записи журнала. <code>copy-journal-record</code> ==<br />
Создаёт копию записи журнала на следующем этапе маршрута. Копирует все атрибуты и данные, корректируя даты и время при необходимости. Возвращает ID новой записи.</div>
Arhidiman
https://wiki.chemsoft.ru/index.php?title=%D0%90%D0%B4%D0%B4%D0%BE%D0%BD%D1%8B&diff=2270
Аддоны
2026-03-31T08:02:22Z
<p>Arhidiman: Новая страница: «== Описание пронумерованных скриптов в папке test_scripts == == Проверка даты регистрации. <code>check-registration-date</code> == Проверяет, не истёк ли срок регистрации пробы. Сравнивает дату регистрации из указанного поля с текущей датой. Если прошло более заданного количес...»</p>
<hr />
<div>== Описание пронумерованных скриптов в папке test_scripts ==<br />
<br />
== Проверка даты регистрации. <code>check-registration-date</code> ==<br />
Проверяет, не истёк ли срок регистрации пробы. Сравнивает дату регистрации из указанного поля с текущей датой. Если прошло более заданного количества дней (по умолчанию — 10), выдаёт ошибку. В противном случае показывает сообщение об успешной проверке.<br />
<br />
== Проверка заполненности полей показателей. <code>check-indicator-fields-filled</code> ==<br />
Проверяет заполненность полей показателей (индикаторов) в записи журнала. Проверяет наличие определённых показателей (например, "Аммоний-ион") и заполненность у них таких полей, как исполнители, методики, средний результат и др. Выдаёт ошибку, если показатели отсутствуют или не все поля заполнены.<br />
<br />
== Проверка заполненности атрибутов записи ЛЖ. <code>check-record-fields-filled</code> ==<br />
Проверяет заполненность заданных полей в записи журнала (например, "Источник", "Место отбора", "Дата регистрации" и др.). Если какое-либо из обязательных полей не заполнено, выдаётся соответствующая ошибка.<br />
<br />
== Проверка движения пробы. <code>check-sample-moving</code> ==<br />
Проверяет маршрут движения пробы по этапам. Получает историю перемещений записи и определяет, происходило ли движение (более одного этапа). Отображает маршрут или сообщает, что движение не происходило.<br />
<br />
== Проверка прав пользователя. <code>check-user-rights</code> ==<br />
Проверяет права доступа пользователя к определённым ресурсам (объекты анализа, методики, записи ЛЖ). Отображает таблицу с типами доступа (чтение, запись и т.д.) и наличием прав по каждому ресурсу.<br />
<br />
== Заполнение атрибутов записи ЛЖ. <code>fill-record-fields</code> ==<br />
Автоматически заполняет заданные поля в записи журнала (например, даты, место отбора, шифр пробы и др.). Использует ключевые слова для сопоставления полей, если точные имена не совпадают.<br />
<br />
== Копирование записи журнала. <code>copy-journal-record</code> ==<br />
Создаёт копию записи журнала на следующем этапе маршрута. Копирует все атрибуты и данные, корректируя даты и время при необходимости. Возвращает ID новой записи.</div>
Arhidiman
https://wiki.chemsoft.ru/index.php?title=%D0%97%D0%B0%D0%B3%D0%BB%D0%B0%D0%B2%D0%BD%D0%B0%D1%8F_%D1%81%D1%82%D1%80%D0%B0%D0%BD%D0%B8%D1%86%D0%B0&diff=2269
Заглавная страница
2026-03-31T07:47:13Z
<p>Arhidiman: </p>
<hr />
<div>==[[Справочник разработчика ЛИС]]==<br />
<br />
==[[Руководство по настройке шаблонов WEB ЛИМС Тритея]]==<br />
<br />
==[[Основные управляющие функции в дизайнере документов ЛИС 1.5]]==<br />
<br />
==[[Интеграции WEB ЛИМС Тритея]]==</div>
Arhidiman
https://wiki.chemsoft.ru/index.php?title=%D0%98%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D0%B8&diff=2267
Интеграции
2026-03-31T07:36:06Z
<p>Arhidiman: Новая страница: «Описание интеграционных скриптов WEB ЛИМС»</p>
<hr />
<div>Описание интеграционных скриптов WEB ЛИМС</div>
Arhidiman