Правила конвертации объектов 1с. Как найти ошибку при переносе данных. Знание платформ все же необходимо

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

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

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

Как посмотреть, для каких релизов предназначены правила? Просто откройте файл правил любым редактором (по умолчанию это может быть Internet Explorer или Блокнот) и посмотрите на первые строчки - в них записаны версии источника и приемника.

Рис.1. Просмотр правил

Что делать? Если у Вас есть такая возможность - обновите программу-источник до релиза, указанного в правилах конвертации. Если Вы не можете обновить программу, значит и с этими правилами работать не сможете.

Но, возможно, Вы уже все это сделали, а выгрузка все равно происходит с ошибками? Тогда попробуйте найти проблемный элемент, мешающий программе выполнять выгрузку корректно.

Алгоритм действий при поиске ошибок мы продемонстрируем на примере переноса данных из КА 1.1 в БП 3.0 .

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

Рис.2. Поочередная выгрузка групп объектов

Рис.3. Поочередная выгрузка видов объектов

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

Что делать? Если Вам удалось найти конкретный документ, вызывающий ошибку и Вы видите, в чем, вероятнее всего, заключается проблема - отлично. Исправьте документ, если это возможно, или просто не переносите его - гораздо проще восстановить один документ, чем выполнять весь перенос вручную. Чтобы выполнить перенос, исключив только один документ, воспользуйтесь отбором в соседнем окне. В колонке "Тип сравнения" установите "Не равно", в "Значение" выберите проблемный документ, и продолжайте выгрузку как обычно.

Рис.4. Отбор документа при выгрузке

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

Что делать? Ошибки на этапе загрузки чаще всего можно исправить только на этапе выгрузки, так что порядок действий при поиске проблемы будет тем же, что описан выше, с одним лишь исключением - после каждой выгрузки необходимо будет повторять загрузку, чтобы найти элемент, который в базу-приемник не загружается. Выполняйте ту же самую последовательность - сначала перенесите группу видов объектов, затем определенные виды, за определенные даты и наконец исключите проблемный элемент, мешающий успешной загрузке.

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

Рассмотрим на примере выгрузки из КА 1.1 . Пользователь выгружает из базы-источника Входящие остатки на начало 2018 года. Процесс выгрузки прерывается и программа выдает несколько служебных сообщений, среди которых имеется следующее:

Ошибка в обработчике события ПередОбработкойПравилаВыгрузки
ПВД = Остатки_Материалы
Обработчик = ПередОбработкойВыгрузкиДанных
ОписаниеОшибки = Ошибка получения значения свойства объекта (по имени свойства источника)
ПКО = Номенклатура (Справочник: Номенклатура)
ПКС = 15 (Артикул --> Артикул)
Объект = Сварочный аппарат инвертор ВДИ 160Р (Основные средства)
СвойствоПриемника = Артикул (Строка)
ОписаниеОшибки = Поле объекта не обнаружено (Артикул)
ПозицияМодуля = Обработка.УниверсальныйОбменДаннымиXML.МодульОбъекта(8283)
КодСообщения = 13
ПозицияМодуля = Обработка.УниверсальныйОбменДаннымиXML.МодульОбъекта(1694)
КодСообщения = 31

Можно было бы пойти сложным путем и поочередно выгружать разные виды остатков (остатки основных средств, остатки нематериальных активов и т.д.) и найти, что ошибка возникает при выгрузке по правилу Остатки_Материалы . А можно сразу посмотреть имя правила в сообщении об ошибке. Посмотрите, в самой первой строчке в расшифровке ошибки в сообщении говорится именно об этом. ПВД - правило выгрузки данных . Правило выгрузки данных равняется Остатки_Материалы . Нам не нужно ничего искать, программа сама сообщает место возникновения ошибки.

Рис. 5.1. Служебное сообщение об ошибке

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

В остатках по счету 10.09 "Инвентарь и хозяйственные принадлежности" находим наш проблемный объект - субконто Сварочный аппарат инвертор ВДИ 160Р (см. рис. 5.2)

