Release 3.3.0

Новый дизайн платформы

Масштабно обновлен интерфейс: переработаны логотип и цветовая палитра, упрощен дизайн форм и усилен фокус на контенте.

• Изменения в боковом меню: Согласования, Таблицы DMN и Графы теперь находятся в разделе Лаборатория. С Рабочих пространств убран бейдж beta.

Тезаурус

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

Ключевые функции модуля:

• Проектирование систем понятий (родовидовые, партитивные, ассоциативные связи)
• Поддержка мультиязычной терминологии
• Интерактивная графическая визуализация связей
• Импорт данных из MS Excel
• Автоматическая генерация тезаурусов из онтологий
• Разметка документов терминами и отслеживание мест их использования

Подробные инструкции по работе с модулем доступны в документации.

Шаблоны структурированных документов

В систему добавлена поддержка шаблонов структурированных документов, что позволяет стандартизировать создание контента и ускорить работу пользователей. Администраторы получили доступ к новому реестру "Структурированные документы (шаблоны)" для управления версиями и настройкой прав доступа по ролям.

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

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

Добавлена возможность задавать вопросы к онтологии на естественном языке, что значительно упрощает навигацию и анализ сложных структур. Новая функция доступна непосредственно на полотне онтокарты через кнопку "Задать вопрос" на панели инструментов.

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

MCP-сервер и инструменты создания классов/свойств на онтологии

В состав платформы OSA интегрирован MCP-сервер, расширяющий возможности автоматизации работы с онтологиями. Сервер поддерживает ключевые инструменты для программного управления знаниями:

• создание новых онтологий
• создание классов и их иерархий
• создание скалярных свойств и отношений

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

Нововведения в структурированных документах

Улучшения поиска терминов

Теперь при выделении текста и нажатии Ctrl+Пробел поиск выполняется в следующем порядке:

• поиск по выделенной фразе как есть
• поиск по нормализованной фразе (единственное число, именительный падеж)
• поиск по нормализованной фразе с заменой всех ё на е

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

Вставка inline-изображения с выравниванием

Добавлена возможность создать в документе строку с изображением с любым выравниванием с помощью html:

<span class="img-line" data-halign="left|center|right" data-v-align="top|middle|bottom">
   ![](/uploads/image.png) <span>(6.1)</span>
</span> 

Новые команды в дереве документа

В виджете дерева в редакторе структурированных документов при выделении нескольких компонентов доступно две новых команды: "Объединить содержимое" и "Поместить внутрь". При выборе "Объединить содержимое" все содержимое выбранных компонентов будет добавлено к содержимому целевого компонента, а исходные компоненты будут удалены. Это удобно для объединения нескольких абзацев в один, для слияния списков и разделов. При выборе "Поместить внутрь" все выбранные компоненты будут помещены внутрь целевого компонента. Это удобно для быстрой реорганизации структуры через дерево.

Поддержка сканированных pdf

Добавлена поддержка сканированных pdf (технология OCR) при импорте в структурированные документы и при индексации аттачментов pdf для поиска. Необходимость применения OCR определяется автоматически по наличию текста в документе pdf. Если качество текста в файле pdf очень низкое, то есть возможность принудительно использовать OCR:

• параметр Форсировать OCR для pdf-файлов в диалоге импорта документов
• параметр forcePDFOCR в методе helpers.indexAttachContent(t.id, t.providerId, forcePDFOCR) (по умолчанию false)

Улучшения разметки терминами

Улучшена функция автоматической разметки документа терминами:

• добавлен индикатор текущего прогресса, позволяющий отслеживать статус обработки документа в реальном времени
• улучшены алгоритмы распознавания, что снижает количество ложных срабатываний
• реализована возможность массовой отмены кандидатов на разметку: теперь можно одним действием отвергнуть предложенные пары "термин / фрагмент текста", если они не соответствуют контексту

Также выделили интерфейс разметки терминами в отдельный виджет, реализовав принцип разделенного экрана:

• теперь на одном экране доступны как список кандидатов на разметку, так и исходный текст документа
• при клике на кандидата из списка система автоматически прокручивает документ к соответствующему фрагменту текста

Провайдер поиска для версий документов

