Добавление параметров номенклатуры и карточек номенклатуры в макетах печатных форм
Универсальный механизм подстановки реквизитов Номенклатуры и Карточки номенклатуры в макеты печатных форм без правки конфигурации. Достаточно добавить в макет параметр с именем по правилу Номенклатура<ИмяРеквизита> или КарточкаНоменклатуры<ИмяРеквизита> — система сама подставит туда нужное значение из документа.
Зачем это нужно
Раньше, чтобы в печатной форме показать значение какого нибуть реквизита номенклатуры или карточки номенклатуры (например, производителя, бух. номер карточки), нужно было обращаться к программисту: править запрос в модуле менеджера, добавлять поле в выборку, согласовывать имя параметра. Любая мелкая правка макета превращалась в задачу на несколько часов, а то и дней.
Теперь добавление поля в макет — это локальное изменение макета (через стандартное «Администрирование → Печатные формы, отчеты и обработки → Макеты печатных форм → Изменить макет»). Не нужно править ни код 1С, ни запросы. Реализация в общем модуле один раз поддерживает все будущие параметры — список потенциально доступных полей соответствует составу реквизитов справочника на момент печати.
Где это уже работает
| Документ / Справочник |
|---|
| Заказ клиента |
| Заказ поставщику |
| Поступление |
| Продажа |
| Списание |
| Сборка-комплектация |
| Инвентаризация |
| Начало обслуживания |
| Окончание обслуживания |
| Карточки номенклатуры (справочник) |
Как пользоваться
1. Откройте копию макета на правку
В клиенте 1С: «Администрирование → Печатные формы, отчеты и обработки → Макеты печатных форм». Выбрать нужный макет и нажать Изменить макет или F2.
2. Добавьте нужный параметр в область строки
В области макета (например, «Строка» для «Заказа клиента»):
- Поставьте курсор в нужную ячейку.
- Откройте свойства ячейки (правый клик → Свойства или
Alt + Enter). - В поле Заполнение выберите Параметр.
- В поле Параметр введите имя по правилу:
- для Номенклатуры —
Номенклатура<ИмяРеквизита> - для Карточки номенклатуры —
КарточкаНоменклатуры<ИмяРеквизита>
- для Номенклатуры —
Имя реквизита берётся из таблиц приложений 1 и 2 этой статьи.
3. Сохраните и проверьте
Сохраните макет, закройте редактор, нажмите «Печать → Заказ клиента» ещё раз — теперь в нужной ячейке окажется значение из реквизита номенклатуры - производитель.
Что произойдёт, если имя параметра указано неверно
Параметр останется пустым. Печать не сломается. Это штатное поведение: лишние имена параметров система молча игнорирует, ошибок не возникает. Проверьте имя по таблице в приложении.
Правила формирования имён параметров
A. Простые реквизиты
<Префикс><ИмяРеквизита> — без разделителей.
Примеры:
НоменклатураАртикулНоменклатураГарантияМесяцевКарточкаНоменклатурыБухНомерКарточкаНоменклатурыДатаВводаВЭксплуатацию
B. Раскрытие реквизитов-ссылок
Для реквизита, который сам является ссылкой на справочник (например, Производитель или ВидНоменклатуры), помимо ключа с самим значением (НоменклатураПроизводитель) автоматически добавляются развёрнутые поля первого уровня вложенности ссылочного объекта:
| Имя параметра | Что подставляется |
|---|---|
НоменклатураВидНоменклатурыНаименование | Наименование вида номенклатуры |
НоменклатураПоставщикНаименование | Наименование контрагента-поставщика |
НоменклатураПоставщикИНН | ИНН контрагента-поставщика |
НоменклатураПоставщикКПП | КПП контрагента-поставщика |
КарточкаНоменклатурыКодПоОКОФНаименование | Расшифровка кода ОКОФ |
Имена реквизита и подреквизита идут подряд, без разделителей.
Глубина раскрытия — один уровень. То есть НоменклатураПроизводительПолноеНаименование доступно (это реквизит самого Производителя), а вот НоменклатураПроизводительОсновноеЛицоИНН — нет (это уже второй уровень вложенности).
С. Дополнительные реквизиты
Если у номенклатуры или карточки настроены «Дополнительные реквизиты» (механизм БСП), они доступны под именами:
НоменклатураДопРеквизит<Идентификатор>— для НоменклатурыКарточкаНоменклатурыДопРеквизит<Идентификатор>— для Карточки
<Идентификатор> формируется из наименования дополнительного реквизита: оставляются только буквы, цифры и подчёркивание, остальные символы убираются. Например, дополнительный реквизит «Цвет корпуса» доступен как НоменклатураДопРеквизитЦветкорпуса.
D. Служебный параметр
| Имя параметра | Что подставляется |
|---|---|
НоменклатураДатаИВремяПечати | Текущая дата и время сервера на момент печати |
КарточкаНоменклатурыДатаИВремяПечати | То же |
Ограничения
- Реквизиты составного типа не раскрываются на подреквизиты. Например, у Карточки номенклатуры реквизит
ДокументПоступления— составной (может бытьПоступление,Списаниеи т. д.), поэтому доступен только ключКарточкаНоменклатурыДокументПоступления(выведется представление), а вотКарточкаНоменклатурыДокументПоступленияДатаили...Номер— нет. - Перечисления (
АмортизационнаяГруппа) — подреквизитов нет по определению. В параметр подставляется представление значения перечисления. - Устаревшие реквизиты (
УдалитьВес,УдалитьКартинкаи подобные с префиксом «Удалить») в выборку не попадают. Использовать их в макетах нельзя. - Изображения и хранилища значений не передаются — это технические данные, для макета не пригодны.
- Табличные части номенклатуры/карточки (например,
СетевыеИнтерфейсыу Карточки) не разворачиваются в строки макета — для каждой строки печати используется одна номенклатура/карточка, ТЧ — это коллекция. Если нужна печать сетевых интерфейсов карточки — это отдельный макет «Карточка номенклатуры», для которого механизм не предназначен. - Стандартный реквизит «Владелец» карточки (= номенклатура, которой она принадлежит) сейчас не входит в набор автоматических параметров.
Совет: как быстро узнать список доступных параметров
При правке макета пользователю не обязательно держать в голове все имена. Достаточно открыть таблицы Приложения 1 (для Номенклатуры) и Приложения 2 (для Карточки номенклатуры) этой статьи и взять оттуда имя нужного реквизита, добавив префикс.
Также можно ориентироваться на список реквизитов справочника в режиме 1С:ПредКонфигуратор.
Приложение 1. Реквизиты справочника «Номенклатура»
В колонке «Имя параметра в макете» — то имя, которое нужно вписать в свойство «Параметр» ячейки.
| Имя параметра в макете | Синоним (как видит пользователь) | Описание |
|---|---|---|
НоменклатураСсылка | Ссылка | Сама ссылка на элемент (в текстовый параметр выведется как представление) |
НоменклатураКод | Код | Код элемента (в справочнике Номенклатура код по умолчанию пустой) |
НоменклатураНаименование | Наименование | Наименование позиции |
НоменклатураПометкаУдаления | Пометка удаления | Истина — элемент помечен на удаление |
НоменклатураЭтоГруппа | Это группа | Истина — элемент является группой каталога |
НоменклатураРодитель | Родитель | Ссылка на родительскую группу |
НоменклатураАмортизационнаяГруппа | Амортизационная группа | Амортизационная группа номенклатуры |
НоменклатураАртикул | Артикул | Артикул позиции номенклатуры |
НоменклатураВидНоменклатуры | Вид номенклатуры | Вид номенклатуры в информационной базе |
НоменклатураВРасчетПотребностейВключатьАналоги | В расчёт потребностей включать аналоги | При расчёте минимального остатка учитывать аналоги |
НоменклатураГарантияМесяцев | Гарантия месяцев | Срок гарантии в месяцах |
НоменклатураЕдиницаИзмерения | Единица измерения | Единица измерения по классификатору, в которой ведётся учёт |
НоменклатураКодПоОКОФ | Код по ОКОФ | Код по ОКОФ номенклатуры |
НоменклатураКомментарий | Комментарий | Произвольный комментарий |
НоменклатураМинимальныйОстаток | Минимальный остаток | Минимальный остаток номенклатуры, который должен быть в резерве |
НоменклатураПоставщик | Поставщик | Поставщик номенклатуры |
НоменклатураПроизводитель | Производитель | Производитель номенклатуры |
НоменклатураСтавкаНДС | Ставка НДС | Ставка НДС по умолчанию для подстановки в документы |
НоменклатураФайлКартинки | Файл картинки | Ссылка на файл картинки номенклатуры |
Раскрытые поля реквизитов-ссылок (примеры наиболее полезных — полный список зависит от состава реквизитов справочников-целей):
| Имя параметра в макете | Что подставляется |
|---|---|
НоменклатураПроизводительНаименование | Наименование производителя |
НоменклатураПроизводительКод | Код производителя |
НоменклатураПоставщикНаименование | Наименование контрагента-поставщика |
НоменклатураПоставщикИНН | ИНН поставщика |
НоменклатураПоставщикКПП | КПП поставщика |
НоменклатураВидНоменклатурыНаименование | Наименование вида номенклатуры |
НоменклатураЕдиницаИзмеренияНаименование | Наименование единицы измерения (шт., упак. и т. д.) |
НоменклатураСтавкаНДСНаименование | Наименование ставки НДС (20%, 10%, Без НДС и т. п.) |
НоменклатураКодПоОКОФНаименование | Расшифровка кода ОКОФ |
Приложение 2. Реквизиты справочника «Карточки номенклатуры»
В колонке «Имя параметра в макете» — то имя, которое нужно вписать в свойство «Параметр» ячейки.
| Имя параметра в макете | Синоним (как видит пользователь) | Описание |
|---|---|---|
КарточкаНоменклатурыСсылка | Ссылка | Сама ссылка на карточку (выведется как представление) |
КарточкаНоменклатурыКод | Код | Код карточки (автонумерация, длина 11) |
КарточкаНоменклатурыНаименование | Наименование карточки | Наименование карточки |
КарточкаНоменклатурыПометкаУдаления | Пометка удаления | Истина — карточка помечена на удаление |
КарточкаНоменклатурыАвтоНаименование | Авто наименование | Автоматически формировать наименование по формуле из настроек учёта |
КарточкаНоменклатурыАмортизационнаяГруппа | Амортизационная группа | Амортизационная группа ОКОФ |
КарточкаНоменклатурыБухНомер | Бух номер | Бухгалтерский номер карточки |
КарточкаНоменклатурыВерсияПО | Версия ПО | Версия программного обеспечения |
КарточкаНоменклатурыВестиУчетПоКарточкамНоменклатуры | Вести учёт по карточкам номенклатуры | Ведётся ли для данной карточки учёт по карточкам |
КарточкаНоменклатурыВидНоменклатуры | Вид номенклатуры | Вид номенклатуры карточки |
КарточкаНоменклатурыГарантияМесяцев | Гарантия месяцев | Срок гарантии в месяцах |
КарточкаНоменклатурыДатаВводаВЭксплуатацию | Дата ввода в эксплуатацию | Дата ввода карточки в эксплуатацию |
КарточкаНоменклатурыДатаНачалаЛицензии | Дата начала лицензии | Дата начала действия лицензии |
КарточкаНоменклатурыДатаНачалаПодпискиОбновлений | Дата начала подписки обновлений | Дата начала действия подписки на обновления |
КарточкаНоменклатурыДатаОкончанияГарантии | Дата окончания гарантии | Дата окончания гарантии от даты ввода в эксплуатацию |
КарточкаНоменклатурыДатаОкончанияЛицензии | Дата окончания лицензии | Дата окончания действия лицензии |
КарточкаНоменклатурыДатаОкончанияПодпискиОбновлений | Дата окончания подписки обновлений | Дата окончания действия подписки на обновления |
КарточкаНоменклатурыДатаПриобретения | Дата приобретения | Дата приобретения карточки |
КарточкаНоменклатурыДатаУстановкиПО | Дата установки ПО | Дата установки программного обеспечения |
КарточкаНоменклатурыДокументПоступления | Документ поступления | Документ-основание поступления карточки (составной тип, выведется как представление) |
КарточкаНоменклатурыЕстьГарантия | Есть гарантия | Истина — на карточку распространяется гарантия |
КарточкаНоменклатурыЕстьОграниченияПоКоличествуПользователейЛицензии | Есть ограничения по количеству пользователей лицензии | Признак ограничения лицензии по количеству пользователей |
КарточкаНоменклатурыЕстьОграниченияПоСрокуДействияЛицензии | Есть ограничения по сроку действия лицензии | Признак ограничения лицензии по сроку действия |
КарточкаНоменклатурыЕстьОграниченияПоСрокуДействияОбновлений | Есть ограничения по сроку действия обновлений | Признак ограничения подписки на обновления по сроку |
КарточкаНоменклатурыЗаметки | Заметки | Дополнительная информация по карточке |
КарточкаНоменклатурыИнвентарныйНомер | Инвентарный номер | Инвентарный номер карточки |
КарточкаНоменклатурыКлючАктивации | Ключ активации | Ключ активации лицензии |
КарточкаНоменклатурыКодПоОКОФ | Код по ОКОФ | Код по ОКОФ карточки |
КарточкаНоменклатурыКоличествоПользователейЛицензии | Количество пользователей лицензии | Количество пользователей у лицензии |
КарточкаНоменклатурыКомментарий | Комментарий | Произвольное описание |
КарточкаНоменклатурыПервоначальнаяСтоимость | Первоначальная стоимость | Сумма первоначальной стоимости |
КарточкаНоменклатурыПорядковыйНомер | Порядковый номер | Порядковый номер карточки |
КарточкаНоменклатурыСерийныйНомер | Серийный номер | Серийный номер карточки |
КарточкаНоменклатурыСетевоеИмя | Сетевое имя | Сетевое имя устройства |
КарточкаНоменклатурыСетевойПользователь | Сетевой пользователь | Сетевой пользователь устройства |
КарточкаНоменклатурыСрокПолезногоИспользования | Срок полезного использования (мес.) | Срок полезного использования карточки в месяцах |
КарточкаНоменклатурыФайлКартинки | Файл картинки | Ссылка на файл картинки карточки |
Раскрытые поля реквизитов-ссылок (примеры):
| Имя параметра в макете | Что подставляется |
|---|---|
КарточкаНоменклатурыВидНоменклатурыНаименование | Наименование вида номенклатуры |
КарточкаНоменклатурыВидНоменклатурыКод | Код вида номенклатуры |
КарточкаНоменклатурыКодПоОКОФНаименование | Расшифровка кода ОКОФ |
КарточкаНоменклатурыКодПоОКОФКод | Сам код ОКОФ (значение в справочнике) |