Quad.Wiki
Настройка шаблона экспорта
- Ruslan P
- Ruslan
Добавление шаблона
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.