DokumentationCommerceIntegreringsguide för AEM Assets

Konfigurera AEM Assets-projektet som stöder Commerce-metadata

Senast uppdaterad: 12 maj 2026

Skapat för:

  • User

När du använder AEM Assets som ett DAM-system (Digital Asset Management) för Commerce kan du med installationen av paketet assets-commerce hantera bilder och videor för Commerce-produkter från AEM utvecklingsmiljö.

Följ de här stegen för att konfigurera AEM Assets-projektet med den paketkod och de metadata som krävs för att hantera Commerce-resurser från AEM redigeringsmiljö:

  1. Läs mer om innehållet i paketet assets-commerce

  2. Slutför installationsstegen för att konfigurera AEM Assets-projektet så att det stöder Commerce-metadata

AEM Commerce assets-commerce package contents

Adobe tillhandahåller en AEM Commerce-paketkod assets-commerce för att lägga till Commerce-namnområdes- och metadataschemaresurser i Experience Manager Assets as a Cloud Service-miljökonfigurationen.

Den här paketkoden lägger till följande resurser i AEM Assets redigeringsmiljö:

  • Ett anpassat namnområde, Commerce som identifierar Commerce-relaterade egenskaper.

    • En anpassad metadatatyp commerce:isCommerce med etiketten Eligible for Commerce som taggar Commerce-resurser som är associerade med ett Adobe Commerce-projekt.

    • En anpassad metadatatyp commerce:skus och en motsvarande UI-komponent som lägger till en Product Data-egenskap. Produktdata innehåller metadataegenskaper som associerar en Commerce-resurs med produkt-SKU:er.

      Användargränssnittskontroll för anpassade produktdata {width="600" modal="regular"}

    • En anpassad metadatatyp commerce:roles och commerce:positions för att visa hur resursen visualiseras i Commerce.

  • Ett metadatamatchemaformulär med en Commerce-flik som innehåller fälten Eligible for Commerce och Product Data för taggning av Commerce-resurser. Formuläret innehåller även alternativ för att visa eller dölja fälten roles och position från AEM Assets användargränssnitt.

    Commerce-flik för AEM Assets metadatamatchformulär {width="600" modal="regular"}

  • Ett exempel på taggad och godkänd Commerce-resurs equipment_6.jpg som har stöd för inledande resurssynkronisering. Endast godkända Commerce-resurser kan synkroniseras från AEM Assets till Adobe Commerce.

NOTE
Mer information om AEM Commerce-paketkoden finns på sidan Viktigt.

Förutsättningar

Du behöver följande resurser och behörigheter för att distribuera paketkoden assets-commerce till AEM Assets as a Cloud Service AEM-miljön:

Produktbilder

[Endast SaaS]{class="badge positive" title="Gäller endast Adobe Commerce as a Cloud Service- och Adobe Commerce Optimizer-projekt (SaaS-infrastruktur som hanteras av Adobe)."} Dynamic Media med OpenAPI-funktioner är självbetjäning för produktvisningar som drivs av AEM Assets.

  1. Gå till din Cloud Manager.

  2. Välj önskad miljö.

  3. Aktivera Dynamiska media med OpenAPI-funktioner.

    Om knappen Dynamic Media med OpenAPI-funktioner inte är aktiv öppnar du en supportanmälan.

AEM Assets

[PaaS endast]{class="badge informative" title="Gäller endast Adobe Commerce i molnprojekt (Adobe-hanterad PaaS-infrastruktur)."} På AEM as a Cloud Service skickar du en Adobe-supportanmälan med följande information:

  • Titel: Aktivera Dynamic Media OpenAPI för att fullt ut integrera Adobe Commerce med AEM Assets

    • Innehåll i supportanmälan:

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

När du har skickat in supportanmälan aktiverar Adobe Dynamic Media med OpenAPI-funktioner i molntjänstmiljön och delar information, till exempel IMS-klient-ID, så att du kan fortsätta med integreringen.

Steg 1: Installera paketet assets-commerce

  1. Navigera till AEM Cloud Manager, välj ett program och skapa produktions- och mellanlagringsmiljöer som du vill integrera med Adobe Commerce.

  2. Konfigurera en distributionspipeline eller verifiera att pipelinen kan distribuera ändringar till den valda miljön.

  3. Klona Adobe hanterade Git-databas för det valda programmet.

  4. Hämta paketkoden från AEM Assets Commerce-databasen från GitHub.

  5. Kopiera manuellt den hämtade koden från din lokala AEM-utvecklingsmiljö till den befintliga Adobe-hanterade databasen.

  6. Ersätt alla förekomster av <my-app> med ditt programnamn i alla filter.xml och pom.xml files för ditt projekt.

