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.
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
Vereiste
-
Toegang repo.magento.com om de extensie te installeren. Voor sleutelgeneratie en het verkrijgen van de nodige rechten, zie Uw verificatietoetsen ophalen. Zie voor installatie in de cloud de Commerce on Cloud Infrastructure Guide
-
Toegang tot de opdrachtregel van de Adobe Commerce-toepassingsserver.
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.
Gebruik deze methode om de Catalog Service voor een Commerce Cloud-instantie.
-
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. -
Bekijk de omgevingsvertakking die u wilt bijwerken met de Adobe Commerce Cloud CLI.
code language-shell magento-cloud environment:checkout <environment-id>
-
Voeg de module Catalogusservice toe.
code language-bash composer require magento/catalog-service --no-update
-
Pakketafhankelijkheden bijwerken.
code language-bash composer update "magento/catalog-service"
-
Wijzigingen in de code vastleggen en doorvoeren voor de
composer.json
encomposer.lock
bestanden. -
De codewijzigingen toevoegen, toewijzen en doorvoeren voor de
composer.json
encomposer.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.
Gebruik deze methode om de Catalog Service voor een instantie ter plaatse.
-
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
-
Afhankelijkheden bijwerken en de extensie installeren:
code language-bash composer update "magento/catalog-service"
-
Upgrade Adobe Commerce:
code language-bash bin/magento setup:upgrade
-
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.
-
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.
-
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
, enProduct Variant Feed
indexeerders worden ingesteld opUpdate 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.