Рис. 5.2. Оборотно-сальдовая ведомость по счету 10.09 за 2018 г.

Если открыть это субконто, то можно сразу увидеть, что Сварочный аппарат инвертор ВДИ 160Р действительно является основным средством, а не номенклатурой (см. рис. 5.3). То, что остатки по Сварочному аппарату инвертор ВДИ 160Р оказались на счете 10.09 совершенно очевидная ошибка, которую необходимо исправить.

Рис. 5.3. Карточка основного средства Сварочный аппарат инвертор ВДИ 160Р

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

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

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

Пример ошибки.

Рассмотрим пример еще одной ошибки, обнаруженной при переносе данных.

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

Рис.6.1. Сообщение об ошибке

Итак, проблемный документ нам сообщает сама программа - это Счет покупателю ИПБП-000008, значит мы сразу переходим к документу и пытаемся выяснить, в чем заключается ошибка.

Как Вы можете видеть на рисунке 6.2, в этом документе в табличной части "Товары и услуги" в одной из строк установлена группа номенклатуры, а не сама номенклатура, что само по себе является ошибкой. Разумеется, в правилах конвертации для этого документа не прописано как из этой табличной части конвертировать объект группа номенклатуры , это элемент совсем другого типа, нежели сама номенклатура , и у программы нет сведений о том, как перенести другой элемент, отличный от указанного в правилах. Следовательно, процесс конвертации не распознает его, не может его конвертировать и выдает ошибку.

Рис.6.2. Документ с ошибкой

Как и зачем это было установлено нас, в данный момент, не интересует. Мы решаем не переносить документ, а значит, исключаем его из списка переносимых объектов. Находим правило выгрузки документа Счет на оплату покупателю , выбираем его, переходим к отбору, устанавливаем Поле - Ссылка, Вид сравнения - Не равно, Значение - наш проблемный документ. Таким образом мы исключим данный документ из списка переносимых объектов и выгрузка должна пройти нормально.

Рис.6.3. Установка настроек для исключения документа

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

Здесь необходимо отметить, что возможности отбора объектов существуют в обработках УниверсальныйОбменДаннымиXML не во всех типовых конфигурациях. Точнее такой функционал отсутствует в режиме управляемого приложения. В частности, в типовой конфигурации Комплексная автоматизация ред.1.1 можно работать как в режиме обычного приложения, так и в режиме управляемого приложения, или, как еще говорят, в режиме управляемых форм. В первом случае отборы в типовой обработке возможны (см. рис.4), во втором - нет. Тогда нужно воспользоваться доработанным версиями обработки (см. рис. 6.3). Если конфигурация используется в режиме совместимости с платформой 8.2 (это в частности КА 1.1 и УПП 1.3 ), то необходима обработка УниверсальныйОбменДаннымиXML версии 2.1.7 . Если же режим совместимости не используется, как например в конфигурации Бухгалтерия предприятия редакции 3.0 , то нужно работать с обработкой версии 2.1.8 . Эти обработки обладают также дополнительными возможностями по заполнению отборов из журнала регистрации (подробнее ), поэтому входят не во все варианты поставок, но их всегда можно приобрести либо в составе пакетов, помеченных как с отбором по ЖР , либо отдельно.

Вот так, в общем виде, выглядит процесс поиска и устранения ошибки, возникшей при переносе данных 1С.

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

Печать (Ctrl+P)

Обработчик Перед Записью Полученных Данных

Процедура ПКО_<ИмяПКО>_ПередЗаписьюПолученныхДанных в общем модуле МенеджерОбменаЧерезУниверсальныйФормат содержит текст обработчика ПередЗаписьюПолученныхДанных для конкретного ПКО. Текст обработчика может быть пустым. Однако, на практике всегда используется при загрузке данных для реализации дополнительной логики, которую необходимо выполнить перед записью объекта в информационную базу. Например, нужно ли загрузить изменения в существующие данные ИБ либо следует загрузить их как новые данные.

Обработчик содержит следующие параметры;

