Onboarding en installatie

Installeer de Catalogusservice om productgegevens van een Commerce-instantie aan te vragen en te ontvangen met de functie GraphQL-API voor catalogusservice. 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. Zie de installatie-instructies voor meer informatie Live zoeken en Product Recommendations.

Systeemvereisten

Softwarevereisten

  • 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 beschikt over twee eindpunten voor instapweigering:

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

Alle Commerce-testinstanties gebruiken het Sandbox-eindpunt.

Voer alle tests van de Lading op het zandbakeindpunt uit. Voordat u begint met het testen van het laden, moet u een Ondersteuningsticket zodat het team van de Diensten het extra serververkeer kan voorzien.

Installatie en configuratie

Aan de slag 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

De nieuwste versie van de extensie Catalog Services installeren (magento/catalog-service) op een Adobe Commerce-instantie waarop Adobe Commerce versie 2.4.4 of hoger wordt uitgevoerd. De Catalogusservice wordt geleverd als een composer-pakket van de repo.magento.com opslagplaats.

Cloud-infrastructuur

Gebruik deze methode om de Catalog Service voor een Commerce Cloud-instantie.

  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 lokale beheer van Commerce-projectomgevingen raadpleegt u Het leiden van takken met CLI in de Gebruikershandleiding Adobe Commerce on Cloud Infrastructure.
  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 vastleggen en doorvoeren voor de composer.json en composer.lock bestanden.

  6. De codewijzigingen toevoegen, toewijzen en doorvoeren voor de composer.json en composer.lock bestanden naar de cloud-omgeving.

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

    Als u de updates naar de cloudomgeving doorvoert, wordt het Commerce-implementatieproces voor cloud om de wijzigingen toe te passen. Controleer de implementatiestatus via de logboek implementeren.

In de bedrijfsruimten

Gebruik deze methode om de Catalog Service voor een instantie ter plaatse.

  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 de Catalog Service, voert u de volgende taken uit om de Catalogusservice te integreren met uw Adobe Commerce-exemplaar. Deze integratie maakt gegevenssynchronisatie en communicatie mogelijk tussen de Commerce-instantie, de Catalogusservice en andere ondersteunende services.

  1. Stel de Commerce Services Connector door de API-sleutels op te geven en een SaaS-gegevensruimte te selecteren.

    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 eerste gegevenssynchronisatie uit vanuit de Gegevensbeheerdashboard.

    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 Eerste synchronisatie in de Handleiding voor het exporteren van SaaS-gegevens.

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

  • Bevestig dat Cron-taken worden uitgevoerd.
  • Controleer of de indexen worden uitgevoerd vanaf de Beheerder of door het Commerce CLI bevel te gebruiken bin/magento indexer:info.
  • Controleer of de Catalog Attributes Feed, Product Feed, Product Overrides Feed, en Product Variant Feed indexeerders worden ingesteld op Update by Schedule.

Toegang tot de service

De Catalog Service GraphQL API is toegankelijk via de https://catalog-service.adobe.io/graphql eindpunt dat POST bevelen over HTTPS gebruikt.

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. Zie voor meer informatie de Storefront Services GraphQL documentatie.

Configuratie van firewall

Toestaan Catalog Service via een firewall toevoegen commerce.adobe.io op de lijst van gewenste personen.

Catalogusservice en API-net

De API-net voor Adobe Developer App Builder laat ontwikkelaars toe om privé of derde APIs en andere interfaces met Adobe producten te integreren gebruikend Adobe IO.

Zie de Catalog Service en API-net onderwerp voor installatie en configuratiedetails.

Gegevensbeheerdashboard

Voor meer informatie over Catalog Service gegevenssynchronisatie, zie Gegevensbeheerdashboard.

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