Maxpho Commerce 11. Gestione CSV. Data: 20 Settembre 2011 Versione : 1.1 Autore: Maxpho Srl

Transcript

1 Maxpho Commerce 11 Gestione CSV Data: 20 Settembre 2011 Versione : 1.1 Autore: Maxpho Srl

2 Indice generale 1 - Introduzione Il file CSV Modulo CSV su Maxpho Modulo CSV Pro su Maxpho Specifiche CSV Struttura di interfacciamento CSV Importazione prodotti Automatismi Importazione prodotti Esportazione Ordini Esempi... 8 Pag. 2 di 9

3 1 Introduzione Questo documento presenterà i casi d'uso di interazione attraverso file CSV con il software Maxpho Commerce, in particolare l'importazione delle anagrafiche dei prodotti e l'esportazione delle informazioni degli ordini. Maxpho dispone di due diversi moduli per l'interazione con file CSV: Modulo CSV Modulo CSV Pro I dettagli tecnici di integrazione sono consultabili all'indirizzo web: Il file CSV Il CSV (Comma Separated Value) è un formato di archiviazione di dati molto comune basato su file di testo, utilizzato normalmente per l'importazione e l'esportazione di grosse moli di dati archiviate in una struttura tabellare. Questo standard è molto utilizzato nel mondo del web per l'interscambio di informazioni per due motivi principali: semplicità di utilizzo, creazione e manipolazione del file CSV; dimensione dei file ridotti con conseguente carico della rete molto basso e velocità di trasmissione alta. 1.2 Modulo CSV su Maxpho Questo modulo per l'interazione semplice dei CSV permette di settare le impostazioni di importazione ed esportazione dei file CSV direttamente da un pannello nell'amministrazione. Per quanto riguarda l'importazione delle anagrafiche è possibile impostare alcuni valori di default nel sistema per velocizzare le fasi di importazione come: Separatore dei campi di default (modificabile nelle singole importazioni); Separatore delle cifre decimali di default (modificabile nelle singole importazioni); Lingua di default (modificabile nelle singole importazioni); Pag. 3 di 9

