Quad.Wiki

Настройка шаблона экспорта

Owned by Ruslan P
Last updated: Sept 09, 2024 by Ruslan
12 min read

Добавление шаблона

1. Для добавления шаблона откройте вкладку Конфигурация / внизу Экспорт

2. В таблице "Шаблоны экспорта" нажмите Добавить, в появившейся строчке заполните

Название - название шаблона экспорта, может быть любым, таким, чтобы вы понимали, что это за экспорт

Валюта - валюта, в которой будет выгружаться основная цена. Если у вас основная цена в другой валюте, то цены будут конвертированы по курсу, введенному во вкладке Информация

Загол. - если стоит птичка, то в файл выгрузки будут добавлены заголовки полей, если не стоит - то с первой строчки будут идти данные

Дробн. - количество знаков после запятой у выгружаемой в файл основной цены товара. (0 - округляется до целой цены, 2 - 2 знака после запятой, например 123.45, 1 - один знак после запятой, 123.5, можно так же округлять до десятков, сотен и т.п., -2 - округляет до 100, т.е. значение 123456 будет округлено до 123500, -1 - до 10, 123460 и т.д.)



После изменений нажмите кнопку Сохранить над таблицей.



Добавление полей

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



Нажмите кнопку Добавить - появится новая строка, в которой нужно заполнить следующие колонки:

В Поле выбирается поле, которое выгружается в файл

Заголовок - название колонки, выгружаемой в файл

Колонка - индекс колонки в файле

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

“Каталог” - выгружается значение из своего каталога (основного прайса), эквивалент как раньше было без птички в поле “Из привязанного”

“Прайс” - выгружается значение из прайса, указанного в настройках экспорта, эквивалент как раньше было с птичкой в поле “Из привязанного”

“Прайс или каталог” - в этом случае, если заполнено значение в Прайсе, то выгрузится оно, если не заполнено, то выгрузится значение из своего каталога

“Каталог или прайс” - в этом случае, если заполнено значение в Каталоге, то выгрузится оно, если не заполнено, то выгрузится значение из прайса указанного в настройках экспорта

Последние 2 варианта работают только для пользовательских полей и для полей Код, Модель, Производитель, Краткое описание, Полное описание

 

Формула - здесь указываются настройки для некоторых типов полей.

Тип полей, которые можно выгрузить



В группе Основные указаны стандартные поля программы, в которых записана какая-то информация.

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

 

Поле Наличие - выгружается название типа наличия, которое присвоено товару.

 

В группе Цены можно выбрать выгружаемую цену или другие поля, относящиеся к ценам



Цена выгружается в валюте экспорта и с указанным округлением



Колонка "Рекомендованная цена" может быть выгружена только если вы выгружаете товар через какой-то прайс (в Основном прайсе нет Рекомендованной цены) и это будет РЦ из этого прайса. Как выгрузить минимальную РЦ из всех прайсов, в которых есть товар, указано здесь: Выгрузка рекомендованной цены

Поле с id = 6 - это ваша основная цена. Название этого поля может отличаться, так как вы задаете его сами. Если поставить птичку "Из привязанного", то выгрузится цена из прайса в валюте прайса. Если нужно, чтобы цены эти выгружались в валюте экспорта, нужно использовать поле "Цена пост. в валюте экспорта".



Группа полей Пользовательские - здесь находятся поля, которые создавались вручную (т.е. не стандартные поля программы).



Группа полей Прочее

Доставка - выгружается Название выбранного способа доставки



QGID - ид группы товара

Цена 2 - Цена 5 - дополнительные цены привязанного прайса, если такие в нем есть



Группа Наличие



Выгружается информация, указанная в конфигурации типов наличия, в зависимости от типа наличия товара.

Т.е. например, если выбрать поле "Наличие, площадка 7", то будет выгружена информация из колонки "Пл. 7"

Если у товара наличие "Под заказ", то в данном примере в файл экспорта будет выгружена цифра "8"

При выгрузке учитывается наличие товара для основной цены (для каждой цены в программе свое собственное наличие). Если нужно использовать наличие другой цены, то в колонку Формула нужно записать название поля наличия этой цены







Группа Доставка


Доставка, площадка 1 - 5 - аналогично наличию, выгружается информация из таблицы конфигурации типа доставки.

Доставка от (дней) - выгружается количество дней доставки ОТ для выбранного поставщика товара. Т.е. минимальный срок доставки.

С помощью колонки Формула указывается для какой цены и региона выгружается значение

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

ID региона можно узнать здесь

ID поля цены во вкладке Конфигурация / внизу Доп. поля

Если нужно выгрузить основную цену, то ставится 0.

Например, 46|0 означает, что нужно выгрузить минимальное количество дней доставки для региона с ИД = 46 и поставщика выбранного для основной цены.

Доставка до (дней) - выгружается количество дней доставки ДО для выбранного поставщика товара. Т.е. максимальный срок доставки. В колонке Формула указывается аналогично предыдущему полю.

