1с конвертация данных составной тип данных
Если реквизит составного типа, то проверка реквизита на заполненность значением выполняем только с помощью функции ЗначениеЗаполнено() .
Ответ таков: когда у составного реквизита тип не выбран, то он имеет значение Неопределено , поэтому проверки типа ПустаяСтрока(Реквизит) Или Реквизит.Пустая() могут сгенерировать исключительную ошибку.
2) Построение запроса
Если в запросе реквизит составного типа участвует в отборах или в соединениях, то следует использовать функцию ВЫРАЗИТЬ (), что уменьшит время выполнения запроса.
Ответ таков: в таких условия система производит левое соединение реквизита с таблицами, которые указаны в его типе, а потом уже отсекает лишние записи. Добавив функцию ВЫРАЗИТЬ в запрос, мы явно указываем с какой таблицей выполнять левое соединение. Умно выражаясь, данная функция выполняет приведение значения к определенному типу.
Синтаксис функции: ВЫРАЗИТЬ ( <Выражение> КАК <Тип значения> ) .
Пример.
У справочника ТочкиКартыМаршуртаБизнесПроцесса имеется реквизит ВладелецТочки , который имеет составной тип: СправочникСсылка.ШаблоныБизнесПроцессов , БизнесПроцессСылка.БизнесПроцессУниверсальный . Требуется получить выборку, содержащая информацию о всех точках маршрута, которые относятся к шаблонам бизнес-процессов, а так же наименования этих шаблонов:
Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
| ВЫРАЗИТЬ(ТочкиКартыМаршрутаБизнесПроцесса.ВладелецТочки КАК Справочник.ШаблоныБизнесПроцесса).Наименование КАК ШаблонБизнесПроцесса,
| ТочкиКартыМаршрутаБизнесПроцесса.Наименование КАК НаименованиеТочкиМаршрута,
| ТочкиКартыМаршрутаБизнесПроцесса.ВидТочки КАК ВидТочкиМаршрута
|ИЗ
| Справочник.ТочкиКартыМаршрутаБизнесПроцесса КАК ТочкиКартыМаршрутаБизнесПроцесса
|ГДЕ
| ВЫРАЗИТЬ(ТочкиКартыМаршрутаБизнесПроцесса.ВладелецТочки КАК Справочник.ШаблоныБизнесПроцесса) ЕСТЬ НЕ NULL
| И НЕ ТочкиКартыМаршрутаБизнесПроцесса.ПометкаУдаления";
Пока ВыборкаДетальныеЗаписи.Следующий() Цикл
// Вставить обработку выборки ВыборкаДетальныеЗаписи
КонецЦикла;
3) Проявление отрицательной стороны
При задании составного типа реквизиту старайтесь избегать включения в составной тип примитивных типов (число, булево, строка). Смешивая ссылочные типы с примитивными, увеличивается размер базы данных (создаются дополнительные колонки в таблице реляционной БД), может пострадать индексация реквизита (включение с составной тип неограниченной длины строку). Все это повлияет на производительность.
Чтобы выгрузить один объект источника в несколько объектов приемника, можно использовать мощный инструмент расширения возможностей правил конвертации – «ВыгрузитьПоПравилу».
Синтаксис функции:
Пример реальной задачи. Необходимо выгрузить справочник – «НоменклатурныеГруппы» в три объекта на стороне приемника: «НоменклатурнаяГруппа» (справочник), «ЗаказНаПроизводство» (документ), «СтатусыЗаказов» (регистр сведений). Для решения данной задачи можно использовать функцию «ВыгрузитьПоПравилу».
В правилах выгрузки данных (далее-ПВД) в обработчике «ПередОбработкой» происходит выгрузка в объект приемника «НоменклатурнаяГруппа» по стандартной выгрузке (ИмяПКО), а в обработчике «ПослеВыгрузки» происходит выгрузка в объекты «ЗаказНаПроизводство» и «СтатусыЗаказов» с помощью функции «ВыгрузитьПоПравилу»:
Если необходимо выгрузить иерархический справочник (элементы и папки) с учетом иерархии и поиск в базе приемника будет осуществляться по внутреннему идентификатору объекта источника (по полям поиска не будет продолжен поиск), то для корректной выгрузки иерархии необходимо установить галочку – «Поиск» у реквизита «ЭтоГруппа» (см. рисунок 1).
Рисунок 1 – Выгрузка иерархического справочника.
Если не установить галочку «Поиск» у реквизита «ЭтоГруппа», то папки объекта будут выгружаться как элементы.
3. Реквизиты объекта для правил регистрации объектовОбъекты регистрируются по правилам регистрации объектов к выгрузке только при изменении реквизитов объекта, которые указаны в правилах конвертации свойств (далее-ПКС) объекта (правила обмена данными). При необходимости регистрировать объект к выгрузке и при изменении реквизитов, которые не указаны в ПКС, достаточно данные реквизиты добавить в ПКС и установить галочку – «отключить» (см. рисунок 2).
Рисунок 2 – Реквизиты объекта для правил регистрации объекта.
Это может потребоваться для задачи, когда у нас есть реквизиты на стороне базы источника, которых нет в базе приемника, и только при их изменении объекты должны регистрироваться к обмену.
4. Зарегистрировать объект к выгрузке другим объектом (объектами)Когда стоит задача выгружать вместо регистрируемого объекта другой объект, то при регистрации исходного объекта в правилах регистрации объектов в обработчике «ПослеОбработки» через метод «ЗарегистрироватьИзменения» плана обмена можно зарегистрировать необходимый объект на узлах плана обмена.
Синтаксис метода:
ЗарегистрироватьИзменения (Узлы, Данные)
Пример реальной задачи. Несколько документов «Списания с расчетного счета» по одному документу «Заявка на расходование ДС» необходимо выгружать из конфигурации источника в один документ «Списания с расчетного счета» конфигурации приемника. При изменении документа «Списания с расчетного счета» регистрируется к обмену документ «Заявка на расходование ДС», который при выгрузке собирает по определенным правилам данные со всех документов «Списания с расчетного счета».
В продолжение пункта 4. При выгрузке любого объекта происходит проверка, соответствует ли он существующим правилам регистрации. Если при регистрации вместо исходного объекта регистрируется к выгрузке другой объект, то новый объект также будет проходить проверку по своему типу правил регистрации объектов. В случае несоответствия правилам регистрации, объект будет выгружать, как «УдалениеОбъекта».
Для устранения данной нестыковки выгружаемого объекта и правил регистрации объекта, нужно использовать в правилах регистрации в обработчике «ПослеОбработки» параметр «Выгрузка».
Описание параметра Выгрузка:
Выгрузка (только чтение) – Булево – параметр определяет контекст выполнения правила регистрации. Истина – правило регистрации выполняется в контексте выгрузки объекта. Ложь – правило регистрации выполняется в контексте перед записью объекта.
Пример реальной задачи. При изменении документа «Списания с расчетного счета» регистрируется к обмену документ «Заявка на расходование ДС», который при выгрузке собирает по определенным правилам данные со всех документов «Списания с расчетного счета». Но документ «Заявка на расходование ДС» может выгружать независимо по своим правилам регистрации, которые не совпадают с правилами регистрации при регистрации из документа «Списания с расчетного счета».
6. Выбор правила конвертации объектов по умолчаниюЕсли по одному объекту источнику в правилах конвертации объектов присутствуют несколько правил, то система будет использовать по умолчанию правило, которое совпадает по наименованию с наименованием объекта источника (см. рисунок 3).
Рисунок 3 – Выбор правила конвертации объекта по умолчанию.
Пример реальной задачи. Данный подход может пригодиться при выгрузке субконто, когда система определяет правила выгрузки объекта по умолчанию.
7. Создание документов (справочников) через ПКО на стороне приемникаПри необходимости создавать на стороне приемника новые элементы документов (справочников) и подставлять их в исходный объект, можно применить следующий подход:
- определить правило заполнения нового документа (справочника) на стороне приемника (например, через входящие данные);- описать заполнение реквизита нового документа (справочника) в исходном объекте (например, через исходящие данные);
- заполнять при выгрузке на стороне источника новый документ (справочник) уникальным значением (например, числом).
Пример реальной задачи. Необходимо на стороне приемника создавать новые документы «ДокументРасчетовСКонтрагентом» в документе ввод начальных остатков по счетам взаиморасчетов. На стороне источника заполняем реквизит «ДокументРасчетовСКонтрагентом» при выгрузке начальных остатков по счетам взаиморасчетов уникальным значением (числом):
В исходном объекте («ВводНачальныхОстатков») описываем правила выгрузки реквизита «ДокументРасчетовСКонтрагентом»:
Определяем правило заполнения «ДокументаРасчетовСКонтрагентом» на стороне приемника (см. рисунок 4).
Рисунок 4 – Правили выгрузки «ДокументРасчетовСКонтрагентов».
В конвертации данных нельзя создать параметр с типом «ТаблицаЗначений» на вкладке «Параметры» (см. рисунок 5).
Рисунок 5 – Допустимые типы для параметров конвертации данных.
Возможность создать параметр с типом «ТаблицаЗначений» при необходимости присутствует в системе, необходимо в общем обработчике «ПередЗагрузкойДанных» определить параметр.
Также необходимо в общем обработчике «ПослеЗагрузкиДанных» удалить данный параметр.
При выгрузке из базы источника можно указывать вместо элемента перечисления или предопределенного значения справочника текстовое значение, которое равно наименованию элемента перечисления или предопределенного значения справочника.
Пример реальной задачи. В базе приемника присутствует реквизит – «ТипПлатежа» с типом «Перечисление». При выгрузке реквизита (обработчик: «Перед выгрузкой») можно указать текстовое значение равное наименованию элемента перечисления на стороне базы приемника (см. рисунок 6). Данный подход может ускорить процесс разработки в конвертации данных.
Рисунок 6 – Заполнение реквизита с типом «Перечисление».
10. Ускорение процесса выгрузки с помощью параметра «ВыгрузитьОбъект» («ВыгрузитьТолькоСсылку»)Когда необходимо выгрузить большой объем данных и нет необходимости выгружать полностью ссылочные данные, то можно сократить объем выгружаемых данных с помощью параметров «ВыгрузитьОбъект» («ВыгрузитьТолькоСсылку») в обработчике «ПриВыгрузке» правил конвертации свойств (ПКС):
Пример реальной задачи. Данное ускорение может потребоваться, когда все ссылочные объекты (нормативно-справочная информация) из базы источника ежедневно интегрируется в базу приемника, а документы должны транслироваться с определенным интервалом (раз в месяц). В таком случае при обмене документами между базами нет необходимости полностью передавать ссылочные объекты, а можно передавать только ссылку, что ускорит процесс выгрузки.
Рассмотренные приемы работы позволят повысить производительность и эффективность работы с программой конвертацией данных 2.1.
Статью подготовил Аналитик-эксперт по информационным системам "ИнфоСофт" Ретунский Александр.
1. Группы правил.
В КД2 разделение по объектам метаданных происходило автоматически. В КД3 для удобства необходимо создать группы правил разделив их по объектам метаданных.
2. XDTO. Ключевые свойства и обязательные поля.
В КД3 обмен настраивается через универсальный формат (EnterpriseData). И поэтому при настройке обмена нужно смотреть состав пакета XDTO EnterpriseData.
Рассмотрим для примера описание справочника Номенклатура. Первое поле это Ключевые поля. Ключевые поля определяют те данные, которые будет передаваться всегда в xml схеме при выгрузки поля. И эти поля конвертация данных будет требовать обязательно заполнить при настройке отправки данных.
Кроме ключевых полей еще есть обязательные поля которые нужно обязательно определить.
"ТипНоменклатуры" является обязательным, т.к. в свойстве поля определено мин.количество=1 макс.количество=1
"Описание" является необязательным, т.к. в свойстве поля определено мин.количество=0 макс.количество=1
3. Правило конвертации объекта (ПКО) и правило обработки данных (ПОД).
Перед созданием ПОД нужно создать ПКО.
Далее созданное ПКО нужно подвязать к ПОД
Цифрами я указал порядок заполнения ПОД. Также не забыть заполнить и поле "группа"(группа правил).
4. Иерархические справочники
В КД3, чтобы обработать для отправки иерархические справочники необходимо создать два ПКО (одно ПКО для групп элементов, а другое для элементов) и одно ПОД.
К ПОД привязать два ПКО (для этого поставить соответствующий флажок)
"При обработке" написать код, который определит когда использовать одно ПКО, а когда другое.
При получении данных необходимо создать два ПКО и два ПОД и в одном из ПОД поставить флажок "Правило для группы справочника"
5. Правило конвертации предопределенных данных (ПКПД).
В КД2 обмен настраивался между двумя конфигурациями. В КД3 обмен настраивается через универсальный формат (EnterpriseData). Может так получится что при конвертации перечислений в универсальном формате не будет таких значений как у вас в базе или не будет вообще такого перечисления как у вас.
Если в значениях формата не хватает значений, то можно ставить одинаковые и передавать значение перечислений в AdditionalInfo (про AdditionalInfo в пункте 7).
6. Табличная часть
При отправке делаем запрос к данным и выгружаем Таблицу значений
Для Получения тоже используется алгоритм конвертации
7. AdditionalInfo
Если в формате нет реквизитов для конвертации реквизитов конвертации, тогда можно использовать поле AdditionalInfo.
У всех объектов (справочников, документов и др.) в EnterpriseData базовый тип Object. В описании этого типа, который находится пакете XDTO ExchangeMessage, есть свойство AdditionalInfo, которое наследуют все объекты.
Этим свойством можно пользоваться для переноса данных, которые не смогли сопоставить в формате EnterpriseData.
Принимаю признак проведен. В КД3 Если у документа установлен признак ПолученныеДанные.Проведен, то документ проводится.
(В КД2, если передать просто проведен = Истина. Документ будет с признаком проведен, но фактически движений не сделает)
8. Отправка Структуры с Значение и ИмяПКО
Если в табличной части есть реквизит составного типа. То при отправке нужно определить тип каждого элемента табличной части при помощи алгоритма. Рассмотрим на примере документа СФПолученая табличная часть "документы основания"
В алгоритме по типу документа определяем соответствующее ему ПКО.
9. Правило регистрации объектов (ПРО)
ПРО в КД3 не реализовано поэтому для настройки ПРО применяется КД2
В этом примере выгружаются только проведенные Поступления.
После сохранения правила в файл его нужно загрузить в настройку обмена базы из которой производим отправку данных.
Related Posts
14 Comments
обычно бестолочи накидают скринов для массовки и чтобы скрыть(за картиками) свое неумение подать материал.
тут, повторюсь, годно и вполне хорошо.
Полезный материал, спасибо. Особенно для тех, кто начинает разбираться с КД 3.0.
В последних релизах КД можно просто настройкой выгрузить ТЧ, без алгоритма.
Если в формате нет реквизитов для конвертации реквизитов конвертации, тогда можно использовать поле AdditionalInfo.Как вариант, можно еще дополнительные свойства использовать. Они почти у каждого объекта в формате есть.
В алгоритме по типу документа определяем соответствующее ему ПКО. ПРО в КД3 не реализовано поэтому для настройки ПРО применяется КД2По-моему в тестовой КД3 уже есть возможность ПРО создавать.
Эх, вот бы на полгодика раньше такую статью мне)))) А то все пришлось через боль постигать))) Спасибо за материал. Однозначно в избранное.
Не все скриншоты отображаются, почему?
Но на практике, когда речь идет о внутренних обменах между базами одного клиента, или при переносе данных из одной конфигурации в другую, КД 3.0 и рядом не стояла с КД 2.0, где простейшие изменения в правила конвертации вносятся просто.
(6) Для разового обмена КД2 подходит. А если у одного клиента зоопарк конфигураций, обновляющихся в разное время и нужен постоянный обмен, КД3 предпочтительнее.
А где есть тестовая КД3? Хотелось бы глянуть.
(7) Я такой точки зрения: если множество конфигураций у одного клиента, то при обновлении одной, может поменяться формат данных для обмена, в этом случае придется обновлять все базы, участвующие в обмене, при чем нет гарантий, что во всех актуальных релизах реализован один формат. При чем эта ситуация касается и обмена между партнерами. Другими словами, если обновляется формат, то все конфигурации должны соответствовать ему. Это крайне не удобно. В случае с КД2 все решается очень быстро в контексте одного обмена между двумя узлами. К тому же, повторюсь, КД3 призвана для создания универсального формата, понятного для множества конфигураций, а значит, нацелена для обмена между партнерами.
Для обмена между своими базами такой подход не нужен, когда нужно настроить обмен для внутренних объектов, например, т.е. речи об универсальности нет. Да, это можно сделать как в КД3, так и в КД2, но стоит ли оно таких телодвижений в КД3?
При обновлении одной конфигурации не требуется обновлять другиеЛюбая точка зрения имеет место быть, но все-таки считаю, что для внутреннего обмена КД2 предпочтительнее
Согласен, но 1С идёт своим путём и выпиливает обмен на КД2 из типовых.
>у клиентов центральный узел, у которого настроен обмен с другими узлами
Один ко многим. Если у периферийного узла поменялась конфигурация, нужно менять правила с центральной базой, а это повлияет на все остальные обмены.
Приведу пример из практики. База УТ 10.3.8 обменивается с постоянно обновляемой БП 3.0. Программиста в штате нет. После внедрения обмена на КД3 вопрос с обменом был закрыт. Работает несколько лет.
(14) КД3 в отличие от других требовательна к качеству исходных данных. Бардак не распространяет. Если что-то не заполнено, сообщит и остановит выгрузку. В Вашем случае возможно был контроль отрицательных сумм, а в новой версии формата его убрали. Нужно смотреть на ошибки.
Читайте также: