DokumentationCommerceAEM Assets Integration

Konfigurieren des AEM Assets-Projekts

Letzte Aktualisierung: 11. Mai 2026

Erstellt für:

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

In diesem Abschnitt wird beschrieben, wie Sie Ihr AEM Assets-Projekt so konfigurieren, dass der Commerce-Namespace, das Metadatenschema und Commerce Registerkarte in der Authoring-Umgebung von AEM verfügbar sind. Hintergrundinformationen zu diesen Ressourcen finden Sie unter Commerce-Metadaten in AEM Assets.

Sie haben zwei Möglichkeiten, das AEM Assets-Projekt zu konfigurieren:

  • [Empfohlen]{class="badge positive"} Self-Service-Onboarding - Aktivieren Sie in AEM-Versionen 2026.5.26309 und höher die Integration in Cloud Manager, indem Sie eine Umgebungsvariable festlegen und Dynamic Media mit OpenAPI-Funktionen aktivieren. Es ist kein benutzerdefinierter Code erforderlich. Siehe Aktivieren der Commerce-Integration (Self-Service).

  • Manuelle Konfiguration - Stellen Sie das assets-commerce-Paket über eine Cloud Manager-Pipeline bereit. Verwenden Sie diese manuellen Schritte, wenn Sie benutzerdefinierten Paket-Code bereitstellen müssen oder wenn Sie eine AEM-Version vor 2026.5.26309 verwenden. Siehe Manuelles Installieren des Assets-Commerce-Pakets.

TIP
Sie können die aktuelle AEM-Version über das Menü oben rechts überprüfen: Help > About AEM.

Aktivieren der Commerce-Integration (Self-Service) enable-aem-commerce-self-service

[Unterstützt]{class="badge informative" title="Unterstützt"} AEM-Version 2026.5.26309 und höher.

In unterstützten AEM-Versionen aktivieren Sie die Commerce-Integration von Cloud Manager aus, ohne benutzerdefinierten Code bereitzustellen. Der Commerce-Namespace, das Metadatenschema und die Registerkarte Commerce werden automatisch bereitgestellt, wenn Sie die Integration im Autoren-Service aktivieren.

Voraussetzungen für den Self-Service

  • Zugriff auf das AEM Cloud Manager-Programm und Umgebungen mit den Rollen „Programm“ und „Bereitstellungs-Manager“

  • Ein AEM-Programm ab Version 2026.5.26309.

  • Die IMS-Org-ID für Ihre Commerce-Instanz.

    Sowohl Ihre Commerce-Instanz als auch die Authoring-Umgebung von AEM Assets müssen sich in derselben IMS-Organisation befinden.

Schritt 1: Erstellen des Programms und der Umgebungen

Das Erstellen eines Programms in Cloud Manager ist ein einzelner Assistentenprozess: Das Programm und seine Umgebungen werden in mehreren Schritten konfiguriert und am Ende gemeinsam gespeichert.

  1. Wählen Sie in Cloud Manager Add Program aus.

  2. Klicken Sie auf Set up for production, geben Sie einen Programmnamen ein und klicken Sie auf Continue.

  3. Wählen Sie im Solutions & Add-ons Schritt die Lösungen und Add-ons aus, die für Ihr Projekt erforderlich sind, einschließlich Dynamic Media, und wählen Sie dann Continue aus.

    Schritt "Cloud Manager-Lösungen und -Add-ons“ mit ausgewähltem Dynamic Media {width="600" modal="regular"}

  4. Geben Sie im Add Environment Schritt Namen für die Umgebungen Produktion und Staging ein und wählen Sie dann eine Region aus.

    Dialogfeld "Cloud Manager-Umgebung hinzufügen“ mit Produktions- und Staging-Details {width="600" modal="regular"}

  5. Wählen Sie Save aus, um das Programm mit seinen Umgebungen zu erstellen.

Schritt 2: Commerce-Integrationsvariable aktivieren

Öffnen Sie in Cloud Manager die in Schritt 1 erstellte Umgebung und dann:

  1. Wählen Sie die Registerkarte Configuration aus.

  2. Fügen Sie eine Umgebungsvariable mit den folgenden Werten hinzu und wählen Sie dann Add und Save aus:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
    Feld Wert
    Name COMMERCE_INTEGRATION_ENABLED
    Wert true
    Service angewendet Autor
    Typ Variable

    Cloud Manager-Umgebungskonfiguration mit der COMMERCEINTEGRATIONENABLED-Variable, die auf den Autoren-Service angewendet wird {width="600" modal="regular"}

    Die Umgebung wird aktualisiert, um die Konfiguration anzuwenden. Warten Sie, bis der Umgebungsstatus zu Running zurückkehrt.

Schritt 3: Aktivieren von Dynamic Media mit OpenAPI-Funktionen

  1. Suchen Sie auf der Registerkarte General nach Dynamic Media.

  2. Wählen Sie neben OpenAPI-Funktionen sind verfügbar die Option Click to activate.

    Registerkarte „Umgebung - Allgemein“ mit dem Link zur Dynamic Media OpenAPI-Aktivierung {width="600" modal="regular"}

    Die Aktivierung erfolgt im Hintergrund. Nach Abschluss des Vorgangs ist die Umgebung für die Commerce-Integration bereit.

    note
    NOTE
    Wenn Click to activate nicht verfügbar ist, öffnen Sie ein Support-Ticket, um Dynamic Media mit OpenAPI-Funktionen zu aktivieren.

Schritt 4: Validieren der Konfiguration

Wechseln Sie zur AEM Assets-Autorenumgebung und öffnen Sie ein beliebiges Asset. Bearbeiten Sie die Eigenschaften und vergewissern Sie sich, dass das Standard-Metadatenschema die Registerkarte Commerce enthält und dass die Felder Product Data und Eligible for Commerce sichtbar sind.

Installieren Sie das Paket assets-commerce manuell

NOTE
Verwenden Sie diese manuelle Methode, um benutzerdefinierten Paket-Code bereitzustellen, oder wenn Sie AEM-Versionen vor 2026.5.26309 verwenden. Verwenden Sie in unterstützten Versionen Aktivieren der Commerce-Integration (Self-Service).

Voraussetzungen

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

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 diesen 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.

Installationsschritte

  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.

Konfigurieren eines Metadatenprofils (optional)

Legen Sie in der AEM Assets-Autorenumgebung Standardwerte für Commerce-Asset-Metadaten fest, indem Sie ein Metadatenprofil erstellen. Um diese Standardwerte automatisch zu verwenden, wenden Sie das neue Profil auf AEM Asset-Ordner an. 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