Importazione Documenti da File (excel)
E’ possibile importare documenti in GL180 a partire da file
esterni di tipo xls e xml. Questa operazione deve essere eseguita da un utente
esperto utilizzando direttamente il DataBase poichè non esiste una interfaccia
apposita.
I documenti devono essere adeguatamente configurati:
causali, registri associati ecc.
Attenzione: i documenti privi di righe
non vengono importati.
Configurazione
L’importazione avviene tramite l’esecuzione di un processo
che ha come parametri:
1. La ditta
di esercizio(1, presa in automatico dall’utente);
2. Il
servizio (B2B, preso in automatico dall’utente);
3. La
tipologia utente (2 = Customer ,preso in automatico dall’utente);
4. La
visibilità di quel utente,cioè il codice cliente a cui esso è associato( presa
in automatico dall’utente);
5. Il tipo
documento(221, preso dalla tabella ecom_servizio nel campo t_documordine per
quel servizio);
6. Il file da
importare comprensivo di path(preso dal’interfaccia web)
Le informazioni necessarie sono contenute all’interno della
tabella impt_docconfig:
Nome campo
|
Descrizione
|
c_servizio
|
Codice Servizio da gestire
|
C_ditta
|
Codice ditta da gestire
|
T_docum
|
Tipo documento che può
essere importato
|
C_tipologia
|
Codice tipologia dell’utente
che richiede l’importazione(di solito 2=Customer )
|
C_visibilita
|
Codice cliente a cui è
associato un utente
|
D_adapterassembly
|
Nome della dll su cui si
trova la routine di conversione
|
D_adapterclass
|
Nome della classe della
routine di conversione
|
D_validatorassembly
|
Nome della dll su cui si
trova la routine di validazione
|
D_validatorclass
|
Nome della classe della
routine di validazione
|
Una volta reperita la configurazione corretta (tramite i
campi c_servizio,c_ditta,t_docum,c_tipologia,c_visibilita) il processo
utilizzerà le informazioni contenute nei campi d_adapterassembly, d_adapterclass,
d_validatorassembly, d_validatorclass per istanziare le opportune routine.
Prima viene effettuata un’operzione di conversione nel
formato desiderato(adapter) e poi i dati vengono validati secondo una serie di
regole(validator).
Per il momento sono disponibili le suguenti funzioni di
conversione:
d_adapterassembly
|
d_adapterclass
|
Default
|
Formato
|
Sipac.GL180.Bolc.BolcDocuments.dll
|
Sipac.GL180.Bolc.BolcDocumentsDomain.OrderCustomerImportFileAdapterFromExcel
|
no
|
.xls
|
Sipac.GL180.Bolc.BolcDocuments.dll
|
Sipac.GL180.Bolc.BolcDocumentsDomain. DefaultDocumentImportFileValidator
|
si
|
.xml
|
E le seguenti funzioni di validazione:
d_validatorassembly
|
d_validatorclass
|
Default
|
Sipac.GL180.Bolc.BolcDocuments.dll
|
Sipac.GL180.Bolc.BolcDocumentsDomain.OrderCustomerImportFileValidator
|
no
|
Sipac.GL180.Ecom.BackOfficeB2B.Bolc.dll
|
Sipac.GL180.Ecom.BackOfficeB2B.Bolc.B2BOrderCustomerImportFileValidator
|
no
|
Sipac.GL180.Bolc.BolcDocuments.dll
|
Sipac.GL180.Bolc.BolcDocumentsDomain
.DefaultDocumentImportFileValidator
|
si
|
Documents (Testate documento)
Nome campo
|
Descrizione
|
Tipologia
|
Obbligatorio
|
Valori
ammessi
|
|
DocID
|
Numero documento
|
Alfanumerico
|
SI
|
Max 8 caratteri
|
|
DocDate
|
Data documento
|
Data
|
SI
|
|
|
Branch
|
Codice branch / ufficio
|
Alfanumerico
|
NO
|
Tabella branch
|
|
CustomerID
|
Codice intestatario
|
Numerico
|
SI
|
|
|
|
Description1
|
Descrizione aggiuntiva ( prima parte)
|
Alfanumerico
|
NO
|
|
|
|
Description2
|
Descrizione aggiuntiva (seconda parte)
|
Alfanumerico
|
NO
|
|
|
DestID
|
Codice destinatario
|
Numerico
|
NO
|
|
|
DestType
|
Tipo indirizzo destinatario
|
Alfanumerico
|
NO
|
Tabella tipi indirizzi
|
|
DestAddress
|
Indirizzio destinatario
|
Alfanumerico
|
NO
|
|
|
DestZIP
|
Codice postale destinatario
|
Alfanumerico
|
NO
|
|
|
DestLocality
|
Loclità destinatario
|
Alfanumerico
|
NO
|
|
|
DestCity
|
Comune destinatario
|
Alfanumerico
|
NO
|
|
|
DestProvince
|
Provincia destinatario
|
Alfanumerico
|
NO
|
|
|
TransportModality
|
Modalità trasporto
|
|
NO
|
Tabella tipi modalità di trasporto
|
|
Language
|
Lingua documento
|
Numerico
|
SI
|
0=Nessuna(italiano default)
1=Inglese
2=Francese
3=Tedesco
4=Spagnolo
|
|
DestCountry
|
Paese destinatario
|
Alfanumerico
|
NO
|
|
|
|
DestNote
|
Note destinatario
|
Alfanumerico
|
NO
|
|
|
|
DocumentRows (Righe documento)
Nome campo
|
Descrizione
|
Tipologia
|
Obbligatorio
|
Valori
ammessi
|
|
DocID
|
Numero documento
|
Alfanumerico
|
SI
|
Max 8 caratteri
|
|
DocDate
|
Data documento
|
Data
|
SI
|
|
|
RowID
|
Numero riga
|
Numerico
|
SI
|
|
|
RowType
|
Tipo riga documento
|
Numerico
|
SI
|
0=Articolo
1=Art. Manuale
2=Perc. limitata
3=Descrittiva
4=Solo Importo
5=Riferimento
6=Omaggio
7=Perc. estesa
|
|
|
ItemCode
|
Codice articolo
|
Numerico
|
SI (Solo per RowType 0,1,2,4,6,7)
|
|
|
|
ItemVariant
|
Codice variante articolo
|
Alfanumerico
|
SI (Solo per RowType 0,6)
|
|
|
BarCode
|
Codice a barre articolo
|
Alfanumerico
|
NO
|
|
|
CustomerItemCode
|
Codice cliente articolo
|
Alfanumerico
|
NO
|
|
|
Description
|
Descrizione di riga
|
Alfanumerico
|
NO
|
|
|
Quantity
|
Quantità
|
Numerico
|
SI (Solo per RowType 0,1,2,4,6,7)
|
|
|
DeliveryDate
|
Data consegna
|
Data
|
NO
|
|
|
Note
|
Note
|
Alfanumerico
|
NO
|
|
|
Price
|
Prezzo
|
Numerico
|
SI (Solo per RowType 4)
|
|
|
DocumentNotess (Note documento)
Nome campo
|
Descrizione
|
Tipologia
|
Obbligatorio
|
Valori
ammessi
|
DocID
|
Numero documento
|
Alfanumerico
|
SI
|
Max 8 caratteri
|
DocDate
|
Data documento
|
Data
|
SI
|
|
NoteID
|
Codice nota
|
Numerico
|
SI
|
|
AdditionalNote
|
Descrizione nota
|
Alfanumerico
|
SI
|
|
Legame tra tabelle documenti
Il legame tra tabelle di un
documento è così rappresentato:

