Esprinet importazione catalogo: differenze tra le versioni

Da Dolibarr Wiki.
Vai alla navigazione Vai alla ricerca
VisualeWikitesto
Nessun oggetto della modifica
Nessun oggetto della modifica
 
(8 versioni intermedie di uno stesso utente non sono mostrate)
Riga 1: Riga 1:
<div style="text-align:center;"></div>
<div style="text-align:right;">'''Manuale utente rev. 1
<div style="text-align:right;"></div>


'''“Modulo Esprinet importazione catalogo”'''


<div style="text-align:right;"></div>
'''Versione del modulo: 2.0.0'''
<div style="text-align:right;">'''Manuale utente rev. 1'''</div>
<div style="text-align:right;">'''“Modulo Esprinet importazione catalogo”'''</div>
<div style="text-align:right;">[[Image:Immagine1.png]]</div>


<div style="text-align:right;"></div>
'''Versione di Dolibarr supportate: 12.0.x / 13.0.x'''
<div style="text-align:right;"></div>
<div style="text-align:right;"></div>
<div style="text-align:right;"></div>
<div style="text-align:right;">[[Image:Immagine2.png]]</div>
<div style="text-align:right;">'''Versione del modulo: 2.0.0'''</div>
<div style="text-align:right;">'''Versione di Dolibarr supportate: 12.0.x / 13.0.x'''</div>
<div style="text-align:right;">'''Data: 13 Luglio 2021'''</div>
<div style="text-align:right;">'''Autori: Diciannove Soc. Coop.'''</div>


<div style="text-align:right;"></div>
'''Data: 13 Luglio 2021'''
 
'''Autori: Diciannove Soc. Coop.'''</div>
<div style="text-align:right;">'''''https://shop.19.coop'''''</div>
<div style="text-align:right;">'''''https://shop.19.coop'''''</div>
<div style="text-align:center;"></div>
<div style="text-align:center;"></div>
<div style="text-align:center;"></div>
<div style="text-align:center;"></div>
<div style="text-align:center;"></div>
<div style="text-align:center;"></div>
'''Indice'''
{| style="border-spacing:0;width:17cm;"
|- style="border:none;padding:0cm;"
| align=center| '''1'''
||
|| '''Introduzione'''
|- style="border:none;padding:0cm;"
| align=center| '''2'''
||
|| '''Installazione del modulo in Dolibarr ERP&CRM'''
|- style="border:none;padding:0cm;"
| align=center| '''3'''
||
|| '''Configurazione del modulo'''
|- style="border:none;padding:0cm;"
| align=center| '''4'''
||
|| '''Esprinet importazione catalogo'''
|-
|}
= 1. Introduzione =
= 1. Introduzione =




Il modulo '''Esprinet importazione catalogo''' è il modulo sviluppato ad-hoc per Dolibarr ERP & CRM che consente l’importazione come prodotti predefiniti del catalogo “disponibilità prodotti” di Esprinet.
Il modulo '''Esprinet importazione catalogo''' è il modulo sviluppato ad-hoc per Dolibarr ERP & CRM che consente l’importazione come prodotti predefiniti del catalogo “disponibilità prodotti” di Esprinet.
 
<br
Il modulo prevede la possibilità di collegarsi al server di Esprinet tramite protocollo s/ftp e scaricare il file del catalogo aggiornato. Tale file viene messo a disposizione dai servizi Esprinet ogni 15 minuti.  
Il modulo prevede la possibilità di collegarsi al server di Esprinet tramite protocollo s/ftp e scaricare il file del catalogo aggiornato. Tale file viene messo a disposizione dai servizi Esprinet ogni 15 minuti.  


Riga 61: Riga 22:
= 2. Installazione del modulo in Dolibarr ERP&CRM =
= 2. Installazione del modulo in Dolibarr ERP&CRM =


<div style="color:#000000;">[[Image:Immagine3.png]]</div>
<div style="color:#000000;">[[File:Img1 ddt-italia manuale.png|346x346px]]</div>


<span style="color:#000000;">Una volta scaricato il pacchetto contenente il Modulo “</span><span style="color:#000000;">Esprinte importazione catalogo”</span><span style="color:#000000;">, il contenuto va copiato nella cartella “</span><span style="color:#000000;">''/custom”''</span><span style="color:#000000;"> all’interno della directory principale di Dolibarr ERP&CRM.</span>
<span style="color:#000000;">Una volta scaricato il pacchetto contenente il Modulo “</span><span style="color:#000000;">Esprinte importazione catalogo”</span><span style="color:#000000;">, il contenuto va copiato nella cartella “</span><span style="color:#000000;">''/custom”''</span><span style="color:#000000;"> all’interno della directory principale di Dolibarr ERP&CRM.</span>
Riga 68: Riga 29:




<div style="color:#000000;">{{clear}}
<div style="color:#000000;">{{clear}}</div>
[[Image:Immagine4.png|center]]</div>


'''Nota 1: '''dopo aver copiato il modulo nella cartella “''/custom”'', se esso non risulta ancora visibile nell’elenco dei moduli, è necessario attivare nel file di configurazione di Dolibarr ERP&CRM le due direttive seguenti:
'''Nota 1: '''dopo aver copiato il modulo nella cartella “''/custom”'', se esso non risulta ancora visibile nell’elenco dei moduli, è necessario attivare nel file di configurazione di Dolibarr ERP&CRM le due direttive seguenti:


<div style="text-align:center;">$dolibarr_main_url_root_alt </div>
<div style="text-align:center;">$dolibarr_main_url_root_alt
<div style="text-align:center;">$dolibarr_main_document_root_alt </div>
$dolibarr_main_document_root_alt  
 
</div>eliminando le “//” iniziali e compilando con il percorso corretto.
eliminando le “//” iniziali e compilando con il percorso corretto.


In un’installazione Dolibarr ERP&CRM eseguita a partire da files zip o tar.gz, il file di configurazione chiamato '''conf.php''' è all’interno della cartella ''htdocs/conf/.''  
In un’installazione Dolibarr ERP&CRM eseguita a partire da files zip o tar.gz, il file di configurazione chiamato '''conf.php''' è all’interno della cartella ''htdocs/conf/.''  
Riga 91: Riga 50:


{{clear}}
{{clear}}
[[Image:Immagine5.png|center]]
 
[[File:Img4 import esprinet catalogo manuale.png|1080x1080px]]


Per modificare questi parametri, premere il tasto “'''Modifica'''” in fondo alla pagina.
Per modificare questi parametri, premere il tasto “'''Modifica'''” in fondo alla pagina.
Riga 100: Riga 60:


{{clear}}
{{clear}}
[[Image:Immagine6.png|none]]
 
[[File:Img5 import esprinet catalogo manuale.png|1080x1080px]]


All’utente poi si possono assegnare anche i permessi specifici introdotti dal modulo:
All’utente poi si possono assegnare anche i permessi specifici introdotti dal modulo:


{{clear}}
{{clear}}
[[Image:Immagine7.png|center]]
 
[[File:Img6 import esprinet catalogo manuale.png|1080x1080px]]


Tutte le configurazioni dei vari parametri sono descritti in maniera puntuale.
Tutte le configurazioni dei vari parametri sono descritti in maniera puntuale.
Riga 131: Riga 93:
Di seguito le impostazioni di default per il client FTP di Esprinet:
Di seguito le impostazioni di default per il client FTP di Esprinet:


[[Image:Immagine8.png]]
[[File:Img7 import esprinet catalogo manuale.png|1080x1080px]]