ДанныеИБ – Тип –СправочникОбъект, ДокументОбъект. Элемент данных информационной базы, соответствующий полученным данным. Если соответствующие данные не найдены, то этот параметр имеет значение Неопределено .
ПолученныеДанные – Тип –СправочникОбъект или ДокументОбъект. Элемент данных, сформированный путем конвертации данных XDTO. Записывается в случае, если эти данные являются для информационной базы новыми (параметр ДанныеИБ содержит значение Неопределено ). В противном случае ПолученныеДанные замещают собой ДанныеИБ (все свойства из ПолученныеДанные переносятся в ДанныеИБ ). Если стандартное замещение данных ИБ полученными данными не требуется, следует прописать свою логику переноса, после чего установить ПолученныеДанные значение Неопределено
КонвертацияСвойств . Тип –Таблица значений . Содержит правила конвертации свойств текущего объекта, инициализированные в рамках выполнения сеанса обмена.
КомпонентыОбмена . Структура, которая содержит компоненты обмена: правила обмена и параметры обмена. Процедура инициализации компонентов обмена находится в модуле ОбменДаннымиXDTOСервер

Рассмотрим некоторые практические примеры, которые я решал в расширенной конфигурации, чтобы не менять основную конфигурацию типовых прикладных решений 1С.

Не замещать найденные объекты при загрузке

В правилах конвертации объектов редакции 3.0 в отличии от редакции 2.0 отсутствует свойство “Не замещать найденные объекты при загрузке” благодаря которому, найденные объекты в информационной базе приемника по значению синхронизирующих полей не будут изменяться.

В правилах конвертации объектов редакции 3.0 параметр ДанныеИБ имеет значение неопреднлено если обеъект не найден. Кроме того, если параметр ПолученныеДанные имеет занчение неопреднлено, то при выъоде из обработчика м не будут заменены.

Работадатель попросил, чтобы я изменил правила конвертации между типовыми конфигурациями УТ 11 и БП 3.0 таким образом, чтобы данные справочника организаций и складов в бухгалтерии не проподали при обмене с УТ. Особенно проподали дополнительные реквизиты этих справочников в бухгалтерри, каждый раз когда когда в УТ элементы этих справочников зарегистрировались для отправки в бухгалтерю.

Эту задачу я выполнил в расширении конфигурации бухгалтерии, чтобы не менять основную конфигурацию. Решение показано на рис. 1 . Если элемент справочника существует (найден в источнике) , то параметр ДанныеИБ определено и чтобы все свойства из ПолученныеДанные НЕ переносились в ДанныеИБ следует установить ПолученныеДанные значение Неопределено

Рис 3 Фрагмент программного кода в расширении конфигурации

Если объект справочника не найден, то параметр ДанныеИБ имеет значениеНеопределено и тогда я вызываю процедуру ПродолжитьВызов для продолжения вызова обработчика события из расширяемой конфигурации

Не отражать документы в регламентированном учете

Меня попросили, чтобы была возможность не отражать в бухгалтерии 3.0 некоторые документы отгрузки, которые создаются в управлении торговлей 11. С этой целю я ввел дополнительный реквизит документа реализации «Не отражать документы в регламентированном учете». Если флаг установлен, то этот документ дожжен быть помечен на удаление в базе приемника (БП 3.0). Сложность этой задачи заключается в том, что в бухгалтерии предприятия у документов нет дополнительных реквизитов. Я решил использовать поле комментарии. При отправке на стороне источника (УТ 11) я заполняю реквизит комментарии с соответствующей надписью, а на приемнике (БП) , в обработчике перед запиью полученных данных я устанавливаю пометку на удаление как показано на рис 2

Задача этого правила обмена перенести остатки по взаиморасчетам из БП 2 в УТ11.

Поэтапное создание правила обмена с помощью конфигурации "Конвертация данных"(метаданные должны быть загружены):

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

2) Переходим к написанию самого кода т.к. в УТ нет хозрасчетного регистра то мы должны его преобразовать. Сначала нам нужен запрос который по нашим параметрам будет возвращать остатки по взаиморасчетам. В обработчике события "Перед обработкой" пишем следующий запрос:

