Come utilizzare l'Importatore – Brownie

Uno strumento che può tornare è l’Importatore, raggiungibile da Strumenti > Importatore dal Back End di Brownie.

Questa è un’interfaccia per creare delle regole di import mappando file excel, da utilizzare anche più volte per aggiornare prodotti, giacenze, listini prezzo o altro. Nella vista lista abbiamo l’elenco delle importazioni già salvate.
Ogni importazione può avere i seguenti stati:

In attesa dell'avvio del processo: Importazione salvata ma mai eseguita;
In corso: L’importazione sta girando;
Completata: L’importazione ha girato con successo, senza errori gravi;
Completata con errori: l’importazione ha girato con successo, ma si sono verificati uno o più errori che potrebbero averne danneggiato i risultati;
Fallita: l’importazione ha incontrato qualche errore fatale che l’ha interrotta;
Out of memory: l’importazione è fallita perché troppo pesante da gestire, da rifare suddividendo il file da importare in più file più piccoli;

Lo stato dell’importazione è visibile nella lista nell’apposita colonna, così come il numero di righe importate rispetto al totale (in caso di importazione “In corso”).

La toolbar della vista lista presenta solo le azioni “Nuovo” ed “Elimina”.

Le interfacce di creazione e di editing di un’importazione, a differenza di quasi tutto il CMS, sono differenti, quindi le analizzeremo separatamente.

Iniziamo da quella di creazione di un’importazione, raggiungibile cliccando sull’apposito pulsante nella toolbar "nuovo".

Nella sezione titolo va inserito il titolo che verrà dato alla nuova importazione, puramente autoreferenziale per il cms e per inserirlo nella lista.

La prima cosa da fare qui è scegliere l’oggetto da importare:

Le opzioni sono:

Articoli;
Prodotti: Vengono importati i prodotti senza anagrafica, quindi senza le relative varianti (taglia, colore, etc). Questo strumento è utile quando abbiamo già un'importazione ma dobbiamo crearne un'altra per aggiungere altre informazioni.
Varianti: Vengono importati i prodotti con la relativa anagrafica, quindi le varianti.
Giacenza: Per importare solo le quantità di singole varianti;
Indirizzi;
Listini prezzo;

Una volta scelto l’oggetto da voler importare, carichiamo il file in formato excel dalla barra "file da importare", cliccando su "sfoglia".

Una volta importato il file, da "Opzioni" è presente un menù a tendina "Mostra":

Questa casella permette di ignorare la prima riga del file importato, generalmente quella che contiene titolo, descrizione, SKU, e non sono utili all'importazione. Per non includerla nell'importazione bisognerà inserire il numero 1.

Sotto questi due campi vediamo invece la componente più importante, ovvero l’area di mappatura file. E' possibile scegliere una mappatura già utilizzata selezionando il menù a tendina "Utilizza mappatura salvata" oppure salvare la mappatura che stiamo creando da "Salva mappatura corrente".

La prima cosa che abbiamo fatto fare è stato scegliere l’oggetto da importare in quanto i valori delle select “Mappa su” dipendono dall’oggetto scelto, e non sono modificabili una volta caricato il file.

Il valore di default di ogni select è “Ignora”, che farà sì che la colonna sarà ignorata in fase di importazione. Per importare quella determinata colonna bisognerà scegliere uno dei parametri disponibili sulla quale mapparla (un’importazione valida contiene almeno una colonna mappata).

Una volta mappate tutte le colonne potremo salvare, verremo quindi reindirizzati alla vista dettaglio dell’importazione così salvata.

Se il server supporta le chiamate asincrone vedremo l’importazione già girare, altrimenti dovremo lanciarla noi con l’apposito pulsante “Importa” in alto a destra.