'''N.B. '''Utente e Password vanno richiesti ad Esprinet. Il “Nome” può essere inserito a piacere, sarà l’opzione che viene presentata nelle impostazioni del modulo “Esprinet Importazione Catalogo” alla voce “<span style="color:#202020;">Connessione FTP per download file zip catalogo</span>”.
'''N.B. '''Utente e Password vanno richiesti ad Esprinet. Il “Nome” può essere inserito a piacere, sarà l’opzione che viene presentata nelle impostazioni del modulo “Esprinet Importazione Catalogo” alla voce “<span style="color:#202020;">Connessione FTP per download file zip catalogo</span>”.
Riga 141: Riga 103:


{{clear}}
{{clear}}
[[Image:Immagine9.png|center]]
 
[[File:Img8 import esprinet catalogo manuale.png]]


= <span style="color:#800000;">4. </span><span style="color:#800000;">Esprinet importazione catalogo</span> =
= <span style="color:#800000;">4. </span><span style="color:#800000;">Esprinet importazione catalogo</span> =
Riga 148: Riga 111:


{{clear}}
{{clear}}
[[Image:Immagine10.png|center]]
 
[[File:Img10 import esprinet catalogo manuale.png|1080x1080px]]


In alto sono presente le informazioni riguardanti la connessione FTP con il repository Esprinet e nell’elenco vengono presentati i file selezionabili per l’importazione. Dalla configurazione del modulo sappiamo che il file da selezionare è ''dispoP.xml.zip''.  
In alto sono presente le informazioni riguardanti la connessione FTP con il repository Esprinet e nell’elenco vengono presentati i file selezionabili per l’importazione. Dalla configurazione del modulo sappiamo che il file da selezionare è ''dispoP.xml.zip''.  
Riga 157: Riga 121:


{{clear}}
{{clear}}
[[Image:Immagine11.png|none]]
 
[[File:Img11 import esprinet catalogo manuale.png|1080x1080px]]


La seconda voce di menù laterale, “'''Files importati'''”, è il semplice log delle importazioni manuali ed automatiche effettuate con il modulo:
La seconda voce di menù laterale, “'''Files importati'''”, è il semplice log delle importazioni manuali ed automatiche effettuate con il modulo:


{{clear}}
{{clear}}
[[Image:Immagine12.png|none]]
 
[[File:Img12 import esprinet catalogo manuale.png|1080x1080px]]


Per effettuare la corretta importazione dei prodotti del catalogo Esprinet è necessario creare gli appositi extrafields della scheda prodotto:
Per effettuare la corretta importazione dei prodotti del catalogo Esprinet è necessario creare gli appositi extrafields della scheda prodotto:


{{clear}}
{{clear}}
[[Image:Immagine13.png|none]]
 
[[File:Img13 import esprinet catalogo manuale.png]]


Il modulo non aggiunge gli extrafields automaticamente e consente l’importazione anche se tali campi extrafields NON vengono inseriti.
Il modulo non aggiunge gli extrafields automaticamente e consente l’importazione anche se tali campi extrafields NON vengono inseriti.


{{clear}}
{{clear}}
[[Image:Immagine14.png|center]]
 
[[File:Img14 import esprinet catalogo manuale.png|1080x1080px]]


N.B. sono tutti di tipo Stringa
N.B. sono tutti di tipo Stringa
Riga 187: Riga 155:


* https://<URLDOLIBARR>/custom/esprinetcatalogimport/esprinetcatalogimportindex.php?cronjob=1&securitykey=<SECURITYKEYCRONJOB>&userlogin=<LOGINUTENTE>&action=importcatalog
* https://<URLDOLIBARR>/custom/esprinetcatalogimport/esprinetcatalogimportindex.php?cronjob=1&securitykey=<SECURITYKEYCRONJOB>&userlogin=<LOGINUTENTE>&action=importcatalog
[[Categoria:Moduli]]

Versione attuale delle 15:33, 5 apr 2024

Manuale utente rev. 1

“Modulo Esprinet importazione catalogo”

Versione del modulo: 2.0.0

