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 before-you-begin

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: installation sans OpenSearch
    • Méthode 2: installation avec OpenSearch (Pas d’interruption)
IMPORTANT
En raison de l’annonce de fin de prise en charge de 7 Elasticsearch pour août 2023, il est recommandé à tous les clients Adobe Commerce de migrer vers le moteur de recherche OpenSearch 2.x. Pour plus d’informations sur la migration de votre moteur de recherche lors de la mise à niveau du produit, voir Migration vers OpenSearch dans le Guide de mise à niveau.

Méthode 1 : installation sans OpenSearch method-1

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 OpenSearch Les modules sont désactivés.

  1. Installez Adobe Commerce 2.4.4+ sans Live Search.

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

    code language-bash
    composer require magento/live-search
    
  3. Exécutez les commandes suivantes pour désactiver OpenSearch et les modules connexes, puis installez 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
    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 "Mise à jour par planification" :

    • Flux de produit
    • Flux de variante de produit
    • Flux d’attributs du catalogue
    • Flux de prix du produit
    • Flux de données de site web de Portée
    • Portée Flux de données de groupes de clients
    • Flux de catégories
    • Flux d’autorisations de catégorie
  5. Configurez vos 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, en fonction des configuration requise.

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

  7. Exécutez la commande suivante dans cet ordre :

    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. Vérifier que les données ont été exportées.

  9. Test la connexion depuis le storefront.

Méthode 2 : installation avec OpenSearch method-2

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, OpenSearch 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. OpenSearch est désactivé et Live Search activée une fois que toutes les données de catalogue sont indexées et synchronisées.

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

    code language-bash
    composer require magento/live-search
    
  2. Exécutez la commande suivante pour désactiver temporairement la fonction Live Search modules qui diffusent les résultats de recherche storefront.

    code language-bash
    bin/magento module:disable Magento_LiveSearchAdapter Magento_LiveSearchStorefrontPopover Magento_LiveSearchProductListing
    
    code language-bash
    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 "Mise à jour par planification" :

    • Flux de produit
    • Flux de variante de produit
    • Flux d’attributs du catalogue
    • Flux de prix du produit
    • Porte le flux de données du site web
    • Porte le flux de données de groupes de clients
  4. Configurez vos 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, en fonction des configuration requise.

    Vous devriez pouvoir 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. Exécutez la commande suivante dans cet ordre :

    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. Une fois la synchronisation terminée, utilisez la méthode 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.
  8. Exécutez les commandes suivantes pour activer Live Search modules, désactiver OpenSearch, puis exécutez 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. Test la connexion depuis le storefront.

Configuration des clés d’API configure-api-keys

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 Commerce de la configuration. Dans le Administration, les services Commerce sont disponibles dans la variable Configuration barre latérale lorsqu’un module SaaS est installé.

Synchronisation des données de catalogue synchronize-catalog-data

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 par peuvent prendre jusqu'à 30 minutes. 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

Utilisez la variable Tableau de bord de la gestion des données pour surveiller l’état de synchronisation des données de produit transférées de la base de données Commerce vers les services Commerce SaaS.

Vérifier l’exportation verify-export

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 test-connection

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

  • La variable 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.

Pour autoriser la recherche en direct par le biais d’un pare-feu, ajoutez commerce.adobe.io à la liste autorisée.

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 installée :

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

Mise à jour Live Search update

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 3.1.1 à 4.0.0, modifiez la racine du projet. Composer .json comme suit :

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

    code language-bash
    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 :

    code language-bash
    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 :

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

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

Désinstallation Live Search uninstall

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

Live Search packages 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 jeu 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 les données et les miniatures des principaux résultats de la recherche.

Live Search dependencies dependencies

Les éléments suivants Live Search les dépendances sont capturées par 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