Импорт данных из Ivanti Neurons

Вы можете использовать расписание для импорта данных устройств и пользователей из Ivanti Neurons. Сначала нужно создать новую регистрацию приложения в Ivanti Neurons и создать подключение для пересылки данных в ваш экземпляр Ivanti Neurons, а затем использовать подключение для планирования импорта.

Создаваемый для Ivanti Neurons коннектор предназначен только для импорта данных. Он не может использоваться для других целей, таких как запросы и поиск в Service Desk.

Конфигурация данного импорта - это расширенная функция, предназначенная для использования теми, кто знаком с такими технологиями, как Postman, JSON и OData, для сбора необходимых параметров подключения. Если вам нужна поддержка использования этой функции от профессиональных сервисов Ivanti, обратитесь к своему поставщику.

Для получения дополнительной информации о подключениях см. раздел Подключения данных и раздел Импорт данных для получения информации о компоненте импорта.

Для создания подключения к платформе Ivanti Neurons:

1. Создайте новую особую регистрацию приложения в платформе Ivanti Neurons. Это создаст URL-адрес маркера доступа, ИД клиента и секрет клиента, которые будут необходимы в дальнейшем.

Для получения дополнительной информации о создании регистрации нового особого приложения см. отдельную справку для платформы Ivanti Neurons.

2. Запустите компонент Подключения данных и в дереве Подключения данных выберите коннектор Ivanti Neurons, а в списке Действия нажмите Новое подключение.
   Будет создано новое подключение.
3. Введите имя подключения и нажмите клавишу Enter
   Это имя станет именем модуля, который будет использоваться во время конфигурации источника для импорта данных.
4. В таблице Свойства установите значение URL-адрес для URL-адреса вашего Tenant для Ivanti Neurons; например, https://example.ivanticloud.com/.
5. Для параметра Поставщик уже установлено значение OAuth2, которое изменить нельзя. Укажите значения параметров URL-адрес маркера доступа, ИД клиента и Секрет клиента. Не заполняете значение Область действия.
6. Нажмите для проверки подключения.
   В случае неудачи подключения проверьте указанную выше информацию и повторите попытку.
7. Щелкните для сохранения нового подключения.

После создания подключения к платформе Ivanti Neurons вы можете создавать типы подключений для доступа к различным типам данных, доступным в Ivanti Neurons, например, для устройств или пользователей.

Во время конфигурации импорта необходимо указать уникальные идентификаторы для импортируемых элементов. Однако в некоторых случаях вам не удастся найти идентификаторы, уникальные для всех импортируемых элементов. Например, во время импорта устройства вы можете использовать имя устройства в качестве уникального идентификатора только для устройства Windows, а не для устройства Apple, для которого, возможно, придется использовать другие данные, например, серийный номер. В таких случаях необходимо создать разные варианты импорта данных для различных типов устройств, используя фильтр выбора только необходимых элементов.

Вы не можете создать фильтр для данных Neurons в ПО Service Desk - вместо этого нужно выполнить фильтрацию данных с помощью запроса OData как части URL-адреса конечной системы во время создания типа подключения (представлено далее). Например, вместо ввода URL-адреса конечной системы, подобного api/discovery/v1/device, вы можете указать api/discovery/v1/device?$filter=manufacturer eq 'Apple'.

Для создания нового типа подключения:

1. В дереве подключений данных выберите созданное ранее подключение, а затем в списке Действия выберите Создать тип подключения.
   Отобразится новый тип подключения.
2. Введите имя типа подключения и нажмите клавишу Enter.
3. В таблице Свойства укажите следующие свойства типа подключения.
   Url-адрес конечной системы - это путь к подключаемой конечной системе, например, api/discovery/v1/device или api/discovery/v1/user. Если вам нужно импортировать все доступные данные, необходимо включить фильтр OData как часть URL-адреса, так как вы не сможете добавить фильтр позже в процессе конфигурации импорта данных.
   Имя класса TPS: введите имя объекта.
   Описание класса TPS: необязательное значение.
