Правила конвертации XML

Что такое правила конвертации XML? Как они выглядят?

Правила конвертации данных XML - это такая настройка соответствия между объектами двух баз 1С. Можно назвать их - "правила маппинга данных". Эти правила специалисты 1С настраивают в базе 1С конфигурации 1С:Конвертация данных. У Конвертации данных бывает редакция 2 и редакция 3. Правила конвертации XML можно создавать и редактировать и во второй, и в третьей редакции. В третьей редакции нет раскраски кода, зато используется интерфейс управляемых форм и также дополнительно можно создавать и настраивать новый универсальный формат обмена XDTO (его еще называют КД 3). А старый формат обмена XML специалисты 1С называют между собой КД 2. Это не официальный термин, просто так понятнее и привычнее.

Правила конвертации XML в базе 1С:Конвертация данных 8, ред. 2 могут выглядеть следующим образом:

Давайте разберем интерфейс. В данном случае Источник - это база данных 1С:УПП, но не любого релиза, а конкретного - 1.3.268.х. Приемник - это база данных 1С конфигурации УНФ релиза обязательно 3.0.13.х. Это означает, что при обновлении релизов конфигураций ваших баз данных правила конвертации XML также потребуется обновлять под их новую структуру. Как выгрузить структуру конфигурации базы 1С и загрузить в базу КД 2 для разработки правил конвертации XML мы разобрали в отдельной статье: Выгрузка структуры конфигурации базы 1С в файл XML

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

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

На скриншоте интерфейса выше выбрано ПКО ЗаказКлиента. В нижней части интерфейса мы видим еще одну таблицу. Это таблица правил конвертации свойств документа Заказ покупателя (УПП) в документ Заказ клиента (УНФ). Видно, что свойства могут называться также, а могут отличаться. Бывают поля примитивных типов, по ним конвертация проще. А иногда нужно рекурсивно указывать ПКО для текущего свойства. Это необходимо делать, когда свойство ссылочного типа. Кстати, правила обмена XML из УПП в УНФ являются примером программного продукта, который разработала, развивает и распространяет компания MoscowSoft.

Например, поле СкладГруппа (тип составной: СправочникСсылка.ГруппыСкладов или СправочникСсылка.Склады) конвертируется в свойство СтруктурнаяЕдиницаРезерв (тип значения СправочникСсылка.СтруктурныеЕдиницы).

Как сэкономить время на разработке правил конвертации данных XML

На наш взгляд лучший способ сэкономить время - это использовать готовые правила конвертации XML.

Где их можно взять?

1. Стандартные обработки для перехода на новую 1С, которые сделала фирма 1С.
2. Бесплатные заготовки правил обмена XML, найденные в интернете
3. Авторские правила с гарантией качества алгоритмов разработки компании MoscowSoft

Обработки фирмы 1С в макетах хранят правила конвертации данных. Их можно загрузить себе в Конвертацию данных 2 и далее поверх загрузить структуры своих конфигураций 1С. Надо выбирать максимально похожие правила переноса к конфигурациям своих баз 1С, только тогда получится использовать их как заготовку.

Про заготовки правил из интернета все понятно. Иногда получается найти не очень старые правила, но часто их нужно очень долго дорабатывать.

Правила компании MoscowSoft гарантированно работают на актуальных релизах программ 1С. Переносы данных можно проверить бесплатно перед покупкой на своей базе 1С.

Прямо на вашем сервере сделаем выгрузку данных за небольшой период времени. Получите базу 1С с результатом переноса. После проверки качества примете положительное решение о приобретении продукта MoscowSoft для переноса данных.

Выберите готовый перенос данных 1С удобным способом:

Как выполнять выгрузку и загрузку данных с использованием правил XML

Запуск обработки

Вручную выгрузка и загрузка данных выполняются с помощью обработки Универсальный обмен в формате XML. Компания MoscowSoft поддерживает авторскую версию этой обработки с исправленными ошибками и дополнительным функционалом. Подробности изучайте по ссылке >>

Для запуска обработки у пользователя должно присутствовать право интерактивного запуска внешних отчетов и обработок.

Стандартная версия этой обработки уже встроена в конфигурации 1С. Найти стандартную обработку сможете командой меню Операции - Обработки - Универсальный обмен в формате XML, если используете интерфейс "Обычные формы". Или Все функции - Универсальный обмен в формате XML для интерфейса управляемых форм. Для запуска встроенной обработки у текущего пользователя 1С должно быть право администрирования.

Выгрузка данных

