27.04.2017

Конвертация данных, редакция 3.0

• Общая информация
• Особенности применения новой технологии
• Пример использования   

Общая информация

Редакция 3.0 конфигурации Конвертация данных предоставляет новые технологические возможности обмена данными между прикладными решениями на платформе "1С:Предприятие 8".

В настоящее время в большинстве типовых решений используется технология обмена данными, которая подразумевает выгрузку данных из конфигурации-отправителя в готовом для конкретной конфигурации-получателя виде (универсальный обмен по правилам). При таком подходе в конфигурации-отправителе поддерживаются отдельные правила конвертации для каждой редакции конфигурации-получателя.

Новая технология предполагает выгрузку данных в едином универсальном формате, который может использоваться любой конфигурацией-получателем. Таким образом, при обмене данными с несколькими конфигурациями по новой технологии в конфигурации достаточно реализовать одну выгрузку данных в универсальном формате, не поддерживая при этом несколько вариантов выгружаемых данных для различных редакций конфигураций.

Особенности применения новой технологии обмена

Для реализации новой технологии обмена разработан формат данных EnterpriseData, который дает возможность осуществлять обмен данными без учета внутреннего устройства программ-корреспондентов. Формат EnterpriseData поддерживает передачу данных трех основных типов:

• нормативно-справочная информация,
• документы,
• остатки на заданную дату в натуральном или денежном измерении.

Формат EnterpriseData может использоваться для обмена данными между прикладными решениями на платформе "1С:Предприятие 8.3", для обмена данными решений на платформе "1С:Предприятие" с другими программами экономического назначения, а также для обмена данными между программами, разработанными на других платформах. Освоение работы с форматом данных EnterpriseData не представляет сложностей для разработчиков, знакомых с системой "1С:Предприятие 8".

Для реализации обмена в прикладной конфигурации разрабатывается общий модуль "Менеджер обмена через универсальный формат", который содержит в себе логику загрузки данных, представленных в формате EnterpriseData, а также логику выгрузки данных в этот формат. В логике выгрузки и загрузки может быть задействован набор параметров, что позволяет использовать единожды написанную логику в различных вариациях, например, при обмене данными текущей конфигурации с конфигурациями Розница, Бухгалтерия предприятия и другими.

Технологическая конфигурация Конвертация данных, редакция 3.0, служит помощником разработки логики обмена и предоставляет следующую функциональность:

• загрузка и хранение структуры конфигурации "1С:Предприятия 8",
• загрузка и хранение структуры формата (EnterpriseData или аналогичного),
• интерфейс для разработки конвертации,
• выгрузка текста общего модуля "Менеджер обмена через универсальный формат" в буфер обмена,
• загрузка конвертации из текста общего модуля "Менеджер обмена через универсальный формат",
• подготовка описания структуры формата в виде, пригодном для публикации.

Редакция 3.0 конфигурации Конвертация данных на данный момент не является заменителем Конвертации данных, редакция 2.0, а служит для решения задач, связанных с разработкой обмена данными через универсальный формат.

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

Ознакомиться с новой технологией конвертации данных можно на примере обмена данными между конфигурациями 1С:ERP Управление предприятием 2.0 (версия 2.0.7 и выше) и Бухгалтерия предприятия, редакция 3.0 (версия 3.0.35 и выше). В поставку конфигурации включен шаблон для демо-базы, содержащий правила обмена

Пример использования

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

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

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

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

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

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

• Открыть информационную базу в режиме "Предприятие".
• Открыть внешнюю обработку MD83Exp.epf (Меню Файл — Открыть).
• Указать имя файла, в который следует сохранить структуру информационной базы.
• Нажать кнопку Выгрузить.

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

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

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

• Открыть одну из информационных баз (либо УП либо БП) в режиме "Конфигуратор".
• В дереве метаданных найти XDTO пакет с именем EnterpriseData_{X|XX}_{Y|YY}_{Z|ZZ}, где X,Y,Z должны соответствовать нужной версии формата.
• Установить курсор на пакет XDTO, нажать правую кнопку мыши и в контекстном меню выбрать пункт Экспорт XML-схемы. Указать путь и имя файла для экспорта.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Открыть настройку правил обмена для конвертации УП.

Перейти на закладку Правила конвертации объектов.

Создать новое правило конвертации и заполнить данные на закладке Основные сведения:

• Идентификатор правила: "Справочник_Контрагенты_Отправка",
• Объект конфигурации: "СправочникСсылка.Контрагенты",
• Объект формата: "Справочник.Контрагенты",
• Область применения: Для отправки.