Добавлен провайдер поиска для версий структурированных документов. Версии документов индексируются в момент создания версии и отображаются в поиске с соответствующим типом объекта и ссылкой для просмотра. Версии структурированных документов также могут быть использованы для вопросно-ответной системы. Для этого добавьте в провайдер поиска "Версии структурированных документов" (d845af39-34cf-483f-8a37-1b09c443b15c) вызов метода helpers.indexAsVector(t):

async function indexObject(context, helpers) {
  // ... существующая логика индексации
  
  // Триггер индексации векторного представления
  helpers.indexAttachContent(t,{});
  await helpers.indexObject(t);

  // ... продолжение логики

}

Для индексации созданных ранее версий добавьте в индексацию по расписанию id этого провайдера d845af39-34cf-483f-8a37-1b09c443b15c.

Прочие изменения

• исправлена работа нумерации разделов в оглавлении редактора документов
• исправлена ошибка, из-за которой не получалось перетащить сразу несколько компонентов в дереве документа
• исправлена ошибка, из-за которой дублировались запросы к БД, при просмотре документов с внешним содержимым
• исправлено поведение свойства "Показать свернутым" на внешнем содержимом с документом внутри
• панель форматирования текста автоматически скрывается, когда пользователь кликает за пределами текущего компонента
• в панели инструментов редактора структурированного документа теперь выводится непосредственно название экземпляра документа, а не значение свойства "Заголовок"
• cообщение о вставке/создании ссылки в структурированном документе перемещено в верхнюю часть экрана
• в диалог настройки ссылки в документах добавлена кнопка отмены разметки, позволяющая быстро удалить ссылку и заменить ее на текст
• в настройках редактора структурированных документов удален пункт "Свернуть компоненты"
• добавили технический отступ в нижнюю часть редактора для более комфортного набора текста: теперь самый нижний компонент можно прокрутить до середины или верхней части экрана; это позволяет писать текст в удобной визуальной зоне, а не у самого края окна браузера
• при создании нового абзаца с помощью горячих клавиш или через выпадающее меню курсор автоматически устанавливается в начало нового компонента
• добавлена опция "Размечать только первое вхождение термина" в функцию автоматической разметки документов
• теперь при сохранении новой версии документа система автоматически сохраняет список всех терминов, которые были использованы для разметки текста в данной версии
• добавлен механизм разметки текста структурированного документа терминами из выбранных тезаурусов
• в диалог разметки терминами добавлен фильтр по предметным областям
• оптимизировано потребление памяти при работе с большими структурированными документами
• в конструкторе документов для администраторов платформы реализована возможность множественного выбора компонентов с помощью клавиши Shift; выделенные элементы можно быстро добавить в окно "Компоненты для вставки"
• улучшен диалог добавления внешнего содержимого: при выборе опции "по типу компонента" теперь отображается табличный реестр всех доступных компонентов данного типа с удобной фильтрацией
• добавлено модальное окно, мешающее продолжению работы с документом в случае ошибки сохранения изменений
• в оглавлении редактора структурированного документа, после перетаскивания разделов, узлы дерева больше не раскрываются автоматически (это сохраняет текущий уровень свернутости/развернутости, который был до начала операции)
• в настройках таблицы добавлена возможность задать расстояние между строками и столбцами
• улучшения в конструкторе структурированных документов (доступен только для администраторов платформы): добавлен виджет фильтров и возможность управлять составом отображаемых колонок в реестре компонентов
• в свойствах документа добавлена настройка максимальной ширины области просмотра (в пикселях)
• улучшен механизм автоматической прокрутки к созданному компоненту
• улучшено информирование пользователей об ошибках в структурированных документах: система теперь предоставляет более понятные и детальные сообщения
• в режиме просмотра документа добавлена возможность быстрого копирования ссылки на конкретный раздел: при наведении курсора на заголовок появляется специальная иконка, ссылка копируется по клику
• для компонента "Внешнее содержимое" добавлено свойство "Показать содержимое в редакторе": при его активации становится видна компонентная модель целевого объекта, который используется во внешнем содержимом (внутренняя структура доступна только для чтения)
• упростили работу с большими документами: теперь при наведении на границу компонента появляется его имя, а клик сразу перекидывает к соответствующему заголовку