4. Нажмите рядом с элементом Назначения атрибутов.
   Отобразится диалог "Управление назначениями", где можно сохранить назначения для элементов OData в Ivanti Neurons, которые нужно будет получить для атрибутов коннектора Service Desk. Затем эти элементы OData станут доступны для импорта в Service Desk с использованием компонента импорта данных.

Если нужно открыть доступ к устройствам в ПО Ivanti Neurons с помощью Диспетчера настольных систем, не забудьте добавить назначение для атрибута ИД Neurons, который используется для идентификации устройств. Для получения дополнительной информации см. раздел Подключение к Ivanti Neurons для управления настольными системами.

5. Нажмите Добавить назначение.
   Отобразится диалог определения атрибута назначения.
6. Используйте технологию, например, Postman для получения записи подходящего устройства или пользователя из Ivanti Neurons.
7. Введите Имя и Заголовок в диалоге определения атрибута назначения, а затем укажите Описание (необязательно).
8. В ПО Postman скопируйте имя элемента, который нужно импортировать с этим назначением, и вставьте его в поле Назначение.
9. Нажмите OK.
   Назначение будет добавлено в список в диалоге. Если вы используете символ / для доступа к элементам из структуры дерева, символ / изменится на . в столбце Назначение ответа. Столбец Назначение запроса содержит значение, переданное в URL-адрес конечной системы, а в столбце Назначение ответа содержится путь к требуемым данным.
10. Если элемент соответствует массиву (у пользователя может быть несколько адресов электронной почты, и нужно выбрать один из них), введите индекс требуемого элемента в столбце Назначение ответа [в квадратных скобках] перед . - используется как разделитель.

Нумерация индексов начинается с 0, поэтому для открытия первого электронного письма в массиве электронной почты введите Emails[0].Email в столбце Назначение ответа.

11. Повторите действия для других атрибутов, к которым вам нужен доступ.
12. В диалоге управления назначениями установите для параметра Имя? значение True для атрибута, содержащего уникальное значение в виде его имени и нажмите OK.
    Диалог управления назначениями будет закрыт.
13. Для типа подключения в таблице свойств установите значение для элемента Главный ключ.
14. В списке Действия нажмите Тест назначения.
    Отобразится таблица с результатами назначений для первых 10 полученных записей.

После сохранения изменений типа подключения можно добавлять и удалять новые назначения (кроме имени и главного ключа), однако нельзя редактировать существующие назначения.

15. Нажмите для сохранения изменений.

Теперь после создания подключения с Ivanti Neurons вы можете использовать его для создания импорта данных. Процесс импорта осуществляет назначение данных, указанных ранее в назначениях типов коннекторов, для соответствующих атрибутов объектов Service Desk.

Для создания конфигурации импорта:

1. В дереве Назначения импорта компонента Импорт данных выберите папку запланированного импорта.
2. В списке Действия нажмите Новый запланированный импорт, укажите нужное расписание и нажмите .
3. В дереве импорта конфигураций выберите только что созданное расписание, а затем в списке Действия выберите Создать назначение импорта.
   Появится окно нового назначения импорта.
4. В списке Исходный модуль выберите модуль, созданный во время настройки имени подключения данных.
5. В списке Исходный бизнес-объект выберите объект, созданный во время настройки имени типа подключения данных.
6. В поле Цель выберите Модуль и Бизнес-объект, в который нужно импортировать данные Neurons.
7. Переместите Исходные атрибуты, из которых нужно импортировать данные, в Целевые атрибуты.
8. В списке Целевые атрибуты выберите атрибут, который будет использоваться в качестве ключа, а затем в списке Действия нажмите Установить атрибут целевого ключа.
   Появится диалог атрибута целевого ключа.
9. Выберите атрибуты, которые нужно сделать ключевыми, и нажмите OK. Для получения дополнительной информации о целевых атрибутах см. раздел Установка атрибута 'Целевой ключ'.
10. Если необходимо, установите значение параметра Путь файла журнала и нажмите .
    Импорт данных выполняется по расписанию.