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

Рассмотрим создание пакета импорта на примере импорта справочника физических лиц со списком контактов.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

В списке пакетов импорта выделить нужный пакет и нажать гиперссылку Импорт/Экспорт. Откроется окно «Выполнение импорта» (см. Bыполнение импорта).