Системные требования#

Для работы с модулем «Импорт данных» необходимо установить в Систему .net framework 4.8 .

Обновление .net даст возможность взаимодействовать по протоколу TLS 1.3. Убедитесь, что в Системе есть поддержка этого протокола.

Настройка импортера данных#

Перед началом работы с модулем Импортер данных :

Заполните форму авторизации:

Где:

[Адрес сервера приложения] можно заполнить данными из адресной строки браузера.

В конфигурационном файле config.xml заполните параметры:

config.xml

<?xml version="1.0"?>
<root>
  <settings>
    <overwritetemptables>1</overwritetemptables>
  </settings>
  <server>
        <commandTimeout>300</commandTimeout>
        <Timeout>300</Timeout>
                  <!--Необязательные параметры для доступа из другой сети-->
                  <Forwarding>false</Forwarding>
                  <PortForwarding>25432</PortForwarding>
                  <IpForwarding>10.2.3.4</IpForwarding>
  </server>
</root>

Где:

commandTimeout - максимальное время на выполнение команды, по умолчанию указано значение в секундах 300. Значение необходимо увеличить при возникновении ошибки превышения времени выполнения запроса. Информация об ошибке будет записана в лог-файле.
Timeout - максимальное время на установку соединения с БД, по умолчанию указано значение в секундах 300. Информация об ошибке подключения к БД будет записана в лог-файле.

Блок настроек для работы из другой сети, где нет прямого доступа к БД, но реализована возможность перенаправления порта и IP. То есть при успешной аутентификации мы получаем параметры подключения к БД в закрытом контуре, из текущей сети доступа нет, но имеется возможность сетевыми средствами порт/адрес БД из закрытого контура открыть наружу.

Forwarding - включение возможности изменения порта и IP на другой, для работы из другой сети. Если настройка равна false, то перенаправления не будет, значение true - включает эту возможность.
PortForwarding - на какой порт заменяем.
IpForwarding - на какой IP заменяем.

Например, мы получили порт 5432 и адрес 10.1.4.12 закрытого контура. В нашей сети перенаправление осуществляется через порт 25432 и адрес 10.2.3.4.

Установите шрифт для корректного отображения значков в интерфейсе импортера. Для этого необходимо в папке модуля «fonts» найти файл GlyphiconIAS.otf. Запустить его двойным щелчком мыши и нажать «Установить». После установки шрифта закройте диалоговое окно и перезапустите модуль.

Описание интерфейса#

Примечание

Перед началом работы в импортере данных необходимо выполнить его настройку (см. Настройка импортера данных).

Главное окно модуля «Импортер данных» состоит из:

[1] - имя БД, в которую импортируются данные;
[2] «Шаблоны» - выбор шаблона для импорта (уже созданного набора пар в файле .xml);
[3] - сохранение шаблона (см. Как сохранить шаблон импорта);
[4] «Открыть из файла» - загрузка шаблона для импорта из файла;
[5] «Схема-приемник» - выбор проекта, в который будет выполнен импорт данных. До выбора схемы-приемника кнопки на панели импортера будут неактивны. Выбрать можно только те проекты, в которых у сотрудника есть установленная связь с субъектом. Так как информация о сотруднике, выполнившим импорт, будет отображаться в свойствах объектов.
[6] «Набор данных» - выбор схемы-приемника БД, в которую импортируются данные;
[7] «Перейти к сопоставлению» - начало сопоставления полей приемника и источника данных.

Выполнение импорта#

Как создать шаблон для импорта#

В поле [Схема-приемник] выберите название проекта, куда будут импортироваться данные. После выбора приемника данных в рабочей области автоматически создается корневой шаблон с названием «Новый шаблон».

В поле [Набор данных] выберите из списка БД набор данных, в который будет выполняться импорт. Набор данных предварительно должен быть создан в приложении (см. создайте набор данных).

Чтобы выбрать ранее созданный шаблон, нажмите кнопку «Шаблоны» и выберите из списка нужный файл.

Как создать пару источник-приемник#

Чтобы создать пару источник-приемник нажмите кнопку «Добавить пару» на панели инструментов или справа от названия шаблона в рабочей области. Откроется окно «Свойства пары».

Заполните поля:

[Имя пары] введите произвольное название.
[Объект-приемник] выберите Alias объекта-приемника (см. Как определить Alias объекта).
[Источник] выберите источник данных:

«Файл» неоходимо указать путь к файлу, содержащему данные для импорта в формате .tab, .mid/mif, .shp , .xls/.xlsx (с указанием листа, из которого загружаются данные);

«ИАС Градоустройство V2» требуется подключиться к БД;

