Как перенести доп. сведение к документу в 1С КД2?

[Odineski]

КД2 как перенести дополнительные сведения к документу

[Odin — Одинэсник]

В КД2 дополнительные сведения к документу нужно переносить не как реквизиты самого документа, а как записи регистра сведений, в котором БСП хранит дополнительные сведения.

Обычно запись содержит:

1С (Код)

Объект ДокументСсылка Свойство Элемент справочника дополнительных сведений Значение Значение дополнительного сведения

1 2 3

Объект      ДокументСсылка Свойство    Элемент справочника дополнительных сведений Значение    Значение дополнительного сведения

Точные названия регистра и его полей зависят от конфигурации. Чаще всего используются регистры с названиями:

1С (Код)

ДополнительныеСведения ЗначенияСвойствОбъектов ДополнительныеРеквизиты

1 2 3

ДополнительныеСведения ЗначенияСвойствОбъектов ДополнительныеРеквизиты

Сначала нужно определить, где именно хранятся ваши данные.

## 1. Проверьте, что переносится

В 1С есть два разных механизма.

### Дополнительные сведения

Открываются обычно отдельной командой или через меню:

1С (Код)

Еще Дополнительные сведения

1 2	Еще     Дополнительные сведения

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

### Дополнительные реквизиты

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

Для КД2 оба варианта обычно необходимо переносить через соответствующие регистры сведений.

## 2. Найдите регистр в конфигурации

В конфигураторе источника откройте объект документа и посмотрите, какие регистры используют ссылку на этот документ.

Можно также найти регистры по измерению типа:

1С (Код)

ДокументСсылка.НужныйДокумент

1	ДокументСсылка.НужныйДокумент

Проверьте записи регистра в режиме 1С:Предприятие. У записи должны быть примерно такие значения:

1С (Код)

Объект = Документ.LES_ПроектЛесовосстановления Свойство = ДополнительноеСведение Значение = ЗначениеСведения

1 2 3

Объект   = Документ.LES_ПроектЛесовосстановления Свойство = ДополнительноеСведение Значение  = ЗначениеСведения

Нужно проверить:

1. имя регистра;
2. какие поля являются измерениями;
3. где хранится ссылка на документ;
4. где хранится свойство;
5. где хранится значение;
6. тип значения.

Особенно важно проверить тип поля Значение. Оно часто бывает составного типа и может содержать:

1С (Код)

Строка Число Дата Булево СправочникСсылка ДокументСсылка Характеристика

1 2 3 4 5 6 7

Строка Число Дата Булево СправочникСсылка ДокументСсылка Характеристика

## 3. Настройте перенос самого документа

В КД2 сначала должно быть создано и настроено ПКО для документа.

Например:

1С (Код)

ПКО LES_ПроектЛесовосстановления

1	ПКО LES_ПроектЛесовосстановления

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

Также должны быть настроены ПКО для:

— свойства дополнительного сведения;
— значения, если оно является ссылкой;
— владельца свойства, если используется подчиненный справочник;
— других ссылочных значений.

Например, если дополнительное сведение имеет значение СправочникСсылка.LES_Лесосеки, для справочника LES_Лесосеки также нужно настроить ПКО.

## 4. Создайте ПКО для регистра сведений

В КД2 создайте правило конвертации объекта для регистра сведений, в котором хранятся дополнительные сведения.

Например:

1С (Код)

ПКО РегистрСведений.ДополнительныеСведения

1	ПКО РегистрСведений.ДополнительныеСведения

В настройке ПКО укажите соответствие полей:

1С (Код)

Объект Свойство Значение

1 2 3

Объект Свойство Значение

Пример логики соответствия:

1С (Код)

Объект Источник: Объект Приемник: Объект Свойство Источник: Свойство Приемник: Свойство Значение Источник: Значение Приемник: Значение

1 2 3 4 5 6 7 8 9 10 11

Объект     Источник: Объект     Приемник: Объект   Свойство     Источник: Свойство     Приемник: Свойство   Значение     Источник: Значение     Приемник: Значение

Если поле Объект является составным или имеет тип ТипОбъекта, необходимо настроить преобразование ссылки через ПКО документа.

## 5. Создайте ПОД для регистра

После создания ПКО создайте правило обработки данных.

В КД2 обычно нужно указать:

1С (Код)

Источник: Регистр сведений.ДополнительныеСведения ПКО: ПКО ДополнительныеСведения

