| Table of Contents |
|---|
| Note |
|---|
Обязательно сделайте бекап сайта перед запуском каких-то выгрузок новым способом, или убедитесь у вашего хостера, что есть бекап сайта и на какую дату. |
Если у вас уже была настроена выгрузка в Bitrix старым способом и на сайт выгружались “дублирующиеся” для каждого раздела характеристики, то перед новой выгрузкой нужно с сайта удалить все характеристики, которые добавлены программой. Для этого нужно в админке сайта отсортировать характеристики по Символьному коду и удалить все характеристики, у которых он начинается с PRM_
...
| Expand | ||||
|---|---|---|---|---|
| ||||
Вы можете удалить их любым способом, которым умеете.
Можно отфильтровать по символьному коду  Ввести фильтр Можно отфильтровать по символьному коду Ввести фильтр PRM_% Внизу окна поставить птичку “Для всех” и нажать “Удалить” 
|
...
1. Добавить задание Sync.X
Задание с типом “Синхронизация Bitrix”
...
2. Добавить действие в Quad.Magic
Действие должно запускать задание Sync.X, которое добавили в предыдущем пункте. Действие должно срабатывать после всех действий, которые программа выполняет для контента. Обычно эти действия настроены в группе Quad.Magic полного обновления, либо есть отдельная группа, по добавлению новых товаров.
...
Указываете настройки подключения к API, ключ и папки, которые настраивали по этой инструкции.
...
Адрес папки API - ссылка на сайт на папку, полная, с адресом сайта
...
Птичку “Выгружать бренды” можно не ставить, если у вас бренды на сайте реализованы не отдельным инфоблоком, а просто свойством-списком или текстовым.
Сайт - указывается код нужного сайта (у вас в админке могут быть несколько).
...
Посмотреть можно здесь:
...
4. Sync.X вкладка “Группы”
...
Настройки выгружаемых по товару полей.
...
Название - поле программы, которое выгружается в качестве Названия товара на сайт. По умолчанию title, это стандартное поле названия товара в программе.
...
где f_3s5po22gj - код поля дополнительного названия, заменить нужно в трех местах.
...
Описание - поле программы, которое выгружается в качестве Описания товара на сайт. По умолчанию info, это стандартное поле Полного описания товара в программе.
...
| Code Block | ||
|---|---|---|
| ||
replace(replace(case when coalesce(info, '') <> '' then info else case when coalesce(f_3tspt3keb, '') <> '' then f_3tspt3keb else shortinfo end end, '<div', '<p'), '</div', '</p') |
Краткое описание - код поля для выгрузки краткого описания. По умолчанию shortinfo (краткое описание из программы).
Внешний код товара - поле, в котором формируется внешний код. Обычно это поле Код программы. В него нужно загружать внешний код с сайта при начальной загрузки товаров в программу, если у вас на сайте они уже были. И в это же поле формировать уникальный код для новых товаров. По умолчанию значение code.Символьный код -
| Note |
|---|
Если вы уже выгружали на сайт товары старым модулем, то здесь должен выгружаться такой же код, как и раньше. Посмотреть, что выгружалось, можно в настройках шаблона экспорта Bitrix Full. |
Символьный код - поле, в которое записывается символьный код товара (изначально с сайта, а так же формируется программой при выгрузке). Добавьте такое пользовательское поле с типом Строка, если у вас его еще нет. В настройке указывается код поля.
Результат:
...
...
7. Sync.X вкладка “Поля”
В этой вкладке можно настроить выгрузку дополнительных свойств товара, при обновлении или добавлении товара, а так же свойств и полей товара, при обновлении цен и остатков.
...
При выгрузке обновления цен и остатков в одной строке может быть до 6 тегов, их описание будет разделе инструкции про выгрузку цен и остатков.
Примеры
| Code Block |
|---|
PRM|IN_STOCK|(case p.is_exists when 2 then 0 else 157 end)
PRM|CML2_ARTICLE|p.article
PRM|GARANTIYA|p.garanty
PRM|STRANA2|(select coalesce(p2.f_3q3s7dq8i, m2.country) from product p2 left outer join c_manufacture m2 on (m2.code = p2.manuf_code) where p2.id = p.id)
PRM|IMPORTER2|(select coalesce(p2.f_3qcgq3oq5, m2.brand_importer, p2.f_3roao2888) from product p2 left outer join c_manufacture m2 on (m2.code = p2.manuf_code) where p2.id = p.id)
PRM|SERVISNYY_TSENTR|(select coalesce(p2.f_3qcgq41su, m2.service_centr, p2.f_3roao3avh) from product p2 left outer join c_manufacture m2 on (m2.code = p2.manuf_code) where p2.id = p.id)
PRM|SROK_SLUZHBY_MES|p.f_3qcgq3ff8
PRM|brend|(select m2.title from c_manufacture m2 where m2.code = p.manuf_code) |
8. Sync.X вкладка “Свойства”
Настройка выгрузки свойств товаров из Наборов характеристик программы.
...
Выгружать характеристики - здесь указывается, по какому тексту будут сопоставляться характеристики при выгрузке, чтобы не создавались дубли. Варианты:
По названию характеристики - проверяется только название, все характеристики программы с одинаковым названием выгружаются в 1 характеристику на сайте. Такой способ можно использовать только если у вас и в программе только по одной характеристики с одинаковым названием. Иначе нужно следить, чтобы у всех характеристик с одинаковым названием был одинаковый Тип характеристики.
По id характеристики - на сайте создается столько же характеристик, сколько и в программе, т.е. синхронизация идет 1 в 1, могут дублироваться характеристики, если они дублируются в программе для разных типов.
По названию + тип характеристики - рекомендуемая настройка, если выгрузка характеристик будет “с нуля”. На сайте будут дублироваться характеристики только в случае, если они в программе имеют разный Тип. Т.е. например Число и Список с выбором нескольких значений. Характеристика будет дублироваться так же в случае, когда есть 2 характеристики с одинаковым названием, на разным признаком “Множественная”.
ID параметров - ид набора характеристик.
...
Только основные - если установлена птичка, то выгружаются только основные характеристики.
Префикс символьного кода - префикс, который добавляется к символьному коду характеристики. Нужно что-то добавлять, чтобы потом можно было просто отфильтровать характеристики, добавленные программой, на сайте.
...
Разделитель символьного кода - символ, который вставляется между словами названия характеристики при формировании символьного кода.
...
Обновлять фильтр/развернут - если не установлена птичка, то у свойства на сайте не обновляется признак, что свойство отображается в Умном фильтре. В этом случае отображение можно настраивать в админке сайта. Так же в этом случае не выгружается признак, что свойство в фильтре отображается развернутым.
Обновлять тип свойства - если не установлена птичка, то при выгрузке свойств на сайт не изменяется их тип (число, строка, список). Иначе тип свойства на сайте изменяется на такой тип, как в программе.
Не создавать новые свойства - если птичка установлена, то у товаров заполняются только существующие на сайте свойства, новые не создаются.
Название в любом регистре - если не установлена птичка, то при выгрузке свойств на сайт будут дублироваться свойства, которые написаны разными буквами (строчными и прописными). Например свойства “Тип” и “тип” - это будут разные свойства. Устанавливайте эту птичку, если не нужно учитывать регистр букв.
Не выгружать “списки” с больше 200 значений - если установлена эта птичка, то на сайт не будут выгружаться характеристики, у которых в программе тип “Список с выбором нескольких значений” или “Список с выбором одного значения”, если у них больше 200 значений. В большинстве случаев, если у характеристики больше 200 значений, то значит тип у нее установлен не правильно. Нет смысла в списках, в которых пользователю нужно что-то выбирать из такого большого количества значений. Скорее всего тип у характеристики должен быть “Число” или просто “Текст/Строка”. Поменяйте тип в программе и после этого характеристика выгрузится.
| Note |
|---|
Данная настройка сделана по той причине, что ваш сайт на Bitrix будет работать медленно и обновляться медленно, если у вас будут свойства с типом “Список”, содержащие большое количество значений. |
Все свойства выгружать списками - если установлена эта птичка, то все характеристики программы на сайте будут создаваться с типом “Список”, даже если в программе этот тип “Строка” или “Число”.
Выгружать свойства с больше 200 значениями как тип Строка - если установлена птичка, то программа сама будет изменять тип свойства, если у него больше чем 200 значений. (см. описание Не выгружать “списки” с больше 200 значений).
Множественные характеристики - указывается способ установки у свойства на сайте признака “Множественное”.
...
Варианты:
Все списки множественные - если установлен такой тип, то свойства с типом “Список с выбором…” на сайт будут выгружены с признаком Множественное (а так же свойства, у которых явно установлен такой признак в настройке характеристики в программе).
Все списки НЕ множественные - все характеристики будут выгружены как НЕ множественные, за исключением характеристик, у которых явно установлен такой признак.
...
Только "Список с выбором нескольких значений" - только такой тип будет выгружен как “Множественное” + с явно установленным признаком. Характеристики с типом “Список с выбором одного значения” в этом случае будет выгружен как НЕ множественный.
9. Sync.X вкладка “Цены и остатки”
Здесь для выгрузки товаров нужно заполнить отмеченные на скриншете поля.
...
Как их заполнять можно посмотреть в инструкции по обновлению цен.
В “Поле полного остатка” можно написать 0, это значит что новые товары будут создаваться как Нет в наличии. Наличие им проставится в дальнейшем отдельной выгрузкой для обновления цен и наличия.
При этом нужно убрать птичку во вкладке Товары, по обновлению остатков.
...
Если птичку оставить, то в “Поле полного остатка” нужно указывать правильный код, чтобы правильно обновлялись остатки.
Обновление цен и остатков выполнится после выгрузки товаров.
Тестирование выгрузки
Для тестов через Автозаполнение рекомендуется выбрать только 1 товар, чтобы при неправильной выгрузке не удалять много информации с сайта и чтобы тест проходил быстрее.
Добавьте 2 действия Автозаполнения для отбора товара в выгрузку контента.
...
В первом действии отключаются для выгрузки все товары (присваивается 0), действие без условий.
Во втором действии отбираются товары, в нем в колонке IDs укажите ID товары, на котором будете тестировать. Можно указать несколько ИД через запятую.
...
Выполните по порядку оба правила.
Так же вы можете ограничить и выгружаемые группы. Для этого в настройках задания Sync установите так:
...
При такой настройке будет выгружена как группа товара, так и все ее вышестоящие группы.
Сохраните задание и запустите его выполнение.
...
Результаты можно посмотреть во вкладке Статус - там не должно быть ошибок.
После выгрузки проверьте, что на сайте создались разделы и отобранный товар, проверьте что у товара есть фото (в том числе дополнительные), описание, заполнены свойства, в том числе те, которые вы передавали через вкладку “Поля”.
...
Проверьте, что в инфоблок добавлен Бренд, если он отдельным инфоблоком, что Бренд заполнен в карточке товара.
Если все ок, то Автозаполнение очистите фильтр для действия отбора, чтобы выгружались все товары, а так же поменяйте настройку действия Synс, чтобы выгружались все группы.