В этом разделе мы рассмотрим загрузку в Итилиум данных из MS SCOM, MS SCCM, Active Directory, а также загрузку файлов в формате XML и MS Excel. Расскажем, как можно получать и передавать данные при помощи web-сервиса, приведем пример интеграции с внешним порталом с использованием http-сервиса.
Загрузка из MS SCOM
Система «Итилиум» позволяет регистрировать события из внешних источников. В качестве внешнего источника может выступать, например, программная система MS SCOM.
Для подключения возможности регистрации событий, созданных в MS SCOM, необходимо выполнить следующие действия.
Шаг 1. В справочник «Задания» (ссылка «Задания» панели навигации раздела «Администрирование и настройки») добавить элемент «Загрузка SCOM», в котором будет указана встроенная обработка «Загрузка данных из SCOM» и заполнены соответствующие параметры: «адрес сервера», «логин», «пароль» и др. Дополнительно можно указать конфигурационную единицу, от имени которой будут формироваться события.
Создание нового задания, использование встроенной обработки — загрузка данных из SCOM
Шаг 2. В обработку «Регламентные и фоновые задания» (ссылка «Регламентные и фоновые задания» панели навигации раздела «Администрирование и настройки») добавить ранее созданное задание «Загрузка из SCOM» и задать расписание запуска обработки синхронизации.
При автоматической регистрации в документе заполняются поля «Дата», «Категория», «Описание», «Клиент», «Инициатор», «Состояние» и «Дополнительные поля».
Система «Итилиум» позволяет отслеживать состояния документа «События» и документы «Alert» программного обеспечения MS SCOM. Для синхронизации используется поле «Код SCOM» справочника «Состояния событий» (ссылка «Состояния событий» панели навигации раздела «Управление событиями»).
Загрузку из MS SCOM также можно выполнить единовременно (не осуществляя ее в постоянном режиме по определенному расписанию). В форме «Загрузка данных из SCOM» (раздел «Администрирование и настройки», ссылка панели навигации «Администрирование», ссылка «Импорт данных в Итилиум из внешних систем») необходимо указать сервер БД, логин, пароль пользователя и параметры загрузки, после чего по нажатию кнопки «Подключиться» в Итилиум будут выгружены данные из MS SCOM.
Таблица соответствия кодов SCOM
Код МОМ
Статус
Описание
0
New
Признак нового события
85
Acknowledged
Событие было принято и определено, но еще не было разрешено
170
Level 1: Assigned to help desk or local support
Событие было передано на help desk или в службу поддержки
180
Level 2: Assigned to subject matter expert
Событие было передано эксперту
190
Level 3: Requires scheduled maintenance
Событие отложено
200
Level 4: Assigned to external group or vendor
Информация о том, что событие было передано внешней группе или производителю
255
Resolved
Событие закрыто
Обработка для единовременной загрузки из системы MS SCOM
Загрузка из MS SCCM
В справочник «Конфигурационная база данных» существует возможность загрузки информации из системы аудита MS SCCM.
Загрузка из MS SCCM выполняется в два этапа:
Шаг 1. В форме «Загрузка данных из MS SCCM» (раздел «Администрирование и настройки», ссылка панели навигации «Администрирование», ссылка «Импорт данных в Итилиум из внешних систем») необходимо указать сервер БД, логин, пароль пользователя и параметры загрузки (клиент, объект CMDB, тип связи с КЕ), определить, требуется ли синхронизация данных с ранее загруженными КЕ (для сравнения загружаемых с КЕ с уже существующими в системе только по наименованию и классификатору), и установить флаг «Синхронизировать с ранее загруженными КЕ». После чего нажать кнопку «Далее».
Шаг 1 загрузки данных из MS SCCM
Шаг 2. Выбор нужных параметров загрузки объекта CMDB.
Шаг 2 загрузки данных из MS SCCM
Загрузка из Active Directory
Возможности системы Итилиум позволяют объединить список пользователей Active Directory (если используется) и приложения. Для этого предназначена обработка «Загрузка из Active Directory» (раздел «Администрирование и настройки», ссылка панели навигации «Администрирование, ссылка «Импорт данных в Итилиум из внешних систем»).
Загрузка данных из Active Directory по протоколу LDAP реализована только для операционной системы Ubuntu версии 22.
Обработка выполнена в виде «мастера» и включает в себя следующие шаги.
Шаг 1. В начале работы необходимо указать такие параметры, как наименование, имя сервера, логин и пароль.
Шаг 1. Ввод данных для подключения к AD
Шаг 2. Далее вы можете выбрать OU. OU — это клиент, из которого будет происходить загрузка пользователей. На этом шаге можно выбрать несколько клиентов, из которых будет происходить загрузка пользователей. Для этого необходимо выбрать объект и нажать кнопку «Добавить в список».
Шаг 2. Выбор OU
Шаг 3. На следующем шаге вы можете указать дополнительные отборы. Для этого в правой табличной части, нужно выбрать свойство нажать кнопку «Добавить в отбор», а затем кнопку «Применить отбор».
Шаг 3. Настройка отборов для загрузки данных
Шаг 4. На следующем шаге происходит настройка типа загружаемых данных и параметров загрузки в систему. Вы можете выбрать настойку для загрузки клиентов, потребителей, сотрудников, пользователей и физических лиц.
Шаг 4. Настройка загружаемых данных
Шаг 5. На следующем шаге определяется, в какие из справочников будет производиться загрузка: «Клиенты», «Физические лица», «Потребители», «Сотрудники», «Пользователи».
Вкладка «Клиенты» доступна, если в дереве выбрать клиента, другие вкладки будут доступны при выборе загружаемого пользователя. На каждой из таких вкладок необходимо установить соответствие полей в Итилиум и полей в AD либо указать абсолютное значение.
На данном шаге также доступен режим «Предпросмотра изменений» (на рисунке ниже отмечен цифрой 1).
Если необходимо сохранить регламентное задание для загрузки данных из AD, необходимо нажать на кнопку «Записать», а затем по кнопке «Создать регламентное задание» можно настроить регламентное задание (на рисунке ниже отмечено цифрой 2).
По нажатию кнопки «Загрузить» будет осуществлена загрузка данных из AD (на рисунке ниже отмечено цифрой 3).
Шаг 5. Настройка соответствия полей системы Итилиум и AD
Загрузка файлов в формате XML
Существует возможность загрузки файлов в формате XML, сформированных системой аудита Everest, в справочник «Конфигурационная база данных». Для этого предназначена форма «Загрузить данные из систем аудита» (раздел «Администрирование и настройки», ссылка панели навигации «Администрирование», ссылка «Импорт данных в Итилиум из внешних систем»).
При загрузке данных из системы Everest нужно указать следующие параметры:
«Клиент»;
«Иерархия» — вид связи между загружаемыми объектами, выбирается из справочника «Связи объектов»;
«Название объекта» — объект, для которого будет выполняться загрузка;
«Список файлов (один или несколько)» — путь(и) к XML файлу, из которого будет выполняться загрузка (при этом подразумевается, что в одном XLM файле содержится выгрузка только по одному компьютеру, то есть, если потребуется загрузка по нескольким компьютерам, необходимо в процедуре загрузки указать все файлы выгрузки).
Обработка загрузки данных из систем аудита
Загрузка файлов в формате MS Excel
В системе Итилиум существует возможность загрузить пользователей из файла MS Excel. Для этого предназначена обработка «Загрузка пользователей из Excel» (раздел «Администрирование и настройки», ссылка панели навигации «Администрирование», ссылка «Импорт данных в Итилиум из внешних систем»). В окне обработки необходимо выбрать клиента и файл для загрузки данных.
На вкладке «Загружаемые поля» выбираются поля, которые необходимо загружать, причем для большинства из них можно выбрать, загружать данные из файла Excel, из справочника Итилиум либо задать их вручную.
Вкладка «Загружаемые поля» обработки загрузки пользователей
На вкладке «Параметры пользователей» можно установить для пользователей следующие параметры:
«Аутентификация ОС»;
«Аутентификация 1С»;
«Показывать в списке выбора»;
«Запрещено изменять пароль»;
«Режим запуска (авто, управляемое приложение или обычное приложение)».
На вкладке «Роли пользователей» можно указать роли, которые будут по умолчанию установлены каждому загружаемому пользователю.
Примечание
При выборе файла загрузки обработка будет обращаться к первому листу книги Excel, т.е. если данные о пользователях находятся на втором, третьем или других листах, то обработка их не «увидит».
После осуществления всех необходимых настроек необходимо нажать Далее. В появившемся окне проставляются галочки напротив тех строк, которые нужно загрузить. После нажатия на кнопку «Далее» данные будут записаны в справочник «Пользователи».
Окно выбора загружаемых полей обработки загрузки пользователей
Получение данных из системы при помощи web-сервиса
Web-сервис IT_DataGetting позволяет внешним системам получать информацию об имеющихся в системе «Итилиум» документах с отбором по интервалу дат, а также набору реквизитов («Клиент», «Ответственный», «Состояние», «Инициатор»). О публикации и настройке web-сервисов можно узнать в главе «Настройка поддержки Web-сервисов».
В результате выполнения web-сервисом операции GetIDs система Итилиум возвращает объект типа RelatedData, содержащий наборы данных для связанных с документами справочников системы.
Операция предназначена для первоначального получения данных справочников, либо периодической актуализации этих данных. Не имеет входных параметров.
Для каждого элемента справочника операция GetIDs возвращает сочетание <Наименование> — <Уникальный идентификатор>. В дальнейшем при получении данных о документах системы для полей ссылочных типов возвращаются именно идентификаторы.
Внимание!
Клиент web-сервиса должен обладать ролью «Использование Web-сервиса IT_DataGetting»
Описание объекта RelatedData
Initiator. Массив элементов справочника «Пользователи (потребители услуг)». Элемент представляет собой объект типа Initiator (http://Itilium.ru). Содержит свойства Name и Ref типа string(http://www.w3.org/2001/XMLSchema). Используется для получения информации об инициаторах обращения.
Responsible. Массив элементов справочников «Сотрудники», «Рабочие группы». Элемент представляет собой объект типа Responsible (http://Itilium.ru). Содержит свойства Name и Ref типа string (http://www.w3.org/2001/XMLSchema). Используется для получения информации о сотрудниках и рабочих группах.
IncidentStatus. Массив элементов справочника «Состояния обращений». Элемент представляет собой объект типа IncidentStatus (http://Itilium.ru). Содержит свойства Name и Ref типа string (http://www.w3.org/2001/XMLSchema). Используется для получения информации о состояниях документов «Обращение».
TaskStatus. Массив элементов справочника «Состояния нарядов». Элемент представляет собой объект типа TaskStatus (http://Itilium.ru). Содержит свойства Name и Ref типа string (http://www.w3.org/2001/XMLSchema). Используется для получения информации о состояниях документов «Наряд».
ChangeStatus. Массив элементов справочника «Состояния изменений». Элемент представляет собой объект типа ChangeStatus (http://Itilium.ru). Содержит свойства Name и Ref типа string (http://www.w3.org/2001/XMLSchema). Используется для получения информации о статусах документов «Изменение».
Client. Массив элементов справочника «Клиенты». Элемент представляет собой объект типа Client (http://Itilium.ru). Содержит свойства Name и Ref типа string (http://www.w3.org/2001/XMLSchema). Используется для получения информации о клиентах.
Error. Массив сообщений об ошибках. Элемент представляет собой объект типа string (http://www.w3.org/2001/XMLSchema). Используется для получения информации об ошибках, возникших при работе метода.
При выполнении web-сервисом операции GetDocs система «Итилиум», получив в качестве входных параметров набор фильтров, возвращает список документов определённого типа, соответствующих заданным фильтрам.
Отбор может производиться по следующим полям
Наименование
Описание
Тип значения
Type
Тип документа
Одно из следующих значений типа String: Incident, Task, Change
DateAfter
Нижняя граница периода, за который нужно предоставить информацию о документах
Объект типа dateTime(http://www.w3.org/2001/XMLSchema)
DateBefore
Верхняя граница периода, за который нужно предоставить информацию о документах
Объект типа dateTime (http://www.w3.org/2001/XMLSchema)
ClientFilter
Массив, содержащий фильтр клиентов. В качестве элемента массива используется уникальный идентификатор справочника «Клиенты», полученный ранее в операции GetIDs
Объект типа ClientFilter (http://Itilium.ru), представляет собой массив элементов типа Ref (http://Itilium.ru)
ResponsibleFilter
Массив, содержащий фильтр ответственных. В качестве элемента массива используется уникальный идентификатор из справочников «Сотрудники» или «Рабочие группы», полученный ранее в операции GetIDs
Объект типа ResponsibleFilter (http://Itilium.ru), представляет собой массив элементов типа Ref (http://Itilium.ru)
StatusFilter
Массив, содержащий фильтр состояний документов. В качестве элемента массива используется уникальный идентификатор из справочников «Состояния обращений», «Состояния нарядов», либо «Состояния изменений», полученный ранее в операции GetIDs
Объект типа StatusFilter (http://Itilium.ru), представляет собой массив элементов типа Ref (http://Itilium.ru)
InitiatorFilter
Массив, содержащий фильтр инициаторов (контактных лиц). В качестве элемента массива используется уникальный идентификатор из справочника «Пользователи (потребители услуг)»
Объект типа InitiatorFilter (http://Itilium.ru), представляет собой массив элементов типа Ref (http://Itilium.ru)
StaffFilter
Массив, содержащий фильтр инициаторов нарядов (физических лиц). В качестве элемента массива используется уникальный идентификатор из справочника «Физические лица»
Объект типа StaffFilter (http://Itilium.ru), представляет собой массив элементов типа Ref (http://Itilium.ru)
Операция возвращает объект типа Data. Данный объект содержит свойства:
«DocArray» — массив документов, соответствующих накладываемым фильтрам, элемент массива имеет тип Doc (http://Itilium.ru);
«RelatedDocArray» — массив связанных документов, элемент массива имеет тип Doc (http://Itilium.ru);
«ErrorArray» – массив, содержащий описания ошибок, возникших при работе операции. Элемент массива имеет тип string (http://www.w3.org/2001/XMLSchema).
Тип Doc является базовой единицей представления документа системы и содержит следующие поля:
«Type» — тип документа (Incident, Task, Change), тип string;
«Number» — номер документа, тип string;
«Theme» — тема документа, тип string;
«DateOfCreating» — дата создания документа, тип dateTime (http://www.w3.org/2001/XMLSchema);
«DateOfLastChange» — дата последнего изменения документа, тип dateTime (http://www.w3.org/2001/XMLSchema);
«Responsible» — уникальный идентификатор ответственного, тип string;
«Status» — уникальный идентификатор состояния документа, тип string;
«Resolution» — решение, тип string;
«Ref» — уникальный идентификатор ссылки документа, тип string;
«Initiator» — уникальный идентификатор контактного лица, тип string;
«RelatedDocs» — массив уникальных идентификаторов связанных документов, тип Ref (http://Itilium.ru).
Передача данных в систему при помощи web-сервиса
Web-сервис custom actions позволяет внешним системам передавать в систему «Итилиум» информацию любого типа. О публикации и настройке web-сервисов можно узнать в главе «Настройка поддержки web-сервисов».
Внимание!
Клиент web-сервиса должен обладать ролью «Пользователь web-сервиса custom actions».
Последовательность настройки механизма работы с web-сервисом следующая.
Шаг 1. Подключить пользовательскую внешнюю обработку, выполняющую прием и обработку получаемых из внешней системы данных, в качестве дополнительной обработки. Обработка должна содержать экспортный метод «ВыполнитьКоманду(Text)», где Text — данные, передаваемые из внешней системы.
Шаг 2. Указать ссылку на подключенную обработку в константе «Обработка для работы web-сервиса custom actions» (меню «Все функции — Константы»).
При обращении к web-сервису вызывается метод «ВыполнитьКоманду(Text)» подключенной внешней обработки, который выполняет предопределенные разработчиком действия с полученными из внешней системы данными.
Пример интеграции с внешним порталом с использованием HTTP-сервиса
HTTP-сервис потенциально позволяет упростить создание клиентских приложений, уменьшить объем передаваемых данных, вычислительную нагрузку и время использования платформенных лицензий (лицензия используется только в момент получения или передачи данных).
Внимание!
Пользователь при работе с внешним порталом должен обладать ролью «Потребитель услуг».
В комплект поставки Итилиум входит архив c именем портал.7z, который содержит файл с описанием интеграции своего дизайна в web-портала, а также архив с примером портала. Для стабильной работы необходимо установить Denwer. Содержимое данного архива необходимо встроить в свой портал на web-сервере для работы пользователя с ролью «Потребитель услуг».
Структура данных
Наименование
Содержание
Incident
UID — идентификатор обращения.
Number — номер обращения.
Data — дата регистрации обращения.
Topic — тема обращения.
Description — описание обращения.
Status — состояние обращения.
TheRegulatoryClosureDate — нормативная дата закрытия обращения.
TheActualClosingDate — фактическая дата закрытия обращения.
MembershipServices — состав услуги.
Category — категория.
ThereAreFiles — наличие прикрепленных файлов.
Rating — оценка.
CommentToTheRating — комментарий к оценке.
RequiresConfirmation — требует подтверждения.
RequiresEvaluation — требует оценки.
RequiresCommentToRating — требует комментарий к оценке.
IncidentDetail
UID — идентификатор обращения.
Number — номер обращения.
Data — дата регистрации обращения.
Description — описание обращения.
Topic — тема обращения.
Status — состояние обращения.
TheRegulatoryClosureDate — нормативная дата закрытия обращения.
TheActualClosingDate — фактическая дата закрытия обращения.
TheHistoryOfCommunication — история общения по обращению.
MembershipServices — состав услуги.
Category — категория.
Configuration item — конфигурационные единицы.
FilesDefinitions — описания файлов.
ThereAreFiles — наличие прикрепленных файлов.
Rating — оценка.
CommentToTheRating — комментарий к оценке.
RequiresConfirmation — требует подтверждения.
RequiresEvaluation — требует оценки.
RequiresCommentToRating — требует комментарий к оценке.
Чтобы уточнить, доступна ли вам возможность работы с порталом или приобрести портал, напишите нам на почту info@itilium.ru или позвоните по телефону 8(499)271-30-77.
