Siti Ecommerce
Scarica il PDF
Risultati ricerca
Indice
Frase completa
Cerca nella pagina
Chiudi
Indice

IMPORTAZIONE / ESPORTAZIONE DEI DATI ARTICOLO TRAMITE FILE

Tipicamente in un sito Ecommerce collegato con un gestionale Passepartout i dati relativi agli articoli gestiti vengono prelevati automaticamente, alla sincronizzazione, dal gestionale stesso.

Considerando però che Passweb offre la possibilità di estendere queste informazioni mediante la creazione di appositi Attributi Articolo potrebbe essere particolarmente utile importare / esportare queste informazioni in blocco mediante l’upload / download di un apposito file.

In questo senso dunque il pulsante Importa ( ) presente nella barra degli strumenti della maschera “Gestione Articoli” consente di caricare in maniera massiva i dati gestiti da Passweb relativamente agli articoli attualmente presenti all’interno del sito.

Cliccando su questo pulsante verrà quindi visualizzata la maschera “File Dati Articolo” mediante la quale poter effettuare l’upload del file contenente le informazioni desiderate.

Nello specifico all’interno di questa sezione sarà necessario indicare:

  • File (csv-txt): consente di selezionare il file txt o csv da uplodare e contenente i dati da associare ai vari articoli gestiti all’interno del sito
  • Lingua: consente di indicare la lingua del sito a cui dovranno fare riferimento i dati presenti all’interno del file di importazione
  • Separatore: consente di indicare, selezionandolo, dall’apposito menu a tendina, il carattere che è stato utilizzato all’interno del file di importazione come separatore per i vari campi

Affinchè la procedura di import possa funzionare in maniera corretta e i dati contenuti nel file possano essere associati ai relativi articoli, dovranno essere rispettate delle regole ben precise. Nello specifico

  • Prima di avviare la procedura di import dovranno già essere stati creati all’interno di Passweb, tutti gli attributi articolo da valorizzare attraverso questa procedura.
  • Il file da importare deve avere estensione .csv o .txt
  • Il carattere separatore dei vari campi deve essere esattamente quello indicato all’interno del campo “Separatore” presente nel form di importazione.
  • L’intestazione, ossia la prima riga del file, deve necessariamente contenere l’elenco dei nomi dei campi articolo che dovranno poi essere valorizzati con i dati presenti all’interno del file stesso. Il nome dei campi non è case sensitive

Supponendo di aver scelto come carattere separatore il TAB, l’intestazione del file dovrà avere una struttura del tipo

NOME CAMPO1 (TAB) NOME CAMPO2 (TAB) ….. (TAB) NOME CAMPON

Allo stesso modo le righe dei dati dovranno avere una struttura del tipo

VALORE1 (TAB) VALORE2(TAB) …. (TAB) VALOREN

  • Il primo campo del file dovrà essere obbligatoriamente il Codice dell’Articolo. La presenza di questo campo è ovviamente indispensabile in quanto è quella che assicurerà poi l’associazione dei dati ai relativi articoli.

NOTA BENE: se all’interno del file da importare non è presente il CODICE ARTICOLO e/o se i codici inseriti all’interno di questo campo non coincidono con quelli degli articoli effettivamente presenti all’interno del sito la procedura di import non valorizzerà, ovviamente, alcun campo dati

E’ possibile utilizzare all’interno del codice articolo il carattere jolly ? in maniera tale da poter associare i dati presenti all’interno di una stessa riga a più articoli contemporaneamente.

Utilizzando ad esempio il codice articolo “AGLIANIC???” i dati presenti nel file in corrispondenza di questa riga verranno associati a tutti gli articoli presenti all’interno del sito che hanno un codice lungo 11 caratteri e che iniziano con la strina “AGLIANIC”

  • Il file di importazione deve soddisfare le specifiche del formato RFC4180.

ATTENZIONE! In questo senso è quindi necessario che il valore dei campi contenenti interruzioni di riga, e/o lo stesso carattere utilizzato anche come separatore sia necessariamente racchiuso da virgolette.

Inoltre nel caso in cui il valore di un campo abbia al suo interno elementi racchiusi da doppi apici (come potrebbe ad esempio avvenire nel caso di codice HTML) sarà necessario racchiudere tra virgolette oltre all’intero campo anche questi stessi elementi.

Supponendo, ad esempio, di aver scelto come carattere separatore il ; e di voler importare un file csv con i soli campi CODICE e DESCRIZIONE, potrebbero configurarsi le seguenti casistiche:

