Конвертация данных 3.0. Настройка правил конвертации в формате Enterprise Data. Пример использования

Задача

Передать информацию о контрагентах из УП в БП. Данные передаются в одностороннем порядке, идентификация производится по уникальному идентификатору.Настройка правил конвертации выполняется с помощью специальной конфигурации Конвертация данных, редакция 3.0 (далее – КД 3.0).

Выполняемые действия

Этап 1. Подготовка к настройке правил.

Для настройки правил конвертации в конфигурации КД 3.0 должны содержаться сведения о структуре информационных баз, между которыми производится синхронизация данных, а также о структуре формата Enterprise Data.

Шаг 1. Выгрузка структуры информационных баз УП и БП.

Для выгрузки информации о структуре информационной базы используется обработкаMD83Exp.epf, входящая в комплект поставки конфигурации КД 3.0.

Для каждой информационной базы (УП и БП) необходимо выполнить следующие действия:

1. Открыть информационную базу в режиме “Предприятие”.
2. Открыть внешнюю обработку MD83Exp.epf (Меню Файл & Открыть).
3. Указать имя файла, в который следует сохранить структуру информационной базы.
4. Проверить настройки в форме обработки (все флаги должны быть сняты).
5. Нажать кнопку Выгрузить.

Шаг 2. Экспорт xml-схемы формата обмена

Для выгрузки схемы формата обмена используются стандартные возможности платформы.

Необходимо выполнить следующие действия:

1. Открыть одну из информационных баз (либо УП либо БП) в режиме “Конфигуратор”.
2. В дереве метаданных найти XDTO пакеты с именами ExchangeMessage иEnterpriseData_1_0_beta.
3. Установить курсор на пакет XDTO, нажать правую кнопку мыши и в контекстном меню выбрать пункт Экспорт XML-схемы. Указать путь и имя файла для экспорта. Выполнить это действие для каждого из двух пакетов, сохранив XML-схемы в два разных файла.

Шаг 3. Загрузка структуры информационных баз в конфигурацию КД 3.0

Загрузка выполняется в конфигурацию КД 3.0 в режиме “Предприятие”. Перечисленные ниже действия следует выполнить для каждой из конфигураций, для которых настраиваются правила конвертации (УП и БП).

1. Перейти в раздел Конфигурации, и выбрать команду Загрузка структуры конфигурации.
2. Указать путь к файлу со структурой информационной базы (см. Этап 1, Шаг 1).
3. Указать способ загрузки & в новую версию конфигурации.
4. Нажать кнопку Выполнить загрузку, дождаться окончания загрузки.

Шаг 4. Загрузка структуры формата обмена в конфигурацию КД 3.0

Загрузка выполняется в конфигурацию КД 3.0 в режиме “Предприятие”.

1. Перейти в раздел Формат данных, и выбрать команду Загрузка структуры формата.
2. Указать файлы со структурой формата (см. Этап 1, Шаг 2). Необходимо указать сразу оба файла, используя множественный выбор.
3. Проверить имя основного пакета XDTO – должен совпадать с пространством имен пакета XDTO EnterpriseData_1_0_beta (см. в конфигураторе УП или БП).
4. Указать способ загрузки & в новую версию формата.
5. Нажать кнопку Выполнить загрузку, дождаться окончания загрузки.

Этап 2. Создание конвертаций

Для решения описанной задачи необходимо создать две конвертации:

• УП (для выгрузки данных из УП в формат обмена)
• БП (для загрузки данных из формата обмена в БП)

Создание конвертаций производится в разделе Конвертации, команда Конвертации. Для новой конвертации необходимо указать наименование, конфигурацию и формат обмена. Например, конвертация для конфигурации УП:

• Наименование & “УП2.0.7”.
• Конфигурация & “УправлениеПредприятием”.
• Поддерживаемые версии формата & одна строка, в которой выбрана единственная позиция справочника Версии формата.

Далее для каждой из двух конвертаций требуется настроить правила:

• правила обработки данных,
• правила конвертации объектов,
• правила конвертации предопределенных данных.

Для перехода к комплекту правил конкретной конвертации необходимо перейти в разделКонвертации, выбрать команду Настройка правил конвертации и выбрать в списке конкретную конвертацию, для которой будут настраиваться правила. В результате будет открыта форма Настройка правил обмена, в которой собраны все правила для конкретной конвертации.

Этап 3. Создание правил конвертации объектов

Шаг 1. Правило конвертации для выгрузки контрагентов из УП

1. Открыть настройку правил обмена для конвертации УП.
2. Перейти на закладку Правила конвертации объектов.
3. Создать новое правило конвертации и заполнить данные на закладке Основные сведения:
   1. Идентификатор правила: “Справочник_Контрагенты_Отправка”,
   2. Объект конфигурации: “СправочникСсылка.Контрагенты”,
   3. Объект формата: “Справочник.Контрагенты”,
   4. Область применения: Для отправки.
4. Нажать кнопку Записать и перейти на закладку Правила конвертации свойств:
   1. Воспользоваться сервисом автоматического сопоставления свойств
      1. Нажать кнопку Настройка ПКС
      2. В открывшейся форме нажать Автосопоставление. Сопоставятся свойства “ИНН”, “КПП”, “Наименование”, “НаименованиеПолное”, “ДополнительнаяИнформация”, “ЮридическоеФизическоеЛицо”
      3. Сохранить результат автоматического сопоставления & нажать кнопкуСоздать правила конвертации свойств и закрыть форму настройки правил конвертации свойств
   2. Вручную добавить правило конвертации свойства для ОКПО (свойство конфигурации & “КодПоОКПО”, свойство формата & “ОКПО”).
   3. Позже потребуется вернуться к правилам конвертации свойств, чтобы заполнить правило конвертации свойства для свойства “ЮридическоеФизическоеЛицо”, которое является перечислением.