«Временное хранилище» - введите название файла и укажите путь для его сохранения на рабочем месте. Данные указываются только при создании первой пары источник-приемник. Для всех последующих пар при выборе источника «Временное хранилище» будет доступно временное хранилище, для первой пары источник-приемник;

«Таблица в базе данных» - при выборе этого вида источника, поля с информацией об источнике данных заполнятся автоматически (доступно редактирование полей вручную).

После заполнения всех полей нажмите кнопку «Добавить пару» в окне «Свойства пары». После добавления в шаблоне рабочей области появится новая пара.

Чтобы открыть свойства пары, два раза щелкните левой кнопкой мыши по ее названию в рабочей области.

Добавьте необходимое количество пар.

Как определить Alias объекта#

Найти Alias объекта можно следующими способами:

в основном приложении найти нужный тип объекта или, в случае отсутствия, создать новый. В карточке объекта в нижнем левом углу скопировать наименование. Запустить в Редактор метаданных и открыть в нем нужный проект с метаданными. В строке поиска ввести наименование вручную или вставить скопированное из карточки объекта в приложении. Определить Alias в соответствующем поле в свойствах объекта.

в Конфигураторе системы открыть нужный проект и перейти в раздел «Роли». Щелкнуть по ссылке-названию одной из ролей в списке. В поле [Состав роли] ввести тип объекта и в результатах поиска найти искомое значение. Alias объекта будет указан в графе «Псевдоним типа».

в Конфигураторе системы открыть нужный проект и перейти в раздел «ГИС Конфигуратор». В поле [Представление БД] представлено наименование слоя, которое состоит из префикса Geo + Alias объекта.

Как сопоставить поля#

После создания требуемого количества пар «Источник-приемник», для перехода к настройкам сопоставлеия полей, нажмите кнопку «Перейти к сопоставлению» в нижнем правом углу окна модуля.

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

Чтобы изменить пару для сопоставления, в поле [Пара «Источник-приемник»] выберите название из раскрывающегося списка или переключайтесь между ними с помощью стрелок <,|больше| .
В поле [Режим импорта] выберите значение из списка:
- Добавить - данные размещаются в системе вместе с уже имеющимися;
- Обновить - обновление семантики и геометрии при совпадении объектов по ключевому полю. Ключевое поле задается в структуре таблицы приемника в столбце .
- Перезалить - данные, размещенные в системе, будут удалены и вместо них будут размещены данные источника.
- Перезалить с инфосетом - данные, размещенные в объекте системы и имеющие указанный набор данных, будут удалены и вместо них будут размещены данные источника.
- Добавить и обновить - обновить в случае совпадения ключевого поля и добавить в случае несовпадения.
Выберите тип в поле [Геометрия], если в исходных данных присутствуют объекты с геометрией.

Если в источнике данных присутствуют объекты с геометрией, то модуль информирует о типе геометрии и количестве объектов с геометрией указанного типа. На основе этой информации выберите тип геометрии. Если в источнике данных присутствуют объекты с отличным от выбранного типа геометрии, то такие объекты импортируются без геометрии.
Поле [Система координат источника]. Система пытается автоматически определить систему координат из файла, содержащего импортируемые данные, и сопоставить её с доступными системами координат. Если автоматически сопоставить не удалось, то укажите систему координат вручную, выбрав значение из списка. Если поле [Система координат источника] пустое, укажите систему координат данных, загружаемых в Систему, и сохраните шаблон. Значения в поле сохранятся и будут отображаться при следующем использовании.

5. Чтобы сопоставить поля объектов приемника и источника в окне «Структура таблицы приемника» выберите поле, затем в окне «Структура таблицы источника» дважды щелкните левой кнопкой мыши по полю для сопоставления. Выбранные поля в таблице приемника и источника сопоставятся.

Примечание

Чтобы сопоставить даные разного типа используются значения полей источника и стандартные функции PostgreSQL (например, чтобы сопоставить поле приемника с типом DATE и поле источника с типом VAR, к значению в поле DATE нужно добавить ::date ).

Для импорта данных, которые являются ссылками на другие объекты или значениями справочника, в модуле предназначена функция #LINK.

#LINK возвращает значение ключа первого найденного объекта нужного типа или значения справочника, у которого <поле> равно <значение>.

Чтобы сопоставить ссылочные поля с помощью функции #LINK в таблице приемника выберите поле, которое ссылается на другой справочник и введите функцию в формате:

#LINK („<псевдоним справочника или объекта>“, <значение>, „<поле>“) , где:

„<псевдоним справочника или объекта>“ - алиас тех объектов метаданных, среди которых необходимо совершить поиск;

