DokumentationCommerceAEM Assets Integration

Konfigurieren des AEM Assets-Projekts zur Unterstützung von Commerce-Metadaten

Letzte Aktualisierung: 11. Mai 2026

Erstellt für:

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

Wenn Sie AEM Assets als DAM (Digital Asset Management System) für Commerce verwenden, können Sie nach der Installation des assets-commerce-Pakets Bilder und Videos für Commerce-Produkte aus der AEM-Autorenumgebung verwalten.

Führen Sie die folgenden Schritte aus, um das AEM Assets-Projekt mit dem erforderlichen Paket-Code und den erforderlichen Metadaten für die Verwaltung von Commerce-Assets aus der AEM-Autorenumgebung zu konfigurieren:

  1. Informationen über den Inhalt des assets-commerce

  2. Führen Sie die Installationsschritte aus, um das AEM Assets-Projekt zur Unterstützung von Commerce-Metadaten zu konfigurieren

AEM Commerce Assets-Commerce-Paketinhalte

Adobe bietet eine AEM Commerce-Paket-Code-assets-commerce zum Hinzufügen von Commerce-Namespace- und Metadatenschema-Ressourcen zur Experience Manager Assets as a Cloud Service-Umgebungskonfiguration.

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 Alternativtext eingeben können, der vom Commerce Store-Ansichtscode eingegeben wurde. Dies ändert nichts daran, wie Produktbilder im Katalog zugewiesen werden oder welchen Umfang sie haben. Siehe ALT-Text in AEM Assets-Metadaten.

  • 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 ​

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.

Voraussetzungen

Sie benötigen die folgenden Ressourcen und Berechtigungen, um den assets-commerce-Code in der AEM Assets as a Cloud Service AEM-Umgebung bereitzustellen:

Produktvisualisierung

[Nur SaaS]{class="badge positive" title="Gilt nur für Adobe Commerce as a Cloud Service- und Adobe Commerce Optimizer-Projekte (von Adobe verwaltete SaaS-Infrastruktur)."} Dynamic Media mit OpenAPI-Funktionen ist ein Self-Service für Produktvisualisierungen mit AEM Assets.

  1. Navigieren Sie zu Ihrer Cloud Manager.

  2. Wählen Sie die gewünschte Umgebung aus.

  3. Aktivieren Sie Dynamic Media mit OpenAPI-Funktionen.

    Wenn die Schaltfläche Dynamic Media mit OpenAPI Funktionen nicht aktiv ist, öffnen Sie ein Support-Ticket.

AEM Assets

[Nur PaaS]{class="badge informative" title="Gilt nur für Adobe Commerce in Cloud-Projekten (von Adobe verwaltete PaaS-Infrastruktur)."} Senden Sie auf AEM as a Cloud Service ein Adobe-Support-Ticket mit den folgenden Informationen:

  • Bezeichnung: Aktivieren der vollständigen Integration von Adobe Commerce mit AEM Assets durch Dynamic Media OpenAPI

    • Inhalt des Support-Tickets:

      • AEM Program ID
      • Adobe Commerce URL
      • AEM Environment ID
      • IMS Org ID

Sobald Sie das Support-Ticket gesendet haben, aktiviert Adobe Dynamic Media mit OpenAPI-Funktionen in Ihrer Cloud Services-Umgebung und gibt die Details wie die IMS-Client-ID frei, damit Sie mit der Integration fortfahren können.

Schritt 1: Installieren des Assets-Commerce-Pakets

  1. Gehen Sie zur AEM Cloud Manager, wählen Sie ein Programm aus und erstellen Produktions- und Staging-Umgebungen die Sie in Adobe Commerce integrieren möchten.

  2. Klonen Sie das in Adobe verwaltete GitRepository für das ausgewählte Programm.

    Cloud Manager-Repository-Anmeldeinformationen und Klonbefehl {width="600" modal="regular"}

    Wählen Sie in Pipelines die Option Access Repo Info aus, um Repository Info zu öffnen. Kopieren Sie den URL- oder Git command line, generieren Sie bei Bedarf ein Zugriffskennwort und klonen Sie es dann lokal mit Ihrem Git-Client.

  3. Laden Sie von GitHub den Paket-Code aus dem AEM Assets Commerce-Repository herunter.

  4. Kopieren Sie lokalen AEM-) den heruntergeladenen Code manuell in das bestehende von Adobe verwaltete Repository.

  5. Ersetzen Sie in allen filter.xml und pom.xml Dateien für Ihr Projekt alle Vorkommen von <my-app> durch Ihren App-Namen.

    note
    NOTE
    Alternativ können Sie den benutzerdefinierten Code in Ihrer AEM Assets-Projektkonfiguration als Maven Paket.

  6. Übertragen Sie die Änderungen und pushen Sie Ihre lokale Entwicklungsverzweigung in das Cloud Manager-Git-Repository.

  7. Konfigurieren Sie eine Bereitstellungs-Pipeline oder stellen Sie sicher, dass Ihre Pipeline Änderungen an der ausgewählten Umgebung bereitstellen kann.

    Cloud Manager-Pipelines {width="600" modal="regular"}

    Wenn die Pipeline vorhanden ist, öffnen Sie das Menü Aktionen (…) Informationen zum Run, Edit, View/Edit variables oder anderen Aktionen finden Sie in der oben verlinkten Dokumentation zur Cloud Manager-Pipeline.

  8. Aktualisieren Sie in AEM Cloud Manager die AEM-Umgebung, indem Sie die Pipeline verwenden, um Ihren Code bereitzustellen.

  9. Gehen Sie zu einem beliebigen Asset und bearbeiten Sie dessen Eigenschaften, um die Änderungen zu validieren:

    • Das Standard-Metadatenschema umfasst die Registerkarte Commerce .

    • Produkt-SKUs und die Eligible for Commerce Felder sind sichtbar.