4 Percentuale di ricarico prezzi (incide su ogni prezzo nel CSV); Inserimento automatico della categoria ebay consigliata per il prodotto; Numero di righe da importare simultaneamente (valore che permette in alcune situazioni di velocizzare l'importazione anche di 100 volte). Per quanto riguarda l'esportazione degli ordini è possibile impostare alcuni valori di default per indicare al sistema come estrarre i dati: Campi da esportare; Codifica terminatore di linea (Windows/Unix); Indirizzo server FTP (server su cui sarà esportato il CSV); Password server FTP (server su cui sarà esportato il CSV); Directory server FTP (server su cui sarà esportato il CSV). 1.3 Modulo CSV Pro su Maxpho Attraverso l'utilizzo del modulo più avanzato, definito CSV Pro, è possibile fornire al sistema un template di importazione da utilizzare ogni volta che ci si troverà ad importare un CSV conosciuto. Il sistema salverà l'intestazione del CSV in modo da poterlo riconoscere in una delle successive importazioni senza chiedere nuovamente all'utente di settare le impostazioni per il CSV e permettendo in questo modo anche eventuali automatismi di importazione. Le impostazioni che si possono fornire alla creazione del template di importazione sono: Associazione campi dell'header; Separatore dei campi; Separatore cifre decimali; Lingua predefinita di importazione; Nome template di importazione; Importazione automatica categorie; Importazione automatica produttori; Campi necessari (che devono contenere un valore) affinché una riga venga importata; Campi per l'aggiornamento, cioè i campi che il sistema verificherà essere cambiati per aggiornare o meno un prodotto; Filtro categorie, ovvero il sistema importerà soltanto i prodotti assegnati a determinate Pag. 4 di 9

5 categorie; Filtro produttori, ovvero il sistema importerà soltanto i prodotti assegnati a determinati produttori; Ricarico, cioè un ricarico percentuale o fisso per ogni campo numerico del CSV; Filtro soglie numeriche, quindi il sistema importerà soltanto i prodotti i cui valori numerici sono tra le sogli impostate; url FTP o HTTP di importazione del CSV, ovvero la locazione dove andrà il sistema a scaricare in automatico il CSV: Utente e Password FTP, nel caso in cui il CSV da scaricare si trovasse su un server FTP; Intervallo di importazione, quante volte il sistema importerà giornalmente il CSV. Pag. 5 di 9

6 2 Specifiche CSV Un file CSV costruito nel rispetto delle specifiche di encoding e di strutturazione del formato CSV può essere utilizzato in ingresso a Maxpho per popolare lo store online. In fase di importazione si possono inserire: l'anagrafica dei prodotti: ovvero tutti i campi del prodotto (nome, modello, descrizione, peso, etc...) e, se lo store online lo prevede, gli attributi collegati al prodotto che il buyer dovrà indicare in fase di acquisto; categorie dello store: se richiesto, tutte le categorie a cui sono assegnati i prodotti che il sistema importa e che non sono presenti nel database di Maxpho verranno create in modo automatico e assegnate al prodotto; produttori: come per le categorie, il sistema ha la possibilità di inserire in modo automatico e assegnare il produttore al prodotto nel caso in cui questo non sia già presente nell'amministrazione di Maxpho. Maxpho non vincola le caratteristiche in cui viene strutturato il CSV, poiché l'applicativo è installato su piattaforma Linux. Per evitare problema di encoding di caratteri speciali è richiesto che il CSV abbia codifica UTF Struttura di interfacciamento CSV Essendo il CSV un formato di archiviazione dell'informazione tra i più comuni, questo tipo di interazione è stato sviluppato con l'intenzione di fornire la possibilità di interfacciamento con architetture differenti e dando la possibilità al seller di non dover alterare o modificare gli strumenti che attualmente utilizza. Per un interfacciamento di questo tipo sono necessari pochi passaggi e possono essere individuati in due macro strutture: Generazione Data Feed: A partire dagli strumenti in possesso dal buyer è necessario esportare in formato CSV tutti i dati che si intendono importare all'interno dell'amministrazione di Maxpho. Essendo il CSV un formato di archiviazione molto comune e conosciuto, la maggior parte degli applicativi forniscono nativamente la possibilità di esportare l'informazione in questo formato; nel caso in cui, invece, l'esportazione non fosse possibile direttamente in formato CSV sono presenti molti strumenti che manipolano il file esportato e forniscono un CSV in uscita. Importazione Data Feed: Una volta generato il data feed contente tutte le informazioni di interesse, attraverso un'interfaccia user friendly viene chiesto al seller di indicare le caratteristiche strutturali del file per permetterne il corretto parsing da parte del sistema. Una volta completata questa fase, in modo totalmente automatico il sistema provvede Pag. 6 di 9

7 all'inserimento di tutte le informazioni contenute nel data feed. Una volta completata la procedura (la velocità di inserimento si riduce se il sistema ha la necessità di recuperare informazioni online come l'immagine del prodotto) è possibile controllare il risultato dell'importazione all'interno della finestra prodotti. 2.2 Importazione prodotti L'importazione prodotti è un meccanismo sviluppato con lo scopo di ottimizzare e ridurre la possibilità di errori in fase di popolamento dello store online. Attualmente il collo di bottiglia principale nella creazione di uno store online è appunto nell'inserimento di prodotti. L'inserimento della descrizione, dell'immagine e della specifica di tutti i dati relativi al prodotto richiedono un notevole sforzo umano con la conseguente possibilità di commettere errori. Migliorando questa fase grazie all'utilizzo di strumenti standard e ottimizzati, l'importazione consente la creazione e l'aggiornamento del proprio database prodotti in modo semplice, veloce e riducendo notevolmente gli errori in inserimento dell'informazione. Questo modulo è caratterizzato da un'elevata flessibilità che può essere identificata principalmente attraverso alcune caratteristiche descritte di seguito: Caricamenti Multi Lingua: i prodotti sono caratterizzati da informazioni che sono dipendenti dalla lingua. Se il negozio possiede più lingue di pubblicazione del prodotto in fase di popolamento mediante file CSV, il seller ha la possibilità di fornire un valore per tutte le lingue in cui si desidera che il prodotto venga inserito; Gestione attributi: se lo store lo prevede, è possibile indicare in fase di caricamento CSV le varianti di un prodotto con gestione delle quantità sulla variante stessa che si sta inserendo; Caricamento immagine: è possibile indicare nel file CSV un url HTTP a cui il sistema può trovare l'immagine del prodotto: in questo caso il sistema provvede in modo automatico a scaricare l'immagine ridimensionandola opportunamente. Pag. 7 di 9

