Documentazione Commerce Guida all'integrazione di AEM Assets

Migrare i file multimediali a AEM Assets DAM

Last update: Thu Dec 18 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Argomenti:
CMS
Media

Creato per:

Utente

Sia Adobe Commerce che Adobe Experience Manager (AEM) forniscono funzionalità integrate per semplificare la migrazione di file multimediali da Commerce a AEM Assets Digital Asset Management System (DAM). È inoltre possibile eseguire la migrazione di file multimediali da altre origini.

Prerequisiti

Categoria

Requisito

Requisiti di sistema

Ambiente AEM as a Cloud Service fornito con AEM Assets
Capacità di stoccaggio sufficiente
Larghezza di banda di rete per trasferimenti di file di grandi dimensioni

Accesso e autorizzazioni richiesti

Accesso amministratore ad AEM Assets as a Cloud Service
Accesso al sistema di origine in cui sono archiviati i file multimediali (Adobe Commerce o sistema esterno)
Autorizzazioni appropriate per accedere ai servizi di archiviazione cloud

Account archiviazione cloud

Account di archiviazione AWS S3 o Azure Blob
Configurazione contenitore/bucket privato
Credenziali di autenticazione

Contenuto Source

File multimediali organizzati pronti per la migrazione
File immagine e video nei formati supportati da AEM Assets.
Risorse pulite e duplicate

Preparazione metadati

Profilo metadati AEM Assets configurato per le risorse Commerce
Valori metadati mappati per ogni risorsa
Editor file CSV (ad esempio, Microsoft Excel)

Best practice per la migrazione

Cura le risorse prima della migrazione rimuovendo il contenuto inutilizzato e duplicato.
Organizza le risorse in modo logico per dimensione, formato o caso d’uso.
È consigliabile suddividere le migrazioni di grandi dimensioni in batch più piccoli.
Pianificare le importazioni ad alta intensità di risorse durante le ore di minore utilizzo.
Convalida la mappatura dei metadati prima dell’importazione completa.

Flusso di lavoro di migrazione

Segui il flusso di lavoro di migrazione per esportare i file multimediali da Adobe Commerce o da un altro sistema esterno e importarli in AEM Assets DAM.

Passaggio 1: esportare il contenuto dall'origine dati esistente

[Solo PaaS]{class="badge informative" title="Applicabile solo ai progetti Adobe Commerce on Cloud (infrastruttura PaaS gestita da Adobe)."}

Per i commercianti Adobe Commerce, il modulo di archiviazione remota può facilitare le importazioni e le esportazioni di file multimediali. Questo modulo consente alle aziende di archiviare e gestire i file multimediali utilizzando servizi di archiviazione remota come AWS S3. Per configurare l'archiviazione remota per l'istanza di Commerce, vedere Configurare l'archiviazione remota nella Guida alla configurazione di Commerce.

Se hai file multimediali archiviati all'esterno di Adobe Commerce, caricali direttamente in una delle origini dati supportate da AEM as a Cloud Service.

Passaggio 2: creare un file CSV per la mappatura dei metadati

Dopo aver esportato i file multimediali, crea un file CSV per mappare queste risorse con i metadati necessari per l’automazione. Il file CSV deve includere campi per product, position e role mapping, garantendo l'allineamento con il profilo metadati AEM Assets.

Per ogni file multimediale di cui si prevede la migrazione, fornire i valori per i campi di metadati inclusi nel profilo di metadati AEM Assets per le risorse Commerce come descritto nella tabella seguente.

Metadati

Descrizione

Valore

assetPath

Percorso completo in cui la risorsa verrà memorizzata nell’archivio AEM Assets.

Utilizzare il percorso per creare sottocartelle per organizzare le risorse di Commerce, ad esempio content/dam/commerce/<brand>/<type>.

/content/dam/commerce/<sub-folder>/..<filename>

commerce:positions

Posizione/ordine della risorsa nelle gallerie di prodotti

Valori numerici multipli separati da barre verticali ("Number: multi")

commerce:isCommerce

Flag che indica se la risorsa è utilizzata in Commerce

Yes

commerce:skus

SKU di prodotto associati a questa risorsa

Più valori stringa separati da barre verticali (Stringa: multipli)

commerce:roles

I ruoli o i tipi di immagini per la risorsa (ad esempio, thumbnail, main image, swatch)

Più valori separati da punto e virgola (ad esempio, "miniatura; immagine; swatch_image; small_image")

Codice CSV

Utilizza questo codice CSV di esempio per creare il file in un editor di codice o in un’applicazione per fogli di calcolo come Microsoft Excel.

code language-csv

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`

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

Passaggio 3: importare in blocco Assets in AEM Assets

Dopo aver creato il file di mappatura dei metadati, utilizza lo strumento AEM Assets Bulk Import per importare le risorse.

Di seguito è riportata una panoramica generale sull'utilizzo dello strumento.

Accedi all'ambiente di authoring AEM Assets as a Cloud Service.
Dalla vista Strumenti di Experience Manager, seleziona Assets > Bulk Import.

{width="600" modal="regular"}
In Configurazioni di importazione in blocco, selezionare Create per aprire il modulo di configurazione.

{width="600" modal="regular"}
Imposta e salva la configurazione.

Sono necessari:
- Credenziali di autenticazione per l’origine dati
- Cartella di destinazione in AEM Assets in cui verranno archiviati i file importati
- Facoltativo. Informazioni sui tipi MIME, le dimensioni del file e altri parametri per personalizzare la configurazione di importazione
- Percorso del file CSV di mappatura metadati caricato nell’istanza di archiviazione Cloud.
Per i passaggi dettagliati, consulta Configurare lo strumento Importazione in blocco nella Guida utente di AEM Assets as a Cloud Service.
Dopo aver salvato la configurazione, utilizzare gli strumenti di importazione in blocco per testare ed eseguire l'operazione di importazione.

recommendation-more-help

a946a0ea-3a16-4ab1-9bea-af7261643345