Registerkarte “Commerce” ist in den Eigenschaften nicht sichtbar

Wenn die Registerkarte Commerce nicht in den Eigenschaften angezeigt wird, müssen Sie die folgenden Schritte im Metadatenschema-Editor manuell ausführen:

  1. Navigieren Sie zum Metadatenschema-Editor.

  2. Wählen Sie Bearbeiten aus, um das Standard-Metadatenschema-Formular zu ändern.

  3. Erstellen Sie eine Commerce-Registerkarte und wählen Sie sie aus.

  4. Ziehen Sie die Komponente Produkt in die Registerkarte Commerce und ordnen Sie sie der commerce:skus zu.

  5. Aktivieren Sie das Kontrollkästchen für Rollen anzeigen und Reihenfolge anzeigen.

  6. Ziehen Sie eine checkbox-Komponente per Drag-and-Drop auf die Registerkarte {2 Commerce} und ordnen Sie sie der commerce:isCommerce zu. Definieren Sie Ja und Nein als Optionen.

Wenn Sie auf andere Probleme stoßen, erstellen Sie ein Support-Ticket oder wenden Sie sich an Ihren AEM Assets Integration-Vertriebsmitarbeiter, um Hilfe zu erhalten.

Schritt 2: Optional. Konfigurieren eines Metadatenprofils

Legen Sie in der AEM Assets-Autorenumgebung Standardwerte für Commerce-Asset-Metadaten fest, indem Sie ein Metadatenprofil erstellen. Wenden Sie dann das neue Profil auf AEM Asset-Ordner an, um diese Standardwerte automatisch zu verwenden. Diese Konfiguration optimiert die Asset-Verarbeitung durch Reduzierung manueller Schritte.

Beim Konfigurieren des Metadatenprofils müssen Sie nur die folgenden Komponenten konfigurieren:

  • Fügen Sie eine Registerkarte Commerce hinzu. Diese Registerkarte ermöglicht Commerce-spezifische Konfigurationseinstellungen, die von der Vorlage hinzugefügt werden.

  • Fügen Sie das Feld Eligible for Commerce zur Registerkarte Commerce hinzu.

Die Komponente Produktdaten-Benutzeroberfläche wird automatisch auf Grundlage der Vorlage hinzugefügt.

Definieren des Metadatenprofils

  1. Melden Sie sich bei der Adobe Experience Manager-Autorenumgebung an.

  2. Navigieren Sie im Adobe Experience Manager-Arbeitsbereich zum Arbeitsbereich für die Inhaltsverwaltung in AEM Assets durch Klicken auf das Adobe Experience Manager-Symbol.

    AEM Assets-Authoring {width="600" modal="regular"}

  3. Öffnen Sie die Administrator-Tools, indem Sie auf das Hammersymbol klicken.

    AEM-Autoren-Admin zur Verwaltung von Metadatenprofilen {width="600" modal="regular"}

  4. Öffnen Sie die Seite Profilkonfiguration , indem Sie auf Metadata Profiles klicken.

  5. Create eines Metadatenprofils für die Commerce-Integration.

    AEM-Autoren-Admin fügt Metadatenprofile hinzu {width="600" modal="regular"}

  6. Fügen Sie eine Registerkarte für Commerce-Metadaten hinzu.

    1. Klicken Sie links auf Settings.

    2. Klicken Sie im Abschnitt Registerkarte auf + und geben Sie dann die Tab Name an, Commerce.

  7. Fügen Sie das Feld Eligible for Commerce zum Formular hinzu.

    AEM-Autoren-Admin fügt Metadatenfelder zum Profil hinzu {width="600" modal="regular"}

    • Klicken Sie auf Build form.

    • Ziehen Sie das Single Line text Feld in das Formular.

    • Fügen Sie den Eligible for Commerce Text für die Bezeichnung hinzu, indem Sie auf Field Label klicken.

    • Fügen Sie auf der Registerkarte Einstellungen den Titeltext zu Feldbezeichnung“.

    • Setzen Sie den Platzhaltertext auf yes.

    • Kopieren Sie den folgenden Wert in das Feld Map to Property und fügen Sie ihn ein

      code language-terminal 
      ./jcr:content/metadata/commerce:isCommerce

  8. Optional. Um genehmigte Commerce-Assets beim Hochladen in die AEM Assets-Umgebung automatisch zu synchronisieren, setzen Sie den Standardwert für das Review Status​auf der Registerkarte Basic auf approved.

  9. Speichern Sie die Aktualisierung.

Anwenden des Metadatenprofils auf den Commerce Assets-Quellordner

  1. Wählen Sie auf der Seite Metadata Profiles das Integrationsprofil Commerce aus.

  2. Wählen Sie im Menü Aktion die Option Apply Metadata Profiles to Folders aus.

  3. Wählen Sie den Ordner aus, der Commerce-Assets enthält.

    Erstellen Sie einen Commerce-Ordner, wenn er noch nicht vorhanden ist.

  4. Wählen Sie Apply aus.

Nächste Schritte

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