Нажать кнопку Записать и перейти на закладку Правила конвертации свойств:

Воспользоваться сервисом автоматического сопоставления свойств:

• Нажать кнопку Настройка ПКС.
• В открывшейся форме нажать Автосопоставление. Сопоставятся свойства "ИНН", "КПП", "Наименование", "НаименованиеПолное", "ДополнительнаяИнформация", "ЮридическоеФизическоеЛицо".
• Сохранить результат автоматического сопоставления — нажать кнопку Создать правила конвертации свойств и закрыть форму настройки правил конвертации свойств.

Вручную добавить правило конвертации свойства для ОКПО (свойство конфигурации — "КодПоОКПО", свойство формата — "ОКПО").

Позже потребуется вернуться к правилам конвертации свойств, чтобы заполнить правило конвертации свойства для свойства "ЮридическоеФизическоеЛицо", которое является перечислением.

Нажать кнопку Записать и закрыть.

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

Открыть настройку правил обмена для конвертации БП.

Перейти на закладку Правила конвертации объектов.

Создать новое правило конвертации и заполнить данные на закладке Основные сведения:

• Идентификатор правила: "Справочник_Контрагенты_Получение",
• Объект конфигурации: "СправочникСсылка.Контрагенты",
• Объект формата: "Справочник.Контрагенты",
• Область применения: Для получения.

Нажать кнопку Записать и перейти на закладку Идентификация. Указать способ идентификации «По уникальному идентификатору».

Перейти на закладку Правила конвертации свойств.

Воспользоваться сервисом автоматического сопоставления свойств:

• Нажать кнопку Настройка ПКС.
• В открывшейся форме нажать Автосопоставление. Сопоставятся свойства "ИНН", "КПП", "Наименование", "НаименованиеПолное", "ДополнительнаяИнформация", "ЮридическоеФизическоеЛицо".
• Сохранить результат автоматического сопоставления — нажать кнопку Создать правила конвертации свойств и закрыть форму настройки правил конвертации свойств.

Вручную добавить правило конвертации свойства для ОКПО (свойство конфигурации — "КодПоОКПО", свойство формата — "ОКПО").

Позже потребуется вернуться к правилам конвертации свойств, чтобы заполнить правило конвертации свойства для свойства "ЮридическоеФизическоеЛицо", которое является перечислением.

Перейти на закладку Перед записью полученных данных и написать алгоритм для заполнения страны регистрации нового контрагента. Алгоритм содержит следующий текст: «ПолученныеДанные.СтранаРегистрации = Справочники.СтраныМира.Россия;».

Нажать кнопку Записать и закрыть.

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

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

Открыть настройку правил обмена для конвертации (УП или БП).

Перейти на закладку Правила конвертации предопределенных данных

Создать новое правило конвертации и заполнить его свойства:

• Идентификатор правила: "Перечисление_ЮридическоеФизическоеЛицо".
• Объект конфигурации: "ПеречислениеСсылка.ЮридическоеФизическоеЛицо".
• Объект формата: "ЮридическоеФизическоеЛицо".
• Область применения: для отправки и получения.

В табличном поле заполнить соответствия значений перечисления конфигурации и формата: "ФизическоеЛицо" — "ФизическоеЛицо" и "ЮридическоеЛицо" — "ЮридическоеЛицо".

Нажать кнопку Записать и закрыть.

Указать новое правило в правиле конвертации свойства "ЮридическоеФизическоеЛицо" справочника Контрагенты.

Перейти на закладку Правила конвертации объектов.

Найти правило конвертации справочника Контрагенты, открыть форму правила.

Перейти на закладку Правила конвертации свойств и найти правило для свойства "ЮридическоеФизическоеЛицо".

Открыть форму правила конвертации свойства и указать в нем правило конвертации объекта — "Перечисление_ЮридическоеФизическоеЛицо".

Сохранить внесенные изменения.

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

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

Открыть настройку правил обмена для конвертации (УП или БП).

Перейти на закладку Правила конвертации объектов.

Найти правило конвертации справочника Контрагенты, открыть форму правила.

Нажать кнопку Создать на основании — Правило обработки данных.

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

• Идентификатор правила — указать такой же как для правила обработки данных ("Справочник_Контрагенты_Отправка" либо "Справочник_Контрагенты_Получение").
• Область применения — такая же как для правила обработки данных.
• Объект выборки: для конвертации УП — "СправочникСсылка.Контрагенты", для конвертации БП — "Справочник.Контрагенты".
• Правило конвертации объекта — ссылка на правило конвертации объекта.

Нажать кнопку Записать и закрыть.

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

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

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

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

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