Изменить модель: черновик, проверки, версии

Доступно: аналитикам и администраторам

Модель меняют через черновик: ваши правки никому не видны, пока вы их не сохраните. Сохранение проверяет черновик на хранилище и разворачивает новую версию модели.

Режим редактирования

В разделе «Модель» нажмите переключатель «Изменить» над деревом (подсказка «Перейти к редактированию модели»). Его видят аналитики и администраторы. У остальных карточка объекта подписана «только чтение — модель редактируют аналитики и администраторы».

В режиме редактирования:

у каждой группы в дереве есть «+» — «Добавить: таблица», «Добавить: метрика», «Добавить: измерение»;
поля карточки объекта можно менять прямо на месте;
внизу — панель с кнопками «Импорт», «Экспорт», «Отменить» и «Сохранить».

Черновик

Каждая правка сразу попадает в ваш личный черновик. В дереве изменённые объекты помечены: «новый», «изменён» или «удалён». Поле, которое отличается от опубликованной версии, тоже отмечено.

«Вернуть» или «Убрать это изменение из черновика» отменяет правку одного объекта.
«Отменить» → «Отменить черновик?» отменяет все правки. Сохранённая модель не пострадает.

Объект, который уже правит коллега, помечен «В черновике …» с его именем. Такой объект недоступен для правки, пока коллега не сохранит или не отменит свой черновик.

Сохранить и развернуть

Нажмите «Сохранить». Откроется окно «Сохранить черновик» со списком «Изменения».
Нажмите «Отправить». Черновик проходит три этапа:
- «Форма» — каждый объект записан правильно;
- «Компиляция» — модель собирается целиком, ссылки между объектами верны;
- «Проверки» — каждый изменённый объект выполняется на хранилище коротким запросом.
Если всё прошло, вы увидите «Развёрнута версия N». С этого момента все ответы считаются по новой версии.

Если этап не пройден, ничего не сохраняется. В списке «Не прошли» — объекты и причины, например «хранилище отклонило это» с «выполненный SQL». Поправьте черновик и нажмите «Отправить ещё раз».

Подключение

В окне сохранения есть поле «Подключение». Обычно там выбрано подключение по умолчанию. Если выбрать другое из существующих подключений организации, вся модель будет проверена на нём, и после сохранения оно станет подключением по умолчанию. Так модель и хранилище переезжают вместе.

Создавать, менять и удалять сами подключения может только администратор: Хранилища.

Версии

Каждое успешное сохранение — новая развёрнутая версия. Версию видно в трёх местах:

в сообщении «Развёрнута версия N» после сохранения;
в отметке на старых ответах в чате, если модель с тех пор изменилась (подробнее);
в BI-интеграции, закреплённой на версии: «Закреплена на vN» (BI-интеграции).

Истории версий и отката в интерфейсе нет. Чтобы вернуться к прежнему состоянию, держите модель в git как YAML-проект и разверните предыдущий экспорт: YAML-проект.