Le tabelle coinvolte per
l’importazione dei documenti hanno un unico legame rappresentato da DocID e
DocDate.
Importazione documenti (esempio Fattura)
Numero: 1524 - Data: 16/01/2013 - Codice cliente: 150
Righe documento:
riga 1
codice articolo: a1 - descrizione
riga: articolo a1 di prova
variante: 0
quantità: 15
prezzo: 10,25
riga 2
codice articolo: b1 - descrizione
riga: articolo b1 di prova
variante: 0
quantità: 22
prezzo: 5,45
riga 3
codice articolo: c1 - descrizione
riga: articolo c1 di prova
variante: 0
quantità: 26
prezzo: 30,18
Numero: 1525 - Data: 17/01/2013 - Codice cliente: 151
Righe documento:
riga 1
codice articolo: a1 - descrizione
riga: articolo a1 di prova
variante: 0
quantità: 15
prezzo: 10,25
riga 2
codice articolo: c1 - descrizione
riga: articolo c1 di prova
variante: 0
quantità: 28
prezzo: 34,15
Il foglio excel con le informazioni dei documenti deve
essere così compilato:
Tabella Documents:
OrderId
|
OrderDate
|
CustomerID
|
1524
|
16/01/2013
|
150
|
1525
|
17/01/2013
|
151
|
Tabella DocumentRows:
OrderId
|
OrderDate
|
RowsID
|
RowType
|
ItemCode
|
ItemVariant
|
Description
|
Quantity
|
Price
|
1524
|
16/01/2013
|
1
|
0
|
a1
|
0
|
articolo a1 di prova
|
15
|
10,25
|
1524
|
16/01/2013
|
2
|
0
|
b1
|
0
|
articolo b1 di prova
|
22
|
5,45
|
1524
|
16/01/2013
|
3
|
0
|
c1
|
0
|
articolo c1 di prova
|
26
|
30,18
|
1525
|
17/01/2013
|
1
|
0
|
a1
|
0
|
articolo a1 di prova
|
15
|
10,25
|
1525
|
17/01/2013
|
2
|
0
|
c1
|
0
|
articolo c1 di prova
|
28
|
34,15
|