8 3 Automatismi Oltre a usufruire dello scambio file sull'applicativo, è possibile automatizzare l'interazione senza necessariamente accedere al pannello di Maxpho Commerce. In questo modo le operazioni di aggiunta di nuovi prodotti e modifica dei vecchi prodotti è completamente trasparente all'utente e può essere comodamente eseguita, ad esempio, durante la notte. 3.1 Importazione prodotti Tramite il sistema CSV Pro è possibile automatizzare l'importazione dei prodotti da un url HTTP oppure da un server FTP. Per permettere che questo avvenga è sufficiente settare le configurazioni del CSV Pro direttamente dall'amministrazione di Maxpho Commerce. Le informazioni richieste saranno: URL dove è presente il file CSV; nome utente (solo nel caso di accesso FTP); password (solo nel caso di accesso FTP); directory (solo nel caso di accesso FTP); il numero di volte al giorno che il CSV deve essere scaricato e aggiornato dal sistema. 3.2 Esportazione Ordini Gli ordini si possono esportare in modo automatico utilizzando dei moduli CRON sul server residente. L'esportazione può essere fatta in 2 modi: 1. il file viene salvato nella cartella pub/outgoing_data/ del server residente 2. il file viene salvato direttamente in una directory di un server esterno tramite il protocollo FTP 3.3 Esempi Di seguito proponiamo alcuni esempi di utilizzo delle metodologie descritte nel documento: Importazione da url HTTP giornaliera: Inserendo l'url HTTP nella configurazione del CSV Pro, il sistema caricherà giornalmente il file dall'url copiando il file localmente al server dove è posizionato il sito, come log di sistema, e caricando i nuovi prodotti e tutte le modifiche dei prodotti in amministrazione. Pag. 8 di 9

9 Se, ad esempio, scegliessimo di importare in automatico le categorie, il sistema controllerebbe per ogni categoria presente nel file CSV se la stessa è presente anche nell'ecommerce e, in caso contrario, la inserirebbe automaticamente permettendo così di mostrare tutti i nuovi prodotti senza la necessità di un intervento umano e manuale nel sistema. Caricamento automatico da file residente sul server: è possibile automatizzare il caricamento di un CSV che sia stato caricato in precedenza direttamente sul server e che ospita il dominio nella cartella /pub/incoming_data del server. Il sistema, a intervalli stabiliti dall'amministratore del negozio, controllerà se nella cartella ci sono nuovi file e caricherà tutti i nuovi prodotti e le modifiche dei prodotti in modo trasparente all'utente, salvando poi il CSV nella cartella /pub/csv come log del sistema. Scarico del file degli ordini su un server FTP: Impostando le credenziali di accesso e una cartella di un server FTP è possibile scaricare sul server, a intervalli regolari, target un CSV di tutti gli ordini. L'automatismo permette di creare dei CSV incrementali che contengono cioè solo i nuovi ordini dall'ultima esportazione e quelli che hanno subìto un cambiamento di stato, come ad esempio da In Attesa a Pagamento Ricevuto. Pag. 9 di 9