DokumentationCommerceAEM Assets Integrationshandbuch

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

Last update: Mon Dec 22 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Benutzende

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. Weitere Informationen zu ​

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

  • 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 CommercePackage-Code finden Sie auf der Seite „Readme .

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:

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

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

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

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

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

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

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

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

  3. 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 eine im Metadatenschema-Editor manuell erstellen.

  1. Navigieren Sie zum Metadatenschema-Editor.

  2. Klicken Sie Bearbeiten, 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 zu. commerce:isCommerce 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 ​ Metadata Profiles Seite 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. Klicken Sie auf Apply.

Nächste Schritte

recommendation-more-help
7d6707fb-4d59-44b9-ab2a-b69de39eb44d