В моей задача стояли ограничения на группы контрагентов по которым выгружаются взаиморасчеты.

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

НаДату = дата("20130101");
ТД = ТекущаяДата();
группа = Справочники.Контрагенты.НайтиПоНаименованию("Покупатели");
группа1 = Справочники.Контрагенты.НайтиПоНаименованию("Возвраты от ФИЗЛИЦ");

Создаем таблицу которую в последствии будем передавать в правило конвертации значений.

ТЗ = Новый ТаблицаЗначений();
ТЗ.Колонки.Добавить("Контрагент");
ТЗ.Колонки.Добавить("Сумма");
ТЗ.Колонки.Добавить("СуммаРЕГЛ");
ТЗ.Колонки.Добавить("РасчетныйДокумент");
ТЗ.Колонки.Добавить("ДатаРасчетногоДокумента");
ТЗ.Колонки.Добавить("НомерРасчетногоДокумента");
ТЗ.Колонки.Добавить("Партнер");
ТЗ.Колонки.Добавить("ВалютаВзаиморасчетов");
ТЗ.Колонки.Добавить("ДатаПлатежа");

Устанавливаем параметры, вызываем запрос, заполняем таблицу вызываем правило конвертации.

запрос = новый запрос(ТекстЗапроса);
запрос.УстановитьПараметр("группа",группа);запрос.УстановитьПараметр("группа1",группа1);
запрос.УстановитьПараметр("НаДату",НаДату);
запрос.УстановитьПараметр("Счет",ПланыСчетов.Хозрасчетный.РасчетыСПрочимиПоставщикамиИПодрядчиками);//76.05
Выборка = запрос.Выполнить().Выбрать();
ТЗ.очистить();
Пока Выборка.Следующий() Цикл
если Выборка.СуммаОстатокКТ = 0 или Выборка.СуммаОстатокКТ = "" тогда
продолжить;
конецесли;
если Выборка.СуммаОстатокКТ < 0тогда
сообщить(""+Выборка.Субконто1+" отрицательное значение "+Выборка.СуммаОстатокКТ);
конецесли;
СтрокаТЗ = ТЗ.Добавить();
СтрокаТЗ.Контрагент = Выборка.Субконто1;
СтрокаТЗ.сумма = Выборка.СуммаОстатокКТ;//Выборка.СуммаОстатокКт;
СтрокаТЗ.суммаРегл = Выборка.СуммаОстатокКТ;//Выборка.СуммаОстатокКт;
СтрокаТЗ.ДатаРасчетногоДокумента =Выборка.ДатаРасчетногоДокумента;
СтрокаТЗ.НомерРасчетногоДокумента = Выборка.НомерРасчетногоДокумента;
СтрокаТЗ.ДатаПлатежа = ТД;
КонецЦикла;
ИсходящиеДанные = Новый Структура;
ИсходящиеДанные.Вставить("Дата", ТекущаяДата());
ИсходящиеДанные.Вставить("РасчетыСПартнерами", ТЗ);
ИсходящиеДанные.Вставить("ТипОперации", "ОстаткиЗадолженностиПередПоставщиками");
ИсходящиеДанные.Вставить("Комментарий", "Сформировано по кредиту счета 76.05");
сообщить("76.05 КРЕДИТ начало");
ВыгрузитьПоПравилу(, ИсходящиеДанные, "ВводОстатковПоВзаиморасчетам_7605Кредит");

Аналогично проделываем ту же операцию и для остальных необходимых счетов(их описание как и готовое правило имеется во вложении).

3) Переходим к созданию правил конвертации объектов, для этого открываем закладку "Правила конвертации объектов". Добавим туда новое правило с именем "ВводОстатковПоВзаиморасчетам_7605Кредит" , объект источник оставим пустым, объект приемник установим документ "Ввод остатков", на вкладке настройки уберем флаг "Искать объект приемника по внутреннему идентификатору объекта источника".

В обработчике события "Перед загрузкой" напишем следующий код:

ГенерироватьНовыйНомерИлиКодЕслиНеУказан = истина;

В обработчике события "После загрузки" напишем:

