Различия

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

--- ru:manual:export_import:customizable_data_exchange:import_package_setting:import_steps_description [2017/02/15 11:07]
admin создано
+++ ru:manual:export_import:customizable_data_exchange:import_package_setting:import_steps_description [2017/02/20 08:40] (текущий)
@@ Строка 1: / Строка 1: @@
-====== Описание этапа импорта и принципы задания соответствий ======
+====== Описание этапа импорта ======
 После создания этапа необходимо описать его, т.е. настроить соответствия между внешними параметрами и параметрами Business Studio. В зависимости от вида класса приемника описание этапов импорта содержит несколько вкладок (Рис. 1).
@@ Строка 7: / Строка 7: @@
 Перечень вкладок окна и их назначение приведены в Таблице 1.
-| **Название вкладки** | **Описание** |
+<startTableBox>
-| *Ключ | Заполнение вкладки обязательно. Ключ это совокупность параметров справочника, позволяющих однозначно идентифицировать запись. В Business Studio ключом любого справочника является GUID (глобальный уникальный идентификатор). Когда задание таких ключей во внешних программах не всегда удобно, ключом может выступать набор параметров. Например, для справочника "Физические лица" ключевыми параметрами могут быть "Фамилия", "Имя", "Отчество". Если по указанному ключу будет обнаружено несколько объектов, в процессе импорта будет выдана ошибка. В таком случае необходимо расширить набор ключевых параметров. |
+^  **Название вкладки**  ^  **Описание**  ^
-| *Ключ родителя | Появляется только для иерархических справочников. Заполнение вкладки для них обязательно. На вкладке могут указывается имя колонки с признаком группы (возможные значения: Да, Нет) и умолчание для ситуаций, когда в файле импорта колонка с признаком группы не найдена или её значение не заполнено. Обязательно задаются ключевые параметры объекта-родителя для объекта импорта. Если при импорте родитель объекта по ключу не будет найден, то дальнейшее поведение зависит от состояния опции импорта «Создавать объекты в корне, если не найден родитель», подробнее об опциях импорта см. Опции импорта |
+| **Ключ** | Заполнение вкладки обязательно. Ключ это совокупность параметров справочника, позволяющих однозначно идентифицировать запись. В Business Studio ключом любого справочника является GUID (глобальный уникальный идентификатор). Когда задание таких ключей во внешних программах не всегда удобно, ключом может выступать набор параметров. Например, для справочника "Физические лица" ключевыми параметрами могут быть "Фамилия", "Имя", "Отчество". Если по указанному ключу будет обнаружено несколько объектов, в процессе импорта будет выдана ошибка. В таком случае необходимо расширить набор ключевых параметров. |
-| *Ключ владельца | Появляется только для справочников из Элементов списков. Заполнение вкладки для них обязательно. На вкладке задаются ключевые параметры класса-владельца списка. Например, для списка "БизнесМодель.КонтактыФизЛиц" классом владельцем является класс "БизнесМодель.ФизическиеЛица". Владельца класса можно узнать из объектной модели, выбрав в контекстном меню элементов списков пункт **Перейти к владельцу**. Если при импорте владелец объекта по ключу не будет найден, то дальнейшее поведение зависит от состояния опции импорта «Пропускать объекты без Владельца», подробнее об опциях импорта см. Опции импорта |
+| **Ключ родителя** | Появляется только для иерархических справочников. Заполнение вкладки для них обязательно. На вкладке могут указывается имя колонки с признаком группы (возможные значения: Да, Нет) и умолчание для ситуаций, когда в файле импорта колонка с признаком группы не найдена или её значение не заполнено. Обязательно задаются ключевые параметры объекта-родителя для объекта импорта. Если при импорте родитель объекта по ключу не будет найден, то дальнейшее поведение зависит от состояния опции импорта "Создавать объекты в корне, если не найден родитель", подробнее об опциях импорта см. Опции импорта |
-| Параметры | Не является обязательной для заполнения. На вкладке задаются соответствия между дополнительными (неключевыми) параметрами класса. Значения параметров существующих объектов в базе данных будут перезаписаны, если по ключу был найден объект, существовавший ранее. |
+| **Ключ владельца** | Появляется только для справочников из Элементов списков. Заполнение вкладки для них обязательно. На вкладке задаются ключевые параметры класса-владельца списка. Например, для списка "БизнесМодель.КонтактыФизЛиц" классом владельцем является класс "БизнесМодель.ФизическиеЛица". Владельца класса можно узнать из объектной модели, выбрав в контекстном меню элементов списков пункт **Перейти к владельцу**. Если при импорте владелец объекта по ключу не будет найден, то дальнейшее поведение зависит от состояния опции импорта "Пропускать объекты без Владельца", подробнее об опциях импорта см. Опции импорта |
+| **Параметры** | Не является обязательной для заполнения. На вкладке задаются соответствия между дополнительными (неключевыми) параметрами класса. Значения параметров существующих объектов в базе данных будут перезаписаны, если по ключу был найден объект, существовавший ранее. |
 | Графический импорт | Не является обязательной для заполнения. Вкладка для настройки импорта графической информации, подробнее см. **Импорт графических данных** |