Интерфейс обработки состоит из вкладок. Основная вкладка для выгрузки называется Выгрузка данных. В поле Имя файла правил выберите путь к файлу правил конвертации XML. Выбрать и приобрести правила переноса данных для своей задачи можете на странице подбора >>

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

Для старта выгрузки нажмите кнопку Выгрузить данные:

За процессом выгрузки можно следить по сообщениям в окне служебных сообщений 1С и в строке состояния:

При необходимости прервать процесс выгрузки можно командой Ctrl + Break.

Если данных для выгрузки очень много и выгрузка не доходит до конца из-за ошибок, часто причина в недостатке оперативной памяти. В этом случае используйте автоматическую разбивку процесса на части - дополнительный функционал, разработанный сотрудниками MoscowSoft и доступный бесплатно в обработке. Скачайте обработку с таким функционалом по ссылке >>

Как выполнять загрузку данных из файла XML

Если данные выгружали обработкой Универсальный обмен в формате XML, в базе 1С-приемнике данных, нужно запустить загрузку также с помощью этой же обработки.

Перейдите на вкладку Загрузка данных. Выберите режим работы "на сервере" или на клиенте" (в зависимости от того, где лежит файл с выгруженными данными). Выберите имя файла с выгруженными данными. Нажмите кнопку Загрузить данные:

Как разрабатывать правила конвертации ХМЛ

Существует много советов и инструкций по разработке правил конвертации данных XML. Мы разбили процесс разработки на популярные задачи и разместили статьи о них на сайте. Ищите в списке ниже вашу задачу и изучайте материалы:

• Правила выгрузки данных при разработке обменов в 1С:Конвертация данных 2. Научитесь создавать правила обмена данными, сохранять и загружать их в формате XML, а также оптимизировать процесс выгрузки.
• Выгрузка структуры конфигурации 1С в XML: пошаговая инструкция с MD82Exp и MD83Exp. Узнайте, как выгрузить структуру конфигурации базы 1С в файл XML с помощью обработок MD82Exp.epf и MD83Exp.epf.
• Пошаговое создание нового плана обмена данными в 1С. Узнайте, как создать новый план обмена в 1С, настроить модуль менеджера, редактировать команды для обмена данными и добавить общий план.
• Создание обмена с нуля в 1С:Конвертации данных 2. Узнайте, как разработать правила обмена с нуля, как подготовить, выгрузить метаданные, загрузить структуру конфигураций.
• Инструкция использования обработки "Выгрузка и загрузка данных XML" Узнайте, как использовать обработку "Выгрузка и загрузка данных XML" для обмена данными между конфигурациями в 1С:Предприятие 8.5 / 8.3.
• Как изменить правила обмена 1С? Инструкция по изменению правил обмена XML в 1С:Конвертация данных 2.
• Выгрузка только измененных объектов с помощью обработки Универсальный обмен в формате XML. Ознакомьтесь с возможностями обработки Универсальный обмен в формате XML для выгрузки измененных объектов в 1С.
• Выгрузка и загрузка данных с автоматической разбивкой на части для обработки "Универсальный обмен в формате XML". В статье рассматривается возможность автоматической разбивки данных при использовании обработки "Универсальный обмен в формате XML".
• Выгрузка и загрузка структуры метаданных конфигурации 1С в формате XML. В статье описаны шаги процесса выгрузки и загрузки, а также особенности использования внешних обработок для разных версий платформы 1С.
• Правила поиска объектов в Конвертации данных 2. Подробное описание правил поиска объектов, настройки обмена данными и работы с полями сопоставления.
• Создание правил обмена данными XML. Узнайте, как правильно настроить обмен данными между базами конфигурации «Бухгалтерия Предприятия 3.0» с помощью XML.
• Автоматическое создание правил конвертации данных 1С. Как настроить автоматическое создание правил конвертации данных в 1С: практическое руководство
• Правила конвертации свойств в обменах XML в КД 2. Узнайте о правилах конвертации свойств при обмене XML-данными между различными конфигурациями 1С.
• Обработчики событий в правилах конвертации объектов КД 2. Узнайте, как настроить и применять обработчики событий для конвертации данных в 1С. Мы рассмотрим основные задачи, принципы работы и возможности обработчиков.
• Отладка обработчиков событий правил обмена XML с помощью внешней обработки. Узнайте, как анализировать ошибки, работать с логами и использовать внешнюю обработку для отладки.
• Алгоритмы и запросы при разработке конвертаций данных XML. Узнайте, как работают алгоритмы и запросы при конвертации данных XML в 1С: Предприятие. Мы рассмотрим процесс фиксации запросов, создание правил конвертации и повторное использование кода.
• Правила очистки данных при разработке обменов в КД 2. Узнайте, как правильно настроить правила очистки данных в программе КД 2 для корректной обработки объектов при загрузке в информационную базу.
• Правила регистрации объектов. Узнайте о механизме регистрации изменений в 1С: Предприятие, настройке состава объектов для регистрации, категориях правил регистрации и способах ограничивающей миграции.
• Создание правил регистрации объектов Конвертация 2. Узнайте, как создавать правила регистрации объектов (ПРО) в платформе 1С с использованием Конвертации данных 2.х и 3.х. Настройка конфигурации, обмен данными, расширенные функции для указания регистрации.
• Особенности правил регистрации объектов. Узнайте об особенностях регистрации объектов в иерархических справочниках, о создании различных ПРО для элементов и групп, а также о применении фильтров для регистрации элементов и групп.
• Функция ВыгрузитьПоПравилу() в КД 2. Подробный гайд по функции ВыгрузитьПоПравилу в Конвертации Данных 1С. Разбор параметров, практические примеры использования для выгрузки остатков, оптимизации и сложных конвертаций.
• Как настроить двусторонний обмен 1С в формате XML и избежать коллизий. Узнайте, как избежать петель, настроить приоритеты и ГУИДы, а также предотвратить коллизии синхронизации.

