Документация Sync1C - содержание


Дополнительные возможности / Обработка категорий

Эта функциональность проверялось пока только на конфигурации Управление торговлей 11. Если с вашей конфигурацией не работает - пишите, подправлю.

Общее описание

В каталог настроек Sync1C можно добавить файл с именем НастройкиКатегорий.xml. Если этот файл присутствует, то Sync1C будет брать товары из 1С только из указанных категорий, и категории для сайта (на вкладке Новые) формировать в соответствии с настройками в этом файле. Также, начиная с версии 1.8 beta 11: если этот файл присутствует, и РеквизитПроизводителя задан явным образом, то производители на вкладке Новые тоже будут заполняться.

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

Пример файла НастройкиКатегорий.xml

<?xml version="1.0" encoding="UTF-8"?>
<НастройкиКатегорий>
	<ПечататьНеиспользуемыеКатегории>Да</ПечататьНеиспользуемыеКатегории>
	<ПечататьИспользуемыеКатегории>Да</ПечататьИспользуемыеКатегории>
	
	<ФильтрНазваний>
		<ID>ЖенскиеСапоги</ID>
		<НачалоНазвания>Женские сапоги </НачалоНазвания>
		<НачалоНазвания>Сапоги жен</НачалоНазвания>
	</ФильтрНазваний>

	<ОписаниеКатегорий>
		<ШаблонКатегорий1с>\Торговая деятельность\Обувь\{{ВидОбуви}}</ШаблонКатегорий1с>
		<ШаблонКатегорийСайт>\Обувь\{{ВидОбуви}}</ШаблонКатегорийСайт>
		<ПроизводительСайт>Обувная мануфактура</ПроизводительСайт>
		<ГруппаТоваров>
			<ФильтрНазванийСсылка>ЖенскиеСапоги</ФильтрНазванийСсылка>
			<ШаблонКатегорийСайт>\Обувь\Сапоги женские</ШаблонКатегорийСайт>
		</ГруппаТоваров>
	</ОписаниеКатегорий>

	<ОписаниеКатегорий>
		<ШаблонКатегорий1с>\Торговая деятельность\Тара</ШаблонКатегорий1с>
		<ШаблонКатегорийСайт>\Тара</ШаблонКатегорийСайт>
	</ОписаниеКатегорий>

	<ОписаниеКатегорий>
		<ШаблонКатегорий1с>\Торговая деятельность\{{хвост}}</ШаблонКатегорий1с>
		<ШаблонКатегорийСайт>\Торговая деятельность\{{хвост}}</ШаблонКатегорийСайт>
	</ОписаниеКатегорий>

</НастройкиКатегорий>

Свойства и секции файла настроек

ПечататьНеиспользуемыеКатегории

	<ПечататьНеиспользуемыеКатегории>Да</ПечататьНеиспользуемыеКатегории>

Если "Да" или "Истина" - в протокол будет напечатан перечень категорий 1С, которые не попали в фильтр (товары из которых будут проигнорированы, словно их нет в 1С).

На вкладке Протокол этот перечень занимает одну строчку, в которой написано: "Неиспользуемые категории: ...". Если навести туда курсор мышки, то 1С подсветит многострочное значение как подсказку (hint). Можно кликнуть туда, скопировать значение в буфер обмена, и вставить в текстовый редактор. Если вставить в страндартный Блокнот - получится мешанина, без концов строк. Если вставить в Notepad++, то будет всё нормально. Ещё можно открыть файл Протокол.txt, даже в Блокноте, там тоже всё хорошо.

ПечататьИспользуемыеКатегории

	<ПечататьИспользуемыеКатегории>Да</ПечататьИспользуемыеКатегории>

Если "Да" или "Истина" - в протокол будет напечатан перечень категорий 1С, которые попали в фильтр (товары из которых будут использованы для синхронизации с сайтом).

Предыдущие замечания про многострочное значение в протоколе сюда тоже относятся.

ФильтрНазваний

	<ФильтрНазваний>
		<ID>ЖенскиеСапоги</ID>
		<НачалоНазвания>Женские сапоги </НачалоНазвания>
		<НачалоНазвания>Сапоги жен</НачалоНазвания>
	</ФильтрНазваний>

Эта секция настроек позволяет дополнительно к категориям ещё фильтровать товары по названиям.

  • <ID> - придуманный вами код для данного фильтра, чтобы потом на этот фильтр сослаться из других секций.
  • <НачалоНазвания> - начало названия товара. Чувствительно к регистру (т.е. "Товар" и "товар" - это разные названия). Можно указывать несколько начал названий, как в примере.

На демонстрационной базе Управление торговлей 11.4 фильтр из примера отфильтрует по названиям следующие товары из справочника номенклатуры:

  • Женские сапоги с искусственным мехом
  • Женские сапоги с натуральным мехом
  • Сапоги жен высокие
  • Сапоги жен. низкие

На фильтр названий можно ссылаться из секции <ГруппаТоваров>. Ссылка из секции <ОписаниеКатегорий> не даст эффекта.

ОписаниеКатегорий

	<ОписаниеКатегорий>
		<ШаблонКатегорий1с>\Торговая деятельность\Обувь\{{ВидОбуви}}</ШаблонКатегорий1с>
		<ШаблонКатегорийСайт>\Обувь\{{ВидОбуви}}</ШаблонКатегорийСайт>
		<ПроизводительСайт>Обувная мануфактура</ПроизводительСайт>
		<ГруппаТоваров>
			<ФильтрНазванийСсылка>ЖенскиеСапоги</ФильтрНазванийСсылка>
			<ШаблонКатегорийСайт>\Обувь\Сапоги женские</ШаблонКатегорийСайт>
		</ГруппаТоваров>
	</ОписаниеКатегорий>

Это основная секция, она описывает порцию категорий в 1С, которая будет использоваться для синхронизации с сайтом. Таких порций может быть сколько надо. При обработке очередного товара в 1С, его категория последовательно сравнивается со всеми секциями ОписаниеКатегорий, в том порядке, в каком они расположены в файле НастройкиКатегорий.xml. Какая секция первой подойдёт - той секцией этот товар и будет обработан, оставшиеся секции ОписаниеКатегорий проверяться не будут.

<ШаблонКатегорий1с> - задаёт шаблон для фильтрации категорий из 1С.

Полное название категории выглядит примерно так: \ВерхняяКатегория\Подкатегория\ПодкатегорияПодкатегории\Итд, например: \Торговая деятельность\Продукты, \Торговая деятельность\Продукты\Соки, \Торговая деятельность\Продукты\Кондитерские изделия\Праздничные наборы, \Торговая деятельность и т.д.

Шаблон представляет собой аналогичный текст, в котором некоторые части заменены на подстановки переменных такого вида: {{идентификатор}}. Просто текст без подстановок тоже является шаблоном, он соответствует проверяемому тексту только в случае пролного совпадения. Например, шаблон \Торговая деятельность\Продукты\{{хвост}} подойдёт таким категориям из вышеупомянутых: \Торговая деятельность\Продукты\Соки и \Торговая деятельность\Продукты\Кондитерские изделия\Праздничные наборы. А категория \Торговая деятельность\Продукты не подойдёт, поскольку в её названии нет завершающего слэша после Продукты, а в шаблоне он есть.

<ШаблонКатегорийСайт> - задаёт шаблон для вычисления категорий сайта. Это может быть просто текст без подстановок, который задаёт конкретную категорию. Либо же в этом шаблоне можно использовать подстановки переменных из входного шаблона.

Например:

		<ШаблонКатегорий1с>\Торговая деятельность\Обувь\{{ВидОбуви}}</ШаблонКатегорий1с>
		<ШаблонКатегорийСайт>\Обувь\{{ВидОбуви}}</ШаблонКатегорийСайт>

Категория 1С \Торговая деятельность\Обувь\Женская обувь будет преобразована в категорию \Обувь\Женская обувь на сайте.

Если этот шаблон не задан, то категория для новых товаров (на вкладке "Новые") не будет заполнена.

<ПроизводительСайт> - задаёт значение производителя для сайта. Это не шаблон, это конкретный текст. Если он не задан, то производитель для новых товаров (на вкладке "Новые") не будет заполнен.

<ГруппаТоваров> - эта секция выделяет часть товаров с помощью фильтра названий, и позволяет задать им другой шаблон категорий, и/или другого производителя.

Например:

<ОписаниеКатегорий>
	<ШаблонКатегорий1с>\Торговая деятельность\Обувь\{{ВидОбуви}}</ШаблонКатегорий1с>
	<ШаблонКатегорийСайт>\Обувь\{{ВидОбуви}}</ШаблонКатегорийСайт>
	<ПроизводительСайт>Обувная мануфактура</ПроизводительСайт>
	<ГруппаТоваров>
		<ФильтрНазванийСсылка>ЖенскиеСапоги</ФильтрНазванийСсылка>
		<ШаблонКатегорийСайт>\Обувь\Сапоги женские</ШаблонКатегорийСайт>
	</ГруппаТоваров>
</ОписаниеКатегорий>

В соответствии с этой настройкой, большинство обуви из демонстрационной базы УТ 11.4 попадёт на сайте в категории \Обувь\Женская обувь, \Обувь\Кроссовки, и \Обувь\Мужская обувь. Однако товары, относящиеся к женским сапогам, попадут в категорию \Обувь\Сапоги женские. Производитель у всех будет один и тот же (Обувная мануфактура), поскольку он не переопределяется для группы товаров.

 


Далее: Дополнительные возможности / Мультисклад
Обратно: Дополнительные возможности / Автозапуск и автовыполнение
Документация Sync1C - содержание