УстановщикBETA

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

Включение Установщика

По умолчанию визард отключен, вкладка Установщик в пространстве не отображается.

Чтобы включить визард:

1. Откройте файл infomaximum.subsystem.workspaces.json.
2. Приведите файл к следующему виду:

   {
       "performance_employee": false,
       "is_wizard_available": true
   }
   

3. Сохраните изменения и перезапустите систему.

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

Права доступа

Доступ ко вкладке Установщик зависит от прав пользователя:

• Настраивать визард могут пользователи с привилегией Пространство с операцией W или с локальным доступом на изменение пространства
• Заполнять визард при установке пакета могут пользователи с привилегией Пространство с операцией C или W, а также с локальным доступом на изменение пространства
• Если у пользователя есть только право на чтение пространства, вкладка Установщик не отображается

Подробнее о привилегиях на странице Роли доступа.

Вкладка «Установщик»

Во вкладке доступны два типа шагов.

Настройка переменных — создается автоматически, если в модели данных есть хотя бы одна переменная с переключателем Настраивается в визарде:

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

Загрузка таблицы — добавляется вручную автором пакета. При создании шага нужно указать:

• Название шага — отобразится у пользователя в визарде
• Описание — поясняет, какие колонки обязательны или какие данные должен содержать загружаемый файл
• Заменяемую таблицу — таблицу в модели данных, куда будут загружены данные пользователя

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

Работа с визардом

Настройка визарда автором пакета

Автор пакета работает с визардом во вкладке Установщик в пространстве:

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

Пример настройки визарда

Подготовим пакет «Анализ обращений клиентов».

1. Перейдем во вкладку Установщик и нажмем + Шаг с загрузкой таблицы.
2. Добавим шаг Загрузка таблицы обращений (cases) и укажем в описании обязательные поля: case_id, customer_id, open_date, close_date.
3. Добавим шаг Загрузка таблицы клиентов (customers). Нажмем + Шаг с загрузкой таблицы и заполним необходимые поля.
4. Перейдем во вкладку Модель данных и нажмем кнопку Переменные.
5. Создадим переменную sla_days типа Целое число, укажем значение по умолчанию, активируем переключатель Настраивается в визарде и зададим заголовок SLA (срок обработки в днях).
6. Вернемся во вкладку Установщик. В настройках визарда появился шаг Настройка переменных.
7. Экспортируем пространство как пакет — подробнее на странице Действия с пространствами.

Установка пакета пользователем

Визард автоматически открывается и проводит пользователя по шагам в следующих случаях:

• При установке пакета в новое или существующее пространство
• При обновлении пакета
• При дублировании пространства с пакетами

Пример установки пакета

Установим пакет «Анализ обращений клиентов» в пространство:

1. Добавим пакет в существующее пространство — это запустит визард установки.
2. Загрузим таблицу обращений клиентов, перетащив файл .csv в область для загрузки.
3. Убедимся, что в ней присутствуют обязательные колонки: case_id, customer_id, open_date, close_date.
4. Загрузим таблицу customers, перетащив файл .csv в область для загрузки.
5. Настроим переменную — введем значение 5 в поле SLA (срок обработки в днях).
6. Завершим установку, нажав Завершить.

Глобальные переменные

Переменные пространства можно использовать в разных пакетах и объектах модели данных. Значения таких переменных задаются один раз и хранятся централизованно — не нужно дублировать их в каждом пакете. Подробнее на странице Глобальные переменные.

Особенности работы

Работа с глобальными переменными

Если переменная с таким же именем и типом уже существует в пространстве, система использует ее. Если имя совпадает, но тип отличается — установка прервется с ошибкой.

В переменные нельзя вводить вычисляемые выражения или формулы — только готовые значения. Например, для переменной типа Дата и время нельзя указать формулу вроде toDateTime, нужно задать конкретное значение: 2025-09-22 08:00:00. Это правило распространяется на все типы данных.

Глобальные переменные нельзя редактировать или удалять, пока импортированный пакет, которому они принадлежат, не распакован. Если оставить поле Текущее значение или Значение по умолчанию пустым, система сохранит его как null.

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

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

Работа с таблицами

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

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

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

Если сервер перезапустился до завершения установки, пакет появится в пространстве, но работать корректно не будет — удалите его и установите заново. Если обновить страницу во время прохождения визарда, настройка начнется сначала.

Ограничения

• Шаги можно выполнить только в том порядке, который задал автор пакета
• Окно установки визарда привязано к идентификатору пользователя, который его открыл. Если один пользователь уже устанавливает пакет, другой открыть его не сможет
• Если пакет с визардом уже установлен и визард открыт или пройден, у другого пользователя окно с визардом не откроется, даже если он добавит такой же пакет в то же пространство через Маркетплейс