Здесь показаны различия между выбранной ревизией и текущей версией данной страницы.
ru:manual:export_import:customizable_data_exchange:import_package_setting:principals_of_conformity_settings [2020/12/16 14:47] aliev |
— (текущий) | ||
---|---|---|---|
Строка 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/principals_of_conformity_settings/change_principals_of_conformity_settings_1.png?nolink | Рисунок 1. Настройка соответствий между внешними параметрами и параметрами класса Business Studio }}] | ||
- | |||
- | Добавление, редактирование и удаление параметров происходит при помощи пунктов контекстного меню. Описание назначения его пунктов приведено в Таблице 1. | ||
- | |||
- | <startTableBox> | ||
- | ^ **Название пункта** ^ **Описание** ^ | ||
- | | **Добавить параметр** | Пункт меню предназначен для добавления простых параметров. Открывает окно выбора параметра. Если при загрузке был выбран файл для генерации, затем откроется окно выбора внешнего параметра. Добавляет новую строку в список параметров. | | ||
- | | **Добавить сложный параметр** | Пункт меню предназначен для упрощения добавления сложных параметров, которые не задаются в Business Studio в виде конкретных строковых параметров (например, если ключ состоит из трёх строковых параметров одного объектного параметра, как в примере из Принципы задания соответствий параметров). Вы также можете создать их вручную, редактируя объект колонки. Открывает окно выбора параметра, затем **Окно свойств** объекта колонки (см. [[ru/manual/export_import/customizable_data_exchange/import_package_setting/column_object_edit]]), добавляет выбранный объектный параметр в качестве значения параметра "Параметр", а конечный текстовый параметр - в новую строку вкладки "Список колонки" этого окна. Далее на этой вкладке можно добавить ещё строковые параметры. Описание задания соответствий приведено в данной статье ниже. | | ||
- | | **Свойства** | Открывает **Окно свойств** объекта колонки. | | ||
- | | **Удалить параметр** | Удаляет выделенную строку из списка параметров. | | ||
- | <endTableBox| Таблица 1. Контекстное меню параметров описания этапа импорта > | ||
- | |||
- | На примере данных, которые содержит Таблица 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/principals_of_conformity_settings/lang_principals_of_conformity_settings_2.png?nolink | Рисунок 2. Схема импорта в справочник "БизнесМодель.ФизЛица" }}] | ||
- | |||
- | Сначала необходимо импортировать физических лиц, поэтому первым этапом будет импорт строк из листа "Лист 1" в справочник "БизнесМодель.Физлица". Пусть в данном файле импорта по колонкам **Фамилия**, **Имя**, **Отчество** можно однозначно определить импортируемый объект. Тогда ключевыми параметрами объекта "Физлицо" будут поля "Фамилия", "Имя", "Отчество". Каждое из этих полей можно представить в виде конечной строки. Параметры "Дата рождения" и "Комментарий" не будут являться в данном случае ключевыми. Каждое из этих полей также можно представить в виде конечной строки. | ||
- | |||
- | В случае если уникальность по названию не соблюдается и ключ получается слишком сложный, можно использовать одно поле в качестве ключевого. Например, это может быть созданный для этих целей пользовательский параметр или параметр "guid". | ||
- | |||
- | == == | ||
- | **Внимание!** Параметр "guid" формируется системой автоматически при создании нового объекта. | ||
- | |||
- | Параметр "guid" должен быть уникальным для всех объектов системы. | ||
- | |||
- | Длина строкового параметра "guid" ограничена 40 символами. | ||
- | ==== ==== | ||
- | |||
- | Для ознакомления со структурой данных Business Studio предназначена **Объектная модель** (см. [[ru/manual/object_model|Объектная модель]]). | ||
- | |||
- | == == | ||
- | **Внимание!** Данные можно импортировать только в хранимые параметры. | ||
- | ==== ==== | ||
- | |||
- | В процессе импорта (Рис. 3) по ключевым параметрам "Фамилия", "Имя", "Отчество" в справочнике "БизнесМодель.Физлица" ищется объект. В случае если такой объект существует, произойдет обновление неключевых параметров "Дата рождения", "Комментарий". В случае если по ключевым параметрам объект не найден - будет создан новый объект. | ||
- | |||
- | [{{ ru/manual/export_import/customizable_data_exchange/import_package_setting/principals_of_conformity_settings/lang_principals_of_conformity_settings_3.png?nolink | Рисунок 3. Поиск объекта по ключевым параметрам }}] | ||
- | |||
- | Далее необходимо импортировать список контактов физических лиц. То есть вторым этапом будет импорт строк листа "Лист 2" в класс элементов списков "БизнесМодель.КонтактыФизЛиц" из листа "Лист 2" файла импорта. Владельцем списка "БизнесМодель.КонтактыФизЛиц" является справочник "БизнесМодель.Физлица". Ключ объекта справочника "БизнесМодель.Физлица" - набор простых параметров "Фамилия", "Имя", "Отчество". Таким образом, на данном этапе задается ключ владельца импортируемого объекта. | ||
- | |||
- | Однозначно определить контакт в файле импорта позволяет набор колонок **Фамилия**, **Имя**, **Отчество**, **Тип контакта**. Одним из ключевых параметров контакта является объектный параметр "Владелец", но его нельзя представить в виде конечной строки. Ключом параметра "Владелец" является набор параметров "Фамилия", "Имя", "Отчество", каждый из которых можно представить в виде конечной строки. Другим ключевым параметром контакта является объектный параметр "ТипКонтакта", который также нельзя представить в виде конечной строки. Однозначным идентификатором объекта "ТипКонтакта" является параметр "Название", который можно представить в виде конечной строки. | ||
- | |||
- | Таким образом ключом импортируемого объекта будет являться набор двух сложных параметров "Владелец\{Фамилия}{Имя}{Отчество}" и "ТипКонтакта\Название". | ||
- | |||
- | То есть любому сколь угодно сложному объектному параметру можно поставить в соответствие набор текстовых полей, указав "путь" до каждого. Дополнительные параметры у сложного параметра всегда являются ключевыми полями (позволяющими однозначно его идентифицировать). Также дополнительным параметром может являться объектный параметр, в свою очередь содержащий набор полей (опять же, ключевых). | ||
- | |||
- | Параметр "Контакт" не будет являться в данном случае ключевым. Поле **Контакт** можно представить в виде конечной строки. | ||
- | |||
- | На Рис. 4 представлена схема импорта контактов физических лиц на основе рассматриваемого примера. | ||
- | |||
- | [{{ ru/manual/export_import/customizable_data_exchange/import_package_setting/principals_of_conformity_settings/lang_principals_of_conformity_settings_4.png?nolink | Рисунок 4. Схема настройки пакета импорта для элементов списков "БизнесМодель.КонтактыФизЛиц" }}] | ||
- | |||
- | В процессе импорта из листа "Лист 2" в элементы списков "БизнесМодель.КонтактыФизЛиц" по ключевым параметрам "Фамилия", "Имя", "Отчество" в справочнике "БизнесМодель.Физлица" ищется владелец объекта импорта. В случае если владелец не найден - дальнейшее поведение зависит от состояния опции импорта "Пропускать объекты без Владельца", подробнее об опциях импорта см. [[ru/manual/export_import/customizable_data_exchange/import_package_setting/import_options]]. | ||
- | |||
- | Настройка соответствий для сложных параметров производится в **Окне свойств** объекта колонки, подробнее о работе с этим окном см. [[ru/manual/export_import/customizable_data_exchange/import_package_setting/column_object_edit]]. | ||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | [<contextnavigator>] | ||
- | |||