Instalar Live Search

Live Search se instala como una extensión desde Adobe Marketplace. Después del Live Search El módulo de (con módulos de catálogo como dependencias) está instalado y configurado. Commerce comienza a compartir datos de catálogo y búsqueda con los servicios SaaS. En este punto, Administrador los usuarios pueden configurar, personalizar y administrar facetas de búsqueda, sinónimos y reglas de comercialización.

En este tema se proporcionan instrucciones para realizar las siguientes acciones:

Antes de empezar before-you-begin

Haga lo siguiente:

  1. Confirme que trabajos cron y indexadores se están ejecutando.

  2. Elija el método de incorporación que cumpla sus requisitos y siga las instrucciones.

    • Método 1: Instalar sin OpenSearch
    • Método 2: instale con OpenSearch (Sin tiempo de inactividad)
IMPORTANT
Debido al anuncio de fin de soporte de Elasticsearch 7 para agosto de 2023, se recomienda que todos los clientes de Adobe Commerce migren al motor de búsqueda OpenSearch 2.x. Para obtener información sobre la migración del motor de búsqueda durante la actualización del producto, consulte Migración a OpenSearch en el Guía de actualización.

Método 1: Instalar sin OpenSearch method-1

Este método de incorporación se recomienda al instalar Live Search a un:

  • Nuevo Commerce instalación
  • Entorno de ensayo

En esta situación, las operaciones de tienda se interrumpen mientras que la variable Live Search el servicio indexa todos los productos del catálogo. Durante la instalación, Live Search Los módulos de están activados y OpenSearch módulos están desactivados.

  1. Instalar Adobe Commerce 2.4.4+ sin Live Search.

  2. Para descargar live-search ejecute lo siguiente desde la línea de comandos:

    code language-bash
    composer require magento/live-search
    
  3. Ejecute los siguientes comandos para deshabilitar OpenSearch y módulos relacionados, e instale Live Search:

    code language-bash
    bin/magento module:disable Magento_Elasticsearch Magento_Elasticsearch7 Magento_OpenSearch Magento_ElasticsearchCatalogPermissions Magento_InventoryElasticsearch Magento_ElasticsearchCatalogPermissionsGraphQl
    
    code language-bash
    bin/magento setup:upgrade
    
    note warning
    WARNING
    Mientras los datos están indexados y sincronizados, las operaciones de búsqueda y exploración de categorías no están disponibles en la tienda. Según el tamaño del catálogo, el proceso puede tardar al menos una hora desde el momento en que se realiza cron se ejecuta para sincronizar los datos con Live Search servicios.
  4. Compruebe que lo siguiente indexadores están configuradas como "Actualizar según lo programado":

    • Fuente de productos
    • Fuente de variante del producto
    • Fuente de atributos de catálogo
    • Fuente de precios de productos
    • Fuente de datos del sitio web Ámbitos
    • Fuente de datos de grupos de clientes ámbitos
    • Fuente de categorías
    • Fuente de permisos de categoría
  5. Configure su Claves de API y compruebe que los datos del catálogo estén sincronizado con Live Search servicios.

  6. Para que las facetas estén disponibles como filtros en la tienda, agregue facetas necesita, de acuerdo con la requisitos faceteados.

    Debe poder agregar facetas después de cron ejecuta las fuentes de atributos y exporta los metadatos de atributos.

  7. Ejecute el siguiente comando en este orden:

    code language-bash
    bin/magento saas:resync --feed productattributes
    bin/magento saas:resync --feed products
    bin/magento saas:resync --feed scopesCustomerGroup
    bin/magento saas:resync --feed scopesWebsite
    bin/magento saas:resync --feed prices
    bin/magento saas:resync --feed productoverrides
    bin/magento saas:resync --feed variants
    bin/magento saas:resync --feed categories
    bin/magento saas:resync --feed categoryPermissions
    
  8. Verificar que los datos se han exportado.

  9. Prueba la conexión desde la tienda.

Método 2: Instalar con OpenSearch method-2

Este método de incorporación se recomienda al instalar Live Search hasta:

  • Una producción existente Commerce instalación