выполнить(алгоритмы.ПослеЗагрузкиВводаОстатков);

он выполнит алгоритм со следующим содержанием:

валюта = Константы.ВалютаРегламентированногоУчета.Получить();
объект.Ответственный = ПараметрыСеанса.ТекущийПользователь;
объект.организация=параметры.порганизация;
для каждого стр из объект.расчетыспартнерами цикл
Стр.РасчетныйДокумент = Справочники.ДоговорыКонтрагентов.пустаяссылка();
Стр.ВалютаВзаиморасчетов = валюта;
если ЗначениеЗаполнено(стр.контрагент.партнер) тогда
стр.партнер = стр.контрагент.партнер;
иначе
парт = Справочники.Партнеры.НайтиПоНаименованию(стр.контрагент.Наименование);
если парт <> Неопределено и парт <> Справочники.Партнеры.пустаяссылка() тогда
стр.партнер = парт;

объект2.Партнер = парт;
объект2.Записать();
иначе
выполнить(алгоритмы.ДобавитьПартнера);
конецесли;

конецесли;

конеццикла;

Этот алгоритм будет исполнен на стороне приемника(БП). Кроме переноса остатков по взаиморасчетам стоит задача переноса контрагентов, но в УТ используются партнеры поэтому после формирования документа мы проверяем все ли контрагенты и партнеры имеются в базе приемнике, если по какой то причине их нет то мы их добавляем.

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

Для партнеров был создан алгоритм который выполняется на стороне приемника.

Для того чтобы выполнить алгоритм на стороне приемника, надо в правом верхнем углу окна алгоритма(при его редактировании) проставить флаг "Используется при загрузке".

Ниже приведен код алгоритма "Добавить партнера":

нПартнер = Справочники.Партнеры.СоздатьЭлемент();
нПартнер.Наименование =стр.контрагент.наименование;
нПартнер.Комментарий = "Создан при загрузке из БП";
нПартнер.НаименованиеПолное =стр.контрагент.НаименованиеПолное;
нПартнер.Поставщик = ?(найти(стр.контрагент.ДополнительнаяИнформация,"Поставщик")>0,истина,ложь);
нПартнер.Клиент = ?(найти(стр.контрагент.ДополнительнаяИнформация,"Клиент")>0,истина,ложь);
ПрочиеОтношения = ?(найти(стр.контрагент.ДополнительнаяИнформация,"Прочее")>0,истина,ложь);
нпартнер.Записать();
стр.партнер = нпартнер.ссылка;
контрагент = Справочники.Контрагенты.НайтиПоНаименованию(стр.контрагент.Наименование);
объект2 = контрагент.ПолучитьОбъект();
объект2.Партнер = нпартнер.ссылка;
объект2.Записать();

Возвращаемся обратно к правилу конвертации объекта. Теперь нам надо установить соответствия полей источника и приемника, это можно было сделать непосредственно перед написанием кода. Для того чтобы сопоставить поля в нижней табличной части имеется кнопка вызова мастера "Синхронизация свойств". В этом мастере мы можем либо сопоставить поля, либо оставить как без источника, так и без приемника. В нашем случае все поля и ТЧ мы оставляем без источника.

После того как необходимы поля были выбраны в нижней ТЧ для каждого поля выставляем флаг в колонке "Получить из входящих данных". Этот флаг говорит о том, что система будет искать это поле во входящих данных. Важно чтобы имя поля совпадало с именем во входящих данных, иначе будет выведено сообщение о том, что поле не найдено.

Текстом описаны не все нюансы процесса.

Учебник по 1С Конвертации данных (редакция 2) Правила конвертации объектов

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

Кроме них имеется еще ряд свойств смысл которых постараемся раскрыть.

Искать объект приемника по внутреннему идентификатору объекта источника - флаг определяющий поиск объектов в приемнике для версии платформы V8. Если этот флажок взведен, то поиск объекта для модификации в базе приемнике осуществляется по внутреннему (уникальному) идентификатору объекта. Этот идентификатор не виден пользователю а средствами программы поддерживается уникальность идентификаторов в информационной базе, так что никакие два объекта информационной базы не имеют одинаковых идентификаторов.

