Добавление значений дополнительных полей товаров в шаблоны документов

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

Важно!

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

Рассмотрим процесс добавления на примере. Допустим, нам необходимо добавить доп. поле “Артикул” в шаблон ценника товаров. 

Создание дополнительного поля

Настройка дополнительных полей для товаров выполняется в Файл – Настройки – Товары. Нажмите “Настройка доп. полей”, чтобы перейти к списку доп. полей товаров. 

• Видео-урок о добавлении дополнительных полей для товаров

В открывшемся окне нажмите кнопку “Добавить”, и в карточке доп. поля введите название. В нашем примере это “Артикул” с типом “Строка”.

Затем выделите значение в поле UID, нажмите правой кнопкой мыши и выберите “Копировать”, чтобы скопировать значение UID доп. поля в буфер обмена. 

UID пригодится на следующем шаге. Если планируете что-то копировать в буфер – сохраните UID, например, в блокноте. 

Установка значения доп. поля в карточке товара

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

Откройте Товары – Каталог товаров и для одного или нескольких товаров укажите значение поля “Артикул” на вкладке “Доп. информация”.

Нажмите “Сохранить”, чтобы изменения сохранились в базу данных. 

Открытие файла шаблона

Шаблон необходимо отредактировать в текстовом редакторе, например в  программе “Блокнот”.

Информация Для целей редактирования шаблонов лучше подойдет Notepad++ или SublimeText

Перейдите в настройки программы Файл – Настройки – Внешний вид и нажмите “Папка с шаблонами”.

Папка с шаблонами должна выглядеть примерно так:

Внешний вид папки с шаблонами

В нашем примере необходимо перейти в папку PriceTags, которая соответствует шаблонам ценников. Соответствие папок описано в статье. 

Выберите файл в списке, например 40х60, нажмите правой кнопкой мыши, затем “Открыть с помощью”. 

Информация Если в системе установлены Notepad++ или SublimeText, то можно выбрать пункт "Edit with Notepad++" или "Open with SublimeText", чтобы сразу перейти к редактированию.

В списке программ найдите”Блокнот” (или Notepad) и нажмите “Ок”

Редактирование кода шаблона

Например, мы открыли шаблон в программе SublimeText. Он будет выглядеть так:

В шаблон необходимо добавить следующий код :

Важно

Вставить код необходимо в блоке <BusinessObjectDataSource Name="goods"... после блока <Column Name="Good" DataType="Gbs.Helpers.FR.BackEnd.Entities.Goods.Good, Market, Version=6.2.0.1407, Culture=neutral, PublicKeyToken=null">

    <Column Name="BusinessObjectDataSource2" Alias="Properties" DataType="System.Collections.Generic.Dictionary`2[[System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089],[System.Object, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]" PropName="Properties">
    <Column Name="Key" DataType="System.String"/>
    <Column Name="Value" Enabled="false" DataType="System.Object"/>
    </Column>

В результате файл должен выглядеть так:

После этого сохраните внесенные изменения. 

Изменение шаблона в редакторе

Откройте Файл – Настройки – Внешний вид, выберите необходимый шаблон в списке и нажмите “Изменить”. 

• Видео-урок по редактированию шаблонов документов

Добавьте элемент “Текст” в документ. 

Дважды кликните на добавленный элемент и вставьте в него текст:

[[goods.Good.Properties]["643f0bf0-bc07-43b1-a575-515146858bfc"]]

Где значение 643f0bf0-bc07-43b1-a575-515146858bfc в кавычках – это UID доп. поля, которое мы создали ранее. Шаблон в итоге должен выглядеть так:

Сохраните внесенные изменения.

Печать ценников

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

Откройте Товары – Ценники. Выберите товар, для которого задано значение поля “Артикул”, и добавьте его в список. 

В списке видим, что для товара указан артикул. 

• Инструкция как включить отображение столбцов в списках.

После добавления необходимых товаров нажмите “Печать” и выберите шаблон, в который были внесены правки. 

Если все сделано корректно, то в ценнике вы увидите артикул, указанный в карточке товара.