Versione di Dolibarr supportate: 12.0.x / 13.0.x

Data: 13 Luglio 2021

Autori: Diciannove Soc. Coop.
https://shop.19.coop

1. Introduzione

Il modulo Esprinet importazione catalogo è il modulo sviluppato ad-hoc per Dolibarr ERP & CRM che consente l’importazione come prodotti predefiniti del catalogo “disponibilità prodotti” di Esprinet. <br Il modulo prevede la possibilità di collegarsi al server di Esprinet tramite protocollo s/ftp e scaricare il file del catalogo aggiornato. Tale file viene messo a disposizione dai servizi Esprinet ogni 15 minuti.

Tale operazione può essere effettuata automaticamente, tramite processo pianificato oppure manualmente.

2. Installazione del modulo in Dolibarr ERP&CRM

Una volta scaricato il pacchetto contenente il Modulo “Esprinte importazione catalogo”, il contenuto va copiato nella cartella “/custom” all’interno della directory principale di Dolibarr ERP&CRM.

Effettuata questa operazione il modulo va attivato dalla pagina Impostazioni → Moduli/Applicazioni.


Template:Clear

Nota 1: dopo aver copiato il modulo nella cartella “/custom”, se esso non risulta ancora visibile nell’elenco dei moduli, è necessario attivare nel file di configurazione di Dolibarr ERP&CRM le due direttive seguenti:

$dolibarr_main_url_root_alt

$dolibarr_main_document_root_alt

eliminando le “//” iniziali e compilando con il percorso corretto.

In un’installazione Dolibarr ERP&CRM eseguita a partire da files zip o tar.gz, il file di configurazione chiamato conf.php è all’interno della cartella htdocs/conf/.

Per ulteriori informazioni consultare il link: https://wiki.dolibarr.org/index.php/FAQ_Custom_module_install

Nota 2: è necessario effettuare il login al sistema con un account avente privilegi di “Super amministratore” per poter accedere alla pagina delle Impostazioni.

3. Configurazione del modulo

Una volta effettuato l’accesso con un account avente i privilegi di “Super Amministratore”, si accede al menù laterale “Impostazioni” e quindi “Moduli/Applicazioni”. Si scorre la pagina fino ad arrivare al modulo “Esprinet Importazione Catalogo” oppure si utilizza l’apposita funzione di ricerca in cima alla pagina.

Una volta attivato il modulo (pulsante toggle) si può accedere alla pagina di impostazioni (pulsante ingranaggio). La pagina di impostazioni del modulo è la seguente:

Template:Clear

Per modificare questi parametri, premere il tasto “Modifica” in fondo alla pagina.

Opzioni generali:

Il primo parametro da indicare è il login (username) di un utente del sistema, al quale andranno assegnati i privilegi per “eseguire i processi pianificati”.

Template:Clear

All’utente poi si possono assegnare anche i permessi specifici introdotti dal modulo:

Template:Clear

Tutte le configurazioni dei vari parametri sono descritti in maniera puntuale.

L’opzione “Effettua il backup del database prima dell'importazione del catalogo”, se attivata, effettuerà un backup di tutto il database prima di effettuare l’aggiornamento del catalogo. Si consiglia l’attivazione di questa opzione.

Le ultime due opzioni determinano se utilizzare una connessione via s/ftp per scaricare direttamente dal repository Esprinet il catalogo (versione più aggiornata) da importare in Dolibarr. Nell’ultima opzione “Connessione FTP per download file zip catalogo”, andrà selezionata quale connessione FTP, configurata nel modulo FTP (vedi procedura a seguire), utilizzare per il download del file DispoP contenente il catalogo.

Opzioni per processo pianificato (importazione tramite Cron Job automatico):

Queste opzioni verranno utilizzate dal processo pianificato. La prima opzione, se attivata, utilizzerà la stessa connessione indicata nella sezione precedente.