NOTE
Du kan också installera den anpassade koden i din AEM Assets-projektkonfiguration som ett Maven -paket.

  1. Genomför ändringarna och skicka din lokala utvecklingsgren till Cloud Manager Git-databasen.

  2. Från AEM Cloud Manager uppdaterar du AEM-miljön med pipelinen för att distribuera koden.

  3. Gå till en resurs och redigera dess egenskaper för att validera ändringarna:

    • Standardmetadataschemat innehåller fliken Commerce.

    • Produkt-SKU:er och fälten Eligible for Commerce visas.

Fliken Commerce visas inte i egenskaper

Om fliken Commerce inte visas i egenskaper måste du skapa en manuellt i metadataramedigeraren.

  1. Navigera till metadatarammet.

  2. Klicka på Redigera om du vill ändra standardformuläret för metadataram.

  3. Skapa en Commerce-flik och markera den.

  4. Dra och släpp Product-komponenten till fliken Commerce och mappa den till egenskapen commerce:skus.

  5. Markera kryssrutan för visa roller och visa ordning.

  6. Dra och släpp en kryssruta-komponent på fliken Commerce och mappa den till egenskapen commerce:isCommerce. Ange Ja och Nej som alternativ.

Om du stöter på några andra problem skapar du en supportanmälan eller kontaktar din AEM Assets Integration-säljare för att få hjälp.

Steg 2: Valfritt. Konfigurera en metadataprofil

I AEM Assets redigeringsmiljö anger du standardvärden för Commerce-objektmetadata genom att skapa en metadataprofil. Använd sedan den nya profilen i AEM Resursmappar för att automatiskt använda dessa standardvärden. Den här konfigurationen effektiviserar tillgångsbearbetning genom att minska antalet manuella steg.

När du konfigurerar metadataprofilen behöver du bara konfigurera följande komponenter:

  • Lägg till en Commerce-flik. På den här fliken aktiveras Commerce-specifika konfigurationsinställningar som läggs till av mallen.

  • Lägg till fältet Eligible for Commerce på fliken Commerce.

Gränssnittskomponenten för produktdata läggs till automatiskt baserat på mallen.

Definiera metadataprofilen

  1. Logga in i Adobe Experience Manager redigeringsmiljö.

  2. Gå till arbetsytan för innehållsadministration för AEM Assets på Adobe Experience Manager-arbetsytan genom att klicka på ikonen Adobe Experience Manager.

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

  3. Öppna administratörsverktygen genom att välja hammikonen.

    AEM Author Admin hanterar metadataprofiler {width="600" modal="regular"}

  4. Öppna profilkonfigurationssidan genom att klicka på Metadata Profiles.

  5. Create en metadataprofil för Commerce-integreringen.

    AEM Author Admin lägger till metadataprofiler {width="600" modal="regular"}

  6. Lägg till en flik för Commerce-metadata.

    1. Klicka på Settings till vänster.

    2. Klicka på + i flikavsnittet och ange sedan Tab Name, Commerce.

  7. Lägg till fältet Eligible for Commerce i formuläret.

    AEM Author Admin lägger till metadatafält i profilen {width="600" modal="regular"}

    • Klicka på Build form.

    • Dra fältet Single Line text till formuläret.

    • Lägg till texten Eligible for Commerce för etiketten genom att klicka på Field Label.

    • Lägg till etikettexten i Fältetikett på fliken Inställningar.

    • Ange platshållartexten till yes.

    • Kopiera och klistra in följande värde i fältet Map to Property

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

  8. Valfritt. Om du automatiskt vill synkronisera godkända Commerce-resurser när de överförs till AEM Assets-miljön anger du standardvärdet för fältet Review Status​på fliken Basic till approved.

  9. Spara uppdateringen.

Använda metadataprofilen i Commerce resurskällmapp

  1. På sidan ​ Metadata Profiles väljer du Commerce integreringsprofil.

  2. Välj Apply Metadata Profiles to Folders på åtgärdsmenyn.

  3. Markera den mapp som innehåller Commerce-resurser.

    Skapa en Commerce-mapp om den inte finns.

  4. Klicka på Apply.

Nästa steg

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