Продолжить поиск по полям поиска, если по идентификатору объект приемник не найден - флаг определяет продолжать поиск объекта в информационной базе приемнике, если поиск по уникальному идентификатору не привел к положительному результату.

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

Не создавать новый объект в приемнике, если он НЕ найден * - флаг определяет нужно ли создавать новый объект в информационной базе - приемнике, если он не был найден по уникальному идентификатору или по полям поиска.

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

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

Не запоминать выгруженные объекты - флаг определяет нужно ли системе при выгрузке КЭШировать последние выгруженные объекты. КЭШирование позволяет ускорить процесс выгрузки и загрузки данных.

Использовать быстрый поиск объекта при выгрузке и загрузке - флаг определяет использовать ли быстрый поиск объектов для выгрузки. Имеет смысл применять для небольших по количеству записей справочников (Количество записей не более 1000 элементов). Эффект достигается в том случае, если у многих объектов установлен флаг Не выгружать объекты свойств по ссылкам. При такой схеме выгрузки и загрузке данных скорость возрастает в несколько раз.

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

On-line обмен

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

По правилам выгрузки если объект уже выгружался, то выгружаем его как есть
По правилам выгрузки если объект не выгружался, то не выгружаем
При выгрузке по ссылке на объект выгружаем целиком

Например, если нужно переносить не всю номенклатуру из одной ИБ в другую, а только ту, на которую есть ссылки, то флажок подойдет.

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

Приоритет объекта загрузки - настройка определяет приоритет объекта при загрузке в случае коллизии изменений. Значение по умолчанию и в случае незаполненного значения - Выше. Если произошла коллизия, программа анализирует приоритет объекта загрузки. Только в том случае, если приоритет объекта загрузки равен Выше он будет записан в информационную базу приемника. В случае если приоритет Совпадает или Ниже программа зафиксирует соответствующую информацию о коллизии в информационной базе, но объект менять при этом не будет.

Варианты настроек полей поиска - таблица с возможными вариантами настроек полей поиска для пользователя. Разработчик правил определяет возможные комбинации полей поиска, которые пользователь может выбирать при настройке обмена. Все настройки указанные разработчиком правил должны быть отработаны в коде обработчика "Поля поиска". Переменная НастройкаПоиска в обработчике определяет выбранный пользователем вариант сопоставления (ИмяНастройкиДляАлгоритма из соответствующей строки таблицы). Если пользователь не выбрал ни один вариант сопоставления, или ему ни один вариант не был предложен, то НастройкаПоиска - пустая строка.

На закладке "Дополнительно" можно редактировать наименование правила, вхождение его в определенную группу а так же описание правила.

Доброго времени суток, уважаемые читатели блога . Раньше на этом сайте уже была опубликована статья о конвертации
, в этой статье было показано,
как можно настроить обмен, используя конструкторы, с помощью которых создаются правила обмена.
Этот способ можно используется при конвертации баз из 1С версии 7.7 в 8.2.
Сейчас мы поговорим, как переносить данные между конфигурациями 1С 8.2, которые несколько отличаются друг от друга.

Основное внимание в этой статье будет уделено конвертации табличной части документа, а это значит, что
мы будем работать с правилами конвертации группы свойств — ПКГС .

Подготовка к настройке ПКГС — правил конвертации группы свойств

Мы будем переносить документ «ПоступлениеТоваровУслуг», который имеет отличия в реквизите СтавкаНДС табличной части «Товары»
в базе источнике и приёмнике. В базе источнике этот реквизит имеет тип «СправочникСсылка.СтавкиНДС»,
а в базе приёмнике — тип «ПеречислениеСсылка.СтавкиНДС».

Кстати, для удобства можно определить

Кроме того, в базе приёмнике нам необходимо заполнять реквизит «СчетУчетаБУ», который также находится
в табличной части «Товары» документа «ПоступлениеТоваровУслуг». Данные для заполнения мы возьмём из реквизита «СчетУчетаБУ»
справочника «Номенклатура» базы приёмника.

