Различия

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

Ссылка на это сравнение

ru:manual:export_import:customizable_data_exchange:import_package_setting:import_steps_description:example_task_matching [2017/02/19 20:38]
belkin
— (текущий)
Строка 1: Строка 1:
-====== Принципы задания соответствий ====== 
- 
-Принципы настройки соответствия параметров на всех вкладках настройки пакета импорта схожи. Задается соответствие между параметром Business Studio и параметром внешней системы. В случае если в BusinessStudio используется объектный параметр, который нельзя однозначно привести к строковому параметру внешней системы, то задается соответствие на нижнем уровне только между простыми параметрами BusinessStudio и соответствующими им параметрами внешней системы. 
- 
-В столбце  **Внешний параметр** в случае, если в качестве источника данных выбран файл MSExcel, указывается заголовок колонки листа. Значение нажатием на кнопку {{common/3dot.png?nolink}} или вводится вручную с клавиатуры (см. Рис 1). Выбор колонок листа из списка возможен только в случае, когда при создании пакета импорта был выбран файл генерации. 
- 
-== Внимание! == 
-При вводе с клавиатуры необходимо учитывать, что название чувствительно к регистру. 
-==== ==== 
- 
-\\ Пример ввода названия колонки: 
- 
-"ЗаголовокКолонки" 
-  
- 
-В столбце **Параметр** указывается параметр класса Business Studio. Выбирается нажатием на кнопку {{common/3dot.png?nolink}}. 
- 
- [{{ ru/manual/export_import/customizable_data_exchange/import_package_setting/import_steps_description/import_steps_description_2.png?nolink | Рисунок 1. Настройка соответствий между внешними параметрами и параметрами класса Business Studio }}] 
- 
-Добавление, редактирование и удаление параметров происходит при помощи пунктов контекстного меню. Описание назначения его пунктов приведено в Таблице 1. 
- 
-<startTableBox> 
-^  **Название пункта**  ^  **Описание**  ^ 
-| **Добавить параметр** | Пункт меню предназначен для добавления простых параметров. Открывает окно выбора параметра. Если при загрузке был выбран файл для генерации, затем откроется окно выбора внешнего параметра. Добавляет новую строку в список параметров. | 
-| **Добавить сложный параметр** | Пункт меню предназначен для упрощения добавления сложных параметров, которые не задаются в Business Studio в виде конкретных строковых параметров (например, если ключ состоит из трёх строковых параметров одного объектного параметра, как в примере из Принципы задания соответствий параметров). Вы также можете создать их вручную, редактируя объект колонки. Открывает окно выбора параметра, затем **Окно свойств** объекта колонки, добавляет выбранный объектный параметр в качестве значения параметра "Параметр", а конечный текстовый параметр - в новую строку вкладки "Список колонки" этого окна. Далее на этой вкладке можно добавить ещё строковые параметры. Описание задания соответствий приведено в статье [[ru/manual/export_import/customizable_data_exchange/import_package_setting/import_steps_description/example_task_matching]]. | 
-| **Свойства** | Открывает **Окно** редактирования **объекта** **колонки (см.** Окно редактирования объекта колонки******)**. | 
-| **Удалить параметр** | Удаляет выделенную строку из списка параметров. | 
-<endTableBox| Таблица 2. Контекстное меню параметров описания этапа импорта > 
- 
-На примере данных, которые содержит Таблица 1 из статьи [[ru/manual/export_import/customizable_data_exchange/import_package_setting/import_file_view]], рассмотрим принципы задания соответствий параметров. На Рис. 2 представлена схема импорта физических лиц на основе рассматриваемого примера. 
- 
-[{{ ru/manual/export_import/customizable_data_exchange/import_package_setting/import_steps_description/example_task_matching/example_task_matching_1.png?nolink | Рисунок 2. Схема импорта в справочник "БизнесМодель.ФизЛица" }}] 
- 
-Сначала необходимо импортировать физических лиц, поэтому первым этапом будет импорт строк из листа "Лист 1" в справочник "БизнесМодель.Физлица". Пусть в данном файле импорта по колонкам **Фамилия**, **Имя**, **Отчество** можно однозначно определить импортируемый объект. Тогда ключевыми параметрами объекта "Физлицо" будут поля "Фамилия", "Имя", "Отчество". Каждое из этих полей можно представить в виде конечной строки. Параметры "Дата рождения" и "Комментарий" не будут являться в данном случае ключевыми. Каждое из этих полей также можно представить в виде конечной строки. 
- 
-В случае если уникальность по названию не соблюдается и ключ получается слишком сложный, можно использовать одно поле в качестве ключевого. Например, это может быть созданный для этих целей пользовательский параметр или параметр "guid". 
- 
-== Внимание! == 
-Параметр "guid" формируется системой автоматически при создании нового объекта.  
- 
-Параметр "guid" должен быть уникальным для всех объектов системы. 
- 
-Длина строкового параметра "guid" ограничена 40 символами. 
-==== ==== 
- 
-Для ознакомления со структурой данных Business Studio предназначена **Объектная модель** (см. [[ru/manual/report/object_model|Объектная модель]]). 
- 
-== Внимание! == 
- 
-Данные можно импортировать только в хранимые параметры. 
-====  ==== 
- 
-В процессе импорта (Рис. 3) по ключевым параметрам "Фамилия", "Имя", "Отчество" в справочнике "БизнесМодель.Физлица" ищется объект. В случае если такой объект существует, произойдет обновление неключевых параметров "Дата рождения", "Комментарий". В случае если по ключевым параметрам объект не найден - будет создан новый объект. 
- 
-[{{ ru/manual/export_import/customizable_data_exchange/import_package_setting/import_steps_description/example_task_matching/example_task_matching_2.png?nolink | Рисунок 3. Поиск объекта по ключевым параметрам }}] 
- 
-Далее необходимо импортировать список контактов физических лиц. То есть вторым этапом будет импорт строк листа "Лист 2" в класс элементов списков "БизнесМодель.КонтактыФизЛиц" из листа "Лист 2" файла импорта. Владельцем списка "БизнесМодель.КонтактыФизЛиц" является справочник "БизнесМодель.Физлица". Ключ объекта справочника "БизнесМодель.Физлица" - набор простых параметров "Фамилия", "Имя", "Отчество". Таким образом, на данном этапе задается ключ владельца импортируемого объекта. 
- 
-Однозначно определить контакт в файле импорта позволяет набор колонок **Фамилия**, **Имя**, **Отчество**, **Тип контакта**. Одним из ключевых параметров контакта является объектный параметр "Владелец", но его нельзя представить в виде конечной строки. Ключом параметра "Владелец" является набор параметров "Фамилия", "Имя", "Отчество", каждый из которых можно представить в виде конечной строки. Другим ключевым параметром контакта является объектный параметр "ТипКонтакта", который также нельзя представить в виде конечной строки. Однозначным идентификатором объекта "ТипКонтакта" является параметр "Название", который можно представить в виде конечной строки. 
- 
-Таким образом ключом импортируемого объекта будет являться набор двух сложных параметров "Владелец\{Фамилия}{Имя}{Отчество}" и "ТипКонтакта\Название". 
- 
-То есть любому сколь угодно сложному объектному параметру можно поставить в соответствие набор текстовых полей, указав "путь" до каждого. Дополнительные параметры у сложного параметра всегда являются ключевыми полями (позволяющими однозначно его идентифицировать). Также дополнительным параметром может являться объектный параметр, в свою очередь содержащий набор полей (опять же, ключевых). 
- 
-Параметр "Контакт" не будет являться в данном случае ключевым. Поле **Контакт** можно представить в виде конечной строки. 
- 
-На Рис. 4 представлена схема импорта контактов физических лиц на основе рассматриваемого примера. 
- 
-[{{ ru/manual/export_import/customizable_data_exchange/import_package_setting/import_steps_description/example_task_matching/example_task_matching_3.png?nolink | Рисунок 4. Схема настройки пакета импорта для элементов списков "БизнесМодель.КонтактыФизЛиц" }}] 
- 
-В процессе импорта из листа "Лист 2" в элементы списков "БизнесМодель.КонтактыФизЛиц" по ключевым параметрам "Фамилия", "Имя", "Отчество" в справочнике "БизнесМодель.Физлица" ищется владелец объекта импорта. В случае если владелец не найден - будет выдана ошибка и объект импортирован не будет. 
- 
-Настройка соответствий для сложных параметров производится в **Окне редактирования объекта колонки**, подробнее о работе с этим окно см. [[ru/manual/export_import/customizable_data_exchange/import_package_setting/column_object_edit]]. 
  
Актуальные новости, публикации и практики для бизнес-архитекторов и аналитиков
Driven by DokuWiki