+<endTableBox| Таблица 1. Перечень вкладок окна и их назначение >
+Принципы задания соответствий описаны в статье [[ru/manual/export_import/customizable_data_exchange/import_package_setting/principals_of_conformity_settings]].
+[<contextnavigator>]
-Принципы настройки соответствия параметров на всех вкладках настройки пакета импорта схожи. Задается соответствие между параметром Business Studio и параметром внешней системы. В случае если в BusinessStudio используется объектный параметр, который нельзя однозначно привести к строковому параметру внешней системы, то задается соответствие на нижнем уровне только между простыми параметрами BusinessStudio и соответствующими им параметрами внешней системы.
-В столбце  **Внешний параметр** в случае, если в качестве источника данных выбран файл MSExcel, указывается заголовок колонки листа. Значение нажатием на кнопку {{common/3dot.png?nolink}} или вводится вручную с клавиатуры (см. Рис 2). Выбор колонок листа из списка возможен только в случае, когда при создании пакета импорта был выбран файл генерации.
-== Внимание! ==
-При вводе с клавиатуры необходимо учитывать, что название чувствительно к регистру.
-==== ====
-\\ Пример ввода названия колонки:
-"ЗаголовокКолонки"
-В столбце **Параметр** указывается параметр класса 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 | Рисунок 2. Настройка соответствий между внешними параметрами и параметрами класса Business Studio }}]
-Добавление, редактирование и удаление параметров происходит при помощи пунктов контекстного меню. Описание назначения его пунктов приведено в Таблице 1.
-<startTableBox>
-^ **Название пункта** ^ **Описание** ^
-| **Добавить параметр** | Пункт меню предназначен для добавления простых параметров. Открывает окно выбора параметра. Если при загрузке был выбран файл для генерации, затем откроется окно выбора внешнего параметра. Добавляет новую строку в список параметров. |
-| **Добавить сложный параметр** | Пункт меню предназначен для упрощения добавления сложных параметров, которые не задаются в Business Studio в виде конкретных строковых параметров (например, если ключ состоит из трёх строковых параметров одного объектного параметра, как в примере из Принципы задания соответствий параметров). Вы также можете создать их вручную, редактируя объект колонки. Открывает окно выбора параметра, затем **Окно свойств** объекта колонки, добавляет выбранный объектный параметр в качестве значения параметра «Параметр», а конечный текстовый параметр - в новую строку вкладки «Список колонки» этого окна. Далее на этой вкладке можно добавить ещё строковые параметры. Описание задания соответствий приведено в статье [[ru//manual/cooperation/exchange#принципы_задания_соответствий_параметров|Принципы задания соответствий параметров]]. |
-| **Свойства** | Открывает **Окно** редактирования **объекта** **колонки (см.** Окно редактирования объекта колонки******)**. |
-| **Удалить параметр** | Удаляет выделенную строку из списка параметров. |
-<endTableBox| Таблица 1. Контекстное меню параметров описания этапа импорта >
-Принципы задания соответствий также показаны на примере ниже, см. статью "Пример задания соответствий" ниже.
-\\
-  * [[ru/manual/export_import/customizable_data_exchange/import_package_setting/import_steps_description/example_task_matching]]