En este escenario, OpenSearch administra temporalmente las solicitudes de búsqueda de la tienda mientras que la variable Live Search El servicio indexa todos los productos en segundo plano, sin interrupciones en las operaciones normales de la tienda. OpenSearch está desactivado y Live Search se activa después de indexar y sincronizar todos los datos del catálogo.

  1. Para descargar live-search ejecute lo siguiente desde la línea de comandos:

    code language-bash
    composer require magento/live-search
    
  2. Ejecute el siguiente comando para deshabilitar temporalmente la variable Live Search módulos de que sirven a resultados de búsqueda de tiendas.

    code language-bash
    bin/magento module:disable Magento_LiveSearchAdapter Magento_LiveSearchStorefrontPopover Magento_LiveSearchProductListing
    
    code language-bash
    bin/magento setup:upgrade
    

    Elasticsearch sigue administrando las solicitudes de búsqueda de la tienda mientras la variable Live Search El servicio sincroniza los datos del catálogo e indexa los productos en segundo plano.

  3. Compruebe que lo siguiente indexadores están configuradas como "Actualizar según lo programado":

    • Fuente de productos
    • Fuente de variante del producto
    • Fuente de atributos de catálogo
    • Fuente de precios de productos
    • Fuente de datos del sitio web Ámbitos
    • Fuente de datos de grupos de clientes ámbitos
  4. Configure su Claves de API y compruebe que los datos del catálogo estén sincronizado con Live Search servicios.

  5. Para que las facetas estén disponibles como filtros en la tienda, agregue facetas necesita, de acuerdo con la requisitos faceteados.

    Debe poder agregar facetas después de cron ejecuta las fuentes de productos y atributos, y exporta los metadatos de atributos a Live Search servicios.

  6. Ejecute el siguiente comando en este orden:

    code language-bash
    bin/magento saas:resync --feed productattributes
    bin/magento saas:resync --feed products
    bin/magento saas:resync --feed scopesCustomerGroup
    bin/magento saas:resync --feed scopesWebsite
    bin/magento saas:resync --feed prices
    bin/magento saas:resync --feed productoverrides
    bin/magento saas:resync --feed variants
    bin/magento saas:resync --feed categories
    bin/magento saas:resync --feed categoryPermissions
    
  7. Una vez finalizada la sincronización, utilice el GraphQL playground con la consulta predeterminada para comprobar lo siguiente:

    • El recuento de productos devuelto está cerca de lo que se espera en la vista de la tienda.
    • Se devuelven las facetas.
  8. Ejecute los siguientes comandos para habilitar Live Search módulos, deshabilitar OpenSearch, y ejecute setup.

    code language-bash
    bin/magento module:enable Magento_LiveSearchAdapter Magento_LiveSearchStorefrontPopover  Magento_LiveSearchProductListing
    
    code language-bash
    bin/magento module:disable Magento_Elasticsearch Magento_Elasticsearch6 Magento_Elasticsearch7 Magento_ElasticsearchCatalogPermissions Magento_InventoryElasticsearch
    Magento_ElasticsearchCatalogPermissionsGraphQl
    
    code language-bash
    bin/magento setup:upgrade
    
  9. Prueba la conexión desde la tienda.

Configuración de claves API configure-api-keys

La clave de la API de Adobe Commerce y su clave privada asociada son necesarias para conectarse Live Search a una instalación de Adobe Commerce. La clave de API se genera y se mantiene en la cuenta de Commerce titular de la licencia, que puede compartirla con el desarrollador o SI. A continuación, el desarrollador puede crear y administrar los espacios de datos SaaS en nombre del titular de la licencia. Si ya tiene un conjunto de claves API, no es necesario que las vuelva a generar.

Titular de la licencia Adobe Commerce

Para generar una clave API y una clave privada, consulte Conector de Commerce Services.

Desarrollador de Adobe Commerce o SI

El desarrollador o SI configura el espacio de datos de SaaS como se describe en la Servicios de Commerce de la configuración. En el Administrador, los servicios de Commerce están disponibles en Configuración barra lateral cuando hay un módulo SaaS instalado.

Sincronización de datos de catálogo synchronize-catalog-data

Live Search requiere datos de productos sincronizados para operaciones de búsqueda y datos de atributos sincronizados para configurar facetas. La sincronización inicial entre el catálogo de productos y el servicio de catálogo comienza cuando Live Search se conecta primero. Según el método de instalación y el tamaño del catálogo, los datos pueden tardar hasta 30 minutos en exportarse e indexarse mediante Live Search. La lista de datos sincronizados y compartidos con el servicio de catálogo se encuentra en el esquema, que se define en:

vendor/magento/module-catalog-data-exporter/etc/et_schema.xml

Utilice el Tablero de administración de datos para monitorizar el estado de sincronización de los datos de producto transferidos desde la base de datos de Commerce a los servicios SaaS de Commerce.

