DokumentationCommerceIntegrering av 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.

    • Alternativa multifältmetadata för text (Alt texts) så att redigerare kan ange alternativ text som är sparad i visningskoden för Commerce Store. Detta ändrar inte hur produktbilder tilldelas eller omfång i katalogen. Se Alternativ text i AEM Assets-metadata.

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

Alternativ text i AEM Assets-metadata

Multifältet Alt texts​är tillgängligt i AEM Assets resursmetadataredigerare på fliken Commerce​när du redigerar en giltig bild.

IMPORTANT
Visningsbeteendet per butik gäller endast alternativ text. AEM Assets-integreringen synkroniserar inte olika produktbilder per Adobe Commerce Store-vy. Produktbilder från AEM fortsätter att synkroniseras till Commerce med samma galleritilldelningsbeteende som före den här versionen.

Flerfältet innehåller en rad per Commerce Store-vy. Varje rad har två inmatningar:

  • Store View Code - ID:t för butiksvyn (till exempel default eller en_US).

  • Alt Text - Alternativ text för den butiksvyn, begränsad till 255 tecken.

Välj Add om du vill lägga till fler rader för ytterligare butiksvyer. Om du vill ta bort en rad markerar du ikonen Delete på den raden för att ta bort den.

Alt-textmultifält med Store View Code och Alt Text input {width="600" modal="regular"}

När du sparar blockerar validering på klientsidan överföring om en rad har en tom Store View Code​eller om två rader använder samma kod för butiksvyn (skiftlägesokänslig).

Alternativa textposter sparas i JCR-resursens metadata som två indexjusterade String[]-egenskaper:

  • commerce:altTextStoreViews: Lagra vykod för varje rad.
  • commerce:altTextValues: Matchande alternativ text vid samma index som varje post i commerce:altTextStoreViews .

När dessa resurser synkroniseras med Adobe Commerce, skrivs alternativ text för butiksvyn till produktmediegalleriet för de matchande butiksvykoderna. Den underliggande bildmappningen är oförändrad.

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