Ситуация осложняется тем, что мы будем работать с табличной частью, поэтому нужно настраивать
правила конвертации группы свойств — ПКГС . Нам нужно будет обращаться к текущей строке табличной части.

Создание правил конвертации группы свойств 1С

У нас уже разработаны правила конвертации для документа «ПоступлениеТоваровУслуг».

Но для табличной части «Товары» нет правила конвертации свойства «СтавкиНДС».
Нужно добавить новое правило конвертации свойств, нажав на кнопку «Синхронизация свойств…».

Появится диалог «Настройка правил конвертации свойств (ПоступлениеТоваровУслуг)».

Нужно повторить то, что сделано на изображении и нажать кнопку «ОК».

Хотя мы создали правило конвертации для группы свойств , но пока оно не готово.
Помните, что реквизиты табличной части «СтавкиНДС» отличаются типами значений.
В базе источнике этот реквизит имеет тип «СправочникСсылка.СтавкиНДС»,
а в базе приёмнике — тип «ПеречислениеСсылка.СтавкиНДС». Здесь нам не хватает правила
конвертации из справочника в перечисление.

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

Чтобы настроить конвертацию свойства правильно, нужно создать новое правило конвертации объектов.

В появившемся диалоге указываем, что справочник «СтавкиНДС» конвертируется в перечисление с таким же названием.

Никаких правил конвертаций свойств для этого правила не будет.
Поэтому при сохранении этого правила, в появившемся диалоге выберем «Нет».

В диалоге с вопросом «Создать правила выгрузки данных?» тоже выберем «Нет».

Двойным нажатием откроем диалог с настройкой правила конвертации объекта (ПКО) «СтавкиНДС».
Здесь на закладке «Обработчики событий» выберем событие «При выгрузке» и определим «Источник» и
«УзелСсылки», то есть то, что будет переносится.

Если Источник. Ставка = 0 Тогда
УзелСсылки = «Ставка0» ;
ИначеЕсли Источник. Ставка = 12 Тогда
УзелСсылки = «Ставка12» ;
ИначеЕсли Источник. Наименование = «без НДС» Тогда
УзелСсылки = «БезНДС» ;
КонецЕсли ;

После написания обработчика нажимаем кнопку «ОК».

В информации по обработчикам:

Источник — Произвольный — выгружаемый объект источник (ссылка или произвольные данные).
УзелСсылки — инициализированный xml-узел ссылки. Может использоваться,
например, для инициализации свойств других объектов.

Теперь явно укажем использование этого правила конвертации объекта при выгрузке реквизита «СтавкаНДС».
Преходим на закладку «Конвертация свойств (*)» документа «ПоступлениеТоваровУслуг» и открываем конвертацию
группы свойств «Товары», два раза щёлкаем на свойстве «СтавкиНДС» и в открывшемся диалоге, в поле «Правило»
выбираем правило конвертации объекта «СтавкаНДС».

Нажимаем кнопку «ОК».

Теперь нам осталось установить счета учёта в соответствии с теми значениями, которые определены для номенклатуры.
Перейдём на закладку «Правила конвертации объектов», найдём объект «ПоступлениеТоваровУслуг» и
двойным нажатием на нём откроем диалог правил конвертации объектов (ПКО).
Перейдём на закладку «Обработчики событий» на событие «После загрузки» и напишем следующее:

Для каждого СтрокаТЧ Из Объект. Товары Цикл
СтрокаТЧ. СчетУчетаБУ = СтрокаТЧ. Номенклатура. СчетУчетаБУ;
КонецЦикла ;

Теперь загрузим эти правила в источнике, используя внешнюю обработку «Универсальный обмен данными в формате XML» — «V8Exchan82.epf».
Выгрузим данные в xml-файл. Затем, откроем эту же обработку в базе приёмнике и выберем xml-файл выгрузки и загрузим данные.

Кстати, обработку «Универсальный обмен данными в формате XML» можно открыть через пункт меню
«Сервис» | «Прочие обмены данными» | «Универсальный обмен данными в формате XML». Об этом было немного написано в заметке о .