DokumentationCommerceAEM Assets Integrationshandbuch

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

Last update: Thu Jul 10 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Benutzende

Um Commerce Asset-Dateien in AEM Assets zu verwalten, führen Sie die folgenden Schritte aus, um das AEM Assets-Projekt mit dem erforderlichen Textbausteincode und den Metadaten zum Verwalten von Commerce-Assets aus der AEM-Autorenumgebung zu konfigurieren.

  • Schritt 1: Sie eine AEM-Projektvorlage mit dem Textbausteincode, um den Commerce-Namespace und die Metadatenschema-Ressourcen zur Experience Manager Assets as a Cloud Service-Umgebungskonfiguration hinzuzufügen.
  • Schritt 2: Einrichten des Metadatenprofils, das auf Commerce Asset-Dateien angewendet werden soll

Hinzufügen des Textbausteincodes zu Ihrem AEM-Projekt

Adobe bietet assets-commerce ein AEM Commerce-Textbaustein zum Hinzufügen von Commerce-Namespace- und Metadatenschema-Ressourcen zur Experience Manager Assets as a Cloud Service-Umgebungskonfiguration. Stellen Sie diesen Code in Ihrer Umgebung als Maven Paket. Konfigurieren Sie dann die Commerce-Metadaten in der AEM Assets-Authoring-Umgebung, um die Einrichtung abzuschließen.

Mit dem Textbaustein werden die folgenden Ressourcen zur Authoring-Umgebung von AEM Assets hinzugefügt:

  • 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 {}Textbaustein für AEM Commerce finden Sie aufSeite „Readme .

Voraussetzungen

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

Installieren des commerce-assets

  1. Erstellen Sie aus der AEM Cloud Manager bei Bedarf Produktions- und Staging-Umgebungen für Ihr AEM Assets-Projekt.

  2. Konfigurieren Sie bei Bedarf eine Bereitstellungs-Pipeline.

  3. Laden Sie von GitHub den Code aus dem AEM Commerce-Textbaustein herunter.

  4. Installieren Sie lokalen AEM-) den benutzerdefinierten Code als Maven-Paket in Ihrer AEM Assets-Umgebungskonfiguration oder durch manuelles Kopieren des Codes in die vorhandene Projektkonfiguration.

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

  6. Stellen Sie in AEM Cloud Manager Code bereit, um die AEM-Umgebung zu aktualisieren.

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ächster Schritt

[Nur PaaS]{class="badge informative" title="Gilt nur für Adobe Commerce in Cloud-Projekten (von Adobe verwaltete PaaS-Infrastruktur)."} Adobe Commerce-Pakete installieren

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