Перейти к основному содержимому

💡 Активность элементов

Доступно с версии 3.10.0.

В блоке «Активность элементов» собраны все настройки, от которых зависит поле «Активность» у элементов на сайте: каким создаётся новый элемент, что меняет плановый импорт, что происходит по вебхукам изменения и удаления и какие агенты деактивации работают.

Раньше эти опции были разбросаны по вкладке — в «Настройках логики импорта», «Основных настройках», таблице «Импортируемые поля» и параметрах событий веб-хука. Теперь они в одном блоке: у каждой опции есть подсказка (значок ?), у заблокированной — причина, а вкладка «Как работает» простыми словами объясняет, что модуль сделает с активностью при текущих настройках.

подсказка

Какой способ управления активностью выбрать под вашу задачу — в статье «Управление активностью товаров на сайте».

Где встречается​

Блок находится на вкладках сущностей сразу под разделом «Настройки логики импорта». На этой странице он описан на примере вкладки «Товары»:

ВкладкаОтличия
Товары—
Услугинет отличий
Комплектынет отличий
Модификацииурезанный набор опций — Активность модификаций

Краткий вид​

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

Блок «Активность элементов» в кратком виде

В шапке — общий режим и список включённых правил (архив, группы, свойство-флаг, удаление):

СостояниеЧто значит
N правил включеномодуль меняет активность по включённым правилам охвата и удалению
Активностью управляет сайтни одно правило не включено — модуль активность не меняет
Модуль не трогает активностьвключено «Полностью игнорировать активность»
Активность по доп. полюактивность берётся из доп. поля МойСклад

Строки краткого вида:

СтрокаО чём
Новый элементкаким создаётся элемент, впервые пришедший из МойСклад
Плановый импортчто агент импорта меняет у существующих элементов
Вебхук изменениячто меняется, когда элемент изменили в МойСклад
Вебхук удалениячто происходит с элементом, когда его удалили в МойСклад
Агенты деактивациикакие агенты деактивации работают

Под строкой — значки включённых настроек, из которых следует этот итог. Нажмите на значок — откроется нужная настройка: опция этого блока или, для значков «Фильтр: группы МойСклад» и «Фильтр: свойство-флаг», поле в блоке «Фильтрация элементов».

Кнопка «Настроить» раскрывает блок с настройками, кнопка «Свернуть» возвращает краткий вид.

Настройки​

В раскрытом блоке две вкладки: «Настройки» и «Как работает». На вкладке «Настройки» опции разложены по группам — от тех, что перекрывают всё остальное, к частным правилам.

Блок «Активность элементов», вкладка «Настройки»

Не трогать активность​

Полностью игнорировать активность. Модуль не меняет активность элементов ни при импорте, ни по вебхукам — ни при создании, ни при обновлении: активностью управляет сайт. Когда опция включена, над блоком появляется предупреждение, а «Активность по доп. полю» становится недоступна.

Агенты деактивации при этом продолжают работать по своим правилам. Если они не нужны, снимите правила в столбце «Импорт (агент)» таблицы правил охвата.

Подробнее — в статье «Управление активностью товаров на сайте».

Активность по доп. полю​

Свойство, откуда считываем активность. Выберите доп. поле МойСклад типа «Флажок»: флаг отмечен — элемент активен, снят — выключен. Поле решает при создании, при плановом импорте и по вебхуку. «Не синхронизировать» — доп. поле не используется.

Важно!

Доп. поле перекрывает правила охвата и «Создавать новые элементы неактивными» — при выбранном поле они выключаются принудительно, а агенты деактивации не работают.

Недоступно, если включено «Полностью игнорировать активность».

Новые элементы​

Создавать новые элементы неактивными. Новые элементы из МойСклад создаются выключенными — их включает менеджер на сайте после проверки карточки. Модуль сам элементы не включает (ни при обновлении, ни по вебхукам, в том числе после выхода из архива), а выключать продолжает: архив, удаление, выход из группы или фильтра.

Можно совмещать с «Полностью игнорировать активность»: элемент создаётся неактивным, а дальше модуль его активность не меняет. Недоступно, если активность берётся из доп. поля.

Подробнее — в статье «Управление активностью товаров на сайте».

Правила охвата: архив, группы, фильтр​

Импортировать архивные элементы. Архивные элементы МойСклад тоже загружаются в Битрикс и создаются неактивными. Правило «Архив» при этом включается принудительно — и для импорта, и для вебхука, а агент деактивации по архиву не нужен: архивные элементы видит сам импорт. Если опция выключена, архивные элементы не загружаются и не создаются.

Ниже — таблица правил. Каждое правило выключает элемент, вышедший из охвата, и включает вернувшийся. Столбцы — где правило работает: «Импорт (агент)» — при плановом импорте и в агентах деактивации, «Вебхук» — когда элемент изменили в МойСклад.

ПравилоЧто делаетКогда доступно
Архиввыключает элемент, ушедший в архив МойСклад, вернувшийся из архива — включаетвсегда
Группы МойСкладвыключает элемент вне выбранных групп, вернувшийся в группу — включаетвыбраны группы МойСклад в блоке «Фильтрация элементов»
Свойство-флагвыключает элемент, не прошедший свойство-флаг, прошедший — включаетвыбрано свойство-флаг в блоке «Фильтрация элементов»

Недоступное правило показано бледным, а под таблицей написано, чего не хватает — например: «„Свойство-флаг“ — недоступно: не выбрано свойство-флаг в разделе „Фильтрация элементов“».

Плановый импорт не получает элементы вне выбранных групп и не прошедшие свойство-флаг — их выключают агенты деактивации. Если включено «Создавать новые элементы неактивными», правила элементы только выключают, а обратно не включают.

Элементы вне охвата на вебхуке

Элемент, не прошедший свойство-флаг, а без правила «Группы МойСклад» — и вне выбранных групп, вебхук дальше не обновляет: поля, цены и остатки остаются как есть. Элемент вне охвата, который правило только что выключило, тоже не обновляется; уже выключенный продолжает получать поля, цены и остатки.

Удаление в МойСклад​

Удалять элемент (по событию DELETE). По вебхуку удаления элемент удаляется из Битрикса. Если опция выключена — элемент остаётся и выключается, а при «Полностью игнорировать активность» остаётся как есть.

Вебхуки настраиваются отдельно — см. «Веб-хуки».

Агенты деактивации​

Эта группа только показывает состояние, настраивать в ней нечего. Агенты деактивации отдельно запрашивают у МойСклад элементы, которых плановый импорт не видит, — архивные, вне групп, не прошедшие свойство-флаг, — и выключают их. Работают по правилам столбца «Импорт (агент)».

АгентВыключаетПочему может не работать
По архивуэлементы, ушедшие в архив МойСкладправило «Архив» для импорта выключено; включено «Импортировать архивные элементы» — архивные элементы видит сам импорт
По фильтруэлементы, не прошедшие свойство-флагправило «Свойство-флаг» для импорта выключено или не выбрано свойство-флаг
По группамэлементы вне выбранных группправило «Группы МойСклад» для импорта выключено или не выбраны группы МойСклад

Если активность берётся из доп. поля, не работает ни один агент. Рядом с каждым агентом видно, работает он или нет («работает» / «не работает»), и почему.

Агенты деактивации запускаются вместе с агентом импорта этой вкладки — раз в 6 минут или из cron, если агент импорта запускается с помощью модуля. Если агент импорта выключен, деактивация не идёт.

Блокировки​

Некоторые опции зависят друг от друга. Заблокированная опция недоступна для изменения, а под ней написано, чем она заблокирована. Когда причина уходит, опция возвращается к прежнему значению. Те же правила применяются при сохранении страницы.

УсловиеЧто происходитНадпись у опции
Включено «Импортировать архивные элементы»правило «Архив» включено в обоих столбцахВключено принудительно: выбрана опция «Импортировать архивные элементы».
Не выбраны группы МойСклад в «Фильтрации элементов»правило «Группы МойСклад» выключено в обоих столбцахНедоступно: не выбраны группы МойСклад в разделе «Фильтрация элементов».
Не выбрано свойство-флаг в «Фильтрации элементов»правило «Свойство-флаг» выключено в обоих столбцахНедоступно: не выбрано свойство-флаг в разделе «Фильтрация элементов».
Включено «Полностью игнорировать активность»доп. поле активности не используетсяНедоступно: включена опция «Полностью игнорировать активность».
Выбрано доп. поле активностивсе правила охвата в обоих столбцах и «Создавать новые элементы неактивными» выключеныВыключено принудительно: активность берётся из доп. поля МойСклад.

Если сработало несколько условий, побеждает нижнее в таблице: например, доп. поле активности выключает правило «Архив», даже если включено «Импортировать архивные элементы».

Как работает​

Вкладка «Как работает» простыми словами показывает, что модуль будет делать с активностью, — по тем же пяти случаям, что и краткий вид, но подробно: строка на каждое действие.

Блок «Активность элементов», вкладка «Как работает»

Сводка считается по текущим значениям формы и меняется сразу, как только вы меняете опции. Начнут действовать изменения после сохранения страницы.

Под каждой строкой — значки настроек, от которых она зависит. Цвет значка показывает состояние:

  • зелёный — включено;
  • серый — выключено;
  • оранжевый — включена настройка, которая перекрывает остальные: «Игнорировать активность» или «Доп. поле активности»;
  • пунктирная рамка — настройка заблокирована; причина видна при наведении.

Нажмите на значок — откроется настройка, от которой он зависит.

ЗначокНастройка
Игнорировать активностьПолностью игнорировать активность
Доп. поле активностиСвойство, откуда считываем активность
Новые — неактивнымиСоздавать новые элементы неактивными
Импорт архивныхИмпортировать архивные элементы
Архив · импорт, Архив · вебхукправило «Архив» в столбце «Импорт (агент)» или «Вебхук»
Группы · импорт, Группы · вебхукправило «Группы МойСклад» в столбце «Импорт (агент)» или «Вебхук»
Свойство-флаг · импорт, Свойство-флаг · вебхукправило «Свойство-флаг» в столбце «Импорт (агент)» или «Вебхук»
Удаление по вебхукуУдалять элемент (по событию DELETE)
Фильтр: группы МойСкладвыбраны ли группы МойСклад в блоке «Фильтрация элементов»
Фильтр: свойство-флагвыбрано ли свойство-флаг в блоке «Фильтрация элементов»

Два последних значка — не опции блока, а условия правил охвата: они показывают, задано ли условие в блоке «Фильтрация элементов», и ведут к нему.

Сохранение​

Блок не сохраняет настройки сам: изменения применяются общей кнопкой «Сохранить» внизу страницы настроек модуля.