e-Commerce e-Commerce 1 Descrizione del Modulo .................................................................................................................. 2 2 Installazione del Modulo ................................................................................................................ 2 2.1 Recupero dei file Necessari 2 2.2 Installazione Parte Client 3 2.2.1 2.3 Installazione Parte Server 3 RISPETTO dei REQUISITI TECNOLOGICI dell’hosting provider 4 2.3.2 Installazione di nopCommerce 2.65 4 2.3.3 Installazione della lingua Italiana sul WEB Store 9 2.3.4 Gestione Errori di Runtime su WEB IIS 10 2.3.5 Errori Frequenti relativi ai Permessi 10 Configurazione di nopCommerce 11 2.4.1 Abilitazione dei WEB Services 11 2.4.2 Azzeramento catalogo dei Prodotti di Prova 12 2.4.3 Impostazione del calcolo delle Tasse 13 2.5 Configurazione della Parte Client 14 2.5.1 Configurazione WEB Store 14 2.5.2 Configurazione del PICAM Client 20 Sincronizzazione dei Dati .............................................................................................................. 25 3.1 Inserisci / Modifica Prodotto 3.1.1 3.2 4 3 2.3.1 2.4 3 RISPETTO dei REQUISITI TECNOLOGICI delle postazioni client 25 Elenco dei campi di sincronizzazione Importa Ordini / Sincronizza Dati 29 30 Info sul Progetto nopCommerce (versione 2.65) ............................................................................ 33 4.1 Licenza 33 4.2 Riferimenti Progetto open-source 33 4.3 Browser Supportati 33 4.4 Strumenti di Sviluppo 33 4.5 Requisiti Tecnologici e di Sistema (versione 2.65) 33 Integrazione al Manuale Utente 1 e-Commerce 1 Descrizione del Modulo Il modulo è la soluzione proposta da ABC Solutions per consentire agli utenti Picam7 di vendere i propri prodotti sul WEB. Il modulo è composto da una parte SERVER, ovvero il sito WEB che utilizza nopCommerce (vers. 2.65) come carrello elettronico, e da una parte CLIENT, costituita da procedure Picam7 utilizzate per la sincronizzazione del Catalogo WEB e il recupero degli ordini confermati sull’e-Commerce. La creazione di un nuovo ordine Picam7 da un ordine WEB offre la possibilità di Impegnare le Esistenze di Magazzino Importare il cliente WEB in Picam7 ( Il cliente viene creato solo se non c’è corrispondenza fra Partita IVA WEB e Partita IVA Picam7) Il programma di gestione degli ordini WEB permette di filtrarli in base allo stato e di aprire in modifica l’ordine Picam7 associato. La creazione di un nuovo articolo WEB è facilitata prelevando i dati principali dall’anagrafica Articoli di Picam7. Attualmente in fase di configurazione viene indicato un magazzino principale utilizzato per aggiornare la disponibilità WEB di un articolo, che viene utilizzato anche nella creazione dell’ordine Picam7. Attraverso la procedura Picam7 di configurazione del WEB Store, è possibile impostare l’Euro come valuta principale e gestire la visualizzazione o meno dell’IVA per i prodotti del sito WEB. Le istruzioni di configurazione della parte server, guidano in modo chiaro all’installazione della Lingua Italiana sul WEB Store. 2 Installazione del Modulo Prima di iniziare è fondamentale sapere che per l’installazione della parte SERVER del modulo e per l’installazione della parte CLIENT vanno rispettati REQUISITI TECNOLOGICI e di SISTEMA. - Requisiti CLIENT (vedi Capitolo 2.2.1) - Requisiti SERVER (vedi Capitolo 2.3.1) L’Installazione completa del modulo e-Commerce, quindi, si suddivide in due parti: Lato Server (WEB): 1. Installazione di nopCommerce (da qui in poi WEB Store) 2. Abilitazione del WEB Store al supporto di chiamate remote Lato Client (PC): 3. Configurazione dei programmi Client di Picam7 2.1 Recupero dei file Necessari File necessari per l’installazione della parte CLIENT: 1. Attivare il modulo e-Commerce contattando il servizio assistenza Picam7 File necessari per l’installazione della parte SERVER: 1. Dal DVD di installazione di Picam7 estrarre la cartella Web, contenente le sottocartelle: Nop2.65 : Ovvero nopCommerce (Versione 2.65) modificato per l’installazione su ARUBA Nop_WS_1.0 : (Picam.Webservices Plugin per la comunicazione con Picam7) Importante: all’interno di \\web_install\Nop2.65\Extensions\Languages c’è il file della lingua italiana rilasciato da ABC Solutions: ABC_Solutions_28060_59037_Italian-265.zip. Integrazione al Manuale Utente 2 e-Commerce 2.2 Installazione Parte Client Verificare il rispetto dei requisiti tecnologici delle postazioni Client (vedi capitolo 2.2.1) Verificare che all’interno della cartella prg2000 dell’installazione di Picam7 siano presenti i seguenti files: NopProxy.dll nopProxyBridge.dll ecommerce.dll ecstore.dll ecmngr.dll ecmeditv.dll ecsyncro.dll 2.2.1 RISPETTO dei REQUISITI TECNOLOGICI delle postazioni client Sul PC deve essere presente: - Microsoft .NET Framework (versione 3.5 o successive) Messaggio di Errore: Se lanciando una procedura del modulo e-Commerce compare un messaggio come quello riportato sotto, come prima cosa accedere al pannello di controllo, verificare che fra la lista dei programmi installati ci sia .NET Framework. 2.3 Installazione Parte Server Se il cliente non ha un sito WEB, è necessario acquistare uno spazio di hosting per installare nopCommerce (versione 2.65). ABC Solutions consiglia come hosting provider: ARUBA. Nota 1: Il modulo è stato testato su questo servizio di host. Nota 2: Nella guida di Installazione che seguirà, le schermate di configurazione saranno quelle del pannello di amministrazione di ARUBA. Integrazione al Manuale Utente 3 e-Commerce 2.3.1 RISPETTO dei REQUISITI TECNOLOGICI dell’hosting provider Qualora si volesse cercare un servizio di hosting alternativo ad ARUBA, per capire se sia in grado di ospitare nopCommerce (versione 2.65), andranno verificati i seguenti requisiti di Sistema: Sistemi operativi del server supportati: o Windows 8 o Windows 7 o Windows Vista o Windows XP o Windows Server 2003 o Windows Server 2008 o Windows Server 2012 Web Server supportati: o Internet Information Service (IIS) 7.0 o superiore. ASP.NET 3.5/4.0 (MVC 3) Database supportati: o MS SQL Server 2005 o superiore. o MS SQL Server Compact 4.0 o superiore. 2.3.2 Installazione di nopCommerce 2.65 Passo 1 Copiare il contenuto della cartella Web nella directory C:\web_install Se non presente, installare un client ftp (ABC Solutions consiglia: Filezilla). Passo 2 Attraverso il client FTP copiare la cartella locale: - C:\web_install\Nop2.65\bin nella directory remota: - your_web_site_root Passo 3 Attribuire i permessi alle cartelle. NopCommerce necessita di permessi in scrittura sui files e sulle directories remoti sotto indicati: Directories: \App_Data\ \bin\ \Content\ \Content\Images\ \Content\Images\Thumbs\ \Content\Images\Uploaded\ \Content\files\ExportImport\ \Plugins\ \Plugins\bin\ Files: \Global.asax \web.config Questi permessi sono verificati nel processo di installazione. Se non sono settati verrà visualizzato un messaggio di errore con la richiesta di configurarli. Integrazione al Manuale Utente 4 e-Commerce Passo 3.1 Andare sul Nuovo Pannello di Amministrazione di Aruba. Cliccare su Permessi in Gestione Servizi Acquisiti / Hosting Windows / Permessi Dalla dialog di gestione Permessi, sotto riportata, selezionare le cartelle indicate al Passo 3 una alla volta e aggiungere i permessi in scrittura Integrazione al Manuale Utente 5 e-Commerce NOTA: I permessi non vengono assegnati immediatamente ma vengono inseriti in una coda di attesa. É necessario seguire le indicazioni del File Manager (aspettando se richiesto) fino al completo assegnamento dei permessi. Integrazione al Manuale Utente 6 e-Commerce Passo 4 Cliccare su configurazione del Framework.Net in Gestione dei servizi Acquistati , Framework .NET (ASP.net) Seleziona la versione in base all’ambiente di sviluppo locale Settare: 4.0 mentre per la voce: Modalità Pipeline La modalità Classica si comporta come la versione precedente di IIS. La modalità Integrata processa tutte le richieste con un unico processo grazie all'integrazione con Asp.Net, nativa in IIS 7. Settare: Integrated Salvare e confermare le modifiche effettuate. Passo 5 Verificare la correttezza dei permessi assegnati; digitando l’indirizzo http://www.your_web_site.domain si possono verificare due possibili situazioni: 1. I permessi sono stati assegnati correttamente; quindi verrà proposta la maschera di configurazione della connessione di SQL Server. 2. Si sono verificati errori imprevisti. Nota Errori: di default IIS 7.0+ non mostrano gli errori sul server. Per visualizzarli occorre modificare il file web.config per abilitarne la visualizzazione. Vedi Sezione Gestione errori di Runtime (capitolo 2.3.4). Passo 5.1 Nel caso non si sono verificati errori: 1. Digitare l’indirizzo http://www.your_web_site.domain. 2. Recuperare dal contratto stipulato con ARUBA: Utente e password ( ovvero i dati di accesso al DB SQL Server ) Nome del DataBase da Utilizzare Host DataBase (che verrà indicato più avanti in fase di configurazione come parametro Data Source ) 3. Inserire in Admin, user, e-mail, (l’e-mail deve essere valida) 4. Spuntare la voce Create Sample Data ( fondamentale per portare a termine l’installazione) 5. Impostare la password di amministratore per l’accesso al sito Integrazione al Manuale Utente 7 e-Commerce IMPORTANTE: Assicurarsi che sia abilitata la spunta su “Create sample data” Scegliere l’opzione Use SQL Server ( or SQL Express) Database. Non spuntare la voce per creare un nuovo Database (Aruba non ne dà la possibilità). Scegliere la voce: Enter raw connection string (advanced) Impostare la Connection string in base al formato indicato in figura. (Si suggerisce di fare copia e incolla della stringa che riportiamo qui di seguito e di modificarla opportunamente) Data Source=xxx.xxx.xxx.xxx;User ID=MSSqlxxxxx;password=xxxxxx NOTA: Il formato del datasource deve essere quello indicato ( spazi fra i vocaboli compresi ! ) Nota Tecnica: Il Provider utilizzato x la connessione utilizza un formato della Connection String Compatibile con il ProviderName=”System.Data.SqlClient”. Il template è il seguente. Un’applicazione basata su framework .NET 4.0 utilizzerebbe nel File Web.config: <add name="objConn" connectionString="Data Source=XXX.XXX.XXX.XXX;User ID=MSSqlXXXX;password=YYYYYY" providerName="System.Data.SqlClient"/> Cliccando su Esegui verrà visualizzata l’immagine che segue Integrazione al Manuale Utente 8 e-Commerce Passo 6 Fine processo di installazione. Digitare l’indirizzo http://www.your_web_site.domain . Se tutto è andato a buon fine verrà caricata l’ Home page di nopCommerce che utilizza il dollaro (USD) come valuta di default, la lingua inglese come lingua principale e gli articoli di prova raggruppati in categorie. Verificare l’accesso dell’Utente Amministratore. 2.3.3 Installazione della lingua Italiana sul WEB Store E’ stato testato che il file della lingua italiana di default rilasciato sul sito ufficiale interpreta erroneamente l’apice singolo generando errori di script e di disallineamento dei templates. Il disallineamento dei templates soprattutto in Chrome rende il sito difficile da utilizzare. ABC Solutions rilascia un file di correzione in cui l’apice singolo viene sostituito con il simbolo ´. Di seguito le operazioni da eseguire per l’installazione di tale file. Passo 1 Dalla cartella C:\web_install\Nop2.65\Extensions\Languages decomprimere il file ABC_Solutions_28060_59037_Italian-265.zip per estrarre il file Italian-265.xml. Passo 2 Accedere come Amministratore al pannello di Controllo Configuration/Languages e cliccare sul tasto “ADD NEW” (aggiungi nuova lingua) Passo 3 Impostare come da figura: Passo 4 Cliccare su “Save and Edit”. Passo 5 Verrà visualizzato un nuovo tasto denominato “Import Resources”. Cliccando sul tasto compare la maschera per caricare il file della lingua. Passo 6 Richiamare la lingua Inglese ed impostare la proprietà: - Display order: 2 Integrazione al Manuale Utente 9 e-Commerce 2.3.4 Gestione Errori di Runtime su WEB IIS Abilitazione della visualizzazione degli Errori lato Server. Supponiamo che sia avvenuto un Application Error sul Server. Per ragioni di Sicurezza, IIS dalla versione 7.0 in poi imposta la voce di configurazione “current custom error” in modo tale da prevenire la visualizzazione in remoto dei dettagli dell’errore di un’applicazione WEB. Se si ha accesso alla macchina server locale, è comunque possibile aprire un browser e visualizzare gli errori. L’accesso che in una LAN avverrebbe tramite una connessione Terminal (RDP), WEBSphere client, o altro, non può essere effettuato sui server ARUBA per contratti di hosting standard. Per abilitare la visualizzazione dei dettagli di un messaggio di errore specifico da una macchina remota, occorre editare il file web.config situato nella directory your_site_root. Occorre: inserire il TAG <customErrors> Impostare l’attributo: “mode” ad “Off” <!-- Web.Config Configuration File --> <configuration> <system.web> <customErrors mode="Off"/> </system.web> </configuration> 2.3.5 Errori Frequenti relativi ai Permessi Quando si viene re-direzionati sulla pagina http://yoursite.it/errorpage.htm l’errore più probabile è quello di non aver assegnato correttamente i permessi richiesti. (Vedi Sopra) Il messaggio visualizzato è il seguente: We're sorry, an internal error occurred that prevents the request to complete. Our supporting staff has been notified with this error and will address this issue shortly. We profusely apologize for the inconvenience and for any damage this may cause. You might want to try the same action at later time. Integrazione al Manuale Utente 10 e-Commerce 2.4 Configurazione di nopCommerce Quando si installa nopCommerce (versione 2.65), per portare a termine l’installazione ed avere un’area di Amministrazione che non dia errori, è necessario installare anche i dati di Prova. Tuttavia per consegnare al cliente un sito pulito, ma utilizzabile, occorre: Eliminare i dati di alcune tabelle (Articoli, Produttori, Sconti, ecc…) Lasciare alcuni dati fondamentali (Lingua inglese, Valute, Codici nazione, ecc…) Occorre inoltre abilitare i servizi di comunicazione Remota. 2.4.1 Abilitazione dei WEB Services ABC Solutions come prima cosa consiglia di abilitare i servizi di comunicazione Remota. Per abilitare la comunicazione fra i programmi Picam7 e WEB Store è necessario effettuare 3 cose: 1. Abilitare il plugin Misc.WebServices per la gestione di Webservices generici 2. Fornire all’Amministratore l’accesso alle funzionalità Webservices 3. Installare il Plugin Picam.Webservices sul Web Store Passo 1 Copia del Picam.Webservices Plugin sul sito WEB. Attraverso il client FTP copiare la cartella locale: C:\web_install\Nop_WS_1.0 \Plugins\Picam.Webservices Nella directory remota: your_web_site_root/Plugins Passo 2 (Facoltativo) Misc.WebServices è un plugin di nopCommerce per abilitare l’accesso ai dati tramite Web Service solo ad un determinato gruppo di utenti. Purtroppo fra le funzionalità abilitate in automatico c’è anche quella di far eseguire una query generica, ma ciò dal punto di vista della sicurezza non è consigliato. Misc.WebServices , utilizzato anche da Picam.Webservices, viene fornito da ABC Solutions in una versione più limitata. Ovvero il contratto esposto ( lista dei metodi disponibili) viene ridotto all’autenticazione. In questo modo il WEB Store espone solo i Metodi del Plugin Picam7 per la sincronizzazione dei dati attraverso il gestionale. Per procedere alla sostituzione del plugin, attraverso il client ftp eliminare la cartella: “your_site_root/Plugins/Misc.Webservices” Quindi copiare nella directory remota: your_site_root/Plugins la directory: C:\web_install\Nop2.65\Extensions\Plugins_Personalizzati\Misc.WebServices Passo 3 Verifica dei Plugin Installati. Occorre verificare la presenza del plugin: - Misc.WebServices - Picam.Webservices Nell’area di Amministrazione, accedere al pannello di Controllo Configuration/Pluging e verificare la presenza dei plugins indicati. Integrazione al Manuale Utente 11 e-Commerce NOTA: Se accedendo alla pagina del plugin manager si ha un errore occorre controllare la presenza di 2 files di configurazione all’interno della directory your_site_root/App_data : InstalledPlugins.txt: il file di Configurazione dei Plugin. Attraverso questo file il plugin Manager sa quali sono i plugin disponibili, e ne carica i Packages. Settings.txt: il file di Configurazione del database. Questo file viene creato al termine della procedura di installazione e contiene informazioni sulla connessione al DB. Passo 4 Per l’abilitazione dei Web Service accedere nell’area di Amministrazione al pannello di Controllo Configuration/Pluging Premere il Pulsante RESTART APPLICATION Premere il Pulsante per ri-effettuare il Reload della Lista di Plugin Cercare in Lista il plugin Misc.WebServices e se non abilitato cliccare su Install Cercare in Lista il plugin Picam.Webservices e cliccare su Install. Configurare il Plugins Misc.WebServices per permettere all’utente Amministratore di effettuare le chiamate da remoto (Sarà l’utente utilizzato dal Client di Picam7) Per fare questo : Andare in pannello di Controllo Configuration/Access Control List ( Gestione ACL) Abilitare Il gruppo Administrator all’accesso ai web services andando a spuntare la voce “Pugin.Access Web Service” (Solo per il gruppo Administrator) Premere il Pulsante Salva. Ora il WEB Store dispone di un Access point attivo su questo indirizzo (WEB Store su dominio di secondo livello): - http://www.your_web_site.domain/Plugins/Picam.WebServices/Remote/StoreSyncService.svc o questo (WEB Store su dominio di terzo livello): - http://subdomain3Level.your_web_site.domain/Plugins/Picam.WebServices/Remote/StoreSyncService.svc NOTA: Sostituendo nel template indicato il nome del proprio sito WEB, il sito non risponderà. Per poter visualizzare il Contratto esposto dal webservice occorre intervenire su una serie di parametri di configurazione di WCF. Per saperne di più, si rimanda alla lettura delle specifiche di Windows Comunication Foundation ed in particolare alla configurazione dei parametri httpGetEnabled, contract="IMetadataExchange" dei TAGs <serviceMetadata> ed <endpoint>. Il file di configurazione remoto da editare è: your_site/Plugins/Picam.Webservices/Remote/web.config. 2.4.2 Azzeramento catalogo dei Prodotti di Prova Procedere con l’azzeramento delle seguenti Tabelle: Nome Tabella Category Manufacturer Products Tags Orders Discount TaxCategory Percorso menù nopCommerce Admin_Menu/Catalogo/Categorie/Elenco/Modifica Admin_Menu/Catalogo/Fornitori/Modifica Admin_Menu/Catalogo/Prodotti Admin_Menu/Catalogo/Prodotti/Tag del Prodotto Admin_Menu/Vendite/Ordini - Per ogni Ordine: Admin_Menu/Promozioni/Sconti/Modifica Admin_Menu/Configurazione/Tasse/Categorie Fiscali Integrazione al Manuale Utente Azione da intraprendere Premere il Pulsante Elimina Premere il Pulsante Elimina Selezionare Tutti ed Elimina Premere il Pulsante Elimina Selez. Visualizza ed Elimina Premere il Pulsante Elimina Eliminare tutte le Voci Presenti 12 e-Commerce 2.4.3 Impostazione del calcolo delle Tasse Anche per l’inserimento / modifica delle configurazioni di Default riportiamo: - Nome Tabella - Percorso del menù di nopCommerce per accedere alla pagina di eliminazione - L’azione da intraprendere Impostare il Tax Provider (Metodo del calcolo delle Tasse) Nome Tabella: TaxProvider Percorso menù nopCommerce: Admin_Menu/Configurazione/Tasse/Provider delle Tasse Azione da intraprendere: Premere il Pulsante Seleziona del provvider: Fixed tax rate provider Impostare il Tax Address di default (Alcune operazioni per il calcolo delle tasse si basano sulla Nazione) Nome Tabella: Tax Address di Default. Percorso menù nopCommerce: Admin_Menu/Impostazioni/Impostazioni delle Tasse /Indirizzo Fiscale Predefinito Azione da intraprendere: Impostare Italy. IMPOSTARE LE TASSE DI SPEDIZIONE ( va Eseguita in Seconda Battuta) Se si sono seguiti correttamente tutti i passi, arrivati a questo punto, non dovrebbero essere presenti categorie fiscali, perché sono state tutte eliminate per predisporne la creazione dal client di Picam7. IMPORTANTE: Si consiglia di tornare in questa sezione solo dopo aver configurato qualche articolo PICAM . L’upload sul WEB Store di un articolo Picam7, inserirà sicuramente una categoria fiscale WEB con aliquota al 22%. La categoria fiscale WEB creata è legata al codice IVA Picam7. Admin_Menu/Impostazioni/Impostazioni delle Tasse : 1. Settare il Flag spedizione Imponibile. 2. Settare una Categria Fiscale di Default. Integrazione al Manuale Utente 13 e-Commerce 2.5 Configurazione della Parte Client Le procedure Picam7 di sincronizzazione sono state progettate solo per Base dati SQL Server. Per portare a termine la configurazione del modulo e-Commerce occorre: Impostare il sito WEB per la vendita in Italia (es: la valuta principale del WEB Store deve essere l’EURO) - Configurare il Client Picam7 in modo che - Possa trasferire gli ordini WEB in ordini Picam7 - Automatizzi quanto più possibile la creazione Prodotti WEB (catalogo) Immagini Categorie Prodotto Categorie Fiscali 2.5.1 Configurazione WEB Store Per meglio comprendere a cosa serva questa procedura, si pensi che ogni record inserito in questa anagrafica, rappresenta la configurazione di un sito WEB Store salvata in Locale. L’utente che si richiede di inserire è quindi quello del WEB Store ovvero quello dell’Amministratore. La funzionalità di Verifica Connessione, verifica che sia possibile raggiungere l’access point abilitato al Passo 4 nel capitolo di Abilitazione dei WEB Services (capitolo 2.4.1). La funzionalità di Verifica Allineamento, apre una maschera attraverso cui è possibile: - Replicare in locale le impostazioni del WEB Store. - Inviare al WEB Store le impostazioni modificate in locale. NOTA: Nonostante non sia un vincolo, attualmente viene gestito un solo WEB Store per Ditta Picam7. Quindi è fortemente sconsigliato creare più di un WEB Store in questa tabella. Nell’esempio riportato si è configurato un dominio di Terzo livello. Passo 1 Entrare in modalità inserimento Indicare - Codice Ditta Codice Store Store Principale URL Service Binding Integrazione al Manuale Utente 14 e-Commerce Passo 2 Premere il pulsante Inserisci / Modifica Inserire User e Password dell’utente Amministratore del WEB Store ( l’unico con permessi si sincronizzazione dei DATI). Notà: Questa maschera non ha effetto sui dati WEB. User e Password vengono salvati solo sul Database di Picam7. Quindi anche il check sull’ultima password inserita, è da considerarsi come check sull’ultima password inserita in Locale. La modifica della password di Amministrazione WEB può essere fatta solo accedendo al WEB Store nell’apposita sezione Utente. Salvare il Record. Integrazione al Manuale Utente 15 e-Commerce Passo 3 Replica in Locale delle impostazioni del WEB Store Richiamare il WEB Store in modifica. Premere il pulsante Verifica Allineamento. Premere il pulsante Leggi da WEB. Passo 4 Configurazione parametri per la vendita in Italia. Passare alla pagina di configurazione delle Tasse Integrazione al Manuale Utente 16 e-Commerce Premere il pulsante Imposta: Viene aperta una maschera che, interrogando il WEB Store, recupera: - Dati dell’indirizzo Fiscale di Default - La lingua correntemente in uso - La valuta di default del catalogo WEB Per il campo Applica Configurazione Standard: - Selezionare Imposta Vendita Italia Per il campo Nuova Valuta WEB: - Selezionare Euro Premere il pulsante OK. Premere il pulsante Applica per salvare le modifiche del record. Alla richiesta di aggiornare Immediatamente i dati WEB premere Si. Integrazione al Manuale Utente 17 e-Commerce Passo 5 Modifica della lingua di Default Passare alla pagina di configurazione: Varie. Per modificare la Lingua di Default premere il pulsante Imposta Viene riaperta la maschera del Passo 4. Selezionare nel campo Lingua principale il codice desiderato. Premere il pulsante OK. Premere il pulsante Applica per salvare le modifiche del record. NOTA: La lingua inglese compare sempre, perché nopCommerce la installa di default. Se la lingua intaliana non compare è necessario accedere a nopCommerce e installarla (Vedi paragrafo: Installazione della lingua italiana). Passo 6 Premere il pulsante Verifica Connessione per verificare se tutto è andato a buon fine; comparirà il messaggio: Integrazione al Manuale Utente 18 e-Commerce Passo 7 I principali campi gestiti sono i seguenti: APPLICA TASSE IN BASE A Gli algoritmi per il calcolo delle tasse in nopCommerce fanno riferimento alla nazione, diversificando per gli stati all’interno della nazione stessa. Per l’ Italia il discorso è più semplice. Selezionare Indirizzo Fiscale Predefinito (l’indirizzo è già presente sul WEB Store, in quanto si era detto di crearlo nel capitolo 2.4.3). METODO PER IL CALCOLO DELLE TASSE Selezionare Aliquota IVA. NAZIONALITA’ DEL WEB STORE Selezionare Italy. GESTIONE IVA ABILITATA Abilitando questa Voce, sul WEB Store, si attivano plugin e voci di configurazione per il calcolo delle Tasse. Selezionare: SI SCORPORO DEI PREZZI PICAM ? All’interno di un WEB Store, i prezzi degli articoli possono essere IVA compresa oppure no. ATTENZIONE: Occorre allineare la gestione dello scorporo al listino di Picam7 utilizzato. Es. Se il listino Picam7 che si sta utilizzando non è comprensivo di IVA; Selezionare: NO. PREZZI AL CLIENTE IVA COMPRESA ? Indipendentemente dai prezzi indicati per i Prodotti WEB, possiamo decidere se sul WEB Store vogliamo che i prezzi visualizzati siano IVA compresa o no. Per visualizzare i prezzi IVA compresa: Selezionare SI. VISUALIZZA SUFFISSO IVA (Incl / Escl) Per visualizzare il suffisso IVA inclusa: Selezionare SI. ELENCO DEI PROVIDERS ATTIVATI ( Metodi di spedizione Attivati ) Campo in sola visualizzazione. In base alle impostazioni del WEB Store, si riporta la lista dei metodi per il calcolo delle spese di trasporto. STIMA DELLA SPEDIZIONE ( WEB Cart ) Attiva / Disattiva nella pagina di conferma ordine lo strumento per il calcolo delle spese di Spedizione. Può essere attivato solo se opportunamente configurato. Selezionare: NO. BUONO SCONTO Attualmente non si gestiscono Buoni sconto. Selezionare: NO. CODICE GIFT CARD Attualmente non si gestiscono Gift Card. Selezionare: NO. TIPO DI MEMORIZZAZIONE ( Immagini WEB Store) Di default nopCommerce salva le immagini sul Database. In alternativa può salvare su File system. Si consiglia di lasciare l’impostazione di default: Database. IMPORTANTE: Prima di cambiare questa impostazione, si consiglia di fare prima un backup dei Dati. Se lo spazio richiesto su Filesystem o sul Database è inferiore a quello richiesto per portare a termine l’operazione molte immagini si perderanno definitivamente. Integrazione al Manuale Utente 19 e-Commerce 2.5.2 Configurazione del PICAM Client Questa procedura permette l’inserimento di una serie di Parametri per ditta, che vengono utilizzati dai programmi del modulo e-Commerce per polorare il Catalogo del WEB Store ed elaborare gli ordini WEB scaricati. Passo 1 Inserimento della configurazione Client per la ditta corrente. Selezionare la pagina Principale. Entrare in modalità inserimento. Nel campo Ditta inserire il codice della ditta corrente. Aggiundere una descrizione come quelle indicate in figura. Passo 2 Impostazione Parametri per la Creazione di nuovi articoli WEB Selezionare la pagina 1a. Articoli Integrazione al Manuale Utente 20 e-Commerce I principali campi gestiti sono i seguenti: TIPO LISTINO Preimpostato in automatico in base al tipo di listino indicato nei parametri di configurazione della ditta Picam7. NUMERO LISTINO Numero listino / Codice Listino Avanzato utilizzato per proporre il prezzo dell’articolo WEB. NOME ARTICOLO WEB DESCRIZIONE ARTICOLO WEB DESCRIZIONE COMPLETA I campi descrittivi di un nuovo articolo WEB verranno preimpostati in base ai campi ARTICOLO Picam7 indicati nei rispettivi campi. PUBBLICA (Prodotto WEB) Preimposta la proprietà per la visualizzazione immediata di un nuovo articolo WEB. HOME PAGE (Prodotto WEB) Preimposta la proprietà per la visualizzazione in Home Page di un nuovo articolo WEB. CRITERIO / PROPRIETA’ (Categoria WEB) Si suggerisce di impostare: Gruppo Merceologico di Vendita. I campi Categoria WEB e Categoria Fiscale WEB di un nuovo articolo WEB verranno preimpostati come quelli dell’ultimo articolo WEB che aveva lo stesso Gruppo Merceologico di Vendita. PUBBLICA (Categoria WEB) Preimposta la proprietà per la visualizzazione immediata di un nuova categoria WEB. HOME PAGE (Categoria WEB) Preimposta la proprietà per la visualizzazione in Home Page di una nuova categoria WEB. Visualizza Articoli WEB Eliminati (Gestione Articoli Eliminati) Spuntare questa voce se nel programma Picam7 di Gestione degli articoli WEB si vuole includere nella lista degli articoli gestiti anche articoli gestiti che attualmente sono stati eliminati dal WEB. Salva configurazioni Parziali Parametro predisposto, ma non gestito in questa versione. Nel programma di Gestione degli articoli WEB, gli Articoli Picam7 selezionati per essere creati sul WEB, rimangono nella lista di gestione solo se vengono modificati e confermati dall’utente, o se vengono inviati sul WEB; alla chiusura del programma gli altri articoli, facendo parte di una lista di selezione temporanea, verranno eliminati. Sovrascrivi configurazioni Parziali Parametro predisposto, ma non gestito in questa versione. Non è consentito avere più articoli WEB associati ad un articolo Picam7. Passo 3 Impostazione Parametri per la Gestione di Categorie WEB, Produttori WEB, Immagini WEB associate all’articolo. In Picam7 esiste una sola Categoria, una sola Marca, una sola Immagine associata all’articolo, mentre in nopCommerce le stesse entità sono legate all’articolo WEB e possono essere in numero superiore. Integrazione al Manuale Utente 21 e-Commerce In questa pagina si dichiara in maniera puntuale se Categorie, Produttori, e Immagini WEB devono essere legate all’articolo WEB in maniera univoca o meno. I principali campi gestiti sono i seguenti: TIPO GESTIONE Si consiglia di impostare l’opzione Gestione PICAM. Se imposto Gestione Picam7: - l’ultima categoria WEB inserita per un articolo sarà la Categoria di Default (Eventuali altre Categorie associate all’articolo saranno eliminate) - l’ultimo Produttore WEB inserito sarà il Produttore di Default (Eventuali altri Produttori associati all’articolo saranno eliminati) - l’ultima immagine WEB inserita per un articolo sarà l’Immagine di Default (Eventuali altre Immagini associate all’articolo saranno eliminate) Se imposto Gestione Ibrida: - rispettivamente nei vari campi si dovrà indicare singolarmente tutte le entità correlate. Nota: La gestione delle entità correlate in numero superiore a uno dovrà essere fatta dal WEB Store attraverso il pannello di amministrazione. Passo 4 Impostare il magazzino principale da cui verranno scelti gli articoli WEB, indicando la quantità da mettere in vendita sul WEB Store. NOTA: In base agli esempi riportati in figura, in fase di creazione di un nuovo articolo, possiamo avere una disponibilità di vendita web fissa di 5 unità (figura 1), oppure una percentuale rapportata al magazzino 01 (figura 2). Integrazione al Manuale Utente 22 e-Commerce Passo 5 Definire un percorso con permessi in lettura e scrittura, in cui verranno salvate le immagini inviate sul WEB Store. NOTA: Se le postazioni client che fanno Upload di Articoli e ricevono Ordini sono più di una, è bene che questa cartella sia raggiungibile da tutti i PC degli utenti, con lo stesso nome di percorso. Passo 6 Definizione dei parametri per la creazione di Ordini / Preventivi. Impostare EUR come Unità monetaria. I principali campi gestiti sono i seguenti: TIPO ORDINE / PREVENTIVO Impostando il Tipo Documento dell’Ordine l’importazione di un ordine WEB creerà un Ordine in Picam7. Impostando il Tipo Documento Preventivo l’importazione di un ordine WEB creerà un Preventivo in Picam7. REGISTRO Registro usato per gli Ordini / Preventivi UNITA’ MONETARIA Il modulo e-Commerce al momento genera solo ordini in euro. DEPOSITO Il deposito è quello indicato al Passo 4. Integrazione al Manuale Utente 23 e-Commerce Passo 7 Mettere in relazione i metodi di Pagamento WEB con i codici pagamento di Picam7. Confermando un ordine WEB è possibile scegliere il metodo di pagamento ( es: carta di Credito, bonifico, ecc…) Se questa tabella è configurata, la procedura di creazione dell’ordine Picam7 dall’ordine WEB preimposta il campo codice Pagamento con i pagamenti di Picam7. Per Associare un codice pagamento di Picam7 ad un Metodo di Pagamento WEB: - Entrare in modalità Modifica - Selezionare una riga dall’elenco dei Metodi di Pagamento WEB - Indicare nel campo Cod. Pagamento il codice di pagamento Picam7 da associare. Integrazione al Manuale Utente 24 e-Commerce 3 Sincronizzazione dei Dati Al momento esistono due procedure di sincronizzazione dei dati, una per i prodotti e l’altra per gli Ordini. 3.1 Inserisci / Modifica Prodotto Questa procedura consente di gestire i codici articolo Picam7 trasferiti su WEB. Per pubblicare un articolo sul WEB procedere come indicato: Passo 1 Impostare i campi per filtrare l’anagrafica articoli di Picam7, e premere il pulsante Preseleziona. Viene proposta una lista da cui è possibile selezionare gli Articoli tramite i tasti di selezione in alto. Integrazione al Manuale Utente 25 e-Commerce Premere Conferma. Come si può notare i campi scelti sono stati aggiunti alla lista degli articoli da gestire. Premere il Tasto Prodotto Viene aperta la maschera di configurazione del Prodotto WEB, con i campi descrittivi preimpostati. Integrazione al Manuale Utente 26 e-Commerce Per poter aggiungere un articolo sul WEB occorre inserire altri tre dati obbligatori - Categoria WEB - Immagine WEB - Categoria Fiscale WEB Categoria WEB La Categoria WEB è quella che andrà a comporre il Menù di sinistra del WEB Store: Selezionare una Categoria WEB esistente, oppure crearne una nuova Per inserire una nuova Categoria WEB, premere il Tasto New a fianco del campo Categoria WEB Eventualmente modificare la descrizione e premere OK. Per inserire una nuova Immagine WEB, premere il Tasto New a fianco del campo Immagine Eventualmente selezionare un’immagine diversa da quella proposta e premere OK. Integrazione al Manuale Utente 27 e-Commerce Categoria Fiscale WEB Selezionare una Categoria Fiscale WEB esistente, oppure crearne una nuova Per inserire una nuova Categoria Fiscale WEB, premere il Tasto New a fianco del campo Categoria Fiscale WEB Eventualmente modificare la descrizione e premere OK. IMPORTANTE: La configurazione creata, per essere trasmessa al WEB Store, deve essere Confermata inserita in lista di sincronizzazione Inviata al WEB Store Confermare le modifiche: premendo il pulsante Salva. Aggiungere l’articolo in lista di sincronizzazione: premendo il pulsante Aggiungi alla lista. NOTA: terminato l’inserimento dei dati, lo specchietto riepilogativo dello stato di sincronizzazione si presenterà come di seguito: Inviare la configurazione dell’ Articolo al WEB Store, premendo il pulsante: Sincronizzazione Prodotto WEB. Se l’upload del prodotto ha esito positivo comparirà il messaggio: Integrazione al Manuale Utente 28 e-Commerce Lo stato di sincronizzazione sarà il seguente: PASSAGGIO AL PROSSIMO ARTICOLO SELEZIONATO Per passare all’articolo in attesa di configurazione o ritornare a quello precedente, usare i Tasti Previous e Next. ANNULLA MODIFICHE Verrà annullata l’ultima modifica ricaricando il record dal Database WEB. VERIFICA DISALLINEAMENTO All’apertura della procedura Inserisci/ Modifica Articolo, vengono effettuati controlli di allineamento degli articoli (Es. se tutti gli articoli WEB hanno l’IVA impostata, se l’aliquota corrisponde a quella dell’articolo Picam7 associato, ecc..). Eventuali anomalie vengono evidenziate con colorazione di riga diversa. Premere il pulsante Verifica disallineamento, per avere informazioni sull’errore riscontrato. 3.1.1 Elenco dei campi di sincronizzazione TIPO SYNC Tipo di sincronizzazione Articolo Può assumere i valori: - Picam : L’articolo WEB è stato creato partendo dall’anagrafica articoli di Picam7. - Internet: L’articolo esiste solo sul WEB Store. Un ordine WEB con questo articolo crea un ordine Picam7 il cui dettaglio è composto da un rigo libero + il prezzo dell’articolo WEB. Per questi articoli non viene gestito l’impegnato cliente. STATO: identifica lo stato del Trasferimento dell’Articolo: -- Non Assegnato -( Articolo selezionato pre-impostato con codice e descrizione articolo) Modificato ( Articolo caricato in maschera di configurazione con modifiche in corso) Confermato ( Articolo Modificato il cui salvataggio ha avuto esito positivo ) In Lista di Trasferimento ( Articolo Aggiunto in Lista di Sincronizzazione ) Sincronizzato ( Articolo la cui Sincronizzazione è andata a buon fine ) Eliminato ( Articolo la cui Eliminazione dal WEB è andata a buon fine ) Riscontrato conflitto ( Articolo Non configurato correttamente ) AZIONE DA COMPIERE -- Nessuna – Salva in locale Upload Elimina Download ( Salvataggio sul DB) ( In lista di sincronizzazione per Trasferimento ) ( In lista di sincronizzazione per Eliminazione ) ( Previsto ma non Utilizzato) Sostanzialmente quando si configura un nuovo articolo WEB o se ne richiamano altri in Modifica, vengono inseriti in una lista, indicando lo stato in cui sono e l’azione che si vuole compiere. Integrazione al Manuale Utente 29 e-Commerce 3.2 Importa Ordini / Sincronizza Dati La procedura in fase di apertura carica una lista degli ordini scaricati dal WEB Store, per i quali è stato creato un ordine Picam7, che risultano in fase di completamento. In base ai filtri sugli stati è possibile selezionare ordini in Corso ed ordini Evasi, per richiamarli in modifica. Le funzionalità disponibili sono quelle dei pulsanti in maschera. SCARICA ORDINE WEB Visualizza e scarica gli ordini WEB confermati. CREA ORDINI PICAM Crea gli ordini Picam7 a partire dagli ordini WEB selezionati. DETTAGLIO ORDINE WEB Visualizza il dettaglio dell’ordine WEB selezionato. ORDINE/PREVENTIVO PICAM Chiede conferma prima di richiamare in modifica l’ Ordine Picam7 associato all’ordine WEB selezionato. Integrazione al Manuale Utente 30 e-Commerce STAMPA ORDINE PICAM Richiama la maschera per stampare gli ordini Picam7 associati agli ordini WEB selezionati. AGGIORNA STATO DEGLI ORDINI In base alle operazioni di importazione o allo stato di completamento dell’ordine, aggiorna lo stato dell’ordine WEB in remoto e in Locale. Integrazione al Manuale Utente 31 e-Commerce DESCRIZIONE DELLA PAGINA DEI LOGS Eventuali errori che si possono generare nella comunicazione fra Picam7 ed il WEB Store vengono registrati in una tabella di LOG e caricati su richiesta. CANCELLA LOG Cancella tutta la tabella dei log registrati fino al momento della pressione del Pulsante. CARICA /RILEGGI LOG Popola la lista degli errori registrati dall’ultima cancellazione al momento della pressione del Pulsante. Integrazione al Manuale Utente 32 e-Commerce 4 Info sul Progetto nopCommerce (versione 2.65) nopCommerce è un carrello elettronico open-source basato sul framework Microsoft ASP.NET MVC. Durante lo sviluppo di nopCommerce sono state rilasciate più versioni. Quella attualmente supportata dal modulo e-Commerce è la 2.65. 4.1 Licenza La licenza di nopCommerce è consultabile al seguente indirizzo: http://opensource.org/licenses/GPL-3.0 E’ sostanzialmente una GPLv3 a cui si aggiunge l’obbligo della dicitura: “powered by nopCommerce’’ su ogni singola pagina ASP. È possibile eliminare la dicitura a pagamento, acquistando una nopCommerce copyright removal key sul sito. 4.2 Riferimenti Progetto open-source nopCommerce è ospitato su CodePlex: un sito di progetti open-source mantenuto da Microsoft. Il sito fornisce gli strumenti necessari per condividere codice e lavorare in maniera collaborativa con altri sviluppatori. E’ possibile effettuare il download della versione di nopCommerce (vers. 2.65) al seguente indirizzo: http://nopcommerce.codeplex.com/releases/view/90459 4.3 Browser Supportati Browser supportati: o Microsoft Internet Explorer 6 e superiori o Mozilla Firefox 2.0 e superiori o Google Chrome 1.x e superiori o Apple Safari 2.x 4.4 Strumenti di Sviluppo Strumenti IDE per la modifica del codice Sorgente: o MS Visual Studio 2012 (con MVC 4 installato) o superiore 4.5 Requisiti Tecnologici e di Sistema (versione 2.65) Per eseguire nopCommerce 2.65., si richiedono i seguenti prerequisiti di Sistema: Sistemi operativi supportati: o Windows 8 o Windows 7 o Windows Vista o Windows XP o Windows Server 2003 o Windows Server 2008 o Windows Server 2012 Integrazione al Manuale Utente 33 e-Commerce Web Server supportati: o Internet Information Service (IIS) 7.0 o superiore. ASP.NET 3.5/4.0 (MVC 3) Database supportati: o MS SQL Server 2005 o superiore. o MS SQL Server Compact 4.0 o superiore. Browser supportati: o Microsoft Internet Explorer 6 e superiori o Mozilla Firefox 2.0 e superiori o Google Chrome 1.x e al di sopra o Apple Safari 2.x Strumenti IDE per la modifica del codice Sorgente: o MS Visual Studio 2012 (con MVC 4 installato) o superiore Integrazione al Manuale Utente 34
© Copyright 2024 ExpyDoc