Нововведения в обычных документах

Улучшения поиска терминов

Теперь при выделении текста и нажатии Ctrl+Пробел поиск выполняется в следующем порядке:

• поиск по выделенной фразе как есть
• поиск по нормализованной фразе (единственное число, именительный падеж)
• поиск по нормализованной фразе с заменой всех ё на е

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

Прочие изменения

• исправлена ошибка встраивания дискурсов термина в документ при наличии нескольких предметных областей у источника дискурса
• в диалог настройки ссылки в документах добавлена кнопка отмены разметки, позволяющая быстро удалить ссылку и заменить ее на текст
• добавлена возможность встроить содержимое дискурсов объекта ссылки непосредственно в текст документа: управление с помощью флага "Встроить содержимое" на вкладке "Параметры" диалога настройки ссылки

Нововведения в онтокартах

Улучшения карточек создания классов и свойств

Улучшен интерфейс карточек создания классов и свойств на онтокарте:

• Логичная структура настроек - параметры теперь организованы по вкладкам "Основные" и "Оформление"
• Быстрое заполнение ключевых данных - при создании объекта можно сразу указать код, предметные области, теги и определение

Прочие изменения

• добавлена поддержка импорта ограничений кардинальности (owl:minCardinality и owl:maxCardinality) для объектных свойств при загрузке онтологий из формата OWL
• в контекстном меню инверсного свойства теперь доступны переход к его карточке и выбор свойства для просмотра объектов дискурса или правил
• в карточке онтологии добавлено поле "Предметная область", значение автоматически подставляется для всех новых классов и свойств; при создании объекта автоподстановку можно отключить или изменить

Нововведения в диаграммах

Быстрая визуализация онтокарты на полотне диаграммы

Добавлена новая функция для быстрой визуализации онтологических моделей на полотне диаграммы: при импорте классы онтологии преобразуются в узлы диаграммы, а свойства - в связи между ними. Функция предназначена для настройки внешнего вида графового представления. Можно использовать импортированную структуру как основу для дальнейшей кастомизации и оформления. Операция доступна через меню "Экспорт/Вставка → Импортировать представление онтологии". Важно отметить, что импорт является одноразовой операцией: последующие изменения в онтологии/представлении не будут автоматически синхронизироваться с диаграммой

Прочие изменения

• в сайдбар диаграммы добавлены кнопки с типами связей (коннекторов), описанных в пользовательской нотации: теперь пользователь может выбрать тип связи, который будет устанавливаться по умолчанию при создании связи путем протягивания мышкой

Нововведения в рабочих простраствах

• виджет "Карточка экземпляра" теперь поддерживает отображение нескольких экземпляров при взаимодействии с другими виджетами: если на вход виджета поступает несколько экземпляров, они автоматически организуются в компактное представление типа "аккордеон"
• при добавлении экземпляра через "древовидную" кнопку в списке классов теперь отображаются названия без префиксов
• в виджетах "Древовидное представление" и "Таксономия класса" реализована поддержка множественного родительства для узлов дерева: дочерние элементы теперь могут корректно отображаться в нескольких ветках дерева
• в виджетах "Структурированный документ" и "Бизнес объекты" появилась возможность отображать компоненты структурированных документов
• добавлен новый виджет "Фильтр": использует существующие иерархические пользовательские фильтры для отображения параметров фильтрации и взаимодействия с другими виджетами рабочего пространства

Нововведения в рабочих потоках

Добавлена поддержка массива исполнителей через output.assigneeIds в пользовательских задачах. При назначении нескольких пользователей создаются экземпляры задачи для каждого пользователя. Результаты собираются в process[taskId_results]. Обратная совместимость сохранена.

Общесистемные нововведения

Улучшение диалога с LLM

Улучшен диалог взаимодействия с LLM:

• Добавлена генерация уникальных шаринг-ссылок для каждого блока "вопрос + ответ" — доступ открыт авторизованным пользователям системы
• Для каждого вопроса теперь отображается дата и время создания
• Реализована функция "Повторить вопрос"

Представление класса в описателе поля

