OSA Документация

🚀 Описание релиза 3.1.0 ​

Наша команда сильно постаралась упростить вашу работу с данными и документами, расширили функционал API и даже добавили ИИ-инструменты.

🤖 ИИ-ассистент + Ваши документы ​

Теперь вы можете задавать вопросы на естественном языке и получать точные ответы, основанные на содержимом объектов (например, документов) в вашей платформе.

Что умеет ИИ-чат:

  • Вести диалог в режиме чата
  • Показывать ссылки на источники (документы, использованные для формирования ответа)
  • Копировать ответы в форматах Markdown и HTML
  • Ограничивать контекст выбранными объектами

💡 Для активации требуется настройка OpenAI-совместимой LLM (не поставляется в составе OSA), службы models, OpenSearch и провайдеров поиска.

Доступ — через кнопку в тулбаре.

📄 Структурированные документы: новые возможности ​

Панель связей ​

В редакторе и просмотре — панель, показывающая:

  • Источники: документы, откуда взято внешнее содержимое
  • Цитирующие: кто ссылается на текущий документ
  • Глоссарий: термины, использованные в тексте

Режим графа ​

Визуализируйте связи между документами:

  • Отображение компонентов-посредников
  • Индекс цитируемости (размер узла = популярность)
  • Возможность «раскрывать» связи последовательно

Улучшенный редактор ​

  • Горячие клавиши: Ctrl+B (жирный), Ctrl+I (курсив), Ctrl+K (ссылка)
  • Панель форматирования при выделении текста
  • Поиск и замена с поддержкой многострочного ввода, счётчиком совпадений и заменой всех
  • Разметка терминами — выделяйте термины из указанного класса прямо в тексте
  • Выравнивание текста: по левому/правому краю, по центру, по ширине
  • Шаблоны расположения панелей: оглавление слева/справа
  • Подсветка активного компонента в превью при редактировании
  • Настройка и вставка графиков в документ
  • Изменение структуры документа из оглавления перетаскиванием

Публикации и метаданные ​

  • При публикации можно сохранять расширенные метаданные: автор, теги, дата актуальности и др.
  • При вставке внешнего содержимого — выбор конкретной публикации: последней, по состоянию или по ID.

📑 Обычные документы: новые возможности ​

Поддержка множественных публикаций ​

Теперь один документ может иметь несколько публикаций, каждая со своим состоянием («Черновик», «Актуальная» и т.д.).

Гибкие ссылки:

  • .../doc/{id} → последняя публикация
  • .../doc/{id}/{pubId} → конкретная публикация
  • .../doc/{id}/{state} → последняя в указанном состоянии

Карточка публикации настраивается через представление класса.

Улучшенный редактор ​

  • Горячие клавиши: Ctrl+B (жирный), Ctrl+I (курсив), Ctrl+K (ссылка)
  • Панель форматирования при выделении текста
  • Настройка и вставка графиков в документ
  • Вставка динамических представлений онтологий в документ

📥 Умный импорт из CSV ​

Импортируйте данные проще:

  • Импорт в существующую модель — загружайте экземпляры в уже созданные классы.
  • Импорт новой модели — автоматически создаёт онтологию (классы, свойства, связи) на основе структуры CSV и наполняет её данными.

CSV-файл может описывать:

  • Структуру класса и его экземпляры (колонки → свойства, строки → объекты)
  • Связи между экземплярами (строки → связи)

Настройка: Лаборатория -> Импорт из CSV.

⚙️ Гибкие настройки бизнес-объектов и объектный API ​

Настройки объектов ​

Создавайте кастомные представления объектов: выбирайте нужные свойства, задавайте псевдонимы и используйте эти настройки в разных сценариях:

  • Работа с данными через удобный API. Оперируйте не "техническими" сущностями, а понятными бизнес-сущностями ("объектами" и их "атрибутами").
  • Индексация и быстрый поиск (в том числе полнотекстовый) по объектам с использованием OpenSearch.
  • Копирование сложных структур данных, состоящих из множества связанных экземпляров.
  • Перенос структур между серверами (например, из тестовой среды в продакшен).

Настройка: Настройки -> Настройки объектов.

Объектный API ​