1 2 3 4 5

Источник:     Регистр сведений.ДополнительныеСведения   ПКО:     ПКО ДополнительныеСведения

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

Пример запроса для отбора записей по документам:

1С (Код)

|ВЫБРАТЬ | ДополнительныеСведения.Объект, | ДополнительныеСведения.Свойство, | ДополнительныеСведения.Значение |ИЗ | РегистрСведений.ДополнительныеСведения КАК ДополнительныеСведения |ГДЕ | ДополнительныеСведения.Объект ССЫЛКА Документ.LES_ПроектЛесовосстановления

1 2 3 4 5 6 7 8

|ВЫБРАТЬ |    ДополнительныеСведения.Объект, |    ДополнительныеСведения.Свойство, |    ДополнительныеСведения.Значение |ИЗ |    РегистрСведений.ДополнительныеСведения КАК ДополнительныеСведения |ГДЕ |    ДополнительныеСведения.Объект ССЫЛКА Документ.LES_ПроектЛесовосстановления

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

## 6. Настройте перенос ссылки на документ

Главное поле регистра, которое нужно правильно обработать, это Объект.

При переносе записи:

1С (Код)

Источник: Документ.LES_ПроектЛесовосстановления Приемник: Документ.LES_ПроектЛесовосстановления

1 2 3 4 5

Источник:     Документ.LES_ПроектЛесовосстановления   Приемник:     Документ.LES_ПроектЛесовосстановления

КД2 должна найти соответствующий документ в приемнике по ПКО документа.

Если конфигурации источника и приемника разные, настройте:

1С (Код)

ПКО документа ПКС Объект

1 2	ПКО документа ПКС Объект

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

1С (Код)

Значение = ПолучитьОбъектПриемник(Источник.Объект);

1	Значение = ПолучитьОбъектПриемник(Источник.Объект);

Не следует передавать GUID документа строкой, если в приемнике требуется настоящая ссылка.

## 7. Настройте перенос свойства

Поле Свойство обычно является ссылкой на элемент справочника дополнительных реквизитов и сведений.

Для него нужно создать отдельное ПКО, например:

1С (Код)

ПКО Справочник.ДополнительныеРеквизитыИСведения

1	ПКО Справочник.ДополнительныеРеквизитыИСведения

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

Рекомендуемый вариант:

1С (Код)

Свойство источника ПКО свойства Свойство приемника Найденный элемент справочника

1 2 3 4

Свойство источника     ПКО свойства Свойство приемника     Найденный элемент справочника

Если свойство уже есть в обеих базах и имеет одинаковый уникальный идентификатор, можно использовать стандартное сопоставление по GUID.

Если свойства были созданы вручную отдельно в каждой базе, их GUID могут отличаться. Тогда сопоставление по GUID не сработает. В таком случае нужно настроить поиск:

1С (Код)

По коду

1

По коду

или:

1С (Код)

По наименованию

1	По наименованию

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

## 8. Настройте поле «Значение»

Поле Значение требует особого внимания.

### Если значение строковое

Настройте обычное соответствие:

1С (Код)

Источник.Значение Приемник.Значение

1 2	Источник.Значение Приемник.Значение

### Если значение числовое

Также используется прямое соответствие, но проверьте:

— разрядность;
— точность;
— пустое значение;
— нулевое значение.

### Если значение является датой или булевым значением

Проверьте, что тип значения в источнике и приемнике одинаковый.

### Если значение является ссылкой

Например:

1С (Код)

СправочникСсылка.LES_Лесосеки

1	СправочникСсылка.LES_Лесосеки

то необходимо создать ПКО для соответствующего справочника и передавать значение через это ПКО.

Иначе в приемнике может появиться:

— пустая ссылка;
— строковое представление ссылки;
— ошибка преобразования типа;
— ссылка на несуществующий объект.

## 9. Ограничьте выгрузку только нужными документами

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

Например:

1С (Код)

|ВЫБРАТЬ | ДополнительныеСведения.Объект, | ДополнительныеСведения.Свойство, | ДополнительныеСведения.Значение |ИЗ | РегистрСведений.ДополнительныеСведения КАК ДополнительныеСведения |ГДЕ | ДополнительныеСведения.Объект ССЫЛКА Документ.LES_ПроектЛесовосстановления | И ДополнительныеСведения.Объект В | (ВЫБРАТЬ | Документы.Ссылка | ИЗ | Документ.LES_ПроектЛесовосстановления КАК Документы | ГДЕ | Документы.Дата МЕЖДУ &ДатаНачала И &ДатаОкончания)

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

|ВЫБРАТЬ |    ДополнительныеСведения.Объект, |    ДополнительныеСведения.Свойство, |    ДополнительныеСведения.Значение |ИЗ |    РегистрСведений.ДополнительныеСведения КАК ДополнительныеСведения |ГДЕ |    ДополнительныеСведения.Объект ССЫЛКА Документ.LES_ПроектЛесовосстановления |    И ДополнительныеСведения.Объект В |        (ВЫБРАТЬ |            Документы.Ссылка |        ИЗ |            Документ.LES_ПроектЛесовосстановления КАК Документы |        ГДЕ |            Документы.Дата МЕЖДУ &ДатаНачала И &ДатаОкончания)

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

## 10. Если стандартный перенос регистра не срабатывает

В некоторых конфигурациях регистр дополнительных сведений не предназначен для прямого обмена через КД2. Например:

— регистр не включен в план обмена;
— у регистра нет удобного ПКО;
— значение хранится в специальном формате;
— объект имеет составной тип;
— данные формируются БСП специальными процедурами;
— в источнике и приемнике отличаются структуры дополнительных сведений.

В этом случае можно переносить сведения из ПКО документа.

### На стороне источника

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

Примерная логика:

1С (Код)

НаборЗаписей = РегистрыСведений.ДополнительныеСведения.СоздатьНаборЗаписей(); НаборЗаписей.Отбор.Объект.Установить(Источник.Ссылка); НаборЗаписей.Прочитать(); ТаблицаСведений = НаборЗаписей.Выгрузить(); ДанныеXDTO.Вставить("ДополнительныеСведения", ТаблицаСведений);

1 2 3 4 5 6 7 8

НаборЗаписей = РегистрыСведений.ДополнительныеСведения.СоздатьНаборЗаписей();   НаборЗаписей.Отбор.Объект.Установить(Источник.Ссылка); НаборЗаписей.Прочитать();   ТаблицаСведений = НаборЗаписей.Выгрузить();   ДанныеXDTO.Вставить("ДополнительныеСведения", ТаблицаСведений);

Название объекта Источник, ДанныеXDTO и точное место обработчика зависят от структуры правил КД2.

### На стороне приемника

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

Примерная логика:

1С (Код)

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

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17

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

Но при таком варианте нужно учитывать существующие записи. Если документ загружается повторно, могут появиться дубли.

Перед записью обычно удаляют старые записи по документу:

1С (Код)

НаборЗаписей = РегистрыСведений.ДополнительныеСведения.СоздатьНаборЗаписей(); НаборЗаписей.Отбор.Объект.Установить(Объект.Ссылка); НаборЗаписей.Записать();

1 2 3

НаборЗаписей = РегистрыСведений.ДополнительныеСведения.СоздатьНаборЗаписей(); НаборЗаписей.Отбор.Объект.Установить(Объект.Ссылка); НаборЗаписей.Записать();

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

## Рекомендуемый порядок настройки

Для обычного случая порядок такой:

1. Создать ПКО документа.
2. Создать ПКО свойства дополнительного сведения.
3. Создать ПКО справочников и документов, которые могут находиться в поле Значение.
4. Создать ПКО регистра дополнительных сведений.
5. Создать ПОД регистра.
6. Ограничить выгрузку регистра нужными документами.
7. Настроить поле Объект через ПКО документа.
8. Настроить поле Свойство через ПКО свойства.
9. Настроить поле Значение с учетом его фактического типа.
10. Выполнить тестовую выгрузку одного документа.
11. Проверить наличие записи регистра в приемнике.
12. Открыть документ и убедиться, что дополнительное сведение отображается в форме.

## Важный нюанс

Если дополнительные сведения создавались пользователем вручную, в источнике и приемнике могут отличаться ссылки на элементы справочника свойств. Поэтому недостаточно перенести только регистр.

Нужно переносить одновременно:

1С (Код)

Документ Свойство дополнительного сведения Значение свойства Запись регистра дополнительных сведений

1 2 3 4

Документ Свойство дополнительного сведения Значение свойства Запись регистра дополнительных сведений

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

[Автор]

Записи