Это старая версия документа.


Принципы задания соответствий

Принципы настройки соответствия параметров на всех вкладках настройки пакета импорта схожи. Задается соответствие между параметром Business Studio и параметром внешней системы. В случае если в BusinessStudio используется объектный параметр, который нельзя однозначно привести к строковому параметру внешней системы, то задается соответствие на нижнем уровне только между простыми параметрами BusinessStudio и соответствующими им параметрами внешней системы.

В столбце  Внешний параметр в случае, если в качестве источника данных выбран файл MSExcel, указывается заголовок колонки листа. Значение нажатием на кнопку  или вводится вручную с клавиатуры (см. Рис 1). Выбор колонок листа из списка возможен только в случае, когда при создании пакета импорта был выбран файл генерации.

Внимание!

При вводе с клавиатуры необходимо учитывать, что название чувствительно к регистру.


Пример ввода названия колонки:

"ЗаголовокКолонки"  

В столбце Параметр указывается параметр класса Business Studio. Выбирается нажатием на кнопку .

 

Invalid Link
Рисунок 1. Настройка соответствий между внешними параметрами и параметрами класса Business Studio

Добавление, редактирование и удаление параметров происходит при помощи пунктов контекстного меню. Описание назначения его пунктов приведено в Таблице 1.

Название пункта Описание
Добавить параметр Пункт меню предназначен для добавления простых параметров. Открывает окно выбора параметра. Если при загрузке был выбран файл для генерации, затем откроется окно выбора внешнего параметра. Добавляет новую строку в список параметров.
Добавить сложный параметр Пункт меню предназначен для упрощения добавления сложных параметров, которые не задаются в Business Studio в виде конкретных строковых параметров (например, если ключ состоит из трёх строковых параметров одного объектного параметра, как в примере из Принципы задания соответствий параметров). Вы также можете создать их вручную, редактируя объект колонки. Открывает окно выбора параметра, затем Окно свойств объекта колонки, добавляет выбранный объектный параметр в качестве значения параметра "Параметр", а конечный текстовый параметр - в новую строку вкладки "Список колонки" этого окна. Далее на этой вкладке можно добавить ещё строковые параметры. Описание задания соответствий приведено в статье example_task_matching.
Свойства Открывает Окно редактирования объекта колонки (см. Окно редактирования объекта колонки).
Удалить параметр Удаляет выделенную строку из списка параметров.
Таблица 1. Контекстное меню параметров описания этапа импорта

На примере данных, которые содержит Таблица 1 из статьи Вид файла импорта, рассмотрим принципы задания соответствий параметров. На Рис. 2 представлена схема импорта физических лиц на основе рассматриваемого примера.

Invalid Link
Рисунок 2. Схема импорта в справочник "БизнесМодель.ФизЛица"

Сначала необходимо импортировать физических лиц, поэтому первым этапом будет импорт строк из листа "Лист 1" в справочник "БизнесМодель.Физлица". Пусть в данном файле импорта по колонкам ФамилияИмяОтчество можно однозначно определить импортируемый объект. Тогда ключевыми параметрами объекта "Физлицо" будут поля "Фамилия", "Имя", "Отчество". Каждое из этих полей можно представить в виде конечной строки. Параметры "Дата рождения" и "Комментарий" не будут являться в данном случае ключевыми. Каждое из этих полей также можно представить в виде конечной строки.

В случае если уникальность по названию не соблюдается и ключ получается слишком сложный, можно использовать одно поле в качестве ключевого. Например, это может быть созданный для этих целей пользовательский параметр или параметр "guid".

Внимание!

Параметр "guid" формируется системой автоматически при создании нового объекта. 

Параметр "guid" должен быть уникальным для всех объектов системы.

Длина строкового параметра "guid" ограничена 40 символами.

Для ознакомления со структурой данных Business Studio предназначена Объектная модель (см. Объектная модель).

Внимание!

Данные можно импортировать только в хранимые параметры.

В процессе импорта (Рис. 3) по ключевым параметрам "Фамилия", "Имя", "Отчество" в справочнике "БизнесМодель.Физлица" ищется объект. В случае если такой объект существует, произойдет обновление неключевых параметров "Дата рождения", "Комментарий". В случае если по ключевым параметрам объект не найден - будет создан новый объект.

Invalid Link
Рисунок 3. Поиск объекта по ключевым параметрам

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

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

Таким образом ключом импортируемого объекта будет являться набор двух сложных параметров "Владелец\{Фамилия}{Имя}{Отчество}" и "ТипКонтакта\Название".

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

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

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

Invalid Link
Рисунок 4. Схема настройки пакета импорта для элементов списков "БизнесМодель.КонтактыФизЛиц"

В процессе импорта из листа "Лист 2" в элементы списков "БизнесМодель.КонтактыФизЛиц" по ключевым параметрам "Фамилия", "Имя", "Отчество" в справочнике "БизнесМодель.Физлица" ищется владелец объекта импорта. В случае если владелец не найден - будет выдана ошибка и объект импортирован не будет.

Настройка соответствий для сложных параметров производится в Окне редактирования объекта колонки, подробнее о работе с этим окно см. Окно свойств объекта колонки.

Актуальные новости, публикации и практики для бизнес-архитекторов и аналитиков
Driven by DokuWiki