Commerce Storefront Catalog Service Versionshinweise
In diesen Versionshinweisen werden die neuesten Aktualisierungen des Commerce Catalog Service behandelt, darunter:
-
Versionen des Storefront Catalog Service
- Verbesserungen des Catalog Service-API-Schemas für einen verbesserten Datenabruf.
- Verbesserungen der Sicherheit, Leistung und Zuverlässigkeit für die Catalog Service-API und die zugrunde liegende Infrastruktur.
-
Catalog Service Metapaket-Versionen
- Abhängigkeiten wurden aktualisiert, um die Leistung, Stabilität und Kompatibilität mit anderen Adobe Commerce-Komponenten zu verbessern.
Aktualisierungen werden nach Typ kategorisiert:
Unterstützung wird für die neueste Version bereitgestellt. Versionshinweise für ältere Versionen sind als Referenz enthalten.
Storefront Catalog Service
Version 1.48
19. Februar 2025
categoryTree Abfrage in der GraphQL-API gibt jetzt Kategoriebeschreibungen, Bilder und SEO-Meta-Tags zurück. Dieses Update liefert die Daten, die Entwickler von Storefronts benötigen, um Kategoriebilder anzuzeigen und die Suchmaschinenoptimierung mit korrekten Metadaten-Titeln, Beschreibungen und Keywords zu verbessern. Wird nur bei Commerce-Implementierungen mit dem zusammensetzbaren Katalogdatenmodell für Headless-Storefronts unterstützt<
Version 1.47
12. Februar 2025
CategoryProductView und ermöglicht erweiterte Ansichten und Abfragen für Produkte nach Kategorie. Diese Aktualisierung ermöglicht es Entwicklerinnen und Entwicklern, Produktdaten basierend auf der Kategorie effizient abzurufen und zu filtern, was die Flexibilität und Leistung für kategoriegesteuerte Anwendungsfälle verbessert. Weitere Informationen finden Sie unter Implementieren von Kategorien in der Storefront. Wird nur bei Commerce-Implementierungen mit dem zusammensetzbaren Katalogdatenmodell für Headless-Storefronts unterstützt
Version 1.46
11. Dezember 2025
Version 1.45
17. November 2025
productSearch GraphQL-Abfrage unterstützt jetzt das Filtern von Produktattributen mit dem names. Mit diesem Filter können Sie:
-
Verringern der Größe der Antwort-Payload durch die Anforderung nur bestimmter Attribute
-
Kombination mit dem vorhandenen
roles, um die Sichtbarkeit nach Rolle und Attributname einzugrenzen -
Beispiele:
Nur nach Attributnamen filtern
code language-graphql query { products(skus: ["SKU-001"]) { attributes(names: ["color", "size", "material"]) { name label value } } }Filtern Sie nach Rollen und Namen:
code language-graphql query { products(skus: ["SKU-001"]) { attributes(roles: ["visible in PDP"], names: ["eco_collection", "new"]) { name label value roles } } }
names-Argument weg oder geben Sie ein leeres -Array an.Version 1.44
6. November 2025
Version 1.43
3. November 2025
-
Bereitstellen verschiedener Produktinhalte für verschiedene Kundensegmente
-
Anwenden von gebietsschemaspezifischen Anpassungen ohne Duplizieren von Basisdaten
-
Überschreibungen auf Feldebene mit Ebenenmasken steuern
-
Unterstützung für Premium-, Saison- und Mobile-optimierte Inhaltsebenen
Ebenen werden mit der vorhandenen
productsAbfrage abgerufen, werden Server-seitig aus Anfrage-Headern angewendet und erfordern keine Schemaänderungen. Siehe Katalogebene im Adobe Commerce Optimizer-Handbuch.
Version 1.42
8. September 2025
So rufen Sie die Preisstufe ab:
- Verwenden der
productsAbfrage mit Ihren gewünschten SKUs - Greifen Sie für SimpleProductView auf
price.tierszu - Greifen Sie für ComplexProductView auf
priceRange.minimum.tiersundpriceRange.maximum.tierszu. - Jede Stufe enthält die ermäßigten
tier- undquantity - Mengenschwellenwerte mit
gte(größer oder gleich) undlt(kleiner als) definieren
Beispiel:
query {
products(skus: ["SKU-001"]) {
... on SimpleProductView {
price {
regular { amount { value currency } }
tiers {
tier { amount { value currency } }
quantity {
... on ProductViewTierRangeCondition { gte lt }
}
}
}
}
}
}
Die API gibt jetzt nur noch Preisstufen zurück, deren ermäßigter Preis niedriger als der Mindestendpreis des Produkts ist. Höhere Ebenen werden weggelassen, da stattdessen der Mindestendpreis für die Storefront gelten würde.
Gilt für:
- Einfache Produkte:
price.tiersumfasst nur Ebenen mittier.amount.value<price.final.amount.value(Minimum final). - Komplexe Produkte:
priceRange.minimum.tiersundpriceRange.maximum.tiersverwenden beim Erstellen der Preisspanne dieselbe Regel.
Version 1.41
2. September 2025
null für das Preisfeld zurück, anstatt einen Fehler auszulösen, sodass Kunden fehlende Daten ordnungsgemäß verarbeiten können.
Version 1.40
30. Juli 2025
Version 1.39
24. Juli 2025
recommendationsByUnitIds ruft Empfehlungseinheiten anhand ihrer eindeutigen ID ab, um den Zugriff flexibler und zielgerichteter zu gestalten.
-
unitIdsist erforderlich (Liste der abzurufenden recIds). -
Kontextparameter (
currentSku,cartSkus,userViewHistory,userPurchaseHistory,category) verhalten sich genauso wie in der vorhandenen Recommendations-Abfrage. -
Beispiel
code language-graphql query { recommendationsByUnitIds( unitIds: ["11ee89d1-bfae-4582-a921-2ced44ff6bf7"] currentSku: "24-MB01" cartSkus: ["24-MB01"] ) { totalResults results { unitId unitName totalProducts productsView { sku } pageType typeId storefrontLabel displayOrder } } }
Version 1.38
15. Juli 2025
Version 1.37
20. Juni 2025
Version 1.36
20. Juni 2025
Version 1.35
13. Juni 2025
Magento-Is-Preview-Kopfzeile, um nicht zwischengespeicherte Daten vom Katalog-Endpunkt an den Suchdienst zu übergeben.
Version 1.34
23. März 2025
Version 1.33
29. April 2025
Version 1.32
28. März 2025
Version 1.31
18. Februar 2025
Version 1.30
9. Dezember 2024
Hauptversion: Zusammensetzbares Katalogdatenmodell für Headless-Storefronts, Header-Management und die Handhabung von Produktdaten.
AC-Locale für zusammenstellbare Katalog-API-Vorgänge in AC-Scope-Locale umbenannt. Kopfzeilenzuordnung und Standardwerte wurden angegeben.
CurrencyEnum wurde aktualisiert, um NONE für Produktsuchabfragen zu unterstützen, die an der Verbundlogik ausgerichtet sind.
Version 1.29
9. Dezember 2024
images" folgen jetzt der sortOrder für den Katalogexport, um ein konsistentes Verhalten bei Storefronts und APIs zu gewährleisten.
Version 1.28
Version 1.27
26. September 2024
Version 1.26
22. Oktober 2024
[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.4 und neuer
lastModifiedAt in Produktinformationen für genaue Sitemaps und die Neuindizierung von Suchmaschinen (z. B. Google).
Version 1.23
22. August 2024
[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.4 und neuer
The following sku does not have product override data in the DB: <SKU value>. Make sure data is synced.
Version 1.22
13. August 2024
[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.4 und neuer
Version 1.19
23. Mai 2024
[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.4 und neuer
InStock für Optionswerte berücksichtigt jetzt den enabled der Produktvariante.
Bekannte Einschränkungen
Die folgenden Funktionen werden noch nicht unterstützt:
- Die maximale Größe für die Payload dynamischer Attribute beträgt 9 MB.
- Der Gruppenproduktpreis kann mit einfachen Produktpreisen berechnet werden.
- In einem Bild-Array enthält nur das erste Bild Rollen.
Verwenden Sie API Mesh und die GraphQL-Kern-API für:
- Mindestpreis
- Preisstufe
- Bundle-Produkte mit Festpreisen
Weitere Informationen und Beispiele finden Sie unter Katalog-Service und API-Mesh.
Version 1.18
11. April 2024
[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.4 und neuer
products- und refineProduct-Abfragen geben jetzt anpassbare Optionsdaten für einfache und komplexe Produkte zurück.
Version 1.17
22. Februar 2024
[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.4 und neuer
catalog-service Metapaket v3.1.0+.
Version v1.16
13. Februar 2024
[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.4 und neuer
Bekannte Einschränkungen
Diese Funktionen werden noch nicht unterstützt:
- Die maximale Größe für die Payload dynamischer Attribute beträgt 9 MB.
- Gruppenproduktpreis. Dieser Wert kann mit einfachen Produktpreisen berechnet werden.
- In einem Bild-Array enthält nur das erste Bild Rollen.
Verwenden Sie API Mesh und die GraphQL-Kern-API für:
- Mindestpreis
- Preisstufe
Version 1.13
12. Oktober 2023
[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.4 und neuer
inStock-Flag für Produktvarianten.
urlKey und externalId wurden zum GraphQL-Schema hinzugefügt.
Version 1.12
19. September 2023
[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.4 und neuer
Version 1.11
18. Juli 2023
[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.4 und neuer
recommendations GraphQL-Abfrage für Produktempfehlungen.
Version 1.10
27. Juni 2023
[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.4 und neuer
related products.
Version v1.7
12. April 2023
[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.4 und neuer
Version v1.6
28. März 2023
[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.4 und neuer
products Abfrage wurden Farbfelder hinzugefügt.
entityId mithilfe von API Mesh) .
Version v1.5
6. März 2023
[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.4 und neuer
categories GraphQL hinzugefügt.
Version v1.4
7. Februar 2023
[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.x und neuer
Version 1.3
17. Januar 2023
[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.x und neuer
Version v1.1
18. November 2022
[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.x und neuer
Version 1.0
4. Oktober 2022
[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.x und neuer
Version 0.3 - Beta+
12. September 2022
[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.x und neuer
Beta-Version
9. August 2022
[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.x und neuer
products- und refineProduct-Abfragen geben die folgenden Daten zurück:
- Vordefinierte (System-)Produktattribute.
- Dynamische Produktattribute und deren Filterung nach Rolle (Produktanzeigeseite/Produktlistenseite).
- Produktoptionen.
- Produktbilder und Filtern nach Rolle (PDP/PLP).
- Ein spezifischer Preis für einfache Produkte und Preisspannen für konfigurierbare Produkte.
- Kundengruppenpreise und Preisspannen. Sie geben einen standardmäßigen Fallback-Preis für Käufer ohne Kundengruppe zurück.
- Produkttypen, die B2B-kundenspezifische Preise verwenden.
Catalog Service-Metapaket
Aktualisierungen des Katalog-Service PHP-Metapakets (magento/catalog-service).
-
Für Kunden von Adobe Commerce as a Cloud Service wird die neueste Version in Ihrer Umgebung installiert.
-
Für lokale Adobe Commerce on Cloud-Standorte empfiehlt Adobe die Verwendung von Composer , um das Metapaket Catalog Service in Ihren Cloud-Umgebungen auf die neueste Version zu aktualisieren.
Version v3.3.0
14. Oktober 2025
[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.4 und neuer
magento/data-services auf ^8.0.0 aktualisiert. Überprüfen Sie vor dem Upgrade die Verwendung der Umgebung und der benutzerdefinierten Data Services-API auf Kompatibilität mit 8.x.
Tee
Version v3.2.0
12. April 2024
[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.4 und neuer
Version v3.1.0
26. Januar 2024
[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.4 und neuer
- Category Permission Data Exporter (
magento/module-category-permission-data-exporter) zum Exportieren von Kategorieberechtigungsdaten, die vom Katalog-Service verwendet werden. - Catalog Sync Admin
magento/module-catalog-sync-adminfür die Admin-Benutzeroberfläche und Konfiguration im Zusammenhang mit der Katalogsynchronisierung.
Verwandte Dokumentation
-
Informationen zu Projekten, die in **Adobe Commerce in der Cloud, lokal oder in Adobe Commerce as a Cloud Service bereitgestellt werden, finden Sie in der folgenden Dokumentation:
-
Informationen zu Projekten, die Adobe Commerce Optimizer oder Adobe Commerce Optimizer Connector verwenden, finden Sie in der folgenden Dokumentation: