DokumentationHandelIntegreringsguide för AEM Assets

Migrera mediefiler till AEM Assets DAM

Last update: Fri Feb 13 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

Skapat för:

  • Användare

Både Adobe Commerce och Adobe Experience Manager (AEM) har inbyggda funktioner för att effektivisera migreringen av mediefiler från Commerce till AEM Assets digitala resurshanteringssystem (DAM). Du kan också migrera mediefiler från andra källor.

Förutsättningar

Kategori
Krav
Systemkrav
  • AEM as a Cloud Service-miljö etablerad med AEM Assets
  • Tillräcklig lagringskapacitet
  • Nätverksbandbredd för stora filöverföringar
Nödvändig åtkomst och behörigheter
  • Administratörsåtkomst till AEM Assets as a Cloud Service
  • Tillgång till källsystemet där mediefiler lagras (Adobe Commerce eller externt system)
  • Lämpliga behörigheter för åtkomst till molnlagringstjänster
Molnlagringskonto
  • AWS S3 eller Azure Blob Storage-konto
  • Privat behållare/bucket-konfiguration
  • Autentiseringsuppgifter
Source Content
Förberedelse av metadata

Bästa praxis för migrering

  1. Kuratera resurser före migrering genom att ta bort oanvänt och duplicerat innehåll.

  2. Ordna materialet logiskt efter storlek, format eller skiftläge.

  3. Överväg att dela upp stora migreringar i mindre grupper.

  4. Schemalägg resurskrävande import under tider med låg belastning.

  5. Validera metadatamappning före fullständig import.

Arbetsflöde för migrering

Följ migreringsarbetsflödet för att exportera mediefiler från Adobe Commerce eller något annat externt system och importera dem till AEM Assets DAM.

Steg 1: Exportera innehåll från den befintliga datakällan

[Endast PaaS]{class="badge informative" title="Gäller endast Adobe Commerce i molnprojekt (Adobe-hanterad PaaS-infrastruktur)."}

För Adobe Commerce-handlare kan modulen Fjärrlagring underlätta import och export av mediefiler. Med den här modulen kan företag lagra och hantera mediefiler med hjälp av fjärrlagringstjänster som AWS S3. Mer information om hur du konfigurerar fjärrlagring för din Commerce-instans finns i Konfigurera fjärrlagring i Konfigurationshandboken för Commerce.

Om du har mediefiler lagrade utanför Adobe Commerce kan du överföra dem direkt till någon av de datakällor som stöds av AEM as a Cloud Service.

Steg 2: Skapa en CSV-fil för metadatamappning

Skapa en CSV-fil som mappar alla mediefiler till Commerce produktdata. Välj någon av följande metoder:

  • Adobe Commerce (PaaS): Använd CLI-kommandot för att automatiskt generera CSV-filen från katalogen
  • Skapa CSV-filen manuellt

Exportera metadata med CLI

[Endast PaaS]{class="badge informative" title="Gäller endast Adobe Commerce i molnprojekt (Adobe-hanterad PaaS-infrastruktur)."}

Använd kommandot AEM Assets Integration CLI för att automatiskt generera en CSV-metadatafil som innehåller bild-URL:er, positioner och roller från de produktmediefiler som lagras i ditt Commerce-projekt.

  1. Visa en lista över tillgängliga kommandon för att verifiera att modulen AEM Assets Integration är installerad:

    code language-bash 
    bin/magento list aem

    De anpassade tilläggskommandona visas under aem i början av kommandolistan.

  2. Kör metadataexportkommandot med ditt AEM-sökvägsprefix:

    code language-bash 
    bin/magento aem:assets:export:csv <AEM-path-prefix>

    <AEM-path-prefix> är den grundläggande mappsökvägen där dina resurser lagras i AEM Assets DAM (till exempel /content/dam/commerce/).

    code language-bash 
    bin/magento aem:assets:export:csv /content/dam/commerce/

    Detta skapar en metadata.csv-fil i katalogen var/export som innehåller bild-URL:er, positioner och roller för varje produktresurs i din Commerce-katalog.

Skapa CSV-filen manuellt

För mediefiler som lagras utanför Adobe Commerce skapar du CSV-filen manuellt. Kolumnrubrikerna måste matcha fältnamnen som konfigurerats i AEM Assets-metadataprofilen. När du har skapat filen fyller du i raderna med metadatavärden för varje mediefil.

Metadata
Beskrivning
Värde
assetPath
Den fullständiga sökvägen där resursen ska lagras i AEM Assets-databasen.

Använd sökvägen för att skapa undermappar för att ordna Commerce-resurser, till exempel content/dam/commerce/<brand>/<type>.
/content/dam/commerce/<sub-folder>/..<filename>
commerce:positions
Placering/ordning för resursen i produktgallerier
Flera numeriska värden avgränsade med pipe ("Number: multi")
commerce:isCommerce
Flagga som anger om resursen används i e-handeln
Yes
commerce:skus
SKU:er för den här resursen
Flera strängvärden avgränsade med pipe (String: multi)
commerce:roles
Roller eller typer av bilder för resursen (till exempel thumbnail, main image, swatch)
Flera värden avgränsade med semikolon (t.ex."miniatyrbild; bild; färgrutebild; liten_bild")
CSV-kod

Använd det här exemplet på CSV-kod för att skapa filen i en kodredigerare eller ett kalkylbladsprogram som Microsoft Excel.

code language-csv 
assetPath,commerce:positions{{Number: multi}},commerce:isCommerce{{String}},commerce:skus{{String: multi}},commerce:roles{{String: multi}}
/content/dam/commerce/sample1.jpg,1,Yes,sku1,thumbnail; image; swatch_image; small_image
/content/dam/commerce/sample2.jpg,1|1|1,Yes,sku1|sku2|sku3,thumbnail; image; swatch_image; small_image|image|image; small_change

Steg 3: Importera Assets satsvis till AEM Assets

När du har skapat metadatamappningsfilen kan du använda verktyget för massimport i AEM Assets för att importera dina resurser.

Här följer en översikt på hög nivå över hur du använder verktyget.

  1. Logga in i AEM Assets as a Cloud Service-redigeringsmiljö.

  2. I Experience Manager-verktygsvyn väljer du Assets > Bulk Import.

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

  3. Välj Create i konfigurationerna för massimport för att öppna konfigurationsformuläret.

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

  4. Konfigurera och spara konfigurationen.

    Du behöver:

    • Autentiseringsuppgifter för datakällan
    • Målmappen i AEM Assets där importerade filer lagras
    • Valfritt. Information om MIME-typer, filstorlek och andra parametrar för att anpassa importkonfigurationen
    • Sökvägen till CSV-filen för metadatamappning som du överförde till molnlagringsinstansen.

    Mer information finns i Konfigurera verktyget Massimport i AEM Assets as a Cloud Service-användarhandboken.

  5. När du har sparat konfigurationen använder du verktygen för massimport för att testa och köra importåtgärden.

Related Articles
Videodemo om verktyget Importera satsvis
Tips, bästa praxis och begränsningar
Överför eller importera resurser med API:er ​
recommendation-more-help
8c823fd5-5db1-44f8-b0b7-6cafdbd7aefa