# embedding_metadata

key: chroma:document
string_value:
d’imposta) e del campo ( eventi eccezionali ) record E.  
 Eventi eccezionali  
La casella “Eventi eccezionali” deve essere compilata dal sostituto d’imposta che si avvale della 
sospensione del termine di presentazione della dichiarazione prevista al verificarsi di eventi eccezionali 
(è presente in diverse sezioni  del 770, ad esempio Record “E” e Record “H”).  
L’anno precedente erano previsti i valori 1, 3, e 7, quest’anno i seguenti:  
 1 - per i contribuenti vittime di richieste estorsive per i quali l’articolo 20, comma 2, della 
legge 23 febbraio 1999, n.44, ha di sposto la proroga di tre anni dei termini di scadenza degli 
adempimenti fiscali ricadenti entro un anno dalla  
data dell’evento lesivo;  
 3 - per i contribuenti, residenti alla data del 12 febbraio 2011 nel comune di Lampedusa e 
Linosa interessati dall’emer genza umanitaria legata all’afflusso di migranti dal Nord Africa, per i 
quali l’OPCM n. 3947 del 16 giugno 2011 ha previsto la sospensione dal 16 giugno 2011 al 30 
giugno 2012 dei termini relativi agli adempimenti ed ai versamenti tributari scadenti nel 
medesimo periodo; la sospensione è stata già prorogata fino al 1° dicembre 2012 dall’articolo 
23, comma 12 octies, del D.L. 6 luglio 2012, n. 95 convertito, con modificazioni, dalla L. 7 
agosto 2012, n.135, è stata nuovamente prorogata fino al 31 dicembre 20 13 dall’art.1, comma 
612, della L. 27 dicembre 2013, n.147;  
 4 - per i contribuenti colpiti da altri eventi eccezionali.  
  
Come da specifiche, tale informazione viene riportata nel record B:


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – R I T E N U T E  
I N O L T R O  T E L E M A T I C O  - 107  Record tipo "B"  
  
 
Specifiche record B – campo 12 –Eventi eccez ionali posizione 94  
  
Nel record E, prospetto ST, ‘Operazioni straordinarie e successioni’:  
  
Record tipo "E"  
Dati relativi ai prospetti ST del mod. 770/2014 semplificato  
  
 
Specifiche record E – campo ST001002  
  
Sono stati aggiunti ulteriori messaggi blo ccanti nel caso in cui le date delle eventuali 
variazioni della sede legale o della sede del domicilio fiscale siano inferiori al 01/01/2013.  
  
Di seguito un estratto delle specifiche tecniche (record B).  
Record tipo "B":  
  
 
Record B – campo 34 – posizion e 489 – data variazione sede legale  
  
 
Record B – campo 40 – posizione 581 – data variazione domicilio fiscale  
  
Il medesimo controllo è presente sul campo ‘Data variazione’, se viene compilata la parte relativa al 
Sostituto ‘Persona fisica’.  
Si visualizz erà il seguente messaggio:  
La data non può essere inferiore al 01 -01-2013.  
  
 
Record B – campo 32 – posizione 479 – data della variazione  
  
 Conferma  
Nel caso in cui non esista corrispondenza fra i dati da trasmettere con quelli risultanti dalla 
dichiarazione, occorre attivare questo check.  
 Forza editing  
Nel caso in cui si attivi tale check, risulterà editabile la sezione ‘Persone Fisiche’ se l’azienda 
contribuente è intestata ad una persona giuridica; viceversa, se l’azienda è intestata ad una persona


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – R I T E N U T E  
108  – IN O L T R O  T E L E M A T I C O  fisica, risulterà possibile compilare i campi della sezione ‘Altri Soggetti’.  
 Correttiva  
Occorre attivare tale check nell’ipotesi in cui il  sostituto d’imposta intenda rettificare o integrare un 
mod. 770/2004 SEMPLIFICATO già presentato, compilando una nuova dichiarazione, completa di 
tutte le sue parti.  
 Integrativa  
Scaduti i termini di presentazione della dichiarazione, il sostituto d’imp osta può rettificare o integrare 
la stessa presentando nei termini previsti una nuova dichiarazione completa di tutte le sue parti, per il 
periodo d’imposta cui si riferisce la dichiarazione; in tal caso, occorre attivare questo check.  
 Correttiva/integra tiva parziale  
Questo check è editabile solo attivando uno dei due check precedenti ‘Correttiva’ o ‘Integrativa’.  
  
Se il check “Dichiarazione correttiva/integrativa parziale” non viene attivato vengono trasmessi tutti i 
movimenti relativi al 2008.  
  
Se in vece viene attivato è possibile editare la combo box “Tipo operazione” e selezionare uno dei 
seguenti valori “ Aggiornamento”, “Inserimento”, “Cancellazione.  
  
ATTENZIONE I sostituti d’imposta che presentano il Mod. 770/SEMPLIFICATO, anche 
avvalendosi della  facoltà di suddividere il predetto modello, possono produrre la dichiarazione 
“correttiva nei termini” o quella “integrativa” mediante l’invio anche delle singole comunicazioni che 
si intendono integrare o rettificare. In tal caso barrare anche la casella  “Correttiva/Integrativa 
parziale”. Tale facoltà è consentita ai soli sostituti d’imposta che hanno presentato il Mod. 
770/SEMPLIFICATO contenente un numero di comunicazioni superiori a 200 (comunicazioni dati 
certificazioni lavoro dipendente assimilati ed  assistenza fiscale e/o comunicazioni dati certificazioni 
lavoro autonomo, provvigioni e redditi diversi).


key: chroma:document
string_value:
lavoro autonomo, provvigioni e redditi diversi).  
  
A questi scopo in caso di attivazione del check “Dichiarazione correttiva/integrale parziale” la 
procedura evidenzia il seguente messaggio di warn ing prima della generazione del file.  
“ Attenzione. La facoltà di presentare una dichiarazione integrativa/correttiva parziale ai soli sostituti 
d’imposta che hanno presentato il Mod. 770/Semplificato consente un numero di comunicazioni 
superiori a 200.”  
  
Un messaggio questa volta bloccante viene emesso se il check correttiva/integrativa parziale è attivo 
ma non vengono specificati nella scheda file telematico i campi relativi al protocollo della 
dichiarazione da sostituire.  
  
Comunicazione parziale in cui non è presente:  
 Identificativo assegnato dal telematico all’invio;  
 Progressivo dichiarante all’interno del file inviato;  
 Entrambi.  
 Tipo operazione  
Se il contribuente intende compilare una dichiarazione integrativa/correttiva, attivando i relativi check, 
sarà possi bile specificare in questa combo la tipologia di operazione da effettuare relativamente ai 
prospetti che si intende sostituire.  
  
Questa combo box permette di filtrare i movimenti da riportare nella dichiarazione.  
Nell’archivio movimenti ritenute abbiamo  visto che è stata inserita una combo box con gli stessi


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – R I T E N U T E  
I N O L T R O  T E L E M A T I C O  - 109  valori.  
  
In fase di generazione file, se la combo ‘Tipo operazione’ rimane impostato a ‘Nessuna’, viene dato 
un opportuno messaggio di avviso  
Inserire il tipo di operazione.  
  
La valorizzazione dell a combo Tipo Operazione determina la compilazione dei seguenti record:  
 Record E = dati relativi al prospetto ST campo 5 posizione 29  
 Record H = campo 5 posizione 29  
  
Persona fisica  
Se l’azienda contribuente è intestata ad una persona fisica, in questa  sezione verranno 
automaticamente proposti i dati anagrafici relativi al titolare in base a quanto indicato nell’archivio 
‘Dati Azienda’ – cartella ‘Titolari’.  
 Data di nascita  
Data di nascita del contribuente titolare dell’azienda. Campo obbligatorio.  
 Comune di nascita  
Comune di nascita del contribuente titolare dell’azienda. Campo obbligatorio.  
 Provincia di nascita  
Sigla della provincia del comune di nascita del contribuente titolare dell’azienda. Campo non 
obbligatorio.  
 Sesso  
Sesso del contribuent e persona fisica titolare dell’azienda.  
 Data variazione  
Data in cui è avvenuta l’eventuale variazione del comune di residenza anagrafica o del domicilio 
fiscale.  
Nel caso in cui le date delle eventuali variazioni della sede legale o della sede di domicil io fiscale siano 
inferiori al 01/01/2008, in base alle specifiche tecniche del tracciato 770/2009 viene visualizzato un 
messaggio di attenzione.  
La data non può essere inferiore al 01.01.2008.  
 Comune di residenza - Domicilio fiscale  
Comune di residenza a nagrafica o del domicilio fiscale del contribuente titolare dell’azienda. Campo 
obbligatorio.  
 Provincia  
Sigla della provincia del comune di residenza anagrafica o del domicilio fiscale del contribuente 
titolare dell’azienda. Campo non obbligatorio.  
 Codice Comune


key: chroma:document
string_value:
titolare dell’azienda. Campo non obbligatorio.  
 Codice Comune  
Il dato deve essere presente nella tabella Codici catastali comunali allegata al modello Unico PF.  
Nel caso in cui il campo codice comune non sia valorizzato in fase di generazione file viene dato il 
seguente messaggio bloccante: Manca codice C omune del domicilio fiscale del dichiarante.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – R I T E N U T E  
110  – IN O L T R O  T E L E M A T I C O   Indirizzo - Frazione - Via - Numero civico  
Indirizzo della residenza anagrafica o del domicilio fiscale del contribuente titolare dell’azienda. 
Risulta obbligatorio in fase di generazione del file, nel caso in cui il campo “Provincia comune di 
residenza”  assume il valore di una provincia italiana.  
 Cap 
C.A.P . del comune di residenza anagrafica o del domicilio fiscale del contribuente titolare dell’azienda.  
 Codice attività  
In questo campo è possibile indicare il codice attività rilevato dalla classifica zione delle attività 
economiche. Non è un campo obbligatorio.  
Dal 01/01/08 è stato modificato l’elenco dei codici attività portandoli a 6. Quindi il campo codice 
attività è stato esteso a 6 sia nella maschera di generazione che nella stampa del modello.  
E’ stato inserito anche un nuovo zoom dei codici attività alternative. L’utente ha la possibilità in 
questo modo di richiamare un codice alternativo direttamente dallo zoom oppure digitare a mano il 
codice attività.  
 Telefono  
Numero di telefono desunto dall’archivio ‘Dati Azienda’ – cartella ‘Titolari’.  
  
Altri soggetti  
 Sede Legale  
In questo campo è possibile indicare la data in cui è avvenuta la variazione della sede legale 
dell’azienda contribuente.  
Nel caso in c ui le date delle eventuali variazioni della sede legale o della sede del domicilio fiscale siano 
inferiori al 01/01/10, in base alle specifiche tecniche del tracciato 770/2010 viene visualizzato il 
seguente messaggio:  
La data non può essere inferiore al 01 .01.2010.  
 Comune - Sede legale  
Comune della sede legale dell’azienda contribuente. Viene proposto in automatico dalla procedura se 
si è specificata una sede legale con il relativo comune nell’archivio ‘Dati Azienda’ – cartella ‘Sedi’. E’ 
un campo obbligatorio.  
 Provincia


key: chroma:document
string_value:
un campo obbligatorio.  
 Provincia  
Provincia della sede legale dell’azienda contribuente. Viene proposta in automatico dalla procedura se 
si è specificata una sede legale con la relativa provincia nell’archivio ‘Dati Azienda’ – cartella ‘Sedi’.  
 Indirizzo - Frazione - Via - Numero  civico  
Indirizzo (frazione, via, numero civico) della sede legale dell’azienda contribuente. Viene proposto in 
automatico dalla procedura se si è specificata una sede legale con il relativo indirizzo nell’archivio ‘Dati 
Azienda’ – cartella ‘Sedi’. In fase  di generazione del file, viene richiesto obbligatoriamente se il campo 
“Provincia sede legale” assume il valore di una provincia italiana.  
 Cap 
C.A.P . della sede legale. Viene proposto in automatico dalla procedura se si è specificata una sede 
legale con il relativo C.A.P . nell’archivio ‘Dati Azienda’ – cartella ‘Sedi’.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – R I T E N U T E  
I N O L T R O  T E L E M A T I C O  - 111   Dom. fiscale  
In questo campo è possibile indicare la data in cui è avv enuta la variazione della sede legale 
dell’azienda contribuente.  
 Comune  
Comune del domicilio fiscale dell’azienda contribuente. Viene proposto in automatico dalla procedura 
se si è specificata una sede di domicilio fiscale con il relativo comune nell’arc hivio ‘Dati Azienda’ – 
cartella ‘Sedi’. Se assente, l’utente viene avvertito in fase di generazione del file di inserire tale dato 
obbligatoriamente, ma solo se è presente la sigla della provincia/C.A.P ./indirizzo del domicilio fiscale.  
 Provincia  
Provinc ia del domicilio fiscale dell’azienda contribuente. Viene proposto in automatico dalla 
procedura se si è specificata una sede di domicilio fiscale con la relativa provincia nell’archivio ‘Dati 
Azienda’ – cartella ‘Sedi’. Se assente, l’utente viene avvertit o in fase di generazione del file di inserire 
tale dato obbligatoriamente, nel caso in cui sia presente il comune/CAP/indirizzo del domicilio 
fiscale.  
 Cap 
C.A.P . del domicilio fiscale dell’azienda contribuente. Viene proposto in automatico dalla procedura se 
si è specificata una sede di domicilio fiscale con il relativo C.A.P . nell’archivio ‘Dati Azienda’ – cartella 
‘Sedi’.  
 Natura giuridica  
In questo  campo occorre indicare il codice statistico relativo alla natura giuridica dell’azienda 
contribuente, che è possibile rilevare dalla tabella SA.. E’ stata modificata (rispetto al modello 
770/2003) per poter inserire le nuove tipologie introdotte per la na tura giuridica consentendo 
l’inserimento anche delle tipologie 53. Nel caso in cui si inserisca un valore errato, la procedura lo 
segnala con un apposito messaggio.  
 Indirizzo - Frazione - Via - Numero civico  
Indirizzo del domicilio fiscale dell’azienda contribuente. Viene proposto in automatico dalla


key: chroma:document
string_value:
Indirizzo del domicilio fiscale dell’azienda contribuente. Viene proposto in automatico dalla 
procedura se si è specificata una sede di domicilio fiscale con il relativo indirizzo nell’archivio ‘Dati 
Azienda’ – cartella ‘Sedi’. Se è presente il comune/C.A.P ./sigla provincia del domicilio fiscale, tale 
campo risulta obbligatorio e viene segnalato in fase di generazione del file.  
 Codice attività  
In questo campo è possibile indicare il codice attività rilevato dal la classificazione delle attività 
economiche. Non è un campo obbligatorio.  
 Telefono  
Numero di telefono del domicilio fiscale dell’azienda contribuente. Viene proposto in automatico 
dalla procedura se si è specificata una sede di domicilio fiscale con il relativo numero telefonico 
nell’archivio ‘Dati Azienda’ – cartella.  
 Stato  
In questa combo è possibile specificare il codice statistico relativo alla stato dell’azienda al momento 
della presentazione della dichiarazione. I dati sono desunti dalla tabella  SA. 
 Situazione  
In questa combo è possibile specificare il codice statistico identificativo della situazione della società 
relativamente al periodo di imposta cui si riferisce la dichiarazione. Tali valori sono desunti dalla


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – R I T E N U T E  
112  – IN O L T R O  T E L E M A T I C O  tabella SC.  
 Codice fiscale del dicastero di appartenenza  
Le sole Amministrazioni dello Stato devono riportare il codice fiscale del dicastero di appartenenza.  
  
Le opzioni disponibili sono attualmente:  
1 - Per i contribuenti vittime di richieste estorsive per i quali l’articolo 20, comma 2, della legge 
23 febbraio 1999, n. 44, ha disposto la proroga di tre anni dei termini di scadenza degli 
adempimenti fiscali ricadenti entro un anno dalla data dell’evento lesivo;  
3 - Per i contribuenti, residenti alla data del 6 aprile 2009 nei comu ni colpiti dagli eventi sismici 
verificatisi in tale data nella regione Abruzzo, per i quali l’ordinanza ministeriale del 6 giugno 
2009, n. 3780 ha previsto la sospensione dal 6 aprile al 30 novembre 2009 dei termini relativi 
agli adempimenti e ai versamen ti tributari scadenti nel medesimo periodo. I termini sono stati 
prorogati al 30 giugno 2010 dall’ordinanza del Presidente del Consiglio dei Ministri 30 dicembre 
2009, n. 3837;  
5 - Per i contribuenti colpiti da altri eventi eccezionali. In caso di contempo ranea presenza di più 
situazioni riguardanti diversi eventi eccezionali, andrà indicato il codice dell’evento che prevede, 
per gli adempimenti fiscali, un periodo di sospensione più ampio.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – R I T E N U T E  
I N O L T R O  T E L E M A T I C O  - 113  Gen. file telematico 770/2014 - Rappresentante Firmatario  
  
 
Gen file telematico 770 2014 Rappresentante Firmatario  
  
In questa scheda devono essere inseriti i dati contenuti nel frontespizio del modello, relativi al 
rappresentante firmatario della dichiarazione  
 Forza editing  
Nel caso in cui si attivi tale check, risulterà editabile la sezione ‘Persone Fisiche’ se l’azienda 
contribuente è intestata ad una persona giuridica; viceversa, se l’azienda è intestata ad una persona 
fisica, risulterà possibile compilare i campi della sezione ‘Altri Soggetti’  
  
Dati relativi al rappresentante firmatario della Dichiarazione  
Nel caso di azienda persona giuridica, i campi di questa sezione risultano editabili ed occorre inserire 
obbligatoriamente almeno i seguenti dati:  
 Il codice fiscale del rappresentante firmatario;  
 Cognome;  
 Nome;  
 Sesso;  
 Data di nascita;  
 Comune di nascita.  
  
Nel caso in cui l’azienda sia invece intestata ad una persona fisica, i campi di questa sezione non sono 
editabili, a meno che non si attivi  il check “Forza Editing”.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – R I T E N U T E  
114  – IN O L T R O  T E L E M A T I C O   Codice fiscale  
In questo campo è possibile indicare il codice fiscale del soggetto che sottoscrive la dichiarazione. Se 
omesso, in fase di generazione del file viene indicato come campo obbligatorio se l’azienda è intestata 
ad una persona giuridica.  
 Codice carica  
Codice carica del soggetto che sottoscrive la dichiarazione. Viene proposto in automatico dalla 
procedura il codice carica del soggetto delegato alla presentazione della dichiarazione Iva indicato 
nell’archivio ‘Dati Azienda’ – ‘Dati Iva’. Se omesso, in fase di generazione del file viene indicato come 
campo obbligatorio, se l’azienda è intestata ad una persona giuridica.  
 Cognome  
Cognome del soggetto che sottoscrive la dichiarazione. Se omesso, in fase di generazione  del file viene 
indicato come campo obbligatorio, se l’azienda è intestata ad una persona giuridica.  
 Nome  
Nome del soggetto che sottoscrive la dichiarazione. Se omesso, in fase di generazione del file viene 
indicato come campo obbligatorio, se l’azienda è intestata ad una persona giuridica.  
 Sesso  
Sesso del soggetto che sottoscrive la dichiarazione. Se omesso, in fase di generazione del file viene 
indicato come campo obbligatorio, se l’azienda è intestata ad una persona giuridica.  
 Data di nascita  
Data di nascita del soggetto che sottoscrive la dichiarazione. Se omessa, in fase di generazione del file 
viene indicato come campo obbligatorio, se l’azienda è intestata ad una persona giuridica.  
 Comune di Nascita  
Comune di nascita del soggetto che sottoscri ve la dichiarazione. Se omesso, in fase di generazione del 
file viene indicato come campo obbligatorio, se l’azienda è intestata ad una persona giuridica.  
 Provincia  
Provincia del comune di nascita del soggetto che sottoscrive la dichiarazione.  
 Indirizz o estero


key: chroma:document
string_value:
 Indirizz o estero  
Indirizzo del comune di residenza anagrafica o domicilio fiscale del soggetto che sottoscrive la 
dichiarazione.  
  
Redazione della dichiarazione  
Il riquadro ”Redazione della dichiarazione”, posto nella seconda facciata del frontespizio del Mod. 
770/2010, è composto da quattro sezioni che devono essere alternativamente utilizzate a seconda 
della modalità di presentazione prescelta:  
 La sezione I è riservata ai sostituti d’imposta che intendano procedere alla trasmissione 
integrale del Mod. 770/2010 SEMPLIFICATO (Frontespizio, Comunicazioni dati lavoro 
dipendente ed assimilati e/o comunicazioni dati lavoro autonomo, provvigioni e red diti diversi, 
prospetti ST ed SX).  
 La sezione II deve essere compilata dai sostituti d’imposta che procedono alla trasmissione del 
Mod. 770/2010 SEMPLIFICATO, con successivo inoltro dei prospetti ST ed SX nell’ambito 
del Mod. 770/2010 ORDINARIO.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – R I T E N U T E  
I N O L T R O  T E L E M A T I C O  - 115   La sez ione III deve essere compilata dai sostituti d’imposta che intendano separare il Mod. 
770/2010 SEMPLIFICATO ed inviare, con il frontespizio, le sole comunicazioni relative a 
certificazioni lavoro dipendente ed assimilati ed i relativi prospetti ST ed SX. ( non gestibile 
tramite ad hoc)  
 La sezione IV deve essere compilata dai sostituti d’imposta che intendano separare il Mod. 
770/2010 SEMPLIFICATO ed inviare, con il frontespizio, le sole comunicazioni relative a 
certificazioni lavoro autonomo, provvigioni e redditi diversi ed i relativi  prospetti ST ed SX.  
 Casi di non trasmissione dei prospetti ST, SV e/o SX  
La comobox “Casi di non trasmissione dei prospetti ST, SV e/o SX” presente in questa sezione deve 
essere compilato per  
indicare le situazioni nelle quali il sostituto può non alleg are i prospetti ST, SV e/o SX al modello 770 
Semplificato. In particolare indicare:  
 1 - nel caso di amministrazioni dello Stato, comprese quelle con ordinamento autonomo 
(non obbligate alla compilazione dei prospetti ST, SV e SX);  
 2 - nel caso di sosti tuto che non abbia operato ritenute relative al periodo d’imposta 2013 
(non obbligato alla compilazione dei prospetti ST e SV).  
  
Come da specifiche tale informazione viene riportata nel record B al campo 110  
  
 
La scelta dell’opzione 1 o 2 nella combo de termina l’ineditabilità del prospetto ST, SV e SX nelle varie 
sezioni  
  
La procedura, nella maschera relativa alle stampe ministeriali dei quadri SS, ST e H, di default ne seleziona 
sempre i corrispondenti flag a prescindere da quando definito nella sezion e Redazione della dichiarazione della 
scheda Rappresentante Firmatario.  
  
 Casella SS  
Flag con label “SS” per le diverse sezioni I, II, III IV con funzionamento simile ai già presenti flag


key: chroma:document
string_value:
“ST” e “SX”. Il flag deve essere riportato sia a livello di tracci ato nel record B nel campo 77 (sezione 
I); sia nella stampa ministeriale del modello 770/2008.  
 Casella ST  
Se vengono inviati prospetti ST (ritenute operate e versamenti eseguiti) unitamente al modello che si 
invia, occorre barrare tale casella. Il Prospe tto ST contiene i dati relativi alle ritenute alla fonte operate, 
alle trattenute di addizionali regionale e comunale all’Irpef, alle trattenute per assistenza fiscale e ad 
alcune imposte sostitutive.  
 Casella SV  
Il Prospetto SV contiene i dati relativi a lle trattenute di addizionali comunali all’Irpef e alle trattenute 
per assistenza fiscale: in Ad hoc non sono presenti questi dati (sono riferibili unicamente a ritenute 
operate a dipendenti )e quindi questo prospetto di fatto non verrà mai generato.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – R I T E N U T E  
116  – IN O L T R O  T E L E M A T I C O  Nel c aso in cui tale check venga attivato, il campo 80 (casella SV) del record B alla posizione 816 
risulterà valorizzato a 1. Di conseguenza, risulterà barrata la corrispondente casella all’interno della 
stampa fiscale in formato ‘pdf’.  
 Casella SX  
Se vengono inviati prospetti SX (riepilogo delle compensazioni) unitamente al modello che si invia, 
occorre barrare tale casella. Il Prospetto SX deve essere redatto per indicare i dati relativi alle 
compensazioni effettuate ai sensi del D.P .R . n. 445 del 1997 e ai sensi dell’art. 17 del D.Lgs. n. 241 del 
1997.  
 Casella SY  
E’ stata inserita la casella di selezione del nuovo prospetto SY nella sezione I -II-IV; 
il prospetto SY non è gestito dalla procedura  
 770 Ordinario  
Nel caso di successivo invio del Mod. 770/2009 ORDINARIO deve essere attivato questo check.  
 Codice fiscale del soggetto che presenta la parte restante della 
dichiarazione  
Nel caso in cui l’invio della sezione IV venga effettuato separatamente dallo stesso sostituto 
d’imposta, questi dovrà annotare il proprio codice fiscale in entrambi gli invii.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – R I T E N U T E  
I N O L T R O  T E L E M A T I C O  - 117  Gen. file telematico 770/2014 - Firma / imp. trasmis.  
  
 
Gen file telematico 770 2014 Firma imp trasmis  
  
In questa scheda devono essere inseriti i dati contenuti nel frontespizio d el modello, relativi alla firma 
della dichiarazione e all’impegno alla presentazione telematica  
  
Firma della dichiarazione  
La dichiarazione deve essere sottoscritta dal dichiarante o da chi ne ha la rappresentanza legale, 
negoziale o di fatto. La dichiara zione deve essere sottoscritta anche dal soggetto che effettua il 
controllo contabile dichiarando anche il proprio codice fiscale.  
 Firma dichiarante  
Se attivo, la sottoscrizione è apposta dal dichiarante o da chi ne ha la rappresentanza legale, negoziale  
o di fatto.  
 Attestazione  
Attivabile da parte dei soggetti che esercitano il controllo qualora sottoscrivano la presente 
dichiarazione.  
  
Risulta attivabile solo se valorizzato almeno un soggetto, nei campi a seguire.  
Come da specifiche, la casella risul ta così definita:


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – R I T E N U T E  
118  – IN O L T R O  T E L E M A T I C O  
 
Record B – casella Attestazione  
  
 Situazioni particolari  
Codici situazioni particolari  
 Soggetto  
Soggetto, Codice fiscale e Firma vengono ripetute 5 volte  
 0 – Nessuno: impostando su questa dicitura, il campo codice fiscale  e il flag Firma non 
possono essere valorizzati.  
 1 -  Revisore contabile: impostando su questa dicitura il campo codice fiscale diventa 
obbligatorio e viene valorizzato di default il flag firma.  
 2 - Responsabile della revisione: impostando su questa dicitura  il campo codice fiscale 
diventa obbligatorio e viene valorizzato di default il flag firma.  
 3 - Società di revisione: impostando su questa dicitura il campo codice fiscale diventa 
obbligatorio e il flag firma non è valorizzato (dalle specifiche il flag f irma è un dato obbligatorio 
se il campo soggetto assume valore diversi da 3 – Società di revisione).  
 4 - Collegio sindacale:  impostando su questa dicitura il campo codice fiscale diventa 
obbligatorio e viene valorizzato di default il flag firma.  
  
Avviso  telematico  
 Invio avviso telematico all’intermediario  
Tale check è editabile se il la combo box “Impegno a trasmettere in via telematica la dichiarazione” 
viene valorizzata.”  
Tale check non deve essere impostato in assenza della sezione “impegno alla tra smissione”.Infatti di 
default è disabilitato.  
  
Impegno alla presentazione telematica  
Il riquadro deve essere compilato e sottoscritto dall’intermediario che presenta la dichiarazione in via 
telematica.  
L’intermediario deve riportare:  
 - Il proprio codice  fiscale;  
 - Se si tratta di CAF, il proprio numero di iscrizione all’albo;  
 - La data (giorno, mese e anno) di assunzione dell’impegno a presentare la dichiarazione;  
 - La firma  
 Numero iscrizione albo del C.A.F .  
Nel caso in cui la trasmissione della dichiarazione venga effettuata da un intermediario abilitato, è


key: chroma:document
string_value:
possibile indicare in questo campo il numero di iscrizione all’albo del C.A.F .  
 Data dell’impegno da trasmettere  
Nel caso in cui la trasmissione della dichiarazione venga effettuata da un int ermediario abilitato, è 
possibile indicare in questo campo la data di accettazione dell’incarico.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – R I T E N U T E  
I N O L T R O  T E L E M A T I C O  - 119   Codice fiscale intermediario  
In questo campo deve essere indicato il codice fiscale del soggetto intermediario che presenta la 
dichiarazione in via telemati ca. 
 Impegno a trasmettere in via telematica la dichiarazione  
Nella casella “impegno a presentare in via telematica la dichiarazione” del 770, deve essere indicato il 
codice 1 se la dichiarazione è stata predisposta dal contribuente ovvero il codice 2 se la dichiarazione è 
stata predisposta da chi effettua l’invio. La combo box consente di definire il soggetto che ha 
predisposto la dichiarazione: contribuente o intermediario.  
 Firma intermediario  
Se attivo, la dichiarazione è stata sottoscritta dall’inte rmediario abilitato.  
 Ricezione avviso telematico  
Questo flag è editabile solo in presenza del flag “invio avviso telematico all’intermediario”.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – R I T E N U T E  
120  – IN O L T R O  T E L E M A T I C O  Gen. file telematico 770/2014 - Fornitore file  
  
 
Gen file telematico 770 2014 Fornitore file  
  
In questa  scheda occorre indicare il tipo di fornitore del file, eventualmente i dati del fornitore 
persona fisica od altri soggetti ed alcuni dati relativi al visto di conformità.  
 Tipo fornitore  
In questa combo è possibile specificare il codice tipologia fornito re del file.  
 01: soggetti che scelgono di trasmettere direttamente la dichiarazione avvalendosi del servizio 
telematico Internet  
 06: presentazione tramite Amministrazione dello Stato  
 10: presentazione tramite C.A.F dip e pens C.A.F imp art3 c 2 altri  int 
  
Persona fisica  
Se si seleziona la tipologia 01 o 02, vengono proposti in automatico dalla procedura i dati anagrafici 
dell’azienda nella sezione ‘Persona Fisica’ se l’azienda è intestata ad una persona fisica. I campi 
presenti in questa sezione acco lgono i medesimi dati presenti nella cartella ‘Persone Fisiche/Altri 
Soggetti’ contenuti all’interno della sezione ‘Persona Fisica’.  
  
Altri soggetti  
Se si seleziona la tipologia 01 o 02, vengono proposti in automatico dalla procedura i dati anagrafici 
dell’azienda nella sezione ‘Altri soggetti’ se l’azienda è intestata ad una persona giuridica. I campi


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – R I T E N U T E  
I N O L T R O  T E L E M A T I C O  - 121  presenti in questa sezione accolgono i medesimi dati presenti nella cartella ‘Persone Fisiche/Altri 
Soggetti’ contenuti all’interno della sezione ‘Altri Sog getti’.  
  
Visto di conformità  
 Tipologia  
Questa combo box indica il soggetto che rilascia il visto di conformità. Può far riferimento al 
responsabile del CAF oppure il professionista  
 Codice fiscale del responsabile del Caf  o professionista  
Se la trasmissione viene effettuata da un i ntermediario abilitato, in questo campo è possibile indicare il 
codice fiscale del responsabile dell’ufficio del C.A.F . o del professionista di cui ci si è avvalsi.  
 Flag firma del riquadro del CAF di conformità  
Tal check deve essere attivato nel caso in cui si appone il visto di conformità ai sensi dell’art. 35 del 
D.Lgs. 9 luglio 1997, n. 241.  
 Codice fiscale del CAF  
E’ stato inserito nuovo campo Codice Fiscale del CAF che compare solo nel caso in cui la 
tipologia=CAF  
  
Non è gestito il controllo di obb ligatorietà sul campo 133 -record B (Codice fiscale del CAF) se è 
presente il campo 132 - record B ( Codice Fiscale del responsabile del C.A.F)


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – R I T E N U T E  
122  – IN O L T R O  T E L E M A T I C O  Gen. file telematico 770/2014 - File telematico  
  
 
Gen file telematico 770 2014 - File telematico  
  
In questa scheda si indicano il periodo di selezione dati per la generazione, la cartella di generazione 
del file, eventualmente i progressivi del modulo in caso di dichiarazioni correttive o integrative.  
  
Parametri di selezione  
Sono state adeguate le date di selez ione: 01/01/2013 – 31/12/2013.  
Nel caso in cui tale intervallo venga modificato indicando un anno solare diverso dal 2013, la 
procedura visualizza un apposito messaggio di avviso bloccante:  
La data iniziale è maggiore della data finale o fuori periodo.  
  
Si ricorda che la possibilità di generazione file tematico 770/2013 è subordinata all’installazione dei 
moduli telematici ridotto o base o esteso nella chiave di attivazione.  
  
Se invii telematici non abilitati, il bottone ok è ineditabile.  
 Directory  
Mediante il bottone è possibile specificare la directory in cui si intende collocare il file telematico. La 
procedura propone di default la directory EXE della cartella dell’installazione di Ad Hoc.  
 Nome del file  
Il nome del file telematico è  proposto dalla procedura e strutturato in base all’ora, minuti, secondi in


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – R I T E N U T E  
I N O L T R O  T E L E M A T I C O  - 123  cui è avvenuta la generazione.  
E’ stato adeguato il nome del file da generare:nomefile_77S14.77S.  
  
Si ricorda che prima di procedere alla generazione del file occorre utilizzare l a procedura di aggiornamento 
movimenti di ritenute in modo da aver valorizzato correttamente il dato nei movimenti di ritenute versati. Il campo 
può accogliere il valore 1, 2 o 3 ed  è obbligatorio nel caso in cui sul movimento ritenute sia valorizzato il campo 
“Somme non soggette” (sezione IRPEF e non INPS/Previdenziali).  
Per i fornitori pregressi il default della combo è nessuno, mentre per i dati ritenute (primanota e ciclo acquisti) e sui 
movimenti ritenute operate il valore è blank.  
  
Protocollo telem atico della dichiarazione da sostituire  
 Identificativo assegnato dal servizio telematico dell’invio  
Se la dichiarazione correttiva nei termini o integrativa avvengono mediante la presentazione delle 
singole certificazioni e/o dei singoli prospetti ST ed SX che il contribuente intende sostituir e, tale 
campo risulta editabile ed obbligatorio. In tal caso, occorre indicare il numero identificativo assegnato 
dal Servizio Telematico per la dichiarazione già trasmessa per la quale si è reso necessario il nuovo 
invio (dato desumibile dalla ricevuta ri lasciata dal Servizio Telematico).  
 Progressivo dichiarazione all’interno del file inviato  
Se la dichiarazione correttiva nei termini o integrativa avvengono mediante la presentazione delle 
singole certificazioni e/o dei singoli prospetti ST ed SX che il contribuente intende sostituire, ta le 
campo risulta editabile ed obbligatorio. In tal caso, occorre indicare il numero progressivo della 
dichiarazione da rettificare all’interno del file.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – R I T E N U T E  
124  – IN O L T R O  T E L E M A T I C O   Gen. file anni precedenti  
  
Elenco delle maschere per il calcolo del file telematico degli anni preceden ti 
 Gen. file telematico 770/2005  
 Gen. file telematico 770/2006  
 Gen. file telematico 770/2007  
 Gen. file telematico 770/2008  
 Gen. file telematico 770/2009  
 Gen. file telematico 770/2010  
 Gen. file telematico 770/2011  
 Gen. file telematico 770/2012  
 Gen. file telematico 770/2013


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – R I T E N U T E  
I N O L T R O  T E L E M A T I C O  - 125   Aggiornamento 
intestatari/movimenti ritenute  
  
Dato un intervallo di date la funzionalità aggiornamento movimenti ritenute è possibile effettuare una 
ricerca sui movimenti ritenuta già abbinati a distinte IRPEF versate; successivamente è data facoltà di 
selezionare uno o più movimenti ritenuta per i quali necessita effettuare la modifica del tipo 
operazione.  
  
 
Aggiornamento intestatari movimenti ritenute  
  
 Aggiornamento intestatari  
Questa combo box permettere l'aggiornamento dell'anagrafica fornitori e dei movimenti di ritenute in 
modo tale da poter attribuire uno dei possibili valori al campo codice somme non soggette. Infatti per 
i fornitori pregressi il  default della combo è nessuno, mentre è blank nei movimenti ritenute  
 Intestatari: con questa opzione è possibile effettuare l’aggiornamento delle anagrafiche 
intestatari, con riguardo al codice somme non soggette.  
Vengono visualizzati i filtri “Da perc ipiente” “ A percipiente” in cui è possibile effettuare una 
selezione per i fornitori soggetti a ritenute.  
La combo box Codice somme non soggette proposto di default è il 3. Premendo ricerca 
vengono visualizzati tutti i fornitori soggetti a ritenute con la  relativa valorizzazione del codice 
somme non soggette presente in anagrafica.  
Selezionando il/i fornitori da modificare è possibile, premendo modifica, aggiornare 
l’anagrafica.  
 Codice somme non soggette: da questa voce è possibile aggiornare sui movimenti ritenute, il


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – R I T E N U T E  
126  – IN O L T R O  T E L E M A T I C O  codice somme non soggette. Il seguente aggiornamento risulta utile per la corretta 
valorizzazione del dato sui movimenti ritenute caricati nel gestionale prima de ll’installazione 
della fast patch e che, in presenza di somme non soggette, presentano la combo box “Codice 
somme non soggette” valorizzata a blank.  
Prima della generazione del file occorre quindi verificare la corretta valorizzazione del codice 
somme non soggette in quanto la presenza del valore “Codice” viene richiesta come dato 
obbligatorio nel file ( compilazione record H) , qualora sia valorizzato il campo “ Altre somme 
non soggette”.  
  
 
Aggiornamento codice somme non soggette  
  
I movimenti ritenute ch e devono essere filtrati sono quelli che presentano  somme non soggette con 
la possibilità tuttavia di  visualizzare anche gli altri movimenti attivando il flag ‘Visualizza tutti i 
movimenti. L'aggiornamento è  possibile solo quando sono visualizzati i sol i movimenti con somme 
non soggette diverse da zero.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – R I T E N U T E  
I N O L T R O  T E L E M A T I C O  - 127  
 
Aggiornamento codice somme non soggette con flag visualizza tutti i movimenti  
  
Inoltre è possibile filtrare i movimenti da “da data registrazione”… “a data registrazione” , “Da 
percipiente” a “Percip iente” e di questi filtrare anche per codice somme non soggette.  
L'aggiornamento del dato è possibile solo quando sono visualizzati i soli movimenti con somme 
non soggette diverse da zero.  
Una volta selezionati i movimenti da aggiornare ed il codice da at tribuire, premendo modifica 
sarà possibile aggiornare i dati pregressi.  
  
 
Aggiornamento dati eseguito


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – R I T E N U T E  
128  – IN O L T R O  T E L E M A T I C O  Questa procedura di aggiornamento deve essere utilizzata prima della generazione del file del 770/2013 in modo 
da aver valorizzato correttamente il da to nei movimenti di ritenute versati. Il campo può accogliere il valore 1, 2 o 3 
ed  è obbligatorio nel caso in cui sul movimento ritenute sia valorizzato il campo “Somme non soggette” (sezione 
IRPEF e non INPS/Previdenziali).  
  
 Tipo operazione  
  
Premend o quindi il bottone ‘Modifica’, il tipo di operazione prescelto verrà automaticamente 
assegnato ai movimenti ritenuta selezionati nello zoom.  
  
Verrà visualizzato un messaggio di aggiornamento completato


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – R I T E N U T E  
I N O L T R O  T E L E M A T I C O  - 129   Compilazi one GLA  
  
La circolare INPS n. 16 del 24 gennaio 2001 ha modificato il modello GLA/D. Il nuovo modello, 
denominato GLA, è un'unica denuncia annuale che riassume le precedenti quattro denunce trimestrali 
e che nell'impostazione e nei contenuti tiene conto s ia dell'esigenza manifestata dai rappresentanti dei 
committenti, volta a snellire le procedure finora esistenti, sia della necessità di agevolare l'acquisizione 
dei dati, da parte dell'Istituto, finalizzata al puntuale aggiornamento delle posizioni assicur ative.  
  
L'inoltro telematico di questa denuncia deve avvenire entro il 30 aprile dell'anno successivo a quello di 
effettuazione delle collaborazioni. Per l'anno 2001 il termine è stato prorogato al 30 giugno 2001. Nel 
caso in cui un committente cessi i ra pporti di collaborazione durante l'anno è comunque tenuto a 
presentare la denuncia annuale secondo la scadenza sopra indicata.  
  
Non devono essere riportate nel nuovo modello i dati già denunciati con il modello GLA/D del primo trimestre 
2000. Tali dati an dranno indicati, invece, solo nel caso in cui il committente non abbia presentato il GLA/D 
relativo al primo trimestre, o nel caso in cui l'abbia fatto, via abbia riscontrato errori od omissioni.  
  
Compilazione GLA - Compilazione GLA  
  
Di seguito riportiam o la maschera per la Compilazione GLA.  
  
 
Compilazione GLA  
  
 Anno corresponsione compenso  
È necessario specificare l'anno per il quale si sono operate ritenute INPS.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – R I T E N U T E  
130  – IN O L T R O  T E L E M A T I C O   Codice Istat attività svolta  
Codice ISTAT dell'attività svolta, da inserire nei casi in cui il committente ne sia in possesso.  
 Codice Istat seconda attività svolta  
Codice ISTAT dell'eventuale seconda attività cui si riferisce la denuncia.  
 Tipo denuncia  
Il tipo di denuncia può essere Principale o Sostitutivo:  
 Principale se si tratta d i una denuncia principale  
 Sostitutivo se si tratta di sostituzione di una precedente denuncia errata (ad es. nell'aliquota) o 
incompleta (ad es. mancata denuncia di un collaboratore). La denuncia individuata con la lettera 
S annulla completamente quella precedente presentata, pertanto deve essere completa di tutti i 
dati, anche quelli che erano corretti già nella prima denuncia.  
 Nome file  
In questo campo è possibile specificare la cartella ed il nome del file ASCII da generare attraverso la 
compilazione  del GLA.  
All'interno di questa maschera è possibile inserire i dati relativi all'utente per la compilazione del GLA 
(questi dati vengono utilizzati per la compilazione del record GS Dati utente).  
  
Compilazione GLA - Dati utente  
  
Occorre compilare: la ra gione sociale dell'utente, il codice fiscale o partita Iva dell'utente, il Cognome 
e nome della persona di riferimento, il numero telefono di riferimento e l'indirizzo e -mail. 
  
 
Compilazione GLA - Dati utente


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – R I T E N U T E  
I N O L T R O  T E L E M A T I C O  - 131  
 
________________________________________ ________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
_____________________________________________________ ___________________________  
________________________________________________________________________________  
________________________________________________________________________________  
__________________________________________________________________ ______________  
________________________________________________________________________________  
________________________________________________________________________________  
_______________________________________________________________________________ _ 
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
___________ _____________________________________________________________________  
___________ _____________________________________________________________________  
________________________________________________________________________________


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – R I T E N U T E  
132  – IN O L T R O  T E L E M A T I C O  
 
________________________________________ ________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
_____________________________________________________ ___________________________  
________________________________________________________________________________  
________________________________________________________________________________  
__________________________________________________________________ ______________  
________________________________________________________________________________  
________________________________________________________________________________  
_______________________________________________________________________________ _ 
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
___________ _____________________________________________________________________  
________________________________________________________________________________  
_______________________________________________________________________________


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – R I T E N U T E  
STA M P E  - 133   STAMPE  
 
Abbiamo riepilogato in questo capitolo una serie di stampe relative alla gestione delle ritenute. 
Troviamo le Certificazioni, i Compensi Pagati, i Versamenti IRPEF e dei Contributi Previdenziali ed 
alcuni prospetti per facilitare la compilaz ione del modello 770 (o della corrispondente sezione del 
modello UNICO).  
  
 
Menù Stampe Ritenute  
  
 Stampa certificazioni  
 Stampa compensi  pagati  
 Stampa versamenti irpef  
 Stampa versamenti previdenziali  
 Stampa riepi logo ritenute alla fonte


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – R I T E N U T E  
134  – S T A M P E   Stampa elenco agenti  
 Stampa elenco altri percipienti  
 Stampa ritenute subite  
 Stampe 770 pregresse  
 Modelli 770/2014


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – R I T E N U T E  
S T A M P E  - 135   Stampa certificazioni  
  
Le aziende che hanno operato ritenute, devono rilasciare, a chi ha percepito il compenso, la 
certificazione relativa alle  ritenute operate nell'anno precedente. La certificazione consiste nella stampa 
di un attestato in cui l'azienda dichiara di aver corrisposto compensi assoggettati a ritenuta.  
  
 
Stampa certificazioni  
  
 Da data - A data  
I campi vengono valorizzati automaticamente con le date di inizio e fine esercizio. L'utente può 
comunque limitare l'intervallo a piacere, definendo comunque come data fine intervallo una data 
coincidente con la fine di un periodo mensil e o annuale.  
 Da percipiente  
Indica il codice del percipiente a partire dal quale si desidera stampare la Certificazione degli importi 
assoggettati a ritenute. L'utente può anche lasciare il campo Blank: in questo caso la procedura 
considera il primo codi ce presente nell'elenco fornitori e/o collaboratori.  
  
Al fine di intestare la certificazione al percipiente è possibile definire, in anagrafica Fornitori, l'indirizzo di tipo 
Residenza. In mancanza di questo dato, la procedura riporterà i dati inseriti ne lla prima scheda dell'anagrafica 
Fornitori.  
  
 A percipiente  
Il campo rappresenta il codice fino al quale interessa la stampa della certificazione.  
 Tipo di stampa  
La combo box Tipo di stampa permette all'utente di scegliere la tipologia della stampa cer tificazione.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – R I T E N U T E  
136  – S T A M P E  La combo box assume il valore sintetica , dettagliata uso interno e dettagliata ad uso esterno. 
Riepiloghiamo brevemente le caratteristiche delle diverse tipologie di stampa:  
 Sintetica: in questo report viene ora riportata la descrizione del  tributo presente nella tabella 
F24 -codici tributo. I dati sono ordinati per codice conto ( fornitore )/codice tributo e 
percentuale tributo;  
 Dettagliata uso interno: inserito nuovo report per la stampa certificazioni. Nel report viene 
riportato il rife rimento alla data e al numero del versamento e l'ordinamento è dato dal codice 
conto - codice esercizio - data registrazione del versamento e numero del versamento. 
All'interno della stampa viene prima riportato il dettaglio per il codice tributo e poi il t otale per 
codice tributo  
 Dettagliata uso esterno: inserito un nuovo report per la stampa certificazioni. Nel nuovo 
report i dati sono ordinati in base al codice conto - codice tributo - data registrazione del 
movimento ritenute, riportando nel report il riferimento al numero documento della fattura 
fornitore percipiente. All'interno della stampa viene prima riportato il dettaglio per il codice 
tributo e poi il totale per codice tributo  
 Stampa descrizione codice tributo  
Se attivo stampa in tutti i report  anche la descrizione del codice tributo definito nella tabella F24 -
codice tributo.  
  
Per eseguire la stampa delle certificazioni è necessario eseguire le seguenti operazioni:  
- Generare i movimenti Ritenute d'Acconto o inserirli direttamente dall'archivio  corrispondente;  
- eseguire il versamento delle ritenute IRPEF e INPS: il versamento deve essere in stato Confermato e deve essere 
inoltre indicata almeno la data versamento;  
- stampare le Certificazioni specificando l'anno (Es. da 01/01/03 a 31/12/03), la  valuta di stampa ed 
eventualmente il percipiente.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – R I T E N U T E  
S T A M P E  - 137   Stampa compensi pagati  
  
Le somme che l'azienda trattiene a titolo di ritenuta devono essere versate all'erario entro il 16 del 
mese successivo. Questa stam pa genera un prospetto distinto per percipiente, dei compensi pagati, 
totalizzando le ritenute calcolate distinte per codice tributo.  
  
 
Stampa compensi pagati  
  
 Da data - A data  
I campi vengono valorizzati automaticamente con le date di inizio e fine e sercizio. L'utente può 
comunque limitare l'intervallo a piacere. La procedura considera tutte le distinte che hanno il campo 
relativo alla data del versamento valorizzato.  
 Da percipiente - A percipiente  
È possibile impostare un intervallo di codici perci pienti (fornitori soggetti a ritenute) per i quali 
stampare i compensi pagati a titolo di ritenuta d'acconto.  
 Tipo di stampa  
Il campo indica il tipo di report di stampa che si desidera stampare tra quelli disponibili.  
 Stampa compensi ordinati per forni tori 
 Stampa compensi ordinati per fornitori (I.R.PE.F.)  
 Stampa compensi ordinati per fornitori (I.N.P .S.)  
 Stampa compensi ordinata per tributo  
 Stampa compensi I.N.P .S.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – R I T E N U T E  
138  – S T A M P E   Stampa versamenti irpef  
  
Si tratta di una stampa di controllo che legge l'archivio delle distinte relative ai versamenti IRPEF 
effettuati o da effettuare.  
  
Come primo campo viene richiesto lo stato delle distinte da considerare, possono essere filtrate 
distinte confermate, provvisori e od entrambe; quindi, se le distinte devono essere relative a ritenute 
già versate, ancora da versare od entrambe le condizioni.  
  
 
Stampa versamenti irpef  
  
 Stato  
La combo box indica lo stato delle distinte da considerare. La selezione può essere effe ttuata per 
distinte provvisorie, confermate od entrambe.  
La combo box indica se la selezione deve essere fatta in relazione a ritenute già versate od ancora da 
versare oppure indifferentemente.  
  
Selezione distinta di versamento  
Una volta impostati i quest i due campi, è possibile stampare il contenuto di una determinata distinta. 
In questo caso bisogna selezionare la specifica distinta cliccando sul relativo bottone: 
automaticamente viene riportato il numero di registrazione, il codice esercizio di riferime nto e la data.  
  
Se si seleziona una specifica distinta, la procedura disattiva tutti gli altri campi presenti sulla maschera di selezione; 
resta comunque attivo il campo su cui impostare la valuta in cui devono essere espressi i valori nella stampa 
versam enti.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – R I T E N U T E  
S T A M P E  - 139  Nel caso in cui non si selezioni alcun codice distinta, l'operatore può impostare gli altri campi di filtro:  
 Versamenti da data - A data  
I campi consentono di limitare la stampa all'interno di un intervallo di date di versamento.  
 Codice tributo  
L'utente può fare la stampa dei versamenti relativi ad un certo codice tributo. La maschera di zoom 
filtra solo i codici tributo di tipo IRPEF .  
 Percipiente  
La stampa può anche essere eseguita relativamente ad un certo percipiente.  
 Conto banca  
Codice d el conto banca utilizzato per il versamento delle ritenute.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – R I T E N U T E  
140  – S T A M P E   Stampa versamenti previdenziali  
  
Si tratta di una stampa di controllo che legge l'archivio delle distinte relative ai versamenti dei 
Cont ributi INPS e Previdenziali effettuati o da effettuare. Come primo campo viene richiesto lo stato 
delle distinte da considerare, possono essere filtrate distinte confermate, provvisorie od entrambe; 
quindi, se le distinte devono essere relative a ritenute già versate, ancora da versare od entrambe le 
condizioni.  
  
 
Stampa versamenti previdenziali  
  
 Stato  
La combo box indica lo stato delle distinte da considerare. La selezione può essere effettuata per 
distinte provvisorie, confermate od entrambe.  
  
La co mbo box indica se la selezione deve essere fatta in relazione a ritenute già versate od ancora da 
versare oppure indifferentemente.  
  
Selezione distinta di versamento  
Una volta impostati i questi due campi, è possibile stampare il contenuto di una determin ata distinta. 
In questo caso bisogna selezionare la specifica distinta cliccando sul relativo bottone: 
automaticamente viene riportato il numero di registrazione, il codice esercizio di riferimento e la data.  
  
Se si seleziona una specifica distinta, la pr ocedura disattiva tutti gli altri campi presenti sulla maschera di selezione; 
resta comunque attivo il campo su cui impostare la valuta in cui devono essere espressi i valori nella stampa 
versamenti.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – R I T E N U T E  
S T A M P E  - 141    
Nel caso in cui non si selezioni alcun codice distinta , l'operatore può impostare gli altri campi di filtro:  
 Versamenti da data - A data  
I campi consentono di limitare la stampa all'interno di un intervallo di date di versamento.  
 Codice tributo  
L'utente può fare la stampa dei versamenti relativi ad un cer to codice tributo. La maschera di zoom 
visualizza solo codici tributo di tipo INPS o Previdenziale.  
 Percipiente  
La stampa può anche essere eseguita relativamente ad un certo percipiente.  
 Conto banca  
Codice del conto banca utilizzato per il versamento d elle ritenute.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – R I T E N U T E  
142  – S T A M P E   Stampa riepilogo ritenute alla fonte  
  
Attraverso questa stampa è possibile ottenere un elenco delle ritenute d'acconto IRPEF versate al fine 
di estrapolare i dati per la compila zione del quadro ST del modello 770, relativo al riepilogo delle 
ritenute alla fonte operate e dei relativi versamenti.  
  
 
Stampa riepilogo ritenute alla fonte  
  
 Da data -A data  
I campi vengono automaticamente proposti con le date di inizio e fine eserc izio. L'utente può 
comunque limitare l'intervallo a piacere. La procedura considera tutte le distinte che hanno il campo 
relativo alla data del versamento valorizzato.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – R I T E N U T E  
S T A M P E  - 143   Stampa elenco agenti  
  
Attraverso questa stampa è possibile ottenere un elenco dei percipienti con i totali, distinti per tributo, 
relativi ai compensi, alle somme non soggette, all'imponibile ed alle ritenute. La stampa che viene 
prodotta è relativa ad una particolare tipologia di percipienti, g li Agenti  e fornisce i dati per la 
compilazione del quadro SE riferito alle provvigioni.  
  
 
Stampa elenco agenti  
  
 Da data - A data  
I campi vengono automaticamente proposti con le date di inizio e fine esercizio. L'utente può 
comunque limitare l'interva llo a piacere. La procedura considera tutte le distinte che hanno il campo 
relativo alla data del versamento valorizzato.  
 Da percipiente - A percipiente  
È possibile impostare un intervallo di codici percipienti (fornitori soggetti a ritenute di tipo Agen te) 
per i quali stampare i compensi pagati a titolo di ritenuta d'acconto.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – R I T E N U T E  
144  – S T A M P E   Stampa elenco altri percipienti  
  
Attraverso questa stampa è possibile ottenere un elenco dei percipienti con redditi da la voro 
autonomo con i totali, distinti per tributo, relativi ai compensi, alle somme non soggette, all'imponibile 
ed alle ritenute.  
  
 
Stampa elenco altri percipienti  
  
 Da data - A data  
I campi vengono automaticamente proposti con le date di inizio e fine  esercizio. L'utente può 
comunque limitare l'intervallo a piacere. La procedura considera tutte le distinte che hanno il campo 
relativo alla data del versamento valorizzato.  
 Da percipiente - A percipiente  
È possibile impostare un intervallo di codici per cipienti (fornitori soggetti a ritenute) per i quali 
stampare i compensi pagati a titolo di ritenuta d'acconto.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – R I T E N U T E  
S T A M P E  - 145   Stampa ritenute subite  
  
Con questa stampa è possibile stampare i movimenti relativi alle ritenute subite  
  
 
Stampa ritenute subite  
  
 Da d ata - A data  
Date di inizio e fine selezione movimenti ritenute subite  
 Da intestatario - A intestatario  
Filtro su intestatari dei movimenti ritenute subite  
 Tipo di stampa  
A seconda del tipo di stampa selezionato la procedura propone i seguenti report  
 Stampa ritenute subite  
 Stampa ritenute subite per cliente  
 Stampa ritenute subite tipo lettera


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – R I T E N U T E  
146  – S T A M P E   Stampe 770 pregresse  
  
Stampe 770 pregresse  
 Modelli 770/2005  
 Modelli 770/2006  
 Modelli 770/2007  
 Modelli 770/2008  
 Modelli 770/2009  
 Modelli 770/2010  
 Modelli 770/ 2011 
 Modelli 770/2012  
 Modelli 770/2013


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – R I T E N U T E  
S T A M P E  - 147   Modelli 770/2014  
  
Sono stati aggiornati i modelli delle stampe cartacee utilizzando quelli predisposti fiscalmente per la 
dichiarazione 770/2010. In particolare:  
  
- Stampa comunicazioni lavoro autonomo / 2014  
- Stampa prospetto st [2014]  
- Stampa prospetto ss [2014]


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – R I T E N U T E  
148  – S T A M P E  Stampa comunicazioni lavoro autonomo / 2014  
  
La stampa comunicazioni lavoro autonomo raggruppa le ritenute per ogni percipiente. Sono 
considerati nella stampa solo i movimenti ritenute relativi a distinte di versamento definitive. In 
corrispondenza di ogni percipiente vengono stampate due sezioni; la prima con tiene i dati anagrafici 
del percipiente stesso, mentre la seconda riporta i dati relativi alle somme erogate. Le ritenute vengono 
raggruppate in base alla causale prestazione ossia alla causale che identifica il pagamento delle ritenute.  
  
 
Stampa comunic azioni lavoro autonomo 2014  
  
 Tipo operazione  
Combo box che permette di considerare solo i movimenti ritenuta già abbinati a distinte di 
versamento IRPEF confermate contraddistinte da una delle tre tipologie di operazione:  
 Inserimento  
 Aggiornamento  
 Cancellazione  
 Tutte  
  
Ricordiamo che il ‘Tipo operazione’ viene impostato anche mediante la funzionalità di 
‘Aggiornamento movimenti ritenuta’.  
  
Il codice comune è un dato anagrafico, quindi, se presente, viene riportato anche nelle stampe pregresse


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – R I T E N U T E  
S T A M P E  - 149  Stampa prospetto st [2014]  
  
Tale stampa raggruppa le ritenute operate per periodo di riferimento, codice tributo, eventi 
eccezionali, articolo, regione, note e modalità di versamento. Sono considerati nel la stampa solo i 
movimenti ritenute relativi a distinte di versamento definitive. La stampa riporta: il periodo di 
riferimento delle ritenute, l'importo delle ritenute operate, l'eventuale importo delle ritenute versate in 
eccesso, delle ritenute compensat e, la differenza (data dall'importo delle ritenute operate meno 
l'importo delle ritenute versate in eccesso e delle ritenute compensate), gli interessi, le note, gli eventi 
eccezionali, il codice tributo, articolo, tesoreria e regione.  
  
 
Stampa prospetto  st 2014


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – R I T E N U T E  
150  – S T A M P E  Stampa prospetto ss [2014]  
  
Tale prospetto riporta i dati riassuntivi relativi a quanto riportato nella comunicazione del modello di 
dichiarazione. Sono considerati nella stampa solo i moviment i ritenute relativi a distinte di versamento 
definitive  
  
 
Stampa prospetto ss 2014  
  
 Tipo operazione  
Combo box che permette di considerare solo i movimenti ritenuta già abbinati a distinte di 
versamento IRPEF confermate contraddistinte da una delle tre  tipologie di operazione  
 Inserimento  
 Aggiornamento  
 Cancellazione  
 Tutte  
  
Ricordiamo che il ‘Tipo operazione’ viene impostato anche mediante la funzionalità di 
‘Aggiornamento movimenti ritenuta’


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – R I T E N U T E  
S T A M P E  - 151  
 
_________________________________________________ _______________________________  
________________________________________________________________________________  
________________________________________________________________________________  
______________________________________________________________ __________________  
________________________________________________________________________________  
________________________________________________________________________________  
___________________________________________________________________________ _____  
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
_______ _________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
____________________ ____________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – R I T E N U T E  
152  – S T A M P E  
 
_______________________________ _________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
____________________________________________ ____________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
_________________________________________________________ _______________________  
________________________________________________________________________________  
________________________________________________________________________________  
______________________________________________________________________ __________  
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
_______________________________________________________________________________


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – R I T E N U T E  
S E R V I Z I  R I T E N U T E  - 153   SERVIZI RITENU TE 
  
 
Menù Servizi Ritenute  
  
 Aggiornamento dati ritenute


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – R I T E N U T E  
154  - S E R V I Z I  R I T E N U T E   Aggiornamento dati ritenute  
  
E’ stata  realizzata  una procedura di servizio per aggiornare il pulsa nte ritenute della primanota nel 
caso in cui sia stato effettuato l'import dei dati da Ad hoc windows e/ o nel caso si voglia aggiornare il 
pulsante ritenute della primanota dopo aver modificato le caratteristiche della causale contabile.  
La procedura di s ervizio si lancia direttamente dalla gestione  Aggiornamento dati ritenute presente nel 
sottomenu Servizi del modulo Ritenute  
  
 
Aggiornamento dati ritenute  
  
 Da data - A data  
Indica l’intervallo temporale per cui generare l’aggiornamento dei dati ritenu te all’interno della 
primanota.  
 Tipo  
L’aggiornamento può essere effettuato sia per quelle registrazioni che prevedono come  intestatario  il 
fornitore e/o il cliente oppure entrambi.  
 Causale  
In questo campo è possibile specificare la causale usata per le registrazioni da aggiornare con i dati 
ritenute. Se l’utente non  specifica nulla, la procedura eseguirà l’aggiornamento per quelle registrazioni 
con causali che hanno attivo il flag  gestisce le ritenute.  
  
Esempio  
Dopo l’import da AHW si interroga la primanota richiamando una registrazione di ricevimento 
fattura.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – R I T E N U T E  
S E R V I Z I  R I T E N U T E  - 155  
 
Registrazione importata da ahw  
  
In questa registrazione si può notare la mancanza del pulsante Ritenute perché sulla causale 008 - 
RICEVIMENTO FATTURA il flag ‘Gestisce le ritenute’ è spe nto. 
  
A questo punto l’utente cambia le caratteristiche di questa causale 008 andando ad attivare il flag 
‘Gestisce le ritenute’.  
Prima di questo intervento per tutte le registrazioni (con causale 008) importate, i dati all’interno del 
pulsante dati riten ute non venivano aggiornati automaticamente.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – R I T E N U T E  
156  - S E R V I Z I  R I T E N U T E  
 
Casuale 008 - Attivazione del flag Gestisce la ritenute.  
  
Torniamo in primanota e premiamo il pulsante Ritenute ora visibile sulla registrazione. Il dettaglio 
non è valorizzato.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – R I T E N U T E  
S E R V I Z I  R I T E N U T E  - 157  
 
Dati Ritenute non aggior nato. 
  
Per valorizzare il dettaglio entriamo nella gestione Aggiornamento dati ritenute presente nel 
sottomenu Servizi del modulo Ritenute.  
  
 
  
Aggiornamento dati.  
  
La procedura provvederà in questo caso ad aggiornare tutte le registrazioni con casuale 008 comprese 
nell’intervallo di data registrazione dal 01/01/2013 al 03/07/2013.  
Tornando in primanota e premiamo il pulsante Ritenute è possibile verificare che il dettaglio è stato 
valorizzato.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – R I T E N U T E  
158  - S E R V I Z I  R I T E N U T E  
 
Dati ritenute valorizzato.  
  
Se per qualche motivo l’ag giornamento non è eseguito con successo viene prodotto un report con 
l’informazione del motivo che ha determinato il mancato aggiornamento e il seriale della 
registrazione.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – R I T E N U T E  
S E R V I Z I  R I T E N U T E  - 159  
 
______________________________________________________________________________ __ 
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
__________ ______________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
_______________________ _________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
____________________________________ ____________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
_________________________________________________ _______________________________  
_________________________________________________ _______________________________  
________________________________________________________________________________


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – R I T E N U T E  
160  - S E R V I Z I  R I T E N U T E  
 
______________________________________________________________________________ __ 
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
__________ ______________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
_______________________ _________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
____________________________________ ____________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
_________________________________________________ _______________________________  
________________________________________________________________________________  
________________________________________________________________________________


key: chroma:document
string_value:
Piattaforma Applicativa Gestionale  
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 Schedulatore  
 
Release 8.0


key: chroma:document
string_value:
COPYRIGHT 2000 - 2015 by ZUCCHETTI S.p.A.  
Tutti i diritti sono riservati. Questa pubblicazione contiene informazioni p rotette da copyright. 
Nessuna parte di questa pubblicazione può essere riprodotta, trascritta o copiata senza il permesso 
dell’autore.  
 
RESPONSABILITÀ  
Resta espressamente esclusa qualsiasi responsabilità per danni diretti ed indiretti di qualsiasi natura c he 
l'utente possa, o terzi possano, in alcun modo subire, derivanti dall'uso o dal mancato uso della 
procedura e da errori della stessa.  
 
TRADEMARKS  
Tutti i marchi di fabbrica sono di proprietà dei rispettivi detentori e vengono riconosciuti in questa 
pubb licazione.  
 
ZUCCHETTI S.p.A.  
Sede Operativa di Aulla  
E - mail: market@zucchetti.it  
Sito Web: http://www .zucchetti.it


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
I N D I C I  - III Indice  
 
Schedulatore  ................................ ................................ ................................ .. 1 
 OPERAZIONI PRELIMINAR I ................................ ................................ ...................  5 
 Logica di funzionamento  ................................ ................................ .........................  6 
 Sessione schedulatore  ................................ ................................ ...............................  7 
 Parametri accesso silente schedulatore  ................................ ................................ .. 8 
 Caricamento gestioni certificate  ................................ ................................ ...........  18 
 Gestione cartella  stampe  ................................ ................................ ........................  19 
 Utente esecutore dei job  ................................ ................................ ........................  20 
 Utente schedulatore activity logger ................................ ................................ ...... 23 
 CERTIFICAZIONE GESTIO NI ................................ ................................ ................  25 
 Caratteristiche gestioni certificate  ................................ ................................ ........ 26 
 Gestioni schedulatore  ................................ ................................ .............................  28 
 Schedulazione ristampa documenti con selezione di una sola causale  ......... 31 
 SCHEDULAZIONE JOB  ................................ ................................ ..........................  35 
 Fotografare una gestione  ................................ ................................ .......................  36 
 Schedulatore di job  ................................ ................................ ................................ . 39


key: chroma:document
string_value:
 Stampa job  ................................ ................................ ................................ ................  49 
 Log elaborazione  ................................ ................................ ................................ ..... 50 
 Visualizzazione log di elaborazio ne ................................ ................................ ..... 51 
 Selezione gruppo schedulatore  ................................ ................................ .............  53 
 Stampa log  ................................ ................................ ................................ ................  54 
 PROATTIVITÀ  ................................ ................................ ................................ ....... 57 
 ATTIVAZIONE PROATTIVI TÀ ................................ ................................ ................  69 
 
 
Le immagini della documentazione differiscono secondo il sistema operativo utilizzato e delle 
parametrizzazioni di Ad hoc Revolution impostate nella configurazione interfaccia.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
IV – I N D I C I  
 
________________________________________________________ ________________________  
________________________________________________________________________________  
________________________________________________________________________________  
_____________________________________________________________________ ___________  
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
______________ __________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
___________________________ _____________________________________________________  
________________________________________________________________________________  
_______________________________________________________________________________


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
S C H E D U L A T O R E  - 1 Schedulatore  
  
Il modulo Schedulatore di Job consente di pianificare le operazioni di ad hoc Revolution, da eseguirsi 
automaticamente con una frequenza stabilita.  
  
In questo modo è possibile:  
 Liberare l’utente dall’onere di eseguire elaborazioni che richie dono molto tempo, da 
pianificarsi ad esempio nei momenti di minore operatività (come può essere l’elaborazione 
dell’Inventario di Magazzino;  
 Eseguire elaborazioni frequenti rispettando i tempi pianificati (è ad esempio possibile decidere 
di aggiornare il  datawarehouse giornalmente con il modulo Infolink);  
 Controllandone il lancio sia in termini di configurazione (filtri da impostare sulla maschera) sia 
in termini di tempificazione rispetto ad altre operazioni (facendo elaborare l’archivio statistico, 
ad esempio, prima di effettuare la stampa delle statistiche).  
  
Mostriamo di seguito il menu del modulo (presente all’interno del menu principale Sistema), e le voci 
che saranno analizzate nei paragrafi successivi.  
  
 
Menù Schedulatore di Job  
  
 OPERAZIONI PRELIMINAR I 
 CERTIFICAZIONE GESTIO NI 
 SCHEDULAZIONE JOB  
 PROATTIVITÀ


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
2 – S C H E D U L A T O R E   ATTIVAZIONE PRO ATTIV ITÀ


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
S C H E D U L A T O R E  - 3 
 
________________________________________________________ ________________________  
________________________________________________________________________________  
________________________________________________________________________________  
_____________________________________________________________________ ___________  
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
______________ __________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
___________________________ _____________________________________________________  
___________________________ _____________________________________________________  
________________________________________________________________________________


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
4 – S C H E D U L A T O R E  
 
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
________ ________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
_____________________ ___________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
__________________________________ ______________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
_______________________________________________ _________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
____________________________________________________________ ___________________


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
O P E R A Z I O N I  P R E L I M I N A R I  - 5   
 OPERAZIONI PRELIMINAR I 
  
Il modulo Schedulatore di Job consente di pianificare le operazioni di Ad Hoc Revolution, da 
eseguirsi automaticamente con una frequenza stabilita. In questo mod o è possibile:  
liberare l'utente dall'onere di eseguire elaborazioni che richiedono molto tempo, da pianificarsi ad 
esempio nei momenti di minore operatività (come può essere l'elaborazione dell'Inventario di 
Magazzino);  
eseguire elaborazioni frequenti ris pettando i tempi pianificati (è ad esempio possibile decidere di 
aggiornare il datawarehouse giornalmente con il modulo Infolink);  
controllandone il lancio sia in termini di configurazione (filtri da impostare sulla maschera) sia in 
termini di tempificazio ne rispetto ad altre operazioni (facendo elaborare l'archivio statistico, ad 
esempio, prima di effettuare la stampa delle statistiche).  
  
 Logica di funzionamento  
 Sessione schedulatore  
 Parametri accesso silente schedulatore  
 Caricamento gestioni certificate  
 Gestione cartella stampe  
 Utente esecutore dei job  
 Utente schedulatore activity logger


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
6 – O P E R A Z I O N I  P R E L I M I N A RI  Logica di funzionamento  
  
Il modulo è trasversale rispetto alle funzionalità della procedura: risulta potenzialmente attivabile su 
ogni maschera di elaborazione o di stampa (che rispettino alcuni requisiti minimi descritti in seguito), 
senza la necessità che sia stata disegnata tenendo conto dello Schedulatore.  
  
Fotografie di Configurazione delle Maschere  
Per pianificare una elaborazione/stampa è suf ficiente aprirla, importare i necessari parametri di 
esecuzione e quindi catturarne una F otografia  premendo la combinazione di tasti CTRL+F11 . Una 
volta catturate le configurazioni delle maschere, le elaborazioni/stampe possono essere pianificate 
inserendo le in un Job al quale viene assegnato una certa frequenza di esecuzione.  
  
Sessione Schedulatore  
Lo Schedulatore di Job consiste quindi in una sessione sempre attiva di Ad Hoc Revolution che ad 
intervalli di tempo verifica se ci sono Job pianificati da lan ciare. L'esecuzione apre le maschere definite 
nei processi del Job secondo la sequenza stabilita dall'utente, ne riempie i parametri catturati nella 
Fotografia (o preimposta con il valore di default quelli non catturati) ed infine conferma 
automaticamente l'elaborazione o la stampa. I report vengono salvati in formato PDF, ed è 
comunque possibile anche inviarli alla stampante.  
  
Per ciascun Job viene prodotto un Log suddiviso per Processo, in cui vengono riportati i messaggi di 
elaborazione ed i riferimenti  a tutte le stampe prodotte.  
  
Gestione Sincrona ed Asincrona delle Code  
Ogni Job è composto da diversi Processi da eseguire in sequenza tra di loro; ogni Processo  
rappresenta una certa gestione da eseguire, con annessi parametri di lancio catturati con un a fotografia 
di configurazione della maschera.  
  
In un certo momento, una Sessione di Schedulazione può eseguire un solo Job; eventuali altri Job che


key: chroma:document
string_value:
dovessero divenire attivi nel frattempo vengono perciò accodati al termine del primo Job. Per eseguire 
più Job contemporaneamente è necessario tenere aperte più Sessioni di Schedulazione.  
  
In sintesi, sono ravvisabili due tipologie di code di esecuzione. Vi sono le Code Sincrone  dei Processi 
all'interno dei Job, che vengono eseguiti in modo sequenziale. Quest e code vengono eseguite 
interamente solo se ogni singolo Processo termina con successo.  
  
Vi sono inoltre le Code costituite dall'esecuzione dei diversi Job, che vengono eseguite in modo 
Asincrono  solo nel caso siano aperte più sessioni di Schedulazione co ntemporaneamente.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
O P E R A Z I O N I  P R E L I M I N A RI - 7  Sessione schedulatore  
  
Il timer che verifica se vi siano Job da lanciare, e la conseguente esecuzione degli stessi, è demandata 
ad una Sessione di Ad Hoc Revolution dedicata esclusivamente a questo compito (o più sessioni se 
fossero necessari Job ad esecuzione asincrona). Tale sessione rimane tipicamente sempre attiva, anche 
e soprattutto nei momenti di scarsa operatività del sistema informativo (ad esempio di notte o nei 
giorni festivi).  
  
La Sessione Schedulatore  viene individuata dall'ingresso nella procedura con un utente 
appartenente al Gruppo Schedulatore, da definirsi nella maschera Selezione Gruppo Schedulatore. 
Più utenti possono appartenere a tale gruppo, in modo da gestire Job ad e secuzione asincrona 
mediante più sessioni aperte contemporaneamente.  
  
 
Selezione gruppo schedulatore  
  
La Sessione Schedulatore si caratterizza per l'assenza della barra dei menu, e per la presenza di una 
Application Bar speciale per il controllo del Tim er di Schedulazione. L'utente può decidere di 
sospendere l'esecuzione dei Job ancora da eseguire, disattivando il Timer mediante l'apposito bottone 
presente nell'Application Bar. Non può essere invece sospesa l'esecuzione di Job in corso.  
  
 
Sessione Sche dulatore assenza Barra dei Menu e presenza Application Bara speciale per controllo 
Timer


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
8 – O P E R A Z I O N I  P R E L I M I N A RI  Parametri accesso silente 
schedulatore  
  
Il servizio Zucchetti Scheduler Service permette di lanciare,  in modo silente, una sessione di lavoro al 
fine di eseguire i processi schedulati attraverso il modulo Schedulatore di job.  
Zucchetti Scheduler Service si appoggia ad un servizio del sistema operativo Windows in grado di  
lavorare anche in assenza di un ut ente loggato sul sistema e di attivarsi con l'avvio del sistema 
operativo stesso.  
  
La configurazione del servizio Zucchetti Scheduler Service  avviene tramite la maschera parametri 
accesso silente schedulatore  presente nel sottomenu Schedulatore.  
  
 
Creaz ione icona accesso silente schedulatore  
  
Questa maschera permette di definire due configurazioni diverse:  
Creazione Icona Accesso Silente per lo Schedulatore  
Configurazione Scheduler Service


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
O P E R A Z I O N I  P R E L I M I N A RI - 9 Creazione Icona Accesso Silente per lo Schedulatore  
 File CNF da utilizzare:  
Occorre specificare un file di connessione cp3start.cnf ; tale file deve contenere al suo interno una 
stringa per la connessione silente al database. Per ulteriori informazioni circa la stringa per l'accesso 
silente.  
 Azienda  
Specificare l'azienda con la quale si vuole effettuare l'accesso alla procedura in fase di login  
 Esercizio  
Specificare l'esercizio sul quale si vuole effettuare l'accesso alla procedura in fase di login  
 Utente con cui accedere  
Specificare l'utente con il q uale si vuole accedere alla procedura; l'utente deve appartenere al gruppo 
schedulatore  
 Utilizza stringa criptata  
Permette di decidere se utilizzare una stringa di accesso criptata, a tal fine è necessario configurare 
opportunamente il file cp3srtart.cnf  indicando la variabile pubblica public g_CRYPTSilentConnect  
come di seguito riportato:  
public g_CRYPTSilentConnect  
g_CRYPTSilentConnect = .t.  
 Esegui  
Permette di scegliere la modalità di apertura della finestra della procedura  
 Commento  
Permette di inse rire un commento da visualizzare nell'icona di collegamento;  
 Nome collegamento  
Fornisce la possibilità di specificare un nome dell'icona di collegamento  
 Abilita tasti di scelta rapida  
Mediante l'attivazione del check Abilita tasti di scelta rapida è fo rnita la possibilità di specificare la 
sequenza di tasti per l'apertura rapida della procedura.  
L'informazione della combinazione di tasti (es. MAIUSCOLO+F1),  definita per avviare la maschera 
della procedura, viene riportata nella cartella Collegamento del le Proprietà dell'icona accesso silente 
schedulatore.  
  
Alla conferma della maschera la procedura creerà sul desktop un collegamento per effettuare l'accesso


key: chroma:document
string_value:
silente alla procedura con l'utente Schedulatore con le proprietà parametrizzate nella maschera di  
creazione icona accesso silente schedulatore.  
  
 
Icona accesso silente


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
10 – O P E R A Z I O N I  P R E L I M I N A RI  Esegui come  
Sono possibili due modalità di utilizzo del servizio in base al tipo di installazione dell'applicazione.  
 Servizio locale: l'applicativo risiede fisicamente sulla mac china dove verrà utilizzato il servizio.  
 Servizio di rete: l'applicativo risiede su una macchina diversa da quella dove verrà utilizzato il 
servizio (necessità di una mappatura di rete per il corretto funzionamento).  
  
N.B. In base al settaggio di questa  combo box verranno abilitati o meno alcuni dei successivi campi.  
 Mappatura  
Editabile solo per Servizio di rete . Indicare il percorso dove risiede la cartella del programma 
specificando un path assoluto (es. \\nomeServer \cartellaProgramma ). 
 Percorso Zm ainservice  
Non editabile : contiene il path dell'eseguibile del servizio.  
 Percorso ZschSrv  
Non editabile; contiene il path dell'eseguibile per il controllo del servizio.  
 Esegui Zucchetti Scheduler Service all'avvio  
Il servizio viene impostato con tipo d i avvio Automatico in modo che si attivi automaticamente 
all'avvio del sistema operativo  
 Avvia subito Zucchetti Scheduler Service  
Se attivo esegue immediatamente Zucchetti Scheduler Service  
 Crea icona sul desktop  
Se attivo crea un'icona di Zucchetti Sc heduler Service sul desktop  
  
 
Icona Zucchetti Scheduler Service  
  
 Crea il servizio  
Se attivo, premendo il bottone ok della maschera verrà creato il servizio Windows per l'avvio dello 
schedulatore.  
Se si disattiva il check sarà comunque possibile creare  il servizio anche dal programma Zucchetti 
Scheduler Service, che permette un controllo totale e più approfondito delle impostazioni del servizio  
Nel caso in cui il servizio esista già, il sistema ne ignorerà la creazione o le eventuali modifiche.  
  
Una vo lta completati correttamente tutti i campi, all'ok della maschera verrà creato un file di configurazione


key: chroma:document
string_value:
scheduler.ini all'interno della cartella \jbsh\zschsrv dell'applicativo. La modifica del file non deve avvenire 
manualmente, ma solo tramite la mascher a di configurazione, ogni volta che se ne presenti la necessità; questo per 
evitare mal funzionamenti dovuti ad una non corretta configurazione. Nel caso in cui il servizio debba essere 
eseguito come Servizio di rete, ovvero l'applicativo gestionale Ad Hoc  o il Sistema Software di Federazione 
risiedano su un'altra macchina, è necessario configurare anche un'altra maschera che comparirà all'Ok della 
procedura nel caso in cui si decida di creare subito il servizio tramite l'apposito check.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
O P E R A Z I O N I  P R E L I M I N A RI - 11   
Avvio della sessi one Schedulatore  
Una volta caricati tutti i Job che si intendono eseguire, per far sì che l'esecuzione degli stessi avvenga 
nel modo corretto è possibile operare seguendo modalità diverse:  
 Utilizzare un Servizio di Windows e Zucchetti Scheduler Service. Con le configurazioni 
eseguite precedentemente è possibile risolvere contemporaneamente i problemi di occupazione 
di memoria da parte dell'applicativo e la necessità di dover impostare un'operazione pianificata 
per il riavvio, soluzione completa per una co rretta gestione automatizzata della sessione di 
schedulazione.  
 Lasciare aperta una sessione dell'applicativo con l'utente Schedulatore loggato. Questa 
modalità può comportare, N el lungo periodo , un'anomala occupazione della memoria della 
macchina, pertanto, se si sceglie di lasciare aperta una sessione di lavoro con  l'utente 
Schedulatore, sarà necessario chiudere la sessione e riattivarla, consigliamo almeno una volta a 
settimana.  
 Utilizzare la gestione definita come Login Silente. Ovvero l'utente Schedulatore effettua la 
login sull'Applicativo, solo quando deve es sere lanciato un job, al termine della sua esecuzione la 
sessione di lavoro dell'utente Schedulatore verrà terminata. Per l'esecuzione di questa modalità 
di schedulazione è necessaria la configurazione e la creazione di alcuni file per l'attivazione di 
un'operazione pianificata del sistema operativo.  
  
Utilizzare un Servizio di Windows e Zucchetti Scheduler Service  
Una volta configurato il servizio come da indicazioni precedenti (vedere la Sezione Zucchetti 
Scheduler Service), è possibile utilizzare tale mo dalità per il controllo di una sessione dell'applicativo 
avviata con utente schedulatore.  
Il servizio Windows configurato si preoccupa di tenere attiva una sessione dello schedulatore in grado 
di eseguire i job alle ore stabilite.


key: chroma:document
string_value:
di eseguire i job alle ore stabilite.  
L'avvio del servizio e qu indi dell'applicativo avviene allo startup del Sistema Operativo dove risiede e 
rimane attivo fino a quando l'utente non decide di fermarlo.  
Il controllo completo del servizio è fornito da un cruscotto mediante il quale è possibile reperire delle 
informazi oni sullo stato del servizio che gestisce la sessione di lavoro dello schedulatore ed avere 
informazioni sullo stato dello schedulatore stesso.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
12 – O P E R A Z I O N I  P R E L I M I N A RI 
 
Zucchetti Scheduler Service – Generale  
  
Zucchetti Scheduler Service, una volta lanciato, è visibile tramite  un'icona all'interno della 
SystemTray,  sulla barra delle applicazioni.  
E' possibile richiamarne a video le funzionalità semplicemente eseguendo un doppio click sulla 
relativa icona che assume la forma di un piccolo orologio con accanto i simboli di Arrest o (quadratino 
rosso) e Avvio (triangolino verde).  
  
Come da figura sopra riportata, la pagina Generale contiene le funzionalità principali per il controllo 
del Servizio.  
Il campo in sola visualizzazione fornisce un log di informazioni, sia per quanto rigua rda il servizio, sia 
per quanto riguarda lo stato dell'attività dello schedulatore.  
E' possibile verificare se alla pressione dei vari bottoni presenti nella maschera, la procedura ha 
risposto correttamente o ha invece generato una eccezione.  
La label Stato del servizio  visualizza in che stato si trova il servizio per la schedulazione.  
  
Nel caso in cui sia indicato Non attivo come mostrato in figura, indica che il servizio non è stato avviato, pertanto 
non esiste alcuna sessione dello schedulatore attiva. Lo stato Attivo, viceversa, indica che attualmente una sessione 
dello schedulatore è avviata e sta effettuando il proprio lavoro di schedulazione dei job.  
  
 Avvia e Arresta  
Permettono di controllare il servizio e di conseguenza la sessione dello schedulatore, avviando o 
interrompendo la sessione di lavoro.  
  
N.B. Arrestare il servizio significa di fatto terminare la sessione di lavoro dello schedulatore.  
Nel caso in cui lo schedulatore di job non stia lavorando, la procedura è in grado di arrestare in 
sicurezza il servizio.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
O P E R A Z I O N I  P R E L I M I N A RI - 13 E' da sottolineare che tale comando potrebbe avere effetti negativi se l'applicativo venisse interrotto 
nel momento in cui stesse elabora ndo un job schedulato, tale comportamento viene identificato dal 
seguente messaggio di avviso.  
Lo schedulatore sta attualmente elaborando un job. La terminazione del servizio potrebbe 
causare la perdita dei dati in elaborazione. Si è sicuri di voler arrest are la procedura?  
  
Rispondendo No alla domanda, il job non viene terminato, sarà poi possibile tentare in un secondo 
momento l'arresto del servizio.  
Nel caso in cui si risponda affermativamente il processo di schedulazione verrà terminato  
immediatamente c on la conseguente possibilità di perdita di informazioni e con la possibilità che 
alcuni dati assumano valori inconsistenti. Pertanto è vivamente sconsigliato fermare il servizio 
nel momento in cui compare tale messaggio.  
 Aggiorna  
Esegue un interrogazione per verificare nuovamente gli stati del servizio (attivo / non attivo) e dello 
schedulatore di job.  
Solo nel caso in cui la sessione dell'applicativo stia effettivamente elaborando un job, nel log verrà 
evidenziato quale  dei job schedulati è attualmente in esecuzione e da quanto tempo è in elaborazione 
(viene indicata la data di inizio elaborazione).  
 ? 
Mostra le informazioni di servizio riguardo al programma.  
  
Nella seconda pagina, Connessione, è possibile creare, canc ellare e settare alcuni parametri per il 
corretto funzionamento del servizio.  
  
 
Zucchetti Scheduler Service – Connessione


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
14 – O P E R A Z I O N I  P R E L I M I N A RI La pagina non mostra le impostazioni correnti del servizio, ma permette il suo settaggio. Le impostazioni di 
default impostano il  check attivo su Account di sistema locale: questo potrebbe però non identificare le impostazioni 
attualmente utilizzate.  
  
Account di sistema locale  
Nel caso in cui non siano necessari diritti di rete, è possibile utilizzare il servizio con un account di 
sistema locale (non è necessario specificare nessun account e nessuna password)  
 Consenti al servizio di interagire col desktop:  
Attivabile se si utilizza un account di sistema locale; se attivato, la sessione dello schedulatore avviata 
dal servizio, anzi ché lavorare in background sarà visibile come sessione di lavoro attiva.  
  
Account  
Se si seleziona la voce, occorrerà specificare un utente valido. Consigliamo di impostare tali valori 
solamente se il servizio necessita di particolari diritti di rete, ovve ro se l'installazione dell'applicativo 
risiede fisicamente su un'altra macchina.  
 Password  
Specificare una password valida per l'utente inserito nell'account.  
 Esegui all'avvio  
Agendo o meno sul check è possibile decidere se far partire all'avvio Zucchetti Scheduler Service. 
Questo permette un controllo visibile  sul Servizio.  
 Crea ed Elimina  
Gestiscono la creazione e l'eliminazione del servizio.  
 Ok Esci ed Applica  
Applica  si abilita solamente quando si attuano delle modifiche nella pagina Connessione; la pressione 
dello stesso le rende operative.  
  
Il bottone Esci permette di term inare Zucchetti Scheduler Service. Nel caso in cui il servizio sia in 
stato Non attivo , il programma viene chiuso e può essere successivamente rilanciato.  
Nel caso in cui invece il servizio sia Attivo , viene visualizzato un messaggio di avviso in cui si ch iede 
se si desidera veramente uscire.


key: chroma:document
string_value:
se si desidera veramente uscire.  
  
Rispondendo Sì verrà chiuso Zucchetti Scheduler Service, ma il servizio e di conseguenza la sessione dello 
schedulatore rimarrà attiva.  
  
Il bottone ok consente la riduzione ad icona del programma annullando eventual i modifiche.  
  
Il bottone ok non applica eventuali modifiche; per consolidarle occorre utilizzare l'apposito bottone.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
O P E R A Z I O N I  P R E L I M I N A RI - 15   
In merito all'utilizzo del servizio Zucchetti Scheduler Service è necessario precisare alcune cose :  
Lo Zucchetti Scheduler Service non può esser avviato con un path virtuale. Infatti nel caso in cui 
l'installazione di AHR sia stata effettuata su un drive virtuale e l'utente lancia l'avvio del nuovo servizio 
viene segnalato l'errore:  
Errore nell'avvio del servizio: non è possibile trovare il path specifico: verificare che non 
contenga un drive virtuale.  
  
Inoltre, nel caso si utilizzi Zucchetti Scheduler Service, non è possibile indicare un path come una 
unità mappata ( es. u:\Stampe ) ma è necessario indicare un percorso UNC . Infatti se vie ne 
specificato un percorso come unità mappata, lo Zucchetti Scheduler Service non riconosce la 
directory e nel log del job riporta il messaggio di errore Invalid path or file name. Attenzione: 
impossibile creare la cartella: u: \Stampe \ definita nel path.  
  
Nel caso in cui si utilizza risorse di rete (es stampante), anche nel caso di configurazione del servizio 
come servizio locale  occorre inserire login (nomeDominio \nomeUtente) e pwd nella cartella 
Connessione della maschera Zucchetti Scheduler Service  
  
L'informazione che i job schedulati siano eseguiti dallo Zucchetti Scheduler Service è data dalla variabile 
G_ISSERVICE memorizzata nel file scheduler.ini  all'interno della cartella \jbsh\zschsrv  
dell'applicativo. Se lo dallo Zucchetti Scheduler Service è at tivo questo assume il seguente valore 
G_ISSERVICE=.T.  
  
Configurazione file .CNF per accesso silente al Database  
Per effettuare l'accesso silente al Database in modo che all'utente non venga richiesto nessun input da 
tastiera è necessario configurare oppor tunamente il file cp3start.cnf.  
Le configurazioni possibili variano a seconda se si acceda ad un database Microsoft Sql Server o ad un 
database Oracle e Db2.


key: chroma:document
string_value:
database Oracle e Db2.  
  
Database Microsoft Sql Server  
Nel caso in cui occorra accedere ad un database Microsoft Sql Serv er sono possibili due 
configurazioni: la prima prevede una stringa così formattata e non necessita di alcun DSN configurato  
CP_DBTYPE='SQLServer'  
CP_ODBCCONN='Driver=SQLServer;  
DATABASE=AHRDEMO; 
SERVER=PC_SERVER;UID=SA;PWD=;TRUSTED_CONNECTION=NO'  
  
In alte rnativa è possibile utilizzare un DSN di Sistema  impostando nel CNF la seguente stringa:  
CP_DBTYPE='SQLServer'  
CP_ODBCCONN='DSN=AHR_DSN; UID=sa; PWD=; WSID=PC_SERVER;  
DATABASE=AHRDEMO'  
  
Database Oracle  
Nel caso in cui occorra accedere ad un database Oracl e è possibile una sola configurazione 
utilizzando necessariamente un DSN di Sistema:  
CP_DBTYPE='Oracle'  
CP_ODBCCONN= 'DSN=SSFA_ORA; UID=ute_ssfa; PWD=ute_ssfa;


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
16 – O P E R A Z I O N I  P R E L I M I N A RI DATABASE=AHRDEMO; TRUSTED_CONNECTION=no''  
  
Database Db2  
Nel caso in cui occorra accedere ad un database Db2 e è possibile specificare una configurazione 
utilizzando un DSN di Sistema:  
CP_DBTYPE ='DB2'  
CP_ODBCCONN = 
'DSN=AHRDEMO;UID=db2inst1;PWD=ibmdb2;DATABASE=AHRDEMO'  
  
Nel caso in cui si scelga di utilizzare un DSN è condizione necessaria per l'av vio del servizio di windows che tale 
DSN sia un DSN di sistema.  
  
Utilizzo del Servizio con S.O. Windows Vista  
Utilizzando un sistema operativo Windows Vista occorre prestare particolare attenzione alla 
configurazione delle impostazioni per il corretto fun zionamento del servizio utilizzato per la 
schedulazione nonché della consolle di controllo Zucchetti Scheduler Service.  
In particolare le operazioni di configurazione e di creazione del servizio, a causa delle politiche di 
sicurezza restrittive adottate da  Vista, devono essere eseguite da un utente Amministratore.  
  
E' possibile individuare due comportamenti differenti:  
  
Comportamento del Sistema Con UAC disattivato:  
disattivando UAC, Windows Vista funziona nello stesso modo delle versioni precedenti di Wi ndows. 
Gli account -amministratore possono fare potranno fare qualsiasi cosa (senza richieste di conferma) e 
gli account standard non avranno i privilegi necessari per eseguire le operazioni riservate agli 
amministratori.  
Comportamento del Sistema Con UAC a ttivato (default)  
le applicazioni vengono normalmente eseguite come se fossero state avviate da un Utente standard, 
anche se l'account corrente appartiene al gruppo degli amministratori; questo perché, a differenza 
delle versioni precedenti di Windows, per  impostazione predefinita sia gli utenti standard che gli 
amministratori accedono alle risorse ed eseguono applicazioni usando il contesto di protezione per


key: chroma:document
string_value:
amministratori accedono alle risorse ed eseguono applicazioni usando il contesto di protezione per 
utenti standard. Come detto in precedenza, se un'applicazione esegue un'operazione che richiede i 
privilegi di amministratore, UAC richiede il consenso (se l'account corrente è amministratore) o le 
credenziali di un amministratore (se l'account corrente è un utente standard) prima di consentire 
l'esecuzione dell'operazione.  
In questo caso particolare oc corre seguire attentamente la seguente documentazione  
  
Iter procedurale per un corretto utilizzo del Servizio  
Per poter configurare il servizio è necessario accedere alla procedura ad hoc avviandola come: Esegui 
come amministratore' . 
Se non si esegue ques ta modalità di avvio al momento della creazione del servizio verranno presentati 
a video diversi messaggi di impossibilità di accedere alle Risorse di Sistema:  
Errore scrittura nel registro  
Errore nell'apertura del SCMenager  
  
Inoltre in caso di utilizzo d i Vista in Rete NON DEVE  essere utilizzata la modalità Servizio di Rete  
perché il sistema non riconosce più l'eventuale mappatura della cartella di rete condivisa che viene


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
O P E R A Z I O N I  P R E L I M I N A RI - 17 sostituita automaticamente con il relativo percorso UNC.  
  
Consolle Zucchetti Sched uler Service  
Per poter utilizzare correttamente la Consolle Zucchetti Scheduler Service è necessaria che anche 
questa sia avviata in modalità Esegui come amministratore' in quanto utenti standard e/o utenti 
amministratori necessitano su Vista di ulteriori particolari diritti di accesso alle strutture del Sistema.  
Pertanto se si avvia la Consolle in modalità Standard non sarà possibile avviare, arrestare o configurare 
il servizio.  
Non sarà inoltre possibile utilizzare l'opzione Esegui all'avvio in quanto anc he in questo caso 
l'eventuale avvio di. Zucchetti Scheduler Service anche loggandosi come utente Amministratore, non 
avrà i particolari diritti di cui necessita.  
Consigliamo quindi di non utilizzare l'opzione citata.  
  
N.B. il servizio verrà comunque attiv ato all'avvio della macchina lanciando di conseguenza una sessione dell'utente 
schedulatore.  
Per averne il controllo occorrerà avviare manualmente in modalità Esegui come Amministratore, Zucchetti 
Scheduler Service.  
  
Nel caso in cui si decida di configura re il servizio in modo tale che possa interagire col desktop 
Windows Vista ha un comportamento differente rispetto ai precedenti Sistemi Operativi; infatti 
all'avvio del programma verrà visualizzata una finestra di Rilevamento finestre di dialogo dei servi zi 
interattivi come da figura seguente.  
  
 
Maschera rilevamento finestra di dialogo dei servizi interattivi  
  
Pertanto per poter avere accesso alla visualizzazione del programma avviato selezionare l'opzione 
mostra messaggio .


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
18 – O P E R A Z I O N I  P R E L I M I N A RI  Caricamento gestioni certificate  
  
Le gestioni di Ad Hoc Revolution già certificate per essere eseguite dallo Schedulatore di Job vengono 
memorizzate nell'anagrafica Gestioni Schedulatore, ove vengono specificati i parametri d a catturare 
durante le fotografie di configurazione delle maschere.  
  
Tale anagrafica viene popolata automaticamente alla prima pressione dei tasti CTRL+F11. L'utente 
può decidere di certificare direttamente l'utilizzo di una certa gestione, oppure utilizz are le 
configurazioni rilasciate con il modulo, che possono essere importate con la funzione Carica/Salva 
Dati Esterni:  
  
 
Caricamento gestioni certificate  
  
Le configurazioni delle Gestioni Certificate rilasciate con il modulo sono disponibile all'intern o del file 
JBSH.TXT presente nella sottocartella EXE \FILES_X_IMPORT. Tali configurazioni possono 
essere adattate in base alle necessità dell'utente, ad esempio disattivando/attivando dalla Fotografia 
determinati parametri, oppure impostandone altri con val ori prefissati.  
  
Nelle Gestioni Certificate rilasciate con il modulo sono state eliminate le seguenti tipologie di 
parametri dalla Fotografia, in modo che vengano inizializzati con le impostazioni di default:  
Le descrizioni di altri parametri presenti nel la gestione non editabili, e quindi non configurabili da 
parte dell'utente;  
Le date valorizzate di default con la data di sistema, gli intervalli di date relativi alla data di sistema, 
oppure i parametri contenenti l'esercizio corrispondente alla data di s istema: in questo modo risulta 
possibile utilizzare la medesima Fotografia anche in periodi differenti;  
Le chiavi primarie delle gestioni di tipo anagrafico (come ad esempio l'elaborazione Inventario di 
magazzino), in quanto valorizzate automaticamente in modo progressivo.


key: chroma:document
string_value:
magazzino), in quanto valorizzate automaticamente in modo progressivo.  
  
Se l'utente ritenesse necessario Fotografare i parametri eliminati nelle gestioni certificate, può 
comunque riattivarli modificando la corrispondete anagrafica Gestioni Schedulatore.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
O P E R A Z I O N I  P R E L I M I N A RI - 19  Gestione cartella stampe  
  
Tutti i report generati dalle gestioni schedulate vengono salvate in un file in formato PDF all'interno 
della cartella definita su ciascun Job (richiamabili poi dalla Visualizzazione Log di Elaborazione). È 
comunque possibile abili tare anche la stampa cartacea, attivando l'apposito check presente 
nell'anagrafica del Job.  
  
Nel caso tale cartella non sia stata definita all'interno del Job, sarà utilizzata la cartella di default 
specificata in Contropartite e Parametri Gestione Percor si. 
  
 
Gestione cartella stampe


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
20 – O P E R A Z I O N I  P R E L I M I N A RI  Utente esecutore dei job  
  
Nel caso in cui fossero presenti più utenti schedulatori la procedura, previa opportuna 
parametrizzazione, consente all’utente di eseguire solo job a lui assegnati.  
  
Per far si che la procedur a operi l’assegnazione dei job ai rispettivi utenti è necessario che l’utente 
schedulatore, per il quale si decide vengano svolti solo i job a lui assegnati, presenti attivo nella cartella 
“ Abilitazione servizi”, della maschera “Servizi FAX/Telefono/Mail/P ostaLite/Web”, il flag: “Esegue 
solo job assegnati”.  
  
 
Servizi FAX Telefono Mail PostaLite Web - Abilitazione servizi  
  
Per gli utenti schedulatori che hanno attivo il flag: “Esegue solo job assegnati” la procedura effettuerà 
l’esecuzione dei soli job in  cui ogni singolo utente sarà citato nel campo: “Utente preferenziale”.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
O P E R A Z I O N I  P R E L I M I N A RI - 21   
Nel caso il cui un utente schedulatore ha attivo il flag sopra descritto ma in nessun job risulta citato 
come: “Utente preferenziale” per questo utente non verrà mai eseguito nessun job. 
  
Nel caso di utenti schedulatori che non hanno attivato il flag: “Esegue solo job assegnati” verranno 
eseguiti tutti i job a prescindere dalla presenza di un “Utente preferenziale” nei job eseguibili.  
  
 
Schedulatore di job - Schedulazione  
  
Natural mente il campo “Utente preferenziale” è presente anche nelle Proattività ed anche per queste 
la procedura segue il comportamento sopra descritto.  
  
Infine, per agevolate l’Utente finale, tramite la maschera di “ Attivazione proattività” è possibile 
aggiorna re l’utente preferenziale in maniera massiva selezionando le pro attività da aggiornare ed 
agendo sul bottone “ Assegna” una volta impostato un utente nell’apposito campo.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
22 – O P E R A Z I O N I  P R E L I M I N A RI 
 
Proattività - Schedulazione  
  
 
Attivazione proattività


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
O P E R A Z I O N I  P R E L I M I N A RI - 23  Utente schedulatore ac tivity logger  
  
E' data la possibilità di utilizzo dell'activity logger anche per l'utente schedulatore.  
  
Nella application bar dell’utente schedulatore è presente il bottone Log che permette di 
parametrizzare l’Activity logger anche per l’utente schedula tore. 
  
 
Application bar  
  
Il bottone apre la maschera di Activity logger setting per la parametrizzazione della modalità di 
tracciatura delle operazioni compiute dall’utente schedulatore.  
  
 
Activity logger setting


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
24 – O P E R A Z I O N I  P R E L I M I N A RI 
 
_________________________________ _______________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
______________________________________________ __________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
___________________________________________________________ _____________________  
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________ ________  
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
____ ____________________________________________________________________________  
________________________________________________________________________________  
_______________________________________________________________________________


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
C E R T I F I C A Z I O N E  G E S T I ONI  - 25  CERTIFICAZIONE GESTIO NI 
  
In questo capitolo saranno discusse le caratteristiche che le gestioni di Ad Hoc Revolution devono 
possedere affinché siano pianificabili con lo Schedulatore di Job, e gli accorgimenti da adottare pe r 
definire una nuova gestione certificata.  
  
 Caratteristiche gestioni certificate  
 Gestioni schedulatore  
 Schedulazione ristampa documenti con selezione di una sola 
causale


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
26 – C E R T I F I C A Z I O N E  G E S T I O N I   Caratteristiche gestioni certificate  
  
Il modulo Schedulatore di Job è potenzialmente utilizzabile con qualunque maschera di 
stampa/elaborazione ( Mask ), come ad esempio la Creazione Archivio Statistico, e con qualun que 
Anagrafica ( Master ), come ad esempio l'Elaborazione Inventario.  
  
Step Esecuzione Processo  
Durante l'esecuzione di ogni Processo vengono eseguiti automaticamente i seguenti passi:  
1. Apertura della maschera (eseguito evento Init; per le entità Master v iene eseguito l'evento 
ecpLoad  che implica l'evento Init). 
2. Assegnamento di tutti i parametri specificati nell'anagrafica Gestioni Schedulatore che non 
risultano Eliminati (opzione Elimina) con quanto catturato nella relativa fotografia del Processo 
(ove vengono intercettati tutti i parametri visibili).  
3. Assegnamento di tutti i parametri forzati all'interno dell'anagrafica Gestioni Schedulatore 
(opzione Sostituisci).  
4. Assegnamento degli altri parametri non catturati mediante il loro valore di default (eseguendo 
gli eventuali Link e Calcolate  presenti sulla maschera).  
5. Per dare inizio all'elaborazione viene infine simulata la pressione del bottone Salva presente 
nella Tool Bar, od il corrispondente tasto F10 (eseguito evento ecpSave ). 
6. Per tutti i m essaggi presentati a video durante l'elaborazione ( cp_Error Msg e cp_YesNo ) viene 
data una risposta automatica (in caso di opzione Si/No, la risposta viene sempre impostata a Si), 
e ne viene tenuta traccia all'interno del Log di Elaborazione legato al Proce sso. 
7. Gli eventuali report prodotti dall'elaborazione vengono salvati in formato PDF all'interno 
della cartella definita nell'anagrafica Schedulatore di Job (o in mancanza nella Gestione Cartella 
Stampe).  
8. Viene infine chiusa la maschera (le gestioni M aster vengono chiuse eseguendo due volte


key: chroma:document
string_value:
8. Viene infine chiusa la maschera (le gestioni M aster vengono chiuse eseguendo due volte 
l'evento ecpQuit : la prima esce dalla fase di caricamento e la seconda chiude effettivamente la 
maschera).  
  
Gestioni Schedulabili  
Con riferimento ai passi del Processo descritti sopra, di seguito vengono riportate le caratteristiche 
richieste alle gestioni che si desidera schedulare, e le eventuali modifiche necessarie ai programmi per 
renderle compatibili:  
Non presentano Zoom e Zoom con selezione: per gestire la selezione delle righe è necessario 
modificare la masc hera implementando un'opzione da utilizzarsi con lo schedulatore.  
  
Gli eventuali messaggi di richiesta con opzione Si/No ( cp_YesNo ) devono essere strutturati in modo 
da consentire una prosecuzione dell'elaborazione scegliendo Si (visto che lo schedulatore  risponde 
automaticamente sempre in quel modo).  
  
Non devono essere presenti routine che utilizzino funzioni di tipo Wait Window  o MessageBox . In 
presenza di tali funzioni sarà opportuno sostituire le Wait Window  con la funzione cp_MSG ed inserire 
un contr ollo sulla presenza dello schedulatore per evitare l'esecuzione dei MessageBox  
(TYPE(g_SCHEDULER)='C' AND g_SCHEDULER='S').


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
C E R T I F I C A Z I O N E  G E S T I O N I  - 27 Non sono schedulabili stampe Solo Testo, ma solo stampe in formato grafico.  
Non devono essere lanciate altre maschere durante l'el aborazione (viene valorizzata solo la maschera 
principale della gestione).  
All'interno del Log di Elaborazione vengono memorizzati tutti i messaggi a video (prodotti dalle 
funzioni cp_ErrorMsg  e cp_YesNo ). Ulteriori informazioni di Log che dovessero essere  necessarie 
devono essere gestite inserendole nei programmi, sfruttando ad esempio la funzione ADDMSG (che 
memorizza i dati di log all'interno della variabile memo w_MSG).


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
28 – C E R T I F I C A Z I O N E  G E S T I O N I   Gestioni schedulatore  
  
Le configura zioni delle gestioni utilizzabili dallo schedulatore sono memorizzate nell'anagrafica 
Gestioni Schedulatore, in modo da rendere controllabili le modalità di passaggio dei parametri alle 
maschere. Con il modulo vengono rilasciate configurazioni per diverse gestioni già certificate, 
caricabili attraverso la funzione Carica/Salva Dati Esterni (menu Sistema).  
  
Durante la cattura della fotografia di una gestione (premendo la combinazione di tasti CTRL+F11 ) 
viene scandita la tabella Gestioni Schedulatore per la verifica della sua configurazione. Nel caso la 
gestione non fosse ancora certificata viene presentato il seguente messaggio:  
Attenzione!! La gestione non è gestita dallo schedulatore. Si desidera inserire la gestione?  
  
Rispondendo affermativamente al mess aggio di avviso, viene aperta la maschera Gestioni 
Schedulatore in caricamento della configurazione, con preimpostati tutti i parametri visibili della 
maschera.  
  
 
Gestioni schedulatore  
  
 Gestione, Descrizione  
E' il codice della gestione che si desidera  certificare, preimpostato automaticamente dalla procedura. 
Non deve essere di norma modificato, altrimenti la procedura non riesce più ad associarlo alla 
gestione da fotografare.  
  
La Descrizione viene preimpostata con il titolo della gestione da catturar e. 
 Chiusura  
Tipologia di chiusura della maschera. Può assumere i valori:


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
C E R T I F I C A Z I O N E  G E S T I O N I  - 29  Nessuno: Non esegue alcuna operazione dopo la valorizzazione dei parametri  
 Save (F10): Simula la pressione del tasto F10 dopo la valorizzazione dei Parametri  
 Quit: Simula la pres sione del tasto ESC dopo la valorizzazione dei Parametri  
 Nome Parametro  
Codice del parametro da catturare. Siccome vengono memorizzati automaticamente solo i parametri 
visibili sulla gestione, le eventuali variabili nascoste che si dovessero passare al p rocesso devono essere 
definite nell'archivio Gestioni Schedulatore, affinché possano poi essere valorizzate nei parametri del 
Job. 
  
Caso tipico riguarda la selezione di una stampa diversa da quella di default tra quelle presenti 
nell'Output Utente, ove è necessario caricare manualmente le variabili w_OQRY per il percorso della 
query e w_OREP per il percorso del report (precedentemente definite nella gestione certificata).  
 Descrizione  
Descrizione del parametro da catturare. Viene preimpostata con il messaggio di tooltip associato al 
parametro sulla maschera.  
 Azione  
Per ciascun parametro potenzialmente catturabile da una fotografia di configurazione può essere 
definito un o dei seguenti tre stati:  
 Nessuna Opzione (default): la gestione viene avviata con il valore del parametro al momento 
della fotografia;  
 Elimina: il parametro non viene catturato al momento della fotografia; sarà eventualmente 
preimpostato con il suo va lore di default, se presente;  
 Sostituisci: il parametro non viene catturato al momento della fotografia; sarà invece 
valorizzato con quanto specificato nel campo Valore da Sostituire.  
  
Nelle Gestioni Certificate rilasciate con il modulo sono state elimi nate le seguenti tipologie di 
parametri dalla fotografia, in modo che vengano inizializzati con le impostazioni di default:


key: chroma:document
string_value:
parametri dalla fotografia, in modo che vengano inizializzati con le impostazioni di default:  
Le descrizioni di altri parametri presenti nella gestione non editabili, e quindi non configurabili da 
parte dell'utente;  
Le date va lorizzate di default con la data di sistema, gli intervalli di date relativi alla data di sistema, 
oppure i parametri contenenti l'esercizio corrispondente alla data di sistema: in questo modo risulta 
possibile utilizzare la medesima Fotografia anche in pe riodi differenti;  
Le chiavi primarie delle gestioni di tipo anagrafico (come ad esempio l'elaborazione Inventario di 
magazzino), in quanto valorizzate automaticamente in modo progressivo.  
 Valore da Sostituire  
Nel caso sia stata specificata l'opzione Sost ituisci, in questo campo deve essere indicato il valore da 
attribuire al parametro al momento di avvio della gestione.  
 Tipo  
Indica il Tipo di Parametro. Può assumere i valori:  
 Variabile: il parametro rappresenta una proprietà della maschera  
 Bottone: il parametro rappresenta un bottone della maschera


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
30 – C E R T I F I C A Z I O N E  G E S T I O N I  ATTENZIONE: L'inserimento dei una nuova gestione non rilasciata con il modulo NON assicura la sua 
corretta esecuzione mediante lo Schedulatore. La Certificazione di una gestione implica la sua compatibil ità con i 
criteri indicati nel paragrafo precedente.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
C E R T I F I C A Z I O N E  G E S T I O N I  - 31  Schedulazione ristampa documenti 
con selezione di una sola causale  
  
Viene data la possibilità di pianifica re la schedulazione della ristampa documenti selezionando una 
sola tipologia di documenti.  
  
 
Ristampa documenti di vendita  
  
 Tipo documento  
E' stato aggiunto sulla maschera di ristampa documenti (vendita e acquisto) e ristampa ordini il campo 
relativo alla causale documento (o causale ordine), che deve valorizzarsi tramite il codice selezionato 
dall'utente nella lista delle causali documenti.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
32 – C E R T I F I C A Z I O N E  G E S T I O N I  Il campo è editabile e obbligatorio se l'utente si limita a selezionare solo una causale documento nella 
griglia  ma diventa non editabile se l'utente seleziona più di una causale.  
Nel caso in cui non sia stata inserita nessuna causale documento la procedura emette a video un 
messaggio bloccante.  
  
Nel caso in cui l'utente seleziona tutti i documenti il nuovo campo T ipo documento diventa non 
editabile.  
  
 
Ristampa ordini con tasto Ctrl + F11  
  
Lo stesso vale per la ristampa documenti di acquisto e la ristampa ordini.  
  
Dopo aver selezionato la causale occorre premere CTRL+F11 per attivare la gestione dello 
schedulato re in base alle impostazioni della maschera prescelta.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
C E R T I F I C A Z I O N E  G E S T I O N I  - 33 
 
Nuova gestione schedulazione documenti vendita


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
34 – C E R T I F I C A Z I O N E  G E S T I O N I  
 
________________________________________________________________________________  
_______________________________________________________________ _________________  
________________________________________________________________________________  
________________________________________________________________________________  
____________________________________________________________________________ ____  
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
________ ________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
_____________________ ___________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
__________________________________ ______________________________________________  
_______________________________________________________________________________


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
S C H E D U L A Z I O N E  J O B  - 35  
 SCHEDULAZIONE JOB  
  
In questo capitolo vengono descritte le operazioni richieste per catturare un fotografia di 
configurazione di una gestione, ed i possibili riscontri sulla sua esecuzione da parte dello schedulatore.  
  
 Fotografare una gestione  
 Schedulatore di job  
 Stampa job  
 Log elaborazione  
 Visualizzazione log di elaborazione  
 Selez ione gruppo schedulatore  
 Stampa log


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
36 – S C H E D U L A Z I O N E  J O B   Fotografare una gestione  
  
Per schedulare una gestione certificata è necessar io eseguire i seguenti passaggi:  
Definizione di un nuovo Processo da schedulare, attraverso la cattura dei parametri da utilizzarsi per 
l'esecuzione della gestione;  
Inserimento del Processo in un nuovo Job od in un Job preesistente;  
Definizione della frequ enza di lancio del Job, e degli eventuali utenti/gruppi interessati alla sua 
esecuzione;  
Avvio della Sessione Schedulatore, che si preoccuperà dell'effettivo lancio del Job in base alla 
frequenza stabilita, ed attivazione del Job.  
  
Definizione Nuovo Proce sso da Schedulare  
La definizione di un nuovo Processo da schedulare passa per la cattura dei parametri richiesti dalla 
gestione da eseguire. A tale scopo è sufficiente aprire una gestione certificata (ovvero compatibile con 
lo Schedulatore e per la quale è  presente una configurazione nell'archivio Gestioni Schedulatore), 
preimpostare i parametri con i valori che si desidera catturare e quindi premere la combinazione di 
tasti CTRL+F11 . 
  
Se la gestione risulta essere già certificata viene presentata la masch era Inserimento Processo in Job, 
attraverso la quale può essere creato un nuovo Job, oppure accodare il Processo ad un Job 
preesistente.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
S C H E D U L A Z I O N E  J O B  - 37 
 
Inserimento Processo in un Job  
  
L'elenco nella parte alta della maschera contiene tutti i Job già caricati, con l' indicazione della data ed 
ora di successiva esecuzione. L'elenco nella parte inferiore presenta invece i processi preesistenti per 
ciascun Job selezionato.  
  
Il Processo che è stato appena catturato può essere inserito in un nuovo Job, premendo il bottone 
Carica, oppure accodato ad un Job preesistente, con il bottone Modifica. Entrambi i bottoni aprono la 
gestione Schedulatore di Job: il primo il caricamento ed il secondo il modifica; per confermare 
l'operazione è quindi sufficiente salvare tale gestione (t asto F10).  
 Aggiorna  
Con questo bottone viene effettuato un aggiornamento dei Job visualizzati (e dei relativi Processi).  
 Mostra  
Premendo questo bottone viene aperta in interrogazione la gestione del Job selezionato, in modo che 
l'utente possa prendere visione delle informazioni di dettaglio non presentate nell'elenco.  
 Modifica  
Con questo bottone si decide di accodare il Processo catturato (con l'ultima fotografia di 
configurazione) al Job selezionato, nel caso si desideri che venga eseguito con la med esima frequenza 
temporale in coda ai Processi preesistenti.  
 Carica  
Con questo bottone si decide di creare un nuovo Job in cui inserire il Processo catturato (con l'ultima 
fotografia di configurazione). Ha senso quando si tratta di un'operazione logicamen te separata dai Job 
preesistenti, oppure con frequenza temporale differente.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
38 – S C H E D U L A Z I O N E  J O B   Esci 
Premendo questo bottone viene abbandonata l'operazione di inserimento del Processo.  
  
 
Maschera Schedulatore di Job: inserimento del Processo in un nuovo Job


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
S C H E D U L A Z I O N E  J O B  - 39  Schedulatore di job  
  
In questa gestione vengono memorizzate le configurazioni di ciascun Job, con i parametri dei relativi 
Processi. Molti dati vengono caricati automaticamente dalla funzione di cattura fotografie, me diante i 
bottoni Carica e Modifica nella maschera di Inserimento Processo in Job. L'utente deve normalmente 
decidere solo la frequenza di lancio del Job e gli eventuali destinatari e -mail ai quali inviare l'avviso di 
esecuzione.  
  
Schedulatore di job - Schedulazione  
  
 
Schedulatore di job - Schedulazione  
  
 Codice  
Codice numerico progressivo che identifica il Job, proposto automaticamente dalla procedura.  
 Attivata  
Il Job sarà processato, nei tempi previsti dalla frequenza di lancio, solo se è stato atti vato questo check.  
 Descrizione Job  
La descrizione del Job viene valorizzata automaticamente con il titolo della gestione per la quale è 
stata catturata una fotografia di configurazione.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
40 – S C H E D U L A Z I O N E  J O B   Esecuzione con Riavvio  
Attivando il check Esecuzione con riavvio  è possibile chiudere la sessione dello schedulatore prima 
di eseguire il job schedulato, tale funzionalità si rende utile nel caso in cui siano state schedulate 
operazioni Onerose.  
Per operazioni onerose, intendiamo l'esecuzione di funzionalità che comporta no il trattamento di 
grandi quantità di informazioni.  
Eseguendo tali operazioni è stato riscontrato che alcune informazioni rimanevano allocate in 
memoria con conseguente perdita di prestazioni dell'intero sistema, attivando il check viene forzata la 
chius ura dello schedulatore con conseguente rilascio della memoria occupata.  
  
L'attivazione di tale check è correlato all'utilizzo del servizio Zucchetti Scheduler Service ed alla sua corretta 
configurazione. Alla chiusura della sessione dello schedulatore ne consegue il successivo riavvio reso possibile dal 
servizio di Schedulazione.  
  
 Creato - Variato Da, In Data  
In questi campi viene evidenziato l'utente che ha creato il Job e l'ultimo che lo ha modificato, con le 
corrispondenti date di creazione e modifica.  
 Frequenza di Lancio  
Il Job può essere eseguito una sola volta oppure perio dicamente con un determinata frequenza di 
lancio; è possibile decidere l'orario di lancio e l'eventuale giorno della settimana o del mese.  
 Frequenza di Lancio Unica. Il Job viene eseguito alla Data di Prossima Esecuzione (campo 
che risulta editabile solo  per questo tipo di frequenza) nell'orario stabilito (campo Ora).  
  
 
Frequenza di lancio Unica  
  
 Frequenza di Lancio Giornaliera. Il Job viene eseguito ogni intervallo di giorni specificato 
(campo Ogni) nell'orario stabilito (campo Ora).  
  
 
Frequenza d i lancio Giornaliera  
  
 Frequenza di Lancio Settimanale. Il Job viene eseguito ogni intervallo di settimane specificato


key: chroma:document
string_value:
 Frequenza di Lancio Settimanale. Il Job viene eseguito ogni intervallo di settimane specificato 
(campo Ogni), in tutti i giorni della settimana attivati, nell'orario stabilito (campo Ora).


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
S C H E D U L A Z I O N E  J O B  - 41 
 
Frequenza di lancio Settimanale  
  
 Frequenza di Lancio Mensile. Il Job viene eseguito una volta al mese per tutti i mesi attivati, a 
fine mese oppure a data fissa, nell'orario stabilito (campo Ora).  
  
 
Frequenza di lancio Mensile  
  
  
Prossima esecuzione  
 Data e Ora di Prossima Esecuzione  
In questi campi viene riportata la data e l'ora di prossima esecuzione del Job. Vengono calcolati 
automaticamente dalla procedura in base alla frequenza di lancio stabilita; solo nel caso di frequenza 
Unica è necessario imputare manualmente la data di prossi ma esecuzione.  
 Tempo Massimo di Attesa  
Tutti i Job processati da una certa Sessione Schedulatore vengono processati in modo sequenziale, in 
base alla loro data e ora di inizio. Se al momento di inizio stabilito per un certo Job ne fosse in 
esecuzione un altro, il primo  verrebbe accodato.  
  
In questo campo è possibile specificare un tempo massimo di attesa dei Job che non possono essere 
eseguiti nell'esatto momento di schedulazione, dopo il quale i Job vengono posticipati al successivo 
intervallo di pianificazione.  
 Inserimento data manuale  
Viene offerta la possibilità di modificare manualmente la data prossima esecuzione, di un job 
schedulato, attivando un check sulla maschera del job stesso.  
Il sopra citato flag: “Inserimento data manuale” risulterà editabile solo se l a frequenza di lancio è 
diversa da “unica”.  
Attivato il flag diventano campi obbligatori la data e l’ora della prossima esecuzione; la procedura


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
42 – S C H E D U L A Z I O N E  J O B  procederà alla prossima esecuzione del job a partire dalla data e dall’ora così caricate  
 Calcola  
I campi Data e Ora di Prossima Esecuzione vengono valorizzati automaticamente al salvataggio della 
gestione e dopo ogni esecuzione del Job. L'utente può comunque forzarne il calcolo, simulando 
l'effetto della frequenza impostata, mediante la pres sione del bottone Calcola.  
  
Dati elaborazione  
In questa sezione vengono memorizzate la data e l'ora nelle quali il Job ha avuto inizio ed è terminato, 
l'ultima volta in cui è stato eseguito.  
  
Stampa Pdf  
 Path  
In questo campo può essere specificata la ca rtella in cui memorizzare le stampe prodotte da un 
processo schedulato in formato PDF .  
Se tale path non viene specificato, lo schedulatore salva il pdf nella cartella specificata nella Gestione 
Path presente nel menù Archivi – Azienda – Gestione Path (Atte nzione: ogni azienda dispone di un 
path specifico.  
 Abilita Stampa Cartacea  
Attivando questo check, le stampe prodotte da un processo schedulato possono essere anche 
stampate direttamente sulla stampante predefinita, oltre ad essere salvate in formato PDF .  
 Invio Stampe per E -Mail  
Attivando tale combo ve ngono inviate tutte le stampe in formato PDF  
 Solo log: a tutti i destinatari definiti nell’apposita sezione viene inviato solo il risultato 
prodotto dalla schedulazione del job in un file allegato in formato ‘pdf ’;  
 Log e stampe: a tutti i destinatari  definiti nell’apposita sezione viene inviato sia il risultato 
prodotto dalla schedulazione del job, sia l’allegato della stampa inerente l’elaborazione avvenuta 
in file allegati in formato ‘pdf ’;  
 Selezione su destinatari: la scelta di inviare solo il l og oppure anche le stampe delle 
elaborazioni è demandata al singolo destinatario, quindi per alcuni utenti si potrà decidere di


key: chroma:document
string_value:
elaborazioni è demandata al singolo destinatario, quindi per alcuni utenti si potrà decidere di 
inviare solo il log, ad altri solo le stampe, ad altri ancora entrambi.  
  
Così come per la proattività, anche per lo schedulator e di job è stata data la possibilità di scegliere la 
modalità di invio delle elaborazioni prodotte dai job processati: sarà così possibile scegliere la modalità  
‘post in’ oppure ‘e -mail’.  
Nel caso di invio mediante e -mail ovviamente la procedura effettua i l controllo sulla presenza 
dell’indirizzo di posta dell’utente a cui si intende inviare la comunicazione dell’elaborazione prodotta 
dal job eseguito; se non viene rilevato alcun indirizzo di posta elettronica per i destinatari selezionati,  
la procedura ne darà evidenza nel file di log finale.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
S C H E D U L A Z I O N E  J O B  - 43 Schedulatore di job - Destinatari  
  
 
Schedulatore di job - Destinatari  
  
Nella scheda Destinatari può essere specificato un elenco di utenti e/o gruppi ai quali inviare una e -
mail di avviso per l'avvenuta esecuzione  del Job, contenente in allegato (formato PDF) i messaggi di 
Log prodotti dall'elaborazione. L'indicazione del gruppo implica l'invio del messaggio a tutti gli utenti 
appartenenti. A tale scopo viene utilizzato l'indirizzo e -mail memorizzato nella gestione  Servizi Fax / 
E-Mail / We / Postalite. È supportato solo il servizio SMTP .


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
44 – S C H E D U L A Z I O N E  J O B  Schedulatore di job - Processi  
  
 
Schedulatore di job - Processi  
  
Nella scheda Processi viene memorizzata la coda dei Processi associati al Job, con gli annessi 
parametri cattu rati con la fotografia di configurazione delle gestioni da schedulare.  
  
Per le gestioni di tipo Anagrafica ( Master ) e Maschera ( Dialog ) il caricamento dei Processi viene 
effettuato automaticamente con una fotografia di configurazione; l'utente può caricar e manualmente 
solo nuovi Processi di tipo Routine.  
 Posizione  
Numero progressivo che indica la sequenza di esecuzione dei Processi.  
 Nome  
E' il codice della gestione oggetto del Processo: viene preimpostato automaticamente dalla procedura 
alla cattura di una fotografia di configurazione. Non deve essere di norma modificato (salvo per i 
processi di tipo Routine), altrimenti la procedura non riesce più ad associarlo alla gestione da 
fotografare.  
 Tipo  
Rappresenta il tipo di Processo da schedulare, non modificabile e valorizzato automaticamente in base 
alla categoria di gestione:  
 Master: nel caso di fotografia di una gestione Anagrafica;  
 Dialog: nel caso di fotografia di una gestione Maschera;  
 Routine: nel caso di caricamento manuale di una routine.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
S C H E D U L A Z I O N E  J O B  - 45  Codice Azienda  
Il Job può eseguire Processi relativ amente a diverse Aziende della procedura: è sufficiente catturare le 
diverse fotografie di configurazione nelle rispettive aziende ed associarle allo stesso Job. Per ciascun 
processo viene evidenziata l'azienda relativa.  
  
Il medesimo utente schedulatore p uò gestire più aziende, modificando automaticamente l'azienda prima di eseguire il 
relativo Processo. A questo scopo è necessario che tale utente sia associato a tutte le aziende per le quali ci sono 
Processi da elaborare (archivio Sistema -Utenti/Azienda).  
  
 Descrizione Programma  
Descrizione del Processo, valorizzata automaticamente con il titolo della maschera di gestione.  
 Chiusura  
Tipologia di chiusura della maschera. Può assumere i valori:  
 Nessuno: Non esegue alcuna operazione dopo la valorizzazion e dei parametri  
 Save (F10): Simula la pressione del tasto F10 dopo la valorizzazione dei Parametri  
 Quit: Simula la pressione del tasto ESC dopo la valorizzazione dei Parametri  
 Parametri  
La pressione di questo bottone consente l'apertura dei parametri  catturati relativamente al Processo 
selezionato. L'utente ha la possibilità di effettuare le seguenti variazioni alla fotografia già catturata:  
Eliminare (tasto F6) i parametri che non si desidera più passare alla gestione;  
Aggiungere nuovi parametri. Cas o tipico riguarda la selezione di una stampa diversa da quella di 
default tra quelle presenti nell'Output Utente, ove è necessario caricare manualmente le variabili 
w_OQRY per il percorso della query e w_OREP per il percorso del report (precedentemente def inite 
nella gestione certificata);  
Passare un parametro da un processo ad un altro (opzione Passa). Può essere utile, ad esempio, 
passare il codice progressivo dell'inventario elaborato alla gestione di stampa inventario;


key: chroma:document
string_value:
passare il codice progressivo dell'inventario elaborato alla gestione di stampa inventario;  
Impostare il valore di un parametr o con un altro parametro di un Processo precedente (opzione 
Riceve);  
Inserimento manuale dei parametri, nel caso il processo sia di tipo Routine.  
  
Affinché un parametro possa essere definito nella maschera Parametri è necessario che sia stato precedenteme nte 
caricato (in automatico o manualmente) nell'archivio Gestioni Schedulatore. Il caricamento manuale è normalmente 
richiesto in caso si vogliano dichiarare parametri nascosti (w_OQRY e w_OREP per l'Output Utente), oppure in 
presenza di processi di tipo R outine (ove è deve essere caricata una nuova gestione con il nome della Routine).


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
46 – S C H E D U L A Z I O N E  J O B    
 
Parametri  
  
 Nome Parametro  
Codice del parametro presente sulla gestione catturata. Deve essere un parametro memorizzato 
all'interno della gestione certificata; può essere selezionato mediante lo zoom.  
 Descrizione  
Descrizione del parametro catturato. Viene preimpos tata con il messaggio di tooltip associato al 
parametro sulla maschera.  
 Passaggio  
I parametri di un determinato processo possono essere valorizzati con il valore assunto da altri 
parametri in processi precedenti. Il collegamento viene attivato impostando  l'opzione Passa sul 
parametro di origine, e l'opzione Riceve su quello/i di destinazione:  
 Nessuna Opzione (default): il parametro del processo sarà valorizzato con quanto definito 
nel campo Valore Parametro;  
 Passa: il parametro può essere utilizzato c ome valore di origine per altri parametri presenti in 
Processi successivi all'interno dello stesso Job. Non viene impostato in fase di esecuzione del 
processo, bensì sarà valorizzato automaticamente dalla procedura (con un valore di default 
oppure con un c odice progressivo);  
 Riceve: il fase di esecuzione del processo, il parametro sarà impostato con il valore assunto 
dal parametro con codice specificato nel campo Valore Parametro, presente in processi 
precedenti all'interno dello stesso Job. La selezione del parametro di ori gine viene effettuata 
premendo l'apposito bottone sulla destra della maschera.  
 Valore Parametro  
Può assumere diversi contenuti in base all'opzione selezionata nel campo Passaggio:  
Nessuna Opzione (default) : il valore da attribuire al parametro in fase di  esecuzione del processo 
(catturato automaticamente con la fotografia di configurazione della gestione);  
Riceve : il codice del parametro di origine con il quale pre impostarne il valore in fase di esecuzione del 
processo;


key: chroma:document
string_value:
processo;  
Passa:  il questo caso non sarà edi tabile, in quanto valorizzato automaticamente dalla procedura con un 
valore di default oppure con un codice progressivo.  
I valori da attribuire ai parametri di tipo stringa devono essere racchiusi tra doppi apici , mentre le date 
possono essere dichiarate utilizzando la funzione CTOD; ad esempio CTOD('01 -01-2004').  
 Tipo  
Indica il Tipo di Parametro. Può assumere i valori:  
 Variabile: il parametro rappresenta una proprietà della maschera  
 Bottone: il parametro rappresenta un bottone della maschera  
 ... 
Questo bottoncino è visibile solo per i parametri con opzione Riceve; premendolo viene presentato 
un elenco con i parametri di origine (per i quali è stata specificata l'opzione Passa). La selezione di un 
parametro di origine è possibile solo dopo l'imposta zione dell'opzione Passa e quindi il salvataggio del


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
S C H E D U L A Z I O N E  J O B  - 47 Job. 
  
 
Selezione parametro  
  
La selezione di un parametro dell'elenco viene riportata automaticamente nel campo Valore 
Parametro.  
  
Schedulatore di job - Log 
  
 
Schedulatore di job - Log


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
48 – S C H E D U L A Z I O N E  J O B  Nella sched a Log, infine, vengono riportati tutti i messaggi per ciascuna elaborazione di Job avvenuta, 
il riscontro di eventuali anomalie ed il collegamento alle stampe in PDF generate.  
  
Elenco Log  
Questo elenco riporta la lista di tutte le elaborazioni effettuate per il Job, ordinata in modo 
decrescente in base alla data di inizio. Viene riportata la data di inizio e di fine per ciascuna 
elaborazione.  
  
Elenco Processi  
Relativamente all'elaborazione selezionata (nell'elenco sulla sinistra della maschera), in questo  elenco 
vengono presentati i codici dei processi eseguiti, con l'ordine di elaborazione. I processi che hanno 
dato luogo ad anomalie di elaborazione vengono evidenziati con il colore rosso.  
 Messaggio di Log  
Relativamente al Processo selezionato (nell'ele nco sulla destra della maschera), in questo campo viene 
presentato l'intero messaggio di log prodotto dall'elaborazione, contenente:  
La data e l'ora di inizio e fine elaborazione;  
Le informazioni di avanzamento dell'elaborazione, presentate sia nei campo M emo a scorrimento, sia 
nelle finestre di avvertimento;  
Gli avvisi presentati nelle finestre di richiesta/conferma ( cp_ErrorMsg  e cp_YesNo) , alle quali lo 
schedulatore risponde sempre in modo affermativo ( Yes). 
 Aggiorna  
Premendo questo bottone viene forzato un aggiornamento dell'Elenco Log e dei conseguenti Elenco 
Processi e Messaggi di Log.  
 Log 
Premendo questo bottone viene aperta l'anagrafica Log Elaborazione Schedulatore, ove sono 
memorizzati tutti i dati di log.  
 Stampe  
Con questo bottone è possibile visualizzare l'elenco delle stampe elaborate dal Job (salvate in formato 
PDF), contenenti log, messaggi di errore o report della procedura, che possono essere aperte 
direttamente con un doppio -click o premend o il bottone OK.


key: chroma:document
string_value:
direttamente con un doppio -click o premend o il bottone OK.  
  
La procedura attribuisce un nome univoco a ciascuna stampa salvata, composto da <codice 
azienda>_<anno><mese><giorno>_<ora><minuti><secondi>_<descrizione processo>.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
S C H E D U L A Z I O N E  J O B  - 49  Stampa job  
  
Con questa funzione  è possibile stampare tutti i dati memorizzati nell'anagrafica dei Job.  
  
 
Stampa job  
  
 Tipo di stampa  
Sono disponibili le seguenti stampe:  
 Stampa Job Sintetica: vengono riportate solo le date di prossima elaborazione e di ultima 
esecuzione;  
 Stampa Job Dettagliata: per ciascun Job vengono elencati tutti i Processi con i relativi 
paramet ri; 
 Stampa Job con Ultimi Log di Elaborazione: per ciascun Processo di ogni Job vengono 
stampati i messaggi di Log relativi all'ultima elaborazione;  
 Stampa Job con Log di Elaborazione: vengono stampati i messaggi di Log relativi a tutte le 
elaborazioni  eseguite.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
50 – S C H E D U L A Z I O N E  J O B   Log elaborazione  
  
In questo archivio vengono memorizzati tutti i dati relativi ai messaggi di Log prodotti dai Processi 
elaborati, visualizzabili anche nelle gestioni Schedulatore di Job e  Visualizzazione Log di Elaborazione.  
  
Ad ogni elaborazione di un Job viene elaborato un nuovo Log con i messaggi relativi a ciascun 
Processo, contenenti:  
 La data e l'ora di inizio e fine elaborazione;  
 Le informazioni di avanzamento dell'elaborazione, presentate sia nei campo Memo a 
scorrimento, sia nelle finestre di avvertimento;  
 Gli avvisi presentati nelle finestre di richiesta/conferma ( cp_ErrorMsg  e cp_YesNo) , alle quali lo 
schedulatore risponde sempre in modo affermativo ( Yes). 
  
 
Log elaborazione  
  
 Gestione  
Mediante questo bottone è possibile richiamare la gestione del Job associato al Log.  
 Stampe  
Con questo bottone è possibile visualizzare l 'elenco delle stampe elaborate dal Job (salvate in formato 
PDF), contenenti log, messaggi di errore o report della procedura.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
S C H E D U L A Z I O N E  J O B  - 51  Visualizzazione log di elaborazione  
  
Questa funzione agevola l a verifica delle ultime elaborazioni, permettendo la visualizzazione dei 
messaggi di Log prodotti dai processi di tutti i Job.  
  
 
Visualizzazione log di elaborazione  
  
 Ultime Elaborazioni  
L'attivazione di questo check (preimpostata di default), consente di visualizzare solo i Log prodotti 
dalle ultime elaborazioni di ciascun Job. Disattivandolo sarà possibile visualizzare l'elenco completo di 
tutti i Log, con un eventu ale filtro sulle date di inizio e fine elaborazione.  
 Da Data - A Data  
Disattivando il check Ultime Elaborazioni, in questi campi sarà possibile impostate i filtri sulle date di 
inizio e fine elaborazione dei Job.  
 Ricerca  
Premendo questo bottone viene f orzato un aggiornamento dell'Elenco Log e dei conseguenti Elenco 
Processi e Messaggi di Log, in base ai filtri impostati (check Ultime Elaborazioni e date di inizio e fine 
elaborazione).


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
52 – S C H E D U L A Z I O N E  J O B    
Elenco Log  
Questo elenco riporta la lista di tutte le elaborazioni dei Job effettuate, ordinata in modo decrescente 
in base alla data di inizio. Viene riportata la data di inizio e di fine per ciascuna elaborazione.  
  
Elenco Processi  
Relativamente all'elaborazione selezionata (nell'elenco sulla sinistra della maschera), i n questo elenco 
vengono presentati i codici dei processi eseguiti, con l'ordine di elaborazione. I processi che hanno 
dato luogo ad anomalie di elaborazione vengono evidenziati con il colore rosso.  
 Messaggio di Log  
Relativamente al Processo selezionato ( nell'elenco sulla destra della maschera), in questo campo viene 
presentato l'intero messaggio di log prodotto dall'elaborazione, contenente:  
La data e l'ora di inizio e fine elaborazione;  
Le informazioni di avanzamento dell'elaborazione, presentate sia nei  campo Memo a scorrimento, sia 
nelle finestre di avvertimento;  
Gli avvisi presentati nelle finestre di richiesta/conferma ( cp_ErrorMsg  e cp_YesNo) , alle quali lo 
schedulatore risponde sempre in modo affermativo ( Yes). 
 Log 
Premendo questo bottone viene aperta l'anagrafica Log Elaborazione Schedulatore, ove sono 
memorizzati tutti i dati di log.  
 Stampe  
Con questo bottone è possibile visualizzare l'elenco delle stampe elaborate dal Job (salvate in formato 
PDF), contenen ti log, messaggi di errore o report della procedura, che possono essere aperte 
direttamente con un doppio -click o premendo il bottone OK.  
 Gestione  
Mediante questo bottone è possibile richiamare la gestione del Job associato al Log.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
S C H E D U L A Z I O N E  J O B  - 53  Selezione gruppo schedulatore  
  
In questa maschera vengono elencati tutti i gruppi di utente configurati. Tra questi può essere indicato 
solo un gruppo che viene abilitato alla sessione schedulatore. In questo modo, tutti  gli utenti 
appartenenti al gruppo possono essere abilitati contemporaneamente per l'esecuzione asincrona dei 
attraverso più sessioni aperte simultaneamente.  
  
 
Selezione gruppo schedulatore


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
54 – S C H E D U L A Z I O N E  J O B   Stampa log  
  
Con questa funzione è possibile stampare i messaggi di Log prodotti dalle elaborazioni di tutti i Job, 
oppure di intervallo di elaborazioni.  
  
 
Stampa log


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
S C H E D U L A Z I O N E  J O B  - 55 
 
________________________________________________________ ________________________  
________________________________________________________________________________  
________________________________________________________________________________  
_____________________________________________________________________ ___________  
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
______________ __________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
___________________________ _____________________________________________________  
___________________________ _____________________________________________________  
________________________________________________________________________________


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
56 – S C H E D U L A Z I O N E  J O B  
 
________________________________________________________________________________  
_______________________ _________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
____________________________________ ____________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
_________________________________________________ _______________________________  
________________________________________________________________________________  
________________________________________________________________________________  
______________________________________________________________ __________________  
________________________________________________________________________________  
________________________________________________________________________________  
___________________________________________________________________________ _____  
________________________________________________________________________________  
_______________________________________________________________________________


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
P R O A T T I V I T À  - 57  
 PROATTIVITÀ  
  
Archivio Proattività  
All’interno del modulo Schedulatore è stata introdotta una funzionalità analoga denominata 
Proattività allo scopo di permettere la pianificazione di un allert: risulta così possibile effettuare un 
controllo automatico con una frequenza stabilita di una determinata situazi one e darne un risultato 
visualizzabile ad ogni esecuzione oppure al solo verificarsi dell’evento scatenante l’allerta.  
Mediante questa nuova funzionalità quindi si potrà dare un avviso agli utenti al verificarsi di un 
evento: ad esempio, potremo avvisare il magazziniere nel caso in cui un determinato articolo arriva ad 
avere una disponibilità negativa.  
Come nel caso dello schedulatore di job, anche per la proattività occorre definire le seguenti 
impostazioni  
  
Mediante questa funzionalità si potrà dare un avviso agli utenti al verificarsi di un evento: ad esempio, 
potremo avvisare il magazziniere nel caso in cui un determinato articolo arriva ad avere una 
disponibilità negativa. Come nel caso dello schedulatore di job, anche per la proattività occorre 
defin ire le seguenti impostazioni  
1)     Creare un nuovo gruppo Schedulator e inserirlo in Selezione gruppo schedulatore  
2)     Creare uno o più utenti schedulatori e associarli a tale gruppo. Tali utenti dovranno anche 
essere associati al gruppo amministratori ; 
3)     Ogni proattività si appoggia una gestione dello schedulatore fissa, certificata e rilasciata col 
modulo Schedulatore', denominata GSJB_BXP WITH THIS (Esecuzione della  
proattività).  
4)     L'utente schedulatore deve appartenere al gruppo Sistemi In formativ  
  
La gestione dello schedulatore GSJB_BXP WITH THIS'viene creata in automatico non appena si crea la prima 
proattività nell'apposito archivio.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
58 – P R O A T T I V I T À  
 
Gestione schedulatore per proattività  
  
Analogamente a quanto avviene per lo Schedulatore di Job, an che nella proattività è prevista una 
sessione sempre attiva del gestionale che ad intervalli di tempo esegue il controllo predefinito e ne 
invia comunicazione con occorrenza:  
 Per Esecuzione:  ad ogni esecuzione segue la visualizzazione del risultato;  
 Per Evento : solo se l'esecuzione della proattività rileva almeno un dato (record) ne manda 
comunicazione.  
  
La proattività prevede l'esecuzione di una query o di una routine in base alla frequenza stabilita 
dall'utente (giornaliera, settimanale) il cui risultato viene sviluppato all'interno di un report oppure 
all'interno di un testo predefinito.  
  
Nel caso in cui si voglia sviluppare il contenuto del risultato all'interno di un report, occorre creare 
una stampa personalizzata ed associarla alla proattività, e verrà generato un file in formato Pdf.  
Nel caso del testo, il risultato della query/batch schedulati viene visualizzato all'interno di un 
messaggio di tipo testo che conterr à una parte relativa alla testata, una parte ripetuta con il dettaglio 
del responso ed infine una parte di chiusura.  
  
Per ciascuna proattività viene prodotto un log, in cui vengono riportati i messaggi di elaborazione ed i 
riferimenti a tutte le elaborazi oni effettuate.  
Tutti i report generati dalle proattività vengono salvati in un file in formato PDF all'interno di una 
cartella predefinita nella Gestione percorsi sfruttando il campo Path schedulatore  (menu Archivi - 
Azienda), richiamabili poi dalla Visua lizzazione Log di Elaborazione.  
  
È comunque possibile abilitare anche la stampa cartacea, attivando l'apposito check presente 
nell'anagrafica della proattività.  
  
Il messaggio prodotto dall'allerta può essere inoltrato a mezzo e-mail oppure a mezzo post in agli


key: chroma:document
string_value:
Il messaggio prodotto dall'allerta può essere inoltrato a mezzo e-mail oppure a mezzo post in agli 
utenti/gruppi selezionati nella sezione Destinatari.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
P R O A T T I V I T À  - 59 Proattività - Schedulazione  
  
La maschera della proattività si presenta pressoché simile a quella dello schedulatore di job.  
  
 
Proattività - Schedulazione  
  
 Codice  
Codice numerico progressivo che identifica la proattività, proposto automaticamente dalla procedura..  
 Descrizione proattività  
Descrizione della proattività di libera imputazione.  
 Attivata  
La proattività sarà processata nei tempi previsti dalla  frequenza di lancio, solo se è stato attivato questo 
check.  
 Creato/Variato Da, In Data  
In questi campi viene evidenziato l'utente che ha creato la proattività e l'ultimo che l' ha modificata, 
con le corrispondenti date di creazione e modifica.  
 Frequen za di Lancio proattività  
La proattività può essere eseguita una sola volta oppure periodicamente con un determinata 
frequenza di lancio; è possibile decidere l'orario di lancio e l'eventuale giorno della settimana o del 
mese.  
 Frequenza di Lancio Unica. L a proattività viene eseguita alla Data di Prossima Esecuzione  
(campo che risulta editabile solo per questo tipo di frequenza) nell'orario stabilito (campo Ora).


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
60 – P R O A T T I V I T À  
 
Frequenza di lancio Unica  
  
 Frequenza di Lancio Giornaliera. La proattività viene eseguit a ogni intervallo di giorni 
specificato (campo Ogni) nell'orario stabilito (campo Ora); è possibile definire un intervallo di 
tempo in termini di minuti ( Campo Ogni -- Minuti)  in cui la procedura deve eseguire 
l'elaborazione. In questo caso la procedura i nizierà l'attività all'ora di inizio esecuzione (15.30 
come indicato nel Campo Ora) e ogni 15 minuti (Campo Ogni Minuti) la proattività verrà 
eseguita aggiornando quindi automaticamente il campo relativo alla data e all'ora di prossima 
esecuzione fino ad a rrivare all'ora di fine esecuzione (indicata nel Campo Fino Alle) in questo 
caso le 18.30. La procedura quindi ad intervalli regolari di 15 minuti eseguirà la proattività 
schedulata; arrivando all'ora di fine esecuzione (Campo Fino Alle) procederà al calco lo 
automatico della data e ora di prossima esecuzione in base alla frequenza di lancio indicata. 
Nell'esempio sottostante arrivati alle ore 16 del giorno 18/07/2008 la procedura effettuerà 
l'aggiornamento automatico della data e ora di prossima esecuzione impostando 
automaticamente la data relativa al giorno seguente 04 -05-06 (poiché è stato specificato che il 
job venga eseguito Ogni 1 giorno) e all'orario stabilito nel campo ora quindi 15.30.  
  
 
Frequenza di lancio Giornaliera  
  
 Frequenza di Lancio Sett imanale. La proattività viene eseguita ogni intervallo di settimane 
specificato (campo Ogni), in tutti i giorni della settimana attivati, nell'orario stabilito (campo 
Ora).  
  
 
Frequenza di lancio Settimanale  
  
 Frequenza di Lancio Mensile. Il Job viene e seguito una volta al mese per tutti i mesi attivati, a 
fine mese oppure a data fissa, nell'orario stabilito (campo Ora) con la frequenza desiderata.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
P R O A T T I V I T À  - 61 
 
Frequenza di lancio Mensile  
  
Nel caso in cui si imposti un orario di fine esecuzione che differisce da  quello di inizio di esecuzione 
solo per alcuni minuti è necessario valorizzare nel campo Fino alle prima i minuti e poi il campo 
relativo all'ora. Ad esempio impostando un intervallo di tempo che va dalle 15.30 alle 15.50 sarà 
necessario valorizzare nel c ampo minuti relativo al campo Fino alle i 50 minuti e successivamente 
valorizzare le ore 15.  
  
Prossima Esecuzione  
 Data e Ora di Prossima Esecuzione  
In questi campi viene riportata la data e l'ora di prossima esecuzione della proattività. Vengono 
calcola ti automaticamente dalla procedura in base alla frequenza di lancio stabilita; solo nel caso di 
frequenza Unica è necessario imputare manualmente la data di prossima esecuzione.  
 Calcola data prossima esecuzione  
I campi Data e Ora di Prossima Esecuzione v engono valorizzati automaticamente al salvataggio della 
gestione e dopo ogni esecuzione della proattività. L'utente può comunque forzarne il calcolo, 
simulando l'effetto della frequenza impostata, mediante la pressione del bottone Calcola.  
 Tempo Massimo di Attesa  
Tutte le proattività vengono processati in modo sequenziale, in base alla loro data e ora di inizio, da 
una Sessione Schedulatore. Se al momento di inizio stabilito per una certa proattività ne fosse in 
esecuzione un' altra, la prima verrebbe acc odata.  
In questo campo è possibile specificare un tempo massimo di attesa delle proattività che non possono 
essere eseguite nell'esatto momento di schedulazione, dopo il quale i Job vengono posticipati al 
successivo intervallo di pianificazione.  
  
Dati Ela borazione  
In questa sezione vengono memorizzate la data e l'ora nelle quali la proattività ha avuto inizio ed è 
terminato, l'ultima volta in cui è stato eseguito.  
  
Stampa Pdf  
 Path


key: chroma:document
string_value:
terminato, l'ultima volta in cui è stato eseguito.  
  
Stampa Pdf  
 Path  
In questo campo può essere specificata la cartella in cui memorizzare le stampe prodotte da un 
processo schedulato in formato PDF .


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
62 – P R O A T T I V I T À  Se tale path non viene specificato, lo schedulatore salva il pdf nella cartella specificata nella Gestione 
Path presente nel menù Archivi – Azienda – Gestione Path (Attenzione: ogni azienda dispone di un 
path specifico.  
 Abilita Stampa Cartacea  
Attivando questo check, le stampe prodotte da un processo schedulato possono essere anche 
stampate direttamente sulla stampante predefinita, oltre ad essere salvate in formato PDF .  
 Invio Stampe per E -Mail  
Attivando tale combo ve ngono inviate tutte le stampe in formato PDF  
 Solo log: a tutti i destinatari definiti nell’apposita sezione viene inviato solo il risultato 
prodotto dalla schedulazione del job in un file allegato in formato ‘pdf ’;  
 Log e stampe: a tutti i destinatari  definiti nell’apposita sezione viene inviato sia il risultato 
prodotto dalla schedulazione del job, sia l’allegato della stampa inerente l’elaborazione avvenuta 
in file allegati in formato ‘pdf ’;  
 Selezione su destinatari: la scelta di inviare solo il l og oppure anche le stampe delle 
elaborazioni è demandata al singolo destinatario, quindi per alcuni utenti si potrà decidere di 
inviare solo il log, ad altri solo le stampe, ad altri ancora entrambi.  
  
Proattività - Destinatari  
  
Nella cartella Destinatari  può essere specificato un elenco di utenti e/o gruppi ai quali inviare una e -
mail o un post in di avviso per l'avvenuta esecuzione della proattività.  
A tale scopo viene utilizzato rispettivamente il codice utente definito nella Gestione utenti/gruppi 
oppu re l'indirizzo e -mail memorizzato nella gestione Servizi Fax / Email / We / Postalite per singolo 
utente.  
  
 
Proattività - Destinatari


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
P R O A T T I V I T À  - 63 Proattività - Proattività  
  
 
Proattività - Proattività  
  
 Tipo di elaborazione  
In questo combo box è possibile defin ire il tipo di elaborazione che si intende utilizzare per produrre 
il cursore dati utili a notificare l'esito del controllo effettuato dalla proattività:  
Query: la proattività produrrà un cursore dati mediante l'esecuzione di una query;  
Batch: la proattivi tà produrrà un cursore dati mediante l'esecuzione di un batch.  
 Elaborazione  
In questo campo l'utente deve indicare il nome del tipo di elaborazione selezionata (query o batch) 
atta a produrre il cursore dati utilizzato per notificare l'esito del controllo.  
Nel caso di selezione su query, apparirà a lato un bottoncin o che permette la navigazione fra le cartelle 
e sarà possibile quindi memorizzarne il path.  
Diversamente per tipo elaborazione batch, sarà sufficiente indicare solo il suo nome.  
 Occorrenza elaborazione  
In questo combo box è possibile stabilire la condizi one di produzione del responso, ovvero se debba 
essere comunicato ad ogni esecuzione oppure al verificarsi dell'evento.  
 Formato elaborazione  
In questo combo box è possibile definire la modalità di visualizzazione del responso prodotto 
dall'esecuzione del la query o del batch: si può scegliere tra la definizione di un testo precostruito 
oppure un report personalizzato.  
Nel caso in cui si selezioni formato Testo, è possibile stabilire la struttura del testo che assumerà il 
responso prodotto dall'elaborazione : sarà quindi possibile definire un'intestazione del messaggio, un 
dettaglio del messaggio restituito ripetuto per ogni riga ed una sezione di chiusura:


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
64 – P R O A T T I V I T À    
Nel caso in cui si selezioni formato A llegato , è possibile selezionare un report utile a notificare i l 
responso dell'elaborazione mediante navigazione fra le cartelle:  
 Smistamento dati  
In questo combo è possibile definire se e come smistare le informazioni del responso ai destinatari 
indicati nella query o nel batch, il cui codice è identificato dal cam po Identificazione destinatario.  
 Nessuna modalità: il messaggio prodotto dall'elaborazione non viene smistato;  
 A mezzo post -in: il messaggio prodotto dall'elaborazione verrà inviato mediante post in ai 
destinatari predefiniti identificati mediante il v alore indicato nel successivo campo 
Identificazione destinatari;  
 A mezzo e -mail: il messaggio prodotto dall'elaborazione verrà inviato mediante posta 
elettronica ai destinatari predefiniti identificati mediante il valore indicato nel successivo campo 
Identificazione destinatari.  
 Post-in per gestione attività: i post -in che arriveranno relativi ad un promemoria attività 
conterranno due pulsanti: con il pulsante "Visualizza" sarà possibile visualizzare l'attività 
oggetto del promemoria, mentre con il puls ante "Posponi" sarà possibile posporre 
successivamente la data e l'ora del promemoria.  
 Identificazione destinatario  
Nel caso in cui nel combo box precedente si scelga la modalità di invio a mezzo post in oppure e -
mail, è possibile valorizzare questo camp o, indicando il nome del campo nel cursore elaborato in cui si 
trova il codice dell'utente a cui inviare il post in oppure l'indirizzo a cui inviare l'e -mail. 
  
Proattività - Aziende  
  
 
Proattività - Aziende  
  
Elenco aziende in cui è attiva la proattività


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
P R O A T T I V I T À  - 65   
Proattività - Log 
  
L'ultima cartella della gestione Proattività evidenzia i log di ogni elaborazione con l'elenco delle 
segnalazioni di ogni processo, lo stato dell'elaborazione e il collegamento alle stampe generate.  
  
 
Proattività - Log 
  
Elenco Log  
Questo elenco riporta la lista di tutte le elaborazioni effettuate per la proattività, ordinata in modo 
decrescente in base alla data di inizio. Viene riportata la data di inizio e di fine per ciascuna 
elaborazione.  
  
Elenco Processi  
Relativamente all'ela borazione selezionata (nell'elenco sulla sinistra della maschera), in questo elenco 
vengono presentati i codici dei processi eseguiti, con l'ordine di elaborazione. I processi che hanno 
dato luogo ad anomalie di elaborazione vengono evidenziati con il colo re rosso.  
  
Messaggio di log  
Relativamente al Processo selezionato (nell'elenco sulla destra della maschera), in questo campo viene 
presentato l'intero messaggio di log prodotto dall'elaborazione, contenente:  
La data e l'ora di inizio e fine elaborazione;  
Le informazioni di avanzamento dell'elaborazione, presentate sia nei campo Memo a scorrimento, sia 
nelle finestre di avvertimento;  
Gli avvisi presentati nelle finestre di richiesta/conferma ( cp_ErrorMsg  e cp_YesNo) , alle quali lo  
schedulatore risponde semp re in modo affermativo ( Yes).


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
66 – P R O A T T I V I T À   Aggiorna  
Premendo questo bottone viene forzato un aggiornamento dell'Elenco Log e dei conseguenti Elenco 
processi e messaggi di log.  
 Log 
Premendo questo bottone viene aperta l'anagrafica Log Elaborazione Schedulatore, ove sono 
memorizzati tutti i dati di log.  
 Stampe  
Con questo bottone è possibile visualizzare l'elenco delle stampe elaborate dalla proattività (salvate in 
formato PDF), contenenti log, messaggi di errore o report della procedura, che possono essere aperte 
direttamente con un doppio -click o premendo il bottone OK.  
  
La procedura attribuisce un nome univoco a ciascuna stampa salvata composto da 
<ESECUZIONEDELLAPROATTIVITA>_<azienda>_<anno><mese><giorno>_<ora><minu
ti><secondi>. Ad esempio:  
ESECUZIONEDELLAPROATTI VITA_DEMO_20080715174716.PDF


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
P R O A T T I V I T À  - 67 
 
________________________________________________________ ________________________  
________________________________________________________________________________  
________________________________________________________________________________  
_____________________________________________________________________ ___________  
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
______________ __________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
___________________________ _____________________________________________________  
___________________________ _____________________________________________________  
________________________________________________________________________________


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
68 – P R O A T T I V I T À  
 
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
_____________ ___________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
__________________________ ______________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
_______________________________________ _________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
____________________________________________________ ____________________________  
_______________________________________________________________________________


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
A T T I V A Z I O N E  P R O A T T I V I T À  - 69   
 ATTIVAZIONE PROATTIVI TÀ 
  
Mediante la funzione di Attivazione proattività è possibile attivare l e varie proattività già presenti in 
archivio su più di un'azienda: in questo caso, la proattività eseguirà la relativa query o batch sui dati di 
tutte le aziende selezionate su cui risulta attivata:  
  
 
Attivazione proattività  
  
Nello zoom sono elencate tu tte le proattività già presenti nel database.  
Mediante il bottone Destinatari è possibile accedere alla sezione Destinatari già definiti sulla proattività 
selezionata ed eventualmente aggiungere, eliminare o modificare quanto già specificato sulla 
proattiv ità stessa:


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
70 - A T T I V A Z I O N E  P R O A T T I V I T À  
 
Selezione destinatari  
  
Mediante il bottone Aziende, è possibile accedere all'elenco delle aziende codificate sul database e 
selezionare quelle sulle quali si intende attivare la proattività:  
  
 
Selezione aziende


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
A T T I V A Z I O N E  P R O A T T I V I T À  - 71   
Mediante il bottone Aggi orna presente su questa maschera si conferma quindi la selezione sulle 
aziende, mentre mediante il bottone Aggiorna presente nella maschera principale si effettua la 
conferma dell'attivazione della proattività selezionata.  
  
Attenzione: l'attivazione proat tività agisce solo su una proattività alla volta in relazione a più aziende; non è 
prevista l'attivazione massiva di più proattività contemporaneamente su più aziende.  
  
Esempio  
La presente pro attività consente di indicare un elenco con le associazioni Cl ienti/Nominativi che 
risultano Disallineate nei campi comuni (es. ragione sociale, indirizzo, ecc).  
  
 
Nuova pro attività


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
72 - A T T I V A Z I O N E  P R O A T T I V I T À  
 
Inserimento della query nella pro attività  
  
 
Filtri applicati sui campi controllati nella query  
  
 
Ordinamento risultati della  query  
  
Eseguendo la query è possibile visualizzare quali siano le anagrafiche disallineate.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
A T T I V A Z I O N E  P R O A T T I V I T À  - 73 
 
Elenco delle anagrafiche disallineate  
  
Infine si può spedire il resoconto della pro attività inserita agli utenti selezionati in essa.  
  
 
Invio resoconto pr o attività  
  
Il testo della e -mail da spedire viene impostato nella scheda Proattività in questo modo:


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
74 - A T T I V A Z I O N E  P R O A T T I V I T À  
 
Es di dettaglio del testo da spedire  
  
All‘utente specificato nell‘interno della pro attività arriva un messaggio di questo tipo:  
  
 
Testo e -mail co n resoconto disallineamenti  
  
Esempio  
Considerando gli archivi demo si selezioni la pro attività relativa all‘invio dei promemoria


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
A T T I V A Z I O N E  P R O A T T I V I T À  - 75 
 
Proattività  
  
Nel combo smistamento dati si selezioni la nuova opzione Post -in per gestione attività.  
Si procede con il c aricare un‘attività che prevede l‘invio di un promemoria  
  
 
Attività appuntamento


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
76 - A T T I V A Z I O N E  P R O A T T I V I T À  Mediante la proattività sarà possibile inviare il post -in all‘utente 1 (identificativo del partecipante 
00001).  
  
 
Elenco log proattività  
  
L‘utente 1 riceverà questo pos t-in caratterizzato da due bottoni:


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
A T T I V A Z I O N E  P R O A T T I V I T À  - 77 
 
Post –in 
  
 Posponi  
Mediante questo bottone è possibile accedere a una maschera che permette di posticipare per un 
periodo di tempo la data del prossimo invio del promemoria.  
 Apri att.  
Mediante questo bottone è possibile accedere direttamente all‘attività oggetto del promemoria.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S C H E D U L A T O R E  
78 - A T T I V A Z I O N E  P R O A T T I V I T À   
 
________________________________________________________________________________  
________________________________________________________________________________  
______________________________________________________________ __________________  
________________________________________________________________________________  
________________________________________________________________________________  
___________________________________________________________________________ _____  
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
_______ _________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
____________________ ____________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
_________________________________ _______________________________________________


key: chroma:document
string_value:
Piattaforma Applicativa Gestionale  
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 Statistiche  
 
Release 8 .0


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S T A T I S T I C H E  
I N D I C I  - III Indice  
 
Statistiche  ................................ ................................ ................................ ....... 1 
 Creazione archivio statistico  ................................ ................................ ....................  3 
 Criteri di elaborazione  ................................ ................................ ..............................  5 
 Ultima generazione  ................................ ................................ ................................ ... 8 
 Stampa statistiche  ................................ ................................ ................................ .... 10 
 Dettaglio sui criteri  ................................ ................................ ................................ .. 14 
 
Le immagini della documentazione differiscono secondo il sistema operativo utilizzato e delle 
parametrizzazioni di Ad hoc Revolution impostate nella configurazione interfaccia.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S T A T I S T I C H E  
IV – I N D I C I  
 
______________________________________________________________ __________________  
________________________________________________________________________________  
________________________________________________________________________________  
___________________________________________________________________________ _____  
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
_______ _________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
____________________ ____________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
_________________________________ _______________________________________________  
________________________________________________________________________________  
_______________________________________________________________________________


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S T A T I S T I C H E  
 S T A T I S T I C H E  - 1 Statistich e 
  
Il modulo Statistiche rappresenta uno strumento per controllare e riepilogare in maniera 
personalizzabile le movimentazioni di magazzino effettuate sia in maniera manuale che attraverso i 
documenti emessi e ricevuti dall'azienda.  
  
Le statistiche elabo rate si concretizzano in una serie di stampe con la possibilità di integrare Microsoft 
Excel per la creazione di grafici. I criteri di selezione e accorpamento dei dati oggetto dei report sono 
definibili dall'utente attraverso un dinamico strumento che per mette di ottenere statistiche sulla 
movimentazione della merce a livello di quantità e valori ma anche di acquisire significative 
informazioni sugli ordini e offerte emesse o ricevute (ordinato, impegnato, riservato).  
  
I dati possono essere disposti in fa se di stampa su più livelli di dettaglio permettendo un'analisi molto 
specifica a seconda delle esigenze di controllo o riepilogo.  
  
A seconda delle varie esigenze aziendali questi dati assumono valori e significati diversi e per questo il 
modulo nasce con  una forte propensione ad adattarsi alle varie realtà (sfruttando, ad esempio la 
possibilità di modificare la stampa standard).  
  
La lettura delle stampe prodotte con il Modulo Statistiche è resa estremamente chiara ed immediata 
anche attraverso l'ausilio di Microsoft Excel che rende possibile la visualizzazione di tabelle attraverso 
grafici, rendendo la stampa molto significativa anche a livello di impatto visivo.  
  
 
Menù Statistiche  
  
 Creazione archivio statistico  
 Criteri di elaborazione  
 Ultima  generazione  
 Stampa statistiche


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S T A T I S T I C H E  
2 - S T A T I S T I C H E   Dettaglio sui criteri


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S T A T I S T I C H E  
S T A T I S T I C H E  - 3  Creazione archivio statistico  
  
L'archivio statistico deve essere visto come una tabella delle movimentazioni di magazzino e dei 
documenti dettagliati con tutte le informazioni ricavabili ad esse collegate, dalle quali estrarr e dati 
riassuntivi per un caso di interesse (vedi Criteri di Elaborazione ). 
  
Attraverso l'archivio statistico è possibile estrarre le informazioni necessarie all'elaborazione dei dati in 
relazione al criterio scelto. La base di partenza è l'archivio dei d ocumenti e dei movimenti di 
magazzino che contiene l'insieme di tutte le transazioni eseguite.  
  
Esiste una fase di creazione dell'archivio statistico, durante la quale vengono letti tutti i documenti ed i 
movimenti di magazzino confermati (vengono quindi ignorato documenti e movimenti provvisori) 
interessati dal periodo di generazione e per ogni movimento viene scritto un elemento nell'archivio 
statistico. Se il periodo si sovrappone a quello già creato i movimenti vengono rielaborati e rigenerati, 
così da  mantenerlo sempre aggiornato (vedi Generazione Archivio Statistico ). 
  
Le informazioni contenute nell'archivio statistico possono essere filtrate in base al codice cliente o 
fornitore, all'agente, alla zona, al gruppo merceologico, ecc. ovvero in base ai Criteri di Elaborazione 
definibili direttamente dall'utente.  
  
Nessuna elaborazione statistica può avere luogo senza che prima sia stato caricato l'archivio statistico 
mediante la fase di generazione. La generazione statistiche permette di creare e/o aggio rnare l'archivio 
statistico e può essere eseguita più volte. La procedura propone sempre la data successiva a quella 
dell'ultima generazione, mentre come data di fine generazione propone la data del mese successivo (lo 
scarto può essere di 30, 31 giorni) d i elaborazione.  
  
 
Creazione archivio statistico


key: chroma:document
string_value:
scarto può essere di 30, 31 giorni) d i elaborazione.  
  
 
Creazione archivio statistico  
  
A conferma della creazione dell'archivio statistico viene emesso il seguente messaggio:  
Elaborazione ultimata; sono stati generati 4 movimenti su 4  
  
Se in relazione alla richiesta di creazione dell'archi vio statistico non vengono individuati elementi viene 
emesso il seguente messaggio:  
Per le Selezioni impostate; non esistono movimenti da evadere!


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S T A T I S T I C H E  
4 - S T A T I S T I C H E  L'archivio Statistico è una fotografia degli archivi al momento della creazione. In caso di modifica di par ametri 
sostanziali come causali di magazzino, zone e relativi collegamenti con anagrafiche articoli, cliente, fornitori o anche 
modifica di movimenti di magazzino per periodi generati, l'archivio statistico non sarà più attendibile e bisogna 
rigenerare per  avere statistiche congruenti.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S T A T I S T I C H E  
S T A T I S T I C H E  - 5  Criteri di elaborazione  
  
Ogni interrogazione dell'archivio statistico deve essere effettuata attraverso un criterio nel quale 
indicare quali causali di magazzino sono  interessate e per quali raggruppamenti totalizzare gli importi 
e le quantità. Si può raggruppare su un nu mero elevato di elementi quali:  
Cliente/Fornitore , Agente , Zona, Gruppo Merceologico , Famiglia , Categoria Omogenea , Categoria Contabile , 
Categoria Com merciale , Marchio , Articolo/Servizio , Magazzino , Periodo, Destinazione Diversa , Voce di C/R , 
Centro di C/R , Commessa , Attività , Pagamento , Capo Area , Per Conto di , Vettore , Provincia, Mastro , Unità di 
Misura , Fornitore Abituale . 
  
La funzionalità del crite rio fornisce la possibilità di stabilire come procede l'elaborazione statistica; in 
particolare indica ordine e tipo di operazioni da eseguire al fine di ottenere una stampa oppure un 
grafico MS Excel. Questa caratteristica permette di ottenere un alto gra do di personalizzazione.  
  
Il modulo è già fornito di criteri precaricati, query e report predisposti a coprire le norm ali esigenze di 
un'azienda come:  
Venduto per Agente , Venduto per Cliente ed Articolo , Ordinato a Fornitore per Articolo , Margine di Vendi ta per 
Articolo , Margine di Vendita per Gruppo Merceologico , ecc. 
 
I criteri si differenziano per il tipo di risultato fornendo una stampa con i totali oppure un foglio su 
MS Excel. Entrambi le tipologie sono gestite dai Criteri di Elaborazione e  vengono e seguiti da un'unica 
voce di menu (vedi sezione Stampa Statistiche ). 
E altresì possibile associare ad un criterio un grafico predefinito GSST_GEN.vgr.  
  
 
Criteri di elaborazione


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S T A T I S T I C H E  
6 - S T A T I S T I C H E  Ricerca  
Può essere effettuata mediante la chiave predisposta:  
 Codice Crite rio 
  
Può essere altrimenti effettuata mediante la cartella Elenco, selezionando la chiave di ricerca che 
interessa, cliccando sulla colonna per la quale si desidera ottenere l'ordinamento.  
 Codice Criterio  
Il campo identifica il codice del criterio di el aborazione. E' un codice alfanumerico lungo 10 posizioni.  
 Causali Utilizzabili  
L'utente ha la possibilità di indicare quelle causali di magazzino che devono essere considerate dalla 
procedura per il criterio di elaborazione scelto.  
 Codice  
Codice della causale di magazzino che la procedura considera per estrapolare i dati. Attraverso il tasto 
F9 (Zoom) è possibile accedere all'elenco delle causali di magazzino selezionabili  
 +\- 
Attraverso i due segni + o - è possibile definire a priori il tipo di movim entazione della causale se 
incrementativi o diminutivo per i prezzi e/o per le quantità.  
 Descrizione  
Descrizione della causale di magazzino  
 Fasi della Elaborazione  
In questa sezione si definiscono su quali elementi effettuare raggruppamenti e totalizza zioni. Per ogni 
elemento di cui si voglia il dettaglio, la procedura effettua, in fase di stampa, una interruzione e il 
rispettivo totale. Quindi, se ad esempio, selezioniamo Articolo/Servizio  e Periodo , avremo rientrati i 
valori relativi ai periodi estrap olati mentre il totale espresso in termini di quantità e di valore farà 
riferimento a ciascun articolo/servizio movimentato.  
 Sequenza Ordinamento  
In questo campo viene specificato l'ordine in cui vengono stampati i raggruppamenti (dimensioni 
dell'archivio statistico).  
 Raggruppamento  
In questo campo viene specificato il raggruppamento per ogni criterio di elaborazione.  
 Quan tità 
In questo campo l'utente indica se riportare la quantità relativa ai movimenti di magazzino (ha senso


key: chroma:document
string_value:
solo per raggruppamenti di tipo articoli/servizi.)  
 Periodo  
Questo campo è attivo solo per i raggruppamenti di tipo periodo. Identifica un intervall o di date per 
cui verranno effettuati dei raggruppamenti.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S T A T I S T I C H E  
S T A T I S T I C H E  - 7 Output Associati al Criterio Statistico  
 Stampa Associata  
In questo campo viene riportato il tipo di report da utilizzarsi per la stampa del criterio statistico, 
definito nell'archivio Output Ute nte (menu Sistema). Il report predefinito è utilizzabile per tutti i 
criteri, per cui non si ha normalmente la necessità di modificarlo (salvo sia presente un report 
personalizzato).  
 Foglio Excel Associato  
L'utente in questo campo può indicare il report riguardante la costruzione del foglio excel associato ad 
un criterio d'elaborazione.  
 Abilita Grafico nella Stampa Statistiche  
Se attivo nella sezione Altre Selezioni della maschera Selezioni Stampa Statistiche viene abilitato il 
tasto Grafico; attraverso  questo bottone la procedura lancia l'elaborazione del grafico predefinito 
GSST_GEN..vgr.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S T A T I S T I C H E  
8 - S T A T I S T I C H E   Ultima generazione  
  
Nell'Archivio Ultima Generazione vengono mantenute informazioni riguardanti sia il periodo coperto  
dall'archivio, sia la chiave dell'archivio.  
  
 
Ultima generazione  
  
Periodi Generati  
Nella parte superiore della maschera vengono riportate le informazioni relative all'ultima generazione 
dell'archivio statistico:  
 Archivio Statistico Da - A 
In questi due campi vengono indicate la data iniziale e la data finale del periodo coperto dall'intero 
archivio.  
 Ultima Generazione Da - A 
In questi due campi vengono indicate la data iniziale e la data finale del periodo del l'ultima 
generazione effettuata. Sono dati puramente informativi e quindi non sono modificabili dall'utente.  
  
Chiave Archivio Statistico  
Nella parte inferiore della maschera viene invece evidenziata l'ultima chiave utilizzata:  
 Ultima chiave  
Il valore vi sualizzato come chiave, se non vi sono stati problemi di generazione, indica l'ultima chiave 
assegnata  ed ovviamente il numero di record contenuti all'interno dell'archivio statistico. Viene lasciata 
la possibilità di modificare tale codice, ma si consigli a di non cambiarlo se non in caso di necessità 
accertata. La generazione dell'archivio è una fase delicata che deve avvenire in modalità esclusiva, 
ovvero solo un processo può aggiornare l'archivio in un dato momento. Per consentire questo 
controllo è stat o inserito il flag di blocco generazione.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S T A T I S T I C H E  
S T A T I S T I C H E  - 9  Blocco generazione  
In condizioni normali l'utente troverà sempre il flag non attivato (nessun blocco), di fatto la procedura 
valorizza questo check durante la creazione e serve ad avvertire eventuali altri proces si di generazione, 
i quali saranno bloccati. L'utente deve intervenire su questo flag solo in caso di interruzione 
imprevista della generazione (come crash della macchina, calo di corrente, ecc). In tali situazioni il flag 
rimane attivo e blocca qualsiasi tentativo di generazione.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S T A T I S T I C H E  
10 - S T A T I S T I C H E   Stampa statistiche  
  
Il risultato di una elaborazione statistica può essere una stampa oppure un foglio di Microsoft Excel. 
Nel caso della reportistica attraverso Microsoft Excel, i l report che viene creato visualizza anche i 
grafici analitici e di confronto tra i periodi selezionati. Ad esempio, tale rappresentazione grafica, 
sicuramente di maggior immediatezza, permette di analizzare l'andamento delle vendite per un 
determinato age nte ed articolo.  
  
Le stampe elaborate con il Modulo Statistiche propongono gli elementi raggruppati dal criterio 
(agente, cliente, fornitore, articolo, etc.), e la relativa descrizione e le totalizzazioni per quantità ed 
importo. Inoltre se il criterio pr evede più periodi di confronto, si evidenziano le percentuali di 
scostamento. In fase di stampa è possibile applicare al criterio una serie di filtri di selezione che 
permettono una maggiore specificità e accuratezza delle informazioni interessate dall'ana lisi statistica.  
  
La stampa propone gli elementi su cui il criterio raggruppa (come agente, cliente, fornitore, articolo, 
ecc.), la relativa descrizione e le totalizzazioni per quantità ed importo. Inoltre se il criterio prevede più 
periodi di confronto, si evidenziano le variazioni percentuali.  
  
 
Stampa statistiche


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S T A T I S T I C H E  
S T A T I S T I C H E  - 11   
Dopo la scelta del criterio, l'utente deve andare a definire tutti gli elementi per cui ha interesse a fare 
un confronto.  
 Periodo di Confronto  
L'utente deve indicare il periodo rispetto a l quale fare l'elaborazione. Se è interessato a confrontare più 
periodi deve mettere dei flag in corrispondenza dei periodi Secondo e Terzo:  
Secondo: se è presente il flag, la procedura automaticamente visualizza due nuovi campi per inserire il 
secondo int ervallo;  
Terzo: se è presente il flag, la procedura automaticamente visualizza due nuovi campi per inserire il 
terzo intervallo.  
  
L'utente ha la possibilità di confrontare periodi diversi, ad esempio potrebbe mettere a confronto i 
primi tre mesi dell'anno , al fine di analizzare l'andamento del trimestre, oppure può anche mettere a 
confronto due periodi sovrapponibili, al fine di confrontare, ad esempio, un mese con l'intero anno.  
 Tipologia  
L'utente può limitare ulteriormente la selezione tra il gruppo de i clienti e/o fornitori. Se la tipologia 
scelta è cliente o fornitore la procedura mostra due nuovi campi per l'inserimento del' intervallo di 
selezione all'interno dell'archivio dei clienti o fornitori.  
  
Nella seconda scheda della maschera l'utente potrà  impostare ulteriori filtri al fine di restringere 
ulteriormente la selezione dei dati  
  
 
Stampa statistiche - Selezioni aggiuntive


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S T A T I S T I C H E  
12 - S T A T I S T I C H E    
Nella terza scheda della maschera esistono ulteriori elementi che consentono di impostare altre 
selezioni.  
  
 
Stampa sta tistiche - Altre selezioni  
  
In particolare è possibile impostare la valuta di rappresentazione degli importi e selezionare il tipo di 
stampa: grafico, excel o stampa. Riportiamo il dettaglio della maschera qui di seguito:  
 Valuta di Stampa  
All'utente è c onsentito di rappresentare gli importi nella valuta di conto o in qualsiasi altra valuta 
indicando il cambio. Viene proposta di default la valuta di conto (precedentemente inserita 
nell'archivio Esercizi).  
 Excel  
Questo bottone è visibile se all'interno d ei criteri di selezione è stato impostato una delle seguenti 
tipologie di foglio Excel: GSST_KEX.XLT, GSST_AGE.XLT e, infine, GSST1GEN.XLT.  
  
Attraverso il foglio di Excel GSST_KEX.XLT o il foglio di Excel GSST_AGE.XLT vengono 
utilizzati modelli MS Excel c he in automatico costruiscono grafici, rispettivamente, sulle 
quantità/valori e sui prezzi risultanti dall'elaborazione. Tale rappresentazione grafica risulta di facile 
comprensione ed evita noiose letture di lunghi tabulati numerici.  
  
Per i criteri di el aborazione, precaricati, che prevedono l'importazione dei dati su questi due fogli 
Excel, è specificato il periodo = mese come ulteriore criterio di raggruppamento. La definizione dei


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S T A T I S T I C H E  
S T A T I S T I C H E  - 13 criteri di dati importati compare sul foglio di Excel solo se il primo m ese viene valorizzato.  
  
Nel caso in cui non vengano specificati tutti i raggruppamenti specificati nei criteri di elaborazione la 
procedura visualizza il seguente messaggio:  
  
Il funzionamento corretto dell'esportazione su Excel in questi due casi avviene  se la selezione della stampa 
restituisce un solo elemento da elaborare sulla base del periodo prescelto (ad esempio un solo fornitore oppure agente 
o cliente).  
  
Attraverso l'utilizzo del foglio Excel GSST1GEN.XLT si ottiene un foglio nel quale vengono 
estrapolati i dati; in questo caso non è necessario per un corretto funzionamento impostare un solo 
elemento.  
 Grafico  
Questo bottone è attivo se all'interno del criterio di elaborazione è attivo il flag di abilitazione grafico.  
La procedura lancia l'elaborazione del grafico predefinito GSST_GEN..vgr  
  
Nel caso in cui non vengano specificati tutti i raggruppament i specificati nei criteri di elaborazione la 
procedura visualizza un messaggio di avvertimento.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S T A T I S T I C H E  
14 - S T A T I S T I C H E   Dettaglio sui criteri  
  
I report associati alla Stampa Standard sono:  
 GSST_SST.VQR  
 GSST_SST.FRX  
  
I report associati al foglio di Excel sono i seguen ti: 
 GSST_AGE.XLT  (da utilizzarsi nel caso di dettagli con solo valori, ad esempio, prezzi e 
periodo di elaborazione mensile).  
 GSST_KEX.XLT  (da utilizzarsi nel caso di dettaglio con valori che quantità e periodo di 
elaborazione mensile).  
 GSST1GEN.XLT  (da utilizzarsi nel caso si vogliano estrapolare i dati senza necessariamente 
stabilire un solo elemento o come periodo il mese).  
  
E' possibile inserire in ogni criterio il Grafico associato:  
 GSST_GEN.VGR


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S T A T I S T I C H E  
S T A T I S T I C H E  - 15 
 
_____________________________________________ ___________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
__________________________________________________________ ______________________  
________________________________________________________________________________  
________________________________________________________________________________  
_______________________________________________________________________ _________  
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
________________ ________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – S T A T I S T I C H E  
16 - S T A T I S T I C H E  
 
___________________________ _____________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________ ________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
_____________________________________________________ ___________________________  
________________________________________________________________________________  
________________________________________________________________________________  
________________________________ ________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
_____________________________________________ ___________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
__________________________________________________________ ______________________


key: chroma:document
string_value:
Piattaforma Applicativa Gestionale  
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 Vendite funzioni avanzate  
 
Release 8.0


key: chroma:document
string_value:
COPYRIGHT 2000 - 2015 by ZUCCHETTI S.p.A.  
Tutti i diritti sono riservati. Questa pubblicazione contiene informazioni protette da copyright. 
Nessuna parte di questa pubblicazione può essere riprodotta, trascritta o copiata senza il permesso 
dell’autore.  
 
RESPONSABILITÀ  
Resta espressamente esclusa qualsiasi responsabilità per danni diretti ed indiretti di qual siasi natura che 
l'utente possa, o terzi possano, in alcun modo subire, derivanti dall'uso o dal mancato uso della 
procedura e da errori della stessa.  
 
TRADEMARKS  
Tutti i marchi di fabbrica sono di proprietà dei rispettivi detentori e vengono riconosciuti in questa 
pubblicazione.  
 
ZUCCHETTI S.p.A.  
Sede Operativa di Aulla  
E - mail: market@zucchetti.it  
Sito Web: http://www .zucchetti.it


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – V E N D I T E  F U N Z I O N I  A V A N Z A T E  
I N D I C I  - III Indice  
 
1 Vendite funzioni avanzate  ................................ ................................ ........  1 
 INTEGRAZIONE EDI ................................ ................................ ..............................  5 
 Ad Hoc e l'EDI  ................................ ................................ ................................ ......... 9 
Archivi EDI  ................................ ................................ ................................ ................................ .. 10 
Trascodifiche  ................................ ................................ ................................ ................................ . 56 
Stampe archivi EDI ................................ ................................ ................................ .....................  60 
 Gestione tabelle import/export  ................................ ................................ ...........  78 
Generazione file EDI  ................................ ................................ ................................ .................  79 
Importazione file EDI ................................ ................................ ................................ ................  87 
Assistente importazione file EDI  ................................ ................................ ............................  96 
Import documenti EDI  ................................ ................................ ................................ .............  98 
Import massivo files EDI  ................................ ................................ ................................ ........ 101 
Anagrafica importazioni  ................................ ................................ ................................ ..........  103


key: chroma:document
string_value:
Log generatore documentale  ................................ ................................ ................................ .. 105 
Cancellazione anagrafica im portazioni  ................................ ................................ .................  106 
Gestione tabelle piatte  ................................ ................................ ................................ ..............  108 
Manutenzione tabelle piatte  ................................ ................................ ................................ .... 111 
Import/export definizione tabelle piatte  ................................ ................................ .............  113 
Import/Export archivi EDI  ................................ ................................ ................................ ... 115 
Controllo congruenza strutture EDI  ................................ ................................ ....................  118 
 IMBALLI E CAUZIONI  ................................ ................................ ..........................  121 
 Operazioni preliminari  ................................ ................................ .........................  122  
 Kit imballi  ................................ ................................ ................................ ...............  128  
 Saldi imballi  ................................ ................................ ................................ ............  132  
 Visualizzazione saldi imballi  ................................ ................................ ................  133  
 Stampa kit imballi  ................................ ................................ ................................ .. 134  
 Duplicazione kit imballi  ................................ ................................ .......................  135  
 Ricostruzione saldi imballi  ................................ ................................ ...................  136


key: chroma:document
string_value:
 Documento con Imballi  e contabilizzazione  ................................ ...................  137  
 BASI DI CALCOLO  ................................ ................................ ...............................  145 
 Scheda di calcolo listini  ................................ ................................ ........................  146  
 Manutenzione basi di ca lcolo ................................ ................................ ..............  151  
 Aggiornamento massivo listini  ................................ ................................ ...........  160  
 Stampa schede di calcolo  ................................ ................................ .....................  162  
 SERVIZI KIT  ................................ ................................ ................................ ........  165 
 Articoli kit  ................................ ................................ ................................ ...............  166  
 Stampa articoli kit  ................................ ................................ ................................ .. 168  
 Aggiornamento listino kit  ................................ ................................ ....................  169  
 Duplicazione articoli k it ................................ ................................ .......................  171


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – V E N D I T E  F U N Z I O N I  A V A N Z A T E   
IV – I N D I C I   Anagrafica articoli kit  ................................ ................................ ...........................  172  
 Anagrafica causali documento  ................................ ................................ ............  173  
 PIANI DI SPEDIZIONE  ................................ ................................ ........................  183 
 Piani di spedizione  ................................ ................................ ................................  185  
 Configurazione ordinamento/rottura piani di spedizione  ............................  196  
 
 
Le imm agini della documentazione differiscono secondo il sistema operativo utilizzato e delle 
parametrizzazioni di Ad hoc Revolution impostate nella configurazione interfaccia.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – V E N D I T E  F U N Z I O N I  A V A N Z A T E  
I N D I C I  - V 
 
_______________________________________________________________________________ _ 
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
___________ _____________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
________________________ ________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
_____________________________________ ___________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
__________________________________________________ ______________________________  
________________________________________________________________________________  
________________________________________________________________________________


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – V E N D I T E  F U N Z I O N I  A V A N Z A T E   
VI – I N D I C I  
 
_____________________________________________________________ ___________________  
________________________________________________________________________________  
________________________________________________________________________________  
__________________________________________________________________________ ______  
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
______ __________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
___________________ _____________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
________________________________ ________________________________________________  
________________________________________________________________________________  
_______________________________________________________________________________


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – V E N D I T E  F U N Z I O N I  A V A N Z A T E  
V E N D I T E  F U N Z I O N I  A V A N Z A T E  - 1 1  Vendite funzioni 
avanzate  
  
Il modulo Vendite Funzioni Avanzate si caratterizza per la presenza di funzionalità che arricchiscono 
il contenuto dei moduli relativi ai documenti.  
  
Integrazione EDI (Electronic Data Interchange): l'EDI (Electronic Data I nterchange) è lo scambio di 
dati strutturati nei formati standard mediante mezzi elettronici tra applicazioni informatiche. In ad  
hoc Revolution è stata realizzata un'infrastruttura parametrica che consente di generare/importare file 
conformi ad uno o più standard definiti nell'ambito dello scambio elettronico dei dati (EDI). E' 
sufficiente associare una struttura EDI alle causali documento, oppure in modo più specifico, a gruppi 
di clienti/fornitori o a singoli clienti/fornitori per definire le modalità di  scrittura/lettura dei file. La 
struttura, della quale è disponibile anche una visualizzazione ad albero, rappresenta la chiave di 
lettura/scrittura dei file. Una struttura EDI è assimilabile concettualmente ad un report di stampa. E' 
in base alla struttur a che viene definito il contenuto ed il layout dei file. Per ogni standard EDI che 
l'azienda intende adottare dovrà quindi essere predisposta almeno una struttura (es: Fattura Eancom 
96A, DT Eancom 96A, Ordine Eancom 96A, Fattura XML, Fattura ACBI).  
Gestio ne imballi e cauzioni: Gli obiettivi principali di questa funzionalità sono:  
 La gestione degli imballi a perdere/rendere  
 La gestione della contabilità degli imballi a rendere (ad esempio consegnati ai clienti e ricevuti 
come resi, con esplicitazione di rettamente sul documento di vendita)  
 La gestione delle cauzioni (contabilizzazione del credito/debito verso cliente/fornitore in 
Primanota: l'importo viene determinato in base al costo standard associato all'articolo imballo).


key: chroma:document
string_value:
Primanota: l'importo viene determinato in base al costo standard associato all'articolo imballo).  
 Gli imballi vengono gesti ti come attributi dell'articolo. Al pari di una distinta base, è possibile 
associare ad ogni articolo uno o più imballaggi (ad esempio, articolo venduto in scatole 
contenute in un cartone).  
  
Schede di Calcolo: le schede di Calcolo consentono di aggiornare  automaticamente un certo listino, 
sulla base di diverse regole preimpostate (altro listino di riferimento, ultimo costo, costo medio 
ponderato, ecc. ecc.), massivamente oppure direttamente in fase di caricamento di un documento. 
Ogni scheda è associata ad  un listino da aggiornare e ad un elenco di articoli/servizi o gruppi 
merceologici. Dall'anagrafica articoli è disponibile uno zoom con tutte le schede di calcolo caricate per 
i listini associati. All'interno di un documento: è possibile visualizzare la si tuazione dei listini 
disponibili per l'articolo (su una certa riga documento), tramite lo zoom già presente (bottone "P") e 
le relative basi di calcolo (listino di acquisto, costo standard, ultimo costo di acquisto) con la possibilità 
di effettuare delle s imulazioni dell'effetto sui listini a seguito della modifica delle basi di calcolo.  
  
Kit commerciali: all'interno del modulo "Vendite funzioni avanzate" è disponibile l'estensione di una


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  - V E N D I T E  F U N Z I O N I  A V A N Z A T E  
2 -  funzionalità altrimenti limitata solo alla Vendita Negozio (modulo P OS). Si rende di fatto disponibile 
la gestione del Kit commerciale direttamente dai documenti del ciclo acquisti e ciclo vendite. La 
funzionalità è identica a quanto previsto per il Kit del modulo POS: in sostanza è disponibile una 
gestione per la definizi one del Kit commerciale e una gestione per eseguire l'aggiornamento dei listini. 
In fase di vendita potranno essere generati automaticamente il documento interno di carico 
dell'articolo Kit e il documento interno di scarico dei componenti (come se si tratt asse di una distinta 
base monolivello).  
  
 INTEGRAZIONE EDI 
 IMBALLI E CAUZIONI  
 BASI DI CALCOLO  
 SERVIZI KIT  
 PIANI DI SPEDIZIONE


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – V E N D I T E  F U N Z I O N I  A V A N Z A T E  
V E N D I T E  F U N Z I O N I  A V A N Z A T E  - 3 
 
________________________________________________________________________________  
________________________________________________________________________________  
__________________________________________________________________ ______________  
________________________________________________________________________________  
________________________________________________________________________________  
_______________________________________________________________________________ _ 
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
___________ _____________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
________________________ ________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
_____________________________________ ___________________________________________


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  - V E N D I T E  F U N Z I O N I  A V A N Z A T E  
4 -  
 
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________ ________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
_____________________________________________________________ ___________________  
________________________________________________________________________________  
________________________________________________________________________________  
__________________________________________________________________________ ______  
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
______ __________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
___________________ _____________________________________________________________


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – V E N D I T E  F U N Z I O N I  A V A N Z A T E  
I N T E G R A Z I O N E  E D I  - 5  INTEGRAZIONE EDI 
  
L'EDI (Electronic Data Interchange) è lo scambio di dati strutturati nei formati standard mediante 
mezzi elettronici tra applicazioni informatiche. Come "scambio fra i sistemi informativi di aziende 
diverse attraverso una rete di telecomunicazioni di documenti commerciali strutturati secondo 
standard concordati", l'EDI sostituisce i tradizionali sistemi cartacei per gli ordini d'acquisto , fatture, 
ordini di pagamento, bolle di consegna ecc., con una conseguente riduzione dei costi ed un aumento 
dell'efficienza legati ai processi aziendali eliminando controlli e verifiche manuali per tutte le 
transazioni commerciali. Per lo scambio di docu menti ci si può servire di reti private dedicate fornite 
da VAN (Value Added Network) o di Internet (in quest'ultimo caso si parla di Web -Edi o Lite -Edi). 
  
Si tratta dello scambio diretto di messaggi commerciali tra sistemi informativi, usando reti di 
telecomunicazioni nazionali ed internazionali. I messaggi commerciali scambiati attraverso l'EDI 
possono essere documenti di base (ordini, fatture), ma l'EDI può diventare anche uno scambio di 
informazioni più sofisticato, così da permettere ai partner  commer ciali di gestire l'intera catena di 
riapprovvigionamento in modo più efficiente. Essenzialmente l'EDI aumenta la velocità e 
l'accuratezza della comunicazione commerciale e ne riduce i costi. Permetterà di avere informazioni 
più accurate ed aggiornate su cu i basare le decisioni aziendali. L'EDI può collegare più strettamente le 
operazioni commerciali con quelle dei fornitori e clienti più importanti, a beneficio di tutti i soggetti 
coinvolti nella catena di riapprovvigionamento.  
  
Nel mondo EDI vengono utili zzati numerosissimi standard  non solo per i documenti di tipo fattura,


key: chroma:document
string_value:
ordine, documento di trasporto, ma anche per listini, pagamenti, piani di spedizione, ecc..  
Tra tutti gli standard in circolazione si distingue l'EDIFACT, acronimo di Electronic Data In terchange 
For Administration, Commerce and Transport, che è uno standard internazionale proposto dalla 
Commissione Economica delle Nazioni Unite (UN) attraverso il quale vengono definiti:  
 Set di regole sintattiche per strutturare i dati  
 Messaggi standard (es: Invoice, Orders, Desadv , Delfor)  
 Versioni per lo scambio dei dati (Directory)  
  
Si tratta di un sistema dinamico perché vengono fornite nuove versioni (dette directory) di anno i n 
anno, così come vengono definite le regole per nuove tipologie di messaggio.  
Standardizzazioni ( subset ) che derivano direttamente dall'EDIFACT sono proposte da enti nazionali 
ed internazionali, ad esempio:  
 GS1 (a livello internazionale)  
 Indicod -Ecr ( Italia)  
  
I subset  dell'Edifact vengono sviluppati nell'ottica di standardizzare le modalità di comunicazione tra i 
partner  commerciali in modo più specifico rispetto allo standard generale, in modo tale da cogliere le 
peculiarità del settore di appartenen za o del sistema legislativo del Paese di riferimento.  
  
Uno dei subset più importanti è l' EANCOM® definito nell'ambito del sistema GS1, ovvero di un 
sistema integrato di standard  globali che prevedono l'identificazione e la comunicazione esatta delle 
informazioni per quanto riguarda i prodotti, i beni, i servizi e le posizioni. Questo sistema è stato 
sviluppato da GS1, ovvero dalla principale organizzazione mondiale dedicata al disegno ed


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  - V E N D I T E  F U N Z I O N I  A V A N Z A T E  
6 - I N T E G R A Z I O N E  E D I  all'implementazione di standard  globali e soluzioni per migliorare l'efficienza e la visibilità delle Supply 
chains. Il sistema degli standard  GS1 è quello più utilizzato nella catena mondiale di 
approvvigionamento. GS1 disciplina l'assegnazione dei prefissi e definisce le specifiche tecniche a 
livello internazionale in c ollaborazione con lo Uniform Code Council. Ogni Paese a sua volta, 
attraverso le organizzazioni nazionali di codifica (in Italia Indicod -Ecr), è responsabile 
dell'assegnazione dei codici e del rispetto delle regole a livello nazionale. Il sistema GS1 si su ddivide in 
diverse aree. Quella riguardante l'EDI è GS1 eCom, che fornisce gli standard  globali per i messaggi 
elettronici che permettono la trasmissione elettronica, automatica, veloce, efficiente ed esatta dei dati 
fra i partner  commerciali. GS1 eCom for nisce due campioni complementari per i messaggi elettronici: 
GS1 EANCOM e GS1 XML. Entrambi forniscono una struttura standardizzata per i messaggi 
elettronici, permettendo ai partner  commerciali di comunicare velocemente, efficientemente ed 
esattamente i l oro dati, indipendentemente dal tipo di software aziendale utilizzato.  
  
Lo standard XML (eXtensible Markup Language) è stato sviluppato per lo scambio di informazioni 
tramite internet. Non ha lo scopo di competere o rimpiazzare lo standard EANCOM®. E' ind irizzato 
a utenti di tipo diverso e quindi i due standard  sono di fatto usati parallelamente. La logica è tuttavia la 
stessa, ovvero vengono forniti degli schemi standard  per la scambio elettronico dei dati tra partner  
commerciali.  
  
Il subset EANCOM® defi nisce le linee guida per l'implementazione dei messaggi standard 
UN/EDIFACT (le norme delle Nazioni Unite per lo scambio elettronico dei dati nei settori


key: chroma:document
string_value:
UN/EDIFACT (le norme delle Nazioni Unite per lo scambio elettronico dei dati nei settori 
Amministrazione, Commercio e Trasporti). Ad Indicod -Ecr ( http://www .indicod -ecr.it/ ) è affidato il 
compito di diffondere lo standard EANCOM® in Italia, attraverso la creazione e la manutenzione di 
subset nazionali che rispondano alle peculiarità italiane. L'obiettivo principale dell'EANCOM® è di 
fornire alle imprese del largo consumo uno standard per la co municazione EDI sia nazionale che 
internazionale basato sull'uso del sistema di identificazione EAN/UCC.  
  
EANCOM® ha le seguenti caratteristiche:  
 E' un subset perfettamente compatibile con UN/EDIFACT  
 E' internazionale e multisettoriale nella sua applicazione  
 Supporta le specifiche internazionali della Commissione Europea  
 Rappresenta un'unica interfaccia con le applicazioni interne  
 Ha già u na base di utenti nel mondo di oltre 30.000 aziende  
  
Come tutti gli standard EDI, EANCOM® contiene un'insieme di regole che permettono di 
strutturare in modo razionale e concordato i documenti da trasmettere nel corso delle relazioni 
commerciali, attraver so messaggi che coprono tutte le funzioni necessarie a completare una 
transazione commerciale completa. In Italia, la versione ad oggi rilasciata in uso alle aziende che 
aderiscono ad Indicod -Ecr è la 96a, che comprende i seguenti messaggi:  
 Catalogo prodotti (PRICAT)  
 Ordine (ORDERS)  
 Conferma d'ordine (ORDRSP)  
 Fattura (INVOIC)  
 Resale report (RESRPT)  
 Avviso di pagamento (REMADV)  
 Avviso di consegna (DESADV)  
  
In Italia, la Grande distribuzione (GDO) adotta principalmente i subset E difact basati sulle versioni 
(directory) 90.1 e 96A, oppure le corrispondenti versioni nello standard EURITMO, che è uno 
standard basato su tracciati con record a lunghezza fissa e solitamente supportato da modalità di 
trasmissione semplificate che prevedo no l'utilizzo di Internet (Web -EDI).


key: chroma:document
string_value:
trasmissione semplificate che prevedo no l'utilizzo di Internet (Web -EDI).  
Generalmente, ogni messaggio EDI è costituito da segmenti che occupano una posizione ben precisa 
nella sequenza, in particolare possono rientrare nelle tre diverse sezioni del messaggio: testata,


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – V E N D I T E  F U N Z I O N I  A V A N Z A T E  
I N T E G R A Z I O N E  E D I  - 7 dettaglio e sommario.  
  
Nella sezione di testata si collocano i segmenti che contengono informazioni che si riferiscono 
all'intero messaggio.  
  
Nella sezione di dettaglio si collocano i segmenti che contengono solo informazioni di dettaglio.  
  
Nella sezione di sommario si colloc ano solo i segmenti che contengono totali o informazioni di 
controllo possono essere collocati in questa sezione (es. totale fattura, numero di righe nell'ordine etc). 
Lo stesso tipo segmento può esistere in più di una delle sezioni del messaggio (es: la t estata e la 
sezione di dettaglio), e può essere ripetuto più di una volta all'interno della stessa sezione.  
  
Struttura di un segmento standard EDIFACT  
Ogni segmento (riga) di un messaggio EDIFACT si caratterizza per la presenza di:  
 Un tag che identifica  il tipo segmento (es: DTM)  
 Separatori di data element ( + e :) 
 Data element (semplici o composti)  
 Un carattere che indica il termine del segmento (l'apostrofo).  
  
La struttura della testata, del dettaglio o del sommario sono costituiti da una serie d i Tag secondo una 
precisa sequenza. I Tag presenti nelle strutture possono essere rappresentati in gruppi (SG1, SG2, 
SG3): i gruppi di segmenti definiscono una sorta di gerarchia tra i singoli Tag presenti sul file. Ad 
esempio, nel caso del messaggio Edifa ct DESADV , le informazioni di dettaglio sono rappresentate da 
tutti i segmenti del gruppo SG10, costituito da un Tag principale (CPS) e da sottogruppi di Tag 
(SG11, SG15) a loro volta costituiti da Tag principali e altri sottogruppi.  
  
I data element che c ompongono ogni segmento/Tag hanno una lunghezza massima predefinita. 
Possono contenere informazioni di per sé sufficienti o che necessitano di dettagli aggiuntivi per 
acquistare un significato specifico. A questo fine vengono utilizzati i data element qual ificatori il cui


key: chroma:document
string_value:
contenuto è espresso sotto forma di un codice appartenente ad un set di valori di cui si è concordato 
il significato. Ad esempio, se deve essere espressa una data/ora, dovranno essere utilizzati anche dei 
data element per stabilire di che data/ora si tratta (ad es: data/ora del documento) e in che formato è 
stata espressa (ad es: anno, mese, giorno).  
  
Interpretazione dei files EANCOM® 
Di seguito viene descritta la sintassi standard secondo specifiche EANCOM®. I valori che possono 
assumere i data element sono contraddistinti dall'utilizzo di tre diversi caratteri che fungono da 
separatori:  
 + (segno più) viene utilizzato per separare i data element all'interno del segmento  
 : (due punti) viene utilizzato per separare i data element contenuti in un data element 
composto  
 ' (apostrofo) viene utilizzato per segnalare la fine del segmento  
  
Esempio  
DTM+137:19940101:102'  
 DTM à sigla di identificazione del segmento  
 + à separatore  
 137 à qualificatore del tipo di data  
 : à separatore di data element contenuti in un data element composto


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  - V E N D I T E  F U N Z I O N I  A V A N Z A T E  
8 - I N T E G R A Z I O N E  E D I   19940101 à data  
 : à separatore di data element con tenuti in un data element composto  
 102 à qualificatore che indica il formato della data  
 ' à indicatore di fine segmento  
  
I data element  sono identificati in base alla loro posizione sequenziale nel segmento secondo i formati 
di segmento definiti dallo  standard. Se un data element definito conditional (non obbligatorio) viene 
omesso ed è seguito da un altro data element, la sua posizione viene indicata dalla presenza del suo 
separatore.  
  
Negli esempi seguenti le sigle utilizzate assumono il seguente si gnificato:  
 TAG à sigla che identifica il messaggio  
 CE à data element che fa parte di un data element composto  
 DE à data element singolo (non fa parte di alcun data element composto)  
  
Esempio  
TAG+DE+DE+DE+CE:CE:CE’                          segmento completo che  include tutti i data 
element  
TAG+DE ++DE+CE:CE:CE’                              un DE è stato omesso  
  
Nel caso in cui uno o più data element definiti ‘conditional’ e situati alla fine del segmento vengano 
omessi, il segmento viene troncato utilizzando il segnalatore di fine segmento (‘).  
  
Esempio  
TAG+DE+DE+DE+DE'                                     segmento originale completo di tutti i data element  
TAG+DE+ DE'                                                  due DE sono stati omessi alla fine del segmento  
  
Nel caso in cui un data element conditional che fa parte di un data element composto venga omesso e 
sia seguito da un altro data element che fa parte dello stesso data element composto, la sua posizione 
viene segnalata dal suo separatore rappresentato d ai due punti.  
  
Esempio  
TAG+DE++DE+CE:CE:CE'                              segmento originale completo di tutti i data element  
TAG+DE++DE+ CE::CE                                     un CE è stato omesso


key: chroma:document
string_value:
TAG+DE++DE+ CE::CE                                     un CE è stato omesso  
  
Nel caso in cui uno o più data element conditional che  sono posizionati alla fine dello stesso data 
element composto vengano omessi, essi saranno troncati da un separatore di DE (+) o dal 
segnalatore di fine segmento nel caso essi siano gli ultimi data element presenti.  
  
Esempio  
TAG+DE+CE:CE:CE+DE+CE:CE'                   segmento originale completo di tutti i data element  
TAG+DE+ CE+DE +CE'                                     tre CE sono stati omessi  
  
 Ad Hoc e l'EDI  
 Gestione tabelle import/export


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – V E N D I T E  F U N Z I O N I  A V A N Z A T E  
I N T E G R A Z I O N E  E D I  - 9  Ad Hoc e l'EDI  
  
La trasmissione dei file è una delle fasi fondamentali che consentono la realizzazione dell'EDI 
(scambio di dati). La situazione ideale e quindi la tendenza di ogni azienda è quella di automatizzare 
anche questa fase delicata del processo attraverso una piena integrazione con il sistema gestionale 
utilizzato. Le m odalità di trasmissione sono le più svariate: linee telefoniche ISDN, VAN (intermediari 
che solitamente dispongono di reti di comunicazione proprietarie ed offrono anche servizi di 
traduzione dei messaggi), Email, Internet, ecc..  
  
In ad hoc sono gestiste solo la fase iniziale e quella finale dell'EDI, ovvero la generazione dei file 
oppure la loro importazione. Sostanzialmente il programma non si occupa della trasmissione e quindi 
dell'invio/ricezione dei file, ma si limita a generare i file in una cartella  predefinita, oppure ad 
importarli selezionandoli manualmente o automaticamente a seconda dei parametri definiti dall'utente.  
  
Entrambe le fasi (generazione/importazione) possono essere gestite attraverso la definizione di n 
strutture parametriche assimil abili concettualmente ad un report di stampa. Alla pari di un report, le 
strutture EDI sono associabili a causali documento ed eventualmente alla combinazione Causale 
documento -intestatario, inoltre, così come un report consente di definire il Layout dei d ati sulla carta, 
una struttura EDI consente di definire il Layout dei dati sul file. La struttura, della quale è disponibile 
anche una visualizzazione ad albero, rappresenta la chiave di lettura/scrittura dei file.  
Per ogni standard EDI che l'azienda inten de adottare dovrà essere predisposta almeno una struttura 
(es: Fattura Eancom 96A, DT Eancom 96A, Ordine Eancom 96A, Fattura XML).


key: chroma:document
string_value:
(es: Fattura Eancom 96A, DT Eancom 96A, Ordine Eancom 96A, Fattura XML).  
  
Il legame tra struttura EDI e dati da scrivere sul file è rappresentato dall'entità che rappresenta 
l'insieme di tabelle ch e gravitano attorno ad una gestione. In sostanza si tratta dell'insieme di 
tabelle/campi utilizzabili per la creazione dei file EDI. Per quanto riguarda il processo di 
importazione è necessario aver definito e creato sul database le Tabelle piatte: si trat ta di tabelle che 
devono consentire di mappare tutti i dati utili provenienti dal file destinati ad essere elaborati per la 
scrittura nelle tabelle dei documenti (Doc_mast, Doc_dett, ecc.). La maggior parte dei campi presenti 
sulle tabelle piatte corrispon deranno a tabelle/campi dei documenti, ma potranno accogliere anche 
tabelle/campi diversi, definibili tramite apposita gestione ed utilizzabili se previsti da uno dei Batch di 
importazione (compito demandato al concessionario Zucchetti).  
  
Il file generato /interpretato da ad hoc è sempre un file di testo, tuttavia, rispettando le regole 
sintattiche del linguaggio XML, è chiaramente possibile generare/importare anche file di questa 
tipologia (comunque rappresentabili come file di testo).  
  
- Archivi  
- Visualizzazione struttura  
- Duplicazione struttura  
- Eliminazione struttura  
- Parametri EDI


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  - V E N D I T E  F U N Z I O N I  A V A N Z A T E  
10 - I N T E G R A Z I O N E  E D I  Archivi EDI  
  
- Struttura  
- Valori predefiniti  
- Variabili nome file  
- Entità  
- Elementi  
- Form ati 
- Caratteri speciali  
- Gruppi intestatari EDI  
- Trascodifiche  
- Stampe archivi EDI


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – V E N D I T E  F U N Z I O N I  A V A N Z A T E  
I N T E G R A Z I O N E  E D I  - 11 Struttura  
  
In questo archivio è possibile definire le caratt eristiche di base di una struttura EDI. La struttura vera 
e propria verrà costruita sulla base delle relazioni tra i vari elementi che si andranno a definire in un 
archivio distinto.  
  
 
Di cosa si compone una struttura EDI  
  
Il caricamento di una struttur a EDI (ex -novo) implica la necessità di seguire un determinato iter imposto dai 
particolari legami tra i vari archivi del modulo: per prima cosa si devono definire Codice e Descrizione della 
struttura. A questo punto è possibile salvare e procedere con il caricamento dell'Elemento Radice e del Formato 
Gruppo (nei corrispondenti archivi). Successivamente sarà possibile completare l'anagrafica della struttura EDI.  
NB: E' anche necessario aver già definito almeno una Tabella piatta in fase di caricamento di un a nuova struttura 
EDI.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  - V E N D I T E  F U N Z I O N I  A V A N Z A T E  
12 - I N T E G R A Z I O N E  E D I  
 
Anagrafica Strutture  
  
 Codice Struttura  
In questo campo deve essere indicato il codice della struttura EDI.  
 Descrizione  
Descrizione della Struttura EDI  
 Predefinita  
L'attivazione di questo check fa si che il codice della struttura venga proposto nelle altre gestioni 
relativ e all'EDI (ad esempio, nella treeview o nella definizione degli elementi, ecc. ecc.). Questo 
velocizza l'interrogazione o il caricamento degli elementi di una struttura. La sua attivazione ha senso 
proprio durante la fase di implementazione di una nuova st ruttura EDI. Il check dovrebbe essere 
attivato solo su una delle strutture caricate in archivio; in caso contrario, quella predefinita diverrebbe 
la prima occorrenza dei codici struttura ordinati alfabeticamente.  
 Separatore  
Questa combo box consente di definire il formato del separatore per i valori numerici in fase di 
generazione/importazione dei file EDI. E' possibile stabilire se deve essere utilizzato un separatore ed 
eventualmente quale.  
 Punto: i valori nu merici verranno esportati/interpretati su/dal file con separatore . (punto)


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – V E N D I T E  F U N Z I O N I  A V A N Z A T E  
I N T E G R A Z I O N E  E D I  - 13 tra parte intera e parte decimale;  
 Virgola: i valori numerici verranno esportati/interpretati su/dal file con separator e, (virgola) 
tra parte intera e parte decimale;  
 Nessuno:  i valori numerici verranno esportati/interpretati su/dal file senza alcun separatore 
tra parte intera e parte decimale;  
 Indentatura  
In questo campo è possibile specificare il numero di spazi da inserire per ogni livello di indentatura. E' 
legato all'uti lizzo delle opzioni Indenta/Deindenta sui formati. Un livello di indentatura corrisponde 
al numero di spazi inseriti in questo campo; due livelli di indentatura corrispondono al doppio del 
numero di spazi inseriti in questo campo; tre livelli di indentatur a corrispondono al triplo del numero 
di spazi inseriti in questo campo e così via.  
 Entità  
Consente di specificare l'entità di riferimento, solo in fase di caricamento. Per i documenti l'entità sarà 
caratterizzata non solo dalle tabelle specifiche (DOC_MAST, DOC_DETT, DOC_RATE) ma anche 
dalle tabelle relative all'intestatario, alle sedi , ecc. ecc.. Per avere la possibilità  di utilizzare determinate 
informazioni in fase di generazione dei file, sarà sufficiente legare le tabelle che contengono 
l'informazione che si desidera all'entità indicata sulla struttura EDI. Ad esempio, per esportat e la 
descrizione di un codice IVA è necessario creare un legame con la tabella VOCIIVA. Quest'ultima 
sarà legata a DOC_DETT, a sua volta legata alla tabella principale DOC_MAST.  
 Elemento Radice  
Si tratta dell'elemento base di una struttura.. La radice rappresenta il punto di partenza per l'esplosione 
degli elementi (ad esempio potranno essere collegati alla radice i seguenti raggruppamenti di elementi: 
testata file, testata docu mento, corpo documento, piede documento e piede file). Un elemento radice


key: chroma:document
string_value:
ha solo questo scopo. Si tratterà sostanzialmente di un elemento di raggruppamento con un formato 
limitato all'Esplosione figli.  
 Formato Gruppo  
In questo campo può essere indicato il formato da utilizzare per tutti gli elementi di raggrupamento di 
tipologia Fisso.  
 Tipo file  
Questa combo box consente di definire la tipologia del file da generare/importare (XML, Edifact, 
Generico). In base a questa informazione sono previsti determi nati automatismi e/o comportamenti 
della procedura. I file vengono sempre generati costruendo delle stringhe di testo da riportare sugli 
stessi, secondo la definizione della struttura EDI, attenendosi precisamente ai parametri definiti sugli 
elementi. Le d ifferenze sostanziali tra le tipologie specificabili nella combo box riguardano le modalità 
di interpretazione dei file:  
 XML: per file di tipologia XML vengono applicate metodologie specifiche per individuare il 
contenuto dei tag;  
 Edifact: per file di tipologia Edifact, il programma si attiene strettamente alla defin izione 
degli elementi/formati. E' data la possibilità  di eliminare gli spazi superflui (sul file generato) 
attivando l’apposito check (e di norma è attivato per creare un file compattato, senza gli spazi 
inutili).;  
 Lunghezza Fissa: in questa categoria rientrano tutti i file che si caratterizzano per la pre senza 
di informazioni (record) a lunghezza fissa. Il messaggio EDI sarà quindi costituito da una serie 
di record, formanti un file sequenziale di tipo testo (flatfile).  
 Generico: per file di tipo diverso la metodologia adottata è sostanzialmente identica  a quella 
prevista per l'Edifact.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  - V E N D I T E  F U N Z I O N I  A V A N Z A T E  
14 - I N T E G R A Z I O N E  E D I   Elimina Spazi  
L'attivazione di questo check consente di applicare l'eliminazione degli spazi bianchi (ALLTRIM) su 
tutti i valori in uscita da ciascun elemento.  
  
La funzione ALLTRIM non interviene solo nel caso in cui il  formato associato all'elemento abbia attivato 
l'apposito check che ha proprio lo scopo di escludere l'eliminazione degli spazi (vedere archivio Formati).  
  
 Nome File  
In questo campo è possibile definire la struttura del nome file. Inserendo tra parentes i angolari 
determinate variabili, è possibile determinare quale sarà il nome del file.  
  
Alcune di queste variabili non possono essere considerate nel caso di generazione di un solo file a 
fronte di più documenti (export massivo dei documenti EDI su file u nico).  
  
Le variabili che possono essere utilizzate in ogni caso sono:  
CODCON : Intestatario documento. Nel caso di export massivo corrisponde al cliente/fornitore 
indicato nel campo intestatario, altrimenti non viene preso in considerazione (Alltrim su cod ice). 
PROGRE : Progressivo generazione file EDI (str di un numerico di 14 cifre con zero filling a sinistra)  
DATE : Data di sistema (nel formato AAAAMMGG)  
TIME : Ora di sistema (nel formato HHTTSS)  
  
Le variabili che possono essere utilizzate solo quando vien e generato un solo file per ogni documento 
sono:  
NUMERO DOCUMENTO  
SERIE DOCUMENTO  
DATA DOCUMENTO  (nel formato AAAAMMGG)  
DATA REGISTRAZIONE  (nel formato AAAAMMGG)  
NUMERO PROTOCOLLO  
SERIE PROTOCOLLO  
  
Ad esempio, inserendo in questo campo la seguente stringa : 
<PROGRE>_<CODCON>_<DATE>_<TIME>.TXT ', si potrebbe ottenere un file nominato 
nel seguente modo:  
  
00000000002563_ANALOGICA_20060930_113051 .TXT  
  
Progressivo: 2563  
Intestatario: Analogica  
Data sistema: 30 settembre 2006  
Ora sistema: 11:30 (51 secondi)  
 Var file


key: chroma:document
string_value:
Data sistema: 30 settembre 2006  
Ora sistema: 11:30 (51 secondi)  
 Var file  
Premendo questo bottone è possibile accedere all'archivio legato all’anagrafica strutture EDI che 
permette di definire il formato di esportazione delle variabili parametriche specificate nel nome file. 
Ad esempio, per la data documento si potrà in dicare una maschera specifica diversa da quella 
predefinita (AAAAMMGG).


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – V E N D I T E  F U N Z I O N I  A V A N Z A T E  
I N T E G R A Z I O N E  E D I  - 15 La compilazione di tale archivio non è obbligatoria! Verrà utilizzato in fase di esportazione esclusivamente per le 
variabili che sono state indicate. Per quelle non specificate verr à applicato il formato di esportazione predefinito!  
  
Si aprirà la maschera  
  
- Variabili nome file  
  
 Normalizzazione  
La normalizzazione permette di generare/importare i file conformi a determinati standard. Alcuni 
caratteri (caratteri speciali) devono essere trascodificati in fase di export/import file EDI, al fine di 
consentire la generazione di un file conforme ad un determinato standard o l'interpretazione dello 
stesso . Ad esempio, per il formato Edifact, il carattere + eventualmente contenuto nei valori da 
esportare sul file, deve essere trascodificato perché in quello standard viene utilizzato come separatore 
tra i data element.  
 Tabella piatta  
Codice della tabella piatta. Questa tabella identifica l'archivio persistente sul quale sono memorizzati 
tutti i dati interpretati dai file EDI in ingresso mediante la struttura. Prima di poter procedere al 
caricamento di una struttura EDI  è necessario aver definito le caratteristiche della tabella piatta nel 
corrispondente archivio. La tabella piatta può contenere in realtà n tabelle ed n campi, anche non 
corrispondenti ad alcun archivio di ad hoc. Tali campi saranno utilizzabili sugli ele menti della struttura 
EDI (in import e/o in export) dopo aver stabilito un legame (anche fittizio) con la tabella principale 
dell'Entità di riferimento.  
 Lunghezza ID primario  
Si tratta della lunghezza dell'identificativo di riga. I primi n caratteri di ogni riga del file vengono 
utilizzati per identificare il segmento e quindi fare il matching con uno degli elementi della struttura 
(che ha valorizzato l' ID primario). Quando questo campo viene modificato, alla conferma il


key: chroma:document
string_value:
(che ha valorizzato l' ID primario). Quando questo campo viene modificato, alla conferma il 
programma chiede se si intendono aggiornare i campi Lunghezza di ogni elemento TAG (ovvero con 
Id Primario valorizzato).  
 Lunghezza segmento  
Questo campo è visibile solo per strutture di  tipologia Lunghezza Fissa. Se viene valorizzato, significa 
che ogni riga del file ha una lunghezza fissa pari al numero di caratteri indicato. Viene utilizzato in fase 
di import per Spezzare su più righe il contenuto di file per i quali non esiste un fine  riga. 
  
Se il file da importare è già suddiviso su più righe, ciascuna delle quali rappresenta un determinato segmento  del 
tracciato, questo campo deve essere lasciato a zero (valore predefinito).  
  
 Tipologia struttura  
Questa combo box consente di definire la tipologia di struttura. Il valore predefinito è Entrambe, 
altrimenti è possibile qualificare una struttura come utilizzabile solo in Import o solo in Export. In 
base alla tipologia saranno valo rizzabili o meno i corrispondenti campi nell'anagrafica elementi.  
 Routine Import  
In questa sezione della maschera vengono esplicitate le routine  utilizzate nella fase di importazione di


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  - V E N D I T E  F U N Z I O N I  A V A N Z A T E  
16 - I N T E G R A Z I O N E  E D I  file EDI. Tale procedura è costituita da vari step contraddistinti c iascuno da almeno un file Batch che 
guida il trattamento dei dati di step in step fino ad arrivare al passaggio dei dati al generatore 
documentale.  
 Primo step  
E' il nome della routine da utilizzare per la trasformazione del file in ingresso in un file XM L. Questo 
passaggio ha lo scopo di creare un oggetto (file XML) che senz'altro facilita nella ricerca delle 
informazioni da trattare, offrendo un'interfaccia di navigazione più flessibile rispetto a quella 
eventualmente da predisporre per fare ricerche sul  file originario.  
Il nome della routine standard è GSVA_BXM  
 Secondo step  
Rappresenta la routine che ha il compito di caricare in memoria il file XML generato allo step 
precedente, di calcolare la chiave univoca per l'inserimento nelle tabelle EDI e di chiamare la funzione 
per il trattamento dei dati (esplicitata nel campo accanto).  
Il nome della routine standard è GSVA_BDR.  
 Funzione  
È la funzione che si occupa dell'effettiva scrittura dei dati nelle tabelle piatte. Semplificando, il 
programma risale agli elementi della struttura in base ai nomi dei Tag contenuti  nel file XML e ricava 
dagli stessi Tabella/Campo in cui andare a scrivere il dato, applicando eventuali trascodifiche.  
Il nome della routine standard è GETOBJXML.  
 Gestione terzo step  
In questo step è possibile definire la routine o la maschera da lancia re per la modifica dei dati inseriti 
nelle tabelle EDI. Se l'importazione dei dati EDI risulta avere tutti i dati congruenti con la base dati di 
ad hoc questo passaggio è opzionale è può essere considerato come una visualizzazione di verifica 
dell'avvenuta  importazione.  
Il nome della routine standard è GSVA_BI3.  
 Quarto step  
La routine indicata in questo campo è quella che si occupa della scrittura del documento,


key: chroma:document
string_value:
La routine indicata in questo campo è quella che si occupa della scrittura del documento, 
dell'anagrafica importazioni e del log. Se nella tabella piatta sono stati utilizzati solo campi previsti 
anche nelle tabelle di destinazione (dei docum enti), allora è utilizzabile il file batch standard. Se invece 
i dati del file sono stati mappati in tabelle/campi diversi da quelli standard, allora è necessario 
predisporre un'apposita routine per la gestione dei nuovi campi ed eventualmente modificare a nche la 
scrittura del documento.  
Il nome della routine standard è GSVA_BCD.  
 Import Massivo  
L'attivazione di questo check fa si che la struttura in oggetto venga considerata tra quelle utilizzabili 
per l'esecuzione dell'import massivo documenti. Attivando il check è anche necessario definire alcuni 
parametri: ordinamento e parame tri file.  
Ordinamento  
In questo campo deve essere definita la priorità della struttura per l'import massivo. Il programma 
ordina le strutture EDI utilizzabili per l'import massivo in base a questo valore (minore è il valore e 
prima sarà considerata la stru ttura) poi ricerca i file nella cartella definita per l'import in base ai 
parametri forniti dall'utente per la struttura stessa.  
 File Associati  
Premendo questo bottone è possib ile accedere all'elenco dei partner  definiti per costruire 
l'associazione dei file alla struttura. Ad esempio, inserendo una riga del tipo *.* il programma


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – V E N D I T E  F U N Z I O N I  A V A N Z A T E  
I N T E G R A Z I O N E  E D I  - 17 considererà tutti i file presenti nella cartella im port cercando di interpretarli con la struttura di 
riferimento. E' possibile specificare un path diverso (per ciascun pattern) per la ricerca dei file. Se non 
viene indicato un percorso specifico per un pattern, il percorso di ricerca è quello predefinito,  ovvero 
quello indicato nei parametri EDI. Un apposito check (ultima colonna a DX) consente di stabilire se 
la ricerca deve essere effettuata anche nelle sottocartelle.  
  
 
Maschera di definizione nome file da considerare in import  
  
 Valori predefiniti  
Questo bottone consente di accedere alla gestione dei Valori Predefiniti.  
Si visualizzerà la maschera  
  
- Valori predefiniti  
  
 Blocca/Sblocca  
Questi bo ttoni sono editabili solo in modalità di interrogazione dell'archivio: sono alternativi (si vede il 
Blocca o lo Sblocca) consentono di modificare lo stato di una struttura EDI. In particolare, il bottone 
Blocca porta lo stato della struttura a Confermata m entre il bottone Sblocca porta lo stato della 
struttura a Provvisoria. Quando una struttura è confermata non è possibile apportare modifiche né 
all'archivio corrente né a tutti i record collegati presenti negli archivi: Elementi, Formati e 
Trascodifiche.  
  
Nel caso in cui si manifesti l'esigenza di effettuare delle modifiche agli elementi, formati o trascodifiche di una 
struttura confermata, si dovrà modificare prima lo status tramite il bottone Blocca. La possibilità di attribuire uno 
stato alle strutture EDI, dovrebbe fungere da deterrente contro modifiche involontarie che potrebbero rendere i file 
esportati/da importare non interpretabili o non conformi agli standard  pattuiti.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  - V E N D I T E  F U N Z I O N I  A V A N Z A T E  
18 - I N T E G R A Z I O N E  E D I  Valori predefiniti  
  
Nella masche ra valori predefiniti accessibile da “anagrafica struttura” è data la possibilità di distinguere 
tra valori predefiniti fissi, ovvero quelli fin ora utilizzati, e variabili, ovvero la nuova tipologia di valore 
predefinito, che permette di valorizzare un ca mpo del documento in base al valore di un determinato 
campo delle tabelle piatte. Lo scopo principale di questa funzione è quello di consentire la 
valorizzazione della data di prevista evasione delle righe di un documento in base alla data di prevista 
evasione presente sul file solo come dato di testata.  
  
 In questo archivio, collegato alla struttura, è possibile inserire l'elenco di valori predefiniti da utilizzare 
solo in caso di importazione di un file EDI proveniente dall'esterno. Un valore predefinito  potrebbe 
essere rappresentato dalla causale documento da utilizzare per l'inserimento dei documenti sul 
programma oppure dalla tipologia di conto relativa all'intestatario.  
  
Ad esempio, in caso di import fatture, la tipologia di conto potrebbe essere val orizzata con il valore F 
(Fornitori), oppure, in caso di import ordini potrebbe essere valorizzato con C (Clienti).  
  
 
Gestione Valori Predefiniti struttura EDI  
  
Per ogni campo delle tabelle presenti nell'entità Agganciata alla struttura è possibile defi nire un 
determinato valore. Nel caso in cui il valore di un campo fosse presente contestualmente su un file da 
importare e sulla gestione dei valori predefiniti, il primo avrebbe priorità, ovvero, tutto ciò che è stato 
inserito come valore predefinito potr ebbe essere sostituito da ciò che viene letto direttamente dal file 
importato.  
 Tipo  
E’ il tipo di valore predefinito, fisso o variabile: in base alla selezione compariranno, rispettivamente, il


key: chroma:document
string_value:
campo dove inserire un valore predefinito oppure tabella/cam po dell’archivio tabelle piatte.  
 Fisso: permette di indicare esclusivamente un valore predefinito (fisso) che verrà scritto nella 
tabella/campo del documento generato;  
 Variabile: permette di indicare tabella/campo definiti nella gestione delle tabelle piatte. Si 
tratta di un valore predefinito variabile perché determinato dal contenuto di un campo che viene 
valorizzato al terzo step (passaggio dati da file XML a tabelle piatte). Può trattarsi anche di un 
campo nuovo non previsto nelle tabelle corrispond enti del documento ed utilizzato 
esclusivamente per determinare il contenuto di altri campi. Ad esempio, è possibile scrivere la 
data di prevista evasione su un campo creato nelle tabelle piatte (ad esempio MVDATEVA in


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – V E N D I T E  F U N Z I O N I  A V A N Z A T E  
I N T E G R A Z I O N E  E D I  - 19 DOC_MAST) e poi utilizzare questa dat a per valorizzare la data di prevista evasione su tutte le 
righe del documento (MVDATEVA in DOC_DETT).  
 Tabella/Campo (e Valore predefinito)  
Accanto alla combo box “Tipo” compaiono i campi tabella/campo oppure valore predefinito a 
seconda della selezione  fatta, rispettivamente, “variabile” o “fisso”.  
In entrambi casi il tipo di campo selezionato o il tipo di dato immesso come valore predefinito 
devono essere congruenti rispetto al campo di destinazione. Quando si deve imputare un valore 
predefinito fisso il programma permette di inserire esclusivamente un numero, una stringa o una data 
in base alla tipologia del campo di destinazione tenendo conto anche della lunghezza. Nel caso di 
selezione di tabella (da dettaglio entità) e campo (da dettaglio tabelle pi atte) esiste un controllo di 
congruenza in merito a tipologia e lunghezza.  
Attenzione, campo incongruente per tipo, lunghezza o numero decimali.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  - V E N D I T E  F U N Z I O N I  A V A N Z A T E  
20 - I N T E G R A Z I O N E  E D I  Variabili nome file  
  
Questa maschera permette di definire il for mato di esportazione delle variabili parametriche 
specificate nel nome file. Ad esempio, per la data documento si potrà indicare una maschera specifica 
diversa da quella predefinita (AAAAMMGG).  
  
La compilazione di tale archivio non è obbligatoria! Verrà u tilizzato in fase di esportazione esclusivamente per le 
variabili che sono state indicate. Per quelle non specificate verrà applicato il formato di esportazione predefinito!  
  
L’archivio “Variabili nome file” è raggiungibile premendo l’apposito bottone dal l’anagrafica struttura 
EDI.  
  
 
Variabili nome file  
  
 Codice variabile  
Per ogni variabile che si può indicare nel nome file è disponibile un corrispondente valore nella 
combo box.  
 Maschera  
Questo campo permette di definire in che modo deve essere scritta la variabile:  
 Per i campi numerici è possibile in dicare esclusivamente una serie di 9 per definire la 
lunghezza del dato. Inoltre è possibile abilitare lo “Zerofill” per ottenere lo zero filling qualora il 
numero da scrivere sul file fosse più corto rispetto alla lunghezza definita con la serie di 9.  
 Per i campi alfanumerici è possibile indicare esclusivamente una serie di X per definire la 
lunghezza del dato (rientra in questa tipologia anche il tipo di dato “time”).  
 Per i campi data è possibile utilizzare le lettere A, M, G per definire, rispettivam ente, la 
lunghezza di anno, mese e giorno ed eventualmente dei separatori che possano essere utilizzati.  
  
Nel campo maschera non è ammesso l’inserimento di caratteri non utilizzabili nel nome file, nella fattispecie: \ / : 
* ? " < > |.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – V E N D I T E  F U N Z I O N I  A V A N Z A T E  
I N T E G R A Z I O N E  E D I  - 21 Nel caso si tenti d i inserire un dato non ammesso, compare un apposito messaggio di warning relativamente alla 
incongruenza riscontrata.  
  
 Zerofill  
Questo check è editabile solo per le variabili di tipo numerico e permette di definire se applicare lo 
zero filling al dato.  
Import/Export archivi EDI


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  - V E N D I T E  F U N Z I O N I  A V A N Z A T E  
22 - I N T E G R A Z I O N E  E D I  Entità  
  
Un'entità rappresenta l'insieme di tabelle che gravi tano attorno ad una gestione. Facendo riferimento 
ai documenti, le tabelle che costituiranno l'entità da utilizzare per l'esportazione/importazione di file 
EDI saranno senz'altro quelle dei documenti: DOC_MAST, DOC_DETT, DOC_RATE; oltre a 
queste, potranno far parte dell'entità tutte le tabelle dalle quali Dipendono quelle dei documenti, ad 
esempio CONTI, VALUTE, PAG_AMEN, ecc. ecc.. Il rapporto di dipendenza è determinato dal 
fatto che su un documento non posso inserire un intestatario che non è presente ne lla tabella 
CONTI, una valuta che non è presente in VALUTE, un codice pagamento che non è presente in 
PAG_AMEN e così via.  
  
Se nell'archivio delle tabelle piatte sono stati definiti nuovi tabelle/campi, per poterne fare la mappatura con gli 
elementi della  struttura EDI, è necessario definire un legame con la tabella principale dell'entità, anche se fittizio. 
Questo legame servirà per l'individuazione dei record facenti capo, ad esempio, ad un determinato documento.  
  
L'anagrafica delle Entità consente quin di di definire l'insieme di queste tabelle e i loro legami (join), 
oltre ad altre informazioni utilizzate in fase di export o import dei file EDI.  
  
 
Archivio Entità  
  
 Entità  
Rappresenta il codice dell'entità con annessa descrizione.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – V E N D I T E  F U N Z I O N I  A V A N Z A T E  
I N T E G R A Z I O N E  E D I  - 23  Controlli  
Routine  eseguita in fase di verifica dei file EDI per effettuare i controlli di coerenza dei dati prima 
dell'inserimento dei documenti nelle corrispondenti tabelle. La routine standard che esegue questi 
controlli è GSAR_BAD.  
 Preimportazione  
Routine eseguita pri ma dell'importazione di file EDI. Non sono previste routine standard da inserire 
in questo campo.  
 Postimportazione  
Routine eseguita dopo l'importazione dei documenti da file EDI per l'aggiornamento delle tabelle 
collegate (ad esempio: aggiornamento saldi  magazzino, ect).  
  
Dettaglio Entità  
Nel dettaglio devono essere definite le tabelle che costituiscono l'entità in oggetto. Per agevolare 
l'acquisizione delle informazioni utili soprattutto alla generazione dei files EDI, è utile indicare il 
maggior numero  possibile di tabelle che contengono tali dati, stabilendono i legami con la tabella 
principale (DOC_MAST) o con una delle tabelle collegate (ad esempio, DOC_DETT). In questo 
modo i dati potranno essere esportati creando degli elementi che punteranno diret tamente a 
tabella/campo senza dover costruire complicate espressioni per ricavarli (ad esempio, espressioni tipo 
Looktab).  
  
La tabella definita come principale sarà DOC_MAST. I campi Tipo aggiornamento e File delle tabelle 
non hanno rilevanza in ambito ED I: sono ineditabili per la tabella principale e si dovrà lasciare il 
valore di default per le tabelle collegate (rispettivamente Modifica e Facoltativo). Le impostazioni 
rilevanti per il dettaglio delle entità sono racchiuse nei seguenti campi: Archivio, L egame, Filtro e 
Collegata.  
  
Le tabelle selezionabili nello zoom sono quelle presenti nel dizionario dati. Per aggiornare il dizionario dati è 
sufficiente lanciare la funzione Caricamento dizionario dati disponibile all'interno del modulo Magazzino (Import


key: chroma:document
string_value:
listini) o del Modulo Import Dati (Servizi).  
Se l'utente ha definito nuove tabelle (nell'anagrafica tabelle piatte), il dizionario dati dovrebbe risultare già 
aggiornato. Se, invece, tale anagrafica è stata popolata utilizzando la procedura di import, occ orre effettuare il 
caricamento dizionario dati.  
  
 Descrizione  
Selezionata una tabella nel dettaglio entità, comparirà la sua descrizione (prevista da analisi) nel 
corrispondente campo (non editabile) posto sotto lo zoom.  
 Legame  
In questo campo deve ess ere definito il legame tra la tabella indicata nella riga dello zoom sulla quale 
si è posizionati e un'altra tabella dell'entità. Se la join da creare è tra tabella Collegata e tabella 
Principale (DOC_MAST) e se è previsto un link da analisi, il legame vie ne proposto automaticamente 
(il bottone contestuale asterisco consente di richiamarlo se l'utente lo avesse modificato). In caso 
contrario, è possibile digitare manualmente la join oppure Incollarla dagli appunti dopo aver verificato 
i legami dalla gestion e Controllo Relazioni Tabelle (accessibile mediante il bottone Relazioni descritto


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  - V E N D I T E  F U N Z I O N I  A V A N Z A T E  
24 - I N T E G R A Z I O N E  E D I  di seguito). Il secondo bottone (puntini) consente di verificare la correttezza della join dopo aver 
valorizzato il campo della tabella di riferimento: Collegata.  
 Filtro  
Questo campo deve essere utilizzato quando non è possibile definire un legame tra le tabelle delle 
entità oppure quando la join indicata nel campo Legame non è sufficiente per selezionare un 
determinato record del database. Ad esempio, il semplice legame tr a documento e sedi azienda 
(SEDIAZIE.SECODDES=DOC_MAST.MVCODSED) non consente di far capo in modo certo ad 
una determinata sede azienda, perché il codice indicato sul documento potrebbe trovare 
corrispondenza in n aziende presenti sul database del gestiona le. 
Inserendo un filtro del tipo SEDIAZIE.SECODAZI=I_CODAZI, si risolve agevolmente il 
problema perché, di tutte le sedi con quel determinato codice sul documento, verrà considerata solo 
quella relativa all'azienda corrente.  
Il campo filtro sarà l'unico da  compilare per poter inserire la tabella AZIENDA nelle entità: in questo 
caso non esiste alcun legame diretto/indiretto con i documenti, perciò si valorizzerà solo il campo 
filtro con una stringa del tipo AZIENDA.AZCODAZI=I_CODAZI. Sarà il filtro stesso ch e 
consentirà di recuperare informazioni per l'azienda corrente dalla tabella Azienda (ad esempio, ragione 
sociale, indirizzo, ecc. ecc.) funzionando di fatto come un legame.  
Il bottone (puntini) posto accanto al campo Legame effettua un controllo di coeren za anche sul 
contenuto del campo Filtro.  
 Collegata  
In questo campo deve essere indicata la tabella con la quale si vuole stabilire il legame. La join deve 
essere costruita tra tabella indicata sulla riga sulla quale si è posizionati e questa tabella.  
 Relazioni  
Premendo il bottone Relazioni si  apre una gestione per il controllo delle relazioni tra le tabelle del


key: chroma:document
string_value:
gestionale che può essere utile in fase di predisposizione dei legami (join) tra le tabelle da inserire nelle 
entità. Scopo della funzione Controllo Relazioni Tabella è quello di metter e in evidenza i legami 
previsti da analisi tra le tabelle del gestionale. E' possibile visualizzare l'elenco delle tabelle Collegate da 
analisi selezionandone una nell'apposito campo e stabilendo il criterio di dipendenza.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – V E N D I T E  F U N Z I O N I  A V A N Z A T E  
I N T E G R A Z I O N E  E D I  - 25 
 
Controllo Relazioni Tabella  
  
 Tabelle  
Questa combo box permette di definire il criterio di dipendenza per la ricerca delle tabelle da 
visualizzare nella treeview . Le scelte possibili sono:  
 Che dipendono da: per ricercare l'elenco delle tabelle che dipendono da quella selezionata n el 
campo successivo. Le tabelle dipendenti sono quelle nelle quali non può essere inserito un 
valore in un determinato campo se questo non è presente sulla tabella dalla quale dipendono.  
 Da cui dipende: per ricercare l'elenco delle tabelle dalle quali di pende quella selezionata nel 
campo successivo. Queste tabelle sono quelle che devono contenere tutti i valori che possono 
essere inseriti in determinati campi della tabella selezionata nel campo successivo.  
 Tabella  
Codice della tabella per la quale si in tendono controllare le relazioni con le altre tabelle.  
  
I bottoni Ricerca, Esplodi ed Implodi consentono rispettivamente di lanciare la ricerca delle tabelle 
collegate, di esplodere la visualizzazione e di imploderla.  
 Relazione  
In questo campo viene rip ortata la relazione tra la tabella indicata nello specifico campo e quella 
selezionata nella treeview .  
Questa stringa può essere copiata negli Appunti mediante l'apposito bottone (puntini) collocato sulla 
destra, oppure selezionando la stringa e premendo l a combinazione di tasti CTRL+C.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  - V E N D I T E  F U N Z I O N I  A V A N Z A T E  
26 - I N T E G R A Z I O N E  E D I   Note aggiuntive  
Nella scheda note aggiuntive è possibile inserire/visualizzare una descrizione più esaustiva relativa 
all'entità selezionata.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – V E N D I T E  F U N Z I O N I  A V A N Z A T E  
I N T E G R A Z I O N E  E D I  - 27 Elementi  
  
Nell'archivio elementi l'utente potrà indicare tutti i Componenti di una determinata struttura EDI. 
L'elemento consente di specificare cosa deve essere scritto/letto in una specifica posizione del file.  
  
Ogni elemento dovrà far riferimento ad un determinato codice struttura. Quest'ultimo e il codice 
elemento sono campi Chiave della corrispondente tabella sul database.  
  
Il contenuto del file da generare/importare può essere determinato seguendo diverse strade. Le 
strutture possono essere esportate/importate da file DBF mediante apposita funzionalità.  
  
Partendo da una st ruttura già presente negli archivi dimostrativi, l'utente potrà procedere alla 
duplicazione e alla modifica degli elementi in base alle proprie esigenze.  
  
La gestione si presenta suddivisa su tre schede: la prima accoglie i dati generali dell’elemento rel ativi ad 
entrambe le sezioni “Export” ed “Import”, mentre gli altri dati sono stati distribuiti nelle altre schede 
in base al loro utilizzo.  
  
Elementi - Elemento  
  
 
Elementi - Elemento  
  
 Codice Struttura  
Codice della struttura EDI. Ogni elemento deve far riferimento ad una certa struttura EDI  
 Codice Elemento  
Rappresenta il codice dell’elemento di una struttura EDI. Trattandosi di un campo chiave non può 
essere ripetuto più volte. Sopra ttutto nelle strutture Edifact, gli elementi da esportare/importare nel 
file si ripetono in più sezioni dello stesso (ad esempio il segmento DTM per esprimere


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  - V E N D I T E  F U N Z I O N I  A V A N Z A T E  
28 - I N T E G R A Z I O N E  E D I  data/ora/periodo si ripete nei dati di testata, di riga e di piede più volte). In ogni caso il no me 
assegnato all’elemento rappresenta solo una codifica interna che non ha valenza per l’import/export.  
 Scelta numero  
Quando un elemento ha come padre un elemento di tipo scelta, deve essere inserito 
obbligatoriamente un valore numerico (da 1 a 999) in questo campo. Questo progressivo numerico 
verrà utilizzato per guidare la scelta da intraprendere. Al ver ificarsi di certe condizioni il programma 
saprà che si dovrà percorrere la strada 1; al verificarsi di altre condizioni saprà che si dovrà percorrere 
la strada 2, e così via.  
L’algoritmo che guida la scelta di uno dei figli è determinato dalla funzione ind icata sull’elemento di 
tipo Scelta. Tale funzione restituisce un valore compreso tra 1 e 999. In base al valore restituito, il 
programma procederà con l’esplosione dei figli con valore “scelta numero” corrispondente a quello 
restituito dalla funzione (escl udendo di conseguenza quelli con valore diverso).  
 Tipo  
Gli elementi associati ad una determinata struttura possono essere di diversa tipologia.  
In base al tipo si otterranno determinati effetti.  
Le scelte possibili sono:  
 Valore: gli elementi di tipo valore (oltre a quelli di tipo Espressione) rappresentano il punto di 
collegamento tra dato da esportare/importare e database. Gli elementi di tipo valore 
consentono di esportare un testo prefissato oppure il contenuto di un determinato campo. In 
caso di i mportazione di un file, questi elementi consentono di definire il campo del database in 
cui andare a scrivere.  
 Espressione: gli elementi di questo tipo sono simili a quelli di tipo “valore”, ovvero 
consentono di esportare stringhe o valori del database su file. La differenza sostanziale è


key: chroma:document
string_value:
consentono di esportare stringhe o valori del database su file. La differenza sostanziale è 
rappresentata dal fatto che il valore da esportare è il risultato di un’esp ressione Visual Fox Pro. 
Questi elementi sono estremamente utili laddove il valore di un campo del database deve essere 
elaborato oppure quando è necessario condizionare l’origine del dato in base al valore di altri 
campi. Ad esempio: 
IIF(DOC_MAST.MVFLVEAC ='A',DOC_MAST.MVDATREG,DOC_MAST.MVDATDOC
)  
 Variabile: gli elementi di questo tipo sono elementi di raggruppamento con formato variabile. 
Si tratta di elementi con funzione di contenitore e che faranno da “padre” ad altri elementi.  
 Fisso: gli elementi di questo tipo, come quelli di tipo variabil e, fungono da contenitore di altri 
elementi. A differenza dei precedenti, presentano un formato fisso. Il formato che viene 
utilizzato per questi elementi è quello definito nella struttura. In genere il formato di questa 
tipologia di elmenti avrà solo lo s copo di effettuare l’esplosione del nodo della struttura.  
 Reiterabile: gli elementi reiterabili sono necessari per poter esportare su file o poter leggere 
dal file le righe di un documento o il dettaglio delle rate. In sostanza, tutti gli elementi che fanno 
riferimento alla riga di un documento dovranno essere legati (ovvero dovranno avere come 
padre) un elemento di tipo reiterabile. In questo modo il programma cicla più volte su una parte 
della struttura scrivendo/leggendo sul/dal file tutte le righe del documento oppure tutto il 
dettaglio delle scadenze.  
  
Gli elementi di tipo reiterabile devono avere un formato che preveda solo l’esplosione dei figli (una sola riga nel 
dettaglio del formato), devono essere elementi di raggruppamento (avranno dei “figli”) e per essi deve essere indicata 
sempre la tabella sulla quale ciclare (ad esempio DOC_DETT per le righe del documento)


key: chroma:document
string_value:
sempre la tabella sulla quale ciclare (ad esempio DOC_DETT per le righe del documento)  
  
Apertura/Chiusura File: gli elementi identificati come “ Apertura File” sono relativi alle righe del 
file che non devono essere ripetute nel caso di generazione massiva relativa a più document i. Sia


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – V E N D I T E  F U N Z I O N I  A V A N Z A T E  
I N T E G R A Z I O N E  E D I  - 29 negli standard  Edifact che in quelli XML, sono sempre presenti delle informazioni di testata che 
non sono relative ad un determinato documento, ma semplicemente al messaggio EDI (file) 
genericamente inteso. Nel caso di esportazione su un unico file di più documenti, gli elementi 
identificati come “ Apertura file” non verranno ripetuti per ogni documento, ma saranno inseriti 
una volta soltanto. Stessa cosa vale per gli elementi di tipo “Chiusura File”; l’unica differenza è 
che avranno ad oggetto i segm enti di chiusura di un messaggio EDI (file).  
  
Gli elementi di tipo “ Apertura File” e “Chiusura File” devono essere inseriti solo come “figli” dell’elemento radice e 
non come “figli”di altri elementi.  
Inoltre tali elementi non devono avere figli se quest’ ultimi devono essere considerati ai fini dell’importazione.  
E’ per questo motivo, ad esempio, che nella struttura degli archivi dimostrativi ‘XML_DES96’ l’elemento 
“EDIFACT” non è stato inserito come padre asso luto di tutti gli elementi, ma semplicemente come elemento di 
“ Apertura file” senza alcun figlio, anche se da file XML risulterebbe come radice di tutti i Tag.  
  
Apertura/Chiusura: gli elementi di “ Apertura” sono quelli che contraddistinguono l’inizio di una 
specifica sezione del messaggio. Ogni sezi one del messaggio, per quanto riguarda l’entità 
documenti, rappresenterà un documento del gestionale. Gli elementi di “Chiusura” non 
vengono utilizzati in fase di export/import: consentono solo di identificare visivamente 
(treeview) l’ultimo elemento relat ivo ad un documento.  
  
Gli elementi di tipo “ Apertura” hanno lo scopo fondamentale di identificare l’inizio di un documento facendo 
“capire” al programma quando deve essere azzerato l’array degli “utilizzi”, ovvero della tabella sulla quale il


key: chroma:document
string_value:
programma ma rca come utilizzati gli elementi della struttura man mano che vengono associati ai Tag del file Xml 
(vedere parte relativa all’importazione files EDI per un approfondimento in merito).  
  
 Scelta: al fine di poter gestire tutte le casistiche in cui è richi esta una valutazione da parte della 
procedura di Export/Import files EDI in base alla quale intraprendere strade diverse disponibili 
all’interno di una struttura EDI, è possibile definire degli elementi di tipo “Scelta”. Un elemento 
di questo tipo ha la ca ratteristica fondamentale di avere come “figli” due o più elementi (che 
potranno rappresentare il nodo di partenza per ulteriori ramificazioni) contraddistinti ciascuno 
da un progressivo numerico da indicare in uno specifico campo. Per questa tipologia di elementi 
è necessario specificare il nome della funzione da utilizzare per guidare la scelta (nelle sezioni 
import/export).  
 Padre  
Rappresenta il legame di un determinato elemento con un altro. Attraverso i legami di ogni elemento 
viene definita di fatto una struttura ad albero. Ad esempio tutti i dati di riga di un documento 
potrebbero essere legati ad un elemento di raggruppamento.  
 Formato  
Il formato consente di definire in che modo devono essere utilizzati i valori determinati dagli altri 
parametri pr esenti sull’archivio elementi (vedere oltre per una definizione di formato).  
 Lunghezza  
La definizione di una lunghezza diversa rispetto a quella di un campo standard o al risultato di una


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  - V E N D I T E  F U N Z I O N I  A V A N Z A T E  
30 - I N T E G R A Z I O N E  E D I  espressione non ha solo lo scopo di gestire un’eventuale troncamen to del dato, ma anche quello di 
aumentare la lunghezza normale dello stesso.  
Specificando una lunghezza superiore a quella di un campo o del risultato di un'espressione o della 
stringa descrittiva (Txt descrittivo) e solo in mancanza di un comportamento di verso definito 
dall’utente (vedere check “Fill”), il programma effettua automaticamente le seguenti operazioni:  
 Riempimento con spazi a SX per i valori numerici  
 Riempimento con blank (spazi) per i valori carattere/memo a DX  
  
Nella lunghezza sono computati anche eventuali separatori definiti sulla “maschera” (ad esempio la barra “/” 
come separatore tra giorno, m ese e anno nelle date oppure il punto o la virgola come separatore tra parte intera e 
decimale nei numerici.  
La lunghezza è relativa al valore già sottoposto ad eventuale trascodifica e non al valore originario risultante dal 
campo o dalla valutazione di u n’espressione.  
L'operazione di riempimento viene effettuata solo dopo aver applicato eventuali trascodifiche.  
  
 ID primario/secondario  
Si tratta di campi che consentono di inserire una stringa lunga fino a 50 caratteri. Lo scopo principale 
di questi campi è quello di consentire la definizione dell’inizio dei segmenti dei messaggi EDI. Nel 
caso di file Edifact il c ampo ID primario dovrà contenere il nome del segmento (UNH, BGM, DTM, 
ecc. ecc.). Nel caso di file XML il campo ID primario dovrà contenere il nome del tag mentre l’ID 
secondario potrà contenere un’eventuale “namespace” previsto dallo schema XSD per la val idazione 
del file.  
L’utilizzo di questi campi è strettamente legato al formato associato all’elemento, ovvero, l’inserimento 
di queste informazioni avrà senso solo prevedendone l’utilizzo sul formato.


key: chroma:document
string_value:
di queste informazioni avrà senso solo prevedendone l’utilizzo sul formato.  
Sulle strutture abilitate all’import, per ogni elemento  con Id primario valorizzato, è necessario indicare 
la tabella di destinazione (campo tabella della sezione import), l’ordine assoluto e se si tratta di un 
elemento di rottura  
 Trascodifiche  
visibile con stato Interroga, se l’elemento prevede almeno un ti po di trascodifica nella scheda import 
o nella scheda export  
 Elemento rottura  
Questo check è essenziale (al pari dell’ordinamento e d ella tabella di destinazione), per poter eseguire 
l’importazione di file EDI. Il check deve essere attivato sugli elemen ti di rottura, ovvero, facendo 
riferimento alla casistica dei documenti, su quelli che segnano l’inizio dei dati di testata, l’inizio dei dati 
di riga, l’inizio del dettaglio matricole e l’inizio delle rate documento. Più precisamente, questa 
informazione viene utilizzata per l’aggiornamento dei progressivi: durante l’import, ad ogni 
occorrenza di un elemento di rottura, il programma porta avanti il progressivo (documento, riga 
documento, riga matricola o riga rata scadenza), perché quell’elemento segna l’i nizio di un nuovo 
documento, di una nuova riga documento, di una nuova riga matricola o di una nuova riga rata 
scadenza.  
L’elemento di rottura svolge anche un’altra importante funzione: man mano che gli elementi della 
struttura vengono utilizzati in impor tazione, ovvero vengono associati ai segmenti presenti su un file 
Edifact o ai Tag di un file Xml, il programma li “marca” per evitare che segmenti o Tag successivi 
facciano capo ad elementi già utilizzati. Quando il programma, durante l’elaborazione, “inc ontra” un 
elemento di rottura, vengono azzerati gli utilizzi per un determinato contesto, in modo tale che


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – V E N D I T E  F U N Z I O N I  A V A N Z A T E  
I N T E G R A Z I O N E  E D I  - 31 determinati elementi ritornino disponibili per l’utilizzo; ad esempio, l’utilizzo degli elementi relativi al 
dettaglio del documento dovrà essere azz erato ogni volta che nel file viene rintracciato un segmento o 
Tag che segna l’inizio di una riga documento ovvero un elemento di rottura.  
 Ordine assoluto  
Il campo ordine assoluto è editabile solo per gli elementi con ID primario valorizzato: ha lo scopo 
esclusivo di fornire alla procedura l’informazione dell’ordinamento dei segmenti su un files in 
standard Edifact o dei tag foglia su un fi le Xml . Questo campo è di importanza fondamentale: senza 
questa informazione il programma non saprebbe distinguere “a chi fa capo” un determinato tag del 
file XML generato dalla procedura (nel caso in cui quest’ultimo fosse ripetuto “n” volte all’interno del 
file). Ad esempio, in un file Edifact conforme alla directory 96A, il segmento “MOA ” viene utilizzato 
per esprimere tutti gli importi; ogni importo farà capo ad un determinato campo della procedura 
(prezzo unitario, spese trasporto, spese imballo, rata  documento, ecc. ecc.). Stabilendo semplicemente 
la sequenza sugli elementi della struttura, il programma ha tutte le informazioni per scrivere nei campi 
corretti.  
  
Edifact e Lunghezza fissa: il campo ordine della sezione import deve essere valorizzato su  tutti gli elementi che 
corrispondono all’inizio di un segmento del file, ovvero su tutti gli elementi con formato il cui dettaglio presenta una 
riga con check segmento attivato.  
Xml: il campo ordine della sezione import deve essere valorizzato su tutti gl i elementi foglia che corrispondono a tag 
Xml contenenti informazioni da scrivere sul database del gestionale. L’informazione è indispensabile solo se sulla 
struttura EDI sono presenti elementi con stesso Id primario che fanno campo alla stessa tabella di destinazione!


key: chroma:document
string_value:
 TXT descrittivo  
L’utilizzo di questo campo può essere considerato analogo a quello di ID primario/secondario, 
tuttavia, in questo caso, lo scopo principale non è quello di indicare l’identificativo di un un segmento 
del file, ma bensì quello di esportare  sul file delle stringhe fisse (magari previste da un determinato 
standard) con lunghezza compresa tra 1 e 254 caratteri.  
 Maschera Campo  
Il campo maschera è rimasto nei dati generali dell’elemento e non è stato sdoppiato, tuttavia ha 
importanza sia per l ’export che per l’import. In export permette di definire come scrivere il dato, in 
import è indispensabile per la corretta interpretazione del dato. E' essenziale per le date, ma, 
soprattutto, per i valori numerici perché permette di distinguere la parte i ntera da quella decimale. 
Indipendentemente dal tipo di struttura (Edifact, Lunghezza fissa, ecc.), è essenziale rappresentare la 
maschera dei numerici come una sequenza di 9 il cui numero, prima e dopo il carattere ".", 
rappresenta, rispettivamente, la lu nghezza della parte intera e della parte decimale. Ovviamente il 
programma deve tener conto anche della lunghezza impostata sull'elemento e delle eventuali 
parametrizzazioni in merito al segno, all'allineamento ed al "filling". Nel caso in cui la lunghezza  
definita sull'elemento sia inferiore alla lunghezza del dato da scrivere sul file (per via del separatore 
oppure del segno) il programma tronca il dato nel seguente modo:  
 - Se l'allineamento è a DX allora il dato viene troncato a SX (preservando il segno).  
 - Se l'allineamento è a SX allora il dato viene troncato a DX.  
  
Nota bene:  
Si ricorda che l'allineamento predefinito per i numerici è a DX. Ad esempio, nel caso di un elemento 
con lunghezza “15”, maschera “9999999999.99999” e dato numerico da riportare sul file 
“1234567890,12345”, avremo:


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  - V E N D I T E  F U N Z I O N I  A V A N Z A T E  
32 - I N T E G R A Z I O N E  E D I   Separatore ",", Allineamento a DX, Segno + con Evidenzia + --> +34567890,12345.  
 Separatore ",", Allineamento a SX, Segno + con  Evidenzia + --> +1234567890,123.  
 Separatore ",", Allineamento a DX, Segno + --> 234567890,12345.  
 Separatore ",", Allineamento a SX, Segno + --> 1234567890,1234.  
 Separatore "Nessuno", Allineamento a DX, Segno + con Evidenzia + --> 
+23456789012345.  
 Separatore "Nessuno", Allineamento a SX, Segno + con Evidenzia + --> +12345678901234.  
 Separatore "Nessuno", Allineamento a DX, Segno + --> 123456789012345.  
 Separatore "Nessuno", Allineamento a SX, Segno + --> 123456789012345.  
  
Per le strutture che pre vedono l'utilizzo di un separatore per distinguere parte intera da parte decimale sui 
numerici(ad esempio Edifact) occorre considerare anche il separatore stesso nella lunghezza espressa sull'elemento 
oltre all'eventuale segno che, come sottolineato negli esempi precedenti, occupa la prima posizione della lunghezza 
totale del dato.  
  
Elementi - Export  
  
 
Elementi - Export  
  
 Tabella  
In questo campo può essere indicata una delle tabelle definite sull’entità associata alla struttura. La 
tabella può/deve essere indicata per gli elementi di tipo valore, espressione, reiterabili o, in caso di 
strutture Edifact, sugli elementi che  determinano l’inizio di un segmento (per la sezione Import). A 
seconda dei casi l’indicazione di una determinata tabella avrà un determinato scopo:  
nel caso di elemento reiterabile, ha lo scopo di determinare la tabella sulla quale il programma deve 
ciclare (ad esempio, DOC_DETT, per scrivere sul file ogni riga del documento;  
nel caso di elemento valore rappresenta la tabella di riferimento per l’import e/o per l’export;


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – V E N D I T E  F U N Z I O N I  A V A N Z A T E  
I N T E G R A Z I O N E  E D I  - 33 nel caso di elemento espressione rappresenta la tabella di riferimento per eventuali t rascodifiche da 
applicare in esportazione e/o per l’import da file. In caso di esportazione il programma valuta solo 
l’espressione. Tuttavia il valore risultante dall’espressione può essere trascodificato compilando 
opportunamente il corrispondente archivi o. Il legame tra elemento espressione e trascodifica avviene 
in base a quanto indicato in “Tabella” e “Campo”.  
Al fine di poter effettuare correttamente l’importazione di un file, è necessario specificare oltre 
all’ordinamento degli elementi anche la tabel la oggetto di destinazione. La tabella di destinazione deve 
essere indicata sugli elementi con Id Primario valorizzato (i figli di questo elemento o lui stesso, 
conterranno valori da scrivere in tale tabella). In questo modo il programma riesce a gestire i n modo 
corretto gli “utilizzi” degli elementi (vedere sezione Importazione Files EDI per un approfondimento 
in merito).  
 Campo  
Accoglierà il campo di riferimento della tabella indicata precedentemente, in genere per la 
lettura/scrittura del dato dal/sul file, oppure per la creazione di un legame tra elemento espressione e 
trascodifica.  
  
Per gli elementi reiterabili non si  deve (non si può) compilare questo campo.  
  
 Tipo campo/espr  
Questa combo box è editabile solo per gli elementi di tipo espressione, altrimenti viene 
predeterminata dalle caratteristiche del campo selezionato. Ovviamente consente di stabilire la 
tipologi a del dato che può essere: numerico, data, carattere o memo.  
 Allineamento  
L’allineamento dei dati può essere modificato rispetto all’impostazione predefinita per tutte le 
tipologie di campo ad esclusione di quelli “data”. Se non viene definito un allinea mento specifico (e


key: chroma:document
string_value:
nessun riempimento particolare, Fill) il programma adotta i seguenti criteri:  
quando il dato è numerico  
 Allineamento --> DX  
 Riempimento --> blank (a SX)  
  
quando il dato è carattere/memo:  
 Allineamento --> SX  
 Riempimento --> blan k (a DX)  
 Fill 
Il check Fill può essere attivato solo dopo aver definito un allineamento diverso da “Nessuno”. Ha lo 
scopo di consentire il riempimento (a SX o DX del dato) con carattere blank oppure con un carattere 
definito nel campo accanto. Tipico uti lizzo è quello relativo ai dati numerici, solitamente allineati a DX 
e riempiti con zeri a SX (tracciati con record  a lunghezza fissa).  
  
Il carattere di riempimento deve anche essere indicato nella sezione “Import” per consentire al programma di 
interpret are in modo corretto il record presente sul file. Tecnicamente il programma esclude dall’informazione la 
parte di stringa corrispondente al carattere di riempimento a SX o a DX in base all’impostazione della combo box 
allineamento.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  - V E N D I T E  F U N Z I O N I  A V A N Z A T E  
34 - I N T E G R A Z I O N E  E D I    
 Tipo Trascodifica  
Per i valori che risultano da un database, da un’espressione o che vengono direttamente letti dal file, è 
possibile stabilire una trascodifica. Questa può essere approntata seconde diverse modalità.  
In particolare, può essere:  
 Non Ge stita: quando il dato non deve essere trascodificato;  
 Da Intestatario: quando i valori da trascodificare sono definiti in base all’intesta tario del 
documento (è necessario caricare una tabella di trascodifica nell’archivio corrispondente). 
Definendo ques ta tipologia, tornando sull’elemento in modalità “Interroga”, sarà possibile 
procedere al caricamento della tabella di trascodifica mediante l’apposito bottone;  
 Da Struttura: quando i valori da trascodificare sono definiti in base alla struttura EDI 
utilizzata e quindi indipendentemente dall’intestatario del documento (è necessario caricare una 
tabella di trascodifica nell’archivio corrispondente). Definendo questa tipologia, tornando 
sull’elemento in modalità “Interroga”, sarà possibile procedere al cari camento della tabella di 
trascodifica mediante l’apposito bottone;  
 Da routine: quando il dato deve essere trascodificato da una routine (batch) presente nel 
gestionale standard oppure predisposta dal rivenditore del gestionale. Ad esempio, la 
trascodifica dei codici articolo può avvenire automaticamente utilizzando la r outine standard 
GSVA_BKE. La routine da utilizzare potrà essere indicata nello specifico campo che diviene 
editabile solo per questa tipologia.  
  
Parametri della Routine GSVA_BKE:  
Questa routine ha lo scopo di facilitare la trascodifica dei codici di ricer ca relativi agli articoli. 
Parametrizzando in modo opportuno questa funzione sarà possibile esportare un determinato 
codice di ricerca. Tuttavia, può anche essere utilizzato senza parametri: in questo caso il


key: chroma:document
string_value:
codice di ricerca. Tuttavia, può anche essere utilizzato senza parametri: in questo caso il 
programma andrà a ricercare il codice di ricerc a dell’intestatario (se è prevista l’applicazione della 
“codifica cliente/fornitore” in base all’omonimo check nella corrispondente anagrafica).  
  
Parametri  
Fisso:                 NULL.  
Provenienza:     C(1) 
Tipologia:           C(1) NB:  Provenienza =A o R 
  
Possibili Valori Provenienza:  
R:                      Interna  
C:                      Cliente NB: ne può esistere solo uno valido alla data documento  
F:                      Fornitore NB: ne può esistere solo uno valido alla data documento  
A:                      Interna Codice di ricerca principale, ovvero quello con codice uguale al codice 
articolo  
I:                       Imballo Codice di ricerca imballo (tiene conto anche dell’eventuale Collo 
specificato sulla riga documento)  
  
Possibili Valori Tip ologia quando la provenienza è R:  
0:                       No 
1:                       EAN 8  
2:                       EAN 13  
3:                       ALFA 39  
4:                       UPC A  
5:                       UPC E  
6:                       2D5 
7:                       2D5 interleave  
8:                       Farmaceutico


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – V E N D I T E  F U N Z I O N I  A V A N Z A T E  
I N T E G R A Z I O N E  E D I  - 35 9:                       198 
A:                       EAN 13 peso variabile  
B:                       EAN 13 peso var. + digit  
C:                       EAN / UCC 14  
  
Possibili Valori Ti pologia quando la provenienza è A:  
F:                       Per ricercare il codice di ricerca da inserire sul documento in base all’intestatario 
di tipo fornitore  
C:                       Per ricercare il codice di ricerca da inserire sul documento in bas e 
all’intestatario di tipo cliente  
  
Esempi  
GSVA_BKE                                    Restituisce il codice di ricerca dell’intestatario (l’unico valido, 
se attiva codifica Cliente/Forn.)  
GSVA_BKE(.NULL.,'R','2')             Restituisce il codice di rice rca interno di tipo EAN 13  
GSVA_BKE(.NULL.,'C')                  Restituisce il codice di ricerca del Cliente (l’unico valido, se 
attiva codifica Cliente)  
GSVA_BKE(.NULL.,'F')                  Restituisce il codice di ricerca del Fornitore (l’unico valido,  
se attiva codifica Fornitore)  
GSVA_BKE(.NULL.,'A')                  Restituisce il codice di ricerca principale dell’articolo  
GSVA_BKE(.NULL.,'I')                   Restituisce il codice di ricerca di tipo imballo (in questo 
caso viene considerato quello definito per il collo indicato sulla riga del documento; solo se il 
collo non è stato specificato, viene considerato il codice di ricerca di tipo imballo generico)  
GSVA_BKE(.NULL.,’A ’,’F’)             Per ricercare il codice di ricerca da inserire sul docu mento 
in base all’intestatario di tipo fornitore.  
GSVA_BKE(.NULL.,’A ’,’C’)            Per ricercare il codice di ricerca da inserire sul documento 
in base all’intestatario di tipo cliente.  
 Condizione  
In questo campo è possibile inserire una funzione che restituisca come valore Vero o Falso (.T. o .F .).


key: chroma:document
string_value:
Se la funzione inserita restituisce il valore “.T.” allora l’elemento (e tutti i suoi eventuali “figli”) viene 
considerato, altrimenti no. Questo campo risulta molto utile nel caso in cui determinati segmen ti non 
debbano essere nemmeno esportati in mancanza di valori significativi.  
 Filtro su tabella  
Questo campo è editabile solo per gli elementi di tipo reiterabile. E’ necessario per poter filtrare un 
sottoinsieme di record  presenti sulla tabella reiterabile. Ad esempio, la tabella MOVIMATR 
(movimenti matricole) è legata a DOC_DETT  (righe documento); per individuare le matricole 
relative ad una certa riga della tabella DOC_DETT è necessario specificare un filtro. Nell’elemento 
reiterabile relativo a MOVIMATR dovrà essere indicato il seguente filtro:  
  
DOC_DETT.MVSERIAL=MOVIMATR.MTSE RIAL AND  
DOC_DETT.CPROWNUM=MOVIMATR.MTROWNUM AND  
DOC_DETT.MVNUMRIF=MOVIMATR.MTNUMRIF  
  
Il filtro rappresenta il legame tra DOC_DETT e MOVIMATR ed ovviamente consente di filtrare 
solo le matricole relative ad una certa riga del documento.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  - V E N D I T E  F U N Z I O N I  A V A N Z A T E  
36 - I N T E G R A Z I O N E  E D I  In fase di imp ortazione, il campo filtro su tabella non viene considerato. Il programma si aspetta che sul file il 
dettaglio matricole sia esploso immediatamente dopo ogni riga documento: in questo modo sa come valorizzare i 
campi chiave per stabilire il legame con ques ta. 
  
 Espressione  
Questo campo è editabile solo per gli elementi di tipo espressione. Consente di definire l’espressione 
Visual Fox Pro da utilizzare per estrapolare il valore dell’elemento. Lo stesso campo può essere 
utilizzato per lanciare funzioni standard di ad hoc (ad esempio GETCAM, per calcolare il cambio da 
utilizzare sui documenti in valuta) o per ottenere  il valore di variabili globali (ad esempio i_CODAZI 
per il codice azienda o i_DATSYS per la data di sistema).  
Per rendere più agevole la predisposiz ione di alcuni elementi, in questo campo possono essere 
utilizzati specifici oggetti creati appositamente. Si tratta di Funzioni oppure di Statement . Questi ultimi 
sono oggetti che vengono letti in un determinato istante dell’elaborazione e che possono var iare 
durante la stessa.  
  
FUNZIONI  
  
DataXml  
Funzione per la conversione delle Date dal/al formato XML IsoDate e/o Iso DateTime  
  
Parametri  
Data                                          D(8) 
Ora                                            N(2)  (se non indi cato 00)  
Min                                            N(2)  (se non indicato 00)  
Sec                                            N(2)  (se non indicato 00)  
Separa                                      C(1) (se non indicato -) [separatore]  
  
Se la data pass ata è di tipo DateTime la funzione estrapola i parametri ore, minuti e secondi 
dalla stessa  
  
Formato restituito  
Es: 2006 -09-05T28:00:00  
  
Esempi  
DATAXML(DATE(),HOUR(DATETIME()),MINU(DATETIME()),00,' -') 
  restituisce 
data/ora di creazione del file


key: chroma:document
string_value:
restituisce 
data/ora di creazione del file  
DATAXML( DOC_MAST.MVDATDOC,HOUR(DOC_MAST.MVDATDOC),MINU(DOC
_MAST.MVDATDOC),00,' -') 
 restituisce data/ora del documento per il quale si sta generando 
il file EDI  
  
Pivaeocodfis  
Funzione per applicare Codice Fiscale e/o Partita Iva azienda  
  
Parametri  
Codazi                                        C(5) 
Tipo                                            C(1) 
  
Formato restituito  
codice 16


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – V E N D I T E  F U N Z I O N I  A V A N Z A T E  
I N T E G R A Z I O N E  E D I  - 37   
Possibili Valori Tipo  
F                                                 Codice Fiscale  
P                                                 Partita IVA  
N                                                 Partita IVA (se valorizzata) altrimenti Codice Fiscale  
  
Esempio:  
PIVAEOCODFIS(i_CODAZI,'P')    Restituisce ila Partita IVA dell’azienda dalla quale si sta 
generando il file EDI  
  
Caltotdoc  
Esegue calcolo totali documento  
  
Parametri  
Seriale                                        C(10) (seriale documento)  
Tipo                                            C(1) 
  
Formato restituito  
Numerico (18,4)  
  
Possibili Valori Tipo  
I                                                  Imponibile documento  
A                                                 Imposta documento  
T                                                 Totale documento  
  
Esempio  
CALTOTDOC(DOC_MAST.MVSERIAL,'T')     Restituisce il totale gener ale del documento 
per il quale si sta generando il file EDI  
  
Countrows  
Consente di individuare il progressivo di riga da esportare (rappresenta il numero di righe 
effettivamente esportate). Ad esempio, se vengono escluse dall'export le righe descrittive, il 
progressivo del segmento LIN dei file Edifact, dovrebbe essere progressivo (senza buchi di 
numerazione). L’utilizzo del CPROWORD (oppure del CPROWNUM) di DOC_DETT non 
consente invece di soddisfare questo requisito.  
La funzione COUNTROWS è sostanzialment e un contatore delle righe esportate di una certa 
tabella di riferimento (ad esempio, di DOC_DETT, MOVIMATR,...). La tabella di riferimento è 
un parametro della funzione. Ad esempio, COUNTROWS(‘DOC_DETT’), restituisce il 
progressivo delle righe esportate d a DOC_DETT. Per ogni riga esportata il contatore si 
incrementa di 1: l’incremento del contatore avviene quando la procedura trova un elemento di


key: chroma:document
string_value:
incrementa di 1: l’incremento del contatore avviene quando la procedura trova un elemento di 
“rottura” (ad esempio il LIN dei file Edifact), con tabella export valorizzata e formato che 
contenga almeno un a riga con Check segmento attivo.  
  
Quindi, l’elemento di rottura fa incrementare il contatore, mentre, l’utilizzo dell’espressione 
COUNTROWS(DOC_DETT) fornirà il valore attuale del contatore, che sarà 1 per la prima 
riga esportata, 2 per la seconda riga e sportata e così via.  
Il contatore si azzera quando inizia una nuova reiterazione (ad esempio nuova riga documento).  
  
Parametri  
Tabella  
  
Esempio  
COUNTROWS(‘DOC_DETT’)                Restituisce il progressivo di righe esportate del


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  - V E N D I T E  F U N Z I O N I  A V A N Z A T E  
38 - I N T E G R A Z I O N E  E D I  dettaglio del documento  
  
Searchdoc  
Consente di ricavare riferimenti dei documenti di origine e di destinazione (numero, alfa e data) 
e di sta bilire se i riferimenti a tali documenti sono presenti. E’ molto utile nel caso in cui il file 
richiesto dalla controparte debba contene re (per determinate righe) i riferimenti ai documenti di 
origine.  
  
Parametri  
Seriale documento (DOC_DETT.MVSERIAL)  
Cprownum (DOC_DETT.CPROWNUM)  
Classe documento ('OR' per gli ordini, 'DT' per i documenti di trasporto, ecc.)  
Tabella (‘DOC_MAST’)  
Campo (‘MV NUMDOC’)  
  
In base alla specificazione o meno del quarto e quinto parametro, la funzione può restituire 
anche un valore booleano (.T./.F.) e quindi può essere utilizzata nel campo "Condizione" degli 
elementi.  
  
Nel caso in cui il dato da leggere non fosse  presente, la funzione SEARCHDOC restituisce 
come valore 0 (zero) oppure ' ' (blank) a seconda del tipo di dato indicato sull’elemento: 
numerico, oppure carattere, data, memo  
  
Esempio  
SEARCHDOC(DOC_DETT.MVSERIAL,DOC_DETT.CPROWNUM,'DT') 
                 Restituisce .T. se la riga è stata originata o evasa da un documento di classe DT 
(documento di trasporto)  
SEARCHDOC(DOC_DETT.MVSERIAL,DOC_DETT.CPROWNUM,'OR') 
                Restituisce .T. se la riga è stata originata  o evasa da un documento di classe OR 
(ordine)  
SEARCHDOC(DOC_DETT.MVSERIAL,DOC_DETT.CPROWNUM,'FA') 
                Restituisce .T. se la riga è stata originata  o evasa da un documento di classe FA 
(fattura)  
SEARCHDOC(DOC_DETT.MVSERIAL,DOC_DETT.CPROWNUM,'NC') 
                Restituisce .T. se l a riga è stata originata  o evasa da un documento di classe NC (nota 
di credito)  
  
La ricerca della presenza di un documento di origine, per una certa riga del documento, avviene


key: chroma:document
string_value:
La ricerca della presenza di un documento di origine, per una certa riga del documento, avviene 
lungo tutto il flusso documentale, indipendentemente dalla tipologia del docum ento 
immediatamente precedente. In questo modo è possibile risalire anche agli ordini, anche se il 
documento che precede la fattura è un DT.  
  
Con l'indicazione del quarto e quinto parametro, la funzione SEARCHDOC restituisce il valore 
del campo del docume nto ricercato.  
  
Esempio  
SEARCHDOC(DOC_DETT.MVSERIAL,DOC_DETT.CPROWNUM,'DT','DOC_MAST','
MVNUMDOC')               Restituisce il numero del documento di trasporto dal quale deriva la 
riga che si sta esportando sul file EDI  
SEARCHDOC(DOC_DETT.MVSERIAL,DOC_D ETT.CPROWNUM,'OR','DOC_MAST','
MVDATDOC')               Restituisce la data dell'ordine dal quale deriva la riga che si sta 
esportando sul file EDI  
SEARCHDOC(DOC_DETT.MVSERIAL,DOC_DETT.CPROWNUM,'FA','DOC_MAST','


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – V E N D I T E  F U N Z I O N I  A V A N Z A T E  
I N T E G R A Z I O N E  E D I  - 39 MVNUMDOC')               Restituisce il numer o della fattura.  
SEARCHDOC(DOC_DETT.MVSERIAL,DOC_DETT.CPROWNUM,'NC','DOC_MAST','
MVNUMDOC')              Restituisce il numero della nota di credito.  
  
Matchrows  
Consente di stabilire se i riferimenti della riga che si sta esportando sono gli stessi dell'ul tima riga 
esportata. La funzione MATCHROWS è di tipo booleano (restituisce .T. o :F .) e quindi può 
essere utilizzata solo sul campo condizione degli elementi. Semplificando, tale funzione lancia 
due volte la SEARCHDOC, una volta per la riga corrente ed una  volta per la riga esportata alla 
reiterazione precedente, in modo tale da poter confrontare i valori di di un determinato campo 
della riga attuale con quella della già scritta sul file con l’ultima reiterazione.  
  
NB: La funzione COUNTROWS deve essere uti lizzata sempre nel caso in cui si intenda 
utilizzare la funzione MATCHROWS perché oltre al progressivo di riga viene memorizzato in 
un apposito "array" il cprownum dell'ultima riga elaborata: si tratta di un dato necessario per 
permettere alla procedura di  confrontare il valore di un campo relativo alla riga attuale rispetto a 
quello della riga elaborata alla reiterazione precedente (ad esempio, il tipico utilizzo è quello di 
fare il confronto di MVSERIAL del documento di origine della riga attuale rispetto  a quello 
della riga precedente).  
  
Parametri  
Seriale documento (DOC_DETT.MVSERIAL)  
Cprownum (DOC_DETT.CPROWNUM)  
Classe documento ('OR' per gli ordini, 'DT' per i documenti di trasporto, ecc.)  
Tabella (‘DOC_MAST’)  
Campo (‘MVNUMDOC’)  
  
Esempio  
MATCHROWS(DOC _DETT.MVSERIAL,DOC_DETT.CPROWNUM,'OR','DOC_MAST','
MVSERIAL')                Restituisce .T. se la riga che si sta esportando su file EDI è stata 
originata dallo stesso documento di tipologia “ordine” che ha originato l'ultima riga esportata.


key: chroma:document
string_value:
Nel campo co ndizione degli elementi è possibile utilizzare anche più funzioni di tipo booleano contestualmente.  
  
Esempio  
SEARCHDOC(DOC_DETT.MVSERIAL,DOC_DETT.CPROWNUM,'DT') AND  
NOT(MATCHROWS(DOC_DETT.MVSERIAL,DOC_DETT.CPROWNUM,'DT','DOC_D
ETT','MVSERIAL'))        In questo caso l’espressione si verifica (restituisce .T.), solo se esiste 
un documento di tipologia DT dal quale deriva la riga corrente (prima condizione vera) e, 
contestualmente, se l’ultima riga esportata sul file deriva da un DT diverso (seconda condizion e 
vera).  
  
Getalias  
Consente di restituire il valore dell’alias “VALORE” da una query eventualmente creata con 
uno specifico scopo dall’utente.  
  
Parametri  
Nome query  
Seriale documento  
Cprownum (eventuale)


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  - V E N D I T E  F U N Z I O N I  A V A N Z A T E  
40 - I N T E G R A Z I O N E  E D I  Oltre alla funzione, è stata resa disponibile un a query standard (da utilizzare come esempio per 
eventuali altre query che desidera predisporre l’utente). Nella fattispecie, la query standard, con 
nome GSVA_TRG.VQR assegna all’alias “VALORE” (l’unico alias che può essere utilizzato 
dalla funzione GETALI AS), il totale righe del documento al netto degli sconti.  
  
La query eventualmente predisposta dall'utente deve restituire sempre un solo risultato con alias V ALORE ed i 
filtri parametrici devono essere predisposti per contenere Seriale e Cprownum.  
  
Esemp io 
GETALIAS('GSVA_TRG.VQR',DOC_MAST.MVSERIAL) 
                                                Restituisce il totale righe del documento che si sta esportando su 
file EDI  
  
Searchindex  
Questa funzione restituisce determinati dati dell’indice documento di ti po “formato 
elettronico”. La funzione è parametrica ed è indispensabile per recuperare le informazioni 
necessarie al fine di produrre il file XML della “Fattura CBI”, in particolar modo, il tipo di 
codifica del file (PDFA,…) e il percorso del file da rappr esentare come stream di dati in base 64 
all’interno di uno specifico tag del file XML.  
  
Parametri  
Classe documentale (una di quelle utilizzate per l’archiviazione documentale)  
Tabella di riferimento (‘DOC_MAST’)  
Seriale documento (DOC_MAST.MVSERIAL)  
Tipo 
  
Possibili Valori Tipo  
1                                                 Seriale indice documento  
2                                                 Tipo codifica CBI  
3                                                 Percorso e nome del file  
  
Esempio  
SearchIndex('GESTFILE_DO','DOC_MAST',DOC_MAST.MVSERIAL,’2’) 
                      Restituisce il valore del campo IDCODCBI relative all’allegato di tipo “formato 
elettronico”  
  
Getparvat


key: chroma:document
string_value:
elettronico”  
  
Getparvat  
Questa funzione restituisce il valore di uno dei campi della tabella dei  codici Iva (VOCIIVA). 
Questo risultato è facilmente ottenibile utilizzando una funzione standard di Visual Fox Pro, 
ovvero, la “LOOKTAB”. Tuttavia, una funzione specifica risulta utile per la determinazione 
esatta del parametro da esportare, tenendo conto  che il codice Iva esplicitato sulla riga di un 
documento può non essere quello effettivamente applicato (è sufficiente pensare ai documento 
con codice Iva esente in testata, ad esempio, perché è applicabile una lettera di intento).  
  
Parametri  
Seriale doc umento  
Cprownum  
Nome campo (di VOCIIVA)  
Campo del documento contenente un codice Iva (eventuale)  
  
Il quarto parametro è opzionale e serve per ricavare il valore di un determinato campo


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – V E N D I T E  F U N Z I O N I  A V A N Z A T E  
I N T E G R A Z I O N E  E D I  - 41 dell'archivio VOCIIVA in relazione al codice IVA indicato in un determ inato campo del 
documento. In alternativa, può essere omesso ed, in questo caso, il programma sa che deve 
considerare il codice Iva della riga documento oppure, se ha aliquota inferiore, quello della 
testata documento.  
  
Esempio  
GETPARVAT(DOC_DETT.MVSERIAL ,DOC_DETT.CPROWNUM,'IVDATANA') 
                 Restituisce il valore del campo IVDATANA della tabella VOCIIVA per il codice IVA 
applicato effettivamente alla riga che si sta esportando sul file, che non è detto corrisponda al 
codice presente in DOC_DETT.M VCODIVA.  
GETPARVAT(DOC_MAST.MVSERIAL,0, 'IVPERIVA',NVL(DOC_MAST.MVACIVA1,'')) 
     Restituisce il valore del campo IVPERIVA della tabella VOCIIVA per il primo codice IVA 
presente sul castelletto del documento.  
  
STATEMENTS:  
  
Countsegm  
Esegue il calcolo de l numero dei segmenti esportati nel file. Quest’informazione è richiesta per 
lo standard Edifact e viene ricavata in base al numero di elementi utilizzati per la generazione 
del file che hanno un formato con tipologia “Id Primario” e check attivo su “Segme nto”.  
  
Countsect  
Esegue il calcolo del numero di sezioni (documenti) esportati nel file. Quest’informazione è 
richiesta per lo standard Edifact e viene ricavata in base al numero di el ementi di tipologia 
“ Apertura”  utilizzati per la generazione del file.  Si ricorda che ogni sezione/documento del file 
deve iniziare con un elemento di tipo “ Apertura” e deve chiudersi con un elemento di tipo 
“Chiusura”.  
  
Headerpers  
Riporta sul file il codice dell’intestatario del documento. E’ necessario utilizzare questo 
statement se si devono esportare delle informazioni sul file che sequenzialmente devono essere 
elaborate prima dell’elemento di apertura del documento (nello standard Edifact, l’elemento


key: chroma:document
string_value:
elaborate prima dell’elemento di apertura del documento (nello standard Edifact, l’elemento 
UNH). Per la determinazione dell’intestario il programma adotta un sis tema alternativo:  
se la generazione del file viene lanciata da Print System, l’intestatario è determinato dalle variabili 
che vengono passate alla Print System stessa.  
se la generazione avviene dalla gestione “Export documenti EDI”, l’intestatario è quello  inserito 
nell’apposito campo che funge anche da filtro di selezione.  
Lo statement Headerpers può essere utilizzato in espressioni con Looktab per ricavare altre 
informazioni (ad esempio, indirizzo, ragione sociale, ecc. ecc.) e può essere oggetto di 
trascodifica, legando quest’ultima all’elemento tramite valorizzazione di tabella/campo.  
  
Predi  
Questo statements può essere utilizzato per riportare sul file il progressivo di generazione dei 
files EDI. Restituisce un valore numerico di 14 cifre (con zero fil ling a sinistra). E’ univoco 
nell’ambito dell’esercizio e viene incrementato per ogni messaggio EDI generato (se in un file 
vengono esportati più documenti, il progressivo viene incrementato di 1). Il progressivo è 
memorizzato per azienda/esercizio ed è di sponibile all’interno della tabella dei progressivi 
(cpwarn) con campo chiave del tipo: prog \PREDI \'DEMO ' \'2006'.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  - V E N D I T E  F U N Z I O N I  A V A N Z A T E  
42 - I N T E G R A Z I O N E  E D I  Elementi – Import  
  
 
Elementi – Import  
  
 Funzione  
In questo campo può essere indicato il nome della funzione da utilizzare per gli elementi di tipologia 
scelta (vedere descrizione elemento di tipo scelta).  
 Campo  
Accoglierà il campo di riferimento della tabella indicata precedentemente, in ge nere per la 
lettura/scrittura del dato dal/sul file, oppure per la creazione di un legame tra elemento espressione e 
trascodifica.  
  
Per gli elementi reiterabili non si deve (non si può) compilare questo campo.  
  
 Variabile globale  
Questo check permette d i memorizzare il dato in ingresso su una variabile globale in modo tale che 
possa essere riutilizzato successivamente fino al termine dell’operazione di importazione tramite i 
valori predefiniti oppure tramite il campo espressione della sezione import. Il check è attivabile solo 
valorizzando tabella e campo della scheda “Import”. La sua attivazione fa si che durante la procedura 
di importazione venga assegnata una variabile globale con nome “g_NOMECAMPO”, ad esempio, 
nel caso si volesse memorizzare il codic e intestatario del documento (passato come dato nella sezione 
di apertura file) dovrà essere utilizzato un elemento con i seguenti dati nella sezione import:  
Tabella                   DOC_MAST.  
Campo                   MVCODCON.  
Var. Globale           Check  Attivo.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – V E N D I T E  F U N Z I O N I  A V A N Z A T E  
I N T E G R A Z I O N E  E D I  - 43   
La variabile globale generata sarà g_MVCODCON.  
  
Nel caso di utilizzo della variabile globale come valore predefinito, occorre specificare come campo di 
destinazione quello indicato sull’elemento utilizzato per memorizzare la stessa variabile gl obale.  
  
 
Variabile globale nei valori predefiniti  
  
Questo tipo di utilizzo è necessario quando alcuni dati vengono passati come dati di apertura file prima dell’inizio 
effettivo del documento: ad esempio, in un file contenente diversi documenti intestat i al solito soggetto può essere che il 
codice intestatario venga passato solo una volta nei dati di apertura del file prima della sequenza di righe relative ai 
singoli documenti.  
  
Nel caso di utilizzo della variabile globale all’interno di un’espressione in import, basterà richiamarla 
con la sintassi g_NOMECAMPO.  
Qualificatore  
Se un elemento viene definito come qualificatore, significa, che ha lo scopo di garantire la corretta 
associazione tra segmenti presenti sul file da importare ed elementi con Id prim ario della struttura 
EDI presente sul gestionale. L'elemento qualificatore di una struttura deve essere figlio di un altro 
elemento di tipo Variabile o Fisso e deve essere di tipo Valore.  
In fase di importazione il programma valuta ogni segmento del file, oltre che per Id primario ed 
ordinamento, anche per il valore di uno o più dei suoi figli (qualificatori). Quando i valori presenti sul 
file corrispondono esattamente al valore indicato sui corrispondenti elementi qualificatori di un 
determinato Tag della struttura, il matching dà esito positivo, altrimenti il segmento del file dovrà 
essere confrontato con il Tag successivo presente sulla struttura. Il Tag della struttura appena saltato 
risulterà come utilizzato per evitare l'eventuale associazione con altr i segmenti presenti sul file aventi


key: chroma:document
string_value:
stesso Id e stessi qualificatori.  
La combo box consente di specificare su quale campo dell'elemento è contenuto il valore qualificatore  
 Nessuno (default): significa che l’elemento della struttura non è un qualificatore ; 
 Id secondario: significa che l’elemento è un qualificatore ed il valore da confrontare è 
indicato sul campo Id secondario;  
 Cod. txt descr.: significa che l’elemento è un qualificatore ed il valore da confrontare è 
indicato sul campo Codice Txt descri ttivo.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  - V E N D I T E  F U N Z I O N I  A V A N Z A T E  
44 - I N T E G R A Z I O N E  E D I    
Questa combo box è utilizzabile solo per strutture EDI diverse dalla tipologia XML. Per questa tipologia di 
struttura non si presenta rischio di ambiguità tra i dati presenti sul file perché a parità di livello, ogni tag ha un 
nome univoco.  
  
 Posizione  
Definendo come qualificatore un certo elemento, si abilita automaticamente questo campo sul quale è 
necessario andare a specificare in che posizione del file si trova la stringa da confrontare con il valore 
inserito nel campo “Id secondario” o “Cod . txt descr.”. La logica di ricerca è diversa a seconda del 
tipo di struttura EDI:  
 Lunghezza Fissa: è necessario specificare l’esatta posizione del file (ad esempio, inserendo 
valore 63, il programma saprà che il qualificatore si trova alla posizione 63 della riga di 
riferimento e che ha lunghezza pari a quella definita sull’elemento);  
 Edifact: è necessario definire la cardinalità del dato, ovvero occorre specificare se il dato 
qualificatore è il 1°, 2°, 3°, ecc., “Data Element” del segmento. Ad esempio, per i segmenti 
DTM, l’elemento qualificatore potrebbe essere il 1° Data Element ( 137 per Data/Ora 
documento/messaggio, 138 per Date Pagamento, ecc. ecc.)  
  
Ad esempio, prendendo come riferimento la struttura degli archivi dimostrativi “EUR_INV96” 
(Standard Lunghezza Fissa), i qualificatori sono stati utilizzati per il trattamento degli  
sconti/maggiorazioni di piede e di riga. Nello specifico, considerando lo sconto/maggiorazione legato 
al pagamento (campo MVSCOPAG di DOC_MAST) si può notare che sono stati definiti due gruppi 
di elementi che hanno stesso Id primario (ALT_SCOPAG e ALT_MAG PAG).


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – V E N D I T E  F U N Z I O N I  A V A N Z A T E  
I N T E G R A Z I O N E  E D I  - 45 
 
Dettaglio esplosione Treeview  
  
Quando si tratta di generare il file Euritmo, il programma considera uno o l’altro gruppo di elementi a 
seconda della validità del campo condizione:  
 ALT_SCOPAG se DOC_MAST.MVSCOPAG < 0  
 ALT_MAGPAG se DOC_MAST.M VSCOPAG > 0  
 Né uno né l’altro se DOC_MAST.MVSCOPAG = 0  
  
Il primo figlio di questi elementi è un elemento qualificatore, ovvero il valore presente sul file 
immediatamente dopo il  Tag (alla quarta posizione) è l’indicatore che deve far capire se ciò che segue 
è uno sconto o una maggiorazione:  
 INDSCADD_SCOPAG ha nel campo Txt descrittivo il valore “ A ” perché nello standard 
Euritmo “ A ” identifica uno sconto  
  
 
Dettaglio identificazione sconto Euritmo  
  
 INDSCADD_MAGPAG ha nel campo Txt descrittivo il valore “C” perché nello standard 
Euritmo “C” identifica una maggiorazione


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  - V E N D I T E  F U N Z I O N I  A V A N Z A T E  
46 - I N T E G R A Z I O N E  E D I    
 
Dettaglio identificazione maggiorazione Euritmo  
  
In fase di import, il programma valuta quindi l’elemento o gli elementi definiti come qualificatori 
prima di associare una certa  riga del file (record) ad uno degli elementi Tag presenti sulla struttura (gli 
elementi Tag sono quelli con Id primario valorizzato). Gli elementi qualificatori possono essere anche 
più di uno. Ad esempio sconto o maggiorazione pagamento vengono associati  ad un determinato Tag 
della struttura non solo se corrisponde il qualificatore alla posizione 4 del record del file, ma deve 
esserci corrispondenza anche tra qualificatore alla posizione 45 del file ed elemento 
TIPOSCADD_XXXPAG.  
  
 
Dettaglio identificazi one sconto pagamento  
  
 Allineamento  
L’allineamento dei dati può essere modificato rispetto all’impostazione predefinita per tutte le 
tipologie di campo ad esclusione di quelli “data”. Se non viene definito un allineamento specifico (e 
nessun riempimento particolare, Fill) il p rogramma adotta i seguenti criteri:  
quando il dato è numerico  
 Allineamento --> DX  
 Riempimento --> blank (a SX)  
  
quando il dato è carattere/memo:  
 Allineamento --> SX  
 Riempimento --> blank (a DX)  
 Fill 
Il check Fill può essere attivato solo dopo a ver definito un allineamento diverso da “Nessuno”. Ha lo 
scopo di consentire il riempimento (a SX o DX del dato) con carattere blank oppure con un carattere 
definito nel campo accanto. Tipico utilizzo è quello relativo ai dati numerici, solitamente allinea ti a DX 
e riempiti con zeri a SX (tracciati con records a lunghezza fissa).  
  
Il carattere di riempimento deve anche essere indicato nella sezione “Import” per consentire al programma di 
interpretare in modo corretto il record presente sul file. Tecnicamen te il programma esclude dall’informazione la


key: chroma:document
string_value:
parte di stringa corrispondente al carattere di riempimento a SX o a DX in base all’impostazione della combo box 
allineamento.  
  
 Segno  
Segno dei campi di tipo numerico


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – V E N D I T E  F U N Z I O N I  A V A N Z A T E  
I N T E G R A Z I O N E  E D I  - 47  Tipo Trascodifica  
Per i valori che risu ltano da un database, da un’espressione o che vengono direttamente letti dal file, è 
possibile stabilire una trascodifica. Questa può essere approntata seconde diverse modalità.  
In particolare, può essere:  
 Non Gestita: quando il dato non deve essere tra scodificato;  
 Da Intestatario: quando i valori da trascodificare sono definiti in base all’intestario del 
documento (è necessario caricare una tabella di trascodifica nell’archivio corrispondente). 
Definendo questa tipologia, tornando sull’elemento in mod alità “Interroga”, sarà possibile 
procedere al caricamento della tabella di trascodifica mediante l’apposito bottone;  
 Da Struttura: quando i valori da trascodificare sono definiti in base alla struttura EDI 
utilizzata e quindi indipendentemente dall’inte statario del documento (è necessario caricare una 
tabella di trascodifica nell’archivio corrispondente). Definendo questa tipologia, tornando 
sull’elemento in modalità “Interroga”, sarà possibile procedere al caricamento della tabella di 
trascodifica media nte l’apposito bottone;  
 Da routine: quando il dato deve essere trascodificato da una routine (batch) presente nel 
gestionale standard oppure predisposta dal rivenditore del gestionale. Ad esempio, la 
trascodifica dei codici articolo può avvenire automaticamente utilizzando la r outine standard 
GSVA_BKE. La routine da utilizzare potrà essere indicata nello specifico campo che diviene 
editabile solo per questa tipologia.  
  
Parametri della Routine GSVA_BKE:  
Questa routine ha lo scopo di facilitare la trascodifica dei codici di ricer ca relativi agli articoli. 
Parametrizzando in modo opportuno questa funzione sarà possibile esportare un determinato 
codice di ricerca. Tuttavia, può anche essere utilizzato senza parametri: in questo caso il


key: chroma:document
string_value:
codice di ricerca. Tuttavia, può anche essere utilizzato senza parametri: in questo caso il 
programma andrà a ricercare il codice di ricerc a dell’intestatario (se è prevista l’applicazione della 
“codifica cliente/fornitore” in base all’omonimo check nella corrispondente anagrafica).  
  
Parametri  
Fisso:                 NULL.  
Provenienza:     C(1) 
Tipologia:           C(1) NB: Vale solo per i co dici di ricerca di tipo interno (Provenienza = ‘R’)  
  
Possibili Valori Provenienza:  
R:                      Interna  
C:                      Cliente NB: ne può esistere solo uno valido alla data documento  
F:                      Fornitore NB: ne può esister e solo uno valido alla data documento  
A:                      Interna Codice di ricerca principale, ovvero quello con codice uguale al codice 
articolo  
I:                       Imballo Codice di ricerca imballo (tiene conto anche dell’eventuale Collo 
specif icato sulla riga documento)  
  
Possibili Valori Tipologia:  
0:                       No 
1:                       EAN 8  
2:                       EAN 13  
3:                       ALFA 39  
4:                       UPC A  
5:                       UPC E  
6:                       2D5 
7:                       2D5 interleave  
8:                       Farmaceutico  
9:                       198 
A:                       EAN 13 peso variabile


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  - V E N D I T E  F U N Z I O N I  A V A N Z A T E  
48 - I N T E G R A Z I O N E  E D I  B:                       EAN 13 peso var. + digit  
C:                       EAN / UCC 14 
  
Esempi  
GSVA_BKE                                    Restituisce il codice di ricerca dell’intestatario (l’unico valido, 
se attiva codifica Cliente/Forn.)  
GSVA_BKE(.NULL.,'R','2')             Restituisce il codice di ricerca interno di tipo EAN 13  
GSVA_ BKE(.NULL.,'C')                  Restituisce il codice di ricerca del Cliente (l’unico valido, se 
attiva codifica Cliente)  
GSVA_BKE(.NULL.,'F')                  Restituisce il codice di ricerca del Fornitore (l’unico valido, 
se attiva codifica Fornitore)  
GSVA_BKE(.NULL.,'A')                  Restituisce il codice di ricerca principale dell’articolo  
GSVA_BKE(.NULL.,'I')                   Restituisce il codice di ricerca di tipo imballo (in questo 
caso viene considerato quello definito per il collo indicato s ulla riga del documento; solo se il 
collo non è stato specificato, viene considerato il codice di ricerca di tipo imballo generico)  
 Espressione  
Il campo espressione nella scheda import può essere utilizzato per “manipolare” il dato letto dal file 
oppure per compiere delle operazioni su qualsiasi dato memorizzato come variabile globale. Lo scopo 
è quello di scrivere il risultato dell’espressione nel campo di destinazione indicato sull’elemento.  
Per l’utilizzo di variabili globali è sufficiente seguire la s intassi g_NOMECAMPO. Per “manipolare” il 
dato corrispondente all’elemento sul quale è stata indicata l’espressione è possibile utilizzare la 
variabile EXPR, oppure, è possibile memorizzare il dato corrispondente all’elemento su una variabile 
globale e poi utilizzarla immediatamente nel campo espressione.  
  
Il tipo di dato risultante da un’espressione dipende esclusivamente dai dati utilizzati, così


key: chroma:document
string_value:
Il tipo di dato risultante da un’espressione dipende esclusivamente dai dati utilizzati, così 
un’espressione che effettua il prodotto di due variabili numeriche darà come risultato un dato 
numerico: per s crivere il risultato su un campo di tipo testo occorrerà applicare la funzione STR al 
valore numerico.  
  
Esempi:  
EXPR + 1 à aggiunge uno al valore letto dal file per i numerici, oppure un giorno se il campo di 
destinazione è data.  
EXPR + ‘ Testo di prova’ à Aggiunge una stringa fissa al valore (testuale) letto dal file.  
EXPR+' Quantità x Prezzo = '+ALLTRIM(STR(g_MVPREZZO*g_MVQTAMOV ,18,4)) à Alla 
stringa letta dal file (EXPR) aggiunge una stringa fissa (Quantità x Prezzo =) seguita dalla 
trasformazione in ca rattere del prodotto tra quantità e prezzo, mantenendo la lunghezza massima del 
dato (18), i decimali (4) ed applicando un’eliminazione spazi sul risultato.  
  
Nota bene: EXPR ha come tipo dato quello del campo di destinazione specificato sull’elemento. Ad esempio se il 
campo di riferimento è MVDESSUP (che è memo) allora la variabile EXPR è di tipo memo.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – V E N D I T E  F U N Z I O N I  A V A N Z A T E  
I N T E G R A Z I O N E  E D I  - 49 
 
Esempio di espressione su sezione Import


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  - V E N D I T E  F U N Z I O N I  A V A N Z A T E  
50 - I N T E G R A Z I O N E  E D I  Formati  
  
L'archivio dei formati, insieme a quello delle trascodifiche e degli  elementi, rappresenta un punto 
centrale per la definizione della struttura/contenuto del file da esportare/importare. Anche i formati, 
come gli elementi, devono essere legati ad una determinata struttura. Quindi, i formati utilizzabili su 
un determinato e lemento sono tutti quelli che hanno in comune il codice struttura.  
  
Il formato ha lo scopo di velocizzare il caricamento degli elementi che hanno alcune caratteristiche in 
comune. Ad esempio, gli elementi che determinano l'inizio riga di un file EDIFACT, avranno un 
formato che prevede l'inserimento del nome del tag a tre caratteri (bgm, dtm, rff) seguito dal 
separatore + e dall'esplosione dei Figli di quell'elemento (tag).  
  
 
Archivio Formati  
  
I formati assumono rilevanza soprattutto per quanto riguarda la fase di export: è il formato che stabilisce la 
collocazione di un valore all'interno di un segmento del file da generare. Per quanto riguarda il processo di 
importazione di un file EDI, il formato assume minor rilevanza perché il file viene interpretato  con metodologie 
particolari (diverse a seconda che si tratti di file Xml o Edifact) che prescindono dalla collocazione definita sul 
formato.  
  
 Codice Struttura  
E' la struttura EDI alla quale fa riferimento il formato richiamato in interrogazione o che si sta 
caricando/modificando.  
 Codice Formato/Descrizione  
Il codice del formato funge da campo chiave insieme a codice struttura e rappresenta i l punto di 
collegamento con l'archivio degli elementi. La descrizione del formato è libera e può esser lunga fino a 
30 caratteri.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – V E N D I T E  F U N Z I O N I  A V A N Z A T E  
I N T E G R A Z I O N E  E D I  - 51   
Dettaglio Formati  
Premesso che i formati hanno rilevanza soprattutto per la fase di export, è possibile affermare che nel 
dettaglio si deve definire la collocazione dei valori sul file da generare. Per quanto concerne la casistica 
dell'import, si vedrà che assume rilevanza solo il check Segmento, che dovrà essere attivato sulla riga 
del formato che determina l'inizio di un nuov o segmento.  
  
Un formato deve Passare una ed una sola informazione, al fine di evitare che un elemento della struttura EDI 
possa essere riferibile a più campi di destinazione. Ricordiamo che per ogni elemento è possibile definire solo un 
campo del database . Il formato non può essere predisposto in modo tale da Passare più informazioni (ad esempio 
Numero e Alfa documento), o meglio, sarebbe possibile per l'esportazione del file, ma non renderebbe lo stesso file 
interpretabile nel momento dell'import.  
  
 Riga  
Il numero di riga rappresenta la sequenza in cui verranno considerati i componenti del formato.  
 Tipo  
La combo box Tipo consente di determinare quale valore deve essere esportato e/o importato. 
L'elenco delle scelte possibili è strettamente legato a quanto viene definito su un elemento della 
struttura EDI ed alcune selezioni potranno avere senso o meno a seconda della tipologia di struttura: 
Xml, Edifact o Altro.  
 Stringa fissa: consente di inserire nel campo accanto una stringa da esportare nel fi le. Ad 
esempio, per quanto riguarda i formati relativi a strutture Edifact, tale tipologia potrebbe essere 
utilizzata per i separatori +: o per i fine riga (definita direttamente sul formato nel campo 
apposito)  
 ID primario: questa tipologia consente di e sportare sul file il contenuto del campo ID 
primario dell'elemento.  
 ID secondario: questa tipologia consente di esportare sul file il contenuto del campo ID


key: chroma:document
string_value:
 ID secondario: questa tipologia consente di esportare sul file il contenuto del campo ID 
secondario dell'elemento.  
 Cod. TXT descrittivo: questa tipologia consente di esportare sul file  il contenuto del campo 
TXT descrittivo dell'elemento.  
 Espressione: questa tipologia consente di esportare sul file il valore restituito dalla 
valutazione dell'espressione indicata sull'elemento, eventualmente sottoposto a trascodifica.  
 Valore sul DB: questa tipologia consente di esportare sul file il valore presente nel campo 
indicato sull'elemento, eventualmente sottoposto a trascodifica.  
 Esploso figli: questa tipologia consente di effettuare l'esplosione di tutti gli elementi che 
hanno come Padre q uello al quale viene associato il formato in oggetto.  
 Esploso figli elementi: questa tipologia ha senso solo per i formati utilizzati su strutture EDI 
per file Xml. La funzionalità è identica a quella prevista per la selezione Esploso Figli, ma 
consente di discriminare in base alla Modalità di comportamento definita sui singoli elementi. 
Nella fattispecie, verranno considerati nell'esplosione solo gli elementi figli con modalità 
Elemento.  
 Esploso figli attributi: questa tipologia ha senso solo per i for mati utilizzati su strutture EDI 
per file Xml. La funzionalità è identica a quella prevista per la selezione Esploso Figli, ma 
consente di discriminare in base alla Modalità di comportamento definita sui singoli elementi. 
Nella fattispecie, verranno consid erati nell'esplosione solo gli elementi figli con modalità 
Attributo.  
 Fine riga CR+LF permette di applicare al file di testo generato un fine riga di tipo Carriage


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  - V E N D I T E  F U N Z I O N I  A V A N Z A T E  
52 - I N T E G R A Z I O N E  E D I  return + Line Feed  
 Fine riga LF permette di applicare al file di testo generato un fine riga di tipo Line Feed  
 Indenta/Deindenta: queste opzioni consentono di gestire un'eventuale indentatura sul file da 
generare. Ovviamente hanno effetto solo in fase di export e saranno soprattutto utili per file di 
tipologia Xml (in ogni caso sono sempre utilizzabili). Le opzioni indenta/deindenta non fanno 
altro che far au mentare o diminuire un contatore interno che consente di determinare in ogni 
momento quanti spazi devono essere applicati all'inizio di una riga. Ad ogni occorrenza 
dell'opzione Indenta il programma incrementa il progressivo di 1. L'opzione deindenta ha 
l'effetto opposto (diminuisce di 1). Questo contatore, che varierà durante la generazione del file, 
viene moltiplicato per il numero di spazi inseriti in uno specifico campo dell'archivio strutture. Il 
valore risultante viene applicato all'inizio di ogni rig a del file (nb: l'inizio delle riga viene 
individuato dal fatto che il formato della riga precedente presenterà un fine riga).  
 Valore nel caso di tipo stringa fissa  
In questo campo è possibile inserire il valore da esportare sul file. Poter inserire una stringa 
direttamente sui formati può essere utile quando questa è caratteristica comune a diversi elementi. Ad 
esempio, per gli  elementi di una struttura Edifact risulta comodo inserire i separatori direttamente sui 
formati, per evitare di doverli specificare su ogni elemento. Nelle strutture Xml, l'inserimento di più 
stringhe fisse consente di definire la struttura di un Tag; ad esempio il formato di un elemento valore 
da esportare su un file Xml potrebbe essere costruito nel seguente modo:  
Stringa Fissa  < 
Id Primario  
Stringa Fissa  > 
Valore sul DB   
Stringa Fissa  </ 
Id Primario  
Stringa Fissa  > 
 Da - A


key: chroma:document
string_value:
Stringa Fissa  > 
Valore sul DB   
Stringa Fissa  </ 
Id Primario  
Stringa Fissa  > 
 Da - A 
I campi Da, A  valorizzabili per ogni riga del formato, consentono di considerare solo una parte del 
dato. Ad esempio, se si dovessero esportare sul file solo i primi tre caratteri del contenuto di un Valore 
presente sul database potrei valorizzare  questi campi, rispettivamente con 1 e 3.  
Nel caso dello standard Edifact risultano molto utili p er spezzare su più data element  (oggetti delle 
strutture Edifact) il contenuto di campi che superano i 35 o 70 caratteri (lung hezze tipiche dei data 
element delle strutture Edifact). Si potranno così definire formati che esportano da carattere 1 a 35, da 
36 a 70, da 71 a 105, ecc. ecc.  
  
L'utilizzo di questi campi consente di evitare l'eliminazione degli spazi vuoti (ALLTRIM) eventualmente presenti 
prima/dopo un a stringa fissa inserita dall'utente nei campi Id Primario/Secondario o nel TXT descrittivo 
dell'elemento o direttamente sul formato.  
Sui valori che risultano dal database o da un'espressione, il programma non effettua mai l'eliminazione degli spazi 
vuoti (eventualmente presenti prima e/o dopo il dato).  
  
 N. (Normalizzazione)  
Il check normalizzazione è attivabile solo per il dato che deriva da un'espressione o dal database. La 
sua funzione è quelle di evitare l'applicazione della normalizzazione prevista per la struttura EDI alla 
quale si riferisce il for mato (vedere oltre per una definizione di normalizzazione).


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – V E N D I T E  F U N Z I O N I  A V A N Z A T E  
I N T E G R A Z I O N E  E D I  - 53  Seg. (Segmento)  
Il check segmento ha rilevanza soprattutto per quanto riguarda l'interpretazione dei file in standard 
Edifact, ma viene utilizzato anche in fase di esportazione dei file di quest o tipo.  
Quando si parla di Segmento di un file Edifact, in genere si fa riferimento al contenuto di una riga 
dello stesso, costituita dal nome di un tag (3 caratteri) separatore + e dai valori dei suoi data elements 
separati da + o : a seconda della tipolo gia di data element . 
Il check in oggetto ha lo scopo essenziale di consentire l'individuazione dell'inizio di un segmento. 
L'inizio di un segmento sarà rappresentato da un determinato elemento della struttura caricata sul 
gestionale. Questo elemento, avrà il campo Id Primario valorizzato con il nome del tag (ad esempio 
DTM, BGM), il suo formato sarà costruito in modo tale da esportare quel valore sul file ed in 
corrispondenza della tipologia Id Primario (nel dettaglio del formato) avrà il check Segmento att ivato, 
per evidenziare l'inizio di un nuovo segmento.  
I motivi che richiedono l'identificazione dell'inizio segmento sono almeno due:  
Nello standard Edifact, in apposito segmento del file, è richiesta l'indicazione del numero dei segmenti 
presenti in una c erta sezione del file, che, nel caso dei documenti, corrisponde esattamente alle 
informazioni relative ad un documento (nb: in un file Edifact possono essere presenti n documenti). 
Il check segmento consente di contare esattamente il numero di segmenti esp ortati nel file (vedere 
funzione COUNTSEGM, utilizzabile nel campo Espressione)  
In fase di importazione gli elementi che hanno un formato con Id Primario Segmento vengono 
utilizzati come termini di raffronto rispetto al contenuto del file. Sostanzialmente il programma valuta


key: chroma:document
string_value:
ogni riga del file Edifact da importare effettuando un confronto dell'inizio segmento sul file rispetto 
all'Id Primario di un elmento della struttura. In base ai Figli di questo elemento, il programma sarà in 
grado di collocare ogni inf ormazione della stringa al posto giusto.  
 E. (Eccezione su ALLTRIM)  
Questo check ha lo scopo esclusivo di gestire un'eccezione in merito all'applicazione dell'eliminazione 
degli spazi (ALLTRIM) eventualmente abilitata a livello di struttura.  
  
Affinché il programma non tagli eventuali spazi a de stra di una stringa descrittiva (ad esempio, inserita nel campo 
TXT descrittivo dell'elemento, è necessario definire inizio e fine stringa utilizzando le colonne Da, A.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  - V E N D I T E  F U N Z I O N I  A V A N Z A T E  
54 - I N T E G R A Z I O N E  E D I  Caratteri speciali  
  
Per rispettare determ inati standard, soprattutto per quanto riguarda la generazione dei file, è spesso 
necessario prevedere una trascodifica di livello diverso rispetto a quanto visto fin'ora. Determinati 
caratteri che potrebbero essere stati utilizzati dall'utente nei codici articolo, cliente, fornitore, nelle 
descrizioni, ecc. ecc. non possono essere esportati direttamente sul file: si rischia di produrre un file 
non interpretabile. Pensando allo standard XML, è facile capire che l'esportazione sul file di stringhe 
contenenti  caratteri speciali quali >' o <' determinerebbero la generazione un file inconsitente. Per 
questo motivo è prevista una trascodifica dei caratteri speciali. Importando i dati dai file DBF 
distribuiti con la procedura (vedere Import/export archivi EDI), l' archivio può essere popolato con la 
normalizzazione prevista per gli standard XML ed EDIFACT (caricamento dei caratteri speciali).  
  
 
Caratteri speciali  
  
 Codice e Descrizione  
Codice e Descrizione della normalizzazione da associare eventualmente ad una determinata struttura.  
  
Dettaglio Normalizzazione  
Nel dettaglio possono essere inseriti con un determinato ordinamento i caratteri speciali che è 
necessario trascodificare in Export/Import di file EDI. L'origine rappresenta il valore che arriva dal 
gestio nale o che deve essere scritto sui campi del database dello stesso, mentre la normalizzazione 
rappresenta il valore che deve essere scritto sul file o che deve essere interpretato dal file.  
  
Si raccomanda di mantenere invariato l'ordinamento dei caratteri  speciali nel dettaglio della gestione. Ad esempio, 
per l'XML, mettere all'ultimo posto la trascodifica del carattere &, significherebbe passare a trascodifica stringhe di


key: chroma:document
string_value:
normalizzazione risultanti dalla trascodifica di altri caratteri speciali (à      &#224      &amp#224).


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – V E N D I T E  F U N Z I O N I  A V A N Z A T E  
I N T E G R A Z I O N E  E D I  - 55 Gruppi intestatari EDI  
  
In questa anagrafica è possibile inserire tutti i possibili codici di raggruppamento di clienti/fornitori al 
fine di adottare logiche comuni per essi da adottare in fase di import od export dei file EDI.  
  
Tutti i clienti/fornitori che fanno parte di un determinato gruppo potrebbero aver adottato le stesse 
convenzioni per la struttura dei file EDI da importare/esportare e/o per le trascodifiche.  
  
I gruppi assumono  rilevanza  
 Nelle anagrafiche di clienti/fornitori (nella scheda EDI): in questo modo si può definire 
l'eventuale appartenenza di un cliente/fornitore ad un certo gruppo;  
 Nelle trascodifiche EDI: per poter definire trascodifiche da utilizzare nel caso in cui 
l'intestatario appartenga ad un determinato gruppo;  
 Nella gestione export documenti EDI: per poter filtrare i documenti intestati a soggetti 
appartenenti allo stesso gruppo.  
  
 
Gruppi intestatari EDI  
  
 Codice Gruppo  
Il codice del gruppo può essere lungo fi no a 10 caratteri.  
 Descrizione  
Descrizione del gruppo (lunghezza massima 35 caratteri).


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  - V E N D I T E  F U N Z I O N I  A V A N Z A T E  
56 - I N T E G R A Z I O N E  E D I  Trascodifiche  
  
E' possibile definire tutte le trascodifiche utili alla generazione/interpretazione dei file conformi a 
determ inati standard che possono essere stati definiti generalmente su due livelli:  
da un ente super parte , come Indicod, GS1  
dalle parti, in genere tra cliente e fornitore  
  
Le trascodifiche possono essere definite mediante due archivi.  
  
Il primo (Associazione  Trascodifiche) consente di definire a quale struttura/elemento si riferisce la 
trascodifica e se deve essere applicata o meno in base all'intestatario o ad un gruppo di intestatari 
(clienti e fornitori possono essere raggruppati in macro classi, dette Gru ppi EDI, in modo tale da 
poter applicare la solita trascodifica a tutti coloro che appartengono allo stesso gruppo). A questo 
archivio possono essere legate le trascodifiche vere e proprie che possono essere diverse a seconda 
che si tratti di import od exp ort. 
  
Il secondo archivio (Gestione Trascodifiche) consente di definire la corrispondenza tra codice di 
origine (da database o da file) e il relativo codice di destinazione (su file o su database), per ogni 
campo delle tabelle del gestionale.  
  
E' possibi le stabilire trascodifiche anche per tabelle non dichiarate nelle entità. Per gli elementi di tipo espressione, il 
valore da esportare può essere direttamente quello determinato dall'espressione stessa oppure una sua trascodifica. 
Per legare una trascodifi ca all'espressione di un elemento è necessario indicare tabella/campo nella sezione export 
dell'elemento e stessi tabella/campo nelle trascodifiche.  
  
Le trascodifiche possono essere caricate direttamente accedendo all'apposita voce di menù oppure 
cliccand o sull'apposito bottone disponibile in modalità interroga sugli elementi che prevedono una 
trascodifica da intestatario o da struttura.  
  
- Associazione trascodifiche


key: chroma:document
string_value:
trascodifica da intestatario o da struttura.  
  
- Associazione trascodifiche  
- Gestione trascodifiche


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – V E N D I T E  F U N Z I O N I  A V A N Z A T E  
I N T E G R A Z I O N E  E D I  - 57 Associazione trascodifiche  
  
Questo archivio consente di definire a quale struttura/element o si riferisce la trascodifica e se deve 
essere applicata o meno in base all‘intestatario o ad un gruppo di intestatari (clienti e fornitori 
possono essere raggruppati in macro classi, dette Gruppi EDI, in modo tale da poter applicare la 
solita trascodific a a tutti coloro che appartengono allo stesso gruppo). A questo archivio possono 
essere legate le trascodifiche vere e proprie che possono essere diverse a seconda che si tratti di import 
od export.  
  
 
Associazione trascodifiche  
  
 Codice struttura  
Ogni trascodifica farà riferimento ad una determinata struttura EDI  
 Codice elemento  
E' il codice dell'elemento al quale si riferisce la trascodifica.  
 Tipo Intestatario  
La tipologia relativa all'intestatario è strettamente connessa a quanto previsto sull'elemento. Se su 
quest'ultimo è stata prevista una trascodifica da struttura, il tipo intestatario sarà impostato a Nessuno; 
viceversa, se sull'elemento è stata indicata una trascodifica da intestatario, in questo elemento può 
avere sen so la selezione della tipologia Clienti, Fornitori o Gruppo. Le scelte possibili sono:  
 Clienti: è la tipologia da indicare se si vuole predisporre una trascodifica valida per un 
determinato cliente (che potrà essere indicato nel campo accanto).  
 Fornitori: è la tipologia da indicare se si vuole predisporre una trascodifica valida per un 
determinato fornitore (che potrà essere indicato nel campo accanto).  
 Gruppo: è la tipologia da indicare se si vuole predisporre una trascodifica valida per un 
determinato gruppo di clienti/fornitori (che potrà essere indicato nel campo accanto).  
 Nessuno : è la tipologia da indicare se si vuole predisporre una trascodifica da applicare solo


key: chroma:document
string_value:
 Nessuno : è la tipologia da indicare se si vuole predisporre una trascodifica da applicare solo 
in base alla struttura di riferimento (può essere legata solo ad elementi che prevedono una 
trascodifica da struttura).  
  
Sul campo relativo all'eventuale intestatario non è possibile effettuare la classica ricerca sullo zoom mediante 
inserimento parziale di un codice.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  - V E N D I T E  F U N Z I O N I  A V A N Z A T E  
58 - I N T E G R A Z I O N E  E D I   Tabella/Campo  
In questi campi devono essere indicati tabella e campo sui quali applicare la trascodifica.  
  
Questi dati devono corrispondere a quanto indicato sull'elemento nella sezione import e/o nella sezione export, 
altrimenti il programma non effett ua il legame trascodifica -elemento. Questo vale anche per gli elementi espressione: 
per predisporne una trascodifica (in export) dovranno essere compilati tabella/campo dell'elemento nella sezione 
export.  
  
 Trascodifica Export  
È il codice della trascodif ica da utilizzare nel caso di generazione dei file EDI (export).  
 Trascodifica Import  
È il codice della trascodifica da utilizzare nel caso di importazione dei file EDI (import).


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – V E N D I T E  F U N Z I O N I  A V A N Z A T E  
I N T E G R A Z I O N E  E D I  - 59 Gestione trascodifiche  
  
Questo archivio consente di definire la corrispondenza tra codice di origine (da database o da file) e il 
relativo codice di destinazione (su file o su database), per ogni campo delle tabelle del gestionale.  
  
 
Gestione trascodifiche  
  
 Codice  
Rappresenta il codice della trascodifica. Visto che la solita trascodifica non avrà senso in import ed in 
export (perché codice di origine e codice di destinazione dovrebbero essere invertiti), è bene 
distinguere le due tipologie di trascodifica in base al codice: ad esempio suffisso _EXP per le 
trascodifiche da utilizzare in export e suffisso _IMP per quelle da utilizzare in import.  
 Descrizione  
Descrizione della trascodifica  
 Elimina spazi su  
Tramite questa combo box è possibile stabilire se deve essere effettuata o meno un'operazione di 
eliminazione spazi (ALLTRIM) sul codice di origine e/o sul codice di destinazione o su nessuno dei 
due. In questo modo la trascodifica è più flessibile: ad esempio uno spazio vuoto può essere 
trascodif icato con un carattere (da ' ' a S). Le scelte possibili sono  
 Codice origine: effettua Alltrim solo sul codice di origine  
 Codice destinazione: ef fettua Alltrim solo sul codice di destinazione  
 Entrambi: effettua Alltrim sia sul codice di destinazione che sul codice di origine  
 Nessuno: non effettua alcuna Alltrim  
 Tabella/Campo  
Tabella e campo per i quali si definisce la trascodifica: devono cor rispondere a quelli indicati 
sull'elemento di riferimento altrimenti non verrà effettuata nessuna trascodifica.  
  
Dettaglio Gestione Trascodifiche  
Nel dettaglio devono essere indicati i valori di ori gine e quelli di destinazione.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  - V E N D I T E  F U N Z I O N I  A V A N Z A T E  
60 - I N T E G R A Z I O N E  E D I  Stampe archivi EDI  
  
Le stampe relative all'integrazione EDI riguardano esclusivamente gli archivi. Per ogni anagrafica 
disponibile è possibile ottenere almeno un report cartaceo.  
  
- Stampa strutture  
- Stampa entità  
- Stampa elementi  
- Stampa formati  
- Stampa associazione trascodifiche  
- Stampa caratteri speciali  
- Stampa gestione trascodifiche  
- Stampa gruppi intestatari


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – V E N D I T E  F U N Z I O N I  A V A N Z A T E  
I N T E G R A Z I O N E  E D I  - 61 Stampa strutture  
  
Questa stampa consente di stampare il contenuto dell'archivio strutture. E' possibile filtrare oltre che 
per codice, anche per Entità. Nella stampa vengono riportati anche i valori predefiniti associati alla 
struttura stampata.  
  
 
Stampa strutture


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  - V E N D I T E  F U N Z I O N I  A V A N Z A T E  
62 - I N T E G R A Z I O N E  E D I  Stampa entità  
  
Questa stampa consente di evidenziare il contenuto relativo ad una determinata entità. E' po ssibile 
stampare solo le entità del modulo Vendite funzioni avanzate anche se nello zoom di selezione 
vengono visualizzate anche quelle del modulo Logistica Remota.  
  
 
Stampa entità


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – V E N D I T E  F U N Z I O N I  A V A N Z A T E  
I N T E G R A Z I O N E  E D I  - 63 Stampa elementi  
  
La stampa evi denzia il contenuto dell'archivio elementi consentendo di filtrare per Struttura e/o per 
uno specifico intervallo di elementi (prima di poter selezionare gli elementi è necessario scegliere una 
determinata struttura EDI).  
  
 
Stampa elementi


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  - V E N D I T E  F U N Z I O N I  A V A N Z A T E  
64 - I N T E G R A Z I O N E  E D I  Stampa formati  
  
La stampa formati consenti di stampare il contenuto del corrispondente archivio fornendo filtri per 
struttura e per un determinato intervallo di codici formato.  
  
 
Stampa formati


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – V E N D I T E  F U N Z I O N I  A V A N Z A T E  
I N T E G R A Z I O N E  E D I  - 65 Stampa associazione trascodifiche  
  
La stampa consente di evidenziare non solo il contenuto dell'archivio Associazione Trascodifiche, ma 
anche le trascodifiche collegate (caricate in gestione trascodifiche)  
  
 
Stampa associazio ne trascodifiche


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  - V E N D I T E  F U N Z I O N I  A V A N Z A T E  
66 - I N T E G R A Z I O N E  E D I  Stampa gestione trascodifiche  
  
Consente di stampare il contenuto dell'archivio Gestione Trascodifiche.  
  
 
Stampa gestione trascodifiche


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – V E N D I T E  F U N Z I O N I  A V A N Z A T E  
I N T E G R A Z I O N E  E D I  - 67 Stampa caratteri speciali  
  
Consente di stampare il contenuto dell'archivio caratteri speciali.  
  
 
Stampa caratteri speciali


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  - V E N D I T E  F U N Z I O N I  A V A N Z A T E  
68 - I N T E G R A Z I O N E  E D I  Stampa gruppi intestatari  
  
La stampa dei gruppi intestatari EDI consen te di filtrare per un determinato range di codici gruppo e 
di ottenere l’elenco dei Clienti/Fornitori che appartengono ai gruppi stampati.  
  
 
Stampa gruppi intestatari


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – V E N D I T E  F U N Z I O N I  A V A N Z A T E  
I N T E G R A Z I O N E  E D I  - 69 Visualizzazione struttura  
  
In base  ai legami creati tra i vari elementi (vedere oltre per una definizione di elemento), è possibile 
visualizzare la struttura in modalità Treeview . Questa modalità di visualizzazione consente di avere 
immediata visione delle caratteristiche di una struttura.  
  
 
Visualizzazione struttura  
  
 Struttura  
Questo codice viene proposto automaticamente se è stata definita almeno una struttura EDI come 
predefinita. E' comunque selezionabile dall'utente.  
 Monolivello  
Questo check è visibile solo per strutture di tipo Edifact o Lunghezza fissa (Eurit mo). L’attivazione di 
questo check permette di passare dalla visualizzazione standard alla visualizzazione monolivello, più 
adatta a verificare se per ogni riga/segmento del file è previsto un elemento con id primario 
corrispondente. Con questo tipo di vis ualizzazione è possibile verificare, per ogni elemento, i seguenti 
dati: l’id primario, la tabella di riferimento (sezione import), il codice dell’elemento e la descrizione.  
Alcuni elementi, ad esempio quello che segna l’inizio di ogni riga del documento d a importare, 
vengono evidenziati applicando un bordo rosso all’icona che identifica il tipo di elemento: tali 
elementi sono gli “elementi rottura”, che, nel caso della tabella di dettaglio (DOC_DETT),


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  - V E N D I T E  F U N Z I O N I  A V A N Z A T E  
70 - I N T E G R A Z I O N E  E D I  determinano l’inserimento di una nuova riga documento s ulle tabelle piatte proprio perché i dati che 
seguiranno sono relativi ad una nuova riga (fino al prossimo riscontro dell’elemento rottura). A titolo 
di esempio si può verificare il segmento con tag “LIN” delle struttura Edifact ed Euritmo: in 
entrambi i c asi il corrispondente elemento della struttura EDI con id primario “LIN” ha il check 
attivo su “elemento rottura” e quindi viene evidenziato nella visualizzazione monolivello.  
  
 
Visualizzazione struttura monolivello  
  
Questo tipo di visualizzazione è uti le per avere un riscontro immediato rispetto al contenuto di un file 
Edifact o Euritmo (lunghezza fissa) da importare. Visto che il programma associa i segmenti del file 
(che in genere corrispondono alle righe del file di testo) agli elementi della struttu ra che hanno “Id 
primario” valorizzato e corrispondente al Tag di ciascun segmento (ad esempio, la riga/segmento con 
tag UNH viene associata al primo elemento della struttura EDI che ha id Primario UNH), la 
visualizzazione dei soli elementi che hanno Id pr imario valorizzato aiuta nell’individuazione di 
eventuali mancanze. Si sottolinea che, nel caso in cui ogni segmento del file non abbia un elemento 
con id primario corrispondente, la procedura di importazione si blocca immediatamente al primo step 
(prima d ella creazione del file XML).  
 Radice  
Questo campo viene proposto precompilato: il valore predefinito è l'elemento radice associato alla 
struttura EDI selezionata nel campo precedente. E' possibile inserire manaulmente il codice di 
qualsiasi elemento face nte parte della struttura ed eseguire la ricerca. In questo modo la struttura viene 
ridimensionata fornendo la possibilità di visualizzare solo una parte della stessa (esplosione di un


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – V E N D I T E  F U N Z I O N I  A V A N Z A T E  
I N T E G R A Z I O N E  E D I  - 71 sottoelemento padre) oppure solo un singolo elemento (selezione di un s olo elemento foglia).  
 Ricerca  
Questo bottone esegue la ricerca degli elementi associati all'elemento radice (direttamente ed 
indirettamente). Dopo aver eseguito la ricerca sarà possibile esplodere/implodere tutta la struttura 
(mediante appositi bottoni) oppure singoli element i. 
 Dettaglio  
Premendo il bottone dettaglio sulla visualiz zazione di  tipo “monolivello”, il programma riesegue la 
ricerca sulla visualizzazione “standard” (il check “monolivello” viene disattivato) visualizzando solo il 
ramo relativo all’elemento della s truttura sul quale si era posizionati. Questo bottone permette quindi 
di visualizzare esclusivamente gli elementi figli di un elemento con “id primario” in modo tale da 
verificare in che modo verranno associati i dati presenti su un determinato segmento de l file da 
importare.  
 Esplodi  
Esplode l'intera struttura EDI.  
 Implodi  
Implode l'intera struttura EDI.  
 Elemento  
Consente di richiamare l'anagrafica dell'elemento sul quale si è posizionati.  
 Stampa  
Consente di stampare la treeview esplosa dall'elemento selezionato come ra dice della visualizzazione.  
  
Le icone posizionate accanto agli elementi della struttura hanno lo scopo di evidenziarne in modo 
immediato la tipologia. Di seguito si riporta l'elenco delle icone utilizzate ed il loro significato:  
  
 Valore   Valore (attribu to XML)  
 Valore (utilizzato in Import)   Valore (attributo XML utilizzato in Import)  
 Espressione   Espressione (attributo XML)  
 Espressione (utilizzato in Import)   Espressione (attributo XML utilizzato in Import)  
 Fisso   Variabile  
 Reiterabile   Scelta  
 Apertura File   Chiusura File  
 Apertura (sezione/documento)   Chiusura (sezione/documento)


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  - V E N D I T E  F U N Z I O N I  A V A N Z A T E  
72 - I N T E G R A Z I O N E  E D I  Duplicazione struttura  
  
Le strutture EDI possono essere duplicate mediante un'apposita funzione raggiungibile da menù. 
Creando una struttura ex novo è possibile modificare il Formato gruppo ed il Nome file della nuova 
struttura, mentre, la duplicazione di Rami su strutture esistenti consente solamente di definire 
elemento padre di origine e di destinazione.  
  
L'effet to di questa operazione è quello di duplicare/aggiornare anagrafica struttura, di duplicare gli 
elementi (da un certo Padre in poi), di duplicare i formati (tutti) e le trascodifiche legate agli elementi 
duplicati.  
  
Nel caso in cui non si effettui una cre azione ex novo di una struttura EDI, ma solo la copia di determinati rami 
da una struttura esistente, il programma segnalerà un errore di chiave duplicata se gli elementi che si tenta di 
inserire sono già esistenti sulla struttura di destinazione.  
  
Questa  funzione risulta essere di indubbia utilità per la definizione di strutture che differiscono per 
pochi dati rispetto a quelle esistenti, situazione tipica che si verifica quando la struttura di un file EDI 
viene convenuta tra le parti o imposta da una par te, ovvero nella maggioranza dei casi.  
  
 
Duplicazione struttura  
  
 Struttura origine  
Codice della struttura da prendere come riferimento per la creazione di una nuova struttura o 
l'aggiornamento di una esistente.  
 Struttura destinazione  
Codice della struttura da creare, oppure da aggiornare se già esistente.  
 Elemento  padre origine  
Elemento (della struttura di origine) a partire dal quale deve essere effettuata la duplicazione. Ad 
esempio, facendo riferimento ad una struttura Edifact, selezionando l'elemento UNB, il programma 
effettuerà la copia dell'intero ramo della struttura di origine che ha come Padre UNB.  
 Elemento padre destinazione


key: chroma:document
string_value:
 Elemento padre destinazione  
In caso di creazione di una struttura nuova, questo campo non è editabile, altrimenti, rappresenta


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – V E N D I T E  F U N Z I O N I  A V A N Z A T E  
I N T E G R A Z I O N E  E D I  - 73 l'elemento (della struttura di destinazione) al quale deve essere Sganciato il ramo duplicato dalla 
struttura di origine. Se in  origine è stato selezionato l'elemento UNB e come destinazione l'elemento 
ROOT, il programma copierà il ramo della struttura di origine con padre UNB assegnando a 
quest'ultimo padre ROOT.  
 Predefinita  
Se questo check viene proposto attivo (dopo aver valo rizzato il campo codice originario), significa che 
la struttura selezionata come origine è predefinita. Lanciando la duplicazione con check attivo, la 
nuova struttura diventerà la predefinita, mentre su quella di origine verrà eliminato il check.  
Se la dup licazione viene lanciata senza lasciare attivo il check, allora la struttura di origine rimarrà 
predefinita, mentre non lo sarà quella nuova.  
 Entità  
Codice entità da utilizzare per duplicazione degli archivi EDI (elementi, formati, ecc.)  
 Elemento radice  
Codice dell'elemento radice della nuova struttura EDI.  
 Formato gruppo  
Codice del formato da utilizzare per gli elementi di tipologia Fisso  (elementi di raggruppamento) della 
nuova struttura EDI.  
 Nome file  
Struttura del nome del file da utilizzare per la nuova struttura EDI.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  - V E N D I T E  F U N Z I O N I  A V A N Z A T E  
74 - I N T E G R A Z I O N E  E D I  Eliminazione struttura  
  
Questa gestione ha lo scopo di consentire d i eliminare le strutture EDI o rami di esse. Per eliminare 
una struttura e tutti gli oggetti collegati (elementi, formati, trascodifiche) è sufficiente selezionare il 
codice e premere il bottone di conferma. Se invece si intende effettuare l'eliminazione d i un 
determinato ramo della struttura, occorre modificare l'elemento padre origine.  
  
 
Eliminazione struttura  
  
 Codice Struttura  
Codice della struttura di riferimento per l'eliminazione.  
 Elemento padre origine  
Codice dell'elemento a partire dal quale deve essere eseguita l'eliminazione. Se viene definito un codice 
diverso rispetto alla radice della struttura, si gnifica che si effettuerà un'eliminazione parziale.  
  
In ogni caso, prima di procedere, dopo la pressione del bottone OK, il programma richiede un 
ulteriore conferma all'utente.  
  
Per poter eliminare una struttura è necessario che la stessa non sia associa ta a causali documento o 
Clienti/Fornitori. In caso contrario comparirà un messaggio a video.  
Se la cancellazione è relativa ad un determinato ramo della struttura, l'associazione della stessa a causali o 
Clienti/Fornitori, non è bloccante.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – V E N D I T E  F U N Z I O N I  A V A N Z A T E  
I N T E G R A Z I O N E  E D I  - 75 Parametri EDI  
  
In questo archivio è possibile definire i percorsi di posizionamento/ricerca dei file EDI 
importati/esportati e stabilire in che modo deve comportarsi la procedura nel caso in cui si verifichino 
degli errori eseguen do l'import massivo dei file EDI.  
  
 
Parametri EDI  
  
 Directory export file  
In questo campo deve essere definito il percorso in cui devono essere salvati i file generati dalla 
procedura. Corrisponde allo stesso percorso definibile anche in Gestione Path (sotto Archivi 
Azienda)  
 Directory di selezione file import  
Il percorso indicato in questo campo è quello in cui la procedura esegue la ricerca dei file da importare 
(valore predefinito).  
 Directory di spostamento file  
Quando i file sono stati correttamente importati, il programma sposta i file in questa ca rtella.  
 Directory file XML intermedi  
E' il percorso di memorizzazione dei file XML generati dalla procedura di importazione. Se non viene 
specificato, l'XML viene generato nella cartella temporanea della macchina client.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  - V E N D I T E  F U N Z I O N I  A V A N Z A T E  
76 - I N T E G R A Z I O N E  E D I   Se si verifica un errore  
Questa  combo box consente di definire il livello di granularità circa l'annullamento dell'operazione in 
caso si presentino degli errori. Si tratta semplicemente di selezionare il valore predefinito da proporre 
quando si lancia l'importazione massiva dei file EDI . Vedere paragrafo Import massivo file EDI.  
Le voci già presenti prima dell’aggiornamento, in ordine di granularità dell’annullamento elaborazione, 
sono le seguenti:  
 Annulla elaborazione corrente: nel caso in cui l’import vada in errore vengono annullate tutte 
le importazioni eseguite relative all’operazione globalmente considerata (verranno eliminati tutti 
i documenti eventualmente generati);  
 Annulla elaborazione struttura corrente: nel caso in cui l’import vada in errore vengono 
annullate tutte le importazioni eseguite relative alla struttura per la quale si è verificato (verranno 
eliminati tutti i documenti eventualmente già generati dall’import di file relativi a quella 
struttura);  
 Annulla elaborazione file corrente: nel caso in cui l’import vada in errore viene annullata solo 
l’elaborazione per la quale si è verificato (verranno mantenuti i documenti generati dagli altri 
file). 
 Annulla solo documenti errati: questa opzione perme tte di annullare l’importazione solo per 
i documenti che risultano errati e che sono presenti all’interno dello stesso file. Ad esempio, se 
di “n” documenti presenti in un file EDI alcuni non fossero importabili perché già presenti 
all’interno del database  di destinazione, allora la procedura escluderebbe dall’importazione solo 
questi documenti, ma importerebbe tutti gli altri.  
  
In questa casistica, il programma evidenzia nel log dell’import massivo che si è verificato un errore in 
merito al file EDI.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – V E N D I T E  F U N Z I O N I  A V A N Z A T E  
I N T E G R A Z I O N E  E D I  - 77 Import massivo e file contenenti alcuni documenti errati  
  
Verificando l’anagrafica importazioni si potrà notare come siano stati saltati esclusivamente i 
documenti già presenti.  
  
 
Log esecuzione step C  
  
Mentre il log del generatore documentale, per lo stesso file, darà evidenza di quali documenti sono 
stati generati dall’importazione.  
  
Questo livello di granularità per l’annullamento dei soli documenti errati, riguarda esclusivamente l’import massivo 
file EDI. Infatti, importando lo stesso file tramite  l’assistente importazione file EDI, il programma segnalerebbe gli 
errori in merito ai documenti già presenti, senza importare il file!


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  - V E N D I T E  F U N Z I O N I  A V A N Z A T E  
78 - I N T E G R A Z I O N E  E D I   Gestione tabelle import/export  
  
In questo capitolo verranno af frontati gli argomenti attinenti al trattamento dei file nelle due fasi 
fondamentali:  
 Export  
 Import  
  
- Generazione file EDI  
- Importazione file EDI  
- Assistente importazione file EDI  
- Import documenti EDI  
- Import massivo file EDI  
- Anagrafica importazioni  
- Log generatore documentale  
- Cancellazione anagrafica importazioni  
- Gestione tabelle piatte  
- Manutenzione tabelle piatte  
- Import/export tabelle piatte  
- Import/export archivi EDI  
- Controllo congruenza strutture EDI


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – V E N D I T E  F U N Z I O N I  A V A N Z A T E  
I N T E G R A Z I O N E  E D I  - 79 Generazione file EDI  
  
Per la generazione dei file EDI è possibile intraprendere diverse strade. I file possono essere generati 
da Print System (utilizzando  l'apposito bottone) oppure tramite la gestione Export Documenti EDI 
che consente di creare anche un unico file a fronte di più documenti.  
  
 
Flusso esportazione  
  
I presupposti per poter lanciare la generazione dei file EDI sono:  
 Aver predisposto una o  più strutture EDI: significa aver definito la struttura di uno o più file, 
ad esempio di uno o più tipi di fattura e/o di ordini e/o di documenti di trasporto, ecc. ecc.;  
 Aver definito dei criteri di utilizzo delle strutture EDI in base al contesto: sig nifica aver 
associato le strutture EDI alle causali documento e/o a Clienti/Fornitori, ma, soprattutto, aver 
definito delle trascodifiche (da Intestatario, da Struttura, da Routine) per rendere il file 
interpretabile dalla controparte (il destinatario del file sarà in grado di interpretare determinati 
codici articolo, banca, unità di misura, ecc. ecc.);  
 Aver definito il percorso di memorizzazione dei file EDI (Gestione Path o Parametri EDI);  
 Aver definito i parametri per il nome del file (Archivio Strutture).  
  
Le strutture EDI vengono definite attraverso la predisposizione degli archivi strutture, el ementi, 
formati e trascodifiche.  
  
In merito agli utilizzi delle strutture EDI, è necessario procedere al loro abbinamento a causali 
documento e/o in modo più specifico a clienti/fornitori.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  - V E N D I T E  F U N Z I O N I  A V A N Z A T E  
80 - I N T E G R A Z I O N E  E D I  
 
Struttura EDI su Causale Documento  
  
E' possibile associare st rutture EDI a tutte le tipologie di documento ad eccezione dei Corrispettivi.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – V E N D I T E  F U N Z I O N I  A V A N Z A T E  
I N T E G R A Z I O N E  E D I  - 81 
 
EDI e Anagrafica Clienti  
  
Oltre all'indicazione di una struttura EDI per ogni causale documento, è possibile stabilire un gruppo 
di appartenenza dei Clienti/Fornitori (il gr uppo può essere utilizzato per definire delle trascodifiche 
comuni che valgano per diversi intestatari contemporaneamente e come filtro di selezione dei 
documenti sulla gestione Export documenti EDI).  
Il path per la memorizzazione del file deve essere indi cato in Gestione Path oppure nei Parametri 
EDI (come già descritto precedentemente). Il path è relativo alla macchina client; per salvare su un 
server è necessario condividere una cartella e mapparla dai singoli client.  
  
Il nome del file viene definito da ll'utente tramite utilizzo di determinate variabili specificate 
nell'apposito campo dell'anagrafica struttura (es: <DATE>,<TIME>).


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  - V E N D I T E  F U N Z I O N I  A V A N Z A T E  
82 - I N T E G R A Z I O N E  E D I  
 
Nome file su anagrafica strutture  
  
E' possibile costruire il nome del file in base a determinate variabili. Alcune di qu este non sono 
utilizzabili nel caso in cui si opti per la generazione di un unico file a fronte di più documenti (vedere 
descrizione campo Nome file dell'archivio strutture).  
  
La generazione del file potrà avvenire da Print System mediante utilizzo di uno  specifico bottone 
oppure da apposita gestione che consente anche la generazione di un unico file relativo a più 
documenti.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – V E N D I T E  F U N Z I O N I  A V A N Z A T E  
I N T E G R A Z I O N E  E D I  - 83 
 
EDI e Print System  
  
La generazione di un file da Print System è possibile solo se il programma è in grado di determinare la 
struttura EDI da utilizzare. Questa condizione si verifica solo se è stata associata al cliente/fornitore 
intestatario del documento o genericamente sulla causale. Il bottone è in ogni caso editabile. In 
mancanza della struttura o di un'altra delle condizioni  descritte precedentemente (percorso, nome 
file), comparirà un messaggio di avviso.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  - V E N D I T E  F U N Z I O N I  A V A N Z A T E  
84 - I N T E G R A Z I O N E  E D I  Export documenti EDI  
La gestione per l'esportazione dei documenti rappresenta un'alternativa alla Print System (relativa ad 
un documento) per la generazione dei file e l 'unica via percorribile se si intendono generare file 
contenenti più di un documento (opzione file unico). E' possibile applicare vari filtri di selezione, 
eseguire la ricerca, selezionare i documenti da generare e lanciare la procedura.  
  
 
Export Documen ti EDI  
  
La struttura EDI da utilizzare viene determinata automaticamente dal programma. I criteri di utilizzo 
sono leggermente diversi a seconda che si opti o meno la generazione in un file unico:  
  
File distinti: la struttura utilizzata è quella definita  per l'intestatario del documento, altrimenti quella 
della causale documento. Se non è definita nemmeno quest'ultima il file non viene generato.  
  
File unico: la struttura da utilizzare è parametrizzabile sul momento. Può essere da intestatario, da 
causale  o forzata. In tutti questi casi è necessario inserire negli appositi campi l'intestatario, la causale o 
la struttura EDI (per le prime due informazioni vengono utilizzati i campi che fungono anche da 
filtro, per la struttura EDI, esiste un campo distinto in calce alla maschera.  
 Causale  
In questo campo può essere definito il filtro per causale documento. Questo campo, se valorizzato, 
viene anche utilizzato per la determinazione della struttura EDI da applicare in caso di generazione di 
file unico con criterio da causale.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – V E N D I T E  F U N Z I O N I  A V A N Z A T E  
I N T E G R A Z I O N E  E D I  - 85  Categ oria 
Rappresenta un filtro in base alla classe di appartenza dei documenti. E' possibile considerare tutti i 
documenti (default) oppure filtrare su documenti interni, ordini, documenti di trasporto, fatture e 
note di credito. Se non è installato il modulo ciclo acquisti, sarà disponibile anche l'opzione per 
emissione DT a fornitore.  
 Tipo documento  
Questa combo box consente di filtrare i documenti da visualizzare nello zoom in base 
all'appartenenza del documento al ciclo acquisti o al ciclo vendite.  
 Doc. dal/al  
In questi campi è possibile definire un intervallo temporale che filtre rà sulla data documento.  
 Serie  
Rappresenta il filtro sulla parte alfanumerica del documento.  
 Da - A Numero  
In questi campi è possibile definire un intervallo numerico che filtrerà sul numero documento.  
 Intestatario  
Questo campo consente di inserire u n eventuale intestatario per la ricerca dei documenti. Il campo è 
editabile solo dopo aver inserito anche la causale documento: questo perché il campo non rappresenta 
solo un filtro di selezione, ma viene utilizzato anche per la determinazione della strutt ura EDI da 
utilizzare (si ricorda che, per ogni causale, nell'anagrafica di Clienti/Fornitori, è possibile specificare 
una struttura EDI alternativa a quella predefinita sulla causale documento stessa). Inoltre, la 
valorizzazione del campo intestatario è n ecessaria per fornire il valore allo statement HEADERPERS, 
che può essere stato utilizzato negli elementi che precedono l'apertura del documento nel file (per 
utilizzo degli statements vedere descrizione campo Espressione dell'anagrafica Elementi).  
 Grupp o 
Questo campo permette di filtrare nella ricerca i documenti relativi ad intestatari facenti parte dello 
stesso gruppo. Può essere utile per esportare in un file unico più documenti relativi ad intestatari


key: chroma:document
string_value:
diversi.  
 Escludi documenti generati  
Questo chec k è proposto attivo di default: consente di escludere dalla visualizzazione i documenti per 
i quali è già stato generato un file EDI (informazione memorizzata nei dati di testa del documento).  
 Struttura  
Questo campo funge solamente da filtro di selezione : consente di visualizzare solo i documenti creati 
con causale che ha associata una determinata struttura EDI.  
  
Dettaglio Export Documenti EDI  
Nello zoom viene visualizzato l'elenco dei documenti che corrisponde ai filtri impostati dall'utente 
dopo aver r ieseguito la ricerca.  
 Seleziona - Deseleziona tutti  
Ha lo scopo di selezionare/deselezionare tutti i documenti presenti sullo zoom.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  - V E N D I T E  F U N Z I O N I  A V A N Z A T E  
86 - I N T E G R A Z I O N E  E D I   File Unico  
Attivando questo check è possibile generare invece che un file per ogni documento selezionato, un 
unico file contenente tutti i doc umenti. Questo tipo di generazione avrà senso quando tutti i 
documenti sono relativi allo stesso intestatario, tuttavia non esistono limiti imposti dalla procedura, 
perché il file generato potrebbe essere utilizzato per scopi diversi rispetto a quello tipi co. 
  
Quando si sceglie questa opzione, come già anticipato precedentemente, è necessario fornire alla 
procedura i criteri per l'applicazione di una determinata struttura EDI. Per questo si attiva la combo 
box Struttura da utilizzare.  
 Struttura da utilizzare  
Permette di scegliere il criterio di utilizzo delle strutture EDI nel caso si desideri generare un file unico 
per tutti i documenti selezionati. Le opzioni disponibili sono:  
 Da intestatario: viene applicata solo la struttura ass ociata all'intestatario indicato sulla 
maschera nel campo che funge anche da filtro. Affinché tale criterio funzioni è necessario che 
nell'anagrafica del cliente/fornitore sia stata definita una struttura EDI applicabile in relazione 
alla causale utilizzat a come filtro di selezione.  
 Da causale: viene applicata solo la struttura associata alla causale documento indicata sulla 
maschera nel campo che funge anche da filtro. Affinché tale criterio funzioni è necessario che la 
causale sia stata associata ad una determinata struttura EDI  
 Forzata: viene applicata solo la struttura indicata nel campo in calce alla maschera (quello che 
appare con questa selezione).  
  
Nel caso in cui non sia applicabile una struttura EDI per il file unico, compare un messaggio di 
avviso.  
 Esporta  
Questo bott one lancia la generazione del file/dei file EDI. Durante la generazione viene visualizzata


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – V E N D I T E  F U N Z I O N I  A V A N Z A T E  
I N T E G R A Z I O N E  E D I  - 87 Importazione file EDI  
  
Per poter importare file EDI nella procedura, è necessario predisporre in modo corretto determinati 
archivi. Occorre effettuare almeno le seguenti operazioni (in ordine cronologico):  
 Avere popolato gli archivi EDI, manualmente o mediante import dei file DBF presenti nella 
cartella di installazione (.. \vefa\exe): entità, elementi, formati, ecc..  
 Aver popolato l'anagrafica tabelle piatte, manualmente o mediante import dei file DBF 
presenti nella cartella di installazione (.. \vefa\exe). 
 Aver aggiornato il database mediante la creazione delle tabelle piatte accedendo all'apposita 
voce di menù.  
 Aver aggiornato il dizionario dati di ad hoc, mediante l'apposita funzione disponibile 
all'interno del menù sistema.  
 Aver compilato i dati richiesti nei parametri EDI: cartelle di elaborazione file e tipo di 
granularità predefinito per l'import massivo.  
  
Per quanto riguarda l'importazione dei documenti EDI è possibile utilizzare almeno due t ipologie di 
interfaccia: una ha come obiettivo la massima automatizzazione e quindi un minimo intervento 
dell'utente (se non nullo); l'altra ha l'obiettivo di consentire la verifica passo dopo passo del processo 
di importazione al fine di risalire con imme diatezza ad eventuali problemi riscontrati con uno o più 
file. 
  
 
Modalità di importazione file  
  
L'intero processo di importazione è scomponibile in fasi specifiche. Il passaggio da una fase a quella 
successiva è guidato da procedure batch esplicitate pe r ciascuna struttura EDI. Sostanzialmente è 
possibile vedere ed utilizzare le elaborazioni standard per l'interpretazione di determinati file EDI, ma 
è anche possibile definire procedure di elaborazione diverse che consentiranno di gestire tutte le 
casisti che che potrebbe trovarsi di fronte l'utente.


key: chroma:document
string_value:
casisti che che potrebbe trovarsi di fronte l'utente.  
  
Al di là della modalità prescelta per eseguire l'importazione dei file EDI, il programma memorizza i 
log dell'elaborazione di ogni file. In Anagrafica Importazioni è possibile verificare data e ora di 
importa zione, il nome del file, la struttura utilizzata, le informazioni di log di ciascuno step. Se 
l'importazione è andata a buon fine, è possibile visualizzare il log di generazione (quello del generatore 
documentale).  
  
L'automatizzazione massima del processo  di importazione prevede la verifica del contenuto di una


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  - V E N D I T E  F U N Z I O N I  A V A N Z A T E  
88 - I N T E G R A Z I O N E  E D I  determinata cartella (ed eventualmente delle sottocartelle), l'associazione di ogni file ad una 
determinata struttura EDI (in base ai parametri definiti dall'utente) e quindi l'esecuzione automatica  di 
tutti gli step di cui è costituito l'intero processo.  
  
 
Step del processo di importazione  
  
La struttura EDI è ovviamente la chiave di lettura del file. In base alle proprietà della struttura il 
programma svolge la prima fase del processo, ovvero la creazione di un file XML con tag 
corrispondenti ai codici degli elementi della struttura (il file XML viene salvato in un'apposita cartella 
specificata dall'utente, oppure nella Temp della macchina client). Si tratta sostanzialmente di una 
trasformazione d el file in ingresso (rispondente ad uno degli standard convenuti, Edifact, Euritmo) in 
un formato più flessibile e facilmente navigabile. Il file XML viene costruito in base all'algoritmo 
definito sulla struttura EDI al primo step (batch standard: GSVA_BXM ) 
  
Il secondo step consiste nella mappatura delle informazioni del file XML su apposite tabelle, definite 
EDI_TABLES (sulla procedura Tabelle Piatte): si tratta di tabelle persistenti presenti nel database e 
definite anche liberamente dall'utente. Le proc edure standard, predisposte da Zucchetti, prevedono 
che queste tabelle siano pienamente corrispondenti con quanto presente negli archivi di destinazione: 
questo significa che gli algoritmi standard funzionano regolarmente fino a quando il file EDI può 
essere mappato in EDI_TABLES con struttura identica a quella dei documenti. Ad esempio, il 
numero documento esplicitato sul file di testo importato, dovrà essere mappato con il campo 
DOC_MAST.MVNUMDOC delle EDI_TABLES. Queste tabelle rappresentano di fatto una  sorta di 
archivio transitorio che, salvo particolari necessità, corrisponde alle tabelle dei documenti


key: chroma:document
string_value:
archivio transitorio che, salvo particolari necessità, corrisponde alle tabelle dei documenti 
(DOC_MAST, DOC_DETT).  
  
Difficilmente risulta possibile mappare tutte le informazioni presenti sul file con i campi a disposizione sulle tabelle 
relativ e ai documenti. In questo caso è necessario procedere alla definizione di nuovi campi sulle EDI_TABLES, 
ma questo implica anche la necessità di personalizzazione delle procedure di elaborazione, soprattutto quella che 
deve fornire i dati al generatore docu mentale (ultimo step).  
  
L'interpretazione del file XML avviene nel seguente modo


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – V E N D I T E  F U N Z I O N I  A V A N Z A T E  
I N T E G R A Z I O N E  E D I  - 89 Il programma individua mediante il Tag di ciascun dato il relativo elemento della struttura EDI  
Sull'elemento della struttura EDI saranno stati definiti Tabella/Campo di dest inazione delle 
EDI_TABLES  
In questo modo le EDI_TABLES vengono popolate mettendo a disposizione dell'utente un archivio 
persistente sul quale sono mappate le informazioni utili del file originario. In questo step rientra anche 
l'eventuale modifica dei dati  mappati (possibilità utile per consentire l'importazione di files con dati 
incongruenti o non interpretati in modo corretto).  
In questo step vengono utilizzati due batch standard, GSVA_BDR che provvede al caricamento del 
file XML, al calcolo del seriale p er l'inserimento in EDI_TABLES ed il richiamo della funzione 
ricorsiva GETOBJXML che si occupa dell'inserimento effettivo dei dati nelle EDI_TABLES.  
  
Al terzo step è prevista un'eventuale fase di manutenzione dei dati appena inseriti nelle 
EDI_TABLES. Il batch standard GSVA_BI3 consente di gestire la modifica dei dati attraverso 
apposite maschere che rappresentano una finestra di visualizzazione dei dati presenti nelle 
EDI_TABLES relativi ad una determinata elaborazione. L'utente tramite un'interfaccia abb astanza 
intuitiva può fare modifiche e confermare i dati in modo tale che vengano aggiornate le 
EDI_TABLES.  
  
L'ultimo step consiste nel passaggio dei dati al generatore documentale. L'algoritmo standard 
(GSVA_BCD) prevede che le EDI_TABLES siano semplicem ente un archivio di transizione con 
tabelle/campi corrispondenti a quelli utilizzati dai documenti. Nel caso siano state mappate 
informazioni aggiuntive, queste dovranno essere gestite mediante personalizzazione del programma.  
  
Le EDI_TABLES sono presenti  fisicamente sul database solo se è stata lanciata l'utility di 
aggiornamento/creazione.


key: chroma:document
string_value:
aggiornamento/creazione.  
  
Quando la procedura di importazione va a buon fine, i file correttamente elaborati vengono spostati 
nella cartella indicata dall'utente nei parametri EDI.  
  
Affinché  il programma riesca ad interpretare in modo corretto i file che si intendono importare è 
necessario aver predisposto in modo corretto la struttura EDI che ovviamente funge da chiave di 
lettura. E' sufficiente adottare determinate convenzioni (diverse a se conda che si tratti di file XML 
oppure in standard Edifact testuale) per assicurare la corretta interpretazione dei file.  
  
Convenzioni da adottare per l'import di file EDI  
1. E' necessario individuare gli elementi di rottura di una struttura EDI. Si tratt a degli elementi che 
devono determinare l'inizializzazione di un nuovo progressivo, ovvero l'inserimento di un nuova riga 
nella tabella principale dei documenti (MVSERIAL), delle righe documento (CPROWNUM), delle 
rate documento (RSNUMRAT), delle matricole (MTCODMAT). In sostanza l'elemento di rottura fa 
capire al programma quando è il momento di cambiare il progressivo, ad esempio perché il valore 
incontrato sul file è relativo ad un nuovo documento, ad una nuova riga del documento, ad una nuova 
rata del do cumento o ad una nuova matricola. Il check che identifica gli elementi di rottura 
(ovviamente sull'anagrafica elementi di una struttura EDI) deve essere attivato su elementi diversi a 
seconda che si tratti di strutture Edifact o XML:  
 Edifact e Lunghezza Fissa: l'elemento di rottura deve essere individuato tra quelli che 
determinano l'inizio di un segmento, ovvero tra quelli che in genere iniziano la riga di un file (ad 
esempio UNH per i dati di testata e LIN per quelli di dettaglio);  
 XML: l'elemento di rottura deve essere ricercato in un elemento foglia, ovvero esattamente su 
uno degli elementi che deve essere scritto sul database. Ad ogni occorrenza dell'elemento foglia


