1с выгрузитьпоправилу описание параметров
В данной статье будут рассмотрены десять приемов работы с конвертацией данных 2.1. Указанные приемы явно не описываются в документации (справке), но их полезно знать и применять. Для наглядности приёмы работы сопровождаются описанием реализации и практическими примерами.
Чтобы выгрузить один объект источника в несколько объектов приемника, можно использовать мощный инструмент расширения возможностей правил конвертации – «ВыгрузитьПоПравилу».
Синтаксис функции:
Пример реальной задачи. Необходимо выгрузить справочник – «НоменклатурныеГруппы» в три объекта на стороне приемника: «НоменклатурнаяГруппа» (справочник), «ЗаказНаПроизводство» (документ), «СтатусыЗаказов» (регистр сведений). Для решения данной задачи можно использовать функцию «ВыгрузитьПоПравилу».
В правилах выгрузки данных (далее-ПВД) в обработчике «ПередОбработкой» происходит выгрузка в объект приемника «НоменклатурнаяГруппа» по стандартной выгрузке (ИмяПКО), а в обработчике «ПослеВыгрузки» происходит выгрузка в объекты «ЗаказНаПроизводство» и «СтатусыЗаказов» с помощью функции «ВыгрузитьПоПравилу»:
Если необходимо выгрузить иерархический справочник (элементы и папки) с учетом иерархии и поиск в базе приемника будет осуществляться по внутреннему идентификатору объекта источника (по полям поиска не будет продолжен поиск), то для корректной выгрузки иерархии необходимо установить галочку – «Поиск» у реквизита «ЭтоГруппа» (см. рисунок 1).
Рисунок 1 – Выгрузка иерархического справочника.
Если не установить галочку «Поиск» у реквизита «ЭтоГруппа», то папки объекта будут выгружаться как элементы.
Объекты регистрируются по правилам регистрации объектов к выгрузке только при изменении реквизитов объекта, которые указаны в правилах конвертации свойств (далее-ПКС) объекта (правила обмена данными). При необходимости регистрировать объект к выгрузке и при изменении реквизитов, которые не указаны в ПКС, достаточно данные реквизиты добавить в ПКС и установить галочку – «отключить» (см. рисунок 2).
Рисунок 2 – Реквизиты объекта для правил регистрации объекта.
Это может потребоваться для задачи, когда у нас есть реквизиты на стороне базы источника, которых нет в базе приемника, и только при их изменении объекты должны регистрироваться к обмену.
Когда стоит задача выгружать вместо регистрируемого объекта другой объект, то при регистрации исходного объекта в правилах регистрации объектов в обработчике «ПослеОбработки» через метод «ЗарегистрироватьИзменения» плана обмена можно зарегистрировать необходимый объект на узлах плана обмена.
Синтаксис метода:
ЗарегистрироватьИзменения (Узлы, Данные)
Пример реальной задачи. Несколько документов «Списания с расчетного счета» по одному документу «Заявка на расходование ДС» необходимо выгружать из конфигурации источника в один документ «Списания с расчетного счета» конфигурации приемника. При изменении документа «Списания с расчетного счета» регистрируется к обмену документ «Заявка на расходование ДС», который при выгрузке собирает по определенным правилам данные со всех документов «Списания с расчетного счета».
В продолжение пункта 4. При выгрузке любого объекта происходит проверка, соответствует ли он существующим правилам регистрации. Если при регистрации вместо исходного объекта регистрируется к выгрузке другой объект, то новый объект также будет проходить проверку по своему типу правил регистрации объектов. В случае несоответствия правилам регистрации, объект будет выгружать, как «УдалениеОбъекта».
Для устранения данной нестыковки выгружаемого объекта и правил регистрации объекта, нужно использовать в правилах регистрации в обработчике «ПослеОбработки» параметр «Выгрузка».
Описание параметра Выгрузка:
Выгрузка (только чтение) – Булево – параметр определяет контекст выполнения правила регистрации. Истина – правило регистрации выполняется в контексте выгрузки объекта. Ложь – правило регистрации выполняется в контексте перед записью объекта.
Пример реальной задачи. При изменении документа «Списания с расчетного счета» регистрируется к обмену документ «Заявка на расходование ДС», который при выгрузке собирает по определенным правилам данные со всех документов «Списания с расчетного счета». Но документ «Заявка на расходование ДС» может выгружать независимо по своим правилам регистрации, которые не совпадают с правилами регистрации при регистрации из документа «Списания с расчетного счета».
Если по одному объекту источнику в правилах конвертации объектов присутствуют несколько правил, то система будет использовать по умолчанию правило, которое совпадает по наименованию с наименованием объекта источника (см. рисунок 3).
Рисунок 3 – Выбор правила конвертации объекта по умолчанию.
Пример реальной задачи. Данный подход может пригодиться при выгрузке субконто, когда система определяет правила выгрузки объекта по умолчанию.
При необходимости создавать на стороне приемника новые элементы документов (справочников) и подставлять их в исходный объект, можно применить следующий подход:
- определить правило заполнения нового документа (справочника) на стороне приемника (например, через входящие данные);
- описать заполнение реквизита нового документа (справочника) в исходном объекте (например, через исходящие данные);
- заполнять при выгрузке на стороне источника новый документ (справочник) уникальным значением (например, числом).
Пример реальной задачи. Необходимо на стороне приемника создавать новые документы «ДокументРасчетовСКонтрагентом» в документе ввод начальных остатков по счетам взаиморасчетов. На стороне источника заполняем реквизит «ДокументРасчетовСКонтрагентом» при выгрузке начальных остатков по счетам взаиморасчетов уникальным значением (числом):
В исходном объекте («ВводНачальныхОстатков») описываем правила выгрузки реквизита «ДокументРасчетовСКонтрагентом»:
Определяем правило заполнения «ДокументаРасчетовСКонтрагентом» на стороне приемника (см. рисунок 4).
Рисунок 4 – Правили выгрузки «ДокументРасчетовСКонтрагентов».
В конвертации данных нельзя создать параметр с типом «ТаблицаЗначений» на вкладке «Параметры» (см. рисунок 5).
Рисунок 5 – Допустимые типы для параметров конвертации данных.
Возможность создать параметр с типом «ТаблицаЗначений» при необходимости присутствует в системе, необходимо в общем обработчике «ПередЗагрузкойДанных» определить параметр.
Также необходимо в общем обработчике «ПослеЗагрузкиДанных» удалить данный параметр.
При выгрузке из базы источника можно указывать вместо элемента перечисления или предопределенного значения справочника текстовое значение, которое равно наименованию элемента перечисления или предопределенного значения справочника.
Пример реальной задачи. В базе приемника присутствует реквизит – «ТипПлатежа» с типом «Перечисление». При выгрузке реквизита (обработчик: «Перед выгрузкой») можно указать текстовое значение равное наименованию элемента перечисления на стороне базы приемника (см. рисунок 6). Данный подход может ускорить процесс разработки в конвертации данных.
Рисунок 6 – Заполнение реквизита с типом «Перечисление».
Когда необходимо выгрузить большой объем данных и нет необходимости выгружать полностью ссылочные данные, то можно сократить объем выгружаемых данных с помощью параметров «ВыгрузитьОбъект» («ВыгрузитьТолькоСсылку») в обработчике «ПриВыгрузке» правил конвертации свойств (ПКС):
Пример реальной задачи. Данное ускорение может потребоваться, когда все ссылочные объекты (нормативно-справочная информация) из базы источника ежедневно интегрируется в базу приемника, а документы должны транслироваться с определенным интервалом (раз в месяц). В таком случае при обмене документами между базами нет необходимости полностью передавать ссылочные объекты, а можно передавать только ссылку, что ускорит процесс выгрузки.
Рассмотренные приемы работы позволят повысить производительность и эффективность работы с программой конвертацией данных 2.1.
Статью подготовил Аналитик-эксперт по информационным системам "ИнфоСофт" Ретунский Александр.
Казалось бы, всего лишь одна функция из арсенала разработчика правил обмена на Конвертации данных 2.1, но понимание этой функции расширяет ваши возможности при написании качественных правил обмена в несколько раз. Да, что там писать эти правила? Сопоставил реквизиты, сопоставил табличные части, да еще помощник автоматически создаст необходимые ПКО, ПКС, ПВД. А как быть, когда нужно передать Регистр сведений в регистр сведений, да не просто передать, а привязать это действие к выгрузке определенных элементов, например, элементов справочника Физические лица? Или как передать табличную часть справочника в документы, да так, чтобы одна строка табличной части создавала ровно один документ на стороне приемника? А как быть, если невозможно сделать соответствия между объектами и данные для приемника необходимо собирать из разных источников? Именно для подобных задач вам может понадобиться функция ВыгрузитьПоПравилу.
Здесь, я расскажу вам о тех ситуациях, в которых мне понадобилась эта функция, и как она меня не раз выручила. Все свое повествование я сопровожу реальными примерами, которые реализовывались мной в одном из проектов.
Описание функции ВыгрузитьПоПравилу().
Функция ВыгрузитьПоПравилу() используется для выгрузки объекта в xml-узел и возвращает узел ссылки на этот объект.
В процессе выгрузки эта функция вызывается из :
ПВД, когда объект из выборки получен и необходимо произвести его конвертацию.
ПКО, когда необходимо выгрузить связанную с выгружаемым объектом информацию.
ПКС, когда свойство имеет ссылочный тип и необходимо выгрузить по ссылке из этого свойства объект.
Из функции ВыгрузитьПоПравилу() могут быть вызваны другие функции, выгружающие субконто, свойства и т.д. этого объекта, а из этих функций – рекурсивно может быть вызвана функция ВыгрузитьПоПравилу(). После того, как объект со всеми необходимыми свойствами выгружен, управление возвращается в то место кода, откуда функция была вызвана . Таким образом, вызов этой функции из обработчиков событий какого-либо правила (ПВД, ПКО, ПКС), не изменяет процесса выгрузки объекта по этому правилу.
Функция ВыгрузитьПоПравилу() имеет ряд параметров
Выгрузка произвольной выборки данных через стандартную выборку с регистрацией объекта источника.
Необходимость в такой задаче может возникнуть, когда объект "источника" и объект "приемника" имеют различную смысловую или функциональную структуру .
Например, документ "источника" позволяет вводить информацию по нескольким подразделениям предприятия, документ "приемника" позволяет вводить информацию только об одном подразделении предприятия.
Данная задача отлично решается при помощи произвольного алгоритма выборки в ПВД, но данное решение имеет два недостатка:
- Мы лишаемся механизма регистрации изменений;
- Алгоритм произвольной выборки отказывается работать в БСП.
БСП - библиотека стандартных подсистем. В частности, имеет своем составе подсистему "Обмен данными", данная подсистема реализует механизмы автоматической синхронизации данных между конфигурациями, по правилам написанным в Конвертации данных.
- Создаем ПВД со Стандартным алгоритмом выборки;
- Указываем объект выборки;
- Пишем обработчик "Перед выгрузкой"(хочу подчеркнуть, что нужно использовать именно этот обработчик). Например, следующего содержания:
Большую часть этого обработчика, как вы можете видеть, занимает отбор данных необходимых для выгрузки. Тут и множество фильтров: по подразделениям, по видам расчетов и механизм разбиения одного документа "источника" на несколько документов "приемника". Если коротко, то в данном примере табличная часть одного документа "источника" разносится по табличным частям нескольких документов "приемника", а значением разбиения данных является значение Подразделения.
Для удобства работы при отборе данных мы использовали Таблицу значений, наш алгоритм подразумевает ПКО с получением данных из "входящих данных", которые будут переданы в функцию ВыгрузитьПоПравилу, поэтому в соответсвующем алгоритме мы производим перевод Таблицы значений в Массив структур.
На следующем шаге мы обходим отобранные данные и вот уже в этом месте мы используем нашу функцию ВыгрузитьПоПравилу. Параметр Документ, здесь является структурой, которую мы передаем как входящие данные, а второй передаваемый нами параметр, это название ПКО, которому мы передаем наши данные.
В самом конце мы отменяем выполнение стандартной выгрузки, так как все необходимые данные связанные с объектом выборки мы уже выгрузили.
Тем самым мы сохраняем функциональность регистрации изменений - документ изменился, зарегистрировался для выгрузки, данные выгрузили. И в то же время делаем произвольный отбор необходимых нам данных.
Выгрузка Регистр сведений -> Регистр сведений с зависимостью от переноса другого объекта.
Типичным примером такой задачи является перенос контактной информации физического лица. Простейший способ решения задачи - это перенос всех "Физических лиц" и всего регистра сведений "Контактная информация" физических лиц. Что делать если нам необходимо переносить не всех физических лиц? Например, только тех физических лиц, которые упоминаются в каком-либо переносимом нами документе. В таком случае, как известно, ПКС документа вызывает ПКО справочника "Физические лица" и тем самым обеспечивается перенос физических лиц упоминаемых в документе.
В переносе "Контактной информации" физических лиц в данной ситуации может помочь функция ВыгрузитьРегистр, очень похожая на функцию ВыгрузитьПоПравилу.
Хочу отметить, что потребность в использовании функции ВыгрузитьРегистр у меня появилась, когда я начал адаптировать правила под БСП уже отлаженные на обработке Универсальный обмен XML. Регистры через обработку спокойно выгружались с использованием функции ВыгрузитьПоПравилу, но БСП ни как не хотело правильно понимать такую выгрузку, в результате чего пришлось переписывать код через ВыгрузитьРегистр.
В обработчике"После выгрузки в файл" ПКО "Физические лица", пишем код следующего вида:
Как видно, в коде отбираются все записи регистра сведений, относящиеся к текущему выгружаемому Физическому лицу, а полученная выборка обходится в цикле.
Для того, чтобы выгрузить записи регистра сведений через функцию ВыгрузитьРегистр, необходимо подготовить структуру НаборЗаписей, которая имеет два поля: Отбор и Строки.
ПКО "КонтактнаяИнформация" имеет следующий вид:
Выгрузка Табличная часть -> Регистр сведений.
По своему решению задача аналогична предыдущей. С той лишь разницей, что информацию для регистра сведений "приемника" брать придется из других объектов "источника", а точнее табличной части того объекта, который на данный момент выгружается. Если бы на стороне "приемника" была так же табличная часть, то задача легко решалась бы в виде ПГКС. Поэтому снова воспользуемся функцией ВыгрузитьРегистр.
Рассмотрим пример переноса информации по ученым степеням Физического лица. Опять создаем код в обработчике "После выгрузки в файл" ПКО "Физические лица". Так как задача аналогичная предыдущей привожу только, код отбора и выгрузки данных из обработчика:
Выгрузка Табличная часть -> Документ.
Предположим, в "источнике" информация для переноса хранится в менее детализированном виде, чем в приемнике, но достаточном для переноса. Например, мной решалась задача по переносу информации об образовании физических лиц из ЗиКБУ в Университет. Понятно, что на стороне кадровой программы нужна минимальная информация об образовании физических лиц, главное что сотрудник обладает необходимой квалификацией и хватит. А вот на стороне университета, информация об образовании, а точнее о дипломах хранится куда более подробно, в связи со спецификой учереждения.
И опять задача решается, при помощи все той же функции ВыгрузитьПоПравилу.
Вот пример выгрузки Дипломов физических лиц. Все тот же обработчик "После выгрузки в файл" ПКО "Физические лица", пишем следующий код:
В общем, как вы понимаете, можно приводить еще много вариаций перегрузок: справочники, документы, регистры. Главное, надо понимать, что не стоит фанатично бросаться на функции ВыгрузитьПоПравилу и ВыгрузитьРегистр.
Замечания по перегрузке.
1. У меня возникли сложности при использовании правил в БСП, в части выгрузки объектов по ссылкам, проблема решилась принудительной установкой параметра ВыгрузитьОбъект в значение Истина, для каждого ПКС ссылочного типа:
Подводим итоги. Когда использовать эти функции?
- Вам необходимо перегрузить объекты с сильно различной структурой или на стороне "источника" необходимо собирать объекты для выгрузки из разных объектов.
- Вам необходимо перегружать объекты с привязкой к выгрузке других объектов.
UPDATE от 11.11.2015
А что если оптимизировать выше написанное?
Пишу дополнение к статье, после оставленного пользователем TarasovAV комментария. Данный пользователь заметил, что можно оптимизировать выгрузку связанной информации, путем накопления списка тех объектов, информацию о которых надо будет отдельно выгружать, а потом через один запрос отобрать сразу всю информацию.
Описываю алгоритм предложенный вышеуказанным пользователем:
1. В правиле конвертации "После загрузки правил обмена", создается параметр типа ТаблицаЗначений, в который будет накапливаться список объектов, для которых в последующем будет выгружаться информация:
2. В в обработчике "После выгрузки" ПКО "Физические лица" (именно для них в примерах мы выгружаем контактные данные, образование и т.п.), мы пополняем нашу таблицу значений новым физическим лицом, проверяя перед этим, а не добавлено ли уже это физическое лицо в таблицу:
3. И финальным действием, будет непосредственная выгрузка информации, только уже с отбором по все физическим лицам сразу. Для этого все обработчики, что были приведены выше начиная, необходимо перенести в правило конвертации "После выгрузки данных", запросы же необходимо изменить, чтобы в них проверялось не равенство одному элементу, а вхождение значения реквизита в массив элементов:
Обратите внимание, как изменилась установка параметра запроса и проверка условия в запросе:
Казалось бы, всего лишь одна функция из арсенала разработчика правил обмена на Конвертации данных 2.1, но понимание этой функции расширяет ваши возможности при написании качественных правил обмена в несколько раз. Да, что там писать эти правила? Сопоставил реквизиты, сопоставил табличные части, да еще помощник автоматически создаст необходимые ПКО, ПКС, ПВД. А как быть, когда нужно передать Регистр сведений в регистр сведений, да не просто передать, а привязать это действие к выгрузке определенных элементов, например, элементов справочника Физические лица? Или как передать табличную часть справочника в документы, да так, чтобы одна строка табличной части создавала ровно один документ на стороне приемника? А как быть, если невозможно сделать соответствия между объектами и данные для приемника необходимо собирать из разных источников? Именно для подобных задач вам может понадобиться функция ВыгрузитьПоПравилу.
Здесь, я расскажу вам о тех ситуациях, в которых мне понадобилась эта функция, и как она меня не раз выручила. Все свое повествование я сопровожу реальными примерами, которые реализовывались мной в одном из проектов.
Описание функции ВыгрузитьПоПравилу().
Функция ВыгрузитьПоПравилу() используется для выгрузки объекта в xml-узел и возвращает узел ссылки на этот объект.
В процессе выгрузки эта функция вызывается из :
ПВД, когда объект из выборки получен и необходимо произвести его конвертацию.
ПКО, когда необходимо выгрузить связанную с выгружаемым объектом информацию.
ПКС, когда свойство имеет ссылочный тип и необходимо выгрузить по ссылке из этого свойства объект.
Из функции ВыгрузитьПоПравилу() могут быть вызваны другие функции, выгружающие субконто, свойства и т.д. этого объекта, а из этих функций – рекурсивно может быть вызвана функция ВыгрузитьПоПравилу(). После того, как объект со всеми необходимыми свойствами выгружен, управление возвращается в то место кода, откуда функция была вызвана . Таким образом, вызов этой функции из обработчиков событий какого-либо правила (ПВД, ПКО, ПКС), не изменяет процесса выгрузки объекта по этому правилу.
Функция ВыгрузитьПоПравилу() имеет ряд параметров
Выгрузка произвольной выборки данных через стандартную выборку с регистрацией объекта источника.
Необходимость в такой задаче может возникнуть, когда объект «источника» и объект «приемника» имеют различную смысловую или функциональную структуру .
Например, документ «источника» позволяет вводить информацию по нескольким подразделениям предприятия, документ «приемника» позволяет вводить информацию только об одном подразделении предприятия.
Данная задача отлично решается при помощи произвольного алгоритма выборки в ПВД, но данное решение имеет два недостатка:
- Мы лишаемся механизма регистрации изменений;
- Алгоритм произвольной выборки отказывается работать в БСП.
БСП — библиотека стандартных подсистем. В частности, имеет своем составе подсистему «Обмен данными», данная подсистема реализует механизмы автоматической синхронизации данных между конфигурациями, по правилам написанным в Конвертации данных.
- Создаем ПВД со Стандартным алгоритмом выборки;
- Указываем объект выборки;
- Пишем обработчик «Перед выгрузкой»(хочу подчеркнуть, что нужно использовать именно этот обработчик). Например, следующего содержания:
Большую часть этого обработчика, как вы можете видеть, занимает отбор данных необходимых для выгрузки. Тут и множество фильтров: по подразделениям, по видам расчетов и механизм разбиения одного документа «источника» на несколько документов «приемника». Если коротко, то в данном примере табличная часть одного документа «источника» разносится по табличным частям нескольких документов «приемника», а значением разбиения данных является значение Подразделения.
Для удобства работы при отборе данных мы использовали Таблицу значений, наш алгоритм подразумевает ПКО с получением данных из «входящих данных», которые будут переданы в функцию ВыгрузитьПоПравилу, поэтому в соответсвующем алгоритме мы производим перевод Таблицы значений в Массив структур.
На следующем шаге мы обходим отобранные данные и вот уже в этом месте мы используем нашу функцию ВыгрузитьПоПравилу. Параметр Документ, здесь является структурой, которую мы передаем как входящие данные, а второй передаваемый нами параметр, это название ПКО, которому мы передаем наши данные.
В самом конце мы отменяем выполнение стандартной выгрузки, так как все необходимые данные связанные с объектом выборки мы уже выгрузили.
Тем самым мы сохраняем функциональность регистрации изменений — документ изменился, зарегистрировался для выгрузки, данные выгрузили. И в то же время делаем произвольный отбор необходимых нам данных.
Выгрузка Регистр сведений -> Регистр сведений с зависимостью от переноса другого объекта.
Типичным примером такой задачи является перенос контактной информации физического лица. Простейший способ решения задачи — это перенос всех «Физических лиц» и всего регистра сведений «Контактная информация» физических лиц. Что делать если нам необходимо переносить не всех физических лиц? Например, только тех физических лиц, которые упоминаются в каком-либо переносимом нами документе. В таком случае, как известно, ПКС документа вызывает ПКО справочника «Физические лица» и тем самым обеспечивается перенос физических лиц упоминаемых в документе.
В переносе «Контактной информации» физических лиц в данной ситуации может помочь функция ВыгрузитьРегистр, очень похожая на функцию ВыгрузитьПоПравилу.
Хочу отметить, что потребность в использовании функции ВыгрузитьРегистр у меня появилась, когда я начал адаптировать правила под БСП уже отлаженные на обработке Универсальный обмен XML. Регистры через обработку спокойно выгружались с использованием функции ВыгрузитьПоПравилу, но БСП ни как не хотело правильно понимать такую выгрузку, в результате чего пришлось переписывать код через ВыгрузитьРегистр.
В обработчике»После выгрузки в файл» ПКО «Физические лица», пишем код следующего вида:
Как видно, в коде отбираются все записи регистра сведений, относящиеся к текущему выгружаемому Физическому лицу, а полученная выборка обходится в цикле.
Для того, чтобы выгрузить записи регистра сведений через функцию ВыгрузитьРегистр, необходимо подготовить структуру НаборЗаписей, которая имеет два поля: Отбор и Строки.
ПКО «КонтактнаяИнформация» имеет следующий вид:
Выгрузка Табличная часть -> Регистр сведений.
По своему решению задача аналогична предыдущей. С той лишь разницей, что информацию для регистра сведений «приемника» брать придется из других объектов «источника», а точнее табличной части того объекта, который на данный момент выгружается. Если бы на стороне «приемника» была так же табличная часть, то задача легко решалась бы в виде ПГКС. Поэтому снова воспользуемся функцией ВыгрузитьРегистр.
Рассмотрим пример переноса информации по ученым степеням Физического лица. Опять создаем код в обработчике «После выгрузки в файл» ПКО «Физические лица». Так как задача аналогичная предыдущей привожу только, код отбора и выгрузки данных из обработчика:
Выгрузка Табличная часть -> Документ.
Предположим, в «источнике» информация для переноса хранится в менее детализированном виде, чем в приемнике, но достаточном для переноса. Например, мной решалась задача по переносу информации об образовании физических лиц из ЗиКБУ в Университет. Понятно, что на стороне кадровой программы нужна минимальная информация об образовании физических лиц, главное что сотрудник обладает необходимой квалификацией и хватит. А вот на стороне университета, информация об образовании, а точнее о дипломах хранится куда более подробно, в связи со спецификой учереждения.
И опять задача решается, при помощи все той же функции ВыгрузитьПоПравилу.
Вот пример выгрузки Дипломов физических лиц. Все тот же обработчик «После выгрузки в файл» ПКО «Физические лица», пишем следующий код:
В общем, как вы понимаете, можно приводить еще много вариаций перегрузок: справочники, документы, регистры. Главное, надо понимать, что не стоит фанатично бросаться на функции ВыгрузитьПоПравилу и ВыгрузитьРегистр.
Замечания по перегрузке.
1. У меня возникли сложности при использовании правил в БСП, в части выгрузки объектов по ссылкам, проблема решилась принудительной установкой параметра ВыгрузитьОбъект в значение Истина, для каждого ПКС ссылочного типа:
Подводим итоги. Когда использовать эти функции?
- Вам необходимо перегрузить объекты с сильно различной структурой или на стороне «источника» необходимо собирать объекты для выгрузки из разных объектов.
- Вам необходимо перегружать объекты с привязкой к выгрузке других объектов.
UPDATE от 11.11.2015
А что если оптимизировать выше написанное?
Пишу дополнение к статье, после оставленного пользователем TarasovAV комментария. Данный пользователь заметил, что можно оптимизировать выгрузку связанной информации, путем накопления списка тех объектов, информацию о которых надо будет отдельно выгружать, а потом через один запрос отобрать сразу всю информацию.
Описываю алгоритм предложенный вышеуказанным пользователем:
1. В правиле конвертации «После загрузки правил обмена», создается параметр типа ТаблицаЗначений, в который будет накапливаться список объектов, для которых в последующем будет выгружаться информация:
2. В в обработчике «После выгрузки» ПКО «Физические лица» (именно для них в примерах мы выгружаем контактные данные, образование и т.п.), мы пополняем нашу таблицу значений новым физическим лицом, проверяя перед этим, а не добавлено ли уже это физическое лицо в таблицу:
3. И финальным действием, будет непосредственная выгрузка информации, только уже с отбором по все физическим лицам сразу. Для этого все обработчики, что были приведены выше начиная, необходимо перенести в правило конвертации «После выгрузки данных», запросы же необходимо изменить, чтобы в них проверялось не равенство одному элементу, а вхождение значения реквизита в массив элементов:
Обратите внимание, как изменилась установка параметра запроса и проверка условия в запросе:
В статье рассказываю:
1) о механизмах и транспорте обмена данными, где одной из сторон обмена выступает конфигурация на базе 1С, и о том, какой транспорт и в каких случаях лучше использовать
2) о решении задачи выгрузки данных документа «Зарплата к выплате организаций» (с выгрузкой банковский счетов физ лиц документа) из ЗУП 2.5.123.1 (далее Источник) в БП КОРП 3.0.52.39 (далее Приемник) путем создания правил обмена данными с использованием конфигурации «Конвертация данных» (далее просто КД) ред. 2.1.8.2. для (далее ЗкВО)
3) о тестирование полученных правил обмена данными.
1) РИБ — между идентичными конфигурациями, реализован на уровне платформы.
2) Универсальный механизм обмена между конфигурациями — основан на объекте платформы 1С 8.х именуемым «план обмена»; обмен данными осуществляется с помощью правил xml, которые создаются в специальной конфигурации — Конвертация данных (ред. 2.х и 3.х). С помощью данного механизма можно реализовать как одноразовый обмен, так и постоянный обмен между 1С конфигурациями. Механизм реализован на уровне конфигурации, встроить в свою конфигурацию можно из технологической конфигурации БСП.
4) Прямое подключение (COM) — обмен осуществляется через прямое подключение одной базы к другой по средствам COM соединения;
Особенности и ограничения СОМ :
в) дружит COM только с ОС Windows.
Транспорт для обмена данными не бывает «плохим или хорошим», «устаревшим или передовым». Бывает транспорт оптимально подобранный для решения задачи или не оптимально.
Оптимально будет использовать для транспорта данных прямое СОМ подключение к базе Приёмнику: в этом случае нам не придется вносить изменения в конфигурации Источника и Приемника, и нам не нужно беспокоиться за передачу файлов и их безопасность, т.к. данные будут выгружаться напрямую.
Последовательность действий тут такая: создаем правила обмена данными, настраиваем планы обмена для регистраций изменений данных в базах, включаем расписание выгрузки данных. Данные выгружать можно по расписанию или по желанию пользователя.
Более подробно о создании правил обмена данными с помощью конфигурации «1С:Ковертация данных» ред. 2.1 расскажу ниже.
2.2 Задача: обмен между ERP 2.0 и Документооборотом КОРП
Важно понимать, что возможности Web -сервисов, заложенные в этих типовых конфигурациях, не безграничны, и что может появиться задача, которую будет быстрее / проще решить, используя COM или что-то еще .
Коробочная конфигурация на базе 1С, как правило, не содержит никаких специализированых средств интеграции с порталом на MS SP , поскольку порталы это штучная «костомная» вещь. Однако, платформа 1С поддерживает такие типы метаданных, как Web -сервисы и XDTO -пакеты. Мы можем создать в конфигураторе 1С Web -сервис задать для него URI пространства имен и пакет XDTO , добавить для Web -сервиса нужные операции и параметры операций, описать для каждой операции функции желательно с названиями на латинице в модуле Web -сервиса, которые будут доступны со стороны MS SP .
Рисунок 2.3.1 – Настройки Web -сервиса в конфигураторе 1С
Далее из конфигуратра 1С делаем публикацию на Web -сервере.
Администратор MS SharePoint создает интеграционный пакет, подключается к публикации на Web -сервере (как пользователь с полными правами, которого специально создали в конфигураторе 1С) и используя функции, которые создал программист в 1С в модуле Web -сервиса, получает необходимые данные.
Рисунок 2.3.2 – Пример ннтеграционного пакет в MS SharePoint
В примере на рисунке администратор MS SharePoint данные с web -сервера получает в формате XML через файл, хотя может читать данные напрямую в параметр. Конечно, лучше не в формате XML , а JSON , но не принципиально.
Когда в штате нет специалистов по SAP и/или когда мы имеем доступ к SAP только как пользователи, и требуется выгрузить консолидированные данные из 1С в SAP:
Если же в штате есть программист SAP: SAP поддерживает внешнее подключение — аналог хранимых процедур sql, который позволяет получать данные напрямую из Sap, без промежуточных выгрузок/загрузок в Excel. На ABAP в Sap пишется функция, а далее программисты 1с получают через нее необходимые данные и далее обрабатывают их в своих учетных системах. Спсб aspirator 23, который написал это в комментариях.
3.1 Постановка задачи
* Если текст тяжело воспринимать, то смотрите сразу пункт 3.2, там задание визуализировано.
1. Из программы ЗУП 2.5 (Источника) в БП КОРП 3.0 (Приемник) требуется выгружать выбранные пользователем документы типа «Зарплата к выплате организаций» (далее ЗкВО), которые должны быть проведены и со способом выплаты «Через банк».
2. Если в документе ЗкВО реквизит «Банк» заполнен служебным элементом «Другие банки», то в Приемнике создается столько же документов, сколько строк в табличной части одного документа ЗкВО в базе Источнике. Если в документе ЗкВО реквизит «Банк» заполнен любым другим конкретным значением, тогда один документ Источника выгружается в один документ Приемника. Другими словами, выгрузка должна идти по правилам "один в несколько документов" или "один в один документ" в зависимости от банка, заданного в документе ЗкВО в Источнике.
3. Для всех физ лиц из табличной части документа ЗкВО Источника требуется выгрузить лицевые счета в базу Приемник, но только если в документе ЗкВО реквизит «Банк» заполнен конкретным значением (не «Другие банки»).
4. В базе Приемнике требуется для выгруженных физ лиц из документа, которые в базе Источнике имеют строго один лицевой счет по указанной в документе организации, установить реквизит «Основной счет», но только в том случае, если базе Приемнике у физ лица в банковских счетах не более одного счета с тем же номером, который был перегружен из Источника (банк значения не играет).
Комментарий по 4 пункту задания: если в базе Приемнике у физ лица несколько счетов с одинаковым номером счета, но с разными банками (головной и филиалы в городе проживания физ лица), то обмен не должен менять флаг "Основной счет" — потому, что физ лицо имело действующий мастер счет ранее открытый в городе проживания в филиале банка, имеющий БИК который отличается от БИКа банка-участника зарплатного проекта.
Последовательность действий при выгрузки данных визуализирована на блок-схеме, Рисунок 3.2.1.
Рисунок 3.2.1 – Блок-схема выгрузки данных
Текст всех процедур содержится в правилах выгрузки данных, которые можно скачать внизу статьи.
4.1 Вносим изменения в конфигурации Источника и Приёмника, если того требует задача
Для реализации повторного поиска ранее выгруженных документов и для реализации пометки на удаления документов в базе Приемнике, для реализации выгрузки типа "один документ во много документов", в базе Приемнике нужно в документе "Ведомость в банк" в режиме конфигуратора создать два реквизита типа строка длиной 36 символов и назвать их: УИДДокументаЗУП и УИДСотрудникаТабЧастиДокументаЗУП.
В справочнике «Конвертации» создаем папку «ЗУП 2.5 -> БП КОРП 3.0», а в нее добавляем новый элемент:
При записи новой конвертации появится окно помощника создания правил. Откажитесь от автоматического создания правил! Перед вами откроется окошко с пустыми закладками, в которых мы будем создавать правила обмена.
4.3. Создаем правила выгрузки данных (ПВД)
Определим сколько Правил Выгрузки Данных (ПВД) нам нужно создать. Для этого ответим на один вопрос: какие данные нам может потребоваться фильтровать по ссылке при выгрузке данных? – Только документ «Зарплата к выплате организаций» (ЗкВО). Остальные данные (банковские счета, физ лица и пр.) будут тоже выгружаться, но ТОЛЬКО потому, что ссылки на них содержаться внутри документа «Зарплата к выплате организаций». Т.е. мы никак не должны руками фильтровать физ лица, они должны выгружаться поскольку содержаться в табличной части документа. ПВД – подтягивается в специальную таблицу обработки «Универсальный обмен данными». Обратите внимание, что в обработке можно задать фильтр на ссылку документа ЗкВО (или подчиненные ему реквизиты Ссылки).
4.4 Создаем Правила Конвертации Объектов (ПКО) и Правила Конвертации Свойств (ПКС).
На закладке ПКО нажмем кнопку Добавить
При попытке записать новое ПКО появится окно «Создать ПКС?», в котором нажимаем ДА.
Сразу после появится окно «Создать ПВД?» — нажимаем НЕТ.
В результате на зкладке ПКО будет созданы элементы:
Символ «Лупа» означает, что при загрузке документа поиск ранее выгруженного документа в Приемнике будет делаться по УИДу. Нам так не надо! У нас задача сделать выгрузку один ко многим или один в один. Поэтому кликаем дважды по ПКО «ВедомостьНаВыплатуЗарплатыВБанк», открываем закладку «Настройки», снимаем флаг «Искать объект приемника по внутреннему идентификатору» и ставим флаг «Автоматически генерировать номер и код».
Аналогично рассуждаем нужно ли искать по УИД справочники: у моего заказчика исторически ключевым полем поиска элементов всех справочников был «КОД». Это не очень хорошо, поскольку КОД пользователи могут менять в отличие от УИДа. Но ничего не поделаешь – если я оставлю настройку поиска по УИД, то это может привести к задвоению справочников в Приемнике. Заходим в ПКО справочников и снимаем флаг «Искать объект приемника по внутреннему идентификатору». Поскольку новые элементы справочников создаются в базе БП КОРП (Приемник) и эта база является главной по отношению в ЗУП (Источник), то для справочников ставим флажки «Не замещать существующие объекты в приемнике, а только создавать новые» и «Не создавать новый объект, если он НЕ найден». У вас может быть иная специфика. Справочники «Организации» и «Пользователи» содержат мало элементов (до 1000), поэтому поставим флаг «Использовать быстрый поиск объекта при выгрузке и загрузке».
Создадим ПКС для ПКО «ВедомостьНаВыплатуЗарплатыВБанк». Колонку «Источник» для всех ПКС очистим, а в колонке «Получать из входящий данных» поставим везде флажок – мы это делаем потому, что выгружать документ будем используя процедуру ВыгрузитьПоПравилу(, , ИсходящиеДанные, , " ВедомостьНаВыплатуЗарплатыВБанк "); , которую поместим в обработчик «Перед выгрузкой» ПВД (об этом подробнее ниже). Мы полностью берем на себя подготовку исходящих данных на стороне Источника, отказываясь от конструктора – только так мы сможем реализовать выгрузку «один во много» или «один в один» в зависимости от наполнения выгружаемого документа.
Добавляем ПКС для ПКО «ВедомостьНаВыплатуЗарплатыВБанк» исходя из условия задачи, и ставим флажки «Поиск» в строчках с ПКС « УИДДокументаЗУП», «УИДСотрудникаТабЧастиДокументаЗУП », «Организация». В результате должно получиться как показано на рисунке ниже.
Если у вас не получилась так, как показано на рисунке выше, то скачайте себе из этой статьи (в самом низу) уже сделанные правила обмена данными и подгрузите их в вашу конфигурацию «Конвертация данных» ред. 2.1.
Зайдем в ПКО « ВедомостьНаВыплатуЗарплатыВБанк » и напишем код в процедуре «После загрузке». Его смысл в том, что реквизит «Округление» в Приемнике одинаков для всех документов, поэтому проще заполнить его непосредственно на стороне Приемника после загрузки данных. Та же логика и для установки нового номера.
4.5 В ПВД реализуем две логики выгрузки данных документа в процедуре «Перед выгрузкой», используя процедуру ВыгрузитьПоПравилу(…)
В ПВД в процедуре «Перед выгрузкой» подготавливаем структуру «ИсходящиеДанные» и реализуем две логики выгрузки «один во много документов» и «один в один» в зависимости от содержания документа.
После заполнения структуры ИсходящиеДанные , вызываем процедуру
ВыгрузитьПоПравилу(, , ИсходящиеДанные, , "СозданиеВедомостейВБанк");
К сожалению, у Вас недостаточно прав для дальнейшего просмотра.
Если Вы приобрели курс, но еще не активировали токен — пожалуйста, активируйте доступ по инструкциям, высланным на Ваш email после покупки.
Если Вы не залогинены на сайте — залогиньтесь, вернитесь на эту страницу и обновите ее.
Если Вы залогинены, у Вас активирован токен доступа, но Вы все равно видите эту запись — напишите нам на e-mail поддержки.
Комментарии / обсуждение (143):
Здравствуйте.
При настройки отладки обработчиков при загрузке не формируется “Модуль отладки загрузки”
…
(текст комментария доступен только участникам Мастер-группы)
…
(текст комментария доступен только участникам Мастер-группы)
КонвертацияОбъектовИнформационныхБаз как найти?
Ее нет в конфигураторе Конвертации?
…
(текст комментария доступен только участникам Мастер-группы)
Извиняюсь заранее если вопросы кажутся глупыми.
Открываю Конфигуратор Конвертации
Захожу в Глобальный поиск меню Правка ввожу ПроизвестиЧтениеДанных()
Надеюсь найти все вхождения этой процедуры в Конфигурации
Результата нет
Что делаю не так и как правильно?
…
(текст комментария доступен только участникам Мастер-группы)
У меня к сожалению не получилось войти в отладчик, как было показано на уроке, хотя я повторил все действия.
Мне бы для начала зайти в отладчик при загрузке объекта.
Пока в моем представлении алгоритм работы системы такой:
Конвертация готовит XML файл содержащий Правила и Список Объектов
Этот файл мы открываем в УОД, которая его обрабатывает
Как отловить этот момент.Мне хочется на примере простой конвертации пройти по коду и посмотреть процесс.
Но не получается войти даже в отладчик.В доп материалах, есть видео, где автор показывает, как исправив ошибку в наименовании флага в форме попасть в отладку.Нашел этот фрагмент и кажется все правильно.
Но в отладчик не вхожу.Есть ли способы попасть в отладку миную штатные средства.Ведь ясно же ,что автор нашел ошибку в коде, прогнав УОД через отладку
…
(текст комментария доступен только участникам Мастер-группы)
Спасибо за терпение, в отладчик попал.
Пока через код обработки УОД.
.Конвертация 2.1.8.2
Не могу попасть в отладчик со стороны загрузки
…
(текст комментария доступен только участникам Мастер-группы)
Добрый день. В ПКО для ПланаВидовХарактеристик пишу
ОписаниеТипов = Новый ОписаниеТипов("СправочникСсылка.Сотрудники");
УзелТипы = одПолучитьXMLПредставлениеОписанияТипов(ОписаниеТипов);
ДобавитьПодчиненный(Приемник, УзелТипы);
В источнике у меня справочник называется СотрудникиПоставщиков, а в приемнике Сотрудники. Поскольку я нахожусь на стороне базы источника (в обработчике ПриВыгрузке), когда я пытаюсь передать в ОписаниеТипов СправочникСсылка.Сотрудники, пишет про несоответствие типов, и правильно, потому что в базе источнике нет такого типа. А если я в описании типов передаю СправочникСсылка.СотрудникиПоставщиков, то при выгрузке не ругается, но зато ругается при загрузке, потому что в базе приемнике нет такого типа СправочникСсылка.СотрудникиПоставщиков. Если в обеих базах справочник называется одинаково, проблемы не возникает. Если вот так:
УзелТипы = СоздатьУзел("Типы");
УзелТип = СоздатьУзел("Тип");
УзелТип.ЗаписатьТекст("СправочникСсылка.Сотрудники");
ДобавитьПодчиненный(УзелТипы, УзелТип);
ДобавитьПодчиненный(Приемник, УзелТипы);
то проблемы тоже не возникает.
Но все таки, как использовать функцию одПолучитьXMLПредставлениеОписанияТипов в случае когда справочники в разных базах называются по разному?
Я попробовал задачу 1.7.3 решить с помощью разных ПВД. В первом варианте создал ПВД и соответствующее ПКО «БухгалтерскаяОперация_ВыгрузитьПоПравилу». Во втором варианте изменил структуру ВыборкаДанных и напрямую в ПКО «БухгалтерскаяОперация_УказаниеПравила» указал соответствующее правило выгрузки. И для теста создал 2-ой документ «Инвентаризация».
В первом варианте все выгрузилось без проблем. Во втором варианте выгрузился только 1 документ (но в решении преподавателя (и его правилах) все выгрузилось, буду искать ошибку).
С точки зрения оптимальности, какое лучше ПВД применять на реальных задачах?
…
(текст комментария доступен только участникам Мастер-группы)
Добрый день!
Возникла сложность при выполнении дз 1.7.1
Я решил выполнять задачу через уже имеющееся ПВД “Контрагенты”, что бы при переносе конкретных контрагентов выгружать их значения свойств “КлассВажности” и “ОсновнойМатериал”. За исключение ПВД, остальное решение практически полностью совпадает с решением преподавателя, но по факту, при загрузке данных на стороне приемника я получаю ошибку – Ошибка при загрузке данных: : Поле объекта не обнаружено» которую не смог отловить. Но данные по первому из 2х контрагентов перенеслись.
В связи с этим возникло 3 вопроса:
1) Можно ли в данной задаче использовать ПВД “Контрагенты”?
2) Если можно использовать ПВД “Контрагенты”, как оптимальнее – использовать его или создавать новое (как в решении преподавателя) ? Плодить много ПВД мне кажется тоже не совсем правильно, раз в данном случае данные в реквизитах Контрагента, почему бы их и не перенести с ПВД “Контрагенты”.
3) Если можно использовать ПВД “Контрагенты”, не сможете подсказать, где у меня ошибка в моих правила? Потратил кучу времени, но так и не смог понять где она.
…
(текст комментария доступен только участникам Мастер-группы)
Загрузил с сайта разработанные правила и там такая же ошибка получается. Подскажите в чем проблема?
…
(текст комментария доступен только участникам Мастер-группы)
Я дописал ветку иначе стало выгружать но на 1 объект меньше чем в видео у меня 18 объектов выгружает а не 19. Кто не прав в видео дальше комментируется и вопрос просто рано возник?
…
(текст комментария доступен только участникам Мастер-группы)
Добрый день.
Делаю обмен данными договоров из 1С Документооборот (2.1.9) в 1С УПП (1.3.86).
Аналогично уроку 1.7.1 настроила ПКО: спр.ВнутренниеДокументы->спр.ДоговорыКонтрагентов (ДоговорыКонтрагентов), РС.ЗначенияСвойствОбъектов, ПВХ.СвойстваОбъектов, ПВХ.НазначенияСвойствКатегорийОбъектов, спр.ЗначенияСвойствОбъектов, а так же РС.КатегорииОбъектов, спр.КатегорииОбъектов.
Основная выгрузка ПВД – ВнутренниеДокументы->ДоговорыКонтрагентов.
В ПКО.ДоговорыКонтрагентов доп.свойстве ПКС.Сумма ПередВыгрузкой передаю данные в ПКО РС.ЗначенияСвойствОбъектов:
ИсходящиеДанные = Новый Структура("Объект, Свойство, Значение");
ИсходящиеДанные.Свойство = "10 СуммаДоговора(руб)";
ИсходящиеДанные.Значение = Источник.Сумма;
ИсходящиеДанные.Объект = Источник.Ссылка;
В ПКО РС.ЗначенияСвойствОбъектов значение ПКС.Объект (в уроке он назывался Контрагент) передается ссылка на договор контрагента и не находит в уже выгруженных данных и поэтому зацикливается.
Что нужно сделать, чтобы убрать цикличность ссылок?
…
(текст комментария доступен только участникам Мастер-группы)
Благодарю за быстрый ответ.
Использовала ПКС, поскольку аналогичные реквизиты Внутреннего документа из ДО должны загрузиться в соответствующие свойства объектов или категории объектов. Поэтому, ВыгрузитьПоПравилу() тут не подойдет. РС в РС не выгружается, а заполняется из данных справочника ВнутренниеДокументы.
Нашла свою ошибку: дописала предопределенное значение у ПВХ Назначения свойств и т.п., убрала галку запоминать выгруженные элементы для ПКО.ДоговорыКонтрагентов – из-за этого была зацикленность)).
Добрый день!
задание 1.7.1 делаю для начала по одному реквизиту по уроку 1.8.1
для Класс важности “Значение” не переносится
для Основной материал без проблем
В чем особенность? В том, что в справочнике Класс важности предопределенные значения?
каким уроком пользоваться для решения этого задания?
…
(текст комментария доступен только участникам Мастер-группы)
Так как занятие финальное для модуля, посвященного основам переноса данных, задам пару общих вопросов, приближенным к реальным условиям переноса:
1. Задача: В основной базе есть справочник “Номенклатура” – 1 млн элементов по группам. Предприятие внедряет отраслевое решение в другой ИБ и возникла необходимость синхронизации НСИ между основной базой и отраслевой ИБ. Структура метаданных идентична.
Переносить всю Номенклатуру нет смысла. Стоит задача перенести только группу “Для переноса”, в которой 500 000 элементов.
Вопрос: Есть 2 подхода:
1. Добавить условный оператор в обработчик ПКО “Перед Выгрузкой”:
Если Источник.Родитель В ИЕРАРХИИ “Для Переноса” Тогда Переносим Иначе Отказ = Истина.
2. Добавить в ПВД произвольный алгоритм выборки нужных элементов и их переносить через ПКО.
В первом подходе будут перебираться все элементы справочника. Второй по скорости должен быть оптимальнее.
Если третий вариант решения задачи, который будет также прост как первый, но также оптимален как второй.
И второй вопрос:
После переноса всех необходимых справочников нам необходимо перенести документы Поступления. Мы заранее уверены, что все ссылочные Типы свойств уже есть в конечной базе. Как нам явно указать, что необходимо переносить только ссылки на объекты без дальнейшего вызова их ПКО и обработки.
На ум приходит только в обработчике ПКС ПередВыгрузкой указать параметр = ЛОЖЬ:
ВыгрузитьОбъект – Булево – Если Истина, то объект выгружается целиком. Если Ложь, то выгружается только ссылка.
Читайте также: