Коннекторы

Сокращённый перевод. Раздел Data на русском — абриджированная версия английской документации, не пословный паритет с EN.

Коннектор хранит источник и маппинг и передаёт документы в один индекс. Управление выполняется через Search → Connectors в консоли.

Выбор источникаCopy Anchor Link

Используйте sitemap для списка страниц, url для одной страницы, json или csv для экспорта, xml или yaml для фида, docsearch для обхода документации. XML/YAML описаны отдельно.

CMS push-модули Bitrix, PrestaShop и DIAFAN устанавливаются внутри CMS. Не путайте доступность типа адаптера с наличием готового установочного модуля: проверяйте поддерживаемую платформу и версию в мастере подключения.

НастройкаCopy Anchor Link

1. Укажите доступный URL и тип источника.
2. Выберите стабильный idField, затем поля заголовка, содержимого и URL.
3. Проверьте маппинг, образцы документов и лимит maxDocuments.
4. Запустите импорт вручную и изучите историю задач.
5. Настройте расписание после успешной проверки.

Без стабильного идентификатора изменение содержимого может выглядеть как новый документ. Если число записей неожиданно растёт, сначала проверьте ID и маппинг.

Новые pull-коннекторы и подключения файлов изолируют поисковые ID между источниками. Для правил выдачи и событий используйте ID из результата поиска. Существующие подключения сохраняют прежние ID. Если старый ID уже принадлежит другому источнику, импорт останавливается с SOURCE_ID_CONFLICT: создайте новое изолированное подключение, проверьте его поиск и затем отключите старое.

В новых изолированных подключениях одинаковые копии записи с одним ID объединяются. Если содержимое различается, все варианты этого ID изолируются с DUPLICATE_SOURCE_ID. Ранее принятый документ остаётся доступным, другие корректные записи могут обновиться. Курсор и подтверждение актуальности не продвигаются, отсутствующие записи не удаляются. Выберите уникальный idField или исправьте дубликаты в источнике, затем запустите полное обновление. Старые подключения сохраняют прежнее правило выбора последней записи.

Изменение рабочих настроек подключения, маппинга или списка файлов сбрасывает курсор и подтверждение актуальности для этой конфигурации. Запустите синхронизацию повторно. Старое задание остановится с SOURCE_CONFIG_CHANGED и не перезапишет новое расписание или статус. Изменение черновика общего источника не мешает действующему подключению до успешной проверки и применения. Повторная проверка без новых настроек сохраняет текущий курсор.

Полный проход CMS сверяет её текущий набор записей, даже если CMS не передаёт список удалений. Сверка и очистка затрагивают только записи этого подключения; неполное чтение не подтверждает удаление отсутствующих записей.

Секреты в параметрах URL хранятся зашифрованными, а в консоли показываются как ***. При сохранении и ротации сохраняются исходное кодирование и порядок параметров, включая повторяющиеся имена. Маску можно сохранить для прежнего подключения; при смене адреса или неоднозначном изменении повторяющихся параметров введите секрет заново. Шифротекст из базы нельзя использовать вместо повторного ввода. Эти правила действуют и для старых коннекторов и URL обхода документации.

Контроль результатаCopy Anchor Link

indexed показывает записи, skipped — пропущенные без изменения, pruned — убранные из выдачи, failed — ошибки. Удаления отсутствующих документов допустимы только после полного прохода с pruneDeleted. Дельта-синхронизация объясняет сравнение документов и курсоры.

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