Файлы CSV конфигурационных элементов

Описание правильной структуры файла CSV, содержащего данные КЭ.

Файлы CSV для элементов конфигурации

В каждом файле CSV можно импортировать КЭ только одного типа.

Файл CSV можно создать или отредактировать в редакторе электронных таблиц, таком как Microsoft Excel.

Табл. 1. Базовая структура файла CSV для импорта КЭ
Заголовок файла Тип КЭ Обязательные данные CSV Общие атрибуты КЭ, уникальные атрибуты КЭ и взаимосвязи

simpleci

      

Тип КЭ

      

SRM_SaaS_ES

MXCIImport

По умолчанию используется AddChange. Поддерживаются также Add и Change.

RU

Общие атрибуты КЭ

Уникальные атрибуты КЭ (необязательно)

Взаимосвязь КЭ (необязательно)

  

Данные для общих атрибутов КЭ

Данные для уникальных атрибутов КЭ

Данные для взаимосвязи КЭ

  
Первая строка: Заголовок файла
В качестве заголовка файла введите следующую строку: simpleci
Вторая строка: Тип КЭ
Это значение задает тип КЭ, вводимый вами при использовании этого файла CSV. Вводимый здесь тип КЭ соответствует значению имя классификации или путь классификации, выводимому в прикладной программе Классификации. Чтобы определить, какие значения можно здесь ввести, просмотрите список имен и типов классификаций в прикладной программе Классификации. Перейдите в прикладную программу Классификации (Управление > Классификации), установите указатель на поле Классификация и нажмите клавишу Enter, чтобы вывести все классификации, либо введите в поле строку, чтобы применить к списку фильтр. В продукте предусмотрен набор по умолчанию классификаций КЭ, имена которых начинаются с SCI. Эти классификации можно просмотреть, введя в поле Классификация SCI и нажав Enter. Другой способ фильтрации этого списка - нажать кнопку Расширенный поиск и ввести =CI в поле Использовать с объектом. Когда появится список классификаций, щелкните по классификации в списке, а затем по вкладке Классификации, чтобы вывести путь классификации. Если значение имени классификации уникально, для типа КЭ можно ввести имя классификации. Если значение имени классификации не уникально, для КЭ нужно ввести путь классификации.
Третья строка: Обязательные данные CSV
В этих строках определяется имя внешней системы, служба предприятия, действие и язык. Эти данные необходимы для правильной обработки файла CSV. В качестве значения для действия можно указать

Add, AddChange или Change.

Четвертая строка: Общие атрибуты КЭ, уникальные атрибуты КЭ и взаимосвязи.
В этой строке определяются данные, которые вы хотите ввести для типа КЭ. Каждый элемент в этой строке представляет собой имя столбца данных, вводимых вами в остальных строках таблицы.
В этой строке вводятся данные трех типов: общие атрибуты КЭ, уникальные атрибуты КЭ и взаимосвязи КЭ.
Общие атрибуты КЭ
В следующей таблице перечислены общие атрибуты КЭ, которые можно включить в четвертую строку. Эти атрибуты можно включить для любого типа КЭ. Единственное обязательное значение - CI_CINUM. Значение CI_CINUM должно быть уникальным, поскольку это первичный ключ для КЭ.
Табл. 2. Общие атрибуты КЭ, которые можно включить на четвертой строке
Элемент Описание

ASSETLOCORGID

Организация, которой принадлежит КЭ, если это актив или размещение

ASSETLOCSITEID

Площадка, которой принадлежит КЭ, если это актив или положение

ASSETNUM

Если КЭ - это активом, данный атрибут представляет собой ID актива.

CALNUM

Календарь, связанный с КЭ

CI_CHANGEBY

Сотрудник или программа, создавшие или изменившие КЭ

CI_CHANGEDATE

Дата создания или изменения КЭ

CIGUID

Связь между авторизованным КЭ и фактическим КЭ

CILOCATION

Положение, где физически находится КЭ

CINAME

Понятное пользователю имя КЭ

CI_CINUM

Идентификатор КЭ. Это обязательное значение.

              DESCRIPTION

Описание авторизованного КЭ

EXTERNALREFID

Идентификатор внешней ссылки

ITEMNUM

Если КЭ - это позиция ТМЦ, данный атрибут представляет собой ID позиции ТМЦ.

ITEMSETID

Номенклатура ТМЦ, которой принадлежит КЭ, если это позиция ТМЦ или услуга

Расположение

Если КЭ - положение, этот атрибут представляет собой ID положения.

NP_STATUSMEMO

Краткое описание обстоятельств изменения

PERSONID

Владелец КЭ

PMCHGCWNUM

Номер окна изменения

PMCHGCWORG

Организация окна изменения

SERVICE

Идентификатор услуги, являющейся КЭ

SERVICEGROUP

Указывает группу услуг, к которой относится услуга

SHIFTNUM

Смена, связанная с календарем для КЭ

STATUS

Состояние жизненного цикла КЭТекущий
Уникальные атрибуты КЭ (необязательно)
В дополнение к упомянутых ранее общим атрибутам КЭ можно ввести атрибуты, являющиеся уникальными для каждого типа КЭ. Чтобы определить, какие атрибуты можно здесь ввести, просмотрите атрибуты КЭ в прикладной программе Классификации. Перейдите в прикладную программу Классификации (Администрирование > Классификации) и найдите классификацию, введенную вами во второй строке файла CSV. Выберите эту классификацию. На вкладке Классификации можно просмотреть уникальные атрибуты для этого типа КЭ в таблице Атрибуты. Это уникальные атрибуты, которые можно ввести в четвертой строке файла CSV.
Взаимосвязи КЭ (необязательно)
Здесь можно ввести взаимосвязи КЭ. Чтобы определить, какие взаимосвязи можно использовать в качестве заголовков столбцов, просмотрите список взаимосвязей КЭ в прикладной программе Взаимосвязи. Для обращения к этой прикладной программе выберите Инфраструктура ИТ > Взаимосвязи. Установите указатель в поле Взаимосвязи и нажмите клавишу Enter, чтобы вывести все взаимосвязи, либо введите в поле строку, чтобы применить к списку фильтр. Используйте в качестве заголовка столбца значение взаимосвязи из списка (например, RELATION.INSTALLEDON). Данные в столбце взаимосвязей должны представлять собой значение CI_CINUM для КЭ назначения. Этот КЭ назначения уже должен быть импортирован в систему.