5. Нажать кнопку Записать и закрыть.

Шаг 2. Правило конвертации для загрузки контрагентов в БП

1. Открыть настройку правил обмена для конвертации БП.
2. Перейти на закладку Правила конвертации объектов.
3. Создать новое правило конвертации и заполнить данные на закладке Основные сведения:
   1. Идентификатор правила: “Справочник_Контрагенты_Получение”,
   2. Объект конфигурации: “СправочникСсылка.Контрагенты”,
   3. Объект формата: “Справочник.Контрагенты”,
   4. Область применения: Для получения.
4. Нажать кнопку Записать и перейти на закладку Идентификация. Указать способ идентификации «По уникальному идентификатору».
5. Перейти на закладку Правила конвертации свойств
   1. Воспользоваться сервисом автоматического сопоставления свойств:
      1. Нажать кнопку Настройка ПКС
      2. В открывшейся форме нажать Автосопоставление. Сопоставятся свойства “ИНН”, “КПП”, “Наименование”, “НаименованиеПолное”, “ДополнительнаяИнформация”, “ЮридическоеФизическоеЛицо”.
      3. Сохранить результат автоматического сопоставления & нажать кнопкуСоздать правила конвертации свойств и закрыть форму настройки правил конвертации свойств.
   2. Вручную добавить правило конвертации свойства для ОКПО (свойство конфигурации & “КодПоОКПО”, свойство формата & “ОКПО”).
   3. Позже потребуется вернуться к правилам конвертации свойств, чтобы заполнить правило конвертации свойства для свойства “ЮридическоеФизическоеЛицо”, которое является перечислением.
6. Перейти на закладку ПередЗаписьюПолученныхДанных и написать алгоритм для заполнения страны регистрации нового контрагента. Алгоритм содержит следующий текст: «ПолученныеДанные.СтранаРегистрации = Справочники.СтраныМира.Россия;».
7. Нажать кнопку Записать и закрыть.

Этап 4. Создание правил конвертации предопределенных данных

Порядок действий одинаков для обоих конвертаций.

1. Открыть настройку правил обмена для конвертации (УП или БП)
2. Перейти на закладку Правила конвертации предопределенных данных
3. Создать новое правило конвертации и заполнить его свойства:
   1. Идентификатор правила: “Перечисление_ЮридическоеФизическоеЛицо”
   2. Объект конфигурации: “ПеречислениеСсылка.ЮридическоеФизическоеЛицо”
   3. Объект формата: “ЮридическоеФизическоеЛицо”
   4. Область применения: для отправки и получения
   5. В табличном поле заполнить соответствия значений перечисления конфигурации и формата: “ФизическоеЛицо” & “ФизическоеЛицо” и “ЮридическоеЛицо” & “ЮридическоеЛицо”
   6. Нажать кнопку Записать и закрыть
4. Указать новое правило в правиле конвертации свойства “ЮридическоеФизическоеЛицо” справочника Контрагенты
   1. Перейти на закладку Правила конвертации объектов
   2. Найти правило конвертации справочника Контрагенты, открыть форму правила
   3. Перейти на закладку Правила конвертации свойств и найти правило для свойства “ЮридическоеФизическоеЛицо”
   4. Открыть форму правила конвертации свойства и указать в нем правило конвертации объекта & “Перечисление_ЮридическоеФизическоеЛицо”.
   5. Сохранить внесенные изменения

Этап 5. Создание правил обработки данных

Порядок действий одинаков для обоих конвертаций.

1. Открыть настройку правил обмена для конвертации (УП или БП)
2. Перейти на закладку Правила конвертации объектов
3. Найти правило конвертации справочника Контрагенты, открыть форму правила
4. Нажать кнопку Создать на основании & Правило обработки данных
5. В созданном правиле обработки данных проверить заполнившиеся автоматически свойства:
   1. Идентификатор правила & указать такой же как для правила обработки данных (“Справочник_Контрагенты_Отправка” либо “Справочник_Контрагенты_Получение”)
   2. Область применения & такая же как для правила обработки данных
   3. Объект выборки:
      1. для конвертации УП & “СправочникСсылка.Контрагенты”
      2. для конвертации БП & “Справочник.Контрагенты”
   4. Правило конвертации объекта & ссылка на правило конвертации объекта.
6. Нажать кнопку Записать и закрыть.

Этап 6. Получение модулей менеджера обмена данными

Модуль менеджера обмена данными необходим для обмена данными между конфигурациями в соответствии с настроенными в КД 3.0 правилами.

Порядок действий одинаков для обеих конвертаций:

1. Открыть информационную базу УП или БП в режиме “Конфигуратор”. Найти в дереве метаданных общий модуль МенеджерОбменаЧерезУниверсальныйФормат и открыть его для редактирования. Модуль должен быть пустым.
2. Открыть информационную базу КД 3.0 в режиме “Предприятие”.
3. Перейти в раздел Конвертации и выбрать команду Выгрузка модуля.
4. В открывшейся форме указать соответствующую конвертацию и нажать кнопку Выгрузить. Модуль будет скопирован в буфер обмена.
5. Перейти в конфигуратор информационной базы УП или БП и вставить содержимое буфера обмена в общий модуль МенеджерОбменаЧерезУниверсальныйФормат.
6. Сохранить конфигурацию.

Выгрузка модуля в буфер обмена также может производиться из формы настройки правил обмена по кнопке Сохранить модуль менеджера обмена.

Для того чтобы по настроенным правилам выполнялся обмен данными, необходимо в обеих информационных базах в режиме “Предприятие” настроить синхронизацию данных через универсальный формат.

Источник