<значение> - значение, которое ищется в поле объекта. „<Значение>“ помещается в одинарные кавычки в тех случаях, когда вводится константное значение. Таким образом система буквально поместит это значение в указанное поле. «<Значение>» помещается в двойные кавычки в случае, если указывается поле источника, в котором содержится значение.

„<поле>“ - поле БД, в котором осуществляется поиск объекта по значению.

Параметр „<псевдоним справочника или объекта>“ можно не указывать, если возможно однозначно определить псевдоним объекта, на который ссылается поле (поле може содержать ссылки на объекты только одного алиаса).

Чтобы в процессе создания схемы сопоставления предварительно посмотреть результат обработки поля для текущих исходных данных нажмите кнопку .

После того, как сопоставление настроено, для запуска процесса импорта нажмите кнопку «Перейти к импорту».

Как добавить фильтр#

Фильтр используется для добавления условий полям при импорте данных.

Для добавления фильтра применяется кнопка «Добавить фильтр».

Чтобы применить фильтр:

нажмите кнопку «Добавить фильтр»;
выберите поле источника к которому применится фильтр;
задайте условия в окне «Фильтр»:
- «Добавить AND» - используется, если в результат запроса должны быть включены объекты, удовлетворяющие всем заданным условиям.
- «Добавить OR» - если в результат запроса должны быть включены объекты, удовлетворяющие хотя бы одному заданному условию.
- «равно» и «не равно» - определяет условие: содержится или нет в указанном поле заданное значение. И при соответствии объекта условиям выводит его в выборку.

Удаление или редактирование условий в рабочей области фильтра выполняется инструментами простого текстового редактора.

После добавления фильтра кнопка «Добавить фильтр» подсвечивается красным и изменяется на «Применен фильтр».

Как добавить скрипт#

Модуль позволяет использовать SQL-скрипты для ручной модификации данных. Существует 2 типа скриптов: скрипт М и скрипт П.

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

Скрипт М выполняется после внесения данных во временную таблицу в БД, но до создания или обновления объектов системы на основе этих данных. Он используется, в основном, для модификации данных во временной таблице. Для добавления скрипта нажмите кнопку «Добавить скрипт [М]». После добавления скрипта кнопка «Добавить скрипт [М]» подсвечивается красным и изменяется на «Скрипт [М] активен».

Скрипт П выполняется после осуществления всего импорта пары. Для добавления скрипта нажмите кнопку «Добавить скрипт [П]». После добавления скрипта кнопка «Добавить скрипт [П]» подсвечивается красным и изменяется на «Скрипт [П] активен».

Скрипты поддерживают переменные, значения которых подставляются в момент импорта:

@infoset@ - значение ключа набора данных с которым осуществляется импорт
@schema@ - название схемы в которую производится импорт конечных данных
@alias@ - псевдоним объектов которые создаются в ходе импорта пары
@tablename@ - название временной таблицы (вместе со схемой – прим. «importer.tt464»)

Удаление или редактирование условий в рабочей области окна скрипта выполняется инструментами простого текстового редактора.

Как сохранить шаблон импорта#

Перед выполнением импорта данных рекомендуется сохранить шаблон с настройками для дальнейшего использования при выполнении импорта данных.

Для сохранения шаблона нажмите кнопку вверху рабочей области:

«Сохранить в базу» - сохранение шаблона импорта в базе данных. Шаблоны, сохраненные таким образом доступны всем пользователям, у которых есть доступ к базе данных.
«Сохранить в V2» - сохраненный шаблон импорта будет доступен в Веб-импортере.
«Сохранить в файл» - сохранение шаблона импорта на рабочем месте пользователя.

Как проходит импорт данных#

После нажатия кнопки «Перейти к импорту» в главном окне модуля отобразится процесс импорта данных.

После окончания импорта слева от названия каждой пары отображается статус ее обработки.

Статус может принимать значения:

- успешно;
- пропущен;
- ошибка.

Чтобы внести изменения и запустить импорт повторно, нажмите кнопку «Назад».

Примечание

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

Как выполнить частичный импорт данных#

Чтобы импортировать часть пар из ранее созданного шаблона, в главном окне импортера нажмите кнопку флажок «Отобразить ключ импорта».

Проставьте флажки рядом с названиями пар для импорта и выполните импорт данных в обычном режиме.

Отображение импортированных данных#

После загрузки семантические и геометрические данные сразу отображаются на карте в Системе.

Загрузите в панель представления таблицу слоя, в который выполнялся импорт данных.

Чтобы отобразить в таблице только загруженные объекты, можно выполнить фильтрацию или поиск в таблице по набору данных.

В карточке каждого загруженного объекта во вкладке «Информация» будет отображаться набор данных, который был указан в десктоп-импортере.