Настраиваемый импорт из MS Excel
Внимание
Настраиваемый импорт из MS Excel доступен только для администраторов OSA.
Основные положения
Для импорта табличных данных из файла MS Excel в класс онтологической OSA необходимо настроить описатель файлов импорта в разделе Настройки > Импорт из MS Excel.
Описатель файлов импорта настраивается один раз и может быть многократно использован для импорта различных файлов одинаковой структуры в один и тот же класс.
Для настройки описателя файлов импорта необходимо выполнить следующие действия:
- создать новый описатель файла импорта в разделе
Настройки > Импорт из MS Excelи указать его название - перейти на закладку "Описатели импорта"
- выбрать класс для импорта - в этом классе будут обновлены данные в результата процедуры импорта
- выбрать опцию "Объединять дубликаты по ключевым полям" если необходимо
- выбрать режим импорта
- выбрать файл MS Excel, структура которого совпадает с файлами, подлежащими импорту (можно также выбрать сам файл для импорта)
- настроить соответствие полей MS Excel свойствам класса, отметить ключевые поля
- обновить описатели полей импорта
Импорт данных
Если описатель файлов импорта настроен, т.е.:
- выбран класса для импорта
- указан режим импорта
- настроено соответствие колонок файла свойствам файла
- указаны ключевые поля
- обновлены описатели полей
то импорт сводится к выполнению следующих действий:
- выбор файла MS Excel
- импорт данных - нужно кликнуть по кнопке "Импортировать"
Требования к исходным данным для импорта
- файл должен иметь расширение
.xlsили.xlsx - данные для импорта должны быть размещены на первом (по порядку) или единственном листе книги MS Excel
- в первой строке должны находиться заголовки таблицы
- данные должны начинаться со второй строки, не должно быть пропусков (пустых строк)
- даты должны быть представлены строками в формате
ДД.ММ.ГГГГ - логические значения могут принимать значения
ДаилиНет, пустое значение интерпретируется какНет - импорт в отношение "Экземпляр создан пользователем" не допускается
Настройка описателя файлов импорта
Класс для импорта
Необходимо выбрать класс, в который будут импортированы данные из файла MS Excel. В зависимости от режима импорта, в классе будут созданы новые экземпляры и/или обновлены существующие.
Внимание
В результате импорта могут быть созданы экземпляры также и в других (связанных) классах (см. настройку Создавать при отсутствии)
Объединять дубликаты по ключевым полям
Если опция установлена, записи в файле с импортируемыми данными, имеющие одинаковые значения ключевых полей, рассматриваются как одна запись, т.е. будет импортирована первая попавшаяся из таких записей.
Рассмотрим пример. Пусть, файл для импорта содержит следующие табличные данные:
| ФИО | Возраст |
|---|---|
| Иванов И.И. | 35 |
| Иванов И.И. | 36 |
| Петров И.И. | 36 |
Только одно поле ФИО отмечено как ключевое:
- если опция "Объединять дубликаты по ключевым полям" не установлена, то процедура импорта выдаст сообщение об ошибке, т.к. в файле импорта присутствуют записи с одинаковыми значениями ключевых полей (а данном случае Иванов И.И.)
- если опция "Объединять дубликаты по ключевым полям" установлена, то результатом импорта будет являться следующая таблица (отобрана случайная запись из всех с повторяющимися значения ключевых полей):
| ФИО | Возраст |
|---|---|
| Иванов И.И. | 36 |
| Петров И.И. | 36 |
Если необходимо импортировать исходную таблицу полностью, то ключевыми полями необходимо сделать все поля таблицы: ФИО и Возраст.
Режим импорта
Доступные режимы импорта:
- Создавать - в классе будут созданы новые экземпляры; если на момент импорта в классе есть экземпляры с совпадающими значениями в ключевых полях, то такие экземпляры созданы не будут
- Обновлять - экземпляры в классе не создаются; осуществляется поиск экземпляров в классе по ключевым полям и обновляются остальные свойства экземпляров
- Обновлять или создавать - у найденных по ключевым полям экземпляров класса будут обновлены остальные свойства; экземпляры не найденные в классе будут созданы
Соответствие колонок MS Excel свойствам класса
Чтобы настроить соответствие колонок MS Excel свойствам класса, необходимо выбрать файл импорта, он будет прочитан и из первой строки таблицы будет загружен список колонок импортируемой таблицы.
Каждой колонке, подлежащей импорту необходимо установить в соответствие одно свойство класса для импорта. Колонки, для которых не будет указано соответствие, будут проигнорированы при импорте.
Отметьте поле как "Ключевое", если значение в этом поле должно учитываться при поиске существующих экземпляров. По крайней мере одно поле должно быть ключевым.
Если свойство типизируется другим классом (далее - связанный класс) (т.е. свойство является отношением, а не скалярным свойством), то для него можно установить параметр "Создавать при отсутствии":
- если параметр "Создавать при отсутствии" установлен, то в связанном классе будут созданы новые экземпляры, при их отсутствии (поиск совпадений осуществляется только по имени экземпляров)
- если параметр "Создавать при отсутствии" не установлен, то импорт завершится ошибкой при условии, что в связанном классе не будет найден соответствующий экземпляр
Внимание
Каждый раз, когда вы меняете любые из этих параметров:
- соответствие колонок файла свойствам класса
- состав ключевых полей
- признаки "Создавать при отсутствии" у полей
перед выполнением процедуры импорта, необходимо обновить описатели полей, кликнув по кнопке "Обновить описатели полей"