Импорт из CSV

Есть два режима импорта данных из CSV:

• Импорт в существующую модель - позволяет импортировать экземпляры в существующие классы
• Импорт новой модели - позволяет создать онтологию (набор классов, скалярных свойств и отношений между классами) и импортировать экземпляры в созданные классы

Каждый CSV-файл, подлежащий импорту, может быть использован в двух качествах:

1. Описание структуры класса и его экземпляров - в этом случае колонки файла используются для описания свойств и отношений класса, а строки - для создания экземпляров;
2. Описание связей между экземплярами - строки файла будут использованы для создания отношений между экземплярами классов.

Требования к CSV-файлам

• В первой строке - названия колонок
• Разделителем данных является запятая
• Формат дат - "ГГГГ-ММ-ДД"
• Для логического типа (галочек) могут быть указаны следующие значения: 1, y, yes, да, true, t
• разделитель целой и дробной части числа - точка

Импорт в существующую модель

❗Важно

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

Подготовка импорта

1. Откройте раздел "Импорт из CSV" и кликните по кнопке "Импортировать" > "Импорт в существующую модель"
2. На панели инструментов рабочего пространства выберите онтологию для импорта;
3. Кликните по кнопке "Добавить файлы", чтобы файлы для импорта

Настройка импорта

Настройка импорта экземпляров

Для каждого CSV-файла, который используется для импорта новых экземпляров:

1. Перейдите на вкладку с именем файла
2. Не устанавливайте флажок "Только для связи", если вы импортируете основные данные. Этот флажок следует включать только для файлов, предназначенных исключительно для установления связей между экземплярами
3. В поле "Класс" выберите класс, экземпляры которого будут создаваться при импорте
4. В поле "Свойства для построения имени экземпляра" укажите одно или несколько свойств, значения которых будут объединены через символ нижнего подчёркивания (_) для формирования имени нового экземпляра. Если оставить это поле пустым, имена будут сгенерированы автоматически
5. Установите соответствие между колонками CSV-файла и свойствами выбранного класса. Убедитесь, что все свойства, которые вы хотите импортировать, отмечены галочками.
6. Для свойств, представляющих связи (отношения), дополнительно укажите в поле "Свойство-приёмник в [имя класса]", по какому свойству целевого класса будет выполняться поиск экземпляров для установления связи

Настройка создания связей

Для каждого CSV-файла, который используется для установления связей между экземплярами:

1. Перейдите на вкладку с именем файла
2. Установите флажок "Только для связи" — он указывает, что файл содержит данные только для установления связей между экземплярами, а не для создания новых записей
3. В поле "Класс-источник" выберите класс, экземпляры которого будут выступать в роли субъектов связи (от кого идёт связь)
4. В поле "Связь" укажите свойство (отношение), которое будет использоваться для соединения экземпляров класса-источника с экземплярами класса-приёмника
5. В поле "Свойство-источник в [имя класса-источника]" выберите то свойство класса-источника, по значению которого система будет искать подходящие экземпляры
6. В поле "Колонка значений для источника" укажите колонку из CSV-файла, содержащую значения для поиска экземпляров-источников
7. В поле "Свойство-приемник в [имя класса-приёмника]" выберите свойство класса-приёмника, по которому будет выполняться поиск целевых экземпляров
8. В поле "Колонка значений для приёмника" укажите колонку из CSV-файла, содержащую значения для поиска экземпляров-приёмников

Пример настройки импорта

Существующая модель для импорта данных из CSV-файлов:

Экземпляры класса "Статус":

• Активно
• Архив

Экземпляры класса "Персона":

• Иванов И.И. с ИНН 123456789012

Файлы для импорта и выполненные настройки

1) Проекты.csv

Название,Код,Бюджет,Статус
Проект 1,001,500,Активно
Проект 2,002,150,Архив

Обратите внимание!

Статусы проектов не импортируются отдельно, так как они уже определены в существующей модели и не требуют загрузки из внешнего файла.

Настройки в системе:

• Флаг Только для связи — не установлен
• Класс — Проект
• Свойства для построения имени экземпляра — Название
• в свойство имеет бюджет, руб — колонку Бюджет
• в свойство имеет код — колонку Код
• в связь имеет статус — колонку Статус, а в качестве свойства-приемника - Имя экземпляра

2) Персоны.csv

Персона,ИНН
Петров П.П.,123456789034
Сидоров С.С.,123456789056

Настройки в системе:

• Флаг Только для связи — не установлен
• Класс — Персона
• Свойства для построения имени экземпляра — Персона
• в свойство имеет ИНН — колонку ИНН

3) Связи Проект-Персона.csv

Код проекта,ИНН участника
001,123456789012
001,123456789034
002,123456789056
002,123456789034

Обратите внимание!

В таблице импортируемых связей указан ИНН 123456789012 для персоны Иванов И.И.
Эта персона не входит в импортируемые данные, но уже существует в текущей модели, поэтому связь будет установлена с существующим экземпляром.

