Данное описание ещё в разработке - будет дополнено
Формат файла импорта
реестра процессов
Файл импорта должен быть в формате Excel (.xlsx) и содержать до 4 листов.
Лист 1: «Пользовательские поля»
Определяет пользовательские поля, которые можно привязывать к процессам.
Примечание: Для обратной совместимости поддерживается также название листа «Параметры».

ㅤ
Допустимые типы параметров

ㅤ
Поведение при импорте
-
Если пользовательское поле с таким названием уже существует — пропускается (не будет создано, чтобы не было дубля)
-
Новые поля создаются с указанными настройками
Лист 2: «Процессы»
Определяет иерархию процессов.

ㅤ
Поведение при импорте
-
Если процесс с таким названием уже существует — пропускается (не будет создан, чтобы не было дубля).
-
Родитель может быть указан из файла импорта или из существующих процессов.
-
Если родитель указан, но не найден ни в файле, ни в системе — ошибка валидации, файл не будет импортирован.
-
Процессы импортируются в порядке иерархии (сначала родители, потом дети).
Пример

ㅤ
Лист 3: «Параметры процессов»
Связывает параметры с процессами и задаёт их значения.

ㅤ
Формат значений по типам

ㅤ
Поведение при импорте
-
Параметр добавляется на «экран» процесса
-
Если значение указано — сохраняется
-
Если значение пустое — параметр просто привязывается к процессу без значения
-
Одна строка = одна связь процесс ↔ параметр
Пример

ㅤ
Лист 4: «Ссылки»
Внешние ссылки, прикреплённые к процессам.

ㅤ
Поведение при импорте
-
Если ссылка с таким URL уже есть у процесса — пропускается
-
Новые ссылки добавляются
Пример

ㅤ
Порядок обработки при импорте
-
Параметры — создаются новые, существующие пропускаются
-
Процессы — создаются новые с учётом иерархии, существующие пропускаются
-
Параметры процессов — привязываются к процессам, значения сохраняются
-
Ссылки — добавляются новые, дубликаты по URL пропускаются
Валидация перед импортом
Система проверяет файл перед импортом и сообщит об ошибках:
-
Неизвестный тип параметра
-
Дублирование названий в файле
-
Несуществующий родительский процесс (не найден ни в файле, ни в системе)
-
Несуществующий процесс или параметр (в листе «Параметры процессов»)
-
Владелец является группой, а не должностью
-
Циклические зависимости процессов
-
Превышение длины названия (максимум 350 символов)
Рекомендации
-
Экспортируйте существующий реестр как образец формата
-
Названия регистронезависимы —
Процесс Аипроцесс асчитаются одинаковыми -
Для метрик обязательно укажите направление метрики на листе «Пользовательские поля»
-
Пустые листы допустимы — импортируется только то, что заполнено