1 – Il campo DESCRIZIONE non contiene il carattere ; il valore di questo campo NON dovrà essere racchiuso da virgolette

ART01;Descrizione ART01

2 – Il campo DESCRIZIONE contiene il carattere ; il valore di questo campo dovrà essere racchiuso da virgolette

ART01;“Descrizione ART01 contenente un ; che deve essere gestito

3 – Il campo DESCRIZONE contiene dei doppi apici sarà necessario racchiudere tra virgolette sia l’intero campo che l’elemento presente al suo interno e racchiuso da doppi apici

ART01;“il campo descrizione contiene ““doppi apici”” che devono essere gestiti

4 – Il campo DESCRIZONE contiene un new line (ritorno a capo) il valore di questo campo dovrà essere racchiuso da virgolette

ART01;il campo descrizione contiene un

new line che deve essere gestito

ATTENZIONE! Eventuali descrizioni degli articoli non devono essere necessariamente allineate tutte su una riga, possono essere utilizzati dei new line (ritorno a capo) facendo però attenzione a racchiudere il valore di questi campi da doppi apici

  • E’ necessario creare file distinti per le diverse lingue gestite all’interno del sito. In fase di importazione sarà poi possibile, come visto, indicare la specifica lingua cui il file fa riferimento.
  • Oltre al campo CODICE, gli ulteriori campi articolo gestiti, e che potranno quindi essere valorizzati in maniera massiva attraverso questa procedura, sono i seguenti (viene indicato il nome del campo da inserire nella riga di intestazione del file e il tipo di valore da utilizzare nei vari record del file stesso):

SITI ECOMMERCE COLLEGATI A MEXAL

    • titolo (valore testuale) – solo nel caso in cui si sia scelto gestire il titolo (ed eventualmente il permalink) delle pagine prodotto utilizzando come tipo di dato l’opzione “Passweb”.
    • categoriaMerceologica (valore testuale) – consente di associare al relativo articolo una o più Categorie Merceologiche secondarie

Per maggiori informazioni in merito all’associazione, lato Passweb, di più categorie merceologiche allo stesso articolo si veda anche la successiva sezione “Associazione di un articolo a più categorie merceologiche” di questo manuale.

ATTENZIONE! i valori relativi a questo campo, e che verranno poi inserti nei vari record del file, dovranno coincidere con i codici delle Categorie Merceologiche effettivamente gestite all’interno del sito. Inoltre nel momento in cui un articolo dovesse essere associato a due o più categorie merceologiche secondarie, i codici di tali categorie dovranno essere separati da punto e virgola ;

Considerando quanto precedentemente indicato relativamente alle specifiche di costruzione del file, nel momento in cui si dovesse decidere di utilizzare il carattere ; come separatore di campi e si volessero associare massivamente più categorie merceologiche ad un determinato articolo i codici di tali categorie oltre ad essere separati da ; dovranno anche essere racchiusi da doppi apici come nell’esempio di seguito riportato.

Es. “codiceCategoria1;codiceCategoria2; … codiceCategoriaN”

    • descrizione (valore testuale)
    • descrizioneDettagliata (valore testuale)
    • descrizioneHtml (valore testuale )
    • descrizioneHtml2 (valore testuale )
    • descrizioneHtml3 (valore testuale )
    • scortaMinima – consente di impostare per il relativo articolo il valore della sua “Scorta Minima”
    • sogliaDisponibilita – consente di impostare per il relativo articolo il valore della sua “Soglia Disponibilità”
    • dispDba – da considerarsi solo per articoli di tipo DBA – Consente di specificare come dovrà essere gestito il calcolo della disponibilità per il corrispondente articolo di tipo DBA. Può assumere i seguenti valori:
    • Dba – consente di calcolare la disponibilità del prodotto basandosi sui progressivi dell’articolo stesso
    • Componenti – consente di calcolare la disponibilità del prodotto facendo riferimento alle disponibilità dei singoli componenti
  • qtaConfezioneType: consente di specificare come dovrà essere venduto l’articolo nel caso in cui ad effettuare l’ordine sia un utente di Privato e nel caso in cui l’articolo in esame sia un articolo gestito a Confezioni. Può assumere i seguenti valori:
    • Propositiva
    • Bloccata
    • BloccataAutomatica
    • Singola
  • qtaConfezioneTypeAziende: consente di specificare come dovrà essere venduto l’articolo nel caso in cui ad effettuare l’ordine sia un utente di tipo Azienda e nel caso in cui l’articolo in esame sia un articolo gestito a Confezioni. Può assumere i seguenti valori:
    • Propositiva
    • Bloccata
    • BloccataAutomatica
    • Singola
  • setOpzioni (valore testuale): consente di indicare il nome del set di opzioni di personalizzazione da associare all’articolo in esame
  • giftCard (valore testuale): consente di indicare il nome della Gift Card da associare all’articolo in esame
  • classiCustom (valore testuale): consente di indicare le classi CSS (separate l’una dall’altra da uno spazio) che dovranno essere assegnate poi all’articolo in esame
  • boxConfigurabile (valore testuale): consente di indicare se l’articolo esame è o meno un campionario configurabile. Sono ammessi i valori SI e NO. Nel momento in cui non dovesse essere valorizzato l’articolo si riterrà non configurabile.
  • maxComponenti (valore numerico): consente di indicare il numero massimo dei componenti del box. Nel momento in cui non dovesse essere valorizzato l’eventuale box configurabile non avrà alcun numero massimo di componenti
  • minComponenti (valore numerico): consente di indicare il numero minimo dei componenti del box. Nel momento in cui non dovesse essere valorizzato l’eventuale box configurabile non avrà alcun numero minimo di componenti
  • spedizione_width (valore numerico): consente di indicare la larghezza dell’articolo in esame (valore espresso in cm)
  • spedizione_height (valore numerico): consente di indicare l’altezza dell’articolo in esame (valore espresso in cm)
  • spedizione_depth (valore numerico): consente di indicare la profondità dell’articolo in esame (valore espresso in cm)
  • spedizione_weight (valore numerico): consente di indicare il peso dell’articolo in esame (valore espresso in kg)

