DokumentationCommerceAEM Assets Integration

Commerce-Metadaten in AEM Assets

Letzte Aktualisierung: 15. Juli 2026

Erstellt für:

  • {"id":"b69b2659-1057-424e-8fc5-ed9e016dc554"}

Commerce-Metadaten sind der Vertrag zwischen AEM Assets und Commerce. Dadurch wird Commerce mitgeteilt, welche Assets für Commerce vorgesehen sind, zu welchen Produkten sie gehören und wie sie verwendet oder angezeigt werden sollen. Diese Metadaten ermöglichen es der AEM Assets-Integration, Asset-Dateien korrekt zuzuordnen und zu synchronisieren.

Commerce-Metadaten ermöglichen die folgenden Funktionen:

  • Markieren Sie ein Asset über Feld commerce:isCommerce als Commerce-geeignet.
  • Verknüpfen eines Assets mit einer oder mehreren Produkt-SKUs über das commerce:skus Feld.
  • Definieren, wie das Asset in Commerce angezeigt wird über die Felder commerce:roles und commerce:positions .
  • Fügen Sie Commerce-spezifischen Alt-Text hinzu, der von der Store Ansicht über die Felder commerce:altTextStoreViews und commerce:altTextValues verschlüsselt wird.
  • Zeigen Sie diese Felder in der AEM Assets-Eigenschaften Benutzeroberfläche über eine Commerce Registerkarte und ein Schemaformular an.
IMPORTANT
Die Commerce-spezifische ALT-Text-Funktion ist noch nicht über Self-Service-Onboarding verfügbar. Sie wird derzeit nur bereitgestellt, wenn Sie das Paket mit benutzerdefiniertem assets-commerce bereitstellen (siehe Manuelles Installieren des Pakets „assets-commerce“). Native Unterstützung ist für eine bevorstehende AEM-Version geplant.

Informationen zum Konfigurieren dieser Ressourcen in Ihrem AEM-Projekt finden Sie unter Konfigurieren des AEM Assets-Projekts. Im Rest dieses Themas wird beschrieben, wie die Metadaten bereitgestellt werden.

AEM Commerce Assets-Commerce-Paketinhalte

Adobe stellt das assets-commerce AEM Commerce-Code-Paket bereit, um Commerce-Namespaces und Metadatenschema-Ressourcen zur Experience Manager Assets as a Cloud Service-Konfiguration hinzuzufügen.

Dieser Paket-Code fügt die folgenden Ressourcen zur Authoring-Umgebung von AEM Assets hinzu:

  • Ein benutzerdefinierter Namespace, der zur Identifizierung von Commerce-bezogenen Eigenschaften Commerce.

    • Ein benutzerdefinierter Metadatentyp commerce:isCommerce mit der Bezeichnung Eligible for Commerce, um mit einem Adobe Commerce-Projekt verknüpfte Commerce-Assets zu taggen.

    • Ein benutzerdefinierter Metadatentyp commerce:skus und eine entsprechende UI-Komponente, um eine Product Data Eigenschaft hinzuzufügen. Produktdaten enthalten die Metadateneigenschaften zum Verknüpfen eines Commerce-Assets mit Produkt-SKUs.

      Benutzerdefiniertes Produktdaten-Benutzeroberflächen-Steuerelement {width="600" modal="regular"}

    • Ein benutzerdefinierter Metadatentyp commerce:roles und commerce:positions Attribute, die zeigen, wie das Asset in Commerce visualisiert wird.

    • Metadaten des Alternativtext-Multifelds (Alt texts), damit Bearbeiter für jeden Code der Commerce-Store-Ansicht Alternativtext eingeben können. Das Mehrfachfeld bleibt in zwei indexorientierten String[] bestehen:

      • commerce:altTextStoreViews - Ansichtscode für jede Zeile speichern.
      • commerce:altTextValues - Abgleichen von Alternativtext am selben Index wie bei jedem Eintrag in commerce:altTextStoreViews.

      App Builder-Implementierungen mit einem externen Matcher können diese Eigenschaften beim Transformieren von Asset-Payloads abfangen. Dies ändert nichts daran, wie Produktbilder im Katalog zugewiesen werden oder welchen Umfang sie haben. Siehe Lokalisierter ALT-Text in AEM Assets-.

  • Ein Metadatenschema-Formular mit einer Registerkarte “Commerce”, das die Eligible for Commerce- und Product Data für das Tagging von Commerce-Assets enthält. Das Formular bietet außerdem Optionen zum Ein- oder Ausblenden der roles- und position in der AEM Assets-Benutzeroberfläche.

    Registerkarte Commerce für das Metadatenschema-Formular von AEM Assets {width="600" modal="regular"}

  • Ein Beispiel für getaggte und genehmigte CommerceAssetsequipment_6.jpg zur Unterstützung der anfänglichen Asset-Synchronisierung. Nur genehmigte Commerce-Assets können von AEM Assets mit Adobe Commerce synchronisiert werden.

NOTE
Weitere Informationen zum {}AEM Commerce-Package-Code} finden Sie auf ​ Seite zu GitHub ​

Lokalisierter ALT-Text in AEM Assets-Metadaten

Das Alt texts​Multifield ist im Metadaten-Editor für AEM Assets-Assets auf der Registerkarte Commerce​verfügbar, wenn Sie ein geeignetes Bild bearbeiten.

IMPORTANT
Das Verhalten der Pre-Store-Ansicht gilt nur für Alternativtext. Die AEM Assets-Integration synchronisiert nicht verschiedene Produktbilder pro Adobe Commerce-Store-Ansicht. Produktbilder aus AEM werden weiterhin mit Commerce synchronisiert. Dies entspricht dem Verhalten bei der Galeriezuweisung wie vor dieser Version.

Das Multifield enthält eine Zeile pro Commerce-Store-Ansicht. Jede Zeile hat zwei Eingaben:

  • Store View Code - Die Kennung der Store-Ansicht (z. B. default oder en_US).

  • Alt Text - Alternativtext für diese Store-Ansicht, begrenzt auf 255 Zeichen.

Wählen Sie Add aus, um weitere Zeilen für zusätzliche Shop-Ansichten hinzuzufügen. Um eine Zeile zu entfernen, klicken Sie auf das Symbol Delete in dieser Zeile, um sie zu entfernen.

Mehrfachfeld „Alt-Texte“ mit Code für Store-Ansicht und Eingabe von Alt-Text {width="600" modal="regular"}

Beim Speichern blockiert die Client-seitige Validierung die Übermittlung, wenn eine Zeile einen leeren Store View Code​hat oder wenn zwei Zeilen denselben Code für die Store-Ansicht verwenden (ignoriert Groß-/Kleinschreibung).

Alternativtexteinträge werden in JCR-Asset-Metadaten als zwei indexorientierte String[] beibehalten:

  • commerce:altTextStoreViews: Ansichtscode für jede Zeile speichern.
  • commerce:altTextValues: Abgleichen von ALT-Text am selben Index wie bei jedem Eintrag in commerce:altTextStoreViews.

Wenn diese Assets mit Adobe Commerce synchronisiert werden, wird Alt-Text für die Einzelspeicheransicht in die Produktmediensammlung für die entsprechenden Speicheransichts-Codes geschrieben. Die zugrunde liegende Bildzuordnung bleibt unverändert.

recommendation-more-help
commerce-help-aem-assets-integration