Installer Live Search

Live Search est installé en tant qu’extension à partir d’Adobe Marketplace. Après la Live Search module (avec les modules de catalogue comme dépendances) est installé et configuré, Commerce Commence à partager les données de recherche et de catalogue avec les services SaaS. À ce stade, Administration les utilisateurs peuvent configurer, personnaliser et gérer des facettes de recherche, des synonymes et des règles de marchandisage.

Cette rubrique fournit des instructions pour effectuer les opérations suivantes :

Avant de commencer

Procédez comme suit :

  1. Confirmez que tâches cron et indexeurs sont en cours d’exécution.

  2. Choisissez la méthode d’intégration qui répond à vos besoins et suivez les instructions.

    • Méthode 1: Installer sans Elasticsearch
    • Méthode 2: Installer avec Elasticsearch (Pas d’interruption)

Méthode 1 : Installation sans Elasticsearch

Cette méthode d’intégration est recommandée lors de l’installation de Live Search à un :

  • Nouveau Commerce installation
  • Environnement d’évaluation

Dans ce scénario, les opérations de storefront sont interrompues pendant que la fonction Live Search service indexe tous les produits du catalogue. Pendant l'installation, Live Search les modules sont activés et Elasticsearch Les modules sont désactivés.

CONSEIL

Pour éviter les erreurs de saisie, pointez sur l’extrémité droite de la zone de code, puis cliquez sur l’icône Copier et collez-le dans la ligne de commande.

  1. Installez Adobe Commerce 2.4.x sans Live Search.

  2. Pour télécharger le live-search , exécutez les éléments suivants à partir de la ligne de commande :

    composer require magento/live-search
    

    Voir à ce sujet la liste des Live Search dependencies qui sont capturés par Composer.

  3. Exécutez les commandes suivantes pour désactiver Elasticsearch et les modules connexes, puis installez Live Search:

    bin/magento module:disable Magento_Elasticsearch Magento_Elasticsearch6 Magento_Elasticsearch7 Magento_ElasticsearchCatalogPermissions Magento_InventoryElasticsearch
    Magento_ElasticsearchCatalogPermissionsGraphQl
    
    bin/magento setup:upgrade
    
    AVERTISSEMENT

    Bien que les données soient indexées et synchronisées, les opérations de recherche et de navigation de catégorie ne sont pas disponibles dans le storefront. Selon la taille de votre catalogue, le processus peut prendre au moins une heure à partir du cron s’exécute pour synchroniser vos données avec Live Search services.

  4. Vérifiez que les indexeurs sont définis sur Update by Schedule:

    • Flux de produit
    • Flux de variante de produit
    • Flux d’attributs du catalogue
  5. Configurez Clés API et vérifier que les données de votre catalogue sont synchronisé avec Live Search services.

  6. Pour rendre les facettes disponibles en tant que filtres dans le storefront, ajoutez le facettes vous avez besoin, selon les configuration requise.

    Vous devriez être en mesure d’ajouter des facettes après cron exécute les flux d’attributs et exporte les métadonnées d’attribut.

  7. Patientez au moins une heure après cron s’exécute pour synchroniser les données. Alors, verify que les données ont été exportées.

  8. Test la connexion depuis le storefront.

Méthode 2 : Installation avec Elasticsearch

Cette méthode d’intégration est recommandée lors de l’installation de Live Search à :

  • Une production existante Commerce installation

Dans ce scénario, Elasticsearch gère temporairement les requêtes de recherche à partir du storefront pendant que la fonction Live Search service indexe tous les produits en arrière-plan, sans interruption des opérations standard de storefront. Elasticsearch est désactivé et Live Search activée une fois que toutes les données de catalogue sont indexées et synchronisées.

CONSEIL

Pour éviter les erreurs de saisie, pointez sur l’extrémité droite de la zone de code, puis cliquez sur l’icône Copier et collez-le dans la ligne de commande.

  1. Pour télécharger le live-search , exécutez les éléments suivants à partir de la ligne de commande :

    composer require magento/live-search
    

    Voir à ce sujet la liste des Live Search dependencies qui sont capturés par Composer.

  2. Exécutez la commande suivante pour désactiver temporairement la fonction Live Search modules qui diffusent les résultats de recherche storefront.

    bin/magento module:disable Magento_LiveSearchAdapter Magento_LiveSearchStorefrontPopover
    
    bin/magento setup:upgrade
    

    Elasticsearch continue à gérer les requêtes de recherche à partir du storefront pendant que la fonction Live Search Le service synchronise les données du catalogue et indexe les produits en arrière-plan.

  3. Vérifiez que les indexeurs sont définis sur Update by Schedule:

    • Flux de produit
    • Flux de variante de produit
    • Flux d’attributs du catalogue
  4. Configurez Clés API et vérifier que les données de votre catalogue sont synchronisé avec Live Search services.

  5. Pour rendre les facettes disponibles en tant que filtres dans le storefront, ajoutez le facettes vous avez besoin, selon les configuration requise.

    Vous devriez être en mesure d’ajouter des facettes après cron exécute les flux de produit et d’attribut et exporte les métadonnées d’attribut vers Live Search services.

  6. Patientez au moins une heure pour que les données soient indexées et synchronisées. Ensuite, utilisez le Jeu GraphQL avec la requête par défaut pour vérifier les éléments suivants :

    • Le nombre de produits renvoyé est proche de ce que vous attendez pour la vue de magasin.
    • Les facettes sont renvoyées.
  7. Exécutez les commandes suivantes pour activer Live Search modules, désactiver Elasticsearchet exécutez setup.

    bin/magento module:enable Magento_LiveSearchAdapter Magento_LiveSearchStorefrontPopover
    
    bin/magento module:disable Magento_Elasticsearch Magento_Elasticsearch6 Magento_Elasticsearch7 Magento_ElasticsearchCatalogPermissions Magento_InventoryElasticsearch
    Magento_ElasticsearchCatalogPermissionsGraphQl
    
    bin/magento setup:upgrade
    
  8. Test la connexion depuis le storefront.

Configuration des clés d’API

La clé d’API Adobe Commerce et sa clé privée associée sont nécessaires pour se connecter. Live Search à une installation d’Adobe Commerce. La clé API est générée et conservée dans le compte de la variable Commerce titulaire de la licence, qui peut la partager avec le développeur ou l’instance SI. Le développeur peut ensuite créer et gérer les espaces de données SaaS pour le compte du détenteur de licence. Si vous disposez déjà d’un ensemble de clés d’API, vous n’avez pas besoin de les régénérer.

détenteur d’une licence Adobe Commerce

Pour générer une clé API et une clé privée, reportez-vous à la section Connecteur Commerce Services.

Développeur Adobe Commerce ou SI

Le développeur ou l’ID configure l’espace de données SaaS comme décrit dans la section Services de commerce de la configuration. Dans le Administration, Commerce Services devient disponible dans le Configuration barre latérale lorsqu’un module SaaS est installé.

Synchronisation des données de catalogue

Live Search nécessite des données de produit synchronisées pour les opérations de recherche et des données d’attribut synchronisées pour configurer les facettes. La synchronisation initiale entre le catalogue de produits et le service de catalogue commence lorsque Live Search est d’abord connecté. Selon la méthode d’installation et la taille du catalogue, l’export et l’indexation des données peuvent prendre jusqu’à huit heures. Live Search. La liste des données synchronisées et partagées avec le service de catalogue se trouve dans le schéma, défini dans :

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

Vérifier l’exportation

Pour vérifier que les données du catalogue ont été exportées à partir de votre instance Adobe Commerce et sont synchronisées pour Live Search, recherchez les entrées dans les tableaux suivants :

  • catalog_data_exporter_products
  • catalog_data_exporter_product_attributes

Pour obtenir une aide supplémentaire, reportez-vous à la section Live Search catalogue non synchronisé dans la base de connaissances d’assistance.

Futures mises à jour des produits

Après la synchronisation initiale, il peut s’écouler jusqu’à 15 minutes avant que les mises à jour incrémentielles des produits ne soient disponibles pour la recherche storefront. Pour en savoir plus, accédez à Indexation - Mises à jour des produits en flux continu.

Tester la connexion

Dans le storefront, vérifiez les éléments suivants :

  • Le Search la zone renvoie les résultats correctement
  • La navigation dans les catégories renvoie correctement les résultats.
  • Les facettes sont disponibles sous forme de filtres sur les pages de résultats de recherche.

Si tout fonctionne correctement, félicitations ! Live Search est installé, connecté et prêt à l’emploi.

Si vous rencontrez des problèmes dans le storefront, vérifiez la variable var/log/system.log pour les erreurs ou échecs de communication de l’API côté services.

Vérification de la version installée

Avant de mettre à jour la recherche en direct, exécutez le code suivant depuis la ligne de commande pour vérifier la version de la recherche en direct actuellement installée :

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

Mise à jour Live Search

Pour mettre à jour Live Search, exécutez les opérations suivantes à partir de la ligne de commande :

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

Pour effectuer une mise à jour vers une version majeure, telle que de 1.0.0 à 2.0.0, modifiez la racine du projet. Composer .json comme suit :

  1. Si votre magento/live-search version est 1.3.1 ou version inférieure et que vous effectuez une mise à niveau vers la version 2.0.0 ou supérieur, exécutez la commande suivante avant la mise à niveau :

    bin/magento module:enable Magento_AdvancedSearch
    

    Pour plus d’informations sur la version actuellement installée magento/live-search version, exécutez la commande suivante :

    composer show magento/live-search
    
  2. Ouvrez la racine composer.json fichier et recherchez magento/live-search.

  3. Dans le require , mettez à jour le numéro de version comme suit :

    "require": {
       ...
       "magento/live-search": "^2.0",
       ...
     }
    
  4. Enregistrer composer.json. Exécutez ensuite la commande suivante à partir de la ligne de commande :

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

Désinstallation Live Search

Pour désinstaller Live Search, voir Désinstallation des modules.

Live Search packages

Package Description
module-live-search Permet aux commerçants de configurer leurs paramètres de recherche pour la facette, les synonymes, les règles de requête, etc., et permet d’accéder à un terrain de lecture GraphQL en lecture seule pour tester les requêtes à partir de la variable Administration.
module-live-search-adapter Permet d’acheminer les requêtes de recherche du storefront vers le Live Search et effectue le rendu des résultats dans le storefront.
- Navigation dans les catégories - achemine les demandes depuis le storefront navigation supérieure au service de recherche.
- Recherche globale - achemine les requêtes de la recherche rapide dans le coin supérieur droit du storefront vers la propriété Live Search service.
module-live-search-storefront-popover Une fenêtre contextuelle "Rechercher lorsque vous tapez" remplace la recherche rapide standard et renvoie des suggestions de produits dynamiques et des miniatures des principaux résultats de recherche.

Live Search dependencies

Les éléments suivants Live Search les dépendances sont capturées par Composer:

Dépendance Description
Exporter les modules Les modules suivants collectent et synchronisent les données du catalogue :
saas-export
module-bundle-product-exporter
module-catalog-data-exporter
module-catalog-inventory-data-exporter
module-catalog-url-rewrite-data-exporter
module-configurable-product-data-exporter
module-data-exporter
module-parent-product-data-exporter
services-connector Requis pour configurer votre connexion à Commerce Services.
module-services-id Requis pour configurer votre connexion à Commerce Services.

Sur cette page