Skip to main content

Импорт из CSV

Импорт из CSV

image.png

Раздел «Импорт из CSV–CSV» этов механизм,системе позволяющийпредназначен импортироватьдля данныемассовой загрузки данных из простогофайла. CSVДоступ файлак странице имеют пользователи с разделителемправом «;»импорта сформированногоиз вCSV.

В UTF-8зависимости формате.от Импортироватьвыбранной можномодели разныеповедение модели,различается: такиедля как:
Пользователи,заявок Компании,поддерживаются несколько форматов и пресеты внешних систем; для пользователей, компаний, КЕ и Активы.
Активыактивов используется классический импорт только CSV с фиксированным порядком колонок.

Общий порядок работы

  1. Откройте раздел импорта в меню приложения.
  2. В списке «Выберите модель для импорта» укажите тип данных.
  3. Дождитесь подсказки с порядком полей (строка с названиями колонок через ;) — для классического импорта и для активов по типу она формируется автоматически после выбора модели.
  4. Выберите файл и нажмите «Импорт».

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

Заявки

Для модели «Заявки» можно импортироватьзагрузить файл в формате:

  • CSV — разделитель полей ;, первая строка файла — заголовки колонок (имена полей должны соответствовать выгрузке источника или универсальным именам; сопоставление выполняется по выбранному пресету).
  • JSON — массив объектов, каждый объект — одна заявка (плоский набор полей). Поддерживаются обёртки вида tickets, issues (Jira), results — парсер разворачивает их в список записей.
  • XLSX (Excel) — первая строка листа — заголовки, далее строки данных (удобно для выгрузок вроде Okdesk и др.).

Дополнительные параметры на экране:

  • Источник / пресет маппинга — выбор внешней системы, от которой зависят соответствия имён колонок полям заявки. Доступны, в частности: Zendesk, Jira, Freshdesk, Naumen Service Desk, Okdesk, Usedesk, Intraservice (IntraDesk), ITSM365, SimpleOne, OTRS / Znuny, варианты Generic и Российские системы (CSV).
  • Сервис по умолчанию — обязателен для создания заявки; если не выбран, может подставиться первый доступный сервис из справочника (при отсутствии сервисов импорт будет невозможен).

Заявитель: если в файле указан e-mail, совпадающий с пользователем в системе, подставляется этот пользователь; иначе по умолчанию используется текущий пользователь, выполняющий импорт.

Импорт заявок идёт построчно с валидацией: строки с ошибками пропускаются, корректные сохраняются. В конце может отобразиться предупреждение с числом импортированных записей и фрагментом списка ошибок (до десяти первых).

Классический импорт (CSV): пользователи, компании, КЕ, активы

Для моделей «Пользователи», «Компании», «КЕ» (конфигурационные единицы, Cunits) и «Активы» (в т.ч. отдельно по каждому типу актива.актива Дляиз удобстваконструктора пользователя,полей):

  • допускается былотолько предусмотренофайл создание шаблона, по которому можно сформировать файл. При выборе модели, отображается список.csv;
  • разделитель полей и— их;;
  • строка порядок для правильной загрузкизаголовков в модель.
    Такфайле как при создании типов активов,не используется конструктор— полей,значения тоидут и список типов, отображаемых в выпадающем списке позволяет импортировать все поля, созданные конструктором.
    Выберите файл с полямистрого в том порядкепорядке, который показан в которомподсказке онина отображеныстранице (как в старой «красной» подсказке, выделеннойтеперь краснымэто цветомблок с перечислением полей через     ;);
  • для активов выбранного типа в подсказку входят сначала стандартные поля актива, затем дополнительные поля, заданные в конструкторе типа.

Рекомендуется сохранять CSV в UTF-8; при чтении система дополнительно выполняет нормализацию кодировок, характерную для выгрузок из Windows (в т.ч. Windows-1251 / KOI8-R), что упрощает импорт файлов из Excel и нажмитеподобных напрограмм.

При кнопкуошибке "Импортвалидации иззаписи CSV"классический импорт может остановиться с сообщением об ошибке (в отличие от поэтапного импорта заявок).

Back to top