Importare dati
I dati per tutti i tipi di prodotto possono essere importati nello store. Inoltre, puoi importare prodotti, dati sui prezzi avanzati, dati sui clienti, dati sull’indirizzo del cliente e immagini dei prodotti. L'importazione supporta le operazioni seguenti:
- Aggiungi/aggiorna
- Sostituisci
- Elimina
Linee guida per l’importazione
Nuove entità
- Le entità vengono aggiunte con i valori attributo specificati nel file CSV.
- Per un attributo obbligatorio senza valore predefinito impostato, l’entità (la riga o le righe corrispondenti) non può essere importata se non è presente alcun valore o se non è valido.
- Per un attributo obbligatorio con un set di valori predefinito, viene importata l’entità (la riga o le righe corrispondenti) e viene impostato il valore predefinito per l’attributo, se non è presente alcun valore o un valore non valido.
- Se i dati complessi non sono validi, l’entità (la riga o le righe corrispondenti) non può essere importata.
Entità esistenti
- Per gli attributi che non sono dati complessi, i valori del file di importazione, inclusi i valori vuoti per gli attributi non obbligatori, sostituiscono i valori esistenti.
- Se per un attributo obbligatorio non è presente alcun valore o è presente un valore non valido, il valore esistente non viene sostituito.
- Se i dati complessi per l'entità non sono validi, l'entità (la riga o le righe corrispondenti) non può essere importata, ad eccezione del caso in cui è stata selezionata l'opzione Elimina entità nel menu a discesa Comportamento importazione.
Dati complessi
Se un attributo specificato nel file di importazione esiste e il relativo valore deriva da un insieme di valori definito, si applica quanto segue:
- Se il valore non è già incluso nel set di valori definito, è possibile importare la riga e impostare un valore predefinito per l'attributo.
- Se il valore è già incluso nel set definito, la riga corrispondente non può essere importata.
- Se il file di importazione specifica un nome di attributo non ancora definito nel sistema, non viene creato e i relativi valori non vengono importati.
File non validi
- Impossibile importare un file se tutte le righe non sono valide.
- Nel file di importazione è specificato un nome di dati complesso o di dati di servizio non esistenti, ad esempio una colonna con un'intestazione
_<non-existing name>.
Il processo di importazione di Adobe Commerce potrebbe non riconoscere correttamente i file codificati in UTF-8 che utilizzano un Byte Order Mark (BOM). I file contenenti una distinta base possono causare problemi o errori durante il processo di importazione.
Operazioni di importazione
sku.Le nuove classi di imposta specificate nei dati di importazione vengono create automaticamente.
Le nuove categorie di prodotti specificate nel file di importazione vengono create automaticamente.
I nuovi SKU specificati nel file di importazione vengono creati automaticamente
Nota: Per i prodotti, è possibile aggiornare tutti i campi eccetto SKU tramite l'importazione.
Importante: Non è possibile rimuovere più valori di campo, ad esempio siti Web o categorie, utilizzando il comportamento di importazione Aggiungi/Aggiorna. Questi campi rimangono nel database dopo l’importazione se non sono elencati nel file CSV.
Importante: prestare attenzione durante la sostituzione dei dati perché i dati del prodotto esistenti vengono cancellati e tutti i riferimenti nel sistema vengono persi.
Se uno SKU nei dati di importazione corrisponde allo SKU di un'entità esistente, tutti i campi, incluso lo SKU, vengono eliminati e viene creato un nuovo record utilizzando i dati CSV. Si verifica un errore se il file CSV fa riferimento a uno SKU che non esiste nel database. È possibile controllare i dati per visualizzare l'errore.
L'eliminazione ignora tutte le colonne nei dati di importazione, ad eccezione dello SKU. È possibile ignorare tutti gli altri attributi nei dati.
Si verifica un errore se il file CSV fa riferimento a uno SKU che non esiste nel database. È possibile controllare i dati per visualizzare l'errore.
Processo di importazione
La dimensione del file di importazione è determinata dalle impostazioni nel file php.ini sul server. Il messaggio di sistema nella pagina Importa indica il limite di dimensioni corrente. La dimensione predefinita è 2 MB.
I caratteri speciali (come il segno di uguale, i simboli maggiore e minore di, le virgolette singole e doppie, la barra rovesciata, la barra verticale e i simboli della e commerciale) possono causare problemi durante il trasferimento dei dati. Per garantire la corretta interpretazione di tali caratteri speciali, è possibile contrassegnarli come sequenza di escape. Se ad esempio i dati includono una stringa di testo come code="str", code="str2", la scelta di racchiudere il testo tra virgolette garantisce che le virgolette doppie originali siano considerate parte dei dati. Quando il sistema rileva una doppia serie di virgolette doppie, è possibile comprendere che il set esterno di virgolette doppie racchiude i dati effettivi.
Durante l’importazione dei dati di prodotto, i nuovi dati di prodotto vengono aggiunti alle voci di dati di prodotto esistenti nel database. Tutti i campi ad eccezione di SKU possono essere aggiornati tramite l’importazione. Tutti i dati di prodotto esistenti vengono sostituiti con i nuovi dati importati. Presta attenzione durante la sostituzione dei dati. Tutti i dati di prodotto esistenti vengono cancellati e tutti i riferimenti nel sistema vengono persi.
Passaggio 1: preparare i dati
-
Nella barra laterale Admin, passa a System > Data Transfer>Import.
-
In Impostazioni importazione, impostare Entity Type su una delle opzioni seguenti:
Advanced PricingProductsCustomer FinancesCustomers and AddressesCustomers Main FileCustomer AddressesStock Sources
-
Fare clic su Download Sample File.
-
Individua il file di esportazione nel percorso di download per il browser Web e apri il file.
Il file di esempio include intestazioni di colonna con dati segnaposto per i tipi di prodotto.
-
Esamina la struttura del file di esempio e utilizzala per preparare il file di importazione CSV, assicurandoti che le intestazioni delle colonne siano digitate correttamente.
-
Verifica che la dimensione del file di importazione non superi il limite mostrato nel messaggio.
-
Se i dati di importazione includono percorsi di immagini di prodotto, accertati che i file di immagine siano stati caricati nella posizione appropriata.
Il percorso predefinito nel server Commerce è:
pub/media/import.Se le immagini risiedono su un server esterno, assicurati di disporre dell’URL completo della directory che le contiene.
Passaggio 2: scegliere il comportamento di importazione
-
Imposta Import Behavior su uno dei seguenti:
Add/Update(per i prodotti, è possibile aggiornare tutti i campi eccetto SKU tramite l'importazione).ReplaceDelete
-
Per determinare cosa accade quando si verifica un errore durante l'importazione dei dati, scegliere una delle opzioni seguenti:
Stop on ErrorSkip error entries
-
Per Allowed Errors Count, immettere il numero di errori che possono verificarsi prima dell'annullamento dell'importazione.
Il valore predefinito è 10.
-
Accettare il valore predefinito di una virgola (
,) per Field separator. -
Accettare il valore predefinito di una virgola (
,) per Multiple value separator.In un file CSV, il separatore predefinito è una virgola. Per utilizzare un carattere diverso, accertati che i dati nel file CSV corrispondano al carattere specificato.
-
Accettare il valore predefinito
_EMPTY_VALUE_per Empty attribute value constant. -
Se si desidera racchiudere i caratteri speciali eventualmente presenti nei dati come sequenza di escape, selezionare la casella di controllo Fields Enclosure.
Passaggio 3: identificare il file di importazione
-
Fare clic su Choose File per selezionare il file da importare.
-
Trovare il file CSV che si è preparati a importare e fare clic su Open.
-
Per Images File Directory, immettere il percorso relativo della posizione sul server Commerce in cui sono archiviate le immagini caricate.
Esempio:
product_images.note note NOTE A partire dalla versione di Adobe Commerce e dal Magento Open Source 2.3.2, il percorso specificato in Images File Directory concatena l'importazione nella directory base delle immagini:<Magento-root-folder>/var/import/images. Inserire ad esempio i fileproduct_imagesnella cartella<Magento-root-directory>/var/import/images/product_images. La directory base delle immagini di importazione può essere configurata nel file\Magento\ImportExport\etc\config.xml. Se il modulo di archiviazione remota è abilitato, importare i file nella cartella<remote-storage-root-directory>/var/import/images/product_images.Per ulteriori informazioni sull'importazione di immagini prodotto, vedere Importare immagini prodotto.
Passaggio 4: controllare i dati di importazione
-
Nell'angolo superiore destro fare clic su Check Data.
-
Attendere alcuni istanti per il completamento del processo di convalida.
Se i dati di importazione sono validi, viene visualizzato il seguente messaggio:
-
Se il file è valido, scegliere Import.
In caso contrario, correggere ogni problema relativo ai dati elencati nel messaggio e riprovare a importare il file.
-
Il processo di importazione continua fino alla fine dei dati, a meno che non si verifichi un errore.
Se nei risultati della convalida viene visualizzato un messaggio di errore, correggere il problema nei dati e importare nuovamente il file.
Al termine dell’importazione viene visualizzato un messaggio.
Cronologia importazione
Commerce mantiene un record dei dati importati nell’archivio, inclusi la data e l’ora di inizio, l’utente, l’ora di esecuzione e un collegamento al file importato. Il Tempo di esecuzione è la durata del processo di importazione.
Per visualizzare la cronologia di importazione:
Nella barra laterale Admin, passa a System > Data Transfer>Import History.
<Magento-root-directory>/var/import_history. Se il modulo di archiviazione remota è abilitato, i file di cronologia di importazione si trovano nella cartella <remote-storage-root-directory>/import_export/import_history.Per scaricare il file Imported/Error, scegliere Download.