Onboarding en installatie

Installeer de Dienst van de Catalogus om productgegevens van een instantie van Commerce te verzoeken en te ontvangen gebruikend de dienst GraphQL API van de Catalogus. De Catalog Service wordt geleverd als een composer-pakket van de repo.magento.com-opslagplaats.

NOTE
Als uw Commerce-exemplaar gebruikmaakt van Live Search of Product Recommendations, wordt de Catalogusservice automatisch geïnstalleerd of bijgewerkt wanneer u aan boord bent of een upgrade uitvoert van deze services. Voor details, zie de installatieinstructies voor Levend Onderzoeken Recommendations van het Product.

Systeemvereisten

de vereisten van de Software

  • Adobe Commerce 2.4.4+
  • PHP 8.1, 8.2, 8.3
  • Composer: 2.x

Ondersteunde platforms

  • Adobe Commerce op cloudinfrastructuur: 2.4.4+
  • Adobe Commerce in bedrijven: 2.4.4+

Eindpunten

Catalog Service heeft twee eindpunten beschikbaar voor instapweigering:

  • Sandbox (https://catalog-service-sandbox.adobe.io/graphql)—wordt gebruikt voor het testen en valideren voordat u live gaat
  • Productie (https://catalog-service.adobe.io/graphql) - gebruikt voor levend verkeer voor de handelaren en websites van Commerce

Alle Commerce-testinstanties gebruiken het Sandbox-eindpunt.

Voer alle tests van de Lading op het zandbakeindpunt uit. Alvorens u begint lading het testen, voorlegt a kaartje van de Steunzodat het team van de Diensten het extra serververkeer kan voorzien.

Installatie en configuratie

Om aan de slag te gaan met Catalog Service voor Adobe Commerce, zijn de volgende stappen vereist:

  • De extensie Catalog Service installeren (magento/catalog-service)
  • De service- en gegevensexport configureren
  • Toegang tot de service

De extensie Catalog Service installeren

recommendation-more-help

Vereiste

Installeer de recentste versie van de uitbreiding van de Diensten van de Catalogus (magento/catalog-service) op een instantie van Adobe Commerce die Adobe Commerce versie 2.4.4 of later in werking stelt. De dienst van de Catalogus wordt geleverd als composer metapakket van de {🔗 bewaarplaats 0} repo.magento.com.

de infrastructuur van de Wolk

Gebruik deze methode om Catalog Service voor een instantie van de Commerce Cloud te installeren.

  1. Schakel op uw lokale werkstation de projectmap voor uw Adobe Commerce over het infrastructuurproject voor de cloud in.

    note note
    NOTE
    Voor informatie over het beheren van het projectmilieu's van Commerce plaatselijk, zie het Leiden takken met CLIin Adobe Commerce op de Gids van de Gebruiker van de Infrastructuur van de Wolk.
  2. Bekijk de omgevingsvertakking die u wilt bijwerken met de Adobe Commerce Cloud CLI.

    code language-shell
    magento-cloud environment:checkout <environment-id>
    
  3. Voeg de module Catalogusservice toe.

    code language-bash
    composer require magento/catalog-service --no-update
    
  4. Pakketafhankelijkheden bijwerken.

    code language-bash
    composer update "magento/catalog-service"
    
  5. Wijzigingen in de code voor de bestanden composer.json en composer.lock doorvoeren en uitvoeren.

  6. Voeg de codewijzigingen voor de composer.json - en composer.lock -bestanden toe, wijs deze toe en duw ze naar de cloudomgeving.

    code language-shell
    git add -A
    git commit -m "Add catalog service module"
    git push origin <branch-name>
    

    Het duwen van de updates aan het wolkenmilieu stelt het proces van de wolkenplaatsing van Commercein werking om de veranderingen toe te passen. Controleer de plaatsingsstatus van opstellen logboek.

op-gebouw

Gebruik deze methode om Catalog Service voor een instantie op locatie te installeren.

  1. Composer van het gebruik om de module van de Dienst van de Catalogus aan uw project toe te voegen:

    code language-bash
    composer require magento/catalog-service --no-update
    
  2. Afhankelijkheden bijwerken en de extensie installeren:

    code language-bash
    composer update  "magento/catalog-service"
    
  3. Upgrade Adobe Commerce:

    code language-bash
    bin/magento setup:upgrade
    
  4. Cache wissen:

    code language-bash
    bin/magento cache:clean
    
    note tip
    TIP
    In sommige gevallen, vooral wanneer het opstellen aan productie, zou u gecompileerde code kunnen willen vermijden omdat het wat tijd kan vergen. Zorg ervoor dat u een back-up van het systeem maakt voordat u wijzigingen aanbrengt.

De service- en gegevensexport configureren

Nadat u Catalog Service hebt geïnstalleerd, voert u de volgende taken uit om de catalogusservice te integreren met uw Adobe Commerce-instantie. Deze integratie maakt de gegevenssynchronisatie en communicatie tussen de instantie van Commerce, de Dienst van de Catalogus, en andere ondersteunende diensten mogelijk. De synchronisatie van gegevens wordt behandeld door de uitbreiding van de Uitvoer van Gegevens SaaS.

  1. Opstelling de Verbinding van de Diensten van Commercedoor de API sleutels te specificeren en een Ruimte van Gegevens te selecteren SaaS.

    Commerce Services Connector-installatie is een eenmalig proces dat vereist is voor het gebruik van Adobe Commerce-services zoals Catalog Service, Live Search en Product Recommendations. Als u reeds de schakelaar voor een andere dienst hebt gevormd, sla deze stap over.

  2. Voer een aanvankelijke gegevenssynchronisatie van het dashboard van het Beheer van Gegevens uit.

    De eerste synchronisatie kan enkele minuten tot uren duren, afhankelijk van de grootte van de catalogus. U kunt de synchronisatiestatus controleren via het dashboard voor gegevensbeheer. Na de eerste synchronisatie worden de productgegevens van de Catalogus doorlopend geëxporteerd om de services up-to-date te houden.

    note note
    NOTE
    U kunt de eerste synchronisatie ook starten vanaf de opdrachtregel met behulp van de Commerce CLI. Zie Aanvankelijke synchronisatiein de Gids van de Uitvoer van Gegevens SaaS.

Ga als volgt te werk om te controleren of de catalogus correct wordt geëxporteerd:

  • Bevestig dat de bouwbanenlopen.
  • Verifieer dat de indexen van Adminlopen of door het bevel van Commerce CLI te gebruiken bin/magento indexer:info.
  • Controleer of de indexen Catalog Attributes Feed, Product Feed, Product Overrides Feed en Product Variant Feed op Update by Schedule zijn ingesteld.

Gegevenssynchronisatie controleren en problemen oplossen

Van Commerce Admin, kunt u het synchronisatieproces controleren gebruikend het Dashboard van het Beheer van Gegevens. Gebruik CLI van Commerceen logboeken om het proces te beheren en problemen op te lossen.

Toegang tot de service

De Catalog Service GraphQL API is toegankelijk vanaf het https://catalog-service.adobe.io/graphql -eindpunt met behulp van POSTEN via HTTPS.

In uw GraphQL-query's moet u meerdere HTTP-headers opgeven, inclusief de openbare API-sleutel die u hebt toegevoegd aan de Adobe Commerce Services Connector-configuratie in de Admin. Voor details, zie de 🔗 documentatie 1} van GraphQL van de Diensten 0} Storefront.

Configuratie van firewall

Als u Catalog Service wilt toestaan via een firewall, voegt u commerce.adobe.io toe aan de lijst van gewenste personen.

Catalogusservice en API-net

Het API Net voor Adobe Developer App Builderlaat ontwikkelaars toe om privé of derde APIs en andere interfaces met Adobe producten te integreren gebruikend Adobe IO.

Zie het Catalog Service en API Netonderwerp voor installatie en configuratiedetails.

Gegevensbeheerdashboard

Voor meer informatie over Catalog Service gegevenssynchronisatie, zie het Dashboard van het Beheer van Gegevens.

7c786b3e-f793-4e26-b38a-3fe76d8eca72