Это старая версия документа.
Рассмотрим создание пакета импорта на примере импорта справочника физических лиц со списком контактов. Содержание листов файла в формате MS Excel, откуда будет производиться импорт, приведено в Таблице 1.
Лист 1 | ||||
---|---|---|---|---|
Фамилия | Имя | Отчество | Дата рождения | Комментарий |
Иванов | Иван | Иванович | 29.09.1969 | Кандидат … |
Петров | Петр | Петрович | 04.05.1978 | |
Лист 2 | ||||
Тип контакта | ||||
Этаж/Кабинет | ||||
Сотовый телефон | ||||
Домашний телефон | ||||
Электронная почта | ||||
Лист 3 | ||||
Фамилия | Имя | Отчество | Тип контакта | Контакт |
Иванов | Иван | Иванович | Этаж/Кабинет | 3 этаж, комната 122 |
Иванов | Иван | Иванович | Домашний телефон | 444333 |
Петров | Петр | Петрович | Этаж/Кабинет | 3 этаж, комната 122 |
Петров | Петр | Петрович | Сотовый телефон | 4 434 434 342 234 |
Петров | Петр | Петрович | Электронная почта | petr@mail.ru |
Для импорта выберите файл генерации пакета импорта в виде, который представлен в Таблице 1. Для первого листа в качестве класса приемника выберите справочник "Физические лица", для второго листа – справочник "Типы контактов", для третьего - элементы списков "БизнесМодель.КонтактыФизЛиц".
Введите название пакета импорта "Импорт физлиц с контактами".
Произведите настройку соответствий параметров справочника "Физические лица" колонкам листа "Лист 1" файла MS Excel.
Если не был выбран файл генерации, добавьте из контекстного меню новый этап для импорта физических лиц. Имя листа - "Лист 1." Класс приемник - класс "БизнесМодель.ФизЛица".
Допустим, что однозначным идентификатором физического лица является набор колонок Фамилия, Имя, Отчество.
Конечно, чтобы однозначно определить объект, этого может оказаться недостаточно. К параметрам "Фамилия", "Имя", "Отчество" возможно добавление таких параметров, как "Адрес", "Дата рождения", "Паспортные данные" - при их наличии и необходимости задания в качестве ключевых. В таком случае параметры "Адрес" и "Паспортные данные" могут являться объектными, то есть сложными параметрами, уже для объекта "Физическое лицо".
На вкладке Ключ задайте параметры "Фамилия", "Имя", "Отчество".
На вкладке Параметры задайте параметры "Дата рождения", "Комментарий".
Произведите настройку соответствий параметров справочника "Типы контактов" колонкам листа "Лист 2" файла MS Excel.
Если не был выбран файл генерации, добавьте из контекстного меню новый этап для импорта типов контактов. Имя листа - "Лист 2.". Класс приемник - класс "БизнесМодель.ТипыКонтактов".
Ключом для типа контакта будет его "Название". Добавьте его на вкладке Ключ.
Произведите настройку соответствий параметров класса "БизнесМодель.КонтактыФизлиц" колонкам листа "Лист 3" файла MS Excel.
Если не был выбран файл генерации, добавьте из контекстного меню новый этап для импорта контактов физических лиц. Имя листа - "Лист 3." Класс приемник - класс элементов списков "БизнесМодель.КонтактыФизЛиц".
Ключом для контакта будут объектные параметры "ТипКонтакта" и "Владелец" (то есть физическое лицо), у которого, в свою очередь, ключом является набор параметров "Фамилия", "Имя", "Отчество" (см. Принципы задания соответствий параметров).
Добавьте их на вкладке Ключ:
То есть любому сколь угодно сложному объектному параметру можно поставить в соответствие набор текстовых полей, указав "путь" до каждого. Дополнительные параметры у сложного параметра всегда являются ключевыми полями (позволяющие однозначно его идентифицировать). Также дополнительным параметром может являться объектный параметр, в свою очередь содержащий набор полей (опять же ключевых).
Ключом владельца будет набор параметров "Фамилия", "Имя", "Отчество" (классом владельцем является класс "БизнесМодель.ФизЛица"). Добавить этот набор параметров на вкладке Ключ владельца.
Дополнительным параметром (неключевым) является параметр "Контакт". Добавьте его на вкладке Параметры.
Сохраните внесенные изменения с помощью кнопки Сохранить.
В списке пакетов импорта выделите нужный пакет и нажмите на гиперссылку Импорт/Экспорт. Откроется окно Выполнение импорта (см. Выполнение импорта).