Пример создания пакета импорта

Рассмотрим создание пакета импорта на примере импорта справочника физических лиц со списком контактов. Содержание листов файла в формате MS Excel, откуда будет производиться импорт, приведено в Таблице 1.

Для импорта выберите файл генерации пакета импорта в виде, который представлен в Таблице 1. Для первого листа в качестве класса приемника выберите справочник "Физические лица", для второго листа – справочник "Типы контактов", для третьего - элементы списков "БизнесМодель.КонтактыФизЛиц".

Введите название пакета импорта "Импорт физлиц с контактами".

Произведите настройку соответствий параметров справочника "Физические лица" колонкам листа "Лист 1" файла MS Excel.

Если не был выбран файл генерации, добавьте из контекстного меню новый этап для импорта физических лиц. Имя листа - "Лист 1." Класс приемник - класс "БизнесМодель.ФизЛица".

Допустим, что однозначным идентификатором физического лица является набор колонок Фамилия, Имя, Отчество.

Конечно, чтобы однозначно определить объект, этого может оказаться недостаточно. К параметрам "Фамилия", "Имя", "Отчество" возможно добавление таких параметров, как "Адрес", "Дата рождения", "Паспортные данные" - при их наличии и необходимости задания в качестве ключевых. В таком случае параметры "Адрес" и "Паспортные данные" могут являться объектными, то есть сложными параметрами, уже для объекта "Физическое лицо".

На вкладке Ключ задайте параметры "Фамилия", "Имя", "Отчество".

На вкладке Параметры задайте параметры "Дата рождения", "Комментарий".

Произведите настройку соответствий параметров справочника "Типы контактов" колонкам листа "Лист 2" файла MS Excel.

Если не был выбран файл генерации, добавьте из контекстного меню новый этап для импорта типов контактов. Имя листа - "Лист 2.". Класс приемник - класс "БизнесМодель.ТипыКонтактов".

Ключом для типа контакта будет его "Название". Добавьте его на вкладке Ключ.

Произведите настройку соответствий параметров класса "БизнесМодель.КонтактыФизлиц" колонкам листа "Лист 3" файла MS Excel.

Если не был выбран файл генерации, добавьте из контекстного меню новый этап для импорта контактов физических лиц. Имя листа - "Лист 3." Класс приемник - класс элементов списков "БизнесМодель.КонтактыФизЛиц".

Ключом для контакта будут объектные параметры "ТипКонтакта" и "Владелец" (то есть физическое лицо), у которого, в свою очередь, ключом является набор параметров "Фамилия", "Имя", "Отчество" (см. Принципы задания соответствий параметров).

Добавьте их на вкладке Ключ:

• добавьте простой параметр "ТипКонтакта" выбором пункта контекстного меню Добавить параметр, в окне Выбор параметра выберите "Тип контакта", затем выберите "Название"; в окне Выберите колонку листа выберите "Тип контакта" или введите вручную в поле Параметр класса;
• добавьте сложный параметр "Владелец\{Фамилия}{Имя}{Отчество}" выбором пункта контекстного меню Добавить сложный параметр; в окне выбора параметра установите флажок Показывать все, выберите параметр "Владелец", в окне Редактор колонки импорта добавьте соответствия для параметров "Фамилия", "Имя", "Отчество".

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

Ключом владельца будет набор параметров "Фамилия", "Имя", "Отчество" (классом владельцем является класс "БизнесМодель.ФизЛица"). Добавить этот набор параметров на вкладке Ключ владельца.

Дополнительным параметром (неключевым) является параметр "Контакт". Добавьте его на вкладке Параметры.

Сохраните внесенные изменения с помощью кнопки Сохранить.

В справочнике Пакет импорта выделите нужный пакет и нажмите на гиперссылку Выполнить импорт. Откроется окно Выполнение импорта (см. Выполнение импорта).