L’opzione “Percorso del file zip da prelevare rispetto la root del server FTP (es. "cartella1/cartella2/" oppure "/" per indicare la cartella root)” di default può essere lasciata vuota (equivale a “/”) così come la terza opzione “Nome del file zip da utilizzare per l'importazione automatica (es. dispoP.xml.zip)” è corretto inserire il valore di esempio dispoP.xml.zip (Consultare comunque Esprinet in caso di configurazioni particolari).

È possibile avviare manualmente il processo pianificato visitando il link “URL per controllare ed eseguire il processo di importazione catalogo in cron”

Opzioni invio notifica email:

Abilitando tramite la relativa opzione l’invio delle notifiche email, verrà inviata una email al termine della procedura di importazione del catalogo, con oggetto e testo definiti sempre in questa sezione, agli indirizzi indicati (indirizzi email da inserire separati da una virgola ‘,’ ).

Impostazioni modulo FTP client:

Le impostazioni dell’FTP vanno configurate nel relativo modulo core del gestionale dal quale si accede sempre da Home → Impostazioni → Moduli/Applicazioni.

Di seguito le impostazioni di default per il client FTP di Esprinet:

N.B. Utente e Password vanno richiesti ad Esprinet. Il “Nome” può essere inserito a piacere, sarà l’opzione che viene presentata nelle impostazioni del modulo “Esprinet Importazione Catalogo” alla voce “Connessione FTP per download file zip catalogo”.


NOTA: su pannello ISP CONFIG il cron job automatico per l’importazione del catalogo tutte le domeniche alle ore 3.00 è configurato nel seguente modo. Il comando lanciato per esteso:

https://dolibarr.19.coop/custom/esprinetcatalogimport/esprinetcatalogimportindex.php?cronjob=1&securitykey=SECURITYKEYCRONJOB&userlogin=esprinet&action=importcatalog

Template:Clear

Attivando il modulo, verranno inserite due nuove voci di menu laterale, all’interno del menù “Strumenti”. La prima voce, Esprinet importazione, consente di avviare l’importazione del catalogo manualmente. Se le impostazioni del modulo appena effettuate sono corrette, la pagina dovrebbe apparire in questo modo:

Template:Clear

In alto sono presente le informazioni riguardanti la connessione FTP con il repository Esprinet e nell’elenco vengono presentati i file selezionabili per l’importazione. Dalla configurazione del modulo sappiamo che il file da selezionare è dispoP.xml.zip.

Una volta selezionato uno o più files, comparirà il tasto “IMPORTA FILE IN LOCALE”.

Procedendo il file verrà scaricato in una cartella dei documenti di Dolibarr e sarà disponibile nella tabellina sottostante, pronto per essere importato:

Template:Clear

La seconda voce di menù laterale, “Files importati”, è il semplice log delle importazioni manuali ed automatiche effettuate con il modulo:

Template:Clear

Per effettuare la corretta importazione dei prodotti del catalogo Esprinet è necessario creare gli appositi extrafields della scheda prodotto:

Template:Clear

Il modulo non aggiunge gli extrafields automaticamente e consente l’importazione anche se tali campi extrafields NON vengono inseriti.

Template:Clear

N.B. sono tutti di tipo Stringa

Configuarzione Cron Job:
  1. tramite linea di comando:
  • php cron_esprinet_start.php <IDCRONESPRINET> <NOMEFILEZIP> <TYPE> <LANGS>
  • php cron_esprinet_start.php 13 dispoP.xml.zip automatic it_IT


  1. tramite invocazione pagina php:
  • https://<URLDOLIBARR>/custom/esprinetcatalogimport/esprinetcatalogimportindex.php?cronjob=1&securitykey=<SECURITYKEYCRONJOB>&userlogin=<LOGINUTENTE>&action=importcatalog
Estratto da "https://wiki.doliplatform.com/index.php?title=Esprinet_importazione_catalogo&oldid=159"