Материалы по разработке обменов XML

Подробно и всесторонне процесс разработки рассмотрен в бесплатном учебнике Кузнецовой по обменам КД 2. С разрешения автора получить файл учебника можете на сайте MoscowSoft >>

Также изучите дополнительные статьи:

• Конвертация данных 1С: От XML до XDTO. В этой статье рассмотрим, как работает конфигурация «Конвертация данных» версии 2.0 и 3.0, их отличия и преимущества.
• Настройка обмена данными в 1С: от теории к практике. Узнайте, как настроить обмен данными между базами 1С и внешними системами. Изучите механизмы РИБ, XML, JSON и REST-интерфейс для синхронизации информации.
• Конвертация данных 2.0 в 1С: как организовать обмен между базами 1С. Узнайте, как настроить обмен данными между типовыми конфигурациями «1С:Предприятие 8» с помощью конфигурации «Конвертация данных 2.0».
• Параметры выгрузки и глобальные обработчики событий в 1С:Конвертации данных 2. В статье рассматриваются ключевые моменты работы с закладками «Основная» и «Параметры», а также задачи для обработчика «Перед выгрузкой».
• Ошибка в обработке Универсальный обмен в формате XML с текстом Поле Имя файла для загрузки на сервере не указано. Узнайте, как устранить ошибку в обработке УниверсальногоОбменВФорматеXML, связанную с отсутствием имени файла для загрузки на сервере.
• Оптмизация алгоритмов при разработке правил обмена XML. Советы по ускорению выгрузки и загрузки данных, работе с ПКО, использованию «Универсального обмена данными XML» и другим приёмам для повышения эффективности обмена данными.
• Планы обмена 1С: Механизм учета объектов и регистрация изменений. Узнайте, как работают планы обмена в 1С: механизм учета объектов, регистрация изменений, узлы плана обмена и правила конвертации данных.
• Файл переноса 1С - форматы файлов для переноса данных 1C. Подробное описание популярных форматов файлов для переноса данных 1С: XML, JSON, табличные файлы и TXT.
• Конвертация данных 3.0. Узнайте о преимуществах использования 1С: Конвертация данных 3.0 для обмена данными между базами 1С.
• КД 2 против КД 3: Полный сравнительный обзор Подробное сравнение Конвертации данных 2.0 и 3.0 в 1С. Разбор архитектуры XML и XDTO, плюсы и минусы.

Популярные задачи при использовании правил конвертации XML

Выгрузка и загрузка данных с автоматической разбивкой на части

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

Выгрузка только измененных объектов вручную

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

Выгрузка только измененных объектов автоматическая

Лучше всего организовать ее с помощью МС:Автообмен. В удобном пошаговом мастере настроите обмен, будут сохраняться логи обмена, можно также установить фильтр по организации и значения параметров выгрузки. Все это в визуальном интерфейсе без программирования. Кроме того, можно обмениваться данными через веб-сервис МС:Автообмен. Обмен через веб-сервисы работает быстро, не зависит от версии платформы 1С и работает на всех версиях операционных систем, не только на Windows.

Если хочется самостоятельно запрограммировать обмен только измененными объектами, изучите инструкцию в статье >>

Отладка обработчиков событий правил конвертации XML

Как создать внешнюю обработку для отладки обработчиков с возможностью остановки по ошибке на нужной строке, подробно разобрали в отдельном материале на сайте >>