Оформление
13 октября: подробные инструкции и повторная сверка
Эта редакция относится к NGENSIA 0.9. Обновлён именно справочный портал: эти изменения не включают функции на сервере, не выдают права и не меняют рабочие процессы.
Что изменено в документации этого релиза
| AREA | WHAT CHANGED | ARTICLES | SCREENSHOTS | WHY |
|---|---|---|---|---|
| Поиск помощи | Четыре маршрута: сделать, настроить, понять термин, исправить ошибку | Найти инструкцию, главная, словарь | Не требуется | Не нужно заранее знать название функции |
| Формы и поля | Пошаговый выбор связанной записи; создание поля и размещение на трёх разных формах; ограничения и наследование | Заполнение, поля, формы, типы | Новые: выбор заказчика, дополнительные настройки поля | Введённое название ещё не является выбранной записью; новый атрибут не появляется автоматически везде |
| Доступ | Разбор результата проверки, источников членства и различий проверки класса и конкретной записи | Проверка доступа | Новый: результат диагностики класса | Помогает разобраться в отказе без опасной выдачи лишних прав |
| Соглашения и SLA | Получатели, общая услуга, календарь с перерывом, область правил, начало и пауза, ошибки сохранения | Соглашения, календари, SLA | Новый: редактор правила SLA | Срок зависит не только от введённого числа часов |
| Процессы и согласования | Сохранение матрицы, этап или переход, условия и блокирующие проверки; исправлена трактовка отмены голосования | Жизненный цикл, правила, настройка согласований, решение | Сохранены подходящие прежние иллюстрации | Кнопка «Готово» не всегда сохраняет всю матрицу; отмена не стирает уже принятое решение |
| Ежедневная работа | Поиск пропавшей заявки, упоминания, загрузка и просмотр файлов, свои активы и связи | Списки, обсуждение, активы, связи | Новый: свой актив под обычным пользователем | Инструкция показывает реальный маршрут, а не экран администратора вместо сотрудника |
| Проекты и отчёты | Добавлен канбан проекта; уточнены снимки, расшифровка, полный CSV, CSV страницы и PDF | Проекты, отчёты | Новый: развёрнутый канбан с тремя задачами; сохранены примеры проекта и Ганта | Не перепутать данные страницы со всей выборкой |
| Автоматизация и интеграции | Подробные тестовые данные, сопоставление входящих полей, различие пропущенного поля и null, конфликт версии и отдельные права | Тестирование, входящие данные, интеграции | Сохранены существующие кадры | Пробный запуск не равен включению обмена или проверке доставки |
| API | Первый безопасный запрос в PowerShell 7; точные и приблизительные счётчики поиска | Первый запрос, постраничная выдача | Команды и примеры ответа вместо снимков секретных ключей | Пример можно повторить; приблизительный total не выдаётся за итог всего поиска |
| Эксплуатация | Разделены копия, экспорт, откат образа и восстановление данных; понятный первый разбор сбоя | Начало, копии, откат, состояние | Новый: состояние системы | Зелёная проверка базы не означает, что уже работают все внешние обработчики |
| S3-копии | Новая инструкция подключения S3 через rclone с отдельным шифрованием и проверкой | Подготовить S3 | Не снимаются конфигурации с секретами | Раньше описание начиналось с уже подготовленного подключения |
| Оргструктура и служебные настройки | Состав команды, перенос отдела, последствия архива, шаблоны комментариев и ошибки регламентов | Оргструктура, инструменты, регламенты, Groovy | Без новых кадров | Архив отдела может отключить сотрудников; шаблон комментария не отправляет сообщение сам |
| Перенос и webhook | Состав CSV-шаблона, повтор ошибочных строк, безопасная смена адреса и ограничения журналов | Шаблон, запуск, webhook, входящие данные | Используются актуальные прежние иллюстрации | Отчёт об ошибках не равен исходному файлу, выключение не отзывает уже начавшийся HTTP-запрос |
Release documentation changes
- Новые статьи: «Как найти нужную инструкцию», «Подготовить S3 для резервных копий» и этот журнал изменений.
- Расширенные статьи: рабочие формы, поля, типы, права, соглашения, календари, SLA, процессы, согласования, комментарии и файлы, активы и связи, проекты, отчёты, автоматизация, интеграции, API и эксплуатация.
- Удалённые/объединённые статьи: нет. Существующие адреса сохранены.
- Новые screenshots — 13, включая дополнение: выбор связанной записи, настройки поля, диагностика доступа, правило SLA, актив обычного сотрудника, состояние системы, развёрнутый канбан проекта, три кадра согласования, расшифровка отчёта, выбор и результат обычной связи. Все сняты с текущего интерфейса на отдельных учебных стендах; изменённые данные — только учебные.
- Исправленные неточности: отмена согласования, объём PDF/CSV, счётчики канбана и API-поиска, маршрут к своим активам, отдельные права интеграций, применение серверных настроек и состав установки с первым Superuser.
- Новые разделы внутри статей: пошаговые примеры, ожидаемый результат, причины ошибок, ограничения и связанные инструкции.
- Закрытые пробелы: канбан проекта, подготовка зашифрованного облачного назначения, навигация по задаче, конкретный выбор записи, разбор диагностики прав, подробные настройки правил SLA; дополнительно — согласование под назначенным участником, расшифровка показателя отчёта и общий выбор связи с сохранённым результатом.
Дополнение: три сценария показаны от действия до результата
| AREA | WHAT CHANGED | ARTICLES | SCREENSHOTS | WHY |
|---|---|---|---|---|
| Согласования | Пройдено положительное решение обычным назначенным пользователем; объяснено различие закрытого согласования и незавершённой заявки | Принять решение | 3 новых: карточка, подтверждение, сохранённое решение | Новичок видит, что проверить до нажатия и как убедиться в результате |
| Отчёты | Добавлен пример «Скоро срок»: показатель → одна строка → карточка заявки; онлайн-режим отделён от фоновых снимков | Читать отчёты | 1 новый: показатель и его расшифровка | Не искать отсутствующую кнопку снимка в онлайн-статистике и не путать сводку с выбранным списком |
| Связи / CMDB | Показаны поиск, выбор, сохранение и переход к связанной записи на двух заявках; указана граница применимости к активам | Связи между объектами | 2 новых: выбор и сохранённая связь | Введённый текст ещё не создаёт связь, а связь заявок не разрешает автоматически связать любой ИТ-актив |
Release documentation changes — дополнение: новых отдельных статей и удалений нет; расширены три инструкции, добавлены шесть screenshots и три пошаговых примера с проверкой результата. Исправлено смешение онлайн-отчёта и представления со снимком. Все три ранее отложенных визуальных сценария закрыты; это не заменяет приёмку остальных ролей, процессов и инфраструктуры.
Что означает проверка
Статьи повторно сопоставлены с текущими экранами, маршрутами и реализацией. Публичный API проверен на соответствие справочника 56 операциям и 44 путям. Новые кадры проверены визуально; снимок формы, открытой без сохранения, не называется успешно выполненной настройкой.
Это не обещание, что каждый сценарий исполнен под каждой ролью. Не выполнялись ради иллюстраций разрушительные операции, выдача дополнительных прав, внешняя отправка почты и webhook. Расписание копий, облачный провайдер, восстановление после потери сервера и весь установочный комплект требуют отдельной приёмки на целевой инфраструктуре. Их ограничения оставлены в инструкциях.
Применимость серверного комплекта · Версия документации · Карта руководства