ATTENZIONE! I campi utilizzati per gestire le dimensioni dell’articolo (spedizione_width, spedizione_ height, spedizione_ depth, spedizione_ weight ) verranno valutati in fase di importazione del file csv solo nel caso in cui non sia stata attivata in Mexal l’App “Invio documenti a Passdelivery

Nel caso in cui l’App in questione sia stata correttamente attivata, i campi Passweb saranno in sola lettura e le dimensioni degli articoli andranno impostate direttamente nel gestionale utilizzando i campi messi a disposizione da questa stessa App

    • metaKeywords (valore testuale )
    • metaDescription (valore testuale )
    • title (valore testuale)
    • nomi degli attributi di tipo Passweb (valore coerente con la tipologia di attributo considerato)
    • siteMap: booleano che può assumere i seguenti valori:
    • SI: include l’articolo nella sitemap
    • NO: esclude l’articolo dalla sitemap

Nel caso in cui non venga indicato nessun valore l’articolo in esame erediterà, per questo campo, quanto indicato nella sezione “Preferenze Sito”

    • sitemapChangefreq: testo che può assumere i seguenti valori:
    • always: sempre
    • hourly: oraria
    • daily: giornaliera
    • weekly: settimanale
    • monthly: mensile
    • yearly: annuale
    • never: mai

Nel caso in cui non venga indicato nessun valore l’articolo in esame erediterà, per questo campo, quanto indicato nella sezione “Preferenze Sito”

    • sitemapPriority: decimale che può assumere i seguenti valori:
    • 0,0
    • 0,1
    • 0,2
    • 0,3
    • 0,4
    • 0,5
    • 0,6
    • 0,7
    • 0,8
    • 0,9
    • 1,0

Nel caso in cui non venga indicato nessun valore l’articolo in esame erediterà, per questo campo, quanto indicato nella sezione “Preferenze Sito”

SITI ECOMMERCE COLLEGATI AD UN GESTIONALE HO.RE.CA.

    • titolo (valore testuale)
    • categoriaMerceologica (valore testuale) – consente di associare al relativo articoli una o più Categorie Merceologiche secondarie

Per maggiori informazioni in merito all’associazione, lato Passweb, di più categorie merceologiche allo stesso articolo si veda anche la successiva sezione “Associazione di un articolo a più categorie merceologiche” di questo manuale.

ATTENZIONE! i valori relativi a questo campo, e che verranno poi inserti nei vari record del file, dovranno coincidere con i codici delle Categorie Merceologiche effettivamente gestite all’interno del sito. Inoltre nel momento in cui un articolo dovesse essere associato a due o più categorie merceologiche secondarie, i codici di tali categorie dovranno essere separati da punto e virgola ;

Considerando quanto precedentemente indicato relativamente alle specifiche di costruzione del file, nel momento in cui si dovesse decidere di utilizzare il carattere ; come separatore di campi e si volessero associare massivamente più categorie merceologiche ad un determinato articolo i codici di tali categorie oltre ad essere separati da ; dovranno anche essere racchiusi da doppi apici come nell’esempio di seguito riportato.