Настройки в системе:

• Флаг Только для связи — установлен
• Класс-источник — Проект
• Связь — имеет участников
• Свойство-источник в "Проект" — имеет код
• Колонка значений для источника — Код проекта
• Свойство-приемник в "Персона" — имеет ИНН
• Колонка значений для приемника — ИНН участника

Импорт новой модели

Подготовка импорта

1. Откройте раздел "Импорт из CSV" (далее - реестр импортов) и кликните по кнопке "Импортировать" > "Импорт новой модели"
2. На панели инструментов рабочего пространства введите название будущей онтологии или оставьте предложенное по умолчанию;
3. Кликните по иконке (Добавить csv файлы), чтобы добавить файл (или файлы) для импорта

Настройка импорта

Каждый добавленный CSV-файл отображается в виде отдельной закладки в панели настроек.

Настройка класса

1. Укажите название класса; не устанавливайте галочку "Является таблицей-связью"
2. Для каждого свойства укажите название (или оставьте без изменения) и тип данных
3. Установите признак "Не импортировать", чтобы не создавать свойство класса и не устанавливать значения этого свойства для импортируемых экземпляров
4. Установите признак "Имя экземпляра", чтобы значение свойства было использовано в качестве наименования создаваемых экземпляров; если признак "Имя экземпляра" будет установлен у нескольких свойств, то результирующим наименованием экземпляров будет являться результат конкатенации значений указанных свойств
5. Для свойств типа "Ссылка" укажите связанный класс и свойство для связи

Рассмотрим описание свойства типа "Ссылка" на примере импорта CSV-файла следующего содержимого:

Имя,Дата рождения,Отец
Дмитрий,1980-12-25,,
Лев,2007-05-24,Дмитрий
Екатерина,2009-02-17,Дмитрий

Чтобы в результате импорта получить следующую онтологию:

необходимо:

1. Для класса установить наименование "Человек"
2. Для свойства "Имя" установить признаки "Имя экземпляра" и "Не импортировать"
3. Для свойства "Отец" указать наименование "имеет отца", выбрать тип "Ссылка"; в качестве связанного класса указать "Человек", а в качестве свойства для связи - "Имя"

Настройка таблицы-связи

С помощью таблиц-связей могут быть настроены связи типа "многие ко многим" или "один ко многим" между экземплярами.

1. Установите признак "Является таблицей-связью" и кликните по кнопке "Добавить описание связи"
2. Укажите название связи
3. Установите признак "Является коллекцией" при необходимости
4. Поля "Свойство-источник в таблице-связи", "Класс-источник" и "Свойство в классе-источнике" используйте для настройки источника связи
5. Поля "Свойство-приемник в таблице-связи", "Класс-приемник" и "Свойство в классе-приемнике" используйте для настройки приемника связи

Рассмотрим настройку таблицы-связи на следующем примере. Пусть даны три CSV-файла:

1. Студенты.csv

ФИО
Иванов И.И.
Петров П.П.

2. Курсы.csv

Наименование курса
Математика
Физика

3. Слушатели курсов.csv

Студент,Курс
Иванов И.И.,Математика
Иванов И.И.,Физика
Петров П.П.,Математика

Для получения следующей онтологии:

необходимо:

1. Для файла "Слушатели курсов.csv" установить признак "Является таблицей-связью"

2. Указать название связи "слушает курсы" и установить признак "Является коллекцией"

3. В полях для источника связи указать:

   • Свойство-источник в таблице-связи: Студент
   • Класс-источник: Студент (Студенты.csv)
   • Свойство в классе-источнике: ФИО

4. В полях для приемника связи указать:

   • Свойство-приемник в таблице-связи: Курс
   • Класс-приемник: Курс (Курсы.csv)
   • Свойство в классе-приемнике: Наименование курса

Запуск импорта

Кликните по кнопке "Старт", после того как завершите настройку импорта. Вас перенаправит на страницу реестра импортов, где в колонке "Статус" будет отображен один из следующих статусов:

• В работе - импорт в процессе выполнения
• Завершен - импорт завершен успешно (созданы онтология, классы, свойства и экземпляры)
• Ошибка - импорт завершен с ошибкой, объекты не созданы

Импорт может занимать некоторое время (особенно, если импортируется большой объем данных) и выполняется в фоне после запуска. Страницу импорта и реестра импортов можно закрыть - это не окажет влияния на работу импорта.

Удаление всех импортированных данных (отмена импорта)

Кликните по иконке (Отменить импорт) в строке реестра импортов, чтобы удалить все созданные в результате импорта объекты:

• описатель импорта из реестра импорта
• созданные онтологии, классы, свойства, экземпляры
• загруженные csv-файлы

Удаление описателя импорта

Кликните по иконке (Удалить запись об импорте) в строке реестра импортов, чтобы удалить описатель импорта и загруженные файлы. Импортированные данные при этом удалены не будут.

Редактирование импорта

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