Для каждого объекта с настройками автоматически генерируется REST API:

  • POST .../object/get/{object_alias}/{id} — получить объект по ID
  • POST .../object/get/{object_alias} — получить коллекцию объектов с фильтрацией и пагинацией
  • POST .../object/create/{object_alias} — создать объект и вложенные сущности
  • POST .../object/update/{object_alias} — обновить объект (только собственные свойства)
  • POST .../object/delete — удалить объекты по списку ID
  • POST .../object/copy — клонирует объект по заданной модели настроек, возвращает ID нового экземпляра.
  • POST .../object/export — возвращает set_data-запрос для воссоздания объекта (без сессии).
  • POST .../swagger.json — OpenAPI-спецификация всех настроенных объектов

Также доступен графический интерфейс Swagger по маршруту /object-api-docs (требуется настройка reverse proxy).

🔍 Быстрый поиск в таблицах рабочих пространств ​

Теперь таблицы поддерживают полнотекстовый поиск через OpenSearch:

  1. Отметьте описание настроек бизнеса-объекта как «Для индексации».
  2. Настройте индекс в OpenSearch и укажите его в INSTANCE_SEARCH_INDEX_NAME.
  3. Запустите планировщик индексации.
  4. Включите «Настройки быстрого поиска» в табличном виджете.

🧩 Рабочие пространства: больше контроля и гибкости ​

Улучшенные таблицы ​

  • Мультивыбор строк при фильтрации (in_all, in_all_only)
  • Форматирование ячеек для конкретных колонок
  • Фильтрация по «Пусто/Не пусто»
  • Быстрый поиск через OpenSearch
  • Переопределение ячеек через шаблоны
  • Фильтрация по тегам в иерархических представлениях

Упрощённый режим ​

Скрывает элементы управления — идеален для презентаций или публичных дашбордов. Стили настраиваются через глобальный CSS-объект.

Виджеты и взаимодействия ​

  • Управляющий виджет документа: клик → фильтрация других виджетов или открытие карточки компонента
  • Визуализация связей между виджетами (кнопка в меню РП)
  • Вложенные таблицы по обратным свойствам
  • Кнопка редактирования документа прямо в виджете «Бизнес-объекты»
  • Новый виджет «Сводная таблица»
  • Виджет «График» улучшены настройки

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

  • Поиск по подсказкам и всем вкладкам
  • Группировка параметров
  • Фильтрация и сортировка в выпадающих списках (через additional_props и sort_prop)

🔍 Факт-эксплорер: глубже и чище ​

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

🗺 Онтокарты ​

Навигатор онтологии ​

Дерево классов с фильтрацией по ветке. Администраторы могут добавлять подклассы.

Переработанная вкладка «Замысел» ​

Теперь включает:

  • Абстракт и проблему (текст)
  • Вопросы компетенции (с указанием способа ответа: онтология, семантический поиск, документ)
  • Заинтересованные стороны

Рабочее пространство онтологии ​

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

📃 Дискурсы объектов ​

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

🌐 Общесистемные улучшения ​

Параметры табличных полей ​

Новые опции в JSON-описателях:

json
{
  "saveOnEnter": true,
  "showOverflowTooltip": true,
  "enableCellWrap": true,
  "maxCellLines": 3,
  "denseGrid": false
}

Уведомления из кода ​

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

js
notify({
  users: ["uuid1", "uuid2"],
  type: "info",
  message: "Задача завершена!",
  timeout: 5000,
});

Новые функции в вычисляемых свойствах ​

  • Агрегатные функции: max, min, avg, sum, count
  • Конкатенация строк с произвольным разделителем: sum
  • Проверка существования элемента в коллекции с учетом иерархии классов: includes, notIncludes

Подсказки под иконкой ​

Подсказки к полям можно скрыть и показывать по клику на иконку «ℹ️» (hintButton в настройках).

Прочие улучшения ​

  • Сохранение положения сайдбара
  • Регулярные выражения для строковых полей
  • Ограничения min/max для числовых свойств и дат
  • Поиск по ID в выпадающих списках
  • Копирование UUID роли, ссылок на правила
  • Улучшенная работа с тегами в реестрах
  • Оптимизация производительности (get_data, индексация, рендеринг)
  • Улучшена работа с пользовательским меню: создание объектов прямо в меню, использование эмодзи в качестве иконок

🛠 Исправления ​

В релизе устранено более 50 ошибок, включая:

  • Проблемы с открытием документов и публикаций
  • Ошибки индексации в OpenSearch
  • Некорректную нумерацию, выравнивание, отображение превью в структурированных документах
  • Проблемы с курсором, пагинацией, цветокодированием в рабочих пространствах
  • Ошибки в сравнении версий и работе с компоновщиками

Подробная документация — в разделе «Справка».

Подробная история изменений доступна по cсылке.