Es. “codiceCategoria1;codiceCategoria2; … codiceCategoriaN”

    • descrizione (valore testuale)
    • descrizioneDettagliata (valore testuale)
    • descrizioneHtml (valore testuale)
    • descrizioneHtml2 (valore testuale)
    • DescrizioneHtml3 (valore testuale)
    • scortaMinima – consente di impostare per il relativo articolo il valore della sua “Scorta Minima”
    • sogliaDisponibilita – consente di impostare per il relativo articolo il valore della sua “Soglia Disponibilità”
    • setOpzioni (valore testuale): consente di indicare il nome del set di opzioni di personalizzazione da associare all’articolo in esame
    • giftCard (valore testuale): consente di indicare il nome della Gift Card da associare all’articolo in esame
    • classiCustom (valore testuale): consente di indicare le classi CSS (separate l’una dall’altra da uno spazio) che dovranno essere assegnate poi all’articolo in esame
    • boxConfigurabile (valore testuale): consente di indicare se l’articolo esame è o meno un campionario configurabile. Sono ammessi i valori SI e NO. Nel momento in cui non dovesse essere valorizzato l’articolo si riterrà non configurabile.
    • maxComponenti (valore numerico): consente di indicare il numero massimo dei componenti del box. Nel momento in cui non dovesse essere valorizzato l’eventuale box configurabile non avrà alcun numero massimo di componenti
    • minComponenti (valore numerico): consente di indicare il numero minimo dei componenti del box. Nel momento in cui non dovesse essere valorizzato l’eventuale box configurabile non avrà alcun numero minimo di componenti
    • spedizione_width (valore numerico): consente di indicare la larghezza dell’articolo in esame (valore espresso in cm)
    • spedizione_height (valore numerico): consente di indicare l’altezza dell’articolo in esame (valore espresso in cm)
    • spedizione_depth (valore numerico): consente di indicare la profondità dell’articolo in esame (valore espresso in cm)
    • spedizione_weight (valore numerico): consente di indicare il peso dell’articolo in esame (valore espresso in kg)
    • title (valore testuale)
    • metaKeywords (valore testuale)
    • metaDescription (valore testale)
    • siteMap: booleano che può assumere i seguenti valori:
    • SI: include l’articolo nella sitemap
    • NO: esclude l’articolo dalla sitemap

Nel caso in cui non venga indicato nessun valore l’articolo in esame erediterà, per questo campo, quanto indicato nella sezione “Preferenze Sito”

    • sitemapChangefreq: testo che può assumere i seguenti valori:
    • always: sempre
    • hourly: oraria
    • daily: giornaliera
    • weekly: settimanale
    • monthly: mensile
    • yearly: annuale
    • never: mai

Nel caso in cui non venga indicato nessun valore l’articolo in esame erediterà, per questo campo, quanto indicato nella sezione “Preferenze Sito”

    • sitemapPriority: decimale che può assumere i seguenti valori:
    • 0,0
    • 0,1
    • 0,2
    • 0,3
    • 0,4
    • 0,5
    • 0,6
    • 0,7
    • 0,8
    • 0,9
    • 1,0

Nel caso in cui non venga indicato nessun valore l’articolo in esame erediterà, per questo campo, quanto indicato nella sezione “Preferenze Sito”

    • pubblicato (SI o NO)
    • catalogo (SI o NO)
    • offerta (SI o NO): valido solo per versioni gestionali precedenti alla 2020E
    • novita (SI o NO) : valido solo per versioni gestionali precedenti alla 2020E
    • fineSerie (SI o NO) : valido solo per versioni gestionali precedenti alla 2020E

ATTENZIONE! i campi relativi ad Offerte / Novità / Fine Serie possono essere valorizzati in maniera massiva, mediante importazione di file csv, solo per versioni del gestionale precedenti alla 2020E. A partire da tale versione i campi in oggetto sono infatti gestiti direttamente sul gestionale e non potranno più essere variati operando direttamente da Passweb

    • decimali (valore numerico)
    • minimoVendibile (valore numerico)
    • massimoVendibile (valore numerico)
    • richiestaPrezzo (SI o NO)
    • unitaMisuraSecondaria (SI o NO)

ATTENZIONE! Nel caso in cui per l’articolo in esame non sia stata definita nessuna unità di misura secondaria, l’articolo sarà sempre gestito con l’unità di misura principale, indipendentemente da quanto impostato per questo campo

    • disponibilità (valore testuale)
    • misuratoreSpedizione (valore numerico)
    • lineeArticolo (elenco di codici separati da ;)

