DocumentatieCommerceAEM Assets integratiehandleiding

Mediabestanden migreren naar de AEM Assets DAM

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

Gemaakt voor:

  • Gebruiker

Zowel Adobe Commerce als Adobe Experience Manager (AEM) verstrekken ingebouwde eigenschappen om media dossiermigratie van Commerce aan het AEM Assets digitale systeem van het activabeheer (DAM) te stroomlijnen. U kunt ook mediabestanden migreren uit andere bronnen.

Vereisten

Categorie
Vereiste
vereisten van het Systeem
  • AEM as a Cloud Service-omgeving voorzien van AEM Assets
  • Voldoende opslagcapaciteit
  • Netwerkbandbreedte voor grote bestandsoverdrachten
Vereiste toegang en toestemmingen
  • Toegang tot AEM Assets as a Cloud Service voor beheerders
  • Toegang tot het bronsysteem waar mediabestanden worden opgeslagen (Adobe Commerce of extern systeem)
  • Geschikte machtigingen voor toegang tot cloudopslagservices
de Rekening van de Opslag van de Wolk
  • AWS S3- of Azure Blob Storage-account
  • Configuratie van privécontainer/emmertje
  • Verificatiegegevens
Inhoud Source
  • Georganiseerde mediabestanden gereed voor migratie
  • Beeld en videodossiers in formaten die door AEM Assetsworden gesteund.
  • Schone, gedupliceerde elementen
Voorbereiding van meta-gegevens

Best practices voor migratie

  1. Elementen krullen vóór de migratie door ongebruikte en gedupliceerde inhoud te verwijderen.

  2. Elementen logisch ordenen op grootte, opmaak of hoofdlettergebruik.

  3. Overweeg grote migraties in kleinere batches te splitsen.

  4. Plan de bronintensieve invoer tijdens off-piekuren.

  5. Metagegevenstoewijzing valideren voordat de bestanden volledig worden geïmporteerd.

Migratieworkflow

Volg de migratieworkflow om mediabestanden uit Adobe Commerce of een ander extern systeem te exporteren en deze te importeren in AEM Assets DAM.

Stap 1: Inhoud exporteren uit de bestaande gegevensbron

[​ slechts PaaS ​]{class="badge informative" title="Alleen van toepassing op Adobe Commerce op Cloud-projecten (door Adobe beheerde PaaS-infrastructuur)."}

Voor de handelaren van Adobe Commerce, kan de Verre module van de Opslag de invoer en de uitvoer van media dossier vergemakkelijken. Met deze module kunnen bedrijven mediabestanden opslaan en beheren met externe opslagservices zoals AWS S3. Aan opstellings verre opslag voor uw instantie van Commerce, zie ​ Verre Opslag ​ in de Gids van de Configuratie van Commerce vormen.

Als u media dossiers hebt die buiten Adobe Commerce worden opgeslagen, upload hen rechtstreeks aan één van de ​ gegevensbronnen ​ door AEM as a Cloud Service worden gesteund.

Stap 2: Een CSV-bestand maken voor de toewijzing van metagegevens

Maak een CSV-bestand waarmee elk mediabestand wordt toegewezen aan de Commerce-productgegevens. Kies een van de volgende methoden:

  • Adobe Commerce (PaaS): Gebruik het CLI bevel om CSV van uw catalogus auto-te produceren
  • Handmatig het CSV-bestand maken

Metagegevens exporteren met CLI

[​ slechts PaaS ​]{class="badge informative" title="Alleen van toepassing op Adobe Commerce op Cloud-projecten (door Adobe beheerde PaaS-infrastructuur)."}

