Различия
Здесь показаны различия между выбранной ревизией и текущей версией данной страницы.
|
ru:manual:export_import:customizable_data_exchange:import_package_setting [2017/02/15 10:51] admin |
ru:manual:export_import:customizable_data_exchange:import_package_setting [2017/02/20 08:40] (текущий) |
||
|---|---|---|---|
| Строка 1: | Строка 1: | ||
| - | ===== Вид файла импорта ===== | + | ====== Настройка пакета импорта ====== |
| - | + | ||
| - | Импорт данных будем рассматривать на примере импорта из файла MS Excel, как самом распространённом. При этом описанное ниже применимо с определёнными поправками и для файлов других типов. | + | |
| - | + | ||
| - | + | ||
| - | + | ||
| - | Ниже рассмотрим требуемую для импорта структуру файла MS Excel. | + | |
| - | + | ||
| - | Файл импорта MS Excel может содержать несколько листов. Каждый лист файла - это отдельная таблица, обычно характеризующая отдельный справочник системы. Таким образом, из одного файла MS Excel можно загружать данные сразу в несколько справочников. Первая строка таблицы - перечень наименований полей. Затем идут значения этих полей. Количество записей равно количеству загружаемых объектов. | + | |
| - | + | ||
| - | Например, в Таблице 1 приведен пример файла MS Excel, где первый лист файла - это таблица физических лиц, в которой указаны поля **Фамилия**, **Имя**, **Отчество**, **Дата рождения**, **Комментарий** (данные справочника "Физические лица"). Второй лист файла - это таблица контактов физических лиц, в которой указаны поля **Тип контакта**, **Контакт** (данные справочника "Контакты ФизЛиц") и поля **Фамилия**, **Имя**, **Отчество** (для определения физического лица, к которому относится данный контакт). | + | |
| - | + | ||
| - | <startTableBox> | + | |
| - | ^ **Лист 1** ^^^^^ | + | |
| - | | Фамилия | Имя | Отчество | Дата рождения | Комментарий | | + | |
| - | | Иванов | Иван | Иванович | 29.09.1969 | Кандидат … | | + | |
| - | | Петров | Петр | Петрович | 04.05.1978 | | | + | |
| - | ^ **Лист 2** ^^^^^ | + | |
| - | | Фамилия | Имя | Отчество | Тип контакта | Контакт | | + | |
| - | | Иванов | Иван | Иванович | Этаж/Кабинет | 3 этаж, комната 122 | | + | |
| - | | Иванов | Иван | Иванович | Домашний телефон | 444333 | | + | |
| - | | Петров | Петр | Петрович | Этаж/Кабинет | 3 этаж, комната 122 | | + | |
| - | | Петров | Петр | Петрович | Сотовый телефон | 4 434 434 342 234 | | + | |
| - | | Петров | Петр | Петрович | Электронная почта | petr@mail.ru | | + | |
| - | <endTableBox| Таблица 1. Таблица 1. Файл импорта MS Excel> | + | |
| - | + | ||
| - | ===== Настройка пакета импорта ===== | + | |
| Создание и редактирование пакетов импорта осуществляется в справочнике "Пакет импорта". | Создание и редактирование пакетов импорта осуществляется в справочнике "Пакет импорта". | ||
| Строка 33: | Строка 7: | ||
| В **Окне справочника** "Пакет импорта" гиперссылки **Выполнить экспорт** и **Выполнить импорт** служат соответственно для экспорта и импорта данных по выбранному пакету импорта. | В **Окне справочника** "Пакет импорта" гиперссылки **Выполнить экспорт** и **Выполнить импорт** служат соответственно для экспорта и импорта данных по выбранному пакету импорта. | ||
| - | * [[ru/manual/export_import/customizable_data_exchange/import_package_setting/choose_datasourse]] | + | Импорт данных будем рассматривать на примере импорта из файла MS Excel, как самом распространённом. При этом описанное ниже применимо с определёнными поправками и для файлов других типов. |
| + | |||
| + | |||
| + | ===== В этом подразделе ===== | ||
| + | * [[ru/manual/export_import/customizable_data_exchange/import_package_setting/import_file_view]] | ||
| + | * [[ru/manual/export_import/customizable_data_exchange/import_package_setting/choose_datasourse]] | ||
| * [[ru/manual/export_import/customizable_data_exchange/import_package_setting/window_settings_import]] | * [[ru/manual/export_import/customizable_data_exchange/import_package_setting/window_settings_import]] | ||
| * [[ru/manual/export_import/customizable_data_exchange/import_package_setting/import_steps]] | * [[ru/manual/export_import/customizable_data_exchange/import_package_setting/import_steps]] | ||
| * [[ru/manual/export_import/customizable_data_exchange/import_package_setting/import_steps_description]] | * [[ru/manual/export_import/customizable_data_exchange/import_package_setting/import_steps_description]] | ||
| - | * [[ru/manual/export_import/customizable_data_exchange/import_package_setting/import_steps_description/example_task_matching]] | + | * [[ru/manual/export_import/customizable_data_exchange/import_package_setting/principals_of_conformity_settings]] |
| + | * [[ru/manual/export_import/customizable_data_exchange/import_package_setting/column_object_edit]] | ||
| * [[ru/manual/export_import/customizable_data_exchange/import_package_setting/import_graphic_data]] | * [[ru/manual/export_import/customizable_data_exchange/import_package_setting/import_graphic_data]] | ||
| - | * [[ru/manual/export_import/customizable_data_exchange/import_package_setting/column_object_edit]] | + | * [[ru/manual/export_import/customizable_data_exchange/import_package_setting/import_options]] |
| - | * [[ru/manual/export_import/customizable_data_exchange/import_package_setting/import_options]] | + | |
| - | + | ||
| - | ==== Выбор источника данных для генерации пакета импорта ==== | + | [<contextnavigator>] |
| - | + | ||
| - | При создании пакета выдается диалоговое окно с предложением "Выбрать источник данных для генерации пакета импорта". | + | |
| - | + | ||
| - | При согласии открывается окно для выбора типа источника данных из имеющихся вариантов. | + | |
| - | + | ||
| - | + | ||
| - | + | ||
| - | После выбора типа источника данных открывается диалоговое окно для выбора конкретного файла данного типа для получения перечня внешних классов и их свойств. В этом случае при редактировании пакета система позволит пользователю выбирать информацию из списков а не писать названия классов и параметров вручную. | + | |
| - | + | ||
| - | Например, в случае выбора варианта «Встроенный импорт из документов MS Excel» откроется окно для выбора файла MS Excel соответственно. Далее будут автоматически заполнены Этапы импорта по названиям листов выбранного файла; будет предложено выбрать классы приемники для каждого этапа; также будут заполнены списки колонок листа по первым строкам листов. В дальнейшем для заполнения параметра «Внешний класс» для этапов импорта, и параметра «Внешний параметр» в его описании можно будет использовать выбор из заполненных системой на этом этапе списков. | + | |
| - | + | ||
| - | При отказе от выбора файла открывается пустое **Окно свойств** пакета импорта. В этом случае добавление этапов импорта и заполнение полей колонок возможно только вручную. С принципами работы в Окне свойств пакета импорта можно ознакомиться ниже в пункте | + | |
| - | + | ||
| - | == Внимание! == | + | |
| - | При создании собственного пакета импорта рекомендуется выбирать файл для генерации. | + | |
| - | ==== ==== | + | |
| - | + | ||
| - | ==== Окно настройки пакета импорта ==== | + | |
| - | + | ||
| - | Настройка пакета импорта выполняется в **Окне свойств** пакета импорта (Рис. 2). | + | |
| - | + | ||
| - | [{{ ru/manual/export_import/customizable_data_exchange/import_package_setting/import_package_setting_3.png?nolink | Рисунок 2. **Окно свойств** пакета импорта }}] | + | |
| - | + | ||
| - | В поле **Название** вводится произвольное название пакета импорта. | + | |
| - | + | ||
| - | == Внимание! == | + | |
| - | Название пакета импорта должно быть уникальным. | + | |
| - | ==== ==== | + | |
| - | + | ||
| - | \\ Нажатие на кнопку **Импорт/Экспорт** открывает окно **Выполнение импорта** (см. [[ru//manual/cooperation/exchange#выполнение_импорта|Bыполнение импорта]]). | + | |
| - | + | ||
| - | ==== Этапы импорта ==== | + | |
| - | + | ||
| - | Этапы импорта разделяют импорт параметров по классам и устанавливают порядок импорта (Рис. 3). | + | |
| - | + | ||
| - | [{{ ru/manual/export_import/customizable_data_exchange/import_package_setting/import_package_setting_4.png?nolink | Рисунок 3. Этапы импорта }}] | + | |
| - | + | ||
| - | В поле **№** задается порядок выполнения этапа импорта. | + | |
| - | + | ||
| - | == Внимание! == | + | |
| - | Порядок выполнения этапов важен: в первую очередь необходимо загружать самостоятельные справочники, потом ссылающиеся на них списки и справочники. | + | |
| - | ==== ==== | + | |
| - | + | ||
| - | \\ В поле **Внешний класс** задается наименование внешнего классапараметра, например столбец базы данных или листа MS Excel, параметр фигуры MS Visio., например таблица базы данных, лист MS Excel или фигуры одного типа MS Visio. | + | |
| - | + | ||
| - | == Внимание! == | + | |
| - | Значения поля **Внешний параметр** чувствительны к регистру. Например, значения "Физлица" и "физлица" не являются идентичными. | + | |
| - | ==== ==== | + | |
| - | + | ||
| - | \\ В поле **Класс** задается класс (или справочник), в который будут импортироваться объекты на данном этапе. | + | |
| - | + | ||
| - | Добавление нового этапа происходит из контекстного меню. При этом откроется окно выбора источника (список листов, которые содержались в файле генерации, если он был выбран при создании пакета), затем окно выбора класса приемника. Поле **№** заполняется автоматически, при необходимости его значение можно изменить. | + | |
| - | + | ||
| - | + | ||
| - | + | ||
| - | == Внимание! == | + | |
| - | Обязательно соблюдение порядка этапов импорта. Для списков сначала импортируются справочники, являющиеся их владельцами. В случае если владелец найден, будет произведен поиск объекта справочника элементов списоков (в рассматриваемом примере - "БизнесМодель.КонтактыФизЛиц") по ключевым параметрам. Далее импорт идет аналогично импорту справочников. Если объект по ключевым параметрам найден, будет произведено обновление неключевых параметров ("Контакт" в данном случае). В случае, если при импорте владелец объекта по ключу не будет найден, то дальнейшее поведение зависит от состояния опции импорта «Пропускать объекты без Владельца», подробнее об опциях импорта см. Опции импорта | + | |
| - | + | ||
| - | При импорте иерархических справочников первым этапом должны импортироваться объекты-родители, потом объекты-потомки. В процессе импорта иерархического справочника ищется родитель объекта импорта. В случае если при импорте родитель объекта по ключу не будет найден, то дальнейшее поведение зависит от состояния опции импорта «Создавать объекты в корне, если не найден родитель», подробнее об опциях импорта см. Опции импорта если родитель не найден, будет выдана ошибка и объект импортирован не будет. | + | |
| - | ==== ==== | + | |
| - | + | ||
| - | + | ||
| - | ==== Описание этапа импорта и принципы задания соответствий ==== | + | |
| - | + | ||
| - | После создания этапа необходимо описать его, т.е. настроить соответствия между внешними параметрами и параметрами Business Studio. В зависимости от вида класса приемника описание этапов импорта содержит несколько вкладок (Рис. 4). | + | |
| - | + | ||
| - | [{{ ru/manual/export_import/customizable_data_exchange/import_package_setting/import_package_setting_5.png?nolink | Рисунок 4. Вкладка **Ключ** }}] | + | |
| - | + | ||
| - | Перечень вкладок окна и их назначение приведены в Таблице 2. | + | |
| - | + | ||
| - | | **Название вкладки** | **Описание** | | + | |
| - | | *Ключ | Заполнение вкладки обязательно. Ключ это совокупность параметров справочника, позволяющих однозначно идентифицировать запись. В Business Studio ключом любого справочника является GUID (глобальный уникальный идентификатор). Когда задание таких ключей во внешних программах не всегда удобно, ключом может выступать набор параметров. Например, для справочника "Физические лица" ключевыми параметрами могут быть "Фамилия", "Имя", "Отчество". Если по указанному ключу будет обнаружено несколько объектов, в процессе импорта будет выдана ошибка. В таком случае необходимо расширить набор ключевых параметров. | | + | |
| - | | *Ключ родителя | Появляется только для иерархических справочников. Заполнение вкладки для них обязательно. На вкладке могут указывается имя колонки с признаком группы (возможные значения: Да, Нет) и умолчание для ситуаций, когда в файле импорта колонка с признаком группы не найдена или её значение не заполнено. Обязательно задаются ключевые параметры объекта-родителя для объекта импорта. Если при импорте родитель объекта по ключу не будет найден, то дальнейшее поведение зависит от состояния опции импорта «Создавать объекты в корне, если не найден родитель», подробнее об опциях импорта см. Опции импорта | | + | |
| - | | *Ключ владельца | Появляется только для справочников из Элементов списков. Заполнение вкладки для них обязательно. На вкладке задаются ключевые параметры класса-владельца списка. Например, для списка "БизнесМодель.КонтактыФизЛиц" классом владельцем является класс "БизнесМодель.ФизическиеЛица". Владельца класса можно узнать из объектной модели, выбрав в контекстном меню элементов списков пункт **Перейти к владельцу**. Если при импорте владелец объекта по ключу не будет найден, то дальнейшее поведение зависит от состояния опции импорта «Пропускать объекты без Владельца», подробнее об опциях импорта см. Опции импорта | | + | |
| - | | Параметры | Не является обязательной для заполнения. На вкладке задаются соответствия между дополнительными (неключевыми) параметрами класса. Значения параметров существующих объектов в базе данных будут перезаписаны, если по ключу был найден объект, существовавший ранее. | | + | |
| - | | Графический импорт | Не является обязательной для заполнения. Вкладка для настройки импорта графической информации, подробнее см. **Импорт графических данных** | | + | |
| - | + | ||
| - | + | ||
| - | Принципы настройки соответствия параметров на всех вкладках настройки пакета импорта схожи. Задается соответствие между параметром Business Studio и параметром внешней системы. В случае если в BusinessStudio используется объектный параметр, который нельзя однозначно привести к строковому параметру внешней системы, то задается соответствие на нижнем уровне только между простыми параметрами BusinessStudio и соответствующими им параметрами внешней системы. | + | |
| - | + | ||
| - | В столбце **Внешний параметр** в случае, если в качестве источника данных выбран файл MSExcel, указывается заголовок колонки листа. Значение нажатием на кнопку {{Настройка%20пакета%20импорта.files:image006.png?17x17|http://byte_srv:8080/lib/exe/fetch.php/common/3dot.png}} или вводится вручную с клавиатуры (см. Рис 9). Выбор колонок листа из списка возможен только в случае, когда при создании пакета импорта был выбран файл генерации. | + | |
| - | + | ||
| - | == Внимание! == | + | |
| - | При вводе с клавиатуры необходимо учитывать, что название чувствительно к регистру. | + | |
| - | ==== ==== | + | |
| - | + | ||
| - | \\ Пример ввода названия колонки: | + | |
| - | + | ||
| - | "ЗаголовокКолонки" | + | |
| - | + | ||
| - | + | ||
| - | + | ||
| - | В столбце **Параметр** указывается параметр класса Business Studio. Выбирается нажатием на кнопку {{common/3dot.png?nolink}}. | + | |
| - | + | ||
| - | [{{ ru/manual/export_import/customizable_data_exchange/import_package_setting/import_package_setting_6.png?nolink | Рисунок 9. Настройка соответствий между внешними параметрами и параметрами класса Business Studio }}] | + | |
| - | + | ||
| - | Добавление, редактирование и удаление параметров происходит при помощи пунктов контекстного меню. Описание назначения его пунктов приведено в Таблице 2. | + | |
| - | + | ||
| - | <startTableBox> | + | |
| - | ^ **Название пункта** ^ **Описание** ^ | + | |
| - | | **Добавить параметр** | Пункт меню предназначен для добавления простых параметров. Открывает окно выбора параметра. Если при загрузке был выбран файл для генерации, затем откроется окно выбора внешнего параметра. Добавляет новую строку в список параметров. | | + | |
| - | | **Добавить сложный параметр** | Пункт меню предназначен для упрощения добавления сложных параметров, которые не задаются в Business Studio в виде конкретных строковых параметров (например, если ключ состоит из трёх строковых параметров одного объектного параметра, как в примере из Принципы задания соответствий параметров). Вы также можете создать их вручную, редактируя объект колонки. Открывает окно выбора параметра, затем **Окно свойств** объекта колонки, добавляет выбранный объектный параметр в качестве значения параметра «Параметр», а конечный текстовый параметр - в новую строку вкладки «Список колонки» этого окна. Далее на этой вкладке можно добавить ещё строковые параметры. Описание задания соответствий приведено в статье [[ru//manual/cooperation/exchange#принципы_задания_соответствий_параметров|Принципы задания соответствий параметров]]. | | + | |
| - | | **Свойства** | Открывает **Окно** редактирования **объекта** **колонки (см.** Окно редактирования объекта колонки******)**. | | + | |
| - | | **Удалить параметр** | Удаляет выделенную строку из списка параметров. | | + | |
| - | <endTableBox| Таблица 2. Контекстное меню параметров описания этапа импорта > | + | |
| - | + | ||
| - | Принципы задания соответствий также показаны на примере ниже, см. Пример задания соответствий | + | |
| - | + | ||
| - | === Пример задания соответствий === | + | |
| - | + | ||
| - | На примере данных, которые содержит Таблица 1, рассмотрим принципы задания соответствий параметров. На Рис. 2 представлена схема импорта физических лиц на основе рассматриваемого примера. | + | |
| - | + | ||
| - | [{{ ru/manual/export_import/customizable_data_exchange/import_package_setting/import_package_setting_7.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_package_setting_8.png?nolink | Рисунок 3. Поиск объекта по ключевым параметрам }}] | + | |
| - | + | ||
| - | Далее необходимо импортировать список контактов физических лиц. То есть вторым этапом будет импорт строк листа "Лист 2" в класс элементов списков "БизнесМодель.КонтактыФизЛиц" из листа "Лист 2" файла импорта. Владельцем списка "БизнесМодель.КонтактыФизЛиц" является справочник "БизнесМодель.Физлица". Ключ объекта справочника "БизнесМодель.Физлица" - набор простых параметров "Фамилия", "Имя", "Отчество". Таким образом, на данном этапе задается ключ владельца импортируемого объекта. | + | |
| - | + | ||
| - | Однозначно определить контакт в файле импорта позволяет набор колонок **Фамилия**, **Имя**, **Отчество**, **Тип контакта**. Одним из ключевых параметров контакта является объектный параметр "Владелец", но его нельзя представить в виде конечной строки. Ключом параметра "Владелец" является набор параметров "Фамилия", "Имя", "Отчество", каждый из которых можно представить в виде конечной строки. Другим ключевым параметром контакта является объектный параметр "ТипКонтакта", который также нельзя представить в виде конечной строки. Однозначным идентификатором объекта "ТипКонтакта" является параметр "Название", который можно представить в виде конечной строки. | + | |
| - | + | ||
| - | Таким образом ключом импортируемого объекта будет являться набор двух сложных параметров "Владелец\{Фамилия}{Имя}{Отчество}" и "ТипКонтакта\Название". | + | |
| - | + | ||
| - | То есть любому сколь угодно сложному объектному параметру можно поставить в соответствие набор текстовых полей, указав "путь" до каждого. Дополнительные параметры у сложного параметра всегда являются ключевыми полями (позволяющими однозначно его идентифицировать). Также дополнительным параметром может являться объектный параметр, в свою очередь содержащий набор полей (опять же, ключевых). | + | |
| - | + | ||
| - | Параметр "Контакт" не будет являться в данном случае ключевым. Поле **Контакт** можно представить в виде конечной строки. | + | |
| - | + | ||
| - | На Рис. 4 представлена схема импорта контактов физических лиц на основе рассматриваемого примера. | + | |
| - | + | ||
| - | [{{ ru/manual/export_import/customizable_data_exchange/import_package_setting/import_package_setting_9.png?nolink | Рисунок 4. Схема настройки пакета импорта для элементов списков "БизнесМодель.КонтактыФизЛиц" }}] | + | |
| - | + | ||
| - | В процессе импорта из листа "Лист 2" в элементы списков "БизнесМодель.КонтактыФизЛиц" по ключевым параметрам "Фамилия", "Имя", "Отчество" в справочнике "БизнесМодель.Физлица" ищется владелец объекта импорта. В случае если владелец не найден - будет выдана ошибка и объект импортирован не будет. | + | |
| - | + | ||
| - | Пример создания пакета импорта с настройкой соответствий для сложных параметров описан в главе [[ru/manual/sample_questions/example_packet_import|Пример создания пакета импорта]]. | + | |
| - | + | ||
| - | ==== Импорт графических данных ==== | + | |
| - | + | ||
| - | Импорт графических данных позволяет импортировать графическую информацию, т.е. создает диаграмму (или диаграммы) со всеми объектами и связями. Настройка такого импорта производится на вкладке **Графический импорт** в области описания этапа импорта (см. Рис. 11). | + | |
| - | + | ||
| - | Обычно импорт графических данных ведётся в конкретные справочники группы «База.СтруктураФайла». | + | |
| - | + | ||
| - | [{{ ru/manual/export_import/customizable_data_exchange/import_package_setting/import_package_setting_10.png?nolink | Рисунок 11. Вкладка **Графический импорт** }}] | + | |
| - | + | ||
| - | == Внимание! == | + | |
| - | Все объекты (в том числе объекты, в которых находятся диаграммыкоторых мы будем импортировать) и связи должны быть уже созданы на момент графического этапа, иначе при открытии диаграммы присутствующие на ней в графическом виде, но отсутствующие в базе данных объекты будут удалены или вызовут ошибки. Исключением являются некоторые связи, объекты из справочника «Список свойств элементов диаграмм», которые требуют загрузки с помощью дополнительного этапа после этапа графического импорта, так как для полноценной работы они требуют информацию об Id созданных на диаграмме фигур. | + | |
| - | ==== ==== | + | |
| - | + | ||
| - | == Внимание! == | + | |
| - | + | ||
| - | С помощью команд «Добавить строку соответствия» и «Удалить строку соответствия» контекстного меню, вызываемого от области задания соответствий, можно добавлять и удалять строки этих соответствий. | + | |
| - | ==== ==== | + | |
| - | + | ||
| - | При добавлении строки на первом этапе предлагается указать наименованием внешней фигуры, а на втором -- выбрать соответствующую ей фигуру Business Studio. | + | |
| - | + | ||
| - | Каждая строка соответствия -- это объект колонки, поэтому в работе с ней применимы механизмы, описанные в п. Окно редактирования объекта колонки | + | |
| - | + | ||
| - | + | ||
| - | + | ||
| - | ==== Окноредактирования объекта колонки ==== | + | |
| - | + | ||
| - | Объект колонки задает соответствие между внешним параметром (например, колонкой листа MS Excel) и параметром класса Business Studio. Если соответствия носят сложный, многоуровневый характер и имеют дополнительные опции, то настраивать их надо через форму Объекта колонки. Для простых соответствий настройка осуществляется через форму Пакета импорта (в этом случае в колонке «Параметр» значение выбирается в окне выбора, вызываемом по кнопке {{common/3dot.png?nolink}} в правой части поля ввода значения). | + | |
| - | + | ||
| - | Настройка дополнительных параметров для сложного параметра выполняется в **Окне редактирования** объекта колонки (**Контекстное меню строки** списка параметров импорта → **Свойства**) (Рис. 10). | + | |
| - | + | ||
| - | [{{ ru/manual/export_import/customizable_data_exchange/import_package_setting/import_package_setting_11.png?nolink | Рисунок 10. **Окно редактирования** объекта колонки }}] | + | |
| - | + | ||
| - | В поле **Название** указан уникальный идентификатор колонки импорта. | + | |
| - | + | ||
| - | Путь до корневого параметра указан в поле **Параметр**. | + | |
| - | + | ||
| - | Перечень параметров, представленных в **Окне свойств** объекта колонки и их описание приведены в Таблице 3. | + | |
| - | + | ||
| - | + | ||
| - | <startTableBox> | + | |
| - | ^ **Название пункта** ^ **Описание** ^ | + | |
| - | | Название | Поле содержит уникальный идентификатор колонки импорта, генерируемый системой автоматически. | | + | |
| - | | Внешний параметр | Если **Окно свойств** объекта колонки параметров вызвано от простого параметра, то поле содержит наименование внешнего параметра (для MS Excel -- заголовок колонки листа), если от сложного -- поле не заполнено. | | + | |
| - | | Параметр | Если **Окно свойств** объекта колонки параметров вызвано от простого параметра, то поле содержит наименование конечного параметра Business Studio, если от сложного -- наименование объектного параметра, в этом случае соответствия по конечным параметрам указываются на вкладке **Список колонки**. | | + | |
| - | | Значение по умолчанию | Значение, которым будет заполнен параметр класса Business Studio по умолчанию при отсутствующем значении внешнего параметра или отсутствии самого внешнего параметра. Следует учитывать, что механизм значения по умолчанию работает только с параметрами простого типа (не объектными). | | + | |
| - | | Перевод значений | Для простых параметров. Открывает окно выбора объекта из справочника «Переводы значений импорта». В **Окне свойств** объектов данного справочника можно задать на вкладке Перевод значений правила перевода значений внешнего параметра из файла-источника данных в значения параметра Business Studio. Перевод значений целесообразно применять в случаях, когда терминология в программе-источнике данных и Business Studio отличается. Например, если в источнике данных тип контакта называется «E-Mail», а в Business Studio -- «Электронная почта», то настройки правила перевода будут следующими: {{ru/manual/export_import/customizable_data_exchange/import_package_setting/import_package_setting_12.png?nolink}} | | + | |
| - | | Условие значения колонки | Для простых параметров. В поле задаётся условие на значение внешнего параметра. Если условие выполняется -- значение внешнего параметра загружается в соответствующий параметр Business Studio. Если условие не выполняется: 1. Для параметров из состава ключа -- объект с таким значением внешнего параметра не будет импортирован в Business Studio. 2. Для параметров не из состава ключа - объект с таким значением внешнего параметра будет импортирован в Business Studio, но значение соответствующего этому внешнему параметру параметра Business Studio останется пустым. В качестве значения этого поля можно применять как конкретные значения (если их несколько, они разделяются символом «%%|%%»), так и регулярные выражения (подробнее с синтаксисом регулярных выражений можно ознакомиться [[https://ru.wikipedia.org/wiki/%D0%A0%D0%B5%D0%B3%D1%83%D0%BB%D1%8F%D1%80%D0%BD%D1%8B%D0%B5_%D0%B2%D1%8B%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D1%8F#.D0.A1.D0.B8.D0.BD.D1.82.D0.B0.D0.BA.D1.81.D0.B8.D1.81|в соответствующей статье]][[https://ru.wikipedia.org/wiki/%D0%A0%D0%B5%D0%B3%D1%83%D0%BB%D1%8F%D1%80%D0%BD%D1%8B%D0%B5_%D0%B2%D1%8B%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D1%8F#.D0.A1.D0.B8.D0.BD.D1.82.D0.B0.D0.BA.D1.81.D0.B8.D1.81| Википедии]]). Пример условия с конкретными значениями (удовлетворяют те объекты, у которых значение внешнего параметр «Фамилия» - Иванов или Петров): **Иванов%%|%%Петров** Пример условия с использованием регулярного выражения (удовлетворяют те объекты, у в значении внешнего параметра «Фамилия» нет цифр -- проверка корректности импортируемой информации): **/****d** | | + | |
| - | <endTableBox| Таблица 3. Параметры **Окна свойств** объекта колонки > | + | |
| - | + | ||
| - | == Внимание! == | + | |
| - | Необходимо учитывать порядок осуществления операций с импортируемыми данными: если для параметра одновременно значения всех или нескольких из числа полей «Перевод значений», «Условие значения колонки», «Значение по умолчанию» то сначала происходит перевод значений в соответствии с заданным в поле «Перевод значений», затем проверка на соответствие полученной в результате перевода строки установленным в поле «Условие значения колонки» условиям, а после этого, если требуется, установка значений по умолчанию. | + | |
| - | ==== ==== | + | |
| - | + | ||
| - | Перечень соответствий конечных параметров сложного параметра задаётся на вкладке «Список колонки», при задании соответствий здесь действуют те же правила и ограничения, что и при задании соответствий для простых параметров, см. Настройка соответствий между параметрами файла-источника данных и параметрами класса Business Studio. | + | |
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | ||
| - | ==== Опции импорта ==== | + | |
| - | + | ||
| - | Опции импорта позволяют управлять правилами импорта данных в нестандартных ситуациях. | + | |
| - | + | ||
| - | Параметр «Опции импорта» может быть выведен на показ в справочнике «Пакеты импорта» с помощью пункта меню **Действия** -> **Настройка колонок**. | + | |
| - | + | ||
| - | Для получения возможности редактировать значения перечисления из Окна справочника нужно включить опцию **Редактирование параметров объектов** из меню **Действия**. Если эта опция включена, опции пакета можно редактировать в выпадающем списке (о работе с выпадающими списками см. [[ru//manual/interface/options#значение_множество|http://byte_srv:8080/doku.php/ru/manual/interface/options#значение_множество]]). | + | |
| - | + | ||
| - | После редактирования опций следует сохранить пакет импорта по соответствующей кнопке в верней части Окна справочника пакетов импорта. | + | |
| - | + | ||
| - | Описание работы опций импорта приведено в таблице ниже. По умолчанию для новых пакетов опции импорта отключены. | + | |
| - | + | ||
| - | + | ||
| - | ^ **Название опции импорта** ^ **Описание** ^ | + | |
| - | | Пропускать объекты без Владельца | Опция определяет, как пройдёт импорт этапа в случае, если в рамках него делается попытка импортировать объекты, владельцы которых не найдены в базе по ключу со вкладки «Ключ владельца» пакета импорта: · Если опция включена -- объекты, владельцы которых не найдены в базе по ключу со вкладки «Ключ владельца» пакета импорта, не будут импортированы, а остальные объекты будут импортированы. · Если опция отключена -- все объекты, которые должны были импортироваться на данном этапе импорта, не будут импортированы. | | + | |
| - | | Создавать объекты в корне, если не найден Родитель | Опция определяет, как пройдёт импорт этапа в случае, если в рамках него делается попытка импортировать объекты, родители которых не найдены в базе по ключу со вкладки «Ключ родителя» пакета импорта: · Если опция включена - объекты, родители которых не найдены в базе по ключу со вкладки «Ключ родителя» пакета импорта, будут импортированы в корень справочника, остальные объекты будут импортированы в качестве потомков для найденных в базе владельцев. · Если опция отключена - объекты, родители которых не найдены в базе по ключу со вкладки «Ключ родителя» пакета импорта, не будут импортированы, а остальные объекты будут импортированы в качестве потомков для найденных в базе владельцев. | | + | |
| - | | Пропускать объекты, если не найдены ссылки | Опция определяет, как пройдёт импорт этапа в случае, если в рамках него делается попытка импортировать объекты, для которых не получается найти объект для импорта значения в соответствии с настройками вкладки «Параметры» пакета импорта: · Если опция включена -- объекты, для которых не получается найти объект для импорта значения в соответствии с настройками вкладки «Параметры» пакета импорта, не будут импортированы, а остальные объекты будут импортированы. · Если опция отключена - все объекты, которые должны были импортироваться на данном этапе импорта, не будут импортированы. | | + | |