Добавлена поддержка параметра {"viewId": "UUID_ПРЕДСТАВЛЕНИЯ_КЛАССА"} в JSON-конфигурации описателя поля. При указании данного параметра, в форме (как при создании нового объекта, так и при drilldown-переходе по существующей записи) будет открываться представление с указанным идентификатором вместо представления по умолчанию.

Переменные окружения в обработчиках событий

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

1. Передайте одну или несколько переменных с префиксом USERCODE_ в remote-runner
2. В коде обработчика обратитесь к объекту env, поля которого содержат значения этих переменных (без префикса USERCODE_)

Пример В docker compose:

remote-runner:
    environment:
      - USERCODE_VAR1=value1
      - USERCODE_VAR2=value2

В коде обработчика:

console.info("Variable 1: ", env.VAR1);
console.info("Variable 2: ", env.VAR2);

Вывод:

Variable 1: value1
Variable 2: value2

Улучшения реестра ссылок

Расширенные возможности управления ссылками в реестре:

• Добавлена колонка "Кол-во использований", отображающая количество документов и версий, в которых применяется каждая ссылка
• Реализован иерархический фильтр, позволяющий быстро находить ссылки по их состоянию или выделять ссылки без привязанного объекта
• Добавлена возможность одновременной работы с несколькими ссылками: можно удалить или изменить состояние сразу для группы выбранных элементов

Улучшение ответа api

Изменена структура поля deleted в ответе API-метода set_data. Теперь вместо массива идентификаторов возвращается расширенная информация об удаленных объектах:

{
  "deleted": [
    {
      "id": "UUID_УДАЛЕННОГО_ОБЪЕКТА",
      "name": "НАЗВАНИЕ_УДАЛЕННОГО_ОБЪЕКТА",
      "tinh": "UUID_КЛАССА_УДАЛЕННОГО_ЭКЗЕМПЛЯРА"
    }
  ]
}

Прочие изменения

• исправлено назначение тега объекту при клике на его цветную плашку в выпадающем списке
• исправлено смещение иконки поиска на панели инструментов в стандартных реестрах платформы после асинхронной загрузки других иконок
• исправлена ошибка, возникающая при материализации вычисляемого класса, в API-методе materialization
• из панели инструментов платформы удалена кнопка "Установить предметную область по умолчанию"
• реализована визуальная маскировка чувствительных данных (паролей, ключей) в полях форм через опцию {"password": true} в JSON-конфиге свойств/описателей полей (в БД значения остаются неизменными)
• добавлен маршрут POST /api/utils/executeHandler для вызова обработчиков событий напрямую, минуя событийную модель
• теперь ссылки на рабочие пространства отображаются в разделе "Последние" бокового меню платформы
• в результатах API-метода get_form теперь возвращаются оригинальные порядковые номера закладок представления.
• оптимизированы запросы для правил, содержащих цепочки вида ...inverse(prop).count|avg|sum|min|max()
• обновлен служебный инструментарий платформы
• оптимизирован запрос set_data в случае создания нового класса
• в ответ set_data добавлен массив deleted (тип UUID[]), который содержит идентификаторы всех удаленных объектов (учитываются не только целевые экземпляры, но и удаленные каскадно по прямым или обратным ссылкам)
• добавлена возможность ручного одноразового запуска задачи планировщика из интерфейса платформы - независимо от настроенного расписания
• добавлена возможность инициировать пересчет значений вычисляемых свойств сразу для всех экземпляров указанного класса: в параметрах API-метода recalc_props нужно передать ключ "class": "CLASS_UUID" (пересчет выполняется с учетом всей иерархии наследования)
• в раздел "Настройки -> Вывод консоли пользовательского кода" добавлен лог отладочной информации при взаимодействии с LLM: это позволяет разработчикам и администраторам отслеживать запросы и ответы моделей, упрощая диагностику
• apI метод recalc_props теперь поддерживает работу с правилами, написанными на SQL
• оптимизированы рекурсивные запросы вычисления иерархии классов
• пункты сайдбара "Планировщик","Импорт из csv","Импорт из MS Excel","Импорт документов","Изменения онтологий","Вывод консоли пользовательского кода" перенесены в раздел "Инструменты"