Met de CLI-opdracht AEM Assets Integration kunt u automatisch een CSV-bestand met metagegevens genereren dat URL's, posities en rollen van de productmediabestanden bevat die in uw Commerce-project zijn opgeslagen.

  1. Beschikbare opdrachten weergeven om te controleren of de AEM Assets Integration-module is geïnstalleerd:

    code language-bash 
    bin/magento list aem

    De opdrachten voor aangepaste extensies worden onder aem weergegeven aan het begin van de opdrachtlijst.

  2. Voer de opdracht voor het exporteren van metagegevens uit met het voorvoegsel van het AEM-pad:

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

    <AEM-path-prefix> is het pad naar de basismap waarin uw elementen worden opgeslagen in AEM Assets DAM (bijvoorbeeld /content/dam/commerce/ ).

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

    Hiermee maakt u een metadata.csv -bestand in de map var/export met URL's, posities en rollen voor elk productelement in de Commerce-catalogus.

De CSV handmatig maken

Voor mediabestanden die buiten Adobe Commerce zijn opgeslagen, maakt u het CSV-bestand handmatig. De kolomkopballen moeten de gebiedsnamen aanpassen die in uw ​ worden gevormd de meta-gegevensprofiel van AEM Assets ​. Nadat u het bestand hebt gemaakt, vult u de rijen met de metagegevenswaarden voor elk mediabestand in.

Metagegevens
Beschrijving
Waarde
assetPath
Het volledige pad waar het middel wordt opgeslagen in de AEM Assets-opslagplaats.

gebruik de weg om subomslagen tot stand te brengen om de activa van Commerce te organiseren, bijvoorbeeld content/dam/commerce/<brand>/<type>.
/content/dam/commerce/<sub-folder>/..<filename>
commerce :positions
De positie/volgorde van het element in productgalerieën
Meerdere numerieke waarden, gescheiden door pipe ("Number: multi")
commerce :isCommerce
Markering die aangeeft of het actief in de handel wordt gebruikt
Yes
commerce :skus
Product-SKU's die aan dit element zijn gekoppeld
Meerdere tekenreekswaarden, gescheiden door pipe (String: multi)
commerce :roles
De rollen of typen afbeeldingen voor het element (bijvoorbeeld thumbnail , main image , swatch )
Meerdere waarden, gescheiden door puntkomma's (bijvoorbeeld "miniatuur; afbeelding; staal_afbeelding; small_image")
CSV-code

Gebruik deze CSV-voorbeeldcode om het bestand te maken in een code-editor of spreadsheettoepassing zoals 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

Stap 3: Bulkimport van Assets naar AEM Assets

Nadat u het metagegevenstoewijzingsbestand hebt gemaakt, importeert u uw elementen met het gereedschap AEM Assets Bulk importeren.

Hieronder vindt u een overzicht op hoog niveau voor het gebruik van het gereedschap.

  1. ​ Login aan uw het auteursmilieu van AEM Assets as a Cloud Service ​.

  2. Selecteer in de weergave Experience Manager Tools Assets > Bulk Import .

    ​ AEM Assets authoring ​ {width="600" modal="regular"}

  3. Selecteer in het venster Configuraties voor bulkimport de optie Create om het configuratieformulier te openen.

    ​ AEM Assets authoring ​ {width="600" modal="regular"}

  4. Opstelling en sparen de configuratie.

    U hebt het volgende nodig:

    • Verificatiereferenties voor uw gegevensbron
    • De doelmap in AEM Assets waarin geïmporteerde bestanden worden opgeslagen
    • Optioneel. Informatie over de MIME-typen, bestandsgrootte en andere parameters om de importconfiguratie aan te passen
    • Het pad naar het CSV-bestand met metagegevenstoewijzing dat u hebt geüpload naar de opslaginstantie in de cloud.

    Voor gedetailleerde stappen, zie ​ het Bulk hulpmiddel van de Invoer ​ in de Gids van de Gebruiker van AEM Assets as a Cloud Service vormen.

  5. Nadat u de configuratie hebt opgeslagen, gebruikt u de gereedschappen voor bulkimport om de importbewerking te testen en uit te voeren.

Related Articles
​ Bulk het hulpmiddel van de Invoer videodemo ​
Tips, beste praktijken, en beperkingen ​
Elementen uploaden of invoegen met behulp van API's ​
recommendation-more-help
9c0cde36-aee3-4e49-8ba1-e9342e3cf211