Доставка от (дата) - выгружается минимальная дата доставки ОТ для выбранного поставщика товара. В колонке Формула указывается аналогично предыдущему полю.

 

Группа Вычисляемые

[Формула Excel] - если выбрать такой тип поля, то в колонку Формула можно записать формулу в формате формул из Excel, например:

=100 - у всех товаров в данной колонке в файле экспорта выгрузится цифра 100

=A[ROW]+B[ROW] - в данную колонку будет помещен результат суммы выгружаемой колонки А (индекс 1) и B (индекс 2). [ROW] означает что будет использована информация из текущей строки выгружаемого файла.

Здесь же можно использовать функции Excel, функции должны быть указаны на английском языке, разделитель параметров - запятая. Найти соответствие названий формул можно в Google.



Через это поле можно выводить так же просто какой-то статический (не изменяющийся) текст. Для этого текст нужно прописать в колонке Формула в двойных кавычках после знака равно. Пример текста из колонки формула:

="Бесплатная доставка!"

="3"

 

[SQL]

Данные в это поле можно выбрать при помощи кода или запроса SQL. В колонке Формула для такого поля задается настройка:

Название поля|SQL-текст

Название поля - любое название латинскими буквами, начинаться должно с буквы, например “val1”, “val2” и т.п.

SQL-текст - текст SQL с помощью которого выбираются данные для выгрузки (тег привязки к товарам из Продукции p.id

Разделитель между названием поля и SQL - вертикальная черта.

C помощью данного поля можно выгрузить так же значение какой-то одной характеристики товара. Формула:

param|1007

Первый тег всегда param, второй - ИД характеристики. ИД можно посмотреть в окне настроек наборов характеристик либо здесь у товара:

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

Данный функционал выгрузки значения характеристики предназначен для выгрузки какого-то ограниченного количества характеристик, 10-20 штук, не больше. Если вам нужно выгрузить все характеристики, то используйте поле [Характеристики товара]

Пример настройки

Примеры SQL

вывод списка QID товаров, входящих в сборный товар

modif1|(select string_agg(concat(pch.child_id::varchar,';',pch.order_idx::varchar,';', pch.unit_count::varchar), '|' order by pch.order_idx) from product_child pch where pch.main_id = p.id)

 

список названий прайсов поставщиков товара, у которых товар в наличии

 

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

 

список цен поставщиков товара у которых товар в наличии


[Характеристики товара]

[Характеристики товара] - начиная с данной колонки будут выгружены параметры (характеристики) товаров.

В колонке Формула нужно указать тип и ИД параметров

 

Например такая запись означает, что должны быть выгружены параметры в формате Virtuemart из набора параметров с ид = 1. ИД набора параметров можно посмотреть в настройках характеристик.



Дополнительно можно указать третьим значением тег MAIN, т.е. в Формула написать VMART;1;MAIN - в этом случае будут выгружены только Основные параметры (основной или не основной параметр указывается в настройке характеристики)

В третьем значении можно указать так же тег “LOW” - в этом случае все значения характеристик товаров будут выводиться в нижнем регистре (маленькими буквами). Если нужно указать и MAIN и LOW, то писать такой тег: VMART;1;MAINLOW

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

VMART;1;MAIN;USIT - выгружаются только характеристики, у которых указано пользовательское название, при этом значения характеристик выгружаются все.

VMART;1;;USITVAL - выгружаются только характеристики, у которых указано пользовательское название и только значения характеристик, у которых установлено пользовательское название, если тип характеристики Текст, Список с выбором одного значения, Список с выбором нескольких значений.

Обратите внимание, если не нужны только главные, при этом нужны только пользовательские, то на месте третьего параметра пустое значение (два знака ; подряд).

 

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

Возможные варианты выгрузки характеристик:

VMART - в формате для Virtuemart

SB - в формате для Shop.by

PS - в формате для PrestaShop (загрузка через API используя QuadSync)

VAR4 - в формате для Opencart

VAR2 - вариант выгрузки всех параметров в одну ячейку

VAR5 - в формате для загрузки в CS-Cart

VAR7 - каждый параметр в отдельную колонку (с одинаковыми названиями в одну колонку)

VAR1 - каждый параметр в отдельную колонку (с одинаковыми названиями из разных групп выгружаются в разные колонки)

BITR5 - в формате для Bitrix, параметры с одинаковым названием из разных групп выгружаются как отдельные параметры

BITR3 - в формате для Bitrix, параметры с одинаковым названием из разных групп выгружаются в одну и ту же колонку

DEAL - для deal.by (prom.ua), выгрузка через Excel

JSON1 - все характеристики выгружаются в одну ячейку в формате JSON, сгруппированном по группам характеристик

 

JSON2 - все характеристики выгружаются в одну ячейку в формате JSON без группировки по группам характеристик

 

OCF - для стандартных фильтров Opencart (без группы впереди)

WOOC - для WooCommerce, каждый параметр выгружается в виде 4х колонок (нумерация начинается с 2, первый параметр должен быть задан через шаблон экспорта и в него выгружается бренд)

 

[Quad.Formula]

[Quad.Formula] - в такой колонке можно записывать формулы, суммирующие информацию из разных полей программы. Например, формировать какие-то описания вида "Код товара: 123. Бесплатная доставка, гарантия, вежливые курьеры" - для этого в колонку Формула нужно записать следующий текст:

Поля указываются через точку с запятой, название полей можете уточнить в техподдержке. Статический текст начинается с $$$ - $$$Код товара:

Так же в формуле можно использовать специальные теги для остатков, если у вас остатки загружаются из прайсов поставщиков

QNT1{n}, QNT3{n}, QNT4{n}, QNT41{n}

При использовании этих тегов выгружаются остатки из соответствующего поля, вместо этого тега.

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

QNT1{n} - остатки из поля “Ост-к (нал)”

QNT3{n} - остатки из поля “Ост-к (зак)”

QNT4{n} - остатки из поля “Ост-к (скл)”

QNT41{n} - остатки из поля “Ост-к (нал)”, если нет остатков в поле “Ост-к (скл)” (т.е. если есть остатки склада, то текст, в котором присутствует этот тег, не выгружается).

В фигурных скобках {n} вместо n указывается максимальное число остатка, который выгружается. Если указано {0} то выгружается любое число. Если указано {5}, то выгружается точное число до 5 включительно, а все что больше 5 выгружается как “больше 5”

Значение по умолчанию, которое выгружается в случае отсутствия остатков, указывается в фигурных скобках после вертикальной черты, например QNT1{5| Наличие уточняйте у менеджера!} .

 

Пример шаблона:

Если у вас На складе будет 1 товар, В наличии 5 товаров, Под заказ 15 товаров, то в описание выгрузится текст:

Код: 123 Доставим сегодня: 1 шт. Под заказ: более 10 шт. Рекламное описание товара

Если у вас На складе будет 0 товаров (нет товара), В наличии 5 товаров, Под заказ 15 товаров, то в описание выгрузится текст:

Если у вас На складе будет 0 товаров (нет товара), В наличии 5 товаров, Под заказ 0 товаров, то в описание выгрузится текст:

Если у вас На складе будет 0 товаров (нет товара), В наличии 2 товара, Под заказ 0 товаров, то в описание выгрузится текст:

 

При таком шаблоне в случае отсутствия остатка у товара будет выгружен текст Остаток: 1шт.

 

[Другое поле] - произвольное поле из базы данных, название поля указывается в колонке Формула. Например konk_price - выгружает отличие вашей цены от конкурентов в Базовой валюте программы. rc_diff - отличие вашей цены от РЦ.



[Выбор заполненного поля] - описание здесь: Экспорт, тип поля "Выбор заполненного поля"

 

Коды полей в формулах:

p_manuf - бренд/производитель

f_group - название группы товара



Формулы

В колонке формула можно писать формулы для любых полей. Возможные варианты:

txt->url - преобразует текст, выгружаемый в ячейку, в ссылку, т.е. заменяет русские буквы английскими, пробелы и знаки пунктуации на символ "тире" - , приводит все к нижнему регистру. Например, так можно формировать URL товара из названия 

Символ тире можно заменить на другой, его нужно записать в конце формулы, например txt->url_   - так вместо тире будет использовано нижнее подчеркивание.



txt->low  - приводит весь текст к нижнему регистру (маленькими буквами)

txt->low1  - приводит весь текст к нижнему регистру (маленькими буквами), за исключением первой буквы в тексте 

dec. - заменяет запятую на точку для числовых полей



Формат выгружаемого файла

Если нужно выгружать информацию не в Excel, а, например, в CSV, то нужно заполнить настройки формата выгружаемого файла.

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

Если нужен разделитель “Tab” (знак табуляции), то нужно написать так:

Выгрузка картинок

Для выгрузки картинок нужно добавить поле типом [Другое поле], а в колонке формула указать photo_list



Будут выгружены картинки товара, разделенные знаком |

Чтобы привести картинки к какому-то другому виду нужно сделать макрос - обратитесь в техподдержку с информацией, в каком виде нужно выгружать картинки.


Замены

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

Подробнее про настройку справочников здесь:

В настройках шаблона экспорта выберите колонку, в которой должна производиться замена, и нажмите кнопку “Замены”

В открывшемся окне перечислите справочники замен, которые должны применяться к этому полю. Можно вводить несколько справочников, каждый с новой строки, в этом случае замены будут осуществлены по каждому справочнику в том порядке, как они введены.

Пример справочника где заменяется знак вопроса на знак тире.

 

Выгрузка товаров по созданному шаблону

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



Либо настроить автоматическую выгрузку через Quad.Magic.