Verificar exportación verify-export

Para comprobar que los datos del catálogo se han exportado desde la instancia de Adobe Commerce y que están sincronizados para Live Search, busque entradas en las tablas siguientes:

  • catalog_data_exporter_products
  • catalog_data_exporter_product_attributes

Para obtener ayuda adicional, consulte Live Search catálogo no sincronizado en la Base de conocimiento de asistencia.

Futuras actualizaciones de productos

Después de la sincronización inicial, las actualizaciones incrementales de productos pueden tardar hasta 15 minutos en estar disponibles para la búsqueda de tiendas. Para obtener más información, vaya a Indexación: actualizaciones de productos de streaming.

Prueba de la conexión test-connection

En la tienda, compruebe lo siguiente:

  • El Search devuelve los resultados correctamente
  • La exploración de categorías devuelve los resultados correctamente
  • Las facetas están disponibles como filtros en las páginas de resultados de búsqueda

Si todo funciona correctamente, ¡enhorabuena! Live Search está instalado, conectado y listo para usar.

Si encuentra problemas en la tienda, consulte la var/log/system.log para errores de comunicación de API o errores en el lado de los servicios.

Para permitir que Live Search pase por un cortafuegos, añada commerce.adobe.io a la lista de permitidos.

Comprobación de la versión instalada

Antes de actualizar Live Search, ejecute lo siguiente desde la línea de comandos para comprobar la versión de Live Search instalada:

composer show magento/module-live-search | grep version

Actualizando Live Search update

Para actualizar Live Search, ejecute lo siguiente desde la línea de comandos:

composer update magento/live-search --with-dependencies

Para actualizar a una versión principal como de 3.1.1 a 4.0.0, edite la raíz del proyecto Composer .json como se indica a continuación:

  1. Si está instalado magento/live-search la versión es 3.1.1 o inferior, y está actualizando a la versión 4.0.0 O superior, ejecute el siguiente comando antes de la actualización:

    code language-bash
    bin/magento module:enable Magento_AdvancedSearch
    

    Para obtener más información sobre el instalado actualmente magento/live-search versión, ejecute el siguiente comando:

    code language-bash
    composer show magento/live-search
    
  2. Abra la raíz composer.json archivo y buscar magento/live-search.

  3. En el require , actualice el número de versión como se indica a continuación:

    code language-json
    "require": {
       ...
       "magento/live-search": "^4.0",
       ...
     }
    
  4. Guardar composer.json. A continuación, ejecute lo siguiente desde la línea de comandos:

    code language-bash
    composer update magento/live-search --with-dependencies
    

Desinstalación Live Search uninstall

Para desinstalar Live Search, consulte Desinstalación de módulos.

Live Search paquetes packages

Paquete
Descripción
module-live-search
Permite a los comerciantes definir la configuración de búsqueda para facetas, sinónimos, reglas de consulta, etc., y proporciona acceso a un área de reproducción de GraphQL de solo lectura para probar consultas desde Administrador.
module-live-search-adapter
Enruta las solicitudes de búsqueda desde la tienda a Live Search y procesa los resultados en la tienda.
- Navegador de categorías - Enruta las solicitudes desde la tienda navegación superior al servicio de búsqueda.
- Búsqueda global: enruta solicitudes desde el búsqueda rápida situado en la esquina superior derecha de la tienda, junto al Live Search servicio.
module-live-search-storefront-popover
Una ventana emergente de "búsqueda mientras escribe" reemplaza la búsqueda rápida estándar y devuelve datos y miniaturas de los resultados de búsqueda principales.

Live Search dependencias dependencies

Lo siguiente Live Search Las dependencias son capturadas por Composer.

  • magento/module-saas-catalog
  • magento/module-saas-category
  • magento/module-saas-category-permissions
  • magento/module-saas-product-override
  • magento/module-saas-product-variant
  • magento/module-saas-price
  • magento/module-saas-scopes
  • magento/module-bundle-product-data-exporter
  • magento/module-catalog-inventory-data-exporter
  • magento/module-catalog-url-rewrite-data-exporter
  • magento/module-configurable-product-data-exporter
  • magento/module-parent-product-data-exporter
  • magento/module-gift-card-product-data-exporter
  • magento/module-bundle-product-override-data-exporter
  • data-services
  • services-id
recommendation-more-help
1d60634e-b73a-404a-be7a-4a2a36676055