Учебник по 1С Конвертации данных (редакция 2) Подробное знакомство с правилами обмена
Мы знаем что такое правила обмена и зачем они нужны. Познакомимся более подробно с дополнительным функционалом работы с правилами обмена. Откроем настройки правил обмена данными (конвертации):
В правилах обмена задаются конфигурации источника и приемника для данных, кроме того:
Закладка "Дополнительно":
Можно указать имя файла по умолчанию для сохранения правил обмена, модулей выгрузки и загрузки данных для 7.7, наименование правил обмена.
Закладка "Параметры":
Допустим, офис принимает заказы исключительно на товары, поэтому желательно установить запрет на выгрузку услуг. Если для элемента справочника Номенклатура реквизит Услуга установлен Истина, то он гарантированно не должен выгружаться. Контроль выгрузки услуг лучше всего сразу сделать опциональным, чтобы не менять правила, в случае, если удаленный офис станет принимать заказы и на услуги.
Для этого случая нам придется освоить два новых приема работы с конфигурацией "Конвертация данных" - использование обработчиков и настройку параметров.
Параметры – это специализированная структура данных в алгоритмах выгрузки, с помощью которой можно обращаться к переменным обработки. Настройка структуры параметров для правил конвертации осуществляется в конфигурации "Конвертация данных", а установка значений параметров возможна в форме обработки выгрузки и загрузки данных.
Для редактирования параметров откроем форму элемента справочника Конвертации для редактируемых правил обмена и перейдем на закладку параметры. Создадим новый элемент справочника Параметры. Присвоим имя параметра – ВыгружатьУслуги. Имя параметра служит для обращения к нему в структуре Параметры при написании программного кода в обработчиках. Наименование будет отображаться в табличной части Параметров в форме обработки универсального обмена данными. Для того, чтобы параметр был виден в диалоге при настройке выгрузки нужно установить флажок "Устанавливать в диалоге" и выбрать тип значения параметра. Для работы с параметрами в диалоге необходимо также установить флажок "Выгружать параметры в формате версии 2.01" в форме элемента справочника Конвертации.
Недостаточно просто указать параметры, надо чтобы алгоритм выполнения выгрузки "понимал", в каком случаем выгружать элемент, а в каком нет. Для подобных (и многих других) случаев используется механизм обработчиков. Суть его заключается в том, что в ключевых точках выполнения всех базовых алгоритмов выгрузки и загрузки данных обрабатывается код, написанный разработчиком при создании правил обмена. Естественно, что использование такого тонкого инструмента требует осторожности и продуманности. Мы рекомендуем перед написанием собственных обработчиков внимательно ознакомится со справкой к конфигурации "Конвертация данных 2.0", где описаны все доступные в обработчиках переменные и способы их использования, а также перечислены виды обработчиков и особенности их вызова в алгоритмах обмена данными.
Для нашей цели необходимо использовать обработчик правила выгрузки "Перед выгрузкой". Откроем правило выгрузки данных Номенклатура и поместим в поле "Перед выгрузкой" на закладке "События" следующий программный код:
Что же делает наш обработчик? При написании программного кода мы использовали переменные алгоритмов выгрузки данных. Структура Параметры служит для обращения к параметру ВыгружатьУслуги, который задается в форме обработки обмена данными. Переменная объект предоставляет доступ к выгружаемому объекту. А переменная Отказ позволяет контролировать отказ от выгрузки текущего объекта. Обработчик исполняется непосредственно перед началом выгрузки объекта, что и дает возможность отменить выгрузку объекта.
ТОЛЬКО ДЛЯ ОБМЕНА V8 - V8 И ОБРАБОТКИ ВЫГРУЗКИ И ЗАГРУЗКИ НЕ НИЖЕ 2.0.18.1
Есть возможность передавать параметры из одной конфигурации в другую. Достаточно для этого на закладке "Параметры" установить флажок "Передавать параметр при выгрузке" и этот параметр будет помещен в файл обмена и к его значению можно будет обратиться при загрузке данных. Можно для параметра указать правило конвертации, согласно которому должны будут конвертироваться значения. При помощи флажка "Передавать параметр при выгрузке" можно передавать только те параметры, которые редактируются в диалоге при выгрузке данных. Если же нужно передать параметр, которые в этом диалоге не присутствует, то нужно вызвать процедуру:
На закладке Параметры выгрузки появился параметр, изменяя значения которого услуги либо выгружаются, либо не выгружаются.
И показываем, как с ее помощью СИЛЬНО упростить решение своих задач
Сегодня мы разберем, как буквально за 10-15 минут настроить и сделать простой перенос справочников и начальных остатков.
А это – массовая и регулярная задача , которая практически неизбежна для большинства запускаемых новых конфигураций.
Поэтому позовите коллег, им это будет тоже очень полезно.
Особенно, если они уже видели КД 3 и успели испугаться:)
Да, когда ее видишь в первый раз – там вообще ни фига не понятно.
Но на самом деле – все ОЧЕНЬ просто. Настолько просто, что вам потом даже скучно будет:)
Что конкретно в сегодняшних видео
Это 4 видео по обмену данными через универсальный формат обмена EnterpriseData .
Кроме того, мы покажем пример доработки типовых правил обмена в 1С:Конвертации данных 3.0
Общая длительность – 34 минуты . Содержание:
- Настройка обмена на примере 1С:Бухгалтерии 8 и 1C:ERP
- Как сделать загрузку типовых правил и универсального формата обмена в Конвертации Данных 3.0
- Перенос структуры метаданных в КД 3.0
- Как выполнить первый обмен данными
- Доработка правил конвертации
- Как загрузить новые правила без изменения конфигурации (без снятия с поддержки )
Обратите внимание , что при решении этой задачи меняются правила загрузки только в конфигурации-приемнике. А конфигурация-источник работает по типовым правилам.
Если бы подобная задача решалась в Конвертации данных 2.0, то изменения пришлось бы вносить в правилах и источника, и приемника.
Данные видеоуроки актуальны для БСП редакции 2.3.2 (для любой сборки старше 2.3.2.43).
Если Вы используете более старшую версию БСП,0 сделайте «поправку» на изменившийся интерфейс и расширенную функциональность. Для этого самостоятельно повторите пример из видео.
Видео 1:
Загрузка правил обмена между типовыми конфигурациями в Конвертацию данных 3.0
В этом уроке выполним подготовительные действия при внесении изменений в правила обмена между типовыми конфигурациями:
- Загрузка в КД структуры формата обмена (
- Создание конвертации
- Выгрузка файлов правил из типовой конфигурации
- Выгрузка модуля менеджера обмена
Видео 2:
Доработка правил обмена в КД 3.0
В этом уроке мы покажем, как дозаполнить реквизиты объектов при загрузке данных.
Будет решена задача – при загрузке объектов из конфигурации-источника устанавливать комментарий “Загружено из БП 3.0”.
Для решения задачи потребуется внести изменения в правилах конвертации объектов , в событии “Перед записью полученных данных”.
Разработанные правила будут сохранены в виде внешней обработки для дальнейшего использования.
Видео 3:
Настройка универсального обмена между типовыми конфигурациями
В этом уроке мы покажем, как настраивать новый обмен между типовыми.
Настройки будут сделаны в конфигурации-источнике и затем загружены в конфигурацию-приемник.
Также в этом видео мы покажем, как без изменения конфигурации подгрузить новые правила обмена.
Видео 4:
Перенос начальных остатков с помощью правил обмена
В уроке покажем типовой функционал переноса начальных остатков.
P.S.
Да, обмены через txt / dbf / ole и т.д. имеют право на существование. В каких-то специальных случаях, типа стыковки с веб-сервером или переноса из готового формата внешнего приложения.
Однако для стандартных обменов – стандартные методы и быстрее, и сильно проще.
А если кто-то изобретает велосипед, когда есть готовое универсальное решение – это как написать себе на лбу “инструментом не владею, изучать не хочу, буду строить костыли за ваши деньги” .
P.P.S.
Мы хотим показать, что Конвертация Данных 3.0 – это не сложно.
Непривычно – да. Не все сразу понятно – да. Есть очень неоднозначные моменты – да.
Но с помощью готовых инструкций и видео ее можно освоить буквально за 1-2 недели.
При разработке правил обмена 1С 8 широко используется возможность программного переопределения поведения правил обмена — механизм обработчиков. Обработчики событий существенно расширяют функционал и являются незаменимым инструментом настройки правил обмена в тех случаях, когда интерактивных возможностей конфигурации недостаточно.
Обработчики и алгоритмы пишутся на языке той платформы, в которой они будут выполняться при обмене.
Если это платформа «1С: Предприятие 7.7», то код обработчиков интегрируется в код обработки выгрузки или загрузки. Соответственно, каждый обработчик или алгоритм выделяется в отдельную функцию и доступен для отладки при обмене.
Если выгрузка или загрузка происходят на платформе «1С: Предприятие 8», то код обработчиков не интегрируется в код обработки обмена данными, а выгружается в файл правил обмена. В процессе обмена данными код обработчиков или алгоритмов берется из файла правил и выполняется непосредственно в контексте оператора «Выполнить». Для отладки кода обработчиков и алгоритмов можно воспользоваться обработкой «Универсальный обмен данными XML».
Если вы производите обмен данными между конфигурациями Управление торговлей 10.3 и Бухгалтерия предприятия 2.0, то после обновления одной из конфигураций, необходимо обновить правила обмена.
Рассмотрим случай когда обмен настраивался из конфигурации Управление торговлей и настроен через прямое подключение к базе приемнику, т.е. бухгалтерии. Загружать новые правила нужно через настройку обмена данными в Управлении торговлей. Настоятельно рекомендуется сделать баз перед этим.
Заускаем 1С Управление торговлей 10.3. Выбираем пункт “Все настройки обмена данными” из меню Сервис => Прочие обмены данными.
Выбираем раздел “Все обмены”. Находим в списке ваш обмен данными, щеалкаем правой кнопкой мыши и нажимаем “Изменить”. Если вы будете пытаться изменить настройки обмена из раздела “Обмен данными с 1С: Бухгалтерия 8”,то при попытке изменения будет запускаться помощник настройки обмена данными, который нам не нужен.
В появившемся окне мы видим что обмен происходит по правилам обмена, которые можно сохранить и загрузить. Правила выгрузки в базу обмена, это правила по которым информация выгружается из Управления торговлей в Бухгалтерию, а правила выгрузки из базы обмена в текущую базу это правила, по которым информация загружается из Бухгалтерии в Управление торговлей.
Загрузим правила выгрузки в базу обмена. Нажимаем “Загрузить правила из файла”. Внимание, если у вас нетиповая конфигурация и вы используете нетиповые правила обмена,т.е. разработанные специально для вашей измененной конфигурации, то вам следует обратиться к специалистам для создания новых правил на основе имеющихся.
Ни в коем случае не заменяйте их на типовые правила. Еслы вы не уверены в том что у вас типовые конфигурации, на всякий случай сохраните имеющиеся правила кнопкой “Сохранить правила в файл”.
Так как последнее вышло гораздо позже чем обновление для Управления торговлей, ищем правила обмена в каталоге шаблонов обновлений 1С для Бухгалтерии. Найти каталог шаблонов обновлений можно следующим образом. Запускаем 1С и нажимаем “Настройка”. В появившемся окне видим путь к каталогу шаблонов конфигураций и обновлений.
Переходим по этому пути. Далее: 1С=>Accounting и выбираем папку с названием последнего установленного релиза Бухгалтерии. В случае если правила нужно взять из обновления конфигурации “1С:Управление торговлей”, папка будет называться Trade. Для конфигурации “1С:Розница” — Retail. В ней находится папка “Обмены данными”.
Далее “Обмен с конфигурацией Управление торговлей, ред. 10.3”. В ней видим ПРАВИЛА КОНВЕРТАЦИИ БП-УТ и ПРАВИЛА КОНВЕРТАЦИИ УТ-БП. Так как нам нужны правила выгрузки из УТ выбираем “ПРАВИЛА КОНВЕРТАЦИИ УТ-БП” и нажимаем открыть. Тоже самое проделываем для правил выгрузки из базы обмена в текущую базу только выбираем файл ПРАВИЛА КОНВЕРТАЦИИ БП-УТ и нажимаем открыть.
В папке “Обмен с конфигурацией Управление торговлей, ред. 10.3” находится файл Совместное использование.htm. Если вы ни разу его не читали то обязательно прочтите. В нем находится следующая полезная информация:
- Цели совместного использования
- Общее описание
- Переход с прошлых версий двустороннего обмена данными
- Предварительные действия
- Порядок настройки обмена данными между конфигурациями
- Синхронизация данных
- Совместная работа конфигураций “Управление торговлей” и “Бухгалтерия предприятия”
- Примеры сценариев работы пользователей
- Таблица соответствия выгружаемых документов УТ — БП (редакция 1.6, редакция 2.0) Таблица соответствия выгружаемых документов БП (редакция 1.6, редакция 2.0) — УТ
- Особенности выгрузки документов и справочников
- Таблица соответствия выгружаемых документов БП (редакция 1.6, редакция 2.0) — УТ
- Перенос документов “Счет на оплату покупателю” и “Заказ покупателя”
- Перенос себестоимости списания товаров
- Контроль результатов обмена данными
Проверяем правила кнопками проверить. И нажимаем ОК. Новые правила сохранены. Запускаем обмен данными и проверяем их работу.
О том,как настроить двухсторонний обмен данными между конфигурациями Управление торговлей 10.3 и Бухгалтерия предприятия 2.0 написано в другой моей статье.