Как добавить дополнительную аналитику в табличную часть документа Реализация товаров и услуг в 1С:УПП 1.3

В практике разработчика 1С часто возникает ситуация, когда бизнес-заказчик (например, главный бухгалтер) требует внедрения специфического учета, не предусмотренного типовым функционалом. Типичный пример — необходимость проставлять "флажки" или дополнительные метки непосредственно в строках табличной части документа Реализация товаров и услуг (РТУ). Основная сложность здесь заключается не в самом добавлении поля, а в сохранении возможности легкого обновления конфигурации, особенно такой массивной, как Управление производственным предприятием 1.3 (УПП).

Рассмотрим несколько эффективных способов решения этой задачи: от классического изменения метаданных до продвинутых методов программного управления формой и использования внешних хранилищ данных.

Метод 1. Добавление реквизита в табличную часть документа

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

Преимущества:

1. Максимально простая разработка и настройка отчетов.
2. Данные хранятся непосредственно в объекте, что исключает рассинхронизацию.
3. Типовые механизмы копирования строк и документов будут работать с этим реквизитом автоматически.

Риски и нюансы:

Основной риск — потеря данных при неквалифицированном обновлении. Если при очередном релизе конфигурации разработчик выберет режим "Заместить" вместо "Объединить" для объекта РТУ, добавленный реквизит исчезнет вместе со всеми накопленными данными. Чтобы минимизировать этот риск, необходимо строго соблюдать правила ведения истории изменений и всегда использовать режим сравнения/объединения с приоритетом основной конфигурации для пользовательских объектов.

Метод 2. Использование внешнего регистра сведений и «Ключа строки»

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

Однако здесь мы сталкиваемся с проблемой: как однозначно идентифицировать строку? Номер строки в 1С — величина непостоянная, он меняется при сортировке или удалении позиций. Для решения этой задачи в профессиональной разработке используется КлючСтроки.

Разберем алгоритм реализации:

1. Создаем новый регистр сведений (например, ДополнительнаяАналитикаНоменклатуры) с измерениями ДокументСсылка и КлючСтроки (тип Число или УникальныйИдентификатор) и ресурсом Флажок (тип Булево).
2. В табличную часть документа добавляем скрытый реквизит КлючСтроки, который заполняется один раз при создании строки и не меняется.
3. На форме документа программно или визуально выводим колонку, данные которой подгружаются из регистра.

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

Метод 3. Программное создание элементов формы (Runtime)

Чтобы избежать "разрисовывания" типовой формы в конфигураторе, что часто приводит к конфликтам при обновлении (когда 1С меняет дизайн или состав реквизитов), проанализируем метод программного добавления элементов. Мы можем добавить колонку в табличное поле в процедуре ПриОткрытии формы документа.

Посмотрим на пример кода, который можно вынести в общий модуль, чтобы в самой форме осталась лишь одна строка вызова:

Процедура ДобавитьКолонкуСАналитикой(ФормаДокумента) Экспорт
    ТабличноеПоле = ФормаДокумента.ЭлементыФормы.Услуги;
    НоваяКолонка = ТабличноеПоле.Колонки.Вставить(0, "МеткаБухгалтера");
    НоваяКолонка.Данные = ""; // Колонка не привязана к реквизиту напрямую
    НоваяКолонка.УстановитьТекстШапки("Ок");
    НоваяКолонка.ДанныеФлажка = "ФлажокПроставлен"; // Имя в данных строки
    НоваяКолонка.РежимРедактирования = РежимРедактированияКолонки.Непосредственно;
КонецПроцедуры

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

Процедура УслугиПриВыводеСтроки(Элемент, ОформлениеСтроки, ДанныеСтроки)
    // Получаем данные из соответствия или закэшированного регистра
    Если ДанныеСтроки.МеткаПроставлена Тогда
        ОформлениеСтроки.Ячейки.МеткаБухгалтера.ОтображатьФлажок = Истина;
        ОформлениеСтроки.Ячейки.МеткаБухгалтера.Флажок = Истина;
    КонецЕсли;
КонецПроцедуры

Метод 4. Механизм «Дополнительные свойства»

В конфигурации УПП 1.3 существует типовой механизм Свойства и Категории (План видов характеристик СвойстваОбъектов). Рассмотрим подробнее, как его можно применить.

Обычно свойства привязываются к документу в целом. Однако, если задача позволяет, мы можем создать свойство "Требует особого внимания" для всего документа РТУ. Бухгалтер сможет устанавливать этот признак на специальной вкладке "Свойства" или через кнопку на панели инструментов. Это полностью исключает изменение кода, так как механизм является типовым. Отчеты по свойствам также можно строить с помощью консоли отчетов или типового отчета "Список/кросс-таблица".

Метод 5. Использование расширений (для современных платформ)

Если ваша база УПП 1.3 работает на платформе 8.3.6 и выше, мы рекомендуем обратить внимание на Расширения конфигурации. Это самый современный и безопасный способ доработки.

Проанализируем последовательность действий:

1. Создаем новое расширение.
2. Добавляем в него документ Реализация товаров и услуг.
3. В расширении добавляем реквизит в табличную часть и выносим его на форму.
4. Пишем код обработчиков в модуле формы расширения (используя аннотации &После или &Вместо).

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

Сравнительный анализ и рекомендации

Выясним, какой метод лучше выбрать в конкретной ситуации:

• Если база обновляется редко и у вас есть полный контроль над процессом — выбирайте Метод 1 (добавление реквизита в ТЧ). Это даст лучшую производительность.
• Если вы боитесь за чистоту конфигурации и хотите избежать любых рисков при обновлении — используйте Метод 2 (внешний регистр) в связке с Методом 3 (программная отрисовка).
• Если аналитика нужна для документа в целом, а не для каждой строки — используйте Метод 4 (типовые свойства), это не потребует программирования вовсе.
• Если платформа позволяет — однозначно используйте Метод 5 (расширения).

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