Данные заводятся загрузкой, а не руками: тринадцать типов импорта и обмен по API
Реестр, который заполняют вручную, устаревает быстрее, чем заполняется. Оргструктура, сотрудники, объекты инфраструктуры, процессы и поставщики загружаются шаблонами Excel через промежуточные таблицы, каждый прогон имеет состояние и журнал, а обмен с соседними системами идёт по HTTP и через почтовый ящик службы.
Импорт Excel по тринадцати типам
Внедрение начинается не с ввода двух тысяч объектов руками. Загрузка объявлена отдельно для каждого типа данных, а шаблоны поставляются вместе с продуктом — состав колонок известен заранее, и подготовка файла не превращается в переписку «а что писать в седьмой столбец».
Что вы заведёте загрузкой на внедрении
Отметьте типы данных, которые нужно перенести, — получите состав работ по загрузке.
| Загружать | Тип загрузки | Что попадает в систему |
|---|---|---|
| Оргструктура | Подразделения с идентификаторами, полными и краткими наименованиями и вышестоящим подразделением | |
| Сотрудники | Фамилия, имя, отчество, должность, признак руководителя подразделения, электронная почта и учётная запись | |
| Объекты | Конфигурационные единицы с классом, типом, видом, уровнем, статусом и минимальным временем простоя | |
| IPv4 | Диапазоны адресов объектов инфраструктуры | |
| IPv6 | Диапазоны адресов объектов инфраструктуры | |
| Поставщики | Наименования, ИНН, код типа, признаки оператора связи, облачного поставщика и ЦОД, даты договора | |
| Адреса ЦОД | Код страны по ОКСМ, код по ФИАС, ОКАТО, индекс, улица, дом, корпус, литера, офис | |
| Процессы | Наименование, уровень критичности, минимальное время простоя, ответственные, технологический процесс и участок | |
| Сквозные процессы | Процессы, проходящие через несколько подразделений | |
| Иерархия процессов | Связи «процесс — зависящий процесс», из которых строится дерево | |
| Процессы (критичные) | Критичные процессы отдельным типом загрузки | |
| Сбои | Ранее учтённые события с датами регистрации, выявления и окончания, ответственными и причинами | |
| Проблемы | Ранее учтённые проблемы надёжности с мероприятиями и ответственными |
0 из 0 типов загрузки
Отметьте хотя бы один тип — он попадёт в состав работ по переносу данных.
Шаблоны, которые поставляются вместе с продуктом
- Оргструктура и сотрудникиДва листа: подразделения и работники с должностями, почтой и учётной записью
- Поставщики и адреса ЦОДДва листа: карточки поставщиков и адреса площадок по классификаторам
- Объекты инфраструктурыТри листа: объекты, диапазоны IPv4 и диапазоны IPv6
- ПроцессыКритичность, минимальный простой, ответственные, связи с поставщиком и объектами
- События и мероприятияДаты регистрации, выявления и окончания, ответственные, сроки и причины
Staging и процедура слияния
Загрузка не пишет в рабочий реестр напрямую. Файл сначала попадает в промежуточные таблицы, и только затем процедура слияния переносит данные в рабочую схему. Это то, что отличает загрузку от «вставили и надеемся».
Схема прокручивается вбок — она шире экрана.
Пока данные лежат в промежуточных таблицах, ошибочная строка ещё не попала в рабочий реестр. Прогон можно отменить, не разбирая последствия в живых данных.
Колонка привязана к полю буквой столбца
Соответствие «столбец таблицы — поле реестра» задано конфигурацией с указанием типа поля. Поэтому файл, у которого сдвинули столбец, не заводит данные не туда: он отклоняется на разборе, а не обнаруживается через месяц в отчёте.
Состояние прогона и журнал импорта
У каждой загрузки есть собственное состояние и запись в журнале. Вопрос «загрузилось ли» имеет ответ в системе — вместе с тем, кто и когда запускал.
| Состояние | Что означает |
|---|---|
| Не запущен | Загрузка настроена, но ещё не выполнялась |
| Загрузка | Файл читается и раскладывается по промежуточным таблицам |
| Обработка | Идёт перенос данных в рабочий реестр |
| Завершено | Прогон закончился, данные в реестре |
| Ошибка | Прогон остановлен; причину можно открыть и посмотреть |
| Отменено | Прогон прерван до завершения |
Состояние ошибки открывается для просмотра — разбор идёт по строке файла, а не по логам приложения. Загрузка объявлена самостоятельным охраняемым действием: право её выполнять выдаётся отдельно от права править карточку. Права на действие.
Типизированные ограничения и проверки
Проверки заданы по типу поля, а не одной общей проверкой «не пусто». Строка, дата и число проверяются каждая по-своему — это и означает, что в реестр не попадёт дата в виде текста или число с лишним разделителем.
Строковые
Проверка строковых значений: длина и допустимость содержимого.
Числовые
Проверка числовых полей — например, минимального времени простоя в минутах.
Даты
Проверка дат: ввод в эксплуатацию, открытие и закрытие договора, сроки мероприятий.
Общие
Базовые ограничения на данные, применяемые ко всем типам полей.
Входящий REST: приём заявок из внешних систем
Смежная система получает обращения по позиции каталога активов запросом HTTP с постраничной выборкой. Ей не нужен доступ к базе службы поддержки и не нужна выгрузка по расписанию — она забирает ровно то, что относится к её объекту.
| Параметр | Правило |
|---|---|
| Идентификатор позиции каталога | Передаётся либо он, либо код позиции — ровно один из двух |
| Код позиции каталога | Альтернатива идентификатору |
| Начальная строка выборки | Не меньше единицы; передаётся вместе с конечной |
| Конечная строка выборки | Не меньше единицы и не раньше начальной |
| Формат ответа | JSON |
| Проверка вызова | Токен в заголовке запроса |
Запрос с половиной границ выборки или с пустой позицией отклоняется с указанием причины. Вызывающая сторона получает понятную ошибку, а не пустой список, который потом трактуют как «обращений не было».
Исходящий REST: обмен с каталогом ИТ-активов
Позиции каталога ИТ-активов запрашиваются у внешней системы постранично, с передачей условия отбора. Конфигурационные единицы не приходится вести в двух местах: продукт умеет обращаться к существующему у вас каталогу.
Постраничный запрос
Запрос передаёт границы выборки и условие отбора. Большой каталог переносится порциями, а не одним обращением, которое не дождётся ответа.
Адрес задаётся конфигурацией
Базовый адрес внешнего сервиса и параметры подключения задаются при развёртывании в вашем контуре — в коде продукта их нет.
Техническая документация — по запросу после заключения соглашения о конфиденциальности
Описание маршрутов интеграционного API, словарь данных, схема размещения и руководство администратора по безопасности передаются по запросу после подписания соглашения о конфиденциальности. На публичной странице приводится состав возможностей и параметры обмена — этого достаточно, чтобы спланировать интеграцию.
Приём обращений из почтового ящика
Почтовый ящик службы опрашивается раз в минуту. Каждое непрочитанное письмо превращается в обращение и помечается прочитанным — второй раз одно и то же письмо в реестр не попадёт, а забытых писем в ящике не остаётся.
Ящик как канал приёма
Дежурный переносит письма в систему руками. Пропущенное письмо обнаруживается, когда пользователь пишет второй раз — уже с претензией.
Ящик как источник обращений
Письмо становится обращением автоматически и попадает в общий маршрут: статус, срок, исполнитель и журнал переходов — как у любого другого обращения.
Подключение к почтовому серверу настраивается при развёртывании в вашем контуре: адрес ящика и параметры соединения задаются конфигурацией.
Загрузка курсов Банка России
Курсы иностранных валют загружаются из ежедневного публикуемого набора данных Банка России по настраиваемому расписанию. Расписание задаётся теми же четырьмя режимами, что и прочие фоновые задания: «Никогда», «Ежедневно», «Раз в неделю», «Раз в месяц».
Адрес этого источника задан в поставке; адреса всех остальных смежных систем задаются конфигурацией вашего контура.
Что настраивается под вашу организацию
- Состав типов загрузки, которые используются на внедрении, и соответствие колонок вашим выгрузкам.
- Адрес и параметры подключения к почтовому ящику службы.
- Адрес каталога ИТ-активов и параметры проверки вызовов интеграционного API.
- Расписание фоновых заданий по четырём готовым режимам.
Что это даёт ИТ-директору
- Перенос данных предсказуем. Тринадцать типов загрузки и пять шаблонов Excel в поставке: объём работ по миграции считается до старта проекта, а не по ходу.
- Промежуточные таблицы защищают рабочий реестр. Ошибочная строка отклоняется до слияния, прогон отменяется целиком.
- Обмен идёт в обе стороны. Обращения отдаются наружу запросом, каталог ИТ-активов забирается извне постранично.
- Наружу продукт ходит только туда, куда разрешено конфигурацией. Адреса смежных систем задаются при развёртывании в вашем контуре.
- Загрузка — охраняемое действие. Право запускать импорт выдаётся отдельно и попадает в общий пересмотр доступов.
Что именно заводится в реестры · Требования к контуру · Права и аудит
Проверить вашу выгрузку на шаблоне загрузки
Пришлите обезличенный фрагмент вашей выгрузки объектов, процессов или оргструктуры — сопоставим его с шаблоном загрузки и покажем прогон целиком: разбор колонок, промежуточные таблицы, состояние прогона и результат в реестре.