ATTENZIONE! Nel caso in cui il codice della linea articolo indicato nel file di importazione non esista, verrà automaticamente aggiunto all'elenco delle Linee Articolo codificate in Passweb

    • Nomi degli attributi di tipo Passweb

In particolare per quel che riguarda gli attributi di tipo Passweb è bene sottolineare che:

  • Per attributi gestiti con controlli a “Selezione multipla” i diversi valori da associare all’attributo dovranno essere separati da virgole.

ATTENZIONE! Nel caso in cui si sia scelto di utilizzare la virgola come carattere separatore il contenuto di campi utilizzati per valorizzare attributi a selezione multipla dovrà essere racchiuso da doppi apici

  • Per attributi gestiti con controlli di tipo “Testo HTML” andrà inserito, ovviamente, non del semplice testo ma vero e proprio codice HTML (con i tag corretti chiusi in maniera opportuna).

ATTENZIONE! Nel caso in cui siano presenti all’interno del codice HTML uno o più caratteri utilizzati anche come carattere separatore e/o nel caso in cui il codice HTML non sia allineato su di un'unica riga ma vengano utilizzati dei ritorni a capo, il campo in esame dovrà essere racchiuso da doppi apici.

Inoltre nel codice HTML vengono utilizzati, tipicamente, doppi apici anche per racchiudere attributi e/o valori di determinati Tag. In questo senso sarà quindi necessario racchiudere tra virgolette oltre all’interno campo anche questi stessi elementi.

Es.

"<table border=""0"" cellpadding=""1"" cellspacing=""1"">

<tbody>

<tr>

<td style=""vertical-align: top; width: 50%;"">

</table>"

  • Per attributi gestiti con controlli di tipo “Immagine” dovrà essere inserito il percorso relativo dell’immagine da utilizzare (es. /Resources/loghi/canon-logo-small.png)

ATTENZIONE!! La procedura di import sovrascriverà eventuali dati già presenti all’interno del sito

Al termine della procedura di importazione verrà inviata una mail di notifica all’indirizzo impostato nella sezione “Posta/SMS” del Wizard contenente i dettagli relativi all’esito della procedura di import.

Tale messaggio potrà inoltre essere consultato anche all’interno della sezione “Posta/SMS – Log Mail” del Wizard.

Il pulsante Esporta ( ) consente invece di esportare in formato .csv l’elenco degli articoli gestiti all’interno del proprio sito con le relative informazioni anagrafiche.

Cliccando su questo pulsante verrà visualizzata la maschera “Esportazione Articoli” all’interno della quale poter configurare l’esportazione dei dati.

Nel caso di sito in multilingua è possibile selezionare, tra quelle attualmente gestite, la lingua in relazione alla quale dovranno essere esportati i dati degli articoli (campo Lingua)

Il campo Separatore consente invece di indicare, selezionandolo, dall’apposito menu a tendina, il carattere che dovrà essere utilizzato all’interno del file di esportazione come separatore per i vari campi.

E’ inoltre possibile definire un filtro sulla base del quale selezionare gli articoli che dovranno essere esportati (sezione Filtro) e, soprattutto, è possibile indicare esattamente quali campi (e conseguentemente che tipo di informazioni) dovranno essere esportati per ogni singolo articolo (sezione Campi).

In questo senso è sufficiente selezionare i campi desiderati tra quelli presenti nel riquadro sinistro ed inserirli in quello destro cliccando sul pulsante raffigurante una piccola freccia rivolta verso destra.

Nel riquadro di sinistra, assieme ai singoli campi sono presenti anche i Set di Attributi attualmente gestiti (evidenziati in grigio)

Selezionando uno di questi Set e spostandolo nel riquadro di destra verranno automaticamente inseriti nel file csv di esportazione tutti gli attributi associati a quello stesso set

Allo stesso modo per eliminare uno specifico campo dal file di esportazione, è sufficiente selezionarlo dal riquadro destro e cliccare sul pulsante raffigurante una piccola freccia rivolta verso sinistra.

I pulsanti raffiguranti due piccole frecce rivolte verso l’alto e verso il basso permettono infine di variare l’ordinamento dei campi e conseguentemente delle informazioni che dovranno essere esportate

NOTA BENE: Per maggiori informazioni relativamente alla creazione di un Filtro Articoli si rimanda alla sezione “Utenti – Gruppi Utenti Sito – Filtri Utente e Filtri Articolo – Filtri Articolo” di questo manuale.