# embedding_metadata

key: chroma:document
string_value:
Specificando il tipo sede sul proc esso, la procedura effettua i seguenti controlli:  
 Se nell'anagrafica dell'intestatario del documento da processare esiste una sede con la stessa 
tipologia specificata nel processo (ad esempio, fatturazione) la procedura considera l'indirizzo ivi 
specific ato, se presente ( ignorando perciò quello generico eventualmente presente nella cartella 
principale dell'anagrafica) altrimenti il processo non risulterà eseguibile e verrà segnalata la 
mancanza dell'indirizzo e -mail della sede nel dettaglio del processo;  
 Se nell'anagrafica dell'intestatario del documento da processare non è stata definita una 
tipologia sede uguale a quella del processo documentale, la procedura verifica che sia presente 
un indirizzo nei dati anagrafici generali e solo in caso contrario i l processo documentale non 
risulterà eseguibile;


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – D O C U M E N T  M A N A G E M E N T  
P R O C E S S O  D O C U M E N T A L E  - 15  Codice sede  
In questo campo è possibile inserire l'espressione Visual Fox Pro che restituisca come risultato il 
codice della sede di riferimento . In questo modo la procedura ricava l'indirizzo da utilizzar e per l'invio 
del documento direttamente dalla Sede di destinazione merce inserita sul documento interessato dal 
processo documentale.  
  
Specificando il codice sede sul processo, la procedura effettua i seguenti controlli:  
 Se nel documento è stata specif icata una sede, il programma ricerca l'indirizzo e -mail sulla 
stessa sede dell'anagrafica cliente/fornitore e lo utilizza per l'invio. Se tale indirizzo non esiste il 
processo non risulterà eseguibile e sarà segnalato come tale nel dettaglio del processo;  
 Se nel documento non è stata definita alcuna sede la procedura ricerca l'indirizzo 
eventualmente indicato nei dati anagrafici principali e solo in mancanza di questo il processo 
non risulterà eseguibile  
  
L'inserimento di un valore nel campo Codice sede fa si che automaticamente venga portato a Nessuna quanto 
specificato come valore nella combo box Tipo sede.  
I due dati sono gestiti in modo esclusivo: si utilizza il Tipo sede oppure il Codice sede  
  
 Per conto di  
In questo campo è possibile inserire l'e spressione Visual Fox Pro che restituisca come risultato il 
cliente per conto del quale si effettua la vendita (ad esempio, MVCODORN, che rappresenta il 
campo del cursore di stampa che contiene il codice del cliente inserito nel Per conto di sul 
documento) . L'utilizzo del campo Per conto di sia sul processo documentale, sia sul documento, 
consente di inviare la stampa all'intestatario del documento stesso e/o al cliente per contro del quale si 
effettua la vendita (il soggetto per conto di è quello che dovrà  ricevere la fattura).


key: chroma:document
string_value:
effettua la vendita (il soggetto per conto di è quello che dovrà  ricevere la fattura).  
  
Per poter inserire il Per conto di sul processo documentale è comunque necessario valorizzare il campo Intestatario. 
Un processo documentale così impostato consente di gestire l'invio simultaneo della stampa all'intestatario e al 
soggetto Per conto di: entrando nei dettagli del processo prima dell'esecuzione, si potranno riscontrare almeno due 
righe relative allo stesso documento, una per l'intestatario e una per il soggetto Per conto di con l'evidenza delle 
attività che possono ess ere portate a termine.  
  
Specificando il Per conto di sul processo, la procedura effettua i seguenti controlli:  
 Se l'espressione inserita sul campo del processo restituisce il codice di un intestatario, la 
procedura ricerca per tale soggetto i dati per l 'invio della stampa ed esegue il processo. Se i dati 
per l'invio non sono disponibili, allora il processo non sarà eseguibile per il soggetto Per conto 
di e ne sarà data evidenza nel dettaglio del processo stesso.  
 Se l'espressione restituisce un valore Vuoto (perché sul documento non è presente il soggetto 
Per conto di) il processo documentale non sarà eseguibile per impossibilità di valutazione del 
destinatario.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N – D O C U M E N T  M A N A G E M E N T  
16 – P R O C E S S O  D O C U M E N T A L E  Nel caso in cui si sia parametrizzato un processo documentale che prevede l'invio di file  a Cpz e nel processo in 
questione si sia valorizzato il campo Per conto di, la procedura proporrà nel dettaglio del processo il codice di errore 
97- [Servizi Corporate Portal] Intestatario (per conto di) non abilitato per invio a Corporate Portal da proce sso 
documentale (warning di colore giallo).  
Ciò significa che il record nella divulgazione dati verrà comunque prodotto, ma i permessi eventualmente inseriti 
nella divulgazione per l'intestatario Per Conto di non risulteranno valutabili da Corportate Porta l (perché non 
gestito).  
  
 Oggetto e Testo  
In questi campi possono essere inserite espressioni Visual Fox Pro per la costruzione parametrica di 
stringhe sulla base dei dati presenti sul cursore di stampa. Il risultato delle espressioni viene utilizzato 
per l'oggetto ed il testo de lle e-mail, per i dati di frontespizio del fax (se deve essere stampato) e per 
l'archiviazione documentale nel qual caso vengono utilizzati rispettivamente per descrizione e note 
aggiuntive dell'indice documento generato.  
 Filtro avanzato  
In questo campo è possibile definire delle condizioni (tramite espressione Visual Fox Pro) al verificarsi 
delle quali il processo verrà eseguito, in caso contrario, il processo evidenzierà nel dettaglio che 
l'esecuzione dell'attività non è eseguibile perché la condizione indicata come filtro avanzato non è 
soddisfatta. Ad esempio, per far si che un processo relativo alle stampe dei documenti possa essere 
eseguito solo per i clienti è sufficiente definire come filtro avanzato: MVTIPCON='C'.  
  
Processi documentali - Autorizz azioni  
  
Una volta definite le attività eseguibili nell'intero processo è possibile definire le autorizzazioni


key: chroma:document
string_value:
affinché le attività possano o non possano essere lanciate da determinati utenti della procedura. E' 
possibile abilitare utenti e/o gruppi all'es ecuzione delle attività di processo e, eventualmente, definire 
condizioni particolari per quanto riguarda il filtro avanzato combinando l'effetto di tale filtro con 
quello presente nella maschera principale del processo.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – D O C U M E N T  M A N A G E M E N T  
P R O C E S S O  D O C U M E N T A L E  - 17 
 
Processi documentali - Autorizz azioni  
  
 Sequenza  
Ogni riga relativa a filtri ed attività del processo ha un numero di sequenza, al fine di indicare alla 
procedura l'ordine di valutazione dei filtri. La sequenza incide anche sull'ordine di visualizzazione.  
  
Per ogni stampa vengono con siderate solo le autorizzazioni della prima riga per la quale le condizioni di filtro sono 
soddisfatte).  
  
 Soggetto  
Le autorizzazioni all'esecuzione delle attività possono essere relative ad Utente o Gruppo.  
 Utente -Gruppo  
Identifica il numero dell'uten te o del gruppo (in base all'impostazione del campo precedente) per il 
quale attuare il filtro.  
 Filtro Avanzato  
Al pari dell'omonimo campo sulla maschera principale del processo, è possibile definire delle 
condizioni (tramite espressione Visual Fox Pro) al verificarsi delle quali il processo verrà eseguito, in 
caso contrario, il processo evidenzierà nel dettaglio che l'esecuzione dell'attività non è eseguibile 
perché la condizione indicata come filtro avanzato non è soddisfatta. La combo box consente di 
definire il rapporto tra questo filtro e quello sulla pagina principale: le condizioni possono essere 
abbinate in modalità And (devono essere valide entrambe), Or (almeno una delle due valida) o 
Sovrascrive (la seconda condizione sostituisce la prima).


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N – D O C U M E N T  M A N A G E M E N T  
18 – P R O C E S S O  D O C U M E N T A L E   Check Stampante, Fax, E -Mail, Net -Folder, Posta Lite, Cpz, 
Archiviazione, Anteprima  
Questi check  dettagliano le attività che possono essere eseguite dall'utente che lancia la stampa legata 
al processo documentale. La logica seguita è simile a quella già adottata per definire i privilegi di 
accesso sulle maschere: (sicurezza procedure): se non è presente nessuna autorizzazione tutti gli utenti 
eseguono tutte le operazioni previste; se si inserisce una sola riga di autorizzazione allora potranno 
eseguire le  attività solo i soggetti esplicitamente autorizzati (gli utenti amministratori non fanno 
eccezione).


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – D O C U M E N T  M A N A G E M E N T  
P R O C E S S O  D O C U M E N T A L E  - 19  Processi documentali infopublisher  
  
Questa funzionalità è disponibile solo in presenza del  modulo Inforeader/Infopublisher e consente di 
parametrizzare processi documentali che permettono di inoltrare report Infopublisher di tipologia 
standard via e -mail e di gestire eventualmente l'archiviazione automatica degli stessi.  
  
La pubblicazione dei dati da Infopublisher presuppone la predisposizione di una Query di rottura che 
ha lo scopo di generare più report da una sola query infopublisher, ognuno dei quali avrà uno 
specifico destinatario in modo tale che ognuno di essi possa ricevere solo i dati di sua competenza (ad 
esempio, pubblicazione dei dati del venduto con query di rottura che spezzi il flusso per agente o per 
cliente). A tal fine è però necessario configurare opportunamente anche la query infopublisher per 
quanto riguarda i filtri standar d: nella fattispecie agenti, occorrerà impostare un filtro per la 
dimensione agente per evitare che i report generati contengano i dati di tutti gli agenti anziché solo 
quelli del destinatario (come approfondito più avanti).  
  
Processi documentali infopubl isher - Processo  
  
 
Processi documentali infopublisher - Processo  
  
L'anagrafica dei processi documentali infopublisher è per la maggior parte dei dati analoga a quella dei 
processi documentali standard. Le uniche differenze sostanziali sono:  
 Le attivit à che possono essere eseguite da process o sono solamente l'invio e -mail e 
l'archiviazione;


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N – D O C U M E N T  M A N A G E M E N T  
20 – P R O C E S S O  D O C U M E N T A L E   Le attività sono sempre rieseguibili (il check non è editabile ed attivo di default);  
 Al posto della sezione Report è presente la sezione Query Infopublisher che  consente di 
Agganciare un processo documentale alla pubblicazione Infopublisher;  
 La selezione di Lingua, Tipo sede, Codice sede e Per conto di non è possibile.  
  
Per ogni query Infopublisher deve essere definito un solo processo documentale. La procedur a avverte 
dell'incongruenza con apposito messaggio.  
  
 Query di rottura  
In questo campo è necessario indicare la query da utilizzare per l'individuazione degli elementi di 
rottura del report infopublisher che viene processato. Ad esempio, per inviare il r eport ad ogni agente, 
basterà definire come query di rottura una semplice query che estragga l'elenco degli agenti (può 
anche essere utilizzata la query standard utilizzata per la visualizzazione zoom dell'anagrafica agenti). 
L'alias della query utilizzato  per il codice agente, dovrà essere utilizzato sul campo Intestatario. Nel 
caso specifico si potrebbe utilizzare come query di rottura per l'elenco degli agenti la 
GSAR0AGE.VQR (presente nell'installazione standard di ad hoc) e definire nel campo Intestata rio la 
concatenazione A+AGCODAGE (dove AGCODAGE corrisponde all'alias della query di rottura). Il 
file generato per l'invio tramite e -mail è determinato dal normale nome della query infopublisher 
seguito da una parte casuale che ne garantisce l'univocità. Nel caso in cui il processo preveda anche 
l'archiviazione documentale, il nome del file archiviato sarà uguale a:  
<Codice_Processo>_<Intestatario>.irp  
 Intestatario  
Indica l'insieme di campi, combinati con un'espressione Visual FoxPro che restituisce come risultato 
tipologia e codice dell'intestatario al quale può essere inoltrato il report Infopublisher.


key: chroma:document
string_value:
tipologia e codice dell'intestatario al quale può essere inoltrato il report Infopublisher.  
  
Nel caso in cui sia necessario inviare al dest inatario solamente i dati di sua competenza (ad esempio invio all'agente 
del venduto filtrando sui documenti a lui riferiti) la definizione della sola query di rottura non è sufficiente. E' 
indispensabile definire anche i Filtri standard sulla query infopu blisher utilizzata.  
  
Ad esempio, nel caso di invio report del venduto agli agenti, se l'alias della query di rottura che 
contiene il codice agente si chiama AGCODAGE, sulla query infopublisher per la dimensione 
corrispondente al codice agente (ad esempio D_AGCODAGE) occorrerà impostare il filtro 
AGCODAGE.  
  
 
Query di rottura (GSAR0AGE.vqr)  
  
Presupposto fondamentale per impostare i filtri standard è conoscere almeno il nome delle 
dimensioni utilizzate nel Mart relativo alla query Infopublisher: a tal fine  è sufficiente aprire 
Inforeader selezionando la query per la quale si intendono impostare i filtri e cliccare sul bottone 
Gestione Codici e Descrizioni.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – D O C U M E N T  M A N A G E M E N T  
P R O C E S S O  D O C U M E N T A L E  - 21   
 
Filtri Standard query Infopublisher  
  
La funzione di pubblicazione dati Infopublisher consentirà d i dare avvio al processo documentale per 
tutte le query per le quali è previsto il processo. Le query con processi documentali associati sono 
contraddistinte dalla colorazione gialla. Per queste query viene eseguito esclusivamente il processo 
documentale e  non anche la generazione del file previsto sulla query infopublisher come file di 
destinazione.  
  
 
Pubblicazione dati Infopublisher.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N – D O C U M E N T  M A N A G E M E N T  
22 – P R O C E S S O  D O C U M E N T A L E  Per le query infopublisher associate a processi documentali non solo è possibile consultare il Log della 
pubblicazione ma anche il dettaglio del processo.  
  
 
Visualizzazione dettaglio processo documentale  
  
Nel caso in cui per l'utente che effettua la pubblicazione sia stata impostata la visualizzazione dell'e -mail a Sempre 
(nei Servizi fax/mail/postalite), il processo do cumentale infopublisher ignora tale parametrizzazione.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – D O C U M E N T  M A N A G E M E N T  
P R O C E S S O  D O C U M E N T A L E  - 23  Log esecuzione processo 
documentale  
  
Per ogni processo documentale eseguito il programma memorizza un log dettagliato che fornisce le 
informazioni su ogni attività dello stesso evidenziando immediatamente quelle andate a buon fine e 
quelle non eseguite.  
  
Dopo aver selezionato un determinato processo è possibile lanciare la ricerca ed ottenere l'elenco 
delle attività corrispondenti. La gesti one è sostanzialmente identica a quella che viene visualizzata 
cliccando sul bottone Dettagli dalla print system di esecuzione del processo (in più esiste la possibilità 
di intervenire sulle selezioni)  
  
Il log viene archiviato solo per i processi document ali per i quali è stato attivato il check Mantieni Log 
nell'anagrafica del processo stesso, quindi, presupposto per interrogare la situazione delle attività dei processi eseguiti 
è aver attivato tale opzione.  
  
Il cruscotto a disposizione evidenzia con div ersa colorazione le operazioni previste ed eseguite 
correttamente (in verde) e quelle eseguite con errori o avvertenze (rosso o giallo), con indicazione del 
codice di errore o di avvertenza.  
  
Tramite il bottone Legenda è possibile visualizzare il signific ato dei codici di errore presenti sulle 
attività del processo fallite o terminate con avvertenze.  
  
 
Log Esecuzione Processo documentale


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N – D O C U M E N T  M A N A G E M E N T  
24 – P R O C E S S O  D O C U M E N T A L E   Processo  
Codice del processo del quale si desidera verificare il log.  
 Utente  
Inserendo il codice utente verranno  visualizzate solo le attività di processi documentali da lui lanciati.  
 Data  
Data di esecuzione dei processi da visualizzare in elenco  
 Intestatario  
L'opzione di default di tale combo box è No filtro, tuttavia, è possibile ricercare solo i processi 
documentali relativi a Clienti, Fornitori, Agenti o Nominativi.  
In questi casi è anche possibile filtrare su uno specifico codice indicandolo nel campo che compare 
accanto alla combo box.  
 Ricerca  
Premendo questo bottone viene aggiornato l'elenco in base ai filtri di selezione impostati.  
 Legenda  
Premendo il bottone legenda si ottiene l'elenco di tutti i possibili errori derivanti dal processo.  
 Stampa  
Col bottone stampa si ottiene il report delle attività eseguite.


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


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


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – D O C U M E N T  M A N A G E M E N T  
A R C H I V I A Z I O N E  D O C U M E N T A L E  - 27  ARCHIVIAZIONE 
DOCUMENTALE  
  
Il processo di archiviazione documentale può essere scomposto genericamente in diverse parti:  
 Produzione file da archiviare: i file oggetto di archiviazione possono avere due ori gini: 
 - File di produzione interna: i file vengono generati da un Processo Documentale 
(ovvero passano dalla Print System della procedura; sono in formato PDF).  
 - File di produzione esterna: sono tutti quei file che non vengono originati direttamente 
dal processo documentale: documenti Word, PDF, grafici, immagini. Questi file possono 
essere archiviati attraverso un'apposita funzione della procedura (manutenzione Indice 
Documenti). I file di produzione esterna sono associabili direttamente a singoli recor d 
degli archivi della procedura (soprattutto anagrafiche), alla stregua di quanto è possibile 
fare attraverso la Gestione allegati standard disponibile limitatamente ad alcune 
anagrafiche (primanota, articoli, documenti, gruppi merceologici). In presenza d el 
modulo Document Management l'application bar presenta specifici bottoni per 
l'associazione/la ricerca dei file da archiviare/archiviati da legare/legati ad un 
determinato record: archiviazione da file, archiviazione da periferica Twain (scanner, 
webcam, ), ricerca file archiviati.  
  
 Definizione attributi di archiviazione: per ciascun file da archiviare è necessario definire 
almeno un attributo di archiviazione, allo scopo di identificare la classe documentale di 
riferimento ed i parametri per la success iva ricerca.  
 - Classe Documentale: la classe documentale di riferimento determina il percorso di 
memorizzazione del file (viene creata una cartella per classe documentale, eventualmente 
suddivisa in sottocartelle per tipologia/classe allegato e periodo: s ettimana, mese, ecc.), le


key: chroma:document
string_value:
suddivisa in sottocartelle per tipologia/classe allegato e periodo: s ettimana, mese, ecc.), le 
modalità di archiviazione ed i parametri di ricerca (attributi).  
 - Compilazione Parametri (attributi): i parametri di ricerca possono essere assegnati in 
modo automatico dalla procedura oppure manualmente da parte dell'utente med iante 
un'apposita maschera di imputazione (manutenzione Indice Documenti). Si possono 
distinguere due modalità di compilazione:  
- Automatica: per i file di produzione interna (originati da un processo 
documentale) i parametri vengono valorizzati automatica mente in base sia ad 
un'associazione con i campi del cursore di stampa, sia a valori predefiniti impostati 
nella classe documentale. La compilazione sarà semi -automatica, richiedendo 
un'imputazione manuale da parte dell'utente, solo nel caso le associazion i con i 
campi del cursore di stampa ed i valori predefiniti fossero insufficienti.  
- Manuale: i file di produzione esterna possono richiedere un'imputazione manuale 
dei parametri di ricerca, salvo quelli determinabili dall'anagrafica del record per il 
quale si sta creando un nuovo indice documento.  
  
 Processo di archiviazione del file: i file da archiviare devono essere memorizzati all'interno di 
una cartella con un percorso definito sulla classe documentale oppure possono essere inoltrati 
ad un server EDS (Extended Document Server) che rappresenta u n sistema di archiviazione


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N – D O C U M E N T  M A N A G E M E N T  
28 – A R C H I V I A Z I O N E  D O C U M E N T A L E  esterno con il quale si può integrare ad hoc e che consente di avere uno o più archivi di allegati 
criptati e compattati gestiti in modo del tutto trasparente da parte degli utenti del gestionale.  
  
In assenza di un server EDS, il percorso di memorizzazione viene definito dalla classe documentale, 
componendo il percorso standard della classe (ad esempio C: \Documenti \Fatture), le eventuali 
sottocartelle relative a tipologia/classe allegato e periodo di raggruppamento 
(C:\Documenti \Fatture \DOC \DOCUM \2006).  
Con l'archiviazione fisica del file viene inserito un nuovo record nell'archivio Indice Documenti, nel 
quale vengono memorizzati tutti i riferimenti dei file archiviati ivi inclusi metodo/percorso di 
archiviazione, nome file, attr ibuti.  
  
Quando per un record di un determinato archivio viene eseguita un'archiviazione manuale o 
automatica, la maschera corrispondente visualizzerà nella parte in alto a destra l'icona di una Graffetta 
con il numero di file referenziati nella tabella de gli indici documenti.  
  
 
Archiviazione documentale  
  
 Associazioni dei file archiviati: i file archiviati, catalogati in base a diversi attributi, possono 
essere associati ai record del gestionale seguendo due modalità distinte. Inoltre, configurando in 
modo opportuno gli attributi della classe documentale è possibile associare lo stesso indice 
documento ad anagrafiche diverse:  
 - Associazione da processo documentale: si tratta dei documenti di provenienza interna 
per i quali viene eseguita l'archiviazion e (solo se prevista da processo) grazie 
all'indicazione sul processo stesso di una determinata classe documentale. In base ai 
parametri di quest'ultima verranno generati automaticamente dei file PDF ricercabili 
tramite gli attributi e visualizzabili come a llegato di uno o più record di archivi diversi: ad


key: chroma:document
string_value:
tramite gli attributi e visualizzabili come a llegato di uno o più record di archivi diversi: ad 
esempio, una fattura prodotta in formato PDF può diventare allegato del documento dal


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – D O C U M E N T  M A N A G E M E N T  
A R C H I V I A Z I O N E  D O C U M E N T A L E  - 29 quale è stata generata e, contestualmente, del cliente intestatario e dell'agente che ha 
realizzato la vendita.  
  
In tal caso i valori degli attributi vengono determinati sulla base del cursore di stampa, quindi i campi della classe 
documentale devono essere stabiliti tenendo conto di ciò che mette a disposizione quest'ultimo.  
  
 - Associazione diretta da file o da perife rica Twain: in questo caso, utilizzando gli appositi 
bottoni (sulla maschera dell'archivio, se disponibili, oppure sull'application bar) è possibile 
procedere all'associazione di file (generati contestualmente nel caso di acquisizione da 
periferiche Twain)  attraverso la creazione automatica di indici documento con classe 
documentale predefinita o selezionata sul momento.  
  
In tal caso i valori degli attributi vengono determinati sulla base dell'archivio di partenza, quindi i campi della 
classe documentale d evono essere stabiliti tenendo conto di ciò che mette a disposizione quest'ultimo.  
  
Una volta installato il modulo Document Management all'utente sarà proposta una application bar 
arricchita dei bottoni relativi all'archiviazione e alla visualizzazione.  
  
 
Barra delle Applicazioni  
  
Tali bottoni risultano utilizzabili per i record presenti in archivi per i quali sono state definite delle 
classi documentali. In caso contrario, comparirà un messaggio a video.  
Non sono state definite classi documentali per t abella.  
 Visualizza documenti associati  
Il bottone Visualizza Documenti Associati non fa altro che aprire la maschera di ricerca documenti 
archiviati, con la valorizzazione automatica dei campi di ricerca (tabella e chiave) sulla base del record 
seleziona to sulla maschera attiva (ad esempio, articolo XYZ della tabella ART_ICOL).


key: chroma:document
string_value:
seleziona to sulla maschera attiva (ad esempio, articolo XYZ della tabella ART_ICOL).  
  
La tabella che viene proposta come parametro di ricerca sulla visualizzazione dei documenti associati è, ovviamente, 
quella utilizzata dall'archivio di partenza (ad esempio, CONT I se la maschera attiva è quella dei Clienti), 
mentre, nel campo chiave, il programma propone la concatenazione dei campi chiave della stessa tabella (nel caso di 
un cliente, il contenuto dei campi ANTIPCON+ANCODCON). NB: è per questo motivo che le classi 
documentali fornite con il gestionale ed associate ai processi relativi alle stampe documenti (fatture differite, DDT) 
prevedono la valorizzazione del nome campo relativo all'intestatario come concatenazione di 
MVTIPCON+MVCODCON (i campi presenti sul curso re di stampa).  
  
 Nuovo documento  
Questo bottone permette di creare un nuovo allegato del record selezionato sulla finestra attiva (ad 
esempio un certo cliente oppure un certo articolo) sulla base di un documento ed eventualmente di 
una query che può essere utilizzata per  estrarre informazioni da scrivere direttamente sul documento 
generato contestualmente. Ad esempio, dopo aver aperto una determinata gestione ed aver


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N – D O C U M E N T  M A N A G E M E N T  
30 – A R C H I V I A Z I O N E  D O C U M E N T A L E  selezionato un record, è possibile generare un documento su Microsoft Word oppure su OpenOffice 
partendo d a un altro documento ove sono presenti Segnalibri che verranno sostituiti dagli alias della 
query collegata al modello. In questo modo è possibile, sempre a titolo di esempio, richiamare un 
determinato articolo dall'apposita anagrafica e generare la scheda  prodotto attraverso l'inserimento sul 
documento dei dati già presenti sull'anagrafica (dati tecnici, commerciali, descrizioni, note) ed anche 
dell'immagine (allegato principale).  
Dopo aver aperto una gestione ed aver selezionato un record (ad esempio gest ione articoli, record 
AHRB), cliccando sul bottone Nuovo documento comparirà una maschera di passaggio dati per la 
selezione della classe documentale (ne deve esistere almeno una di tipo Standard o Default) e del 
modello da utilizzare (caricato preventivam ente in apposita anagrafica). Da tale maschera è anche 
possibile aprire il documento collegato al modello.  
  
 
Maschera di passaggio dati per creazione Nuovo documento  
  
 
Nuovo documento  
  
Confermando le selezioni verrà creato un nuovo Indice documento pe r il record di riferimento.  
 Archivia  
Premendo il bottone Archivia dopo aver selezionato un record di un determinato archivio oppure


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – D O C U M E N T  M A N A G E M E N T  
A R C H I V I A Z I O N E  D O C U M E N T A L E  - 31 indicando successivamente una classe documentale (nel caso non ci sia nessuna gestione aperta), viene 
proposta la maschera standard di apertura file d el sistema operativo (previa indicazione di una 
determinata classe documentale, a meno che non ne esista una di tipo Standard, perché il tal caso la 
classe documentale è predefinita e non selezionabile). L'utente può navigare nelle cartelle per la 
selezion e del file da archiviare. Dopo la selezione viene immediatamente creato un nuovo Indice 
documento con dati modificabili sul momento (archivio in modalità Modifica del record appena 
inserito). In base alle caratteristiche della classe documentale si potrà o  meno confermare 
immediatamente il nuovo record. Se gli attributi obbligatori non sono stati tutti valorizzati comparirà 
un messaggio di avviso.  
 Archiviazione Rapida da periferica Twain (scanner, webcam)  
Oltre alla possibilità di archiviare mediante sele zione manuale del file, esiste la possibilità di procedere 
all'archiviazione mediante utilizzo di una periferica Twain (scanner, webcam). Premendo il bottone 
apposito dell'application bar o sulla maschera (se presente, come nell'anagrafica articoli, client i, 
fornitori), il programma consente di procedere alla cattura in modalità Acquisizione singola oppure 
Acquisizione multipla: nel primo caso il programma crea un file immagine mentre nel secondo caso 
crea un file PDF dato dall'insieme dei documenti Cattura ti. La stessa operazione è consentita anche 
senza aver selezionato preventivamente un record da una determinata gestione.  
  
 
Anagrafica articoli –Tipo Acquisizione  
  
Affinché sia possibile procedere all'archiviazione da periferica Twain è consigliabile in dicare preventivamente lo 
specifico dispositivo da utilizzare nell'archivio Dispositivi Installati. La procedura permette di selezionare il


key: chroma:document
string_value:
dispositivo tra quelli installati nel sistema operativo. In ogni caso, se il dispositivo da utilizzare non è stato 
predefinito, il programma permette di selezionarlo sul momento. Non è possibile archiviare da periferica Twain se la 
classe documentale che si intende utilizzare ha impostato come tipo di archiviazione Collegamento.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N – D O C U M E N T  M A N A G E M E N T  
32 – A R C H I V I A Z I O N E  D O C U M E N T A L E    
Le informazioni sui dispositivi install ati vengono memorizzati su un file di configurazione creato dal 
programma nella cartella temporanea della macchina in uso (Es.: C: \Documents and 
Settings \NomeUtente \Impostazioni locali \Temp ).  
  
Il file creato è: AHE_DISP .CNF  e contiene la seguente variab ile: 
  
Public g_SCANNER  
g_SCANNER=" Codice Scanner installato " 
  
 
Selezione Scanner  
  
Nel caso in cui non si sia proceduto alla selezione del dispositivo Twain la procedura, alla selezione del 
bottone di archiviazione rapida da periferica Twain, dopo la se lezione della classe documentale, 
propone la maschera di selezione origine nella quale è necessario specificare il dispositivo da utilizzare 
per l'archiviazione.  
  
 Classi do cumentali  
 Indice documenti  
 Tipologie e classi allegati


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – D O C U M E N T  M A N A G E M E N T  
A R C H I V I A Z I O N E  D O C U M E N T A L E  - 33  Estensioni allegati  
 Modelli documenti  
 Ricerca documenti archiviati   
 Blocco modifica allegati definitivi


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N – D O C U M E N T  M A N A G E M E N T  
34 – A R C H I V I A Z I O N E  D O C U M E N T A L E   Classi documentali  
  
In qu esta gestione è possibile definire le classi documentali da utilizzare ai fini dell'archiviazione dei 
documenti generati dalla procedura oppure provenienti dall'esterno. Le classi consentono di definire 
delle categorie omogenee di file che avranno in comun e le modalità di archiviazione (percorso, 
attributi).  
  
Classi documentali - Classe documentale  
  
 
Classi documentali - Classe documentale  
  
 Classe Documentale  
Codice e descrizione della classe documentale.  
 Predefinita  
Se è attivo, la classe è il rife rimento per l’invia a.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – D O C U M E N T  M A N A G E M E N T  
A R C H I V I A Z I O N E  D O C U M E N T A L E  - 35  Tipo Archiviazione  
L'archiviazione di un documento (file) può avvenire in modo automatico, semi -automatico o manuale. 
La prima modalità è possibile solo se tutti i parametri necessari per l'archiviazione sono determinabili 
senza in tervento dell'utente, in caso contrario, anche se il tipo di archiviazione è impostato su 
Automatica sarà necessario l'intervento da parte dell'utente (ad esempio per l'indicazione di un 
attributo obbligatorio altrimenti non determinabile) ed è per questo che si può parlare di archiviazione 
semi-automatica. Quella manuale richiede sempre l'intervento da parte dell'utente per la conferma 
dell'indice documento. I valori che può assumere la combo box sono:  
 Automatica: l'archiviazione di un nuovo documento sarà confermata senza l'apertura della 
maschera di manutenzione dell'indice documento, cosa possibile solo se tutti i parametri definiti 
come obbligatori sono valorizzati (tramite collegamento col cursore  di stampa oppure mediante 
valori predefiniti). La classe documentale è sempre obbligatoria e non viene richiesta se ne esiste 
una Standard (archiviazione di documenti esterni) oppure se la classe è legata al processo 
documentale (archiviazione di document i generati dalla procedura). Il nome file è sempre 
presente (per definizione), la data di archiviazione è valorizzata con quella di sistema ed il tipo 
file è costituito dal suffisso o estensione del nome file.  
 Manuale: in questo caso la maschera di manutenzione indici documento sarà sempre aperta 
per conferma, indipendentemente dalla valorizzazione degli attributi di archiviazione.  
 Modalità  
La modalità di archiviazione consente di definire se per il file da archiviare deve essere effettuata una 
copia in un percorso predeterminato, se deve essere creato solo l'indice che punta alla posizione


key: chroma:document
string_value:
copia in un percorso predeterminato, se deve essere creato solo l'indice che punta alla posizione 
originale del file, oppure, se il file deve essere archiviato in un server EDS. Le modalità previste dalla 
combo box son o: 
 Collegamento: è possibile legare il record ad un file specifico in questa maniera l'allegato 
rimane nella sua posizione originaria.  
 Copia File: in questo caso il file di riferimento viene duplicato nel percorso predefinito sulla 
classe stessa con nome determinato in modo cablato. Occorre distinguere i seguenti casi:  
 Archiviazione documenti generati dalla procedura (da processo documentale): in 
questo caso il nome del file archiviato è composto da <Codice Processo>_<Campo 
Chiave Processo>.pdf per le st ampe e da <Codice Processo>_<Campo Intestatario 
Processo>.* per la pubblicazione dati infopublisher  
 Archiviazione documenti preesistenti (compreso il caso di Nuovo documento da 
modello): in questo caso il nome del file è composto da <Seriale Indice 
docum ento>_<Tabella di riferimento Classe documentale>_<Codice record di 
riferimento>.*  
 Extended document server: in questo caso la classe documentale prevede la gestione degli 
allegati attraverso un server EDS. In tal caso i dati da indicare sulla gestione v engono modificati 
in modo sostanziale (vedere apposita sezione).  
 Infinity D.M.S.  
 Archiviazione rapida  
Definisce la funzione della classe documentale indicata durante l'operazione di archiviazione rapida. 
Quindi, questo parametro non incide sul comport amento della procedura per l'archiviazione da 
processo documentale, ma solo per l'archiviazione di file preesistenti o generati da modello (nuovo 
documento) cliccando sull'apposito bottone presente sull'application bar o su alcune gestioni (ad 
esempio, art icoli, clienti, documenti). I valori selezionabili sono:  
 Non presente: la classe è utilizzabile solo  da processo documentale;


key: chroma:document
string_value:
 Non presente: la classe è utilizzabile solo  da processo documentale;  
 Selezionabile: la classe compare nell'elenco sulla maschera di archiviazione rapida e l'utente 
può selezionarla, ma non viene proposta in modo automatico;  
 Default: questa classe è  selezionabile e viene proposta sulla maschera di archiviazione rapida 
presentata all'utente;


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N – D O C U M E N T  M A N A G E M E N T  
36 – A R C H I V I A Z I O N E  D O C U M E N T A L E   Standard: all'utente non viene presentata alcuna maschera e l'archiviazione rapida utilizza 
direttamente questa classe documentale.  
 Tabella Riferimento  
La ta bella di riferimento ha lo scopo principale di individuare i contesti dai quali sarà utilizzabile la 
classe documentale in oggetto. Ad esempio, tutte le classi documentali che avranno come tabella di 
riferimento ART_ICOL saranno utilizzabili per associare file dalla gestione articoli (perché 
ART_ICOL è la tabella del database utilizzata da tale gestione). Il campo non è ovviamente editabile 
se non è prevista archiviazione rapida.  
  
Quando si clicca sul bottone di archiviazione rapida dell'application bar o delle singole gestioni 
(l'apposito bottone è presente sulle gestioni che consentono l'associazione di file anche in assenza del 
modulo Document Management), il programma ricerca le classi documentali utilizzabili in base al 
contenuto della tabella di rifer imento e propone una maschera a video per la selezione della classe 
documentale se non ne esiste una di tipo Standard (perché altrimenti utilizza quella); se non ne esiste 
una Standard compare la maschera di selezione della classe documentale ed eventualme nte viene già 
proposta quella di default (se definita) altrimenti nessuna classe documentale.  
  
 
Bottone archiviazione rapida su application bar  
  
Affinché la procedura si comporti in modo coerente non dovrebbero esistere per una determinata tabella di 
riferimento più classi documentali di tipo Standard oppure Default perché in tal caso il programma considererebbe 
la Prima che trova.  
  
 Cartella contenitore  
Questo check è utilizzabile solo per le classi documentali che hanno come modalità di archiviazione 
Copia file. Se viene attivato, quando verrà utilizzata la classe documentale in oggetto per


key: chroma:document
string_value:
Copia file. Se viene attivato, quando verrà utilizzata la classe documentale in oggetto per 
l'archiviazione rapida, il programma non aprirà il file system per la selezione di un singolo file, ma 
creerà una Cartella nella temporanea della macchina in uso allo scopo di inserirci dentro più file da 
archiviare contestualmente.  
  
Dopo aver inserito n file all'interno della cartella contenito re (_DMTMPFOLD), premendo il bottone 
di conferma, il programma procederà all'archiviazione di tutti i file creando n indici documento 
associati al record di partenza (ad esempio ad un determinato articolo).  
  
Per l'inserimento dei file all'interno della ca rtella _DMTMPFOLD occorre utilizzare le funzionalità del sistema 
operativo, ad esempio selezionando i file da archiviare da Esplora risorse di Windows, Copiando negli appunti 
(funzione Copia) ed incollando (funzione Incolla) all'interno della finestra aper ta dal programma oppure con 
trascinamento (drag'n'drop).  
Al completamento dell'operazione la cartella _DMTMPFOLD viene svuotata.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – D O C U M E N T  M A N A G E M E N T  
A R C H I V I A Z I O N E  D O C U M E N T A L E  - 37 
 
Creazione cartella contenitore nella temporanea della macchina in uso


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N – D O C U M E N T  M A N A G E M E N T  
38 – A R C H I V I A Z I O N E  D O C U M E N T A L E  
 
Inserimento più file all‘interno della cartella contenitore ad esempio tasto destro mouse e incolla  
  
 Commento archiviazione  
Nel caso di archiviazione rapida, l'utilizzo di una classe documentale che ha attivo questo check 
permette di imputare descrizione e/o note dell'indice documento (descrizione br eve ed estesa) prima 
della sua creazione effettiva. Questo check risulta utile soprattutto quando il tipo di archiviazione è 
automatica in modo tale da avere la possibilità di definire descrizione e note anche quando non è 
prevista l'apertura dell'indice d ocumento (in modifica) immediatamente dopo la sua creazione.  
  
 
Maschera per imputazione descrizione e note dell‘indice documento da creare


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – D O C U M E N T  M A N A G E M E N T  
A R C H I V I A Z I O N E  D O C U M E N T A L E  - 39 La maschera è visibile sia in caso di archiviazione singola, sia in caso di archiviazione multipla (utilizzo dell a 
Cartella contenitore). In quest'ultimo caso, ovviamente, il commento imputato è unico per tutti i file che si mandano 
in archiviazione.  
  
 Controlla esistenza dei file archiviati  
Di default attivo e modificata la funzione di ricerca documenti tenendo c onto di questo parametro.  
Il funzionamento è il seguente:  
Se il check "controlla esistenza dei file archiviati" è attivato e si valorizza la classe documentale nella 
maschera di Ricerca documenti archiviati, se uno o più file non esistono la riga dell'indi ce all'interno 
dello zoom viene colorata di rosso e l'unico bottone accessibile nella maschera ricerca documenti 
archiviati è quello per poter aprire l'indice documento di archiviazione.  
Se il check Controlla esistenza dei file archiviati è disattivato e s i valorizza la classe documentale nella 
maschera di Ricerca documenti archiviati, se uno o più file non esistono la riga dell'indice all'interno 
dello zoom non assume nessuna colorazione.  
Se all'interno della maschera di Ricerca documenti archiviati non vi ene selezionata alcuna classe 
documentale allora non viene eseguito il controllo di esistenza dei file archiviati, quindi anche i file 
non esistenti appaiono comunque su sfondo bianco.  
 Tipo raggruppamento  
Solo nel caso di utilizzo della modalità di archiviazione Copia file l'utente ha la possibilità di 
raggruppare i file archiviati per periodo andando a creare delle cartelle rispetto al percorso di 
archiviazione indicato nel campo sott ostante. A secondo del tipo di raggruppamento, il codice azienda 
(già utilizzato come sottocartella del percorso di archiviazione), sarà seguito da un suffisso variabile a


key: chroma:document
string_value:
seconda del giorno di archiviazione o di una data ricavabile dal cursore di stampa ( ad esempio, 
MVDATDOC per l'archiviazione dei documenti generati da processo documentale). Il modo di 
rappresentare l'informazione è cablato per ogni selezione, ad esempio, se la data fosse 18/06/2008, il 
percorso di archiviazione sarà seguito da:  
 Settimana: W+<Numero Settimana>+<Anno> = \DEMOW25200;  
 Mese: M+<Numero Mese>+<Anno> = \DEMOM062008;  
 Trimestre: T+<Numero Trimestre>+<Anno> = \DEMOT22008;  
 Quadrimestre: Q+<Numero Quadrimestre>+<Anno> = \DEMOQ22008;  
 Semestre: S+<Numero Semestre>+<An no> = \DEMOS12008;  
 Anno: <Anno> = \DEMO2008;  
 Nessuno: = \DEMO.  
 Su campo  
Risulta editabile solo se il tipo raggruppamento ha un valore diverso da Nessuno ed ha lo scopo di 
consentire di indicare il campo del cursore di stampa da utilizzare per determi nare la data di 
riferimento per i raggruppamenti temporali. Nel caso in cui venga lasciato vuoto, il programma 
considera come data di riferimento quella di sistema.  
 Tipologia Allegato e Classe Allegato  
Tipologia allegato e classe allegato consentono di definire ulteriori raggruppamenti per la 
classificazione degli allegati. Tipologie e classi possono essere definite nell'archivio tipologie allegati 
del sottomenù Attributi: per ogni codice tipologia è possibile definire n classi. Tali dati sono comuni a 
quanto disponibile anche in assenza del modulo Document Management con la gestione allegati 
disponibile all'interno del menù sistema. Questi dati (tipologia/classe) oltre a fornire la possibilità di 
raggruppare gli allegati (sia in base all'estensione dei f ile, sia fornendo la possibilità di creare delle 
sottocartelle all'interno del percorso di memorizzazione) consentono di definire gli attributi ai fini 
della pubblicazione degli allegati.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N – D O C U M E N T  M A N A G E M E N T  
40 – A R C H I V I A Z I O N E  D O C U M E N T A L E   Completa Path File  
I check  posti accanto ai campi Tipologia/Classe  sono editabili solo se la modalità di archiviazione è 
Copia file. Attivando tali check è possibile aggiungere delle sottocartelle al percorso di 
memorizzazione standard con il codice della tipologia e/o della classe. Ad esempio, il percorso di 
memorizzazi one potrebbe diventare:  
<Percorso archiviazione> \DEMO062008 \IMMAG \MAINM \ 
 Percorso di Archiviazione  
In questo campo deve essere indicato il percorso principale di archiviazione per gli allegati in caso di 
modalità Copia file. A tale percorso verrà aggiunta la cartella denominata con il codice azienda, 
eventualmente seguito dai  codici di raggruppamento periodo. Se previsto, il programma creerà 
ulteriori sottocartelle per tipologia e/o classe allegato come descritto precedentemente.  
  
La modifica del percorso di archiviazione sulla classe documentale permette di aggiornare in mo do automatico tutti 
gli indici documento collegati ad essa: ciò consente di spostare i file archiviati da un percorso ad un altro senza 
perdere il corretto riferimento con il gestionale. In caso di necessità di spostamento dei file è necessario creare la n uova 
cartella nel file system della macchina, modificare il percorso sulla classe documentale e spostare tutte le sottocartelle 
(del vecchio percorso di archiviazione) all'interno del nuovo percorso.  
  
 Controlla esistenza dei file archiviati  
Se il check "controlla esistenza dei file archiviati" è attivato e si valorizza la classe documentale nella 
maschera di Ricerca documenti archiviati, se uno o più file non esistono la riga dell'indice all'interno 
dello zoom viene colorata di rosso e l'unico bottone ac cessibile nella maschera ricerca documenti 
archiviati è quello per poter aprire l'indice documento di archiviazione.


key: chroma:document
string_value:
archiviati è quello per poter aprire l'indice documento di archiviazione.  
Se il check Controlla esistenza dei file archiviati è disattivato e si valorizza la classe documentale nella 
maschera di Ricerca documenti archiviati, se uno o più file non esistono la riga dell'indice all'interno 
dello zoom non assume nessuna colorazione.  
Se all'interno della maschera di Ricerca documenti archiviati non viene selezionata alcuna classe 
documentale allora non viene eseguito il  controllo di esistenza dei file archiviati, quindi anche i file 
non esistenti appaiono comunque su sfondo bianco. Sezione dettaglio della classe documentale  
La sezione di dettaglio della classe documentale contiene i campi relativi agli attributi di archi viazione 
definiti per la classe documentale. Gli attributi sono liberi e consentono di definire dei parametri da 
valorizzare, anche automaticamente, nella fase di creazione dell'indice: in questo modo sarà possibile 
effettuare la ricerca dei file in base a  tali informazioni (ad esempio ricercare tutti i file riferibili ad un 
determinato intestatario) ed avere la possibilità di creare dei legami con una o più gestioni (ad esempio 
il file PDF di una fattura potrebbe essere accessibile dalla gestione documenti  richiamando la 
corrispondente fattura, dall'anagrafica dell'intestatario della fattura, dall'anagrafica dell'agente presente 
nei dati di testata della fattura).  
 Firma digitale  
Tale flag permette di attivare la gestione della firma digitale sugli allegat i appartenenti alla relativa 
classe documentale.  
 Conservazione sostitutiva  
Tale flag identifica la classe documentale come appartenente alla gestione del modulo SOStitutiva.  
 Pubblica su Web  
Se attivo, in fase di associazione manuale, il flag permette d i pubblicare l'indice creato su Web.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – D O C U M E N T  M A N A G E M E N T  
A R C H I V I A Z I O N E  D O C U M E N T A L E  - 41  Nome file Web  
In tale campo è possibile definire un'espressione per la determinazione del nome del file da pubblicare 
su Web. Tale parametrizzazione verrà utilizzata sia in fase di normale stampa che di esecuzione del  
processo documentale. Ad esempio, per nominare il file secondo la data e l'alfa documento sarà 
necessario impostare i seguenti parametri:  
mvdatdoc+mvalfadoc  
 Cancella File  
Attivando tale check, il file creato verrà cancellato dopo la pubblicazione su We b.  
 Sequenza  
Progressivo che indica l'ordinamento degli attributi sia per la ricerca che per l'archiviazione manuale.  
 Attributo e Descrizione  
Codice e descrizione dell'attributo. Tali campi sono definibili liberamente ed hanno lo scopo di 
rappresentar e il significato del valore che sarà memorizzato in loro corrispondenza sull'indice 
documento. Sulla maschera di ricerca dei file archiviati, previa selezione della classe documentale, 
attributi e corrispondenti descrizioni saranno evidenziati in un apposi to dettaglio fornendo la 
possibilità all'utente di inserire i valori ai fini della ricerca.  
  
Il codice attributo, benché libero, non può contenere spazi o segni di punteggiatura. Per questo motivo il programma 
modifica automaticamente il codice inserito n el caso non fosse ammesso.  
  
 Tipo Campo  
Questa combo box consente di definire la tipologia di dato del valore che potrà assumere l'attributo. 
Le tipologie possibili sono Numerico, Carattere e Data.  
 Nome Campo/I  
In questo campo occorre definire il cam po o l'elenco dei campi, eventualmente combinati come 
espressione Visual Fox Pro, in modo tale da ottenere la valorizzazione automatica degli attributi e 
quindi ridurre al minimo la necessità di intervento manuale da parte dell'utente in caso di 
obbligator ietà dell'attributo stesso. Occorre distinguere almeno due casistiche:


key: chroma:document
string_value:
obbligator ietà dell'attributo stesso. Occorre distinguere almeno due casistiche:  
 Se la classe documentale è utilizzata sui processi documentali, le variabili da utilizzare sono 
quelle disponibili sul cursore di stampa: è perciò necessario verificare nome e contenuto dei dati 
estratti ai fini della stampa del documento per sapere cosa  può essere scritto in tale campo. A tal 
fine può essere utile analizzare la query utilizzata dalla stampa (alla quale si può risalire dalla 
gestione output utente);  
 Se la classe documentale è utilizzata per l'archiviazione rapida, le variabili da utiliz zare 
corrispondono al nome dei campi della tabella di riferimento.  
 Obbligatorio  
Se un attributo viene definito come obbligatorio significa che deve presentare un valore significativo 
per poter confermare un indice documento. Se gli attributi obbligatori non vengono valorizzati non è 
possibile ottenere un'archiviazione completamente automatica.  
 Tabella  
Il questo campo occorre definire il nome della tabella relativa alla gestione dalla quale si desidera poter 
accedere ai file archiviati attraverso la clas se documentale in oggetto. Tornando a quanto scritto


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N – D O C U M E N T  M A N A G E M E N T  
42 – A R C H I V I A Z I O N E  D O C U M E N T A L E  precedentemente, se il PDF di una fattura deve essere accessibile anche dall'anagrafica dell'intestatario 
della stessa occorre inserire in questo campo il valore CONTI perché è la tabella relativa alla g estione 
Clienti/Fornitori. Questa è condizione necessaria ma non sufficiente al fine di creare il legame. Altra 
condizione che deve essere soddisfatta è la seguente: il valore dell'attributo deve corrispondere alla 
concatenazione dei campi chiave della tab ella qui indicata. Nel caso dell'intestatario, per far si che tutti 
i suoi documenti siano accessibili dalla sua anagrafica, il valore dell'attributo deve essere uguale alla 
concatenazione ANTIPCON+ANCODICE (ovvero i campi chiave della tabella CONTI). Per far si 
che l'attributo assuma tale valore è necessario parametrizzare opportunamente l'espressione in Nome 
campo/I: nel caso di documenti archiviati da processo documentale l'espressione da utilizzare sarà 
MVTIPCON+MVCODCON.  
 Attributo SOS  
Tale campo risulta attivo solo nel caso in cui sia stato attivato il modulo SOStitutiva e permette di 
definire gli attributi SOS, ovvero delle sorti di chiavi descrittive. Per una trattazione più approfondita si 
rimanda al manuale Integrazi oni. 
 Valore Predefinito  
Il valore predefinito rappresenta il default dell'attributo. Se è stata impostata un'archiviazione di tipo 
automatico, i valori predefiniti sugli attributi obbligatori (assieme a quelli determinabili 
automaticamente) permettono di  eseguire un processo di archiviazione senza necessità di intervento 
da parte dell'utente.  
 Tipo SOS  
Tale campo risulta attivo solo nel caso in cui sia stato attivato il modulo SOStitutiva e permette di 
identificare la tipologia dell'attributo SOS. Per un a trattazione più approfondita si rimanda al manuale 
Integrazioni.  
 Attributo primario


key: chroma:document
string_value:
Integrazioni.  
 Attributo primario  
Se attivo identifica l'attributo SOS indicato come primario. Per una trattazione più approfondita si 
rimanda al manuale Integrazioni.  
  
Classi documentali - Autorizzazi oni 
  
Così come sui processi documentali anche sulle classi è possibile definire le autorizzazioni affinché le 
operazioni di archiviazione, visualizzazione ed eliminazione possano o non possano essere effettuate 
da determinati utenti della procedura. E' po ssibile abilitare utenti e/o gruppi per archiviazione, 
visualizzazione ed eliminazione.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – D O C U M E N T  M A N A G E M E N T  
A R C H I V I A Z I O N E  D O C U M E N T A L E  - 43 
 
Classi documentali - Autorizzazioni  
  
 Sequenza  
La sequenza rappresenta l'ordine di visualizzazione delle righe  
 Soggetto  
Le autorizzazioni all'esecuzione delle attività possono essere relative ad Utente o Gruppo.  
 Utente -Gruppo  
Identifica il numero dell'utente o del gruppo (in base all'im postazione del campo precedente) per il 
quale attuare il filtro ai fini dell'archiviazione, visualizzazione ed eliminazione.  
 Check Archivia, Visualizza, Elimina  
Questi check  dettagliano le operazioni che possono essere eseguite dall'utente che tenta di u tilizzare la 
classe documentale in oggetto. La logica seguita è simile a quella già adottata per definire i privilegi di 
accesso sulle maschere: (sicurezza procedure): se non è presente nessuna autorizzazione tutti gli utenti 
eseguono tutte le operazioni p reviste; se si inserisce una sola riga di autorizzazione allora potranno 
eseguire le attività solo i soggetti esplicitamente autorizzati (gli utenti amministratori non fanno 
eccezione).


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N – D O C U M E N T  M A N A G E M E N T  
44 – A R C H I V I A Z I O N E  D O C U M E N T A L E   Associazione Causali/Classi 
documentali  
  
La gestione facilita tutt e le operazioni inerenti l’archiviazione (da file o da scanner) o di creazione 
barcode per il DMS di Infinity. La gestione è raggiungibile tramite specifica voce di menù. Se il 
modulo Document Management (DOCM) è:  
 attivo: Moduli Document Management Assoc iazione Causali/Classi documentali;  
 non attivo: Sistema Gestione allegati Associazione Causali/Classi librerie.  
  
La gestione permette di definire quale classe documentale utilizzare automaticamente (senza richieste 
all'utente) in base alla causale docum ento o alla causale contabile di riferimento. Quindi, tale 
possibilità, riguarda esclusivamente le registrazioni contabili o le registrazioni di documenti del ciclo 
attivo o passivo.  
  
Per ogni causale contabile o documento è possibile definire:  
 Classe d ocumentale per archiviazione su Infinity mediante barcode.  
 Classe documentale per archiviazione da file o da scanner (direttamente in ad hoc).  
  
Per la generazione del barcode è anche possibile stabilire:  
 se la creazione del barcode deve avvenire immed iatamente dopo la conferma della 
registrazione in primanota o nei documenti;  
 se il barcode deve essere generato automaticamente dalla procedura (con stampa dello stesso) 
o se deve essere imputato manualmente dall’utente (con possibilità di evitarne la st ampa).  
  
In assenza di un record nell’archivio di associazione tra causale e classe documentale relativamente alla 
registrazione contabile o documento, la procedura si comporta secondo quanto stabilito prima del rilascio di questo 
aggiornamento.  
  
 
Associ azione Causali/Classi documentali


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – D O C U M E N T  M A N A G E M E N T  
A R C H I V I A Z I O N E  D O C U M E N T A L E  - 45   
 Tipo causale  
Questa combo box permette di stabilire se l’associazione che si intende stabilire riguarda le causali 
documento o le causali contabili. E’ campo chiave insieme al codice causale.  
 Codice causale contabile o documento  
Dopo avere definito la tipologia di causale selezionabile è possibile stabilire per quale causale contabile 
o documento determinare l’associazione. E’ campo chiave insieme al tipo causale.  
  
Per la selezione della classe documentale occorre fare una selezione da zoom o digitare interamente il codice della 
causale: non è possibile effettuare una ricerca con digitazione parziale (del codice), in tal caso la procedura 
restituirebbe il messaggio “valore non ammesso”.  
Tipo causale e Codice causale sono campi chiave dell’archivio, quin di non possono esistere più associazioni relative 
alla stessa causale contabile o causale documento.  
  
Dopo avere indicato la causale contabile o documento è necessario compilare almeno una delle classi 
documentali presenti nelle due distinte sezioni della  gestione.  
  
Generazione barcode per acquisizione da Infinity.  
  
In questa sezione sono a disposizione tutti i parametri relativi alla funzione di generazione barcode. 
Oltre alla classe documentale è possibile definire se il barcode deve essere generato in  modo 
automatico dalla procedura (external code casuale) o se deve essere imputabile liberamente dall’utente. 
Inoltre, l’utente può stabilire se la procedura di generazione barcode deve essere immediata e quindi 
“scattare” subito dopo la conferma delle reg istrazioni (documenti o primanota) e, infine, se deve 
essere stampato o meno il barcode (in caso di imputazione manuale dello stesso).  
  
In caso di presenza di ZIDI (CPIN attivo in chiave di attivazione) e classi documentali di tipo “Infinity DMS”,


key: chroma:document
string_value:
la nuov a gestione non permette di definire per la generazione barcode un valore diverso da “automatica”. La 
possibilità di definire l’external code (barcode) manualmente è disponibile esclusivamente in caso integrazione 
“DMSEasy” o con classi documentali che hann o modalità di integrazione “Infinity DMS Stand Alone”.  
  
 Classe documentale o Classe libreria allegati  
In questo campo occorre definire la classe (documentale o libreria allegati, a seconda della presenza o 
meno del modulo DOCM) per la quale stabilire l’associazione con la causale contabile o documento 
indicat a per l’operazione di acquisizione documenti su Infinity mediante barcode.  
  
Sono selezionabili le classi documentali che hanno come tabella di riferimento PNT_MAST o DOC_MAST (in 
base all’impostazione della combo box “Tipo causale”) e che hanno come modal ità di archiviazione “Infinity 
DMS” o “Infinity DMS Stand Alone”.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N – D O C U M E N T  M A N A G E M E N T  
46 – A R C H I V I A Z I O N E  D O C U M E N T A L E   Generazione barcode  
Questa combo box prevede tre possibili scelte:  
 Automatica: il barcode verrà sempre generato in modo automatico dalla procedura senza 
richiedere l’imputazione da parte dell’utente.  
  
E’ l’unica scelta possibile in presenza di integra zione ZIDI (modulo CPIN attivo in chiave di attivazione) e classe 
documentale con tipo archiviazione “Infinity DMS”.  
  
 Manuale: il barcode può essere imputato manualmente dall’utente su apposita maschera che 
compare lanciando la funzione di archiviazione  mediante barcode. Se l’utente non imputa alcun 
barcode la procedura genera comunque un barcode casuale automaticamente;  
  
 
Inserimento barcode manuale non obbligatorio  
  
 Man. Obbligatorio: il barcode deve essere imputato manualmente dall’utente senza 
possibilità di far diversamente. Finché non si digita qualcosa nel campo “External code” 
(barcode), la procedura non permette di procedere con l’operazione.  
  
 
Inserimento barcode manuale e obbligatorio  
  
Per l’external code (barcode) inserito manualmente dall’utente è prevista una lunghezza massima di 25 caratteri.  
  
 Barcode immediato  
Dopo aver indicato una determinata classe documentale per l’archiviazione mediante barcode, l’utente 
ha la possibilità di definire se tale funzionalità deve essere lanciata immediatamente dopo il salvataggio 
della registrazione contabil e o del documento. Ciò evita di dover tornare in stato “Interroga” e di 
ricercare la registrazione appena inserita per creare il barcode. Nel caso dei documenti la procedura 
scatta dopo l’eventuale stampa da print system dei report previsti per la causale documento utilizzata.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – D O C U M E N T  M A N A G E M E N T  
A R C H I V I A Z I O N E  D O C U M E N T A L E  - 47  No report di stampa  
L’attivazione di questo check permette di evitare la stampa del barcode. L’opzione ha senso quando il 
documento che si intende acquisire tramite scanner nel DMS di Infinity ha già un determinato codice 
identificativo che dovrà essere imputato manualmente dall’utente. E’ per tale motivo che l’opzione è 
disponibile solo quando la combo box “Generazione barcode” è impostata su “Manuale” o “Man. 
Obbligatorio”.  
  
Quando l’opzione di generazione barcode è “manuale” e l’utente non digita nul la come external code, la procedura 
ignora tale opzione e stampa comunque il frontespizio o l’etichetta del barcode generato automaticamente.  
  
Archiviazione da file/scanner di un documento  
In questa sezione della gestione è possibile stabilire una classe documentale da utilizzare per le 
operazioni di archiviazione da file o da scanner (in adhoc) dipendenti dalla causale utilizzata. In 
sostanza, per le tabelle DOC_MAST e PNT_MAST, è possibile stabilire classi documentali diverse 
tenendo conto della causale documento o causale contabile utilizzata, evitando all’utente l’onere di 
doverla selezionare manualmente.  
 Classe documentale o Classe libreria allegati  
In questo campo occorre definire la classe (documentale o libreria allegati, a seconda della presenza o 
meno del modulo DOCM) per la quale stabilire l’associazione con la causale contabile o documento 
indicat a per le operazioni di archiviazione da file o da scanner in adhoc.  
  
Sono selezionabili le classi documentali che hanno come tabella di riferimento PNT_MAST o DOC_MAST (in 
base all’impostazione della combo box “Tipo causale”) indipendentemente dalle modal ità di archiviazione.  
  
Esempio di archiviazione mediante barcode e da file/scanner  
  
Caricata una nuova associazione Causali/Classi documentali relativamente alla causale documento


key: chroma:document
string_value:
Caricata una nuova associazione Causali/Classi documentali relativamente alla causale documento 
FATIM, che prevede classe documentale FATTPASSIVE (di tipo Infinity DMS St and Alone), 
Barcode imputabile obbligatoriamente dall’utente al salvataggio del documento e senza stampa del 
barcode stesso. Potrebbe essere il caso di archiviazione di fatture di acquisto sulle quali è stato 
immediatamente apposta un’etichetta con externa l code che sarà inseribile manualmente dall’utente 
immediatamente dopo il salvataggio della registrazione tra i documenti di acquisto di adhoc.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N – D O C U M E N T  M A N A G E M E N T  
48 – A R C H I V I A Z I O N E  D O C U M E N T A L E  
 
Causale FATIM  
  
Caricamento nuova fattura nel ciclo acquisti con causale documento FATIM  
  
 
Caricamento fat tura di acquisto  
  
Alla conferma della registrazione, subito dopo aver stampato gli eventuali report previsti per la causale 
FATIM, compare la maschera di richiesta inserimento dell’external code (barcode).


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – D O C U M E N T  M A N A G E M E N T  
A R C H I V I A Z I O N E  D O C U M E N T A L E  - 49 
 
Inserimento manuale e obbligatorio dell’exter nal code (max 25 caratteri)  
  
Alla conferma dell’inserimento del barcode viene immediatamente generato il file XML (perché la 
modalità di archiviazione sulla classe selezionata è Infinity DMS Stand Alone).  
  
 
Conferma invio ad infinity  
  
Se sulla stessa r egistrazione (Fattura con causale FATIM) si tentasse di procedere all’archiviazione da 
file o da scanner direttamente in adhoc, la procedura non richiederebbe nulla all’utente ed 
utilizzerebbe immediatamente la classe documentale FATTPASSIVE prevista nell’ archivio di 
associazione causali/classi documentali.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N – D O C U M E N T  M A N A G E M E N T  
50 – A R C H I V I A Z I O N E  D O C U M E N T A L E   Indici documenti  
  
L'archivio degli indici documenti ha lo scopo di memorizzare tutti i riferimenti dei file archiviati in 
modo tale da consentirne la ricerca e  la visualizzazione a seconda del contesto. Ad esempio, sarà 
possibile identificare ed aprire in modo immediato tutti i file riferiti ad un determinato record (un 
articolo, un cliente, una fattura, ecc.) partendo semplicemente dalla corrispondente anagrafi ca. 
  
La maggioranza dei dati presenti sulla gestione possono essere automaticamente valorizzati (in fase di 
archiviazione) parametrizzando in modo opportuno le classi documentali. Nel caso dei documenti di 
produzione interna (quelli che nascono da un proc esso documentale) anche i campi che normalmente 
necessitano di un intervento da parte dell'utente (descrizione e note aggiuntive) possono essere 
valorizzati in modo automatico.  
  
Per ogni file archiviato esiste un indice documento: i dati che vengono memor izzati per ognuno di essi 
sono distribuiti su più schede in modo da concentrare quelli di base sulla prima scheda, le 
informazioni del file archiviato sulla seconda e gli attributi di ricerca sulla terza.  
  
Indice documenti - Indice documenti  
  
La prima sc heda contiene i dati principali del file archiviato.  
  
 
Indice documenti - Indice documenti  
  
Di seguito l'elenco dei campi:  
 Seriale  
Numero progressivo che rappresenta la chiave primaria dell'archivio (sulla maschera di gestione non 
risulta mai editabil e).


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – D O C U M E N T  M A N A G E M E N T  
A R C H I V I A Z I O N E  D O C U M E N T A L E  - 51  Classe Documentale  
Ogni indice documento ha una classe di riferimento che ne avrà determinato in fase di inserimento la 
collocazione (percorso di memorizzazione, server EDS, ecc.) e gli attributi. Sulla maschera di ricerca 
documenti archiviati la cla sse risulta indispensabile per poter effettuare ricerche in base al valore 
assegnato agli attributi nel momento di creazione dell'indice.  
  
Per le classi documentali di tipo Copia file, la modifica del percorso di memorizzazione sulla classe 
consente di ag giornare automaticamente il percorso sui singoli Indici documento permettendo di 
fatto di poter spostare i corrispondenti file in altre cartelle senza perdere il corretto riferimento 
rispetto ai dati del gestionale.  
 Nome file originale  
In questo campo viene memorizzato il nome del file originario. Il dato visualizzato è diverso a 
seconda della tipologia di classe documentale: se è di tipo Copia file viene visualizzato effettivamente 
il nome del file originario, ment re, se è di tipo Collegamento viene visualizzato oltre al nome del file 
anche il percorso completo di memorizzazione (a livello di database i due dati sono memorizzati in 
campi distinti).  
Nel caso di file archiviati da processo documentale (generati dalla  procedura) il nome del file originale 
coincide con il nome del file archiviato (dato presente nella scheda Informazioni allegato). Invece, nel 
caso di archiviazione di file provenienti dall'esterno (mediante archiviazione rapida) il nome del file 
original e sarà diverso rispetto a quello archiviato. Nel caso di file generati da processo documentale 
infopublisher, il nome del file originale è univoco (presenta una parte random) mentre il nome del file 
archiviato è determinato da codice processo ed intestatar io. 
 Apri file


key: chroma:document
string_value:
archiviato è determinato da codice processo ed intestatar io. 
 Apri file  
Questo bottone permette di aprire il file archiviato con il programma predefinito sul sistema operativo 
per quel tipo di file.  
 Descrizione  
Descrizione del file archiviato. Nel caso di archiviazione da processo documentale viene valorizzato 
con il risultato dell'espressione definita nel campo Oggetto del processo documentale. Nel caso di 
archiviazione rapida dovrà essere valorizzato manualmente.  
 Note aggiuntive  
Note aggiuntive del file archiviato. Nel caso di archiviazione da processo documen tale viene 
valorizzato con il risultato dell'espressione definita nel campo Testo del processo documentale. Nel 
caso di archiviazione rapida dovrà essere valorizzato manualmente.  
 Tipo File  
In questo campo il programma riporta automaticamente l'estensione  del file archiviato (ad esempio 
.pdf, .doc, ecc.).  
 Data Archiviazione  
La data di archiviazione viene valorizzata automaticamente con la data di sistema nella quale è stato 
inserito il file.  
 Utente Archiviazione  
Codice dell'utente della procedura che h a eseguito l'archiviazione del documento.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N – D O C U M E N T  M A N A G E M E N T  
52 – A R C H I V I A Z I O N E  D O C U M E N T A L E  Indice documenti - Informazioni allegato  
  
In questa scheda vengono riepilogate le informazioni relative al file archiviato.  
  
 
Indice documenti - Informazioni allegato  
  
Di seguito l'elenco dei campi.  
 Modalit à archiviazione  
La modalità di archiviazione viene ereditata dalla classe documentale. Può assumere uno dei seguenti 
valori:  
 Collegamento: in questo caso l'indice documento rappresenta semplicemente il collegamento 
ad un file che è rimasto nella sua posi zione originaria e che non è stato replicato nel percorso 
standard indicato sulla classe documentale;  
 Copia File: in questo caso il file di riferimento risulta duplicato nel percorso standard 
predefinito sulla classe documentale con nome determinato in m odo cablato. Occorre 
distinguere i seguenti casi:  
 Archiviazione documenti generati dalla procedura (da processo documentale): in 
questo caso il nome del file archiviato è composto da <Codice Processo>_<Campo 
Chiave Processo>.pdf per le stampe e da <Codic e Processo>_<Campo Intestatario 
Processo>.* per la pubblicazione dati infopublisher  
 Archiviazione documenti preesistenti (compreso il caso di Nuovo documento da 
modello): in questo caso il nome del file è composto da <Seriale Indice 
documento>_<Tabella d i riferimento Classe documentale>_<Codice record di 
riferimento>.*  
 Extended document server: in questo caso la classe documentale prevede la gestione degli 
allegati attraverso un server EDS. In presenza di allegati archiviati su server EDS i dati present i 
sulla gestione sono sostanzialmente diversi (vedere apposita sezione).  
  
L'eliminazione di un indice documento di tipo Copia file determina anche la cancellazione del file dal percorso di 
memorizzazione. La stessa cosa avviene per i file archiviati su se rver EDS, mentre nel caso degli indici di tipo


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – D O C U M E N T  M A N A G E M E N T  
A R C H I V I A Z I O N E  D O C U M E N T A L E  - 53 La modifica della modalità di archiviazione su un indice documento già presente in archivio è possibile solo da 
modalità Copia file a Collegamento (non vicevers a) per i file di provenienza esterna (ovvero quelli per i quali è stata 
eseguita l'archiviazione rapida).  
  
 Tipologia e classe allegato  
Tipologia e classe allegato consentono di classificare ulteriormente i file archiviati. Tipologie e classi 
possono ess ere definite nell'archivio tipologie allegati del sottomenù Attributi: per ogni codice 
tipologia è possibile definire n classi. Tali dati sono comuni a quanto disponibile anche in assenza del 
modulo Document Management con la gestione allegati disponibile all'interno del menù sistema. 
Questi dati (tipologia/classe) oltre a fornire la possibilità di raggruppare gli allegati (sia in base 
all'estensione dei file, sia fornendo la possibilità di creare delle sottocartelle all'interno del percorso di 
memorizzazio ne) consentono di definire gli attributi ai fini della pubblicazione degli allegati.  
 Allegato principale  
Questo check identifica l'allegato principale. Il check è attivabile solo per uno degli allegati ed ha lo 
scopo di identificare l'allegato di riferim ento per specifiche funzionalità. Ad esempio, la stampa listini 
con immagini riporta sul report l'allegato principale (che deve essere un'immagine); il documento di 
offerta con immagini riporta gli allegati principali (che devono essere immagini); l'apertu ra automatica 
del file allegato (in base all'impostazione definita per utente nei servizi fax, e -mail, ecc.) considera 
innanzitutto l'allegato principale.  
 Pubblica su web  
Questo check è relativo alla pubblicazione degli allegati su Corporate Portale Zucchetti. Sarà attivabile 
solo in presenza dell'integrazione col portale (embedded o stand alone) determinando o meno la


key: chroma:document
string_value:
solo in presenza dell'integrazione col portale (embedded o stand alone) determinando o meno la 
pubblicazione dell'allegato su web.  
 Formato elettronico  
Questo check è attivabile in presenza del modulo Fattura CBI. L'attivazione di questo check identifica 
l'allegato come formato elettronico del documento (fattura o nota di credito) ai fini della produzione 
del file XML destinato alla b anca proponente: l'indice documento di questa tipologia può essere 
creato contestualmente alla generazione del file XML della fattura ma, se esiste già, viene utilizzato 
convertendolo direttamente in Base64 ed inserito all'interno di uno specifico tag del file XML.  
 Codifica CBI  
Questo campo risulta visibile solo previa attivazione del check Formato elettronico ed accoglie la 
tipologia di file che dovrà essere convertito in Base64 all'interno del file XML.  
 Percorso standard  
Questo campo è visibile solo p er gli indici documento di tipo Copia file e rappresenta il percorso 
standard di archiviazione del file definito sulla classe documentale di appartenenza (ad esempio 
C:\Documenti \Fatture)  
 Raggruppamento  
Questa combo box non è editabile ed è visibile solo  per gli indici documento di tipo Copia file. Viene 
visualizzato il tipo di raggruppamento temporale scelto sulla classe documentale in base al quale viene 
aggiunto un suffisso alla cartella creata all'interno del percorso standard con il codice azienda.  
 Percorso assoluto  
Questo campo è visibile solo per gli indici documento di tipo Copia file e rappresenta l'effettivo


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N – D O C U M E N T  M A N A G E M E N T  
54 – A R C H I V I A Z I O N E  D O C U M E N T A L E  percorso di archiviazione del file determinato dalla combinazione del percorso standard definito sulla 
classe documentale (ad esempio C: \Documenti \Fatture), da integrarsi con la sottocartella denominata 
con il codice azienda più eventuale suffisso per i raggruppamenti temporali ed, ancora, dalle eventuali 
sottocartelle per tipologia e classe allegato.  
 Nome file archiviato  
Rappresenta unicamente il nome del file archiviato. Il nome dei file viene assegnato in modo diverso a 
seconda del tipo di origine:  
 Archiviazione documenti generati dalla procedura (da processo documentale): in questo caso 
il nome del file archiviato è composto da <Codice Processo>_<Campo Chiave Processo>.pdf  
per le stampe e da <Codice Processo>_<Campo Intestatario Processo>.* per la pubblicazione 
dati infopublisher  
 Archiviazione documenti preesistenti (compreso il caso di Nuovo d ocumento da modello): in 
questo caso il nome del file è composto da <Seriale Indice documento>_<Tabella di 
riferimento Classe documentale>_<Codice record di riferimento>.*  
 Inizio/Fine Validità  
  
Queste date consentono di definire l'intervallo temporale d i validità dell'allegato in modo tale da 
considerare o meno l'indice in specifiche visualizzazioni/stampe (ad esempio, la ricerca documenti 
archiviati: affinché l'indice venga considerato è sufficiente che il periodo di validità dell'indice stesso sia 
comp reso nell'intervallo temporale di ricerca). Entrambi i dati sono richiesti come obbligatori per la 
conferma dell'indice, tuttavia presentano entrambi un valore predefinito: la data di inizio validità è 
proposta uguale alla data di archiviazione mentre alla  data di fine validità viene assegnato il valore 
01/01/3000.  
  
Indice documenti - Attributi di ricerca


key: chroma:document
string_value:
01/01/3000.  
  
Indice documenti - Attributi di ricerca  
  
Nella scheda attributi sono elencati gli attributi dell'indice documento (ereditati dalla classe 
documentale di appartenenza) ed i corrispondenti valor i. 
  
 
Indice documenti - Attributi di ricerca


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – D O C U M E N T  M A N A G E M E N T  
A R C H I V I A Z I O N E  D O C U M E N T A L E  - 55  Sequenza  
Rappresenta l'ordine di memorizzazione/visualizzazione degli attributi e viene ereditato dalla classe 
documentale.  
 Attributo e Descrizione  
Codice e descrizione dell'attributo. Tali campi sono definibili liberamente ed hanno lo scopo di 
rappres entare il significato del valore che sarà memorizzato nel campo successivo Valore.  
  
Benché sia possibile intervenire su tali campi, è consigliabile lasciare invariato tutto ciò che viene proposto sulla base 
della classe documentale. Infatti, per poter poi  ricercare gli allegati in funzione degli attributi è necessario che ci sia 
piena corrispondenza tra codici attributo definiti sulla classe documentale e codici attributo presenti sui singoli indici 
documento. Come sulle classi documentali, il codice attri buto non può contenere spazi o segni di punteggiatura.  
  
 Tipo  
Questa combo box consente di definire la tipologia di dato del valore che potrà assumere l'attributo. 
Le tipologie possibili sono Numerico, Carattere e Data.  
 Valore  
Il valore dell'attribut o viene memorizzato in questo campo. Se la classe documentale è configurata 
opportunamente, tutti i valori degli attributi vengono assegnati automaticamente in fase di creazione 
dell'indice, sia che nasca da processo documentale sia che nasca da archiviazi one rapida.  
 Obbligatorio  
Se un attributo viene definito come obbligatorio significa che deve presentare un valore significativo 
per poter confermare l'indice documento, altrimenti sarà impossibile confermare. In caso di 
archiviazione automatica la procedura ne richi ederà la specificazione.  
 Tabella  
Anche questo campo può essere ereditato dalla classe documentale di appartenenza e serve per creare 
un legame tra l'indice documento ed un determinato record della tabella indicata individuabile in base


key: chroma:document
string_value:
al contenuto del c ampo precedente Valore. Ad esempio, se il PDF di una fattura deve essere 
accessibile anche dall'anagrafica dell'intestatario della stessa in questo campo si avrà la tabella CONTI 
(perché è la tabella relativa alla gestione Clienti/Fornitori), inoltre, il v alore dell'attributo deve 
corrispondere alla concatenazione dei campi chiave della tabella qui indicata. Nel caso dell'intestatario, 
per far si che tutti i suoi documenti siano accessibili dalla sua anagrafica, il valore dell'attributo deve 
essere uguale a lla concatenazione ANTIPCON+ANCODICE (ovvero i campi chiave della tabella 
CONTI).


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N – D O C U M E N T  M A N A G E M E N T  
56 – A R C H I V I A Z I O N E  D O C U M E N T A L E   Tipologie e classi allegati  
  
Tipologie e classi allegato forniscono la possibilità di classificare i file archiviati in  modo più specifico 
rispetto a quanto consentono la sola classe documentale (inteso come codice di raggruppamento di 
allegati) e/o i raggruppamenti temporali (che incidono esclusivamente sulla suddivisione in cartelle dei 
file). Quindi, le tipologie allega to consentono di suddividere gli allegati in base all'uso che ne deve 
essere fatto. Ad esempio, tutti i file immagine potrebbero appartenere alla stessa tipologia, così come 
tutti file che rappresentano documenti (doc, pdf, xls).  
Per ogni tipologia si devo no definire le classi. Le classi rappresentano una suddivisione ulteriore degli 
allegati appartenenti alla stessa tipologia. Scopo principale della classe è suddividere gli allegati con 
caratteristiche comuni; ad esempio, i file immagine potrebbero essere suddivisi in base all'estensione o 
in base alle dimensioni.  
  
 
Tipologie e classi allegati  
  
 Univoca  
Se attivo significa che non può esistere più di un allegato con stessa tipologia/classe associato allo 
stesso record. Al tentativo di inserire un ulteri ore allegato, se la tipologia/classe è univoca, comparirà 
un messaggio a video.  
E' già stato allegato un file, l'univocità della classe non consente ulteriori allegati!  
  
 Predefinita  
Se attivo, indica che la classe sarà proposta come default quando viene  selezionata la tipologia.  
 Pubblica su Web  
Tramite questo check è possibile stabilire se gli allegati di una certa Tipologia/Classe devono essere 
pubblicati su Web. Si tratta semplicemente di un valore predefinito modificabile per ciascun allegato.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – D O C U M E N T  M A N A G E M E N T  
A R C H I V I A Z I O N E  D O C U M E N T A L E  - 57  Estensioni allegati  
  
Attraverso questo archivio è possibile definire una determinata Tipologia/Classe allegato da proporre 
automaticamente in fase di associazione degli allegati sulla base dell'estensione del file selezionato 
fornendo così un automatismo di selezione tipologia/classe allegato dipendente dal tipo di file, o 
meglio dalla sua estensione.  
  
 
Estensioni allegati  
  
 Estensione  
Estensione dei file per i quali applicare l'automatismo.  
 Tipologia/Classe allegato  
Tipologia e classe allegato da utilizzare sull'indice documento per i file con estensione indicata nel 
campo precedente.  
 Estensione CBI  
Campo visibile in pr esenza del modulo Fattura CBI e riportato nell'omonimo campo dell'indice 
documento ai fini della generazione dell'XML della fattura CBI.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N – D O C U M E N T  M A N A G E M E N T  
58 – A R C H I V I A Z I O N E  D O C U M E N T A L E   Modelli documenti  
  
In questo archivio possono essere definiti i modelli da  utilizzare per la creazione di documenti da 
associare contestualmente ad un determinato record di una certa tabella del database, ad esempio, un 
documento da creare e legare subito ad un articolo che si sta visualizzando tramite la corrispondente 
gestione . I modelli utilizzabili partendo da una determinata gestione sono quelli che hanno una classe 
documentale utilizzabile per la stessa gestione: la selezione tra i modelli disponibili sarà quindi filtrata 
in base alle caratteristiche della classe documental e di riferimento (tabella di riferimento).  
  
 
Modelli documenti  
  
 Codice (e descrizione)  
Il codice del modello è un progressivo automatico mentre è definibile liberamente la descrizione del 
modello nel campo obbligatorio.  
 Preferenziale  
Se un modello viene definito come preferenziale sarà proposto automaticamente tra quelli disponibili 
ed utilizzabile da una certa gestione.  
 Percorso  
In questo campo deve essere indicato il file (percorso incluso) da utilizzare come modello per la 
creazione di un nuovo file da associare al record visualizzato a video. Il file utilizzab ile può essere di 
qualunque tipo, tuttavia, affinché la funzionalità offra un servizio significativo, è consigliabile utilizzare 
un modello Word/OpenOffice con Segnalibri da utilizzare in abbinamento con la query indicata nel 
campo successivo.  
 Query coll egata  
In questo campo è possibile indicare la query (percorso incluso) da utilizzare in abbinamento al


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – D O C U M E N T  M A N A G E M E N T  
A R C H I V I A Z I O N E  D O C U M E N T A L E  - 59 modello per la costruzione del documento da associare al record visualizzato a video. Così come 
avviene con il modulo Offerte per la creazione dei docume nti il programma sostituisce gli alias della 
query ai segnalibri definito sul modello di riferimento. Per alias/segnalibri sono utilizzabili dei suffissi 
che determinano la formattazione del dato. Di seguito l'elenco dei suffissi utilizzabili:  
 _P indica il path di un file immagine;  
 _Q indica una quantità, viene applicata la formattazione relativa alla picture parametrica 
v_PQ[15];  
 _I indica un importo, viene applicata la formattazione relativa alla picture parametrica 
v_PV[20];  
 _0 indica  un valore numerico, viene applicata la formattazione relativa alla picture parametrica 
v_PV[40]  
 _1 indica un valore numerico, viene applicata la formattazione relativa alla picture parametrica 
v_PV[60]  
 _2 indica un valore numerico, viene applicata la formattazione relativa alla picture parametrica 
v_PV[80]  
 _3 indica un valore numerico, viene applicata la formattazione relativa alla picture parametrica 
v_PV[100]  
 _4 indica un valore numerico, viene applicata la formattazione relativa alla picture par ametrica 
v_PV[120]  
 _5 indica un valore numerico, viene applicata la formattazione relativa alla picture parametrica 
v_PV[140]  
  
Se il campo è numerico e non ha uno dei suffissi specificati in precedenza (escluso _P) viene convertito con zero 
decimali (pa rte intera del numero)  
 Note  
In questo campo possono essere inserite delle note relativamente all'utilizzo del modello. Ha solo lo 
scopo di specificare in modo più dettagliato il possibile utilizzo del modello.  
 Apri file  
Questo bottone consente di aprir e il file (modello) con il programma predefinito per quella tipologia 
di file sul sistema operativo.


key: chroma:document
string_value:
di file sul sistema operativo.  
  
All'interno del percorso di installazione sono disponibili due file di esempio utilizzabili per la creazione di una 
semplice Scheda prodotto per gli arti coli: 
- Modello:  ..\DOCM \Exe\Query \SCHEDA_PRODOTTO.DOC  
- Query:  ..\DOCM \Exe\Query \SCHEDA_PRODOTTO.VQR  
  
Così come già descritto nella parte introduttiva della Archiviazione documentale, per la creazione del 
documento è sufficiente premere l'apposito botton e dell'application bar:  
 Nuovo documento  
Questo bottone permette di creare un nuovo allegato del record selezionato sulla finestra attiva (ad 
esempio un certo cliente oppure un certo articolo) sulla base di un documento ed, eventualmente, di 
una query che  può essere utilizzata per estrarre informazioni da scrivere direttamente sul documento


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N – D O C U M E N T  M A N A G E M E N T  
60 – A R C H I V I A Z I O N E  D O C U M E N T A L E  generato contestualmente. Ad esempio, dopo aver aperto una determinata gestione ed aver 
selezionato un record, è possibile generare un documento su Microsoft Word oppur e su OpenOffice 
partendo da un altro documento ove sono presenti Segnalibri che verranno sostituiti dagli alias della 
query collegata al modello. In questo modo è possibile, sempre a titolo di esempio, richiamare un 
determinato articolo dall'apposita anagr afica e generare la scheda prodotto attraverso l'inserimento sul 
documento dei dati già presenti sull'anagrafica (dati tecnici, commerciali, descrizioni, note) ed anche 
dell'immagine (allegato principale).  
Dopo aver aperto una gestione ed aver selezionato un record (ad esempio gestione articoli, record 
AHRB), cliccando sul bottone Nuovo documento comparirà una maschera di passaggio dati per la 
selezione della classe documentale (a meno che non ne esista una standard, perché in tal caso la classe 
non è selez ionabile) e del modello da utilizzare (caricato preventivamente in apposita anagrafica). Da 
tale maschera è anche possibile aprire il documento collegato al modello.  
 Classe documentale  
La classe documentale non è editabile se ne esiste una di tipo Standa rd, altrimenti il campo sarà 
editabile ed il programma proporrà eventualmente la classe di tipo Default, altrimenti nessuna classe. 
Nel campo possono essere selezionate le classi documentali relative alla gestione di partenza con 
archiviazione di tipo Manu ale. 
 Modello  
Nel campo modello potrà essere proposto automaticamente il modello Preferenziale altrimenti dovrà 
essere selezionato dall'utente, tra quelli relativi alla classe documentale indicata nel campo precedente.  
 Note  
In questo campo vengono solo ripor tate le note descrittive del modello selezionato al fine di ricordare 
all'utente lo scopo del modello stesso.  
 Apri file


key: chroma:document
string_value:
all'utente lo scopo del modello stesso.  
 Apri file  
Questo bottone consente di aprire il file (modello) con il programma predefinito per quella tipologia 
di file sul sistema operativo.  
  
Abbiamo dato la possibilità di creare il file e aprire il modello documen to all'interno della procedura.  
In questo modo evitiamo all'operatore di creare il modello esternamente e poi associarlo poi al 
gestionale.  
  
Nella maschera di modelli documenti dura nte il controllo di esistenza del file alla pressione del 
bottone Apri file, qualora il modello non esiste esce il messaggio  
Il file di riferimento non esiste, si desidera crearlo?  
  
La procedura nel percorso indicato creerà il file indicato e procederà al la sua apertura per poter 
procedere alla sua parametrizzazione  
  
 
Modello creato


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – D O C U M E N T  M A N A G E M E N T  
A R C H I V I A Z I O N E  D O C U M E N T A L E  - 61  Ricerca documenti archiviati  
  
La maschera Ricerca Documenti Archiviati può essere richiamata sia da apposita voce di m enù, sia 
tramite il bottone Visualizza Documenti presente sull'Application Bar, sia da tasto corrispondente 
presente su svariate anagrafiche.  
  
Tale gestione può essere utilizzata anche per una visualizzazione veloce degli allegati di un record: con 
la gestione attiva e record selezionato, si richiama la maschera di Ricerca Documenti Archiviati; in 
questo caso la maschera di Ricerca Documenti Archiviati viene compilata in automatico con i filtri 
corrispondenti, in modo tale da elencare solo i file collegat i al record che si è richiamato.  
  
Ricerca documenti archiviati - Generale  
  
 
Ricerca documenti archiviati - Generale  
  
 Classe documentale  
Questo campo consente di filtrare nella ricerca solo gli allegati archiviati con la classe documentale 
indicata.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N – D O C U M E N T  M A N A G E M E N T  
62 – A R C H I V I A Z I O N E  D O C U M E N T A L E  Lanciando la ricerca dei documenti archiviati da uno specifico contesto, ad esempio, da anagrafica articoli (previa 
selezione di un determinato record) questo campo risulta valorizzato automaticamente, se per quel contesto esiste 
una classe documentale standard, altrimenti il campo viene proposto vuoto al fine di consentire di visualizzare tutti 
gli allegati indipendenteme nte dalla classe di archiviazione.  
  
 Tipologia e classe allegato  
Questi campi possono essere utilizzati per filtrare i documenti archiviati in base alla tipologia/classe di 
appartenenza.  
 Descrizione, nome file archiviato e nome file originale  
Anche questi campi consentono di definire dei filtri di selezione per la ricerca dei documenti 
archiviati. Nella fattispecie si tratta di Campi di ricerca, che si distinguono per la bordatura messa in 
evidenza, (il cui colore è personalizzabile nella gestione Configurazione Interfaccia), nei quali è 
possibile scrivere una stringa che verrà ricercata automaticamente all'interno del campo 
corrispondente degli indici documenti senza necessità di rieseguire la ricerca con l'apposito bottone (è 
sufficiente uscire dal singolo campo).  
  
Se un indice documento  fa riferimento ad un file inesistente il programma evidenzia nello zoom una riga di colore 
rosso e riporta una messaggio di avviso in calce alla maschera.  
  
 Stampa  
Tramite tale bottone il programma permette la l'accesso alla maschera di stampa, al fine di elaborare 
l'elenco dei record archiviati (anteprima, stampa, .esportazione su foglio di calcolo, ecc.). Il report 
presenta le informazioni relative alla selezione effettuata risalendo alle informazioni presenti 
nell'archivio indici documenti.  
 Apri fil e 
Tale bottone è possibile visualizzare il file archiviato, tramite il suo programma predefinito sul sistema


key: chroma:document
string_value:
operativo (visualizzatore immagine, foglio di calcolo, ecc.) .  
 Visualizza  
Attraverso questo bottone è possibile accedere alla maschera Indici Doc umento e entrandovi in 
variazione risulteranno modificabili alcuni dati, nello specifico: la descrizione, le note, la 
tipologia/classe allegato, il check allegato principale e le date di validità.  
 Copia  
Tramite tale bottone è possibile creare una copia d el file archiviato e contestualmente salvarlo 
all'interno del percorso indicato dall'utente.   
 Invia  
Tramite tale bottone è possibile estrarre ed inviare il file selezionato via posta elettronica in forma di 
allegato (in formato originale) . 
 Pec 
Tramite tale bottone è possibile inviare il file selezionato via posta elettronica certificata.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – D O C U M E N T  M A N A G E M E N T  
A R C H I V I A Z I O N E  D O C U M E N T A L E  - 63  Pdf 
Tale bottone consente di estrarre ed inviare il file selezionato via posta elettronica, in forma di allegato 
PDF (creazione PDF ed invio e -mail).  
 Elimina  
Tramit e questo bottone è possibile eliminare il record selezionato dall'Archivio Indici Documenti. In 
caso di gestione allegati di tipo Copia file, questo comporta anche l'eliminazione fisica del file 
all'interno della cartella in cui è stato memorizzato.  
 Zip 
Consente di aprire la gestione per definire i parametri per la creazione dello zip.  
Attraverso tale bottone è possibile esportare i file archiviati relativi alle righe selezionate in un unico 
archivio Zip. L'operazione è consentita esclusivamente su allega ti con blocco non attivo e quindi in 
stato provvisorio.  
  
 
Esportazioni documenti archiviati in archivio zip  
  
Per la creazione di un archivio da esportare, è necessario definire il codice dell'utente proprietario 
dell'esportazione, nome e percorso del fi le zip che verrà creato. Come nome file viene elaborato un 
numero progressivo seguito dal suffisso _codice utente. Il formato in cui verrà creato il file zip è 7z.  
 Utente proprietario  
Indica l'utente proprio del file che si sta esportando.  
 File zip di  destinazione  
E' necessario indicare il percorso dove salvare lo zip (in una cartella oppure in un'unità esterna. Il 
nome del file viene composto in automatico dalla procedura mettendo insieme 
anno+mese+giorno+oraminutisecondi_codice utente esportatore.  
  
Confermato, nella cartella prescelta, viene creato lo zip.  
  
Il documento esportato, nella Ricerca Documenti archiviati, viene evidenziato con colore BLU e 
aprendolo, viene indicato che il documento è stato esportato per aggiornamento, evidenziando sia 
l'Utente proprietario dell'archiviazione che il percorso di archiviazione.


key: chroma:document
string_value:
l'Utente proprietario dell'archiviazione che il percorso di archiviazione.  
  
Attenzione: Se uno o più indici documento risultano confermati (bloccati) non è possibile utilizzare la funzionalità 
di zip 
  
Confermando la maschera di esportazione documenti archi viati, viene elaborato un messaggio in cui 
vengono riportate le varie azioni eseguite, o eventuali messaggi di errore.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N – D O C U M E N T  M A N A G E M E N T  
64 – A R C H I V I A Z I O N E  D O C U M E N T A L E  All'interno del percorso indicato sulla maschera di esportazione viene fisicamente copiato il file archiviato nel 
percorso indicato nel l'indice documento, sottoforma di archivio compresso (utilizzando 7zip). Contestualmente viene 
aggiornato l'indice documento, nel quale viene apposta l'etichetta Documento esportato per aggiornamento. Nella 
maschera di Ricerca Documenti Archiviati, la riga  relativa a questo allegato risulta blu.  
  
 Importa  
Consente di importare un file di formato ZIP con al suo interno i documenti.  
Attraverso tale bottone è possibile importare file esistenti a livello di indice, ma modificati e quindi da 
sostituire con la versione più aggiornata.  
  
 
Importazione documenti da archivio zip  
  
L'utente proprietario deve essere il medesimo che ha precedentemente esportato l'allegato. È inoltre 
possibile definire se il processo di elaborazione debba considerare solo il file indicato o un intera 
cartella. Una volta selez ionato il file e confermata la maschera viene emessa una maschera di 
elaborazione che riporta le varie azioni compiute dalla procedura.  
Deve essere indicato lo stesso utente che ha eseguito l'esportazione del documento (in quanto 
considerato proprietario) , deve essere indicato lo zip da importare e la modalità di importazione che 
prevede le seguenti scelte:  
 Cartella indicata: consente di analizzare il contenuto di una determinata cartella, che 
contenga uno o più zip relativi ad un determinato documento. Come già indicato questa 
funzione, per importare correttamente i documenti aggiornati, necessita di trovare lo zip con lo 
stesso nome con cui è stato esportato.  
 File indicato; consente di specificare in modo puntuale il file zip da importare per aggiorna re 
il documento esportato.  
 Invia Web


key: chroma:document
string_value:
il documento esportato.  
 Invia Web  
Premendo questo bottone l'allegato viene trasformato in un file PDF ed inoltrato automaticamente 
verso una cartella virtuale presente presso il gestore dei Servizi Web (tipicamente Infinity o CPZ), al 
fine di renderlo  disponibile per la consultazione da parte di clienti o fornitori. Il tasto risulterà attivo 
solo nel caso in cui sia predisposta l'integrazione corrispondente.  
 Nuovo  
Consente di creare un nuovo documento al pari dello stesso bottone dell'Application Bar . Il bottone è 
visibile solo se è stato valorizzato il campo Classe documentale. Affinché il nuovo indice documento 
venga associato ad un determinato record del database occorre che venga valorizzato 
opportunamente il corrispondente Valore di ricerca nell' elenco attributi della scheda Dettagli.  
 Archivia  
Consente di archiviare un file al pari dello stesso bottone dell'Application Bar. Il bottone è visibile solo


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – D O C U M E N T  M A N A G E M E N T  
A R C H I V I A Z I O N E  D O C U M E N T A L E  - 65 se è stato valorizzato il campo Classe documentale. Affinché il nuovo indice documento venga 
associato ad un determinato record del data base occorre che venga valorizzato opportunamente il 
corrispondente Valore di ricerca nell'elenco attributi della scheda Dettagli.  
 Scanner  
Consente di archiviare mediante acquisizione da periferica Twain (ad esempio, scanner) al pari dello 
stesso bottone  dell'Application Bar. Il bottone è visibile solo se è stato valorizzato il campo Classe 
documentale. Affinché il nuovo indice documento venga associato ad un determinato record del 
database occorre che venga valorizzato opportunamente il corrispondente Va lore di ricerca 
nell'elenco attributi della scheda Dettagli.  
 Duplica  
Questo bottone permette di duplicare l'indice documento sul quale si è posizionati nell'elenco ed è 
visibile solo se è stato valorizzato il campo Classe documentale e se l'indice documento non è stato 
archiviato su server EDS. Affinché il nuovo i ndice documento venga associato ad un determinato 
record del database occorre che venga valorizzato opportunamente il corrispondente Valore di ricerca 
nell'elenco attributi della scheda Dettagli. Rispondendo affermativamente alla richiesta della procedura 
verrà creato un nuovo indice documento ed il corrispondente file.  
 Blocca/Sblocca  
Tali bottoni hanno una duplice funzione: permettono la visualizzazione dello stato di un allegato 
(provvisorio se il tasto visibile risulta essere Blocca; confermato, se il tasto visibile risulta Sblocca) e la 
modifica massiva dei record s elezionati (tramite spunta) da uno stato all'altro. In caso di modifica, 
oltre a cambiare la visualizzazione del bottone, viene aggiornato lo stato dell'indice allegato. Per una 
trattazione più approfondita si rimanda al paragrafo Blocco modifica allegati definitivi.


key: chroma:document
string_value:
trattazione più approfondita si rimanda al paragrafo Blocco modifica allegati definitivi.  
  
Ricerca documenti archiviati - Dettagli  
  
Nella scheda dettagli è possibile fornire ulteriori parametri per filtrare l'elenco di indici documento da 
visualizzare nello zoom, in particolare è possibile effettuare ricerche sulla base del valore  degli 
attributi.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N – D O C U M E N T  M A N A G E M E N T  
66 – A R C H I V I A Z I O N E  D O C U M E N T A L E  
 
Ricerca documenti archiviati - Dettagli  
  
 Note  
Consente di ricercare gli indici documento sulla base del contenuto dell'omonimo campo degli indici 
documento.  
 Modalità di archiviazione  
Questa combo box permette di filtrare gli indi ci documento in base alla modalità di archiviazione.  
Le scelte possibili sono:  
 Copia file  
 Collegamento  
 Extended Document Server  
 Tutte  
 Da data validità, a data validità  
Intervallo temporale di ricerca sulla base delle date di validità memorizzate  sui singoli indici 
documento. Il programma propone come range predefinito dall'01/01/1900 al 01/01/3000.  
 Data archiviazione  
Questa combo box consente di definire in modo automatico il range temporale di ricerca di ricerca 
sulla base della data di sistem a e della data di archiviazione. In base al valore assegnato alla combo box 
vengono valorizzate le date di inizio/fine selezione. Ad eccezione del caso Selezione manuale, le date 
successive non saranno editabili.  
Le scelte possibili sono:  
 Ultimi 7 giorni : la data di fine selezione è pari alla data di sistema e quella di inizio selezione a


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – D O C U M E N T  M A N A G E M E N T  
A R C H I V I A Z I O N E  D O C U M E N T A L E  - 67 quella di sistema meno 7 giorni;  
 Ultimi 15 giorni: la data di fine selezione è pari alla data di sistema e quella di inizio selezione 
a quella di sistema meno 15 giorn i; 
 Ultimi 30 giorni (mese): la data di fine selezione è pari alla data di sistema e quella di inizio 
selezione a quella di sistema meno 30 giorni;  
 Ultimi 90 giorni (trimestre): la data di fine selezione è pari alla data di sistema e quella di 
inizio se lezione a quella di sistema meno 90 giorni;  
 Ultimi 180 giorni (semestre): la data di fine selezione è pari alla data di sistema e quella di 
inizio selezione a quella di sistema meno 180 giorni;  
 Ultimi 360 giorni (anno): la data di fine selezione è pari  alla data di sistema e quella di inizio 
selezione a quella di sistema meno 360 giorni;  
 Selezione manuale: le date di inizio e fine selezione sono valorizzabili liberamente  
  
La combo box in oggetto può essere valorizzata automaticamente con uno dei para metri sopra descritti definendo 
appositi parametri e/o preferenze di ricerca negli archivi del modulo validi per utente/gruppo/classe documentale.  
  
 Da data, a data  
Rappresenta l'intervallo di ricerca degli allegati. I campi possono essere valorizzati ma nualmente solo 
se la combo box precedente è impostata su Selezione manuale. In tal caso, i campi non vengono 
proposti vuoti, ma viene predefinito il seguente range temporale dall'01/01/1900 al 01/01/3000.  
 Tipo file  
Ricerca dei file archiviati in base all ’estensione o in base al raggruppamento dell’estensioni se il campo 
è vuoto nessuna estensione.  
 Doc 
 PDF 
 PNG  
 Documenti  
 Fogli di calcolo  
 Immagini  
 Messaggi  
 Pdf 
  
Le estensioni filtrabili tramite combo sono solo quelle presenti nell’archivio in dici documenti.


key: chroma:document
string_value:
Le estensioni filtrabili tramite combo sono solo quelle presenti nell’archivio in dici documenti.  
L’operatore ha quindi la possibilità di visualizzare gli indici archiviati ed i relativi file in base ad un 
determinato tipo di estensione.  
  
Un’altra possibilità fornita per mezzo della combo tipo file è di ricercare gli indici archiviati  in base ai 
diversi raggruppamenti di estensioni, quindi, di poter visualizzare più indici documenti relativi a file 
archiviati con diverse estensioni.  
  
Abbiamo realizzato quindi l’archivio “Raggruppamenti tipi file” presente nel sottomodulo Document 
Mana gement – Attributi allegati – Raggruppamento tipi file . 
 Utente archiviazione  
Permette di filtrare la ricerca degli indici documento sulla base dell'utente che ha eseguito 
l'archiviazione.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N – D O C U M E N T  M A N A G E M E N T  
68 – A R C H I V I A Z I O N E  D O C U M E N T A L E   Utente esportazione  
Permette di filtrare la ricerca degli indici  documento sulla base dell'utente che ha eseguito 
l'esportazione.  
 Solo principali  
Questo check consente di ottenere nell'elenco solo gli indici documento classificati come Allegato 
principale.  
 Non visualizzare documenti inesistenti  
Questo check consent e di evitare che nell'elenco compaiano indici documento relativi a file non più 
disponibili nel percorso di memorizzazione originario.  
 Ordina per  
Questa combo permette di filtrare gli allegati da archiviare in base alla data o alla descrizione di 
archivi azione del file. Gli indici documentali nella cartella generale saranno ordinati o per data 
archiviazione più recente oppure per descrizione file.  
 Data archiviazione file  
 Descrizione file  
 Pubblicabili sul Web  
Questa combo box è relativa all'integrazi one con il web  e ovviamente consente di filtrare gli allegati a 
seconda che risultino pubblicabili o meno sul portale.  
Le scelte possibili sono:  
 Tutti 
 Solo pubblicabili  
 Solo non pubblicabili  
 Tipo  
Questa combo permette di filtrare gli indici documen to da archiviare in base al tipo di archiviazione, 
attraverso le impostazioni archiviazione Web e/o standard.  
 Stato  
Questa combo consente di filtrare gli allegati, in modo che sul dettaglio presente nella prima scheda 
vengano visualizzato soltanto gli i ndici documenti provvisori, confermati oppure tutti.  
 Tabella e Chiave  
Quando non viene indicata una determinata classe documentale sulla maschera principale di ricerca, il 
programma fornisce la possibilità di ricercare tra tutti gli indici documenti quel li relativi ad un 
determinato record (campo chiave) di una determinata tabella (campo tabella).


key: chroma:document
string_value:
determinato record (campo chiave) di una determinata tabella (campo tabella).  
  
Nel caso in cui la tabella indicata contenesse più di un campo chiave, il record deve essere individuato digitando la 
concatenazione dei valori dei campi chi ave (ad esempio, per la tabella CONTI, 
ANCODICE+ANCODCON).  
  
Griglia attributi  
Nella griglia sottostante vengono riportati gli attributi definiti sulla classe documentale indicata sulla 
prima scheda della ricerca documenti archiviati. Nella colonna Valore di ricerca è possibile selezionare


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – D O C U M E N T  M A N A G E M E N T  
A R C H I V I A Z I O N E  D O C U M E N T A L E  - 69 il valore da ricercare nei corrispondenti attributi degli indici documento. Gli operatori accettati per 
tipologia di dato sono i seguenti (il filtro deve rispettare la sintassi sql):  
 Dato di tipo Data:  
2      '=','>','< ','>=','<=','<>';  
 Dato di tipo Numerico  
2      '=','>','<','>=','<=','<>'  
 Dato di tipo Carattere:  
2      'IN','NOT IN','LIKE','=','<>'


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N – D O C U M E N T  M A N A G E M E N T  
70 – A R C H I V I A Z I O N E  D O C U M E N T A L E   Blocco modifica allegati definitivi  
  
Attraverso la fun zione di Ricerca Documenti Archiviati è possibile gestire il blocco o lo sblocco degli 
allegati confermati. Questo può avvenire per singolo indice o attraverso un aggiornamento massivo.  
  
 
Documento confermato non modificabile  
  
Posizionandosi sulla singo la riga del dettaglio della maschera, viene visualizzato un tasto 
rappresentante un lucchetto aperto o chiuso.:  
 Se l'indice è sbloccato, il bottone apparirà con un lucchetto chiuso e la scritta blocca, ad 
identificare che attraverso la selezione della riga e la pressione di tale bottone è possibile 
bloccare l'indice. Al contrario,  
 Se l'indice è bloccato, il bott one apparirà con un lucchetto aperto e la scritta apri, ad 
identificare che attraverso la selezione della riga e la pressione di tale bottone è possibile 
sbloccare l'indice.  
  
Lo scopo di tali operazioni è di modificare lo stato dell'allegato stesso da pro vvisorio a confermato e 
viceversa.  
  
Le righe relative ad indici confermati, in corrispondenza delle quali appare quindi il bottone Sblocca, 
non potranno essere più elaborate, in quanto relative ad indici confermati non più modificabili.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – D O C U M E N T  M A N A G E M E N T  
A R C H I V I A Z I O N E  D O C U M E N T A L E  - 71 Pertanto sulla ma schera Ricerca Documenti Archiviati verranno inibiti e nascosti i bottoni Apri, 
Copia, Elimina, Zip ed Importa.  
  
 
Documento provvisorio ancora modificabile


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N – D O C U M E N T  M A N A G E M E N T  
72 – A R C H I V I A Z I O N E  D O C U M E N T A L E  
 
___________________________________________________________________________ _____  
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
_______ _________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
____________________ ____________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
_________________________________ _______________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
______________________________________________ __________________________________  
________________________________________________________________________________  
________________________________________________________________________________


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – D O C U M E N T  M A N A G E M E N T  
A R C H I V I  - 73  ARCHIVI  
  
 Parametri document management   
 Preferenze di Ricerca   
 Raggruppamenti tipi file


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N – D O C U M E N T  M A N A G E M E N T  
74 – A R C H I V I   Parametri document management  
  
L'archivio Parametri document management permette di definire a priori, eventualmente per ogni 
utente/gruppo, le modalità di ricerca degli allegati dalla corrispondente gestione. In particolare, può 
essere definito il periodo a partire dal quale devono essere visualizzati gli allegati (come impostazione 
predefinita), ad esempio allegati dell'ul timo anno, semestre, trimestre, ecc. e se il codice dell'utente che 
sta interrogando l'archivio degli indici documento deve fungere anche da filtro per la ricerca (in modo 
tale che vengano visualizzati solo gli allegati archiviati dallo stesso utente). In tal modo, accedendo alla 
procedura con un'utente ovvero con un utente che appartiene ad un determinato gruppo per il quale 
si è parametrizzato l'archivio in oggetto, questi avrà la possibilità di poter effettuare la ricerca nella 
modalità predefinita desid erata.  
  
 
Parametri document management  
  
 Soggetto  
La combo box Soggetto permette di definire se la modalità di ricerca predefinita è relativa ad un 
determinato Utente, ad un Gruppo oppure se deve essere l'impostazione di default per tutti (in 
quest'ult imo caso non è ovviamente necessario selezionare anche l'utente/gruppo). Nel caso in cui 
siano applicabili più modalità (ad esempio è presente un'impostazione Default o Gruppo e una per 
Utente) vale quella più specifica.  
 Filtro date  
Consente di definire il periodo da proporre sulla combo box Data archiviazione della ricerca allegati.  
 Utente  
Attivando il check utente in relazione ad un determinato utente o g ruppo, sarà possibile poter 
preimpostare il suo codice all'interno della maschera ricerca document i archiviati nel campo Utente 
Archiviazione.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – D O C U M E N T  M A N A G E M E N T  
A R C H I V I  - 75  Preferenze di ricerca  
  
Nell'archivio preferenze di ricerca, presente all'interno del menu archivi, è possibile definire preferenze 
di ricerca come nell'archivio P arametri Document Management in modo più specifico, ovvero è 
possibile definire criteri diversi a seconda della tabella e della classe documentale di riferimento. In 
questo modo è possibile differenziare le opzioni di ricerca a seconda del contesto.  
  
 
Preferenze di ricerca  
  
 Soggetto  
La combo box Soggetto permette di definire se la modalità di ricerca predefinita è relativa ad un 
determinato Utente, ad un Gruppo oppure se deve essere l'impostazione di default per tutti (in 
quest'ultimo caso non è ovviam ente necessario selezionare anche l'utente/gruppo). Nel caso in cui 
siano applicabili più modalità (ad esempio è presente un'impostazione Default o Gruppo e una per 
Utente) vale quella più specifica.  
 Classe preferenziale  
E' possibile selezionare la class e documentale di riferimento in base alla quale deve essere applicata la 
modalità di ricerca definita.  
 Filtro date  
Consente di definire il periodo da proporre sulla combo box Data archiviazione della ricerca allegati.  
 Utente  
Attivando il check utente i n relazione ad un determinato utente o g ruppo, sarà possibile poter 
preimpostare il suo codice all'interno della maschera ricerca documenti archiviati nel campo Utente 
Archiviazione.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N – D O C U M E N T  M A N A G E M E N T  
76 – A R C H I V I   Raggruppamenti tipi fi le 
  
L’archivio “Raggruppamenti tipi file” è presente nel sottomodulo Document Management – Attributi 
allegati – Raggruppamento tipi file . 
 
L’archivio viene popolato grazie al file Raggruppamenti_tipi_file.txt e la funzionalità carica salva dati 
esterni  
  
 
Raggruppamenti tipi file  
  
Abbiamo individuato i seguenti raggruppamenti  
 Documenti  
 Fogli di calcolo  
 Immagini  
 Messaggi  
 Pdf 
  
L’operatore può comunque mantenere l’archivio aggiungendo nuovi raggruppamenti e o nuove 
estensioni ai raggruppamenti es istenti.  
  
I raggruppamenti sono visibili ed utilizzabili nella combo tipo file in seguito al filtro sulle singole 
estensioni.  
  
Il filtro su uno dei raggruppamenti permette la visualizzazione di più indici documenti in base alle 
estensioni indicate nel ra ggruppamento stesso  
  
Per evitare che in fase di caricamento manuale di un nuovo “raggruppamento”, nell’archivio 
“Raggruppamento tipi file” (modulo Document management),  la procedura presenti il seguente 
errore  
Errore: chiave già utilizzata.  
  
Risulta nec essario, dopo aver riportato nell’installazione la correzione, procedere nuovamente al 
caricamento dei “raggruppamenti tipi file”, tramite la funzione di carica /salva dati esterni, per far si 
che la procedura crei/aggiorni il progressivo della tabella RAG _TIPI.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – D O C U M E N T  M A N A G E M E N T  
A R C H I V I  - 77 
 
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
____________ ____________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
_________________________ _______________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
______________________________________ __________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
___________________________________________________ _____________________________


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


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – D O C U M E N T  M A N A G E M E N T  
E X T E N D E D  D O C U M E N T  S E R V E R  - 79  EXTENDED DOCUMENT 
SERVER  
  
In questa parte vengono descritte le caratteristiche principali del prodotto Zucchetti Extended 
Document Server e le modalità di int egrazione con il modulo Document Management di ad hoc.  
  
 Premessa  
 Parametri EDS  
 Preferenze di Ricerca  
 Classi documentali (EDS)  
 Indici documenti (EDS)


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N – D O C U M E N T  M A N A G E M E N T  
80 – E X T E N D E D  D O C U M E N T  S E R V E R   Premessa  
  
L'archiviazione in fo rmato elettronico di un documento, o di un qualsiasi altro formato dati, sta 
ottenendo una crescente attenzione da parte dell'utenza, in quanto fornisce una risposta concreta 
all'esigenza di eliminare i supporti cartacei e di rendere disponibili tali docum enti ad una larga fascia di 
utenti.  
  
Extended Document Server è una componente software che consente di archiviare documenti e file 
con ogni sorta di formato. Crea un sistema di volumi ed indici per l'ottimizzazione della ricerca e 
permette di consultare i documenti salvati da qualunque postazione interna alla rete aziendale 
(intranet) oppure esterna (internet).  
  
Come funziona  
Extended Document Server è costituito essenzialmente da due componenti: il primo gestisce il 
trasferimento dei dati tra Client e S erver tramite protocollo SOAP , mentre il secondo si occupa della 
vera e propria archiviazione ed estrazione dei documenti.  
  
 
Flusso funzionamento Extended Document Server  
  
Il file/documento prima di essere trasferito subisce un processo di compressione mediante algoritmo 
proprietario, lato Client, col fine di ridurre la mole dei dati ed aumentare il livello di sicurezza della 
trasmissione. Ogni file/documento può essere archiviato abbinandovi una password che ne 
proteggerà ulteriormente la lettura e la p rivacy. I file archiviati possono essere contenuti in uno o più 
file del server di dimensione personalizzabile, in modo tale da consentirne una semplice 
masterizzazione su supporto ottico (CD, DVD).


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – D O C U M E N T  M A N A G E M E N T  
E X T E N D E D  D O C U M E N T  S E R V E R  - 81 Cos'è S.O.A.P .  
Simple Object Access Protocol (SOAP) è u n protocollo standard di comunicazione tra applicazioni 
che consente di accedere a servizi remoti residenti sulle più diverse piattaforme hardware, alla stessa 
maniera in cui un browser richiede pagine HTML su server diversi. SOAP consente il trasporto dei  
dati in maniera consistente e strutturata utilizzando per il trasporto dei messaggi di richiesta/risposta il 
protocollo HTTP , nel quale i parametri e i comandi sono codificati con XML; in questo modo si 
riesce ad eliminare il problema della differenza di piattaforma, in quanto XML ha una tecnologia Web 
estremamente flessibile ed estensibile.  
SOAP non definisce un modello di programmazione o implementazione di specifiche semantiche, ma 
permette di esprimerle fornendo un modello di Packing modulare e meccani smi per la codifica dei 
dati. 
  
I messaggi SOAP sono codificati usando il linguaggio XML. I messaggio sono fondamentalmente 
delle trasmissioni a senso unico, da un Sender ad un Receiver, ma spesso sono del tipo 
richiesta/risposta.  
  
Integrazione con ad hoc  
L'integrazione con il gestionale avviene attraverso il modulo Document Management: è sufficiente 
stabilire in Attivazione procedura la presenza di Extended Document Server per aver la possibilità di 
archiviare sull'apposito Server EDS anziché in percorsi prestabiliti del file system di una o più 
macchine della rete aziendale. Tale possibilità viene fornita fornendo una modalità di archiviazione 
aggiuntiva definibile sulle classi documentali. Oltre a Copia file e Collegamento è disponibile la nuova 
voce Ext ended Document Server.  
  
 
Classi documentali EDS – Nuova modalità di archiviazione


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N – D O C U M E N T  M A N A G E M E N T  
82 – E X T E N D E D  D O C U M E N T  S E R V E R    
Nei paragrafi successivi vengono analizzate le gestioni del modulo Document Management in modo 
differenziale rispetto a quanto descritto in precedenza.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – D O C U M E N T  M A N A G E M E N T  
E X T E N D E D  D O C U M E N T  S E R V E R  - 83  Parametri EDS  
  
In questa anagrafica è possibile impostare i parametri predefiniti da proporre in fase di definizione di 
classi documentali che prevedono l'integrazione degli allegati ad un server (EDS).  
  
 
Parametri EDS  
  
 Server  
Nome del server su cui è installato il programma EDS da utilizzare come valore predefinito sulle 
classi documentali.  
 Porta server  
Porta di comunicazione utilizzata per l'interfacciamento con il server EDS da utilizzare come valore 
predefinito su lle classi documentali.  
 Utente, Password  
Credenziali per l'accesso agli archivi del server EDS da utilizzare come valore predefinito sulle classi 
documentali.  
 Archivio  
Nome dell'archivio EDS da utilizzare come valore predefinito sulle classi documental i.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N – D O C U M E N T  M A N A G E M E N T  
84 – E X T E N D E D  D O C U M E N T  S E R V E R   Classi documentali (EDS)  
  
Sulle classi documentali è possibile selezionare la modalità di archiviazione Extended Document 
Server. Selezionando tale voce, la maschera muta di aspetto e, invece di consen tire di inserire tutti i 
parametri per la determinazione del percorso di memorizzazione permette di definire i parametri di 
comunicazione col server EDS. I parametri possono essere proposti automaticamente dalla procedura 
in base a quanto definito nell'arc hivio Parametri EDS.  
  
 
Classi documentali EDS  
  
Per ogni classe documentale è possibile definire parametri distinti e quindi, di fatto, avere anche più 
server EDS per gli indici documento di ciascuna classe documentale, oppure più semplicemente, file 
di archiviazione distinti.  
 Server  
Nome del server sul quale è in ascolto il servizio EDS.  
 Porta server  
Porta di comunicazione utilizzata per l'interfacciamento con il server EDS.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – D O C U M E N T  M A N A G E M E N T  
E X T E N D E D  D O C U M E N T  S E R V E R  - 85  Utente, Password  
Credenziali per l'accesso agli archivi del server EDS.  
 Archivio  
Nome dell'archi vio EDS da utilizzare.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N – D O C U M E N T  M A N A G E M E N T  
86 – E X T E N D E D  D O C U M E N T  S E R V E R   Indici documenti (EDS)  
  
In caso di utilizzo di classi documentali che prevedono come modalità di archiviazione Extended 
Document Server gli indici documento vengono generati memorizza ndo la chiave di ricerca 
dell'allegato sul server EDS anziché il nome del file originale.  
  
 
Indici documenti EDS  
  
 Indice archiviazione  
Chiave di ricerca dell'allegato sul server EDS. E' necessario memorizzare tale dato per poter estrarre il 
file corrispondente dall'archivio EDS nella cartella temporanea della macchina che lo ha richiesto, ad 
esempio per l'apertura.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – D O C U M E N T  M A N A G E M E N T  
E X T E N D E D  D O C U M E N T  S E R V E R  - 87 
 
Indici documenti EDS – Informazioni allegato  
  
Per quanto riguarda le informazioni allegato non sono presenti i campi relativi al percorso (standard 
ed assoluto) perché il tutto viene gestito dal server EDS.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N – D O C U M E N T  M A N A G E M E N T  
88 – E X T E N D E D  D O C U M E N T  S E R V E R  
 
_____________________________________ ___________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
__________________________________________________ ______________________________  
________________________________________________________________________________  
________________________________________________________________________________  
_______________________________________________________________ _________________  
________________________________________________________________________________  
________________________________________________________________________________  
____________________________________________________________________________ ____  
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
________ ________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – D O C U M E N T  M A N A G E M E N T  
S T A M P E  D O C U M E N T  M A N A G E M E N T  - 89  
 STAMPE DOCUMENT 
MANAGEMENT  
  
 Stampa processi documentali   
 Stampa classi documentali   
 Stampa preferenze di visualizzazione   
 Stampa autorizzazioni processi   
 Stampa log processi docume ntali  
 Stampa abilitazione intestatari   
 Stampa parametri


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N – D O C U M E N T  M A N A G E M E N T  
90 – S T A M P E  D O C U M E N T  M A N A G E M E N T   Stampa processi documen tali 
  
Permette la stampa dei processi documentali codificati con possibilità di filtrare per codice processo e 
classe documentale. I tipi di report sono due: la stampa standard e il dettaglio autorizzazioni.  
  
 
Stampa processi documentali


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – D O C U M E N T  M A N A G E M E N T  
S T A M P E  D O C U M E N T  M A N A G E M E N T  - 91  Stampa classi documentali  
  
Permette di stampare le classi documentali, con filtri sul tipo archiviazione, tabella archiviazione, 
tabella di riferimento per la ricerca (valore di riga). Anche qui i report sono due: la s tampa standard e 
dettaglio autorizzazioni  
  
 
Stampa classi documentali


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N – D O C U M E N T  M A N A G E M E N T  
92 – S T A M P E  D O C U M E N T  M A N A G E M E N T   Stampa preferenze di visualizzazione  
  
Permette la stampa preferenze di visualizzazione filtrando per utente e/o grupp o oppure per 
impostazione predefinita (default) ed, eventualmente, è possibile stabilire un filtro anche per intervallo 
di codici (utente o gruppo).  
  
 
Stampa preferenze di visualizzazione


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – D O C U M E N T  M A N A G E M E N T  
S T A M P E  D O C U M E N T  M A N A G E M E N T  - 93  Stampa autorizzazioni processi  
  
Consenti di stampare, con filtro su processo, classe documentale, codice utente, quali sono le 
operazioni consentite sul processo a ciascun operatore in base ai processi codificati. Per l'operazione 
di archiviazione sarà fo rnita la classe documentale con le operazioni autorizzate (Archivia, Visualizza, 
Elimina). Si dovranno anche considerare i permessi dati al gruppo ed esplicitarli per ogni singolo 
operatore. Gli output disponibili sono: Stampa per Processo, per Soggetto e per soggetto su Excel.  
  
 
Stampa autorizzazioni processi


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N – D O C U M E N T  M A N A G E M E N T  
94 – S T A M P E  D O C U M E N T  M A N A G E M E N T   Stampa log processi documentali  
  
La Stampa log processi documentali, permette la stampa del log relativo ai processi, i filt ri di selezione 
sono: l'utente, la data il processo, l'intestatario (Clienti, Fornitori No filtro).  
  
 
Stampa log processi documentali


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – D O C U M E N T  M A N A G E M E N T  
S T A M P E  D O C U M E N T  M A N A G E M E N T  - 95  Stampa abilitazione intestatari  
  
Permette la Stampa abilit azione intestatari con possibilità di filtrare in base un determinato intervallo 
di intestatari (Clienti, Fornitori, Agenti e Nominativi).  
  
 
Stampa abilitazione intestatari


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N – D O C U M E N T  M A N A G E M E N T  
96 – S T A M P E  D O C U M E N T  M A N A G E M E N T   Stampa parametri  
  
Questa gestion e permette di stampare i parametri di ricerca definiti per utente, gruppo o come valore 
predefinito.  
  
 
Stampa parametri  
  
 Soggetto  
E' possibile filtrare la stampa scegliendo solo i parametri di ricerca definiti per utente, oppure quelli 
definiti per g ruppo, oppure quelli definiti come Default oppure stampare Tutti i parametri di ricerca.


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


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N – D O C U M E N T  M A N A G E M E N T  
98 – S T A M P E  D O C U M E N T  M A N A G E M E N T  
 
________________________________________________________________________________  
_______________________________________________________________________________ _ 
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
___________ _____________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
________________________ ________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
_____________________________________ ___________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
__________________________________________________ ______________________________  
________________________________________________________________________________


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – D O C U M E N T  M A N A G E M E N T  
S E R V I Z I  D O C U M E N T  M A N A G E M E N T  - 99  SERVIZI DOCUMENT 
MANAGEMENT  
  
In questa parte vengono descritte le funzionalità di servizi o utilizzabili per l'aggiornamento di 
determinate anagrafiche relative al modulo Document Management.  
  
 Agenti/nominativi  
 Aggiornamento m assivo intestatari  
 Aggiornamento massivo tipologia e classe allegato  
 Valorizzazione attributi  
 Crea collegamento invia a


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N – D O C U M E N T  M A N A G E M E N T  
100  - S E R V I Z I  D O C U M E N T  M A N A G E M E N T   Agenti/nominativi  
  
Questa gestione consente di attivare in modo massivo le attività di processo su agenti o nominativi. In 
base alla selezione della combo box iniziale è possibile ricercare agenti o nominativi anche definendo 
un certo intervallo in base al codice. Per aggiornare le anagrafiche è sufficiente attivare uno o più 
check posti in calce alla maschera, selezionare i record da aggiornare dallo zoom e premere il bottone 
Esegui.  
  
I check attivabili per gli agenti sono:  
 Stampa  
 E-mail 
 Pec  
 Fax 
 Web Application  
 Postalite  
  
I check attivabili per i nominativi sono:  
 Stampa  
 E-mail 
 Pec 
 Fax 
 Web Application


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – D O C U M E N T  M A N A G E M E N T  
S E R V I Z I  D O C U M E N T  M A N A G E M E N T  - 101  
 
  
I nominativi che possono essere aggiornati da tale gestione sono quelli che non sono già clienti.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N – D O C U M E N T  M A N A G E M E N T  
102  - S E R V I Z I  D O C U M E N T  M A N A G E M E N T   Aggiorna mento massivo intestatari  
  
Questa gestione consente di attivare in modo massivo le attività di processo su clienti o fornitori. In 
base alla selezione della combo box Tipo è possibile ricercare clienti o fornitori anche definendo un 
certo intervallo in ba se al codice. Per aggiornare le anagrafiche è sufficiente attivare uno o più check 
posti in calce alla maschera, selezionare i record da aggiornare dallo zoom e premere il bottone OK.  
 
Aggiornamento massivo intestatari - Abilitazioni  
  
 
Aggiornamento massivo intestatari  
  
La stessa gestione è utilizzata da diversi moduli della procedura. Per la trattazione della stessa gestione 
relativamente alle altre opzioni disponibili all'interno della combo box Aggiorna dati si rimanda alla 
corrispondente documentazione.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – D O C U M E N T  M A N A G E M E N T  
S E R V I Z I  D O C U M E N T  M A N A G E M E N T  - 103  Aggiornamento massivo intestatari - Selezion i aggiuntive  
  
Nella seconda scheda è possibile definire in modo puntuale cosa proporre sullo zoom di selezione.  
  
 
Aggiornamento massivo intestatari - Selezioni aggiuntive  
  
Sono disponibili i seguenti filtri:  
 Categoria commerciale  
 Agente  
 Zona  
 Nazione  
 Categoria contabile  
 Partita IVA (per selezionare i record privi di tale dato)  
 Codice fiscale (per selezionare i record privi di tale dato)


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N – D O C U M E N T  M A N A G E M E N T  
104  - S E R V I Z I  D O C U M E N T  M A N A G E M E N T   Aggiornamento massivo tipologia e 
classe allegato  
  
Questa gestione permette di applicare in modo massivo una determinata combinazione di 
Tipologia/Classe allegato ai record selezionati nello zoom. Appenda si accede alla gestione il 
programma visualizza le classi documentali prive di tali dati (tipologia/classe) e ne consente così 
l'aggiornamento.  
  
 
Aggiornamento massivo tipologia e classe


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – D O C U M E N T  M A N A G E M E N T  
S E R V I Z I  D O C U M E N T  M A N A G E M E N T  - 105   V alorizzazione attributi  
  
La funzione ha l o scopo di aggiungere/variare gli attributi degli indici documento già presenti; ovvero 
in caso di variazione della classe documentale o del valore dell’attributo sull’anagrafica da cui viene 
letto, con questa funzione è possibile aggiornare gli indici ins eriti in precedenza.  
  
La funzione è applicabile solo per le classi documentali che rispettano i seguenti requisiti:  
 Modalità di archiviazione Copia file o Collegamento.  
 Campo tabella di riferimento per archiviazione rapida valorizzato (in sostanza non è 
utilizzabile per le classi documentali che prevedono valorizzazione attributi in base alla query di 
stampa, come g li indici documento generati da processo documentale).  
  
 
Visualizzazione attributi.  
  
 Classe documentale  
Consente di filtrare la Classe Documentale, tra quelle che hanno i requisiti per essere aggiornate, con il 
pulsante Ricerca saranno visualizzati tu tti gli indici appartenenti alla classe selezionata.  
 Seleziona  
Consente di selezionare tutte le righe.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N – D O C U M E N T  M A N A G E M E N T  
106  - S E R V I Z I  D O C U M E N T  M A N A G E M E N T   Deseleziona  
Consente di deselezionare tutte le righe.  
 Inverti Selezione  
Consente di invertire la selezione delle righe.  
 Visualizza  
Consente di vi sualizzare l’indice del documento archiviato.  
 Apri cartella  
Consente di aprire la cartella in cui si trova il documento archiviato.  
 Aggiungi attributi mancanti  
Se attivo, verranno aggiunti all’indice selezionato gli attributi non ancora presenti rispet to alla Classe 
Documentale.  
Al termine dell’elaborazione viene visualizzato un log, Aggiungi attributi mancanti.  
 Ricalcola attributi presenti  
Se attivo, vengono riletti gli attributi già presenti e aggiornati in caso di variazione o della Classe 
Document ale o del Valore sull’anagrafica d’origine.  
Al termine dell’elaborazione viene visualizzato il log, Ricalcola attributi presenti.  
 Elimina attributi non presenti  
Se attivo, consente di aggiornare l’indice rispetto agli attributi che sono stati eliminati d alla classe.  
L’elaborazione è tracciata all’interno di un log.  
Al termine dell’elaborazione viene visualizzato il log, Elimina attributi non presenti.  
 Numero riga da classe  
Se attivo, la procedura aggiorna gli indici con lo stesso numero di riga presente  nella classe 
documentale.  
 Ignora errori elaborazione  
Se attivo, in caso di errore su un attributo, la procedura non interrompe l’elaborazione ma aggiorna i 
restanti attributi.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – D O C U M E N T  M A N A G E M E N T  
S E R V I Z I  D O C U M E N T  M A N A G E M E N T  - 107   Crea collegamento invia a  
  
La funziona di INVIA A consente di inviare alla procedura Ahr uno o più documenti presenti 
all'interno di una cartella di sistema (quindi documenti prodotti precedentemente al di fuori d el 
programma). La funzione si attiva sfruttando la gestione di sistema INVIA A, alla quale viene 
aggiunta la voce Ahr con l'istruzione necessaria.  
  
 
Invia a  
  
La voce Ad hoc Revolution viene riportata con l'indicazione dell'azienda, questo perché, è poss ibile 
creare più collegamenti suddivisi per aziende e inviare i file all'azienda corretta.  
Configurazione  
Per l'attivazione della suddetta opzione è necessario procedere con la configurazione del servizio:


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N – D O C U M E N T  M A N A G E M E N T  
108  - S E R V I Z I  D O C U M E N T  M A N A G E M E N T   Installazione della libreria dynwrap.dll.  
  
Nel caso di nuova installazione la libreria viene installata automaticamente (copiata nella cartella 
Windows \System32) dalla procedura tramite l'avvio del NetSetup. Nel caso di Aggiornamento da una Release 
precedente, è necessario accedere al menù Servizi e la nciare la funzione di Installa Componenti; verificando che sia 
attivo il flag sulla voce Componenti per Invia A  
  
 
Installazione componenti  
  
 Indicare la classe documentale da utilizzare per la gestione dell'Invia A.  
  
 
Classe documentale Predefinita  
  
E' necessario attivare il check Predefinita su una sola classe documentale da utilizzare per 
l'archiviazione mediante l'Invia A.  
La procedura in fase di salvataggio avverte l'operatore dell'esistenza di altre classi con check 
predefinita attivo, impedendone il salvataggio.  
Si visualizzerà il seguente messaggio  
Errore: Sono presenti altre classi con check classe predefinita, selezione non ammessa . 
  
Nel caso in cui si attivi il check “predefinita” su una classe documentale con modalità archiviazione di 
tipo EDS la procedura spegne il automatico il check “predefinita”  
  
Nel caso in cui non si attivi il check Predefinita su una classe documentale al l'utilizzo dell'Invia A, la 
procedura avverte l'operatore mediante apposita messaggistica della mancanza della classe 
documentale utilizzabile da tale funzionalità.  
Si visualizzerà il seguente messaggio  
Classe documentale per l’invia a non definita.  
  
Accedere al menù Document Management \Servizi \ Crea collegamento invia a: in questa gestione 
vengono indicati i parametri necessari per effettuare l'accesso alla procedura e per creare il 
collegamento nella gestione di sistema Invia A.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – D O C U M E N T  M A N A G E M E N T  
S E R V I Z I  D O C U M E N T  M A N A G E M E N T  - 109  
 
Crea collegamento inv ia a 
  
 File CNF da utilizzare  
Occorre indicare un file di connessione CP3START.CNF, tale file deve contenere al suo interno una 
stringa per la connessione (silente o meno) al db.  
 Azienda  
E' possibile indicare l'azienda con cui accedere alla procedura e , ovviamente, sarà la stessa azienda al 
quale saranno associati i documenti inviati.  
 Utente con cui accedere  
Indicare l'utente con cui accedere alla procedura.  
 Password  
Indicare l'eventuale password con cui accedere alla procedura.  
 Esercizio  
Specific are l'esercizio con cui accedere alla procedura.  
 Utilizza stringa di accesso criptato  
Permette di decidere se utilizzare o meno una stringa di accesso criptata


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N – D O C U M E N T  M A N A G E M E N T  
110  - S E R V I Z I  D O C U M E N T  M A N A G E M E N T  Nel caso in cui la criptazione della stringa di accesso silente risulti attiva e nel CNF sel ezionato la funzionalità 
invece non risulta nè abilitata né correttamente definita (mediante la variabile pubblica Public 
g_CRYPTSilentConnect), alla conferma della creazione dell'icona la procedura propone un messaggio di Warning.  
  
 Inserisci nel sottom enù 
Se attivo, nel menù Invia A (attivo premendo il tasto destro su uno o più documenti) viene creato il 
sottomenù Ad hoc Revolution.  
 Commento  
Permette di inserire un commento da visualizzare nell'icona di collegamento;  
 Nome collegamento  
Consente di sp ecificare un nome al collegamento, un nome diverso rispetto a quello proposto in 
automatico dalla procedura.  
  
Alla conferma della maschera la procedura crea nella funzione di Invia A un collegamento 
all'applicativo con i parametri indicati nella configura zione.  
  
Utilizzo  
Selezionando quindi uno o più documenti tramite il tasto destro ed utilizzando la funzione di Invia A, 
si avvia una sessione di Ad hoc Revolution che propone la maschera di archiviazione documenti 
aperta e valorizzata con la classe docume ntale che ha attivo il check Predefinita.  
  
Archiviazione documenti  
  
 
Archiviazione documenti


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – D O C U M E N T  M A N A G E M E N T  
S E R V I Z I  D O C U M E N T  M A N A G E M E N T  - 111   Classe documentale  
Indicazione della classe documentale utilizzata per l'archiviazione (l'unica con attivo il check 
predefinita) con la quale saranno archiv iati i documenti.  
 Modalità archiviazione  
In automatico è proposta la modalità di archiviazione letta dalla classe documentale, con possibilità di 
modifica da parte dell'operatore.  
Le scelte possibili sono: Collegamento, Copia e Sposta.  
L'opzione sposta c onsente di effettuare una operazione di taglia e incolla del/dei file archiviati nel 
path di archiviazione indicato nella classe documentale.  
 Applica a tutti i documenti archiviati  
Questo flag si attiva solo nel momento in cui si selezionano contemporane amente più file da inviare 
all'applicativo per l'archiviazione con la funzione di Invia a, l'attivazione di questo check consente di 
applicare le impostazioni definite nella maschera di archiviazione documenti a tutti i documenti che 
saranno inviati al pro gramma per l'archiviazione.  
  
L'operatore dovrà i valorizzare la cartella attributi dell'archiviazione per poter collegare il file archiviato 
ai record presenti nella procedura.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N – D O C U M E N T  M A N A G E M E N T  
112  - S E R V I Z I  D O C U M E N T  M A N A G E M E N T  
 
_______________________________________________________________ _________________  
________________________________________________________________________________  
________________________________________________________________________________  
____________________________________________________________________________ ____  
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
________ ________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
_____________________ ___________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________


key: chroma:document
string_value:
Piattaforma Applicativa Gestionale  
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 Fattura CBI  
 
Release 8.0


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – F A T T U R A  C B I  
I N D I C I  - III Indice  
 
 Operazioni preliminari  ................................ ................................ .............................  5 
 Parametri fatture cbi  ................................ ................................ ................................ . 9 
 Distinta fatture cbi  ................................ ................................ ................................ .. 11 
 Visualizzazione fatture cbi  ................................ ................................ .....................  14 
 Aggiornamento massivo intestatari  ................................ ................................ ..... 16 
 
Le immagini della documentazione differiscono secon do 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  – F A T T U R A  C B I  
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  – F A T T U R A  C B I  
F A T T U R A  C B I  - 1 Fattura CBI  
  
ACBI (l'associazione per il Corporate Banking Interbancari o) e Assosoftware (l'associazione nazionale 
dei produttori di software gestionale e fiscale) hanno definito congiuntamente lo standard della 
Fattura CBI. Si tratta della possibilità di inviare le fatture ai rispettivi destinatari utilizzando il canale 
interbancario per la trasmissione delle stesse. Le fatture devono essere rappresentate da un file XML 
rispondente ad una struttura predefinita. Gli XML devono essere inviati ad una specifica banca 
tramite il front -end applicativo fornito da questa che provvede rà anche allo smistamento in modo tale 
che ogni fattura arrivi a destinazione.  
  
La fattura può essere rappresentata all'interno del file XML in diversi modi. Solo testata oppure testata 
+ corpo white label (standard sul quale le banche possono effettuare controlli di conformità), oppure 
testata + corpo pubblicato/non pubblicato ovvero testata in XML + file in standard diverso integrato 
all'interno del file XML (rappresentato come stream di dati in Base64). Sarà pubblicato o non 
pubblicato a seconda che il file integrato risponda o meno ad uno standard riconosciuto 
universalmente (ad esempio Edifact o Euritmo anziché uno standard proprietario definito dalle parti).  
  
ACBI ha partecipato ai principali gruppi di lavoro internazionali al fine di garantire uno s tandard ISO 
20022 compliant e quindi il riconoscimento della fattura CBI anche in Paesi diversi dall'Italia.  
  
Lo schema logico del servizio di invio E2E (end 2 end) delle fatture tra aderenti CBI è evidenziato dal 
seguente schema logico


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – F A T T U R A  C B I  
2 - F A T T U R A  C B I  L'Azienda Cr editrice predispone la fattura in formato elettronico (1) e provvede all'invio della stessa 
alla sua Banca Proponente (2). Questa la inoltra verso la Banca Proponente dell'Azienda Debitrice (3) 
che a sua volta la rende disponibile per l'accesso (4) ed invi a un messaggio di conferma di ricezione 
(5). Infine, l'Azienda Creditrice potrà accedere alla conferma di ricezione tramite il front -end 
applicativo della Banca Proponente. Questo schema è applicabile anche al caso di invio di documenti 
non strutturati com e file PDF o Immagini.  
L'azienda mittente può inviare una o più fatture alla propria Banca Proponente comunicandole anche 
l'azienda CBI destinataria.  
Per la predisposizione dei dati di testata è previsto l'uso di uno specifico formato definito da CBI, 
ment re per il corpo della fattura si possono presentare diversi scenari.  
Per ciascuno degli scenari riportati, il cliente dichiara se il flusso che trasmette è fattura elettronica o 
meno, valorizzando un apposito flag all'interno della Testata. Nel primo caso,  sussiste l'obbligo di 
apposizione della firma digitale per il cliente e l'obbligo di verifica da parte della Banca Proponente 
(del mittente e del destinatario) di presenza della stessa.  
  
Gli scenari previsti sono quelli evidenziati in figura  
  
 
  
 Scenario 1: in questo caso il messaggio contiene solo le informazioni riepilogative della fattura.  
 Scenario 2: il messaggio contiene la testata fattura ed un corpo di tipo non pubblicato come 
un file PDF, un'immagine, un formato strutturato concordato tra le  parti, ecc. In questo caso le 
Banche Proponenti non possono eseguire controlli formali di validità del documento. E' il 
cliente che deve preoccuparsi della presenza dei requisiti minimi della fattura.  
 Scenario 3: come lo scenario precedente, ma il corpo  della fattura è strutturato secondo uno


key: chroma:document
string_value:
 Scenario 3: come lo scenario precedente, ma il corpo  della fattura è strutturato secondo uno 
standard pubblico, ad esempio Edifact.  
 Scenario 4: in questo caso la fattura è composta da una Testata Fattura e da un Corpo Fattura 
strutturato secondo uno standard definito dal sistema e pubblicato dal CBI e su cui la Banca 
Proponente è in grado di eseguire controlli formali e di validità.  
  
Indipendentemente dallo scenario di riferimento, se il Cliente dichiara che sta inviando una fattura 
elettronica (in senso proprio, valorizzando appositamente il tag <InvTypC d> in testata ), è 
obbligatoria l'apposizione della firma digitale per garantire il requisito di integrità e autenticità della 
fattura stessa secondo normativa. Invece, nel caso di invio elettronico di fattura cartacea, la firma 
digitale può anche essere t ralasciata. Quando la firma viene apposta, deve essere utilizzato


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – F A T T U R A  C B I  
F A T T U R A  C B I  - 3 esclusivamente il formato PKCS#7 attached.  
  
A fronte dell'invio di un messaggio (o file più messaggio) contenente una o più distinte di fatture da 
parte della Banca Proponente del Mittente,  la Banca Proponente del Destinatario invia un solo 
messaggio di conferma ricezione eventualmente con gli errori rilevati. Opzionalmente la Banca 
Proponente del Destinatario può inviare anche un messaggio di accesso effettuato da parte di 
quest'ultimo comu nicando eventualmente anche lo stato di avanzamento sui singoli documenti, 
secondo lo schema seguente.  
  
 
  
Il mittente predispone il file XML della fattura tramite il front -end applicativo della sua Banca 
Proponente (1). Quest'ultima invia il messaggio a lla Banca Proponente del Destinatario (2) che riceve 
la fattura (3), effettua la verifica formale della congruità e completezza dei dati della fattura (4), 
predispone il messaggio XML di conferma ricezione (5) e lo invia alla Banca Proponente del Mittente 
(6). Il tempo massimo applicabile da Banca Proponente del destinatario per ricezione e verifica 
fattura, predisposizione ed invio della conferma di ricezione della fattura è un'ora. In un secondo 
momento, il destinatario accederà alla fattura tramite il fr ont-end applicativo della sua banca (7). 
Quest'ultima potrà inviare o meno un messaggio di conferma di accesso da parte del destinatario alla 
Banca Proponente del mittente.  
La banca che riceve il messaggio di conferma di ricezione o di accesso effettuato p rocede alla 
riconciliazione, ovvero all'identificazione dei messaggi ricevuti dalla Banca Proponente del 
Destinatario o di quelli per i quali il destinatario ha già effettuato l'accesso.  
  
Obiettivo dell'implementazione del modulo in ad hoc è, almeno inizi almente, quello di realizzare 
l'integrazione con il canale CBI attraverso la predisposizione dei file XML da inviare alla Banca


key: chroma:document
string_value:
l'integrazione con il canale CBI attraverso la predisposizione dei file XML da inviare alla Banca 
Proponente scelta dal cliente. Questo non significa necessariamente produrre un file firmato 
digitalmente, ma solo predisporre l 'applicativo in modo tale che sia possibile generare il file per una o 
più fatture secondo le specifiche CBI (solo testata, testata + corpo non pubblicato, testata + corpo 
pubblicato oppure testata + corpo white label).


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – F A T T U R A  C B I  
4 - F A T T U R A  C B I  Si ricorda che Fattura CBI e Fattu ra elettronica sono due cose diverse. Il file XML prodotto dal modulo può essere 
considerato fattura elettronica solo dopo l'apposizione sul file della firma digitale e del riferimento temporale 
mediante utilizzo di appositi dispositivi che, allo stato att uale, non sono integrabili in alcun modo sul gestionale. 
L'apposizione della firma digitale e del riferimento temporale possono avvenire solo dopo la generazione del file al di 
fuori di ad hoc.  
  
Lo schema seguente riepiloga in che modo possono essere gene rati i file XML relativi alla Fattura 
CBI. 
  
 
  
 Operazioni preliminari  
 Parametri fatture CBI  
 Distinte fatture CBI  
 Visualizzazione fatture CBI  
 Aggiornamento massivo intestatari


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – F A T T U R A  C B I  
F A T T U R A  C B I  - 5  Operazioni preliminari  
  
Affinché sia possibile la generazione dei file XML rappresentanti la fattura in standard CBI occorre 
preventivamente parametrizzare il gestionale. I parametri da impostare riguardano in particolare la 
struttura EDI d a utilizzare (presente anche se non viene utilizzato il modulo Vendite funzioni 
avanzate attraverso un caricamento da procedura di conversione) e la definizione del tipo di 
rappresentazione della fattura per ciascun cliente (Solo testata, Testata+Corpo whi te label, 
Testata+Corpo pubblicato o Testata + Corpo pubblicato). Quest'ultimo prerequisito può essere 
soddisfatto aggiornando le anagrafiche dei cliente in modo puntuale oppure utilizzando l'apposita 
funzione di aggiornamento massivo descritta successivam ente. 
  
Anagrafica Clienti  
  
 
  
 Fattura CBI  
Questa combo box permette di definire quale tipo di fattura deve essere generata per il cliente di 
riferimento. Le scelte possibili sono:  
 No: le fatture/note di credito del cliente non saranno selezionabili per l'abbinamento ad una


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – F A T T U R A  C B I  
6 - F A T T U R A  C B I  distinta per la generazione della fattura XML  
 Solo testata: per le fatture del cliente verrà generato un documento XML con i soli dati di 
testata secondo le specifiche CBI  
 Testata + corpo non pubblicato: per le fatture del clie nte verrà generato un documento 
XML con dati di testata secondo specifiche CBI con allegato all'interno di un Tag specifico un 
file classificato come indice documento di tipo formato elettronico. Se tale indice non esiste, il 
programma provvede autonomamen te alla creazione di tale indice.  
 Testata + corpo pubblicato: per le fatture del cliente verrà generato un documento XML con 
dati di testata secondo specifiche CBI con allegato all'interno di un Tag specifico un file 
classificato come indice documento di tipo formato elettronico. Se tale  indice non esiste, il 
programma non potrà proseguire con la generazione del file XML emettendo prima ancora di 
cominciare con la generazione del file una stampa con l'elenco dei documenti privi del formato 
elettronico.  
 Testata + corpo white label: per l e fatture del cliente verrà generato un documento XML con 
dati di testata e corpo secondo specifiche CBI. In tal caso la fattura viene rappresentata 
completamente utilizzando tutti i tag obbligatori previsti dallo schema XSD della fattura CBI  
  
Per l'aggio rnamento della combo box in oggetto è disponibile un'apposita funzione richiamabile da voce di menù.  
  
Struttura EDI  
Nei parametri del modulo deve essere stata definita la struttura EDI da utilizzare per la generazione 
del file XML. In assenza del modulo V endite funzioni avanzate la struttura EDI con codice 
FATT_CBI deve comunque essere presente (viene caricata da procedura di conversione), inoltre deve 
essere indicato il path di generazione dei file XML con struttura del nome file (Xml ed eventuale 
allegat o).


key: chroma:document
string_value:
allegat o). 
  
In presenza del modulo Vendite funzioni avanzate la struttura EDI FATT_CBI è visualizzabile ed 
eventualmente modificabile come una qualsiasi altra struttura EDI. Si differenzia dalle altre per la 
presenza del check Genera file CBI che la rende selezi onabile in Parametri Fattura CBI.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – F A T T U R A  C B I  
F A T T U R A  C B I  - 7 
 
  
Estensione allegati  
L'archivio Estensioni Allegati deve essere aggiornato tramite caricamento del file di testo presente 
nella cartella Files_x_import. Oltre all'estensione del file, per determinate tipologie di file , è già 
previsto il corrispondente valore da utilizzare come Estensione CBI nel momento di creazione di un 
indice documento di tipo formato elettronico. La creazione di un indice documento di tipo formato 
elettronico si rende necessaria nel caso in cui si debbano generare fatture CBI con dati di testata più 
corpo rappresentato come stream di dati codificato in Base64 da integrare all'interno del file XML in 
apposito Tag. In tal caso in un Tag distinto è previsto che venga indicata l'estensione CBI, ad esemp io 
PDFA se lo stream di dati rappresenta un file PDF . Per tale motivo sugli indici documento è presente 
oltre al check formato elettronico necessario ad identificare l'allegato da considerare per la 
generazione della fattura CBI anche il campo Estensione C BI valorizzato in modo automatico in base 
all'estensione del file. Nel file Estensioni_Allegati.txt fornito con ad hoc sono state definite le 
estensioni CBI solo per le seguenti tipologie di file:  
  
Estensione            Estensione CBI  
HTM                                 HTML  
JPG                                  JPEG  
JPEG                                 JPEG  
GIF                                   GIF_  
PDF                                 PDFA


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – F A T T U R A  C B I  
8 - F A T T U R A  C B I  RTF                                 RICH


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – F A T T U R A  C B I  
F A T T U R A  C B I  - 9  Parametri fatture cbi  
  
In questa anagrafica è possibile definire i parametri di base del modulo necessari alla generazione del 
file XML rappresentante una o più fatture/note di credito caricate in ad hoc.  
  
 
  
 Azienda  
Campo  non editabile definito sulla base del codice azienda in uso.  
 Codice struttura CBI  
Codice della struttura Edi da utilizzare per la generazione del file XML. Le strutture EDI selezionabili 
sono solo quelle identificate dal check Genera file CBI. In mancan za del modulo Vendite funzioni 
avanzate sarà comunque selezionabile la struttura EDI caricata da procedura di conversione 
FATT_CBI.  
 Codice banca proponente  
E' il codice della banca proponente scelta dall'utente che verrà utilizzata come default sul 
corrispondente campo della manutenzione distinte.  
 Sottocartella banche  
Questa combo box consente di definire se devono essere create/utilizzate delle sottocartelle 
all'interno del path definito per la generazione del file XML sulla base del codice o della des crizione 
della banca proponente.  
 File CBI  
Path per la generazione delle fatture CBI. La modifica di questo campo incide sul corrispondente 
campo in Gestione percorsi e viceversa.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – F A T T U R A  C B I  
10 - F A T T U R A  C B I   Nome file  
Consente di definire la struttura del nome del file XML con pos sibilità di utilizzare le seguenti 
variabili: banca di presentazione, numero distinta, data distinta, "date", "time" e progressivo.  
 Nome file  
Consente di definire la struttura del nome del file da inserire eventualmente come allegato del file 
XML (previa  codifica Base64) con possibilità di utilizzare le seguenti variabili: numero documento, 
serie documento, data documento, data registrazione, intestatario, "date", "time" e progressivo.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – F A T T U R A  C B I  
F A T T U R A  C B I  - 11  Distinta fatture cbi  
  
Questo archivio consente di creare le distinte di fatture/note di credito dalle quali generare i file XML 
delle fatture CBI. Ogni distinta potrà generare un solo file XML contenente tutti i documenti abbinati 
alla stessa ciascuno rappresentato in base a quanto definito nell'anagrafica dell'intestatario. I 
documenti intestati a clienti per i quali non è previsto l'invio della fattura CBI non saranno nemmeno 
abbinabili.  
  
 
  
 Numero - Del 
Numero della distinta generata e corrispondente data di inserimento  
 Data generazione  
Questa data viene valorizzata automaticamente solo dopo aver generato il file XML dalla distinta di 
fatture/note di credito.  
 Esercizio  
Esercizio di riferimento della distinta.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – F A T T U R A  C B I  
12 - F A T T U R A  C B I   Banca proponente  
Il programma propone la banca proponent e definita come default nei parametri, ma può essere 
modificata selezionando tra i conti banca.  
 Stato file  
Questa combo box definisce lo stato del file XML relativo alla distinta. Appena la distinta viene creata 
il file risulta ovviamente da generare e t ale valore non sarà modificabile manualmente. Il passaggio al 
secondo stato (Generato) avviene automaticamente solo dopo aver effettivamente generato il file. Lo 
stato Inviato può essere selezionato manualmente ad indicare che il file è stato inviato alla banca 
proponente tramite le modalità definite tra utilizzatore di ad hoc e la banca stessa. Lo stato Accettato 
indica che il file è stato accettato dalla banca proponente: in tal caso, al salvataggio della distinta il 
programma chiede all'utente se vuole e ffettivamente confermare perché la combo box diverrà non 
editabile. Lo stato Rifiutato indica che il file è stato rifiutato dalla banca proponente: in tal caso, al 
salvataggio della distinta il programma chiede all'utente se vuole effettivamente confermare  perché i 
documenti ad esso abbinati torneranno nuovamente abbinabili ad altre distinte.  
 Stato (distinta)  
Ogni distinta nasce in stato provvisorio. Solo dopo la generazione del file la distinta assume lo stato 
confermata. E' sufficiente lo stato provvisorio affinché i documenti già abbinati a distinta non siano 
abbinabili ad altre distinte. Lo stato confermata impedisce all'utente di abbinare ulteriori documenti 
alla stessa distinta.  
 Nome file  
Questo campo viene valorizzato con path e nome file dopo che è stato generato il file XML dalla 
distinta. In tal caso sarà anche disponibile il botto ne per aprirlo con il programma predefinito su 
Windows.  
 Apri XML  
Il bottone è presente solo dopo aver generato il file XML e consente di aprirlo con il programma 
predefinito su Windows.


key: chroma:document
string_value:
predefinito su Windows.  
 Dettagli  
Questo bottone consente di aprire il documento relativo a lla riga sulla quale si è posizionati.  
 Genera  
Il bottone per la generazione del file è visibile solo per distinte in stato provvisorio. Cliccando su 
Genera il programma effettua innanzitutto la verifica della presenza di un indice documento di tipo 
forma to elettronico per i documenti intestati a clienti per i quali è prevista la fattura CBI in standard 
Testata+Corpo pubblicato ed eventualmente restituisce un log di errore, mentre provvederà alla 
creazione automatica degli indici documento di tipo formato elettronico per i documenti intestati a 
clienti per i quali è prevista la fattura CBI in standard Testata+Corpo non pubblicato.  
 Abbina  
Il bottone abbina consente di accedere ad uno zoom con filtri di ricerca per associare i documenti 
(fatture e note di credito) alla distinta. Tale bottone sarà visibile solo per distinte in stato provvisorio. 
La ricerca dei documenti da abbinare p uò avvenire per causale, in base alla data documento, al tipo 
(fattura, nota di credito o entrambi), in base a numero e serie documento ed in base all'intestatario.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – F A T T U R A  C B I  
F A T T U R A  C B I  - 13 
 
Abbina documenti  
  
Lo stato della distinta e lo stato del file sono memorizzati nei dat i di testata di ogni documento. In 
particolare, lo stato della distinta (nei dati di testata del documento) determina se lo stesso è abbinabile 
o meno ad una nuova distinta: può assumere i valori No, Provvisoria e Confermata. Nel primo caso 
sarà abbinabile , mentre negli altri due casi no.  
  
La cancellazione di una distinta di fatture/note di credito è un'operazione sempre fattibile e rende i documenti che 
erano ad essa abbinati nuovamente disponibili per l'associazione ad una nuova distinta.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – F A T T U R A  C B I  
14 - F A T T U R A  C B I   Visualizzazione fatture cbi  
  
Questa gestione consente di monitorare lo status dei documenti di tipo Fattura/Nota di Credito con 
possibilità di filtrare sul loro stato, di richiamarli in visualizzazione e di acced ere alla manutenzione 
distinte.  
  
Visualizzazione fatture cbi - Fatture CBI  
  
 
Visualizzazione fatture cbi - Fatture CBI  
  
 Categoria  
Consente di definire se visualizzare fatture e note di credito oppure solo fatture o solo note di credito.  
 Causale  
Consente di filtrare i documenti abbinati a distinte CBI in base alla causale documento degli stessi.  
 Numero distinta  
Consente di filtrare in base al numero della distinta CBI


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – F A T T U R A  C B I  
F A T T U R A  C B I  - 15  Da - A 
Questi campi permettono di definire un range temporale con riferimento a lla data di registrazione 
delle distinte in modo tale da visualizzare solo i documenti abbinati a tali distinte.  
 Documenti Dal - Al 
Questi campi permettono di definire un range temporale con riferimento alla data documento in 
modo tale da visualizzare so lo quelli che cadono in tale intervallo.  
 Stato file  
Permette di filtrare i documenti da visualizzare in base allo stato del file XML relativo alla distinta 
CBI. 
 Stato distinta  
Permette di filtrare i documenti da visualizzare in base allo stato della di stinta CBI.  
 Visualizza  
Questo bottone richiama il documento selezionato dalla gestione documenti.  
 Origine  
Questo bottone richiama la distinta nella quale è stato abbinato il documento evidenziato sullo zoom.  
  
Visualizzazione fatture cbi - Selezioni ag giuntive  
  
Nella scheda Selezioni aggiuntive è possibile filtrare in base all'intestatario dei documenti (da cliente, a 
cliente).  
  
 
Visualizzazione fatture cbi - Selezioni aggiuntive


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – F A T T U R A  C B I  
16 - F A T T U R A  C B I   Aggiorn amento massivo intestatari  
  
Questa gestione consente di impostare per più clienti contemporaneamente il tipo di fattura CBI da 
generare. La gestione per l'aggiornamento della combo box fattura CBI disponibile in anagrafica 
clienti è la stessa utilizzata d a altre funzioni di aggiornamento relative ad altri moduli (Document 
Management, Contributi accessori). Per tale motivo è disponibile la combo box Aggiorna dati che 
viene preimpostata a seconda della voce di menù dalla quale viene lanciata la gestione. I f iltri di ricerca 
disponibili sono i medesimi: è possibile ricercare i clienti da aggiornare in base al codice ed in base a 
quanto presente nelle selezioni aggiuntive (categoria commerciale, agente, zona, nazione, categoria 
contabile e presenza o meno del c odice fiscale e/o della partita IVA).  
  
 
  
 Aggiorna dati  
Quando la gestione viene lanciata dalla voce di menù del modulo Fattura CBI il valore predefinito è 
Fatturazione CBI in modo tale che la funzione di aggiornamento operi esclusivamente sul tipo di 
fattura CBI da generare anziché sulle impostazioni relative ad altri moduli della procedura (Document 
Management, Contributi accessori, CPZ).  
 Da intestatario - A intestatario  
Questi campi consentono di definire un intervallo di codici clienti da ricercar e e visualizzare nello


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – F A T T U R A  C B I  
F A T T U R A  C B I  - 17 zoom.  
 Ricerca  
Il bottone consente di lanciare la ricerca in base ai filtri di selezione impostati. Lo zoom visualizzerà i 
clienti che rispondono ai criteri di ricerca definiti.  
 Seleziona/Deseleziona tutte  
Questo radio box consent e di selezionare/deselezionare tutte le righe presenti sullo zoom. Solo per le 
righe selezionate verrà applicata la modifica definita nella combo box Fattura CBI.  
 Fattura CBI  
In questa combo box occorre definire il valore da applicare a tutti i clienti s elezionati nello zoom. Per 
applicare le modifiche occorre premere il bottone OK in calce alla maschera.


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


key: chroma:document
string_value:
Piattaforma Applicativa Gestionale  
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 Gestione premi di fine anno  
 
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 qua lsiasi 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  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
I N D I C I  - III Indice  
 
Modulo Gestione premi di fine anno  ................................ ............................  1 
 OPERAZIONI PRELIMINAR I ................................ ................................ ...................  3 
 Premessa sul modulo Gestione premi di fine anno  ................................ ...........  4 
 Modifiche archivi di base  ................................ ................................ .........................  8 
 GESTIONE PREMI DI FIN E ANNO  ................................ ................................ ........  15 
 Gruppi di acquisto  ................................ ................................ ................................ .. 16 
 Contratti a obiettivo/PFA  ................................ ................................ .....................  18 
 Duplicazione contratti  ................................ ................................ ............................  29 
 Stampa contratti  ................................ ................................ ................................ ...... 35 
 Definizione attributo  ................................ ................................ ..............................  37 
 Gruppo famiglie attributi articoli  ................................ ................................ ......... 40 
 Gruppi causali di magazzino ................................ ................................ .................  42 
 Generazione premi  ................................ ................................ ................................ . 43 
 Calcolo premio  ................................ ................................ ................................ ........ 46 
 ESEMPI CONTRATTI A OBIETTIVO /PFA  ................................ ............................  49 
 Contratto obiettivo/PFA con calcolo premio su scaglione max  ...................  50


key: chroma:document
string_value:
 Contratto obiettivo/PFA con calcolo premio su scaglione max  ...................  50 
 Contratto ad obiettivo/PFA con calcolo premio Progressivo  .......................  55 
 Contratto ad obiettivo/PFA con calcolo premio Cumulativo  .......................  59 
 Determinazione pezzi/valore venduto/acquistato per document o senza 
aggiornamento magazzino  ................................ ................................ ..............................  62 
 Contratto ad obiettivo/PFA intestato a gruppo di acquisto  ..........................  68 
 Contratto ad obiettivo/PFA intestato ad agente  ................................ ..............  72 
 Contratto a obiettivo/PFA con punti  ................................ ................................ . 76 
 Contratto a obiettivo/PFA con articolo omaggiato  ................................ ......... 79 
 Contratto ad obiettivo/PFA definendo nei parametri contratti a obiettivo 
Calcolo proporzionale su Importo  ................................ ................................ ................  83 
 Contratto ad obiett ivo/PFA definendo nei parametri contratti a obiettivo 
Calcolo proporzionale su Quantità  ................................ ................................ ...............  87 
 Contratto ad obiettivo/PFA con attrib uti ................................ ..........................  91 
 Contratto ad obiettivo/PFA con tipo storno per articolo  ..............................  94 
 Contratto ad obiettivo/PFA con flag Escluso da premio agente  ..................  98 
 Contratto ad obiettivo/PFA con flag Sconto incondizionato  .....................  104  
 Ripartizione premio per mese  ................................ ................................ ............  106  
 
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  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
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  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  - 1 Modulo Gestione premi 
di fine anno  
  
 OPERAZIONI PRELIMINAR I 
 GESTIONE PREMI DI FIN E ANNO  
 ESEMPI CONTRATTI A OBIETTIVO /PFA


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
2 – E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  
 
____________________________________________________ ____________________________  
________________________________________________________________________________  
________________________________________________________________________________  
_________________________________________________________________ _______________  
________________________________________________________________________________  
________________________________________________________________________________  
______________________________________________________________________________ __ 
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
__________ ______________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
_______________________ _________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  - 3  OPERAZIONI PRELIMINAR I 
  
 Premessa sul modulo Gestione premi di fine anno  
 Modifiche archivi di base


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
4 – E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A   Premessa sul modulo Gestione premi 
di fine anno  
  
Mediante questo modulo si vuole dare risposta alla crescente domanda di s oluzioni standard ad hoc 
Revolution relative alle diverse operatività commerciali in uso nella catena della D.O. e della G.D.O.  
  
Con la denominazione Gestione premi di fine anno andremo quindi ad identificare le azioni 
commerciali che conducono ad un rifl esso indiretto sul prezzo finale di vendita, differito nel tempo (a 
scadenza prefissata).  
Tra le tipologie di azioni qui considerate meritano particolare attenzione quelle riconducibili alle 
operazioni a premio (contratti obiettivo per agenti e clienti o r iconosciuti da fornitori) che possono 
concretizzarsi in sconti di natura monetaria o in materiale o con la corresponsione di omaggi di altra 
natura.  
  
Abbuoni e sconti commerciali devono essere imputati in diminuzione del ricavo o del costo cui si 
riferisc ono e non devono quindi apparire autonomamente in bilancio  
Sconti e abbuoni finanziari (es.: sconto cassa) vanno invece imputati a conto economico tra gli 
oneri/proventi finanziari alla voce C.16 / C.17.  
  
In generale, se non previsti contrattualmente, van no supportati da idonea documentazione allo scopo 
di evitare possibili contestazioni in merito alla loro deducibilità; errate imputazioni di abbuoni e sconti 
attivi possono influire sulla valorizzazione delle rimanenze e sulla corretta determinazione delle  
imposte (gli sconti finanziari non sono deducibili ai fini Irap).  
  
Rilevazioni Generiche  
Le scritture, per gli abbuoni attivi commerciali, potrebbero essere:  
  
Fornitori  a Abbuoni commerciali attivi su 
acquisti B.6  
Abbuoni commerciali attivi su 
acquisti  a Merci X c/ acquisti  
  
Il giroconto nel merci conto acquisti non è necessario purché si tenga memoria in sede di


key: chroma:document
string_value:
Il giroconto nel merci conto acquisti non è necessario purché si tenga memoria in sede di 
elaborazione del bilancio Ue che abbuoni attivi e passivi commerciali vanno indicati in diminuzione 
rispettivamente degli acquisti (B.6) e d ei ricavi (A.1).  
  
La scrittura, per gli abbuoni attivi finanziari, potrebbe essere:  
  
Fornitori  a Abbuoni e sconti attivi C. 16  
  
Resi, sconti commerciali, abbuoni e premi relativi a operazioni di competenza del passato esercizio 
devono essere inseriti t ra gli oneri straordinari altri costi (voce E.21), se passivi o tra i proventi 
straordinari (E.20) se attivi.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  - 5 Premi di fedeltà  
Detti anche sconti quantità o ristorni differiti traggono origine dalle vendite ad un prezzo che, in un 
tempo successivo, per e ffetto del raggiungimento di un determinato obiettivo, di solito il volume di 
affari, subirà una riduzione.  
Si possono verificare i seguenti casi:  
Premio la cui maturazione oltrepassa la chiusura dell'esercizio  
Cedente : 
al 31.12 accantona la quota di compe tenza (c.e. B.13) in un apposito fondo (SP passivo B.3). 
Nell'esercizio di maturazione del premio: utilizza il fondo per la quota accantonata fino al 31.12 
precedente e imputa tra gli sconti e abbuoni su vendite il residuo (in diminuzione della voce di c.e . 
A.1). 
Per essere fiscalmente deducibili, devono risultare da atto scritto. La deducibilità fiscale avviene 
interamente nell'esercizio di maturazione e non man mano che si effettuano gli accantonamenti.  
Cessionario : 
contabilizza il premio solo nell'eserci zio di maturazione finale imputando la quota di competenza tra 
gli sconti e abbuoni su acquisti (in diminuzione della voce di c.e. B.6) e la quota di esercizi precedenti 
tra i proventi straordinari (c.e. E.20).  
  
Premio la Cui maturazione si esaurisce nell 'arco dell'esercizio  
Cedente : 
il premio va imputato tra gli sconti e abbuoni su vendite (in diminuzione della voce di c.e. A.1). Se, per 
lungaggini procedurali il premio viene conosciuto oltre la data di stesura del bilancio, andrà 
contabilizzato tra gli o neri straordinari.  
Cessionario : 
il premio va contabilizzato tra gli sconti e abbuoni su acquisti (in diminuzione della voce di c.e. B.6). 
Se il cessionario viene a conoscenza del premio nell'esercizio successivo a quello di competenza, allora 
inserirà i pr emi tra i proventi straordinari (c.e. E.20).  
  
Il trattamento fiscale previsto per l'IVA e le imposte dirette


key: chroma:document
string_value:
Il trattamento fiscale previsto per l'IVA e le imposte dirette  
Le operazioni a premio possono essere dirette sia agli acquirenti delle merci, sia agli stessi 
rappresentanti incaricati della vendita delle merci . Gli agenti di vendita in generale per vedersi 
attribuire i punti necessari a ottenere il premio, devono vendere un quantitativo minimo di prodotti. 
Questo quantitativo rappresenta dunque l'obiettivo di vendita.  
  
IVA 
L'Iva assolta sull'acquisto di beni o  servizi destinati a premio è indetraibile.  
L'indetraibilità deve essere riferita però "esclusivamente ai beni messi in palio" (cfr. art. 5 Legge 18 
febbraio 1999 n. 28) e non anche agli altri beni o servizi funzionali allo svolgimento della 
manifestazione , come ad esempio le spese di pubblicità, i compensi delle agenzie, ecc..  
  
Nell'ipotesi di premi costituiti da beni o servizi non imponibili ai fini Iva, deve essere versata 
un'imposta sostitutiva del 20 per cento del prezzo d'acquisto degli stessi.  
  
Per quanto concerne la successiva fase dell'assegnazione dei premi ai legittimi assegnatari, si ritiene ai 
sensi dell'art. 2 D.P .R. n. 633/1972, che sia un'operazione posta fuori campo Iva.  
  
Documenti da emettere  
Le note di variazione devono essere emesse ne l rispetto dell'art. 26/633 (per le rettifiche conseguenti 
ad accordi tra le parti intervenute successivamente alla stipula e per inesattezze nella fatturazione il


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
6 – E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  termine per recuperare l'Iva è di un anno; per rettifiche conseguenti ad accordi inseriti ne l contratto 
originario, non c'è termine).  
  
Premi in denaro  
I premi fedeltà in denaro versati dal cedente al cessionario a ristorno del prezzo originariamente 
pattuito e pagato, sono fuori campo Iva ex art. 2 (R.M. 102/Edel 17/09/2004). Se invece si è in 
presenza di contributi promozionali, essi vanno assoggettati ad Iva 20%, in quanto trattasi di 
prestazione eseguita (e fatturata) dal cessionario.  
  
Plafond  
Nelle cessioni internazionali abbuoni e sconti commerciali e finanziari compresi quelli per cassa 
riducono il plafond di cui all'art. 8/633, anche se non è stata emessa nota di variazione.  
  
Imposte Dirette  
Per quanto riguarda le imposte dirette, si possono verificare due diverse situazioni, a seconda che i 
premi, nell'esercizio in cui inizia la manifest azione, non siano ancora stati acquistati oppure siano 
acquistati nell'esercizio in cui si svolge la manifestazione. Nel primo caso l'art. 107 comma 3 TUIR 
prevede la possibilità per l'azienda che organizza la manifestazione, di accantonare in appositi fon di 
del passivo, "distinti per esercizi di formazione", una somma pari a quello che si presume essere 
l'esborso finanziario da sostenere per l'acquisto dei beni oggetto della promozione. Questi 
accantonamenti sono deducibili, negli esercizi di formazione, i n misura non superiore al 30 per cento 
del loro ammontare per le operazioni a premio ed al 70 per cento per i concorsi a premio.  
L'utilizzo del fondo alimentato dagli accantonamenti deve essere effettuato nel momento in cui si 
verifica l'effettivo sostenim ento dell'onere. La differenza fra il costo effettivamente sostenuto e la 
copertura del fondo, qualora sia positiva, determinerà una sopravvenienza passiva (deducibile),


key: chroma:document
string_value:
copertura del fondo, qualora sia positiva, determinerà una sopravvenienza passiva (deducibile), 
qualora sia negativa, determinerà una sopravvenienza attiva (tassabile).  
La norma prev ede che l'ammontare dei fondi non utilizzato al termine del terzo esercizio successivo a 
quello di formazione concorre a formare il reddito dell'esercizio stesso, a titolo di sopravvenienza 
attiva. Se invece i premi sono acquistati nell'esercizio in cui si  svolge la manifestazione, le relative spese 
sono da considerarsi integralmente deducibili; sia che le si consideri spese di pubblicità (come sembra 
confermare anche la Risoluzione n. 54 del 26.03.2004), risultando il premio per il percettore un 
componente  reddituale soggetto a prelievo tributario (un componente tassabile per il soggetto 
percettore, del resto, deve necessariamente rappresentare un costo deducibile per il soggetto 
erogante), sia che le si consideri spese che vanno a incremento del costo per provvigioni.  
Sia l'Iva indetraibile che l'eventuale imposta sostitutiva sui premi corrisposti ai vincitori costituiscono 
oneri deducibili, in quanto costi accessori all'operazione medesima.  
Per quanto interessa gli elementi classificabili in voci di Conto economico rilevanti sia ai fini Irap sia ai 
fini delle imposte sui redditi, gli stessi devono essere assunti ai fini Irap secondo gli stessi criteri ed in 
base agli stessi principi previsti dagli articoli del TUIR.  
Ne deriva che i costi per manifestazioni a premio rileveranno, anche ai fini Irap, nei limiti considerati 
ai fini Ires. L'art. 19 comma 2 Legge n. 449/1997, nell'ipotesi in cui i beni assegnati assumono per il 
beneficiario rilevanza reddituale, ha esteso la tassazione con ritenuta definitiva anch e alle vincite 
derivanti da operazioni a premio.  
La norma specifica però che la ritenuta d'imposta non deve essere operata nei casi in cui altre 
disposizioni di legge prevedono l'applicazione di ritenute alla fonte.


key: chroma:document
string_value:
disposizioni di legge prevedono l'applicazione di ritenute alla fonte.  
La ritenuta sui premi non si applica qua ndo i premi sono assegnati ad un lavoratore dipendente, ad un 
lavoratore autonomo, ad un agente od ad un intermediario di commercio, in quanto gli art. 23, 25 e 
25-bis D.P .R. n. 600/1973 prevedono l'applicazione di specifiche ritenute sui redditi corrispos ti a 
queste categorie di soggetti.  
La ritenuta sui premi, afferma ancora l'art. 19 comma 2 Legge n. 449/1997, non deve essere applicata


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  - 7 se il valore complessivo dei premi attribuiti a uno stesso soggetto, nell'ambito del medesimo periodo 
d'imposta, non sup eri 50mila lire (25,82 Euro); se superiore, la ritenuta sarà applicata sull'intero valore.  
  
Funzionalità base  
Un contratto deve definire la possibilità di applicare condizioni correlate ad un evento 
(vendita/acquisto) riconducibili essenzialmente a ristor ni di prezzo (immediati o differiti), quantità di 
articoli in sconto merce, vendita a condizioni particolari di altro articolo, aggiornamento di un 
contatore di articoli ceduti tale da definire l'eventuale fine validità del contratto stesso.  
Occorre poter distinguere nettamente la gestione dei contratti d'acquisto rispetto a quelli di vendita.  
Il contratto si deve poter applicare ad una referenza direttamente mediante i suoi codici oppure per 
mezzo di una categoria come, ad esempio, un gruppo merceologico, una famiglia, una classe di 
ricarico, un attributo etc.  
Parimenti deve poter essere definibile la sua applicabilità all'intestatario del documento mediante 
associazione diretta o per categorie di raggruppamento.  
Devono potersi gestire contratti di Tipologi a Premi ad agenti: occorre altresì definire sui contratti 
cliente se le vendite ad esse relative partecipano o meno al raggiungimento dell'obiettivo per l'agente.  
Deve poter essere definito il/i listini cui il contratto è applicabile oppure la sua validità  a prescindere 
dal listino applicato.  
Ovviamente le condizioni commerciali, prezzi e sconti, devono poter essere applicate a tutti i clienti 
(fornitori), oppure a classificazioni di clienti (fornitori).  
Deve quindi essere garantita la generazione di righe o documenti di storno tali per cui il valore del 
magazzino risulti allineato alla valorizzazione contabile e le statistiche di vendita/acquisto riportino


key: chroma:document
string_value:
l'esatto valore di periodo.  
Dalla generazione dei documenti di ristorno deve essere possibile generare  note di credito/note di 
debito.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
8 – E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A   Modifiche archivi di base  
  
Parametri contratti a obiettivo  
  
A seguito dell'introduzione del modulo Gestione premi di fine anno sono state realizzate le seguenti 
modifiche negli archivi di base.  
E' stata introdotta nel menu Archivi - Contropartite e parametri la nuova gestione Parametri contratti 
a obiettivo  
  
 
Menu parametri contratti a obiettivo


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  - 9 
 
Parametri contratti a obiettivo  
  
 Etichette per sconti incond izionati  
Rappresentano le etichette per gli sconti incondizionati che è possibile definire sul contratto.  
 Servizio a valore  
Identifica il servizio a valore con il quale viene ripartito il premio sulla fattura/nota di credito, nel caso 
in cui il tipo stor no sul contratto esaminato è impostato a FORFETTARIO.  
 Servizio descrittivo per note  
Identifica il servizio descrittivo che viene utilizzato per riportare le note di generazione di un contratto 
ad effetto immediato.  
 Servizio a quantità e valore per punt i 
Identifica il servizio a quantità e valore che viene utilizzato per riportare sulla fattura/nota di credito 
eventuali punti accumulati.  
 Um 
Identifica l'unità di misura di movimentazione del servizio a quantità e valore per i punti.  
 Calcolo proporzion ale 
 Su importo  
Il peso viene determinato sull'importo del venduto.  
 Su quantità  
Il peso viene determinato sulle quantità vendute.  
 Codice iva premio  
Identifica il codice iva che viene utilizzato sulla riga del premio nella fattura/nota di credito.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
10 – E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A   Categoria contabile.  
Campo attualmente non gestito  
 Codice pagamento  
Identifica il codice pagamento che verrà utilizzato sui documenti creati in fase di generazione premio.  
  
Causali per generazione documenti  
Identificano le causali che l'operatore dovrà ca ricare poiché particolari per la generazione dei 
documenti post generazione premi.  
Nostra fattura : sarà una causale documento di tipo fattura del ciclo attivo intestata a cliente 
(consigliamo di utilizzare una serie in modo da individuarle e in modo che in  fase di generazione 
venga calcolato il numero documento progressivamente).  
Nostra nota di credito : sarà una causale documento di tipo nota di credito del ciclo attivo intestata a 
cliente.  
Documento di attesa Vostra fattura : sarà una causale documento di t ipo documento interno del 
ciclo passivo intestata a fornitore (consigliamo di utilizzare una serie in modo da individuarle e in 
modo che in fase di generazione venga calcolato il numero documento progressivamente Check 
numerazione vendite).  
Documento di at tesa Vostra nota di credito : sarà una causale documento di tipo documento 
interno del ciclo passivo intestata a fornitore (consigliamo di utilizzare una serie in modo da 
individuarle e in modo che in fase di generazione venga calcolato il numero documento 
progressivamente Check numerazione vendite).  
Documento di attesa Vostra fattura (agente) : sarà una causale documento di tipo documento 
interno del ciclo passivo intestata a fornitore (consigliamo di utilizzare una serie in modo da 
individuarle e in modo ch e in fase di generazione venga calcolato il numero documento 
progressivamente Check numerazione vendite).  
  
Per poter generare documenti di attesa Vostra fattura e Vostra nota di credito è necessario creare e collegare (campo


key: chroma:document
string_value:
collegamento valorizzato) ai c lienti utilizzati nei contratti ad obiettivo/PFA una corrispondente anagrafica nel ciclo 
passivo.  
  
 Gruppo causali di magazzino  
Identifica il gruppo di causali di magazzino che verranno considerate per calcolare il fatturato.  
  
Articoli/Servizi  
Le gestio ni articoli/servizi è stata arricchita dalla pagina Premi, la pagina sarà attiva solo se presente il 
modulo di gestione premi di fine anno.  
La pagina premi permette di associare ad articoli/servizi il set di attributi desiderati.  
Gli attributi sono stati i ntrodotti per permettere logiche aggregative nella definizione dei contratti ad 
obiettivo/PFA.  
Nel modulo di gestione premi di fine anno verrà definito un unico gruppo di attributi che permetterà 
all'utente di digitare direttamente la famiglia e quindi l'a ttributo senza dover digitare anche il gruppo.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  - 11 
 
Pagina premi anagrafica articoli  
  
 Importa  
Il bottone importa del dettaglio attributi inserisce automaticamente tutti gli attributi obbligatori 
dell'unico gruppi attributi creato nella gestione premi di fine anno.. L'utente dovrà solo indicare i 
valori per ciascun attributo.  
Nel modulo di gestione premi di fine anno viene definito infatti un unico gruppo di attributi che 
permetterà all'utente di digitare direttamente la famiglia e quindi l'attributo senza  dover digitare anche 
il gruppo.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
12 – E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  
 
Pagina premi anagrafica servizi


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  - 13 
 
________________________________________________________________________________  
________________________________________________________________________________  
__________________ ______________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
_______________________________ _________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
____________________________________________ ____________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
_________________________________________________________ _______________________  
________________________________________________________________________________  
________________________________________________________________________________  
______________________________________________________________________ __________  
______________________________________________________________________ __________


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
14 – E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  
 
________________________________________________________________________________  
________________________________________________________________________________  
__________________ ______________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
_______________________________ _________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
____________________________________________ ____________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
_________________________________________________________ _______________________  
________________________________________________________________________________  
________________________________________________________________________________  
______________________________________________________________________ __________  
________________________________________________________________________________


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  - 15  GESTIONE PREMI DI FIN E 
ANNO  
  
Gli archivi del modulo Gestione premi di fine anno contengono i dati indispensabili  per un corretto 
funzionamento del modulo.  
La figura sottostante mostra i menu, ogni voce verrà dettagliatamente trattata nel rispettivo paragrafo.  
Il modulo Gestione premi di fine anno è utilizzabile sia dal menu Vendite, sia dal menù Acquisti.  
  
 
Menu g estione premi di fine anno  
  
 Gruppi di acquisto  
 Contratti a obiettivo/PFA  
 Duplicazione contratti  
 Stampa contratti  
 Definizione attributo  
 Gruppo famiglie attributi articoli  
 Gruppi causali di magazzino  
 Generazione premi  
 Calcolo premio


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
16 – E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A   Gruppi di acquisto  
  
Attraverso questa funzione si definisce la tabella che permette di raggruppare Codici Clien ti/fornitori 
in modo tale da considerare il fatturato complessivo dei clienti/fornitori per il raggiungimento degli 
obiettivi e di definirne uno come primario.  
  
 
Gruppi di acquisto  
  
Nel caso in cui il contratto ad obiettivo venga intestato a un gruppo d i acquisto la procedura verifica 
tutti i documenti intestati ai clienti/fornitori definiti all'interno del gruppo di acquisto. Il flag centrale 
consente di identificare il codice cliente/fornitore al quale viene intestato il documento fiscale.  
  
In fase di  caricamento viene effettuato un controllo sulla necessità di attivare necessariamente il flag 
Centrale su un intestatario. Se si cerca di attivare il flag Centrale su più intestatari, la procedura avvisa 
l'operatore con il messaggio  
  
 
Salvataggio gruppi  di acquisto


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  - 17   
Per maggiori informazioni si rimanda all'esempio Contratti ad obiettivo intestato a gruppo di acquisto.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
18 – E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A   Contratti a obiettivo/PFA  
  
Contratti a obiettivo/PFA - Contratto  
  
 
Contratti a obiettivo PFA - Contratto  
  
 Codice  
Identifica il codice del contratto stipulato direttamente o indirettamente mediante attributi con il 
cliente.  
 Descrizione  
Identifica la descrizione parlante del contratto.  
 Del 
Data di stipulazione del contratto.  
 Stato  
 Sospeso: un contratto  sospeso non viene applicato.  
 Da elaborare: un contratto che applica i suoi effetti.  
  
Al salvataggio la procedura chiede all'operatore di passare lo stato del contratto da Sospeso a Da 
elaborare


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  - 19  Valuta  
Identifica la valuta del contratto, nel caso in c ui il contratto viene stipulato in valuta extra -emu viene 
visualizzato il campo cambio.  
 Validità  
Intervallo di validità del contratto.  
 Intestatario  
Identifica l'intestatario del contratto.  
 Cliente  
 Agente  
 Gruppo di acquisto  
  
La procedura per la d eterminazione del premio verifica tutti i documenti con medesimo intestatario.  
  
Attenzione: la procedura considera solo i documenti che hanno la causale di magazzino presente nel gruppo di 
causali di magazzino indicato nei Parametri contratti a obiettivo.  
  
 Corresp. Premio  
 Unitaria centrale: questo campo si attiva solo esclusivamente se il contratto è intestato a un 
gruppo di acquisto, identifica come verrà corrisposto il premio.  
 Dati consuntivi al  
Identifica la data che viene aggiornata in AUTOMATICO d alla procedura nel momento stesso in cui 
avviene la generazione del premio.  
Questa data non è editabile poiché è la procedura che la valorizza automaticamente.  
Un contratto con questa data valorizzata non può essere cancellato.  
 Priorità  
Identifica la pri orità di testata di un contratto, a parità di condizioni la procedura applicherà se valido il 
contratto con priorità di testata più elevata (campo attualmente non gestito).  
 Tipo storno  
 Forfettario la ripartizione del premio avviene utilizzando il servi zio a valore definito nelle 
contropartite e vincoli.  
 Ripartito per articolo : la ripartizione del premio avviene su tutti gli articoli che partecipano 
alla determinazione del fatturato.  
 Valido su tutte le vendite  
Questo flag definisce se un contratto è  o meno valido indipendentemente dal/i contratto/i applicato 
sul documento.  
Se attivo: significa che il contratto a obiettivo/PFA è valido indipendentemente dal/i contratto/i


key: chroma:document
string_value:
Se attivo: significa che il contratto a obiettivo/PFA è valido indipendentemente dal/i contratto/i 
utilizzato sul documento.  
Se disattivo: è possibile specificare per quali contrat ti il contratto a obiettivo/PFA è o no valido.  
Nel caso in cui tale flag sia disattivo è possibile definire i contratti che determineranno l'applicazione o 
meno del contratto nella generazione dei premi di fine anno, infatti se il codice contratto indicato  nel 
contratto a obiettivo/PFA non è identico a quello definito sulle righe del documento il contratto a


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
20 – E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  obiettivo/PFA non sarà valido e non verrà considerato nella generazione dei premi di fine anno  
Il contratto a obiettivo/PFA sarà invece valido se i con tratti utilizzati nel documento sono stati 
associati al contratto a obiettivo/PFA utilizzato nella generazione dei premi di fine anno.  
 Contratti  
Il bottone risulta editabile ed utilizzabile se disattivo il check Valido su tutte le vendite, il bottone 
permette di accedere alla gestione contratti associati nella quale indicare per quali contratti il contratto 
a obiettivo/PFA risulta o no valido.  
  
 
Contratti associati  
  
 Valido su tutti i listini  
Questo flag definisce se un contratto è o no valido su qualsiasi listino applicato sul documento.  
Se attivo: significa che il contratto a obiettivo/PFA è valido indipendentemente dal listino uti lizzato 
sul documento.  
Se disattivo: è possibile specificare su quali listini il contratto a obiettivo/PFA è o no valido.  
Nel caso in cui tale flag sia disattivo è possibile definire i listini che determineranno l'applicazione o 
meno del contratto nella ge nerazione dei premi di fine anno, infatti se il codice listino indicato nel 
contratto non è identico a quello definito sulle righe del documento il contratto non sarà valido e non 
verrà considerato nella generazione dei premi di fine anno  
Il contratto sarà  invece valido se i listini utilizzati nel documento sono associati nel contratto a 
obiettivo/PFA utilizzato nella generazione dei premi di fine anno.  
 Listini  
Il bottone risulta editabile ed utilizzabile se disattivo il check Valido su tutti i listini, i l bottone permette 
di accedere alla gestione Listini associati nella quali indicare per quali listini il contratto a 
obiettivo/PFA risulta o no valido.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  - 21 
 
Listini associati  
  
 Escluso da premio agente  
Questo flag stabilisce se il contratto deve essere o no considerato nella determinazione del premio per 
agente. Tutti i documenti analizzati nella generazione del premio dove risulti valido il contratto a 
obiettivo/PFA con questo flag attivo vengono ignorati nella determinazione del premio per agente.  
 Solo sconti incondizionati  
Se attivo il contratto riguarderà solo gli sconti e non sarà possibile definire sulle righe del contratto 
eventuali premi.  
 Modello  
Se attivato, identifica i contratti che saranno impiegati per la generazione di altri contratti.  
Il check è attivabile solo in caricamento e comporta l'aggiornamento dello stato a sospeso', 
impedendo la selezione di un altro stato.  
I contratti modello non possono essere mai utilizzati nella generazione dei premi di fine anno poiché 
hanno associato lo sta to Sospeso'.  
 Codice iva premio  
Identifica il codice iva che sarà riportato sulla riga documento riguardante il premio. Non è editabile 
sul contratto poiché tale codice iva è definito nei Parametri contratti a obiettivo.  
 Calcolo premio  
 Su scaglione max: significa che il premio sarà corrisposto identificando il massimo scaglione 
raggiunto e applicando unicamente le condizioni in questo specificato  
 Progressivo: significa che il premio sarà corrisposto applicando le condizioni di ogni singolo 
scaglione raggiunto sul l'importo/qtà scaglione -scaglione inferiore.  
 Cumulativo: significa che il premio sarà corrisposto sommando i premi calcolati per ogni 
scaglione.  
 Duplica  
Tramite questo bottone è possibile duplicare un contratto già preesistente.  
Il bottone è editabile solo in modalità interroga.  
Alla pressione del pulsante appare la maschera di duplicazione contratto che richiede le seguenti 
informazioni:


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
22 – E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A   La descrizione del contratto da creare (campo facoltativo);  
 Il codice intestatario (facoltativo).  
  
 
Duplicazione contratto  
  
Alla conferma della maschera la procedura crea un nuovo contratto con stato Sospeso contenente 
tutti gli stessi dati del contratto di origine fatto salvo i dati precedenti (se valorizzati ). 
L'utente entrerà quindi in modifica del contratto creato per modificare i dati necessari ed attivarlo 
(cambio stato, cliente etc).  
 Articolo  
Identifica il codice di ricerca sul quale è stipulato il contratto. Se sul contratto è specificato il codice di  
ricerca principale la procedura per verificare l'applicabilità del contratto verifica sui documenti tutte le 
righe con lo stesso codice di ricerca ed eventuali codici di ricerca alternativi aventi la stessa unità di 
misura definita sul contratto.  
Se sul c ontratto è indicato un codice di ricerca alternativo, il contratto sarà applicabile se sui 
documenti è movimentato SOLO ESCLUSIVAMENTE tale codice di ricerca alternativo.  
 Um 
Identifica l'unità di misura sulla quale è valido il contratto, nel caso in cui invece dell'articolo si voglia 
indicare un set di attributi questo campo è obbligatorio e necessita di compilazione per poter accedere 
al bottone attributi.  
 Alternativo  
Se attivo per verificare l'applicabilità o meno del contratto la procedura verifica anche le unità di 
misura alternative del codice di ricerca .  
Esempio  
Supponiamo di caricare un articolo CA VO STAMPANTE con le seguenti unità di misura 
MTR=CM*100.  
Stipuliam o un contratto indicando l'articolo CA VO STAMPANTE e unità di misura MTR, non 
attivando  il flag Alternativo, se nei documenti caricati viene movimentato il codice di ricerca CA VO 
STAMPANTE con unità di misura CM, il contratto NON è valido.


key: chroma:document
string_value:
STAMPANTE con unità di misura CM, il contratto NON è valido.  
Attivando il fla g Alternativo nell'esempio precedente, la procedura considererà valido il contratto.  
 Calcolo premi  
 Su quantità: la ripartizione del premio avviene in base alle quantità di ogni singolo 
documento esaminato con medesimo intestatario.  
 Su importo: la rip artizione del premio avviene in base all'importo di ogni singolo documento 
esaminato con medesimo intestatario.  
 Attributi  
Identifica se il contratto è stipulato direttamente sull'articolo o indirettamente sul set di attributi degli 
articoli/servizi.  
Viene impostato a Si solo se il contenuto della gestione Attributi articoli risulta popolato


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  - 23  Attributi  
Questo bottone è editabile nel momento stesso in cui nel contratto a obiettivo/PFA viene indicata la 
sola unità di misura (non indicando quindi il codice d i ricerca).  
Il bottone permette di accedere alla gestione Attributi articolo nella quale è possibile semplicemente 
definendo un set di attributi rendere valido il contratto per più articoli/servizi aventi associati lo stesso 
set di attributi (pagina premi in anagrafica articoli/servizi).  
Nella Gestione attributi articolo vengono definite le famiglie articolo ed il valore attributo.  
  
 
Attributi articolo  
  
 Visualizza  
Una volta definiti la famiglia attributi e il relativo valore è possibile visualizzare tramite apposito 
bottone Visualizza quali articoli/servizi soddisfano il set di dati inseriti.  
  
 
Visualizza articoli  
  
Attenzione: se all'interno del cont ratto definiamo su una riga la validità per attributo, si consiglia di non specificare 
in altre righe la validità per un articolo che soddisfa gli attributi indicati.  
  
 Premi  
Il bottone permette di accedere alla gestione Premi Contratto nella quale indic are gli scaglioni premio.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
24 – E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A    
 
Gestione premi contratto  
  
 Scaglione premio  
Identifica lo scaglione che l'operatore deve raggiungere per il raggiungimento del premio.  
 Sconto %  
Identifica lo sconto in percentuale che viene attribuito in base allo scaglion e. 
 Sconto a valore per pezzo  
Identifica lo sconto a valore che viene attribuito ogni pezzo venduto.  
 Sconto a valore per scaglione  
Identifica lo sconto che viene attribuito sullo scaglione.  
 Articolo  
Identifica l'articolo che viene dato in omaggio al r aggiungimento dello scaglione.  
 Um 
Identifica l'unità di misura di movimentazione dell'articolo dato in omaggio.  
 Numero pezzi in omaggio  
Identifica il numero dei pezzi dati in omaggio al raggiungimento dello scaglione.  
 Tipo  
Permette di selezionare la tipologia di sconto applicata agli articoli dati in omaggio.  
 Punti premio per pezzo  
Identifica i punti premio che vengono attribuiti ogni pezzo venduto.  
 Punti premio per scaglione  
Identifica i punti premio che vengono attributi sullo scaglione.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  - 25 Conta tori 
 Pezzi venduti  
Identifica i pezzi venduti, vengono aggiornati in automatico dalla procedura al seguito della 
generazione premi.  
 Valore venduto  
Identifica il valore del venduto, viene aggiornato in automatico dalla procedura al seguito della 
generaz ione premi.  
 Premio a quantità  
Identifica il premio attribuito in base alle quantità vendute.  
 Premio a punti  
Identifica il premio attribuito in base ai punti attribuiti.  
  
Contratti a obiettivo/PFA - 
Gestione commerciale  
  
In questa pagina è possibile d efinire fino a 6 livelli di sconto da applicare sul fatturato raggiunto. Se 
l'operatore indica una percentuale di sconto, ma non attiva il flag corrispondente questo sconto non 
verrà preso in considerazione.  
Le label relative agli sconti incondizionati dev ono essere definite nei Parametri contratti a obiettivo.  
  
 
Contratti ad obiettivo PFA - Gestione commerciale


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
26 – E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A   Totale punti premio  
E' l'ammontare dei punti calcolati, se al raggiungimento del premio l'azienda invece di erogare denaro 
o articoli, eroga punti premio.  
 Valore unitario punti  
Identifica il valore unitario dei punti, questo campo è di sola visualizzaz ione, poiché sarà l'operatore 
che effettuerà la relativa scrittura contabile rilevando questo valore.  
 Valore canvass  
Identifica il valore di quelle spese aggiuntive che l'azienda sostiene per reclamare un prodotto 
(promoter, espositori, cartonati, campio ni omaggio,spot, volantinaggio ecc). Questo dato viene gestito 
in scalare al contratto. È un campo di libera imputazione.  
 Note in generazione  
Identificano le note che vengono riportare sulla riga descrittiva del documento fiscale creato in fase di 
genera zione premi.  
 Note contratti  
Identificano le note che l'operatore può associare a un contratto.  
 Note canvass  
Identificano le note che l'operatore può associare al canvass, stabilito sul contratto.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  - 27 Contratti a obiettivo/PFA - Dati consuntivi  
  
In ques ta pagina vengono riepilogati tutti i dati calcolati dalla procedura in fase di generazione premi, 
troviamo tutti i documenti che vengono considerati in fase di generazione e tutti i documenti generati 
dal/i contratto/i a obiettivo/PFA (documenti fiscali/r ettifiche).  
  
 
Contratti a obiettivo PFA - Dati consuntivi  
  
 Valore fatturato globale  
Identifica l'ammontare di tutti i documenti considerati per il raggiungimento dell'obiettivo stabilito sul 
contratto.  
 Valore canvass  
Identifica il valore di quelle spese aggiuntive che l'azienda sostiene per reclamare un prodot to 
(promoter, espositori, cartonati, campioni omaggio,spot, volantinaggio ecc).  
 Valore sconto commerciale  
Identifica l'ammontare dello sconto incondizionato calcolato su valore fatturato.  
 Valore obiettivi raggiunti  
Identifica l'ammontare degli obiettiv i raggiunti.  
 Valore totale storni  
Identifica la somma del valore canvass, sconto commerciale,obiettivi raggiunti.  
 Valore totale contratto  
E' calcolato come valore fatturato -valore totale storni.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
28 – E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  Il bottoncino a fianco dei documenti generati dal contrat to consente all'operatore di interrogare 
l'eventuale generazione premi.  
  
 
Consultazione generazione


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  - 29  Duplicazione contratti  
  
Tramite questa funzionalità risulta possibile duplicare un contratto già preesistente.  
Dato uno specifico contratto è possibile:  
 Duplicarlo in maniera diretta (da un contratto a un altro contratto)  
 Duplicarlo in maniera seriale (da un contratto a molti)  
  
Duplicazione Diretta  
Per mezzo del bottone Duplica nell'anagrafica dei contratti a obiettivo/PFA editabile solo in modalità 
interroga.  
  
 
Dettaglio duplicazione diretta  
  
Alla pressione del pulsante appare la maschera di duplicazione contratto che richiede le seguenti 
informazioni:  
 1. Il codice contratto da creare (campo obbligatorio)  
 2. La descrizione del contratto da crea re (campo facoltativo)  
 3. Il codice intestatario (facoltativo)


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
30 – E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  
 
Duplicazione contratto - Combo box Intestatario.  
  
Nel caso in cui si proceda alla duplicazione in maniera diretta di un contratto a obiettivo/PFA la 
maschera di duplicazione contratto ri porta il campo intestatario, tale campo risulta inizializzato dal 
valore presente nel contratto di origine con possibilità comunque di essere modificato da parte 
dell'operatore, così da permettere la duplicazione ad esempio di un contratto a obiettivo con 
intestatario cliente in un contratto con intestatario agente o gruppo d'acquisto.  
  
 
Duplicazione contratto  
  
Alla conferma della maschera la procedura crea un nuovo contratto con stato Sospeso contenente 
tutti gli stessi dati del contratto di origine fat to salvo i dati precedenti (se valorizzati).  
L'utente entrerà quindi in modifica del contratto creato per modificare i dati necessari ed attivarlo 
(cambio stato, cliente etc).


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  - 31 
 
Contratto duplicato in maniera diretta  
  
Come si può notare dall'immagine so pra riportata, la procedura ha creato un nuovo contratto con il 
codice e descrizione indicati nella maschera di duplicazione contratto, inoltre il contratto creato ha il 
medesimo intestatario del contratto di origine, questo perché nella maschera di duplic azione non sono 
stati valorizzati diversamente i relativi campi.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
32 – E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  Duplicazione contratti - Selezioni principali  
  
Per la duplicazione in maniera seriale (da un contratto a molti) è stata creata una maschera per ogni 
ciclo che permette di selezionare un c ontratto come origine e, dati alcuni filtri e parametri, creare 
nuovi contratti con i medesimi dati del primo.  
  
 
Duplicazione contratti - Selezioni principali  
  
 Tipo  
La combo è preimpostata ed ineditabile alla tipologia Obiettivo PFA,  
 Solo contratti modello  
Se attivo, consente di effettuare un filtro sui soli contratti modello.  
La funzione di duplicazione contratti in maniera diretta (in anagrafica contratto) e in maniera seriale 
(dalla duplicazione contratti) consente di generare partendo da un contratto modello un contratto 
identico ma con flag Modello spento.  
 Codice contratto da duplicare  
Permette la scelta del codice contratto da duplicare (zoom vincolato  al ciclo)  
Vengono poi presentati i dati letti dal contratto selezionato in show .  
 Apri 
Il bottone permette la visione del contratto oggetto di duplicazione.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  - 33 Selezione intestatari  
E’ possibile inoltre filtrare sugli intestatari della duplicazione.  
 Da /a cliente/fornitore  
Se il contratto di origine ha come intestatario un cliente/fornitore.  
 Da/a gruppo di acquisto  
Se il contratto di origine è su gruppo di acquisto.  
 Da/a agente  
Se il contratto di origine è intestato ad agente filtra solo i codici age nte. 
  
Duplicazione contratti - Selezioni aggiuntive  
  
 
Duplicazione Contratti - pagina selezioni aggiuntive  
  
La pagina selezioni aggiuntive prevede  
  
Criterio di composizione codice  
 Prefisso  
Campo valorizzabile dall’utente per la creazione automatica dei codici contratto.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
34 – E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A   Seriale  
Campo numerico valorizzabile dall’utente per la creazione automatica dei codici contratto.  
 Sovrascrivi codici già valorizzati  
Se attivo durante la generazione dei codici contratto i codici contratto in creazione già presen ti 
verranno sovrascritti.  
 Caricamento rapido  
Se valorizzati il prefisso ed il seriale si abilita il pulsante di caricamento rapido che compone il codice 
contratto in creazione sulle righe aventi check box attivo (il criterio di creazione è: prefisso+seri ale+1).  
 Del 
Data di stipulazione del contratto (inizializzata dal contratto di origine indicato nella pagina selezioni 
principali).  
 Validità  
Intervallo di validità del contratto (inizializzata dal contratto di origine indicato nella pagina selezioni 
principali).  
 Stato  
Sospeso: (inizializzato dal contratto di origine indicato nella pagina selezioni principali).  
Da elaborare: (inizializzato dal contratto di origine indicato nella pagina selezioni principali).  
 Codice  
Elenco con check box degli intestat ari identificati medianti i filtri di pagina selezioni principali.  
 Codice contratto in creazione  
la colonna codice contratto in creazione è editabile dall’utente con possibilità quindi di imputare i 
codici contratto manualmente senza seguire quindi il cr iterio di composizione codice.  
  
Alla conferma della generazione la procedura opera l’inserimento riportando le eventuali anomalie 
(codici contratti già esistenti).


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  - 35  Stampa contratti  
  
La stampa contratti accessibile in ogni ciclo permette la stampa completa e sintetica dei contratti 
caricati nelle relative anagrafiche  
  
 
Stampa contratti  
  
 Tipo  
La combo è preimpostata ed ineditabile alla tipologia Obiettivo PFA  
 Stato  
Permette la scelta dello stato del contratto da stampare: Da elaborare, Elaborato, Sospeso, Tutti.  
 Da codice a codice  
Può essere impostato un intervallo di codici contratt o da stampare.  
 Da data - A data registrazione  
Possono essere impostate le date di inizio e fine registrazione dei contratti.  
 Da data - A data validità iniziale  
Può essere impostato un intervallo di date di inizio validità dei contratti.  
 Da data - A data validità finale  
Può essere impostato un intervallo di date di fine validità dei contratti.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
36 – E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A   Da - A priorità  
Può essere impostato un intervallo di priorità dei contratti.  
 Da - A cliente/fornitore  
E' possibile filtrare sull'intestatario se i contratti  filtrati hanno come intestatario un cliente/fornitore.  
Se il codice contratto su cui si sta filtrando è unico il campo non viene proposto.  
 Da - A gruppo di acquisto  
E' possibile filtrare sul gruppo di acquisto se i contratti filtrati hanno come intestat ario un gruppo di 
acquisto.  
Se il codice contratto su cui si sta filtrando è unico il campo non viene proposto.  
 Da - A agente  
E' possibile filtrare sul codice agente se i contratti filtrati hanno come intestatario un agente.  
Se il codice contratto su cui  si sta filtrando è unico il campo non viene proposto.  
 Tipo di stampa  
Gli output disponibili sono:  
 Stampa completa  
 Stampa sintetica


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  - 37  Definizione attributo  
  
L'archivio attributi è stato introdotto per permettere logiche aggregative nella definizione dei contratti 
a obiettivo/PFA.  
  
In quest'archivio possono essere definiti tutti gli attributi che si desiderano utilizzare nelle gestioni 
articoli/servizi (pagina Premi) e nei contratti a obiettivo/PFA.  
  
La pagina premi delle anagrafiche articoli/servizi permette di associare ai record presenti in queste 
gestioni il set di attributi desiderati.  
  
Nei contratti a obiettivo/PFA inoltre è presente il bottone attributi che permette, accedendo alla 
gestione Attr ibuti articolo, di definire un set di attributi in modo da rendere valido il contratto per più 
articoli/servizi aventi associati lo stesso set di attributi nelle relative anagrafiche.  
  
Nel modulo di gestione premi di fine anno viene definito un unico grup po di attributi che permetterà all'utente di 
digitare direttamente la famiglia e quindi l'attributo senza dover digitare anche il gruppo.  
  
 
Definizione attributo


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
38 – E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A    
 Attributo  
Codice e descrizione dell'attributo che saranno visualizzati nel dettaglio attributi della pagina premi 
nelle anagrafiche articoli/servizi e nel bottone attributi dei contratti a obiettivo/PFA al quale 
occorrerà attribuire un valore.  
 Tipologi a 
Nella definizione degli attributi del modulo Gestione premi di fine anno tale combo risulta nascosto e 
fissato alla valorizzazione Fisso da elenco:  il valore che potrà indicare l'utente deve essere compreso 
nell'elenco di valori possibili indicati preven tivamente nella tabella di dettaglio che compare per questo 
tipo di attributo.  
 Input attributo  
Nella definizione degli attributi del modulo Gestione premi di fine anno tale combo risulta nascosto e 
fissato alla valorizzazione Carattere,  
 Obbligatorio  
Permette di stabilire se quest'attributo deve essere definito obbligatoriamente o  no. 
Nella definizione degli attributi del modulo Gestione premi di fine anno tale combo risulta visibile e 
ineditabile e fissato alla valorizzazione Si 
 Multiplo  
Permette di stabilire se l'attributo può essere ripetuto più volte (anche con valori uguali) . 
Nella definizione degli attributi del modulo Gestione premi di fine anno tale combo risulta nascosto e 
fissato alla valorizzazione Singolo  
 Dimensioni  
Dimensioni massime del valore che può assumere l'attributo. Nella definizione degli attributi del 
modu lo Gestione premi di fine anno tale campo risulta nascosto e fissato alla valorizzazione 20.  
 Attributo di ricerca  
Utilizzato nel modulo attività e servizi.  
Questo check permette di considerare i valori dell'attributo come valori di ricerca nella fase di data 
entry dei componenti sulle attività o nelle gestioni di visualizzazione/stampa (Agenda, Elenco


key: chroma:document
string_value:
entry dei componenti sulle attività o nelle gestioni di visualizzazione/stampa (Agenda, Elenco 
attività). In questo modo, anziché digitare la descrizione del componente o accedere allo zoom per la 
selezione dei componenti potrà essere digitato, anche parzialmente, il valore di un attributo di ricerca. 
Il programma restituirà il componente o l'insieme dei componenti che hanno quanto digitato come 
valore di un attributo di ricerca.  
Nella definizione degli attributi del modulo Gestione premi di fine anno tale check risulta nascosto e 
spento.  
  
Se attivo il modulo attività e servizi la definizione degli attributi creati saranno visibili ed utilizzabili anche nel 
sottomodulo impianti, in questo contesto il check attributo di ricerca risulta visibile e modifi cabile. Si consiglia 
comunque di non attivare tale check perché questo comporta l'eliminazione delle definizioni attributo create 
dall'elenco di quelle utilizzabili nel modulo Gestione premi di fine anno.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  - 39 Fonte dati  
Nella definizione degli attributi del modulo Gestione premi di fine anno la tipologia di attributo è 
bloccata a Fisso da elenco: la maschera presenterà un dettaglio dove poter digitare i valori possibili 
dell'attributo. I valori impostati sull'attributo saranno selezionabili da zoom nel moment o in cui si 
vorranno associare alle anagrafiche articoli/servizi e nel bottone attributi dei contratti a 
obiettivo/PFA.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
40 – E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A   Gruppo famiglie attributi articoli  
  
La gestione gruppi famiglie attributi ha lo scopo di definire dei raggruppamenti di attributi allo scopo 
di richiamarli per l'utilizzo in modo automatico senza doverli selezionare uno ad uno.  
Nel modulo di gestione premi di fine anno viene definito un unico gruppo di attributi che permetterà 
all'utente di digitare direttamente la famiglia e quindi l'attributo senza dover digitare anche il gruppo.  
Come si può notare dall'immagine sottostante, infatti, la gestione risulta priva di codice e descrizione, 
il codice e la relativa descrizione vengono creati automaticamente al salvataggio dell'archivio.  
  
 
Gruppo famiglie attributi articoli  
  
Il codice sarà una stringa casuale di 10 caratteri e la descrizione risulterà fissa a Gruppo per gestione 
premi.  
  
Se il modulo attività e servizi è attivato, il codice gruppo creato sarà visibile nel sottomodulo impianti, 
ma comunque non modificabile. L'operatore viene avvertito dell'impossibilità a modificare l'archivio 
mediante apposita messaggistica.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  - 41 
 
Modifica gestione gruppi da altra gestione  
  
Dettaglio  
Nel dettaglio è possibile inserire uno o più attributi definiti nell'archivio Definizione attributi. Gli 
attributi obbligatori del gruppo verranno proposti nel momento in cui si premerà il bottone Importa 
nel dettaglio attributi dell'anagrafica articoli/serv izi


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
42 – E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A   Gruppi causali di magazzino  
  
In quest'archivio vengono raggruppate tutte  le causali di magazzino che verranno utilizzate dalla 
procedura per identificare i documenti da considerare per la determinazione del premio.  
Occorre caricare codice e descrizione e attraverso lo zoom indicare le causali di magazzino che 
costituiscono per  l'azienda il fatturato.  
Una volta caricato quest'archivio occorre necessariamente indicare questo codice nei Parametri 
contratti a obiettivo in quanto campo obbligatorio.  
Ricordiamo che i documenti che non soddisfano le causali definite in quest'archivio non verranno 
considerati per la determinazione del fatturato.  
  
 
Gruppi causali di magazzino  
  
 Utilizzato per simulazioni  
L'utente può scegliere di fare simulazione su tutto l'ordinato o il consegnato nel periodo, anche se non 
fatturato.  
Nel caso non si  volesse operare in tal modo il gruppo di causali deve essere valorizzato analogamente 
a quello di generazione effettiva.  
Un gruppo di causali di magazzino con attivo il flag Utilizzato per simulazioni può essere utilizzato 
solo per generazioni premi in mo dalità simulata; è per questo che nella maschera dei Parametri 
contratti a obiettivo risulta possibile definire solo ed esclusivamente gruppi con il flag relativo alle 
simulazioni spento.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  - 43  Generazione premi  
  
Attraverso questa funzionalità sarà possibile determinare l'ammontare del premio da corrispondere.  
  
 
Generazione premi  
  
 Numero generazione  
Identifica il seriale di generazione del premio.  
 Descrizione  
Identifica la descrizione della generazione eseguita  
 Periodicità liquidazione  
Identifica la periodicità di liquidazione del premio  
 Semestrale: è possibile filtrare solo esclusivamente contratti con pe riodicità liquidazione 
semestrale.  
 Trimestrale: è possibile filtrare solo esclusivamente contratti con periodicità liquidazione 
trimestrale.  
 Altra: è possibile filtrare le altre tipologie di contratto con periodicità liquidazione diversa da


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
44 – E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  semestrale e trimestrale.  
  
Il tipo di periodicità impostato determina l'intervallo di date documento per il calcolo del fatturato 
totale e quantità venduta.  
 Del 
Identifica la data di generazione. Questo campo rappresenta un filtro per lo zoom su codice 
inventario poiché non è possibile indicare sulla maschera inventari con data maggiore rispetto a quella 
stabilita in questo campo e inoltre è un filtro anche per la determinazione dei contratti scaduti, un 
contratto è considerato scaduto se la data di fine validità è  inferiore a quella stabilita in questo campo.  
 Tipo  
Identifica il tipo di generazione.  
 Simulata consente di calcolare solo esclusivamente il premio  
 Definitiva consente di calcolare il premio e di generare documenti fiscali e di rettifica.  
 Valorizzazione  
Identifica la valorizzazione che viene at tribuita all'articolo omaggiato per il calcolo del premio.  
 Costo medio ponderato annuo  
 Costo medio ponderato periodo  
 Costo ultimo  
 Costo ultimo standard  
 LIFO continuo  
 FIFO continuo  
 LIFO a scatti  
 Da Listino  
 Inventario di riferimento  
In ques to campo è possibile indicare l'inventario di riferimento nel quale viene recuperata la 
valorizzazione di cui al punto precedente.  
 Listino riferimento  
In questo campo è possibile indicare il listino di riferimento. Il valore di tale listino viene conside rato 
per tutti gli articoli e per tutti i servizi se il combo tipo valorizzazione è Da listino.  
Identifica la valorizzazione che viene attribuita all'articolo/servizio omaggiato per il calcolo del 
premio  
 Generazione documenti fiscali  
Questo flag consente  di generare documenti fiscali a fronte di premi calcolati.  
 Generazione documenti interni  
Questo flag consente di generare documenti interni a fronte di premi calcolati.  
 Contratto


key: chroma:document
string_value:
Questo flag consente di generare documenti interni a fronte di premi calcolati.  
 Contratto  
E' possibile in fase di generazione filtrare direttamente sul contratto su cui generare i premi.  
 Solo contratto non più valido  
Con questo filtro è possibile far considerare non tutti i contratti, ma solo quelli scaduti alla data di 
generazione premi.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  - 45  Intestatario  
Identifica l'intestatario su cui è possibile fare filtro, co nsiderare solo i contratti di un intestatario 
oppure filtrare sullo specifico cliente o gruppo di acquisto (inizializzato ed ineditabile se filtrato 
direttamente sul contratto).  
 Cliente  
 Agente  
 Gruppo di acquisto  
 Selezione documenti dal - Al 
E' poss ibile considerare solo i documenti all'interno di un range di date.  
Attenzione non viene fatto nessun controllo sul fatto che per un periodo di date è già stata lanciata la 
generazione premi, spetta all'operatore l'onere di verificare se per quel periodo s ono o no già calcolati 
i premi.  
  
Creazione documenti fiscali  
 Documento da generare  
Identifica la causale che s'intende utilizzare per generare il documento fiscale.  
Se l'operatore non indica il codice contratto, ma esclusivamente l'intestatario la procedura recupera la 
causale documento da utilizzare direttamente nei Parametri contratti a obiettivo per ogni contratto 
esaminato. Se si filtra su un contratto il campo Documento da generare  è editabile e inizializzato.  
La determinazione della causale da utilizzare avviene secondo quanto specificato nel contratto nel 
combo Doc .liquidazione premio.  
 Esercizio  
Identifica l'esercizio attribuito al documento fiscale generato.  
 Primo numero  
Identifica il numero attribuito al documento fiscale generato.  
 Del 
Identifica la data attribuita al documento fiscale generato.  
 Dettaglia punti premio  
Se questo  flag è attivato nel documento fiscale generato saranno dettagliati i punti premio se previsti 
dal contratto.  
 Data competenza iva  
Identifica la data di competenza iva attribuita al documento fiscale generato.  
 Scadenze in data diversa


key: chroma:document
string_value:
 Scadenze in data diversa  
Identifica la data  riportata sul documento fiscale generato e utilizzata nel caso in cui il pagamento 
prevede la modalità a data diversa.  
  
Creazione documenti interni  
 Documento da generare  
Identifica la causale documento da utilizzare per la generazione del documento int erno di rettifica.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
46 – E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A   Calcolo premio  
  
In questo capitolo definiremo le formule utilizzate per la determinazione del premio.  
  
Nel calcolo per la determinazione dei pezzi/valore venduto/acquistato i documenti che non 
aggiornano il magazzino sono considerati nel seguente modo:  
 A.-Se si tratta di fatture la procedura somma le quantità/valori movimentate sul documento al 
numero pezzi venduti/acquistati e valore venduto/acquistato;  
 B.-Se si tratta di note di credito la procedura sottrae le quantità/valore movimentato sul 
docume nto al numero pezzi venduti/acquistati e valore venduto/acquistato;  
 C.-Se si tratta di documenti diversi da fatture/note di credito la procedura somma/sottrae le 
quantità/valore movimentato sul documento al numero di pezzi venduti/acquistati e valore 
venduto/acquistato leggendo i dati analitici, nel seguente modo:  
 Nel ciclo attivo somma le quantità/valore se la causale Documento ha attivo il check Dati 
Analitica, con combo box Segno impostata su Avere e combo box Tipo voce impostata su 
Ricavo; sottrae s e la combo box Segno è impostata su Dare e la combo box Tipo voce è 
impostata su Ricavo  
 Nel ciclo passivo somma le quantità/valore se la causale documento ha attivo il check Dati 
Analitica, con combo box Segno impostata su Dare e combo box Tipo voce impo stata su 
Costo; sottrae se la combo box Segno è impostata su avere e la combo box Tipo voce è 
impostata su Costo  
  
Se è definita una percentuale di sconto  il calcolo del premio a valore è dato da:  
Percentuale di sconto moltiplicata per il valore del vendut o. 
Sc % * Valore venduto  
Gli altri campi del bottone non saranno editabili.  
  
Se è definito uno sconto a valore per pezzo  il calcolo del premio a valore è dato da  
Sconto a valore per pezzo moltiplicato per il numero dei pezzi venduti.


key: chroma:document
string_value:
Sconto a valore per pezzo moltiplicato per il numero dei pezzi venduti.  
Sc a valore per pezzo  * pezzi venduti  
Gli altri campi del bottone non saranno editabili.  
  
Se è definito uno sconto a valore per scaglione il calcolo del premio a valore è dato dalla  
somma degli sconti a valore definiti su ciascun scaglione.  
Sc. a valore per scaglione + Sc a v alore per scaglione  
Gli altri campi del bottone non saranno editabili.  
Se è definito l'articolo in omaggio  il calcolo del premio a valore è dato dal costo che l'articolo ha 
nell'inventario selezionato nella maschera di generazione premi (se valorizzato), n el caso in cui invece 
di un articolo è indicato un servizio il costo è ricavato dal prezzo del servizio all'interno del listino 
indicato nella maschera di generazione premi (vale anche per gli articoli se non indicato un inventario 
nella maschera).  
Gli alt ri campi del bottone non saranno editabili.  
  
Se sono indicati i punti per pezzo  il valore del premio a valore sarà a zero.  
Gli altri campi del bottone non saranno editabili.  
  
Se sono indicati i punti per scaglione  il valore del premio a valore sarà a zer o.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  - 47 Gli altri campi del bottone non saranno editabili.  
  
Nel caso in cui si utilizzino causali magazzino che non toccano in alcun modo l'aggiornamento saldi occorre 
parametrizzare correttamente l'input dati analitica, perché è tale input che guida il calcol o dei pezzi 
venduti/acquistati e valore venduto/acquistato.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
48 – E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  
 
________________________________________________________________________________  
________________________________________________________________________________  
_____________________________ ___________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
__________________________________________ ______________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
_______________________________________________________ _________________________  
________________________________________________________________________________  
________________________________________________________________________________  
____________________________________________________________________ ____________  
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  - 49  ESEMPI CONTRATTI A 
OBIETTIVO /PFA  
  
 Contratto obiett ivo/PFA con calcolo premio su scaglione max  
 Contratto ad obiettivo/PFA con calcolo premio Progressivo  
 Contratto ad obiettivo/PFA con calcolo premio Cumulativo  
 Determinazione pezzi/valore venduto/acquistato per 
documento senza aggiornamento magazzino  
 Contr atto ad obiettivo/PFA intestato a gruppo di acquisto  
 Contratto ad obiettivo/PFA intestato ad agente  
 Contratto ad obiettivo/PFA con punti  
 Contratto ad obiettivo/PFA con articolo omaggia to 
 Contratto ad obiettivo/PFA definendo nei parametri contratti a 
obiettivo Calcolo proporzionale su Importo  
 Contratto ad obiettivo/PFA definendo nei parametri contratti a 
obiettivo Calcolo proporzionale su Quantità  
 Contratto ad obiettivo/PFA con attributi  
 Contratto ad obiettivo/PFA con tipo storno per articolo  
 Contratto ad obiettivo/PFA con flag Sconto incondizionato  
 Ripartizione premio per mese


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
50 – E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A   Contratto obiettivo/PFA con calcolo 
premio su scaglione max  
  
Supponiamo di caricare i seguenti dati:  
 Cliente BALDI SRL  
 Articolo SISTE MA ARIA CONDIZIONATA  
 DDT di vendita di 5 pezzi a 25.400  
 DDT di vendita di 3 pezzi a 10.000  
 DDT di vendita di 10 pezzi a 5.000  
 DDT di vendita di 4 pezzi a 1.000  
 DDT di reso di 1 pezzo a 1.000  
  
Stipuliamo con il cliente BALDI SRL un contratto a ob iettivo, valido per il periodo 01/10 al 31/12 
per l'articolo SISTEMA ARIA CONDIZIONATA definendo come calcolo premio SU 
SCAGLIONE MAX.  
  
 
Contratto con calcolo premio scaglione Max  
  
Elaboriamo il premio indicando il contratto appena creato, la procedura considera tutti documenti


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  - 51 intestati al cliente BALDI SRL.  
 
Generazione premi con scaglione max  
  
Consultando il contratto troveremo


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
52 – E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  
 
Aggiornamento bottone premi  
  
Il calcolo del premio sullo scaglione massimo stabilito nel bottone premi.  
  
Vediamo come  è stato calcolato il premio in valore:  
  
Pezzi venduti:  rappresentato dalla somma delle quantità dei documenti considerati per determinare il 
fatturato.  
  
Valore venduto : rappresentato dalla somma del valore di vendita di ciascun documento considerato 
per determinare il fatturato.  
  
Premio a valore  calcolato su scaglione massimo come:  
  
Valore venduto * Sc. %  
210.000 * 14%= 29.400  
  
Si precisa che, in fase di generazione premi in modalità simulata, se non si raggiunge lo scaglione 
stabilito, la procedura n el bottone premi scrive comunque il numero di pezzi venduti/acquistati e il 
valore del venduto/acquisto.  
A questo punto decidiamo di generare anche il documento fiscale e il relativo documento interno. 
Rientriamo nella maschera di generazione premio ed ese guiamo la generazione in Definitiva, a questo 
punto la procedura attiva due flag sulla maschera di generazione


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  - 53 
 
Generazione documenti fiscali e non  
  
Vengono generati due documenti, una fattura e un documento interno di rettifica, nella pagina 
consuntivo è possibile consultare i due documenti generati con un semplice doppio clic sull'elenco 
documenti generati:  
  
Per il documento fiscale la procedura ha utilizzato il servizio a valore definito nei Parametri contratti a 
obiettivo per riportare il premio calcolato, poiché nel contratto è stato definito un tipo storno 
forfettario.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
54 – E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  
 
Consultazione documento Fiscale  
  
 
Consultazione documento di rettifica  
  
Per il documento interno di rettifica la procedura ha utilizzato l 'articolo movimentato per riportare il 
premio calcolato.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  - 55  Contratto ad obiettivo/PFA con 
calcolo premio Progressivo  
  
Supponiamo di caricare i seguenti dati  
 Cliente BALDI SRL  
 Articolo SISTEMA ARIA CONDIZIONATA  
 DDT di vendita di 5 pezzi a 25.400  
 DDT di vendita di 3 pezzi a 10.000  
 DDT di vendita di 10 pezzi a 5.000  
 DDT di vendita di 4 pezzi a 1.000  
 DDT di reso di 1 pezzo a 1.000  
  
Stipuliamo con il cliente BALDI SRL un contratto a obiettivo, valido per il periodo 01/10 al 31/12 
per l'articolo S ISTEMA ARIA CONDIZIONATA definendo come calcolo premio 
PROGRESSIVO.  
  
 
Contratto con calcolo premio Progressivo


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
56 – E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  Elaboriamo il premio indicando il contratto appena creato, la procedura considera tutti i documenti  
intestati al cliente BALDI SRL.  
  
 
Gener azione premi per Contratto con calcolo premio Progressivo  
  
Consultando il contratto troveremo  
  
 
Calcolo premio su primo scaglione


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  - 57 
 
Calcolo premio su secondo scaglione  
  
 
Calcolo premio su terzo scaglione  
  
Il calcolo del premio avviene progressivame nte in base agli scaglioni definiti.  
  
Vediamo come è stato calcolato il premio in valore:  
Nel nostro esempio:  
100.000*10%                   =10.000 eu +  
(150.000 -100.000)*12%  =  6.000 eu +  
(210.000 -150.000)*14%  =  8.400 eu =  
                                         = 24.400 eu  
  
Se generiamo il documento fiscale e il documento interno di verifica  la procedura genererà una fattura 
identica all'esempio precedente, ma con il nuovo importo 24.400 € utilizzando sempre il servizio 
forfettario perché nel contratto è stato definito come tipo storno forfettario.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
58 – E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  
 
Consultazione documento Fiscale  
  
Per il  documento di rettifica l'ammontare del premio sarà spalmato sull'articolo venduto.  
  
 
Consultazione documento di rettifica


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  - 59  Contratto ad obiettivo/PFA con 
calcolo premio Cumulativo  
  
Supponiamo di caricare i seguenti dati:  
 Cliente BALDI SRL  
 Articolo SISTEMA ARIA CONDIZIONATA  
 DDT di vendita di 5 pezzi a 25.400  
 DDT di vendita di 3 pezzi a 10.000  
 DDT di vendita di 10 pezzi a 5.000  
 DDT di vendita di 4 pezzi a 1.000  
 DDT di reso di 1 pezzo a 1.000  
  
Stipuliamo con il cliente BALDI SRL un con tratto a obiettivo, valido per il periodo 01/10 al 31/12 
per l'articolo SISTEMA ARIA CONDIZIONATA definendo come calcolo premio 
CUMULATIVO.  
  
 
Contratto con calcolo premi Cumulativo


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
60 – E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  Elaboriamo il premio indicando il contratto appena creato, la procedura  considera tutti documenti 
intestati al cliente BALDI SRL.  
  
 
Generazione premi Cumulativa  
  
Consultando il contratto troveremo  
  
 
Calcolo premio su primo scaglione


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  - 61 
 
Calcolo premio su secondo scaglione  
  
 
Calcolo premio su terzo scaglione  
  
Il calcol o del premio avviene in modo cumulativo  
  
Vediamo come è stato calcolato il premio in valore:  
Nel nostro esempio:  
100.000*10%  = 10.000 eu +  
150.000*12%  = 18.000 eu +  
210.000*14%  = 29.400 eu  = 
                        = 57.400 eu  
  
Se decidiamo di generare i l documento fiscale e il documento interno di rettifica, la procedura 
genererà una fattura identica all'esempio precedente, ma con il nuovo importo 57.4 00 € utilizzando 
sempre il servizio forfetario perché nel contratto è stato definito come tipo storno forfetario.  
Per il documento di rettifica l'ammontare del premio sarà spalmato sull'articolo venduto.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
62 – E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A   Determinazione pezzi/valore 
venduto/acquistato per documento 
senza aggiornamento magazzino  
  
Nel calcolo per la determinazione dei pezzi/valore venduto/acquistato i documenti che non 
aggiornano il magazzino sono considerati nel seguente modo:  
 A.-Se si tratta di fatture la procedura somma le quantità/ valori movimentate sul documento al 
numero pezzi venduti/acquistati e valore venduto/acquistato;  
 B.-Se si tratta di note di credito la procedura sottrae le quantità/valore movimentato sul 
documento al numero pezzi venduti/acquistati e valore venduto/acqu istato;  
C.-Se si tratta di documenti diversi da fatture/note di credito la procedura somma/sottrae le 
quantità/valore movimentato sul documento al numero di pezzi venduti/acquistati e valore 
venduto/acquistato leggendo i dati analitici, nel seguente modo:  
 Nel ciclo attivo somma le quantità/valore se la causale Documento ha attivo il check Dati 
Analitica, con combo box Segno impostata su Avere e combo box Tipo voce impostata su 
Ricavo; sottrae se la combo box Segno è impostata su Dare e la combo box Tipo v oce è 
impostata su Ricavo  
 Nel ciclo passivo somma le quantità/valore se la causale documento ha attivo il check Dati 
Analitica, con combo box Segno impostata su Dare e combo box Tipo voce impostata su 
Costo; sottrae se la combo box Segno è impostata su a vere e la combo box Tipo voce è 
impostata su Costo  
  
Supponiamo di operare dal ciclo attivo.  
  
Supponiamo di caricare un contratto a obiettivo per il cliente NERI dove al raggiungimento di cinque 
pezzi dell'articolo CPU -P4-2.8GHZ si ha in omaggio un DVD.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  - 63 
 
Dettaglio contratto Neri  
  
Supponiamo di caricare i seguenti documenti:  
 DDTVE 10 qtà a prezzo 10 sconto -10 
 RESOC 1 qtà a prezzo 10 sconto -10 
 FADIFI 8 qtà a prezzo 25 sconto -10 
 NCCLI 5 qtà a prezzo 10 sconto -10 
 OFFCL 3 qtà a prezzo 10 sconto -10 
 ORINT 2 qtà a prezzo 10 sconto -10


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
64 – E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  
 
Elenco documenti  
  
Le causal i di magazzino legate ai documenti sono le seguenti:  
 - Al DDT è associata una causale di magazzino che diminuisce l'esistenza;  
 - Al reso è associata una causale di magazzino che aumenta l'esistenza;  
 - Alla fattura differita è associata la causale di magazzino che non aggiorna il magazzino e la 
causale documento ha il check su Dati di analitica tipo Ricavo segno Avere;  
 - Alla nota di credito è associata la causale di magazzino che non aggiorna il magazzino 
(NULL)  e la causale documento ha il check s u Dati di Analitica tipo Ricavo segno Dare;  
 - All’offerta è associata la causale di magazzino che non aggiorna i saldi e la causale 
documento che ha il check Dati di Analitica, combo box Tipo voce impostata su Ricavo e 
combo box Segno impostata su Avere;  
 - Al documento interno è associata la causale di magazzino che non aggiorna i saldi e la 
causale documento che ha il check Dati di Analitica, combo box Tipo voce impostata su Ricavo 
e combo box Segno impostata su Dare.  
  
Generiamo il premio selezionando  un gruppo di causali che contiene le causali utilizzate e vediamo 
come la procedura determina i pezzi venduti e il valore venduto.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  - 65 
 
Dettaglio causali magazzino  
  
 
Generazione premi


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
66 – E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  
 
Dettaglio Premi contratto  
  
Pezzi venduti 13 dato da:  
  
10 (DDT) -1(RESOC)+8(FA VDI) -5(NCVE)+3(OFFCL) -2(ORINT)= 13  
  
 - La fattura differita è sommata.  
 - La nota di credito è sottratta.  
 - L’offerta è sommata perché essendo un documento diverso da fattura la procedura ha 
considerato i dati di Analitica e l’offerta ha combo box Tipo voce e impostata su Ricavo e 
combo box Segno impostata su Avere.  
 - Il documento interno è stornato perché essendo un documento diverso da fattura la 
procedura ha considerato i dati di Analitica e il documento interno ha combo box Tipo voce e 
impostata su Ricavo e combo box Segno impostata  su Dare..  
  
Stesso ragionamento per il valore del venduto.  
  
90 (DDT) -9(RESOC)+180(FA VDI) -45(NCVE)+27(OFFCL) -18(ORINT)= 225  
  
 - La fattura differita è sommata  
 - La nota di credito è sottratta  
 - L’offerta è sommata perché essendo un documento diverso  da fattura la procedura ha 
considerato i dati di Analitica e l’offerta ha combo box Tipo voce e impostata su Ricavo e 
combo box Segno impostata su Avere.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  - 67  - Il documento interno è stornato perché essendo un documento diverso da fattura la 
procedura ha co nsiderato i dati di Analitica e il documento interno ha combo box Tipo voce e 
impostata su Ricavo e combo box Segno impostata su Dare.  
  
Nel caso in cui si utilizzino causali magazzino che non toccano in alcun modo l'aggiornamento saldi occorre 
parametrizz are correttamente l'input dati analitica, perché è tale input che guida il calcolo dei pezzi 
venduti/acquistati e valore venduto/acquistato.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
68 – E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A   Contratto ad obiettivo/PFA intestato 
a gruppo di acquisto  
  
Caricare un seguente gruppo di acquisto nel ciclo vendite indicando i clienti ANALOGICA, 
BIANCHI e ANTICHITA e definendo come centrale cliente BIANCHI.  
  
 
Gruppo acquisto  
  
Stipulare con il seguente gruppo di acquisto un contratto a obiettivo/PFA  
 Valido dal 01/10 al 31/12 per l'articolo SISTEMA ARIA CO NDIZIONATA  
 Calcolo premio SU SCAGLIONE MAX  
 Tipo storno FORFETTARIO  
 Calcolo premio sulla riga SU Quantità  
 Sconto del 10% sull'acquisto di ogni pezzo


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  - 69 
 
Dettaglio contratto per gruppo di acquisto  
  
Caricare i seguenti documenti:  
 DDT di vendita int estato a cliente ANALOGICA per l'articolo SISTEMA ARIA 
CONDIZIONATA per 2 pezzi a 1.000;  
 DDT di vendita intestato a cliente ANTICHITA per l'articolo SISTEMA ARIA 
CONDIZIONATA per 3 pezzi a 1.000;  
 DDT di vendita intestato a cliente BIANCHI per l'articol o SISTEMA ARIA 
CONDIZIONATA per 1 pezzo a 1.000.  
  
Generiamo il premio


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
70 – E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  
 
Generazione premi gruppo acquisto  
  
Generiamo sia il documento fiscale, sia il documento di rettifica.  
  
 
Dettaglio documenti considerati nella generazione premi


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  - 71   
Come possiamo no tare la procedura considera tutti i documenti intestati agli intestatari presenti nel 
gruppo di acquisto e intesta il documento fiscale al fornitore collegato al cliente definito come 
Centrale nel gruppo di acquisto indicato nel contratto a obiettivo/PFA e  il documento di rettifica al 
cliente definito come Centrale nel nostro esempio BIANCHI.  
  
 
Dettaglio documento fiscale  
  
 
Dettaglio documento di rettifica


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
72 – E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A   Contratto ad obiettivo/PFA intestato 
ad agente  
  
Supponiamo di caricare l'agente CARLI SA VERIO  
 Stipulare con l'agente un contratto:  
 Valido dal 01/01 al 31/01 per l'articolo SISTEMA ARIA CONDIZIONATA  
 Calcolo premio SU SCAGLIONE MAX  
 Tipo storno FORFETTARIO  
 Calcolo premio sulla riga SU Quantità  
 Sconto del 10% sull'acquisto di ogni pezzo  
  
 
Dettaglio contratto agente  
  
Caricare i seguenti documenti:  
 DDT di vendita intestato a cliente ANALOGICA per l'articolo in SISTEMA ARIA 
CONDIZIONATA per 2 pezzi a 1.000 indicando nel documento l'agente CARLI SA VERIO;  
 DDT di vendita intestato a cliente A NTICHITA per l'articolo in SISTEMA ARIA 
CONDIZIONATA per 3 pezzi a 1.000  indicando nel documento l'agente CARLI SA VERIO;


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  - 73  DDT di vendita intestato a cliente BIANCHI per l'articolo SISTEMA ARIA 
CONDIZIONATA per 1 pezzo a 1.000  senza specificare l'agente.  
  
Generiamo il premio indicando tale contratto  
  
 
Generazione premi per agente  
  
La procedura considera solo i documenti in cui è specificato l'agente caricato in precedenza, quindi 
ignora l'ultimo DDT di BIANCHI poiché in questo documento l'agente non è  stato indicato.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
74 – E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  
 
Dettaglio documenti considerati nella generazione premi  
  
Generiamo la fattura, la quale sarà intestata al fornitore definito nell'anagrafica dell'agente riportando 
l'articolo forfettario per l'ammontare del premio.  
  
 
Dettaglio docum ento fiscale  
  
Nel documento interno il valore del premio è spalmato sull'articolo venduto.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  - 75 
 
Dettaglio documento di rettifica


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
76 – E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A   Contratto a obiettivo/PFA con punti  
  
Supponiamo di stipulare un contratto con Il cliente Ced Interdata spa (RB3)  valido dal  01/10 al 
31/12  
 Articolo SISTEMA ARIA CONDIZIONATA.  
 Calcolo scaglione premio SU SCAGLIONE MAX  
 Tipo storno FORFETTARIO  
 Definiamo nel bottone premi uno scaglione, dove al raggiungimento di 1 pezzo è erogato 1 
punto.  
  
 
Dettaglio contratto con punti  
  
Emettiamo a ta le cliente un DDT utilizzando l'articolo SISTEMA ARIA CONDIZIONATA per 10 
pezzi a 1000 €.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  - 77 
 
Generazione premi con punti  
  
Generiamo il documento fiscale dove troveremo  
  
 
Dettaglio documento fiscale con punti  
  
La procedura utilizza il servizio a quanti tà e valore definito nei Parametri contratti a obiettivo per 
rilevare l'ammontare dei punti.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
78 – E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A   Il costo unitario punti deve essere rilevato in contabilità manualmente.  
 Il documento interno di rettifica non è generato poiché a magazzino nel nostro esempio  non 
deve rettificare nulla in quanto nel contratto ho stabilito solo dei punti.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  - 79  Contratto a obiettivo/PFA con 
articolo omaggiato  
  
Supponiamo di stipulare con il cliente Data software international Spa (RB369)un contratto valido dal 
01/10 al 31/12  
 Articolo SISTEMA ARIA CONDIZIONATA.  
 Calcolo premio PROGRESSIVO  
 Tipo storno FORFETTARIO  
 Definiamo nel bottone premi che al raggiungimento dello scaglione di 5 pezzi per l'articolo 
SISTEMA ARIA CONDIZIONATA è dato l'articolo CDROM in omaggio, al raggiung imento 
dello scaglione di 10 pezzi è dato il servizio INSTSOFTWARE in omaggio.  
 Associamo al cliente il Listino CLIEN, con dettagli per l'articolo CDROM e il servizio 
INSTSOFTWARE in cui il prezzo del CDROM è di 18 € e del servizio INSTSOFTWARE è di 
12.50  
  
 
Contratto con articoli in omaggio  
  
Supponiamo di emettere a tale cliente un DDT di vendita di 11 pezzi a 1000 €.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
80 – E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A    
Generiamo il premio  
  
 
Generazione con articoli in omaggio  
  
Se interroghiamo il bottone premi dopo la generazione notiamo che come va lore premio sul primo 
scaglione è riportato il costo medio ponderato annuo dell'articolo omaggiato, nel nostro esempio 
troviamo 11,54630 € esattamente il Costo medio ponderato annuo dell'articolo CDROM 
nell'inventario di riferimento indicato nella maschera  di generazione premi.  
  
 
Dettaglio premio generato  
  
Per il secondo scaglione è riportato il costo che assume il servizio omaggiato nel listino BASE, nel 
nostro esempio troviamo 15 € esattamente il costo del servizio INSTSOFTWARE nel listino BASE


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  - 81 definit o nella maschera di generazione premi nel campo listino di riferimento.  
  
 
Dettaglio premio generato.2  
  
Analizziamo il documento fiscale generato  
  
 
Documento generato  
  
La procedura riporta  
 Il servizio forfetario STORNI per l'ammontare monetario del premio (Somma valori premi 
delle due righe =11,54630+15)  
 L'articolo CDROM omaggiato al prezzo del listino valido alla data registrazione per il cliente, 
indicando sulle righe Sconto merce.  
 Il servizio INSTSOFTWARE omaggiato al prezzo del listino valido  alla data registrazione per 
il cliente, indicando sulle righe Sconto merce.  
 Come codice pagamento quello definito nei parametri contratti a obiettivo.  
  
Analizziamo il documento interno di rettifica


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
82 – E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A    
 
Dettaglio documento di rettifica  
  
La procedura ri porta  
 L'articolo oggetto del fatturato al prezzo dato dal valore monetario del premio calcolato.  
 Come codice pagamento quello definito nei parametri contratti a obiettivo.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  - 83  Contratto ad obiettivo/PFA definendo 
nei parametri contratti a obiett ivo 
Calcolo proporzionale su Importo  
  
 Supponiamo di definire nelle contropartite e vincoli pagina contratti ad obiettivo Calcolo 
proporzionale su IMPORTO.  
 Stipulare con il cliente Funk Software un contratto valido dal 01/10 al 31/12, calcolo premio 
SU SCAGLIONE MAX definendo per l'articolo Mouse ottico, al raggiungimento di 5 pezzi 
uno sconto a valore per scaglione di 3 €  
  
 
Dettaglio premio articolo Mouse ottico  
  
Per articolo Mouse wireless al raggiungimento di 5 pezzi uno sconto a valore per scagli one di 2,5 €.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
84 – E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  
 
Dettaglio premio articolo Mouse wireless  
  
Caricare i seguenti documenti  
 Fattura attiva per 2 pezzi a15 0128 € per articolo Mouse ottico;  
 Fattura attiva per 3 pezzi a 18 € per articolo Mouse wireless;  
 Fattura attiva per 5 pezzi a 13 ,5 € per articolo Mouse ottico;  
 Fattura attiva per 4 pezzi a 12 € per articolo Mouse wireless.  
  
Elaboriamo il premio e generiamo il documento fiscale


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  - 85 
 
Dettaglio documento fiscale  
  
La procedura riporta l'ammontare del premio sul servizio a valore def inito nei parametri contratti a 
obiettivo  
  
Sul documento interno di rettifica troveremo  
  
 
Dettaglio documento interno di rettifica


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
86 – E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  Il valore del premio proporzionato in base all'importo sui singoli articoli:  
Il calcolo effettuato per l'articolo Mouse ottico è il seguente:  
  
(fatturato dell'articolo Mouse ottico /fatturato totale del periodo)*premio calcolato  
  
(97,5/199,5)* 5,5=2,68797  
  
Il calcolo effettuato per l'articolo Mouse wireless è il seguente:  
  
(fatturato dell'articolo Mouse wireless /fattur ato totale del periodo)*premio calcolato  
  
(102/199,5)* 5,5=2,81203


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  - 87  Contratto ad obiettivo/PFA definendo 
nei parametri contratti a obiettivo 
Calcolo proporzionale su Quantità  
  
 Supponiamo di definire nelle contropartite e vincoli pagina contratti ad  obiettivo Calcolo 
proporzionale su Quantità.  
 Stipulare con il cliente Funk Software un contratto valido dal 01/10 al 31/12, calcolo premio 
SU SCAGLIONE MAX definendo per l'articolo Mouse ottico, al raggiungimento di 5 pezzi 
uno sconto a valore per scagl ione di 3 €;  
  
 
Dettaglio premio articolo Mouse ottico  
  
Per articolo Mouse wireless al raggiungimento di 5 pezzi uno sconto a valore per scaglione di 2,5 €.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
88 – E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  
 
Dettaglio premio articolo Mouse wireless  
  
Caricare i seguenti documenti  
 Fattura attiva per  2 pezzi a15 € per articolo Mouse ottico;  
 Fattura attiva per 3 pezzi a 18 € per articolo Mouse wireless;  
 Fattura attiva per 5 pezzi a 13,5 € per articolo Mouse ottico;  
 Fattura attiva per 4 pezzi a 12 € per articolo Mouse wireless.  
  
Elaboriamo il pre mio e generiamo il documento fiscale


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  - 89 
 
Dettaglio documento fiscale  
  
La procedura riporta l'ammontare del premio sul servizio a valore definito nei parametri contratti a 
obiettivo  
  
Sul documento interno di rettifica troveremo  
  
 
Dettaglio documento int erno di rettifica


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
90 – E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  Il valore del premio è proporzionato in base alle quantità dei singoli articoli:  
Il calcolo effettuato per l'articolo Mouse ottico è il seguente:  
  
(quantità fatturata dell'articolo Mouse ottico /quantità totale del periodo)*premio calc olato 
  
(7/14)* 5,5=2,75  
  
Il calcolo effettuato per l'articolo Mouse wireless è il seguente:  
  
(quantità fatturata dell'articolo Mouse wireless / quantità totale del periodo)*premio calcolato  
  
(7/14)* 5,5=2,75


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  - 91  Contratto ad obiettivo/PFA con 
attributi  
  
 Supponiamo di stipulare con il cliente Funk Software un contratto valido dal 01/01 al 31/12, 
calcolo premio SU SCAGLIONE MAX definendo per l'attributo MOUSE, al raggiungimento 
di 2 pezzi uno sconto a valore per pezzo di 5 €.  
  
 
Contratto con attributi


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
92 – E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  
 
Dettaglio premio Contratto con attributi  
  
Caricare i seguenti documenti  
 Fattura attiva per 2 pezzi a1 € per articolo Mouse ottico;  
 Fattura attiva per 3 pezzi a 18  € per articolo Mouse wireless;  
 Fattura attiva per 5 pezzi a 13,5  € per articolo M ouse ottico;  
 Fattura attiva per 4 pezzi a 12  € per articolo Mouse wireless.  
  
Elaboriamo il premio, la procedura considera tutti i documenti intestati ad Funk Software nei quali è 
stato indicato un articolo avente gli attributi indicati nel contratto.  
  
Il premio a valore è dato da 14 pezzi venduti per 5, lo sconto a valore per pezzo.  
Quest'importo è riportato nel documento fiscale generato.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  - 93 
 
Dettaglio documento fiscale generato  
  
Mentre nel documento interno di rettifica generato avviene la ripartizi one del premio sui singoli 
articoli.  
  
 
Dettaglio documento interno di rettifica


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
94 – E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A   Contratto ad obiettivo/PFA con tipo 
storno per articolo  
  
 Supponiamo di definire nelle contropartite e vincoli pagina contratti ad obiettivo Calcolo 
proporzionale su IMPORTO.  
 Stipulare con il cliente Funk Software un contratto valido dal 01/11 al 31/12, calcolo premio 
SU SCAGLIONE MAX definendo per l'articolo  Mouse ottico, al raggiungimento di 5 pezzi 
uno sconto a valore per scaglione di 3 €; per articolo Mouse wireless al raggiungimento di 5 
pezzi uno sconto a valore per scaglione di 2,5 €.  
  
Tipo storno RIPARTITO PER ARTICOLI  
  
 
Contratto con tipo storno pe r articolo


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  - 95 
 
Dettaglio premio prima riga


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
96 – E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  
 
Dettaglio premi seconda riga  
  
Caricare i seguenti documenti  
 Fattura attiva per 2 pezzi a15 € per articolo Mouse ottico;  
 Fattura attiva per 3 pezzi a 18 € per articolo Mouse wireless;  
 Fattura attiva per 5 pezzi a 13,5 € per articolo Mouse ottico;  
 Fattura attiva per 4 pezzi a 12 € per articolo Mouse wireless.  
  
Elaboriamo il premio e generiamo il documento fiscale


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  - 97 
 
Dettaglio documento fiscale  
  
In questo caso la procedura per effettuare lo storno del premio calcolato utilizza gli articoli che 
partecipano alla determinazione del fatturato e non l'articolo forfettario definito nei parametri 
contratti a obiettivo.  
Per il documento interno di rettifica la procedura ripartisce il valore del premio sugli art icoli fatturati.  
  
 
Dettaglio documento di rettifica


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
98 – E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A   Contratto ad obiettivo/PFA con flag 
Escluso da premio agente  
  
Supponiamo di stipulare con il cliente ANALOGICA un contratto valido dal 01/01 al 31/12, calcolo 
premio SU SCAGLIONE MAX definendo per  l'articolo CDROM, al raggiungimento di 5 pezzi 
sconto a valore su scaglione 1.000€.  
Periodicità liquidazione premio ANNUALE  
  
 
Dettaglio contratto  
  
Stipuliamo inoltre per il cliente BIANCHI un contratto valido dall' 01/01 al 31/12, calcolo premio 
SU SCA GLIONE MAX definendo per l'articolo CDROM, al raggiungimento di 5 pezzi sconto a 
valore su scaglione 1.000 €.  
Periodicità liquidazione premio ANNUALE  
  
Sul contratto di BIANCHI attiviamo il Flag Escluso Da Premio Agente.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  - 99 
 
Dettaglio contratto con flag Es cluso da premio agente  
  
Stipuliamo ancora un contratto per l'agente ROSSI MARIO valido dall' 01/01 al 31/12, calcolo 
premio SU SCAGLIONE MAX definendo per l'articolo CDROM, al raggiungimento di 5 pezzi 
sconto a valore su scaglione 1.000€.  
  
 
Dettaglio co ntratto agente


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
100  – E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  Carichiamo i seguenti documenti:  
             DDT di vendita intestato al cliente ANALOGICA per l'articolo CDROM per 100 
pezzi a 155 indicando nel documento l'agente ROSSI MARIO;  
             DDT di vendita intestato al cliente BIANCHI per l'articolo CDROM per 100 pezzi a 
150 indicando nel documento l'agente ROSSI MARIO.  
  
Generiamo i premi per tutti e tre i contratti non indicando alcun codice contratto nella selezione dei 
contratti:  
  
 
Generazione premi per agente  
  
Andando a verifica re i premi elaborati noteremo che per il contratto di ANALOGICA la procedura 
ha correttamente indicato l'unico ddt caricato come documento considerato nella generazione dei 
premi.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  - 101  
 
Dettaglio documenti che partecipano alla generazione dei premi per il co ntratto di ANALOGICA  
  
Anche per il contratto di BIANCHI la procedura ha correttamente indicato l'unico ddt caricato come 
documento considerato nella generazione dei premi.  
  
 
Dettaglio documenti che partecipano alla generazione dei premi per il contratto  di BIANCHI  
  
Andando a verificare il contratto per l'agente ROSSI MARIO, si noterà che la procedura ha


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
102  – E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  correttamente indicato come documento considerato nella generazione dei premi l'unico ddt caricato 
per il cliente ANALOGICA, questo perché il contratto di BIANCHI ha il check Escluso da premio 
agente attivo, quindi, non è stato considerato nella determinazione del premio per agente.  
  
 
Dettaglio documenti che partecipano alla generazione dei premi per l'agente Carli Saverio.  
  
Anche andando a verificare il contatore dei premi per il contratto dell'agente ROSSI MARIO, si 
noterà che la procedura ha considerato le sole quantità relative al ddt caricato per il cliente 
ANALOGICA, quindi 100 Pezzi venduti per un valore del venduto di 15500 (dato da 100 pezzi 
venduto *155 valore dei pezzi ).


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  - 103  
 
Dettaglio contatori dei premi per l'agente ROSSI MARIO.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
104  – E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A   Contratto ad obiettivo/PFA con flag 
Sconto incondizionato  
  
Attivando il flag sconto incondizionato l'operatore non può definire nessun premio, ma solo sconti 
nella pagina Gestione commerciale del contratto, questi sconti saranno applicati sul valore fatturato 
globale.  
  
 
Contratto con solo sconti incondizionati  
  
Nella pagina Gestione commerciale definiamo un primo sconto del 5% ed un secondo sconto del 6,5.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  - 105  
 
Dettaglio Sconti Contratto con solo sconti incondizionati  
  
Inseriamo due documenti per un valore totale dell'articolo Mouse ottico di 97,5 €.  
  
Generiamo il premio e la procedura calcola il valore dello sconto commerciale dato da:  
(Valore fatturato glob ale - 1° sconto - 2°sconto)  
Nel nostro esempio: 97,5 - 5% -6,5%  
  
 
Valore sconto incondizionato


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
106  – E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A   Ripartizione premio per mese  
  
 Supponiamo di stipulare con il cliente Verdi S.p.A. un contratto valido dal 01/01 al 31/12, 
calcolo premio SU SCAGLIONE MAX d efinendo per l'articolo CDROM, al raggiungimento 
di 5 pezzi sconto a valore su scaglione 1.000 €.  
 Periodicità liquidazione premio ANNUALE,  
 Caricati i seguenti documento  
 Mese di gennaio per articolo CDROM 20 pezzi a 150 €  
 Mese di febbraio per artico lo CDROM 20 pezzi a 175 €  
 Mese di maggio per articolo CDROM 20 pezzi a 180 €  
 Mese di novembre per articolo CDROM 40 pezzi a 165 €  
 Mese di dicembre per articolo CDROM 100 pezzi a 158 €  
  
 
Dettaglio contratto Ripartizione premio per mese


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  - 107  
 
Generazio ne annuale  
  
Visualizzando il contratto possiamo notare che la procedura crea 5 documenti interni di rettifica, uno 
per ogni mese.  
  
 
Generazione premi con metodo calcolo proporzionale su importo


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
108  – E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A    
Se metodo calcolo proporzionale su quantità:  
  
Data docum ento Articolo  Quantità  Importo  
31/01/2015  CDROM  1 100 
28/02/2015  CDROM  1 100 
31/05/2015  CDROM  1 100 
30/11/2015  CDROM  1 200 
31/12/2015  CDROM  1 500 
  
Se metodo calcolo proporzionale su importo:  
  
Data documento  Articolo  Quantità  Importo  
31/01/2015  CDR OM 1 92,31  
28/02/2015  CDROM  1 107,69  
31/05/2015  CDROM  1 110,77  
30/11/2015  CDROM  1 203,08  
31/12/2015  CDROM  1 486,15  
  
Consigliamo nel caso in cui il contratto ha periodicità liquidazione premio ANNUALE di generare il premio e i 
relativi documenti fisca li/rettifica a fine anno onde evitare proliferazioni di documenti generati.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  - 109  
 
________________________________________________________________________________  
________________________________________________________________________________  
______________ __________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
___________________________ _____________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________ ________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
_____________________________________________________ ___________________________  
________________________________________________________________________________  
________________________________________________________________________________  
__________________________________________________________________ ______________  
________________________________________________________________________________


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – G E S T I O N E  P R E M I  D I  F I N E  A N N O  
110  – E S E M P I  C O N T R A T T I  A  O B I E T T I V O / P F A  
 
________________________________________________________________________________  
_____________________________________________________________________________ ___ 
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
_________ _______________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
______________________ __________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
___________________________________ _____________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________ ________________________________  
________________________________________________________________________________


key: chroma:document
string_value:
Piattaforma Applicativa Gestionale  
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 Import dati  
 
Release 8.0


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
I N D I C I  - III Indice  
 
Import dati  ................................ ................................ ................................ ..... 1 
 Logica Funzionale  ................................ ................................ ................................ ..... 3 
 Convenzioni sul Formato Dati ASCII  ................................ ................................ .. 4 
 Convenzioni Adottate nella Procedura di Import Dati  ................................ ..... 5 
 CONFIGURAZIONI  ................................ ................................ ................................ .. 7 
 Tracciati Importazi one ................................ ................................ .............................  8 
 Opzioni avanzate  ................................ ................................ ................................ ..... 12 
 Dettaglio ................................ ................................ ................................ ....................  13 
 Sorgente Dati ODBC  ................................ ................................ .............................  16 
 Valori Predefiniti  ................................ ................................ ................................ ..... 22 
 Archivi di Destinazione  ................................ ................................ .........................  24 
 Trasco difiche  ................................ ................................ ................................ ............  25 
 Utilizzo di Campi EX  ................................ ................................ .............................  27 
 IMPORTAZIONE ARCHIVI  ................................ ................................ .....................  31 
 Import archivi e movimenti contabili  ................................ ................................ . 32


key: chroma:document
string_value:
 Import magazzino e documenti  ................................ ................................ ...........  35 
 Resoconti  ................................ ................................ ................................ ..................  38 
 Stampa Resoconti  ................................ ................................ ................................ .... 39 
 OPERAZIONI DI SERVIZIO  ................................ ................................ ...................  41 
 Caricamento Dizionario Dati  ................................ ................................ ...............  42 
 Import/Export Tabelle Import Dati  ................................ ................................ .. 43 
 Duplicazione Tracciati  ................................ ................................ ............................  45 
 Cancellazione Tracciati  ................................ ................................ ...........................  46 
 STAMPE ARCHIVI  ................................ ................................ ................................ . 49 
 Stampa tracciati records  ................................ ................................ .........................  50 
 Stampa Sorgenti Dati ODBC  ................................ ................................ ...............  51 
 Stampa Archivi di Destinazione  ................................ ................................ ...........  52 
 Stampa Valori Predefiniti  ................................ ................................ .......................  53 
 Stampa Trascodifiche  ................................ ................................ .............................  54 
 TRACCIATI STANDARD  ................................ ................................ .........................  57 
 Importazione da altri Gestionali  ................................ ................................ ..........  58


key: chroma:document
string_value:
 Import da Zucchetti Giove  ................................ ................................ ...................  59 
 Import da modulo Paghe di Apri  ................................ ................................ ........ 61 
 
Le immagini della documentazione di fferiscono 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  – I M P O R T  D A T I  
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  – I M P O R T  D A T I  
I M P O R T  D A T I  - 1 Import dati  
  
Il modulo Import Dati di Ad Hoc Revolution co stituisce un utilissimo strumento per l'importazione 
di dati provenienti dall'esterno, allo scopo sia di permettere un'integrazione costante con altre 
procedure gestionali (importazione ripetuta), sia di effettuare una migrazione degli archivi dovuta ad 
una sostituzione del sistema gestionale (importazione una-tantum ). 
  
Il modulo permette di importare sia gli archivi che i movimenti Contabili, di Magazzino e dei 
Documenti. In particolare gli archivi coinvolti sono:  
 Contabili: Automatismi Contabili, Causali Contabili, Modelli Contabili, Piano dei Conti, 
Destinazioni Diverse, Clienti e Fornitori, Zone, Nazioni, Lingue, Valute, Codici IVA., Agenti, 
Banche, Pagamenti,Centri di Costo, Primanota e Partite/ Scadenze, Anag rafica Cespiti, 
Categorie Cespiti e Saldi Cespiti.  
 Magazzino e Documenti: Articoli e Servizi di Magazzino, Unità di Misura, Causali di 
Magazzino, Causali Documenti, Magazzini, Anagrafica Listini, Listini, Contratti, Categorie 
Provvigioni, Sconti/Maggior azioni, Movimenti di Magazzino, Documenti e Ordini/ Impegni, 
Lotti.  
  
Nella figura seguente è riportato il menu della procedura, ogni opzione sarà descritta nel relativo 
paragrafo.  
  
 
Menù Import dati  
  
 Logica Funzionale  
 Convenzioni sul Formato Dati ASCII  
 Convenzioni adottate nella procedura di Import Dati  
 CONFIGURAZIONI  
 IMPORTAZIONE ARCHIVI


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
2 – I M P O R T  D A T I   OPERAZIONI DI SERVIZIO  
 STAMPE ARCHIVI  
 TRACCIATI STANDARD


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
I M P O R T  D A T I  - 3  Logica Funzionale  
  
Il funzionamento della procedura di Import Dati, può essere così schematizzato:  
1.     Lettura dei file da impor tare da sorgente ASCII o ODBC , specificati nei tracciati di 
importazione;  
2.     Segnalazione dell'eventuale mancanza di file da importare;  
3.     Interpretazione dei record dei file da importare, in base a quanto definito nei tracciati;  
4.     Conversione  dei valori contenuti nel file da importare in base alle trascodifiche impostate;  
5.     Nel caso di import degli archivi Clienti e Fornitori, se la trascodifica per codice cliente e/o 
fornitore è trovata viene impostata automaticamente, altrimenti l'impor t viene effettuato sulla 
base del Codice fiscale e/o Partita Iva;  
6.     Completamento campi non specificati con i Valori Predefiniti;  
7.     Assegnazione del valore di default previsto dalla procedura ai campi vuoti senza valori 
predefiniti;  
8.     Contro llo esistenza dei campi obbligatori;  
9.     Scrittura del resoconto se richiesto.  
  
Se ci sono Errori di importazione, la procedura rimanda al resoconto e dà la possibilità di non 
effettuare l'aggiornamento del Data Base con i dati importati, altrimenti ch iede di cancellare i file di 
origine.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
4 – I M P O R T  D A T I   Convenzioni sul Formato Dati ASCII  
  
La routine di importazione permette di trasferire all'interno della procedura Ad Hoc Revolution, dati 
memorizzati in for mato ASCII . La corrispondenza fra i dati da importare e gli archivi della procedura 
è specificata nell'archivio dei Tracciati Record. In tale gestione è possibile definire, oltre ai tracciati di 
default forniti con la procedura, altri tracciati Tipo defini ti dall'utente; è quindi possibile inserire 
tipologie diverse di importazione.  
  
Nella compilazione dei file ASCII è necessario attenersi alle seguenti convenzioni:  
  
Norme Generali  
1.     Il file deve essere in formato ASCII ; 
2.     In campi devono essere  scritti a lunghezza fissa (formato SDF);  
3.     Al termine di ogni record è necessario inserire la copia di caratteri CR (Carriage Return, 
codice ASCII 13) e LF (Line Feed, codice ASCII 10);  
4.     I dati vengono importati troncando i caratteri in eccesso . 
  
Campi numerici (N)  
1.     Allineamento a destra;  
2.     Senza riempimento con zeri non significativi;  
3.     Se il valore è zero il campo può anche essere completamente vuoto;  
4.     Come separatore delle cifre decimali utilizzare la virgola (la proced ura comunque gestisce 
correttamente anche il punto);  
5.     Non devono essere inseriti separatori per le migliaia;  
6.     Per i valori negativi inserire il segno - davanti alla prima cifra.  
  
Esempio : -123.45 = -123.45.  
  
Campi alfanumerici (C)  
1.     Allineamento a sinistra;  
2.     Riempimento con spazi a destra.  
  
Esempio : Rossi Mario = Rossi Mario.  
  
Campi data (D)  
1.     Esprimere l'anno in quattro cifre seguito da mese e giorno (formato AAAAMMGG);  
2.     E' necessario il riempimento con zeri per le cif re non significative.  
  
Esempio : 03-12-98 = 19981203


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
I M P O R T  D A T I  - 5  Convenzioni Adottate nella Procedura 
di Import Dati  
  
Nello sviluppo del modulo Import Dati sono state ad ottate le seguenti convenzioni per il trattamento 
dei Tracciati Record Multipli, degli archivi complessi strutturati con dati di testata e di corpo 
(Master/Detail) e dell'importazione di dati numerici in campi di tipo carattere.  
  
Gestione Tracciati Record  Multipli  
Contengono dati di più archivi con tracciati differenti. La procedura utilizza il codice dell'archivio per 
filtrare i dati da importare. Per convenzione il codice viene confrontato con i primi due caratteri.  
  
Gestione Master/Detail  
Per convenzio ne, vengono utilizzati i primi dieci caratteri del tracciato del file come chiave di 
associazione delle testate con i record del corpo.  
  
Importazione Dati Numerici in Campi Carattere  
Nel caso di importazione di campi numerici in campi carattere, la proced ura converte il numero zero 
nel campo carattere vuoto. Se si vuole considerare il valore zero come un valore accettabile, è 
necessario utilizzare una trascodifica.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
6 – I M P O R T  D A T I  
 
________________________________________________________________________________  
____ ____________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
_________________ _______________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
______________________________ __________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
___________________________________________ _____________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________ ________________________  
________________________________________________________________________________  
_______________________________________________________________________________


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
C O N F I G U R A Z I O N I  - 7  
  
 CONFIGURAZIONI  
  
Scegliendo  la sezione di menu Configurazioni è possibile accedere alla gestione degli archivi propri del 
modulo Import Dati: Tracciati di Importazione, Sorgente dati ODBC, Archivi di Destinazione, Valori 
Predefiniti, Trascodifiche e relative stampe.  
  
Nelle pagine c he seguono, ogni scelta verrà descritta nel rispettivo paragrafo.  
  
 
Menù Configurazioni  
  
 Tracciati di Importazione  
 Opzioni avanzate  
 Dettaglio  
 Sorgente Dati ODBC  
 Valori Predefiniti  
 Archivi di Destinazione  
 Trascodifiche  
 Utilizzo di Campi EX


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
8 – C O N F I G U R A Z I O N I   Tracciati Importazione  
  
E' possibile specificare il tracciato dei file da importare in  un apposito archivio. Per ogni tracciato 
l'operatore può abilitare le seguenti funzionalità:  
1.     U1tilizzo delle Trascodifiche ; 
2.     Gestione Tracciati Record Multipli  (contengono dati di più archivi con tracciati 
differenti. La procedura utilizza il  codice dell'archivio per filtrare i dati da importare; per 
convenzione il codice viene confrontato con i primi due caratteri).  
  
Tracciati Importazione - Tracciati  
  
 
Tracciati Importazione  
  
Nell'archivio dei tracciati record è possibile specificare:  
 Codice Importazione  
Indica il codice del tracciato record di importazione. L'operatore può caricare diversi codici, a seconda 
di cosa vuole importare, che possono rimanere memorizzati contemporaneamente.  
 Descrizione  
Il campo contiene la descrizione compl eta del tipo di importazione.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
C O N F I G U R A Z I O N I  - 9  Sorgente Dati  
L'utente può utilizzare tracciati record la cui origine dati può essere un database richiamabile mediante 
una connessione ODBC, oppure un file con formato ASCII (si vedano le convenzioni adottate in tale 
caso, descritte nel capitolo precedente).  
 ODBC per File DBF  
Attivando questo check, nelle maschere di Sorgente Dati ODBC e Import Archivi sarà possibile 
impostare il percorso di un'origine dati DBF. Il check risulta visualizzabile solo se si è selezionato una 
Sorgente Dati di tipo ODBC.  
 Avanzate  
Con questo tasto, si possono definire ulteriori opzioni per l'importazione. È possibile specificare un 
filtro di selezione sui record da importare, una rottura di codice (cambio chiave) dei record importati, 
il conto  di Iva indetraibile da specificare nelle registrazioni contabili con Iva indetraibile ed una serie di 
aggiornamenti da effettuarsi in automatico.  
Si aprirà la maschera  
  
- Opzioni a vanzate  
  
Griglia  
Nel caso di importazione di tracciati la cui origine dati è di tipo ODBC, la griglia è la seguente  
 Sorgente Dati ODBC  
È il nome della tabella del database aperto con la connessione ODBC, dal quale importare i dati.  
 Archivio di Destinazione  
E' il codice dell'archivio di destinazione presente in Ad Hoc Revolution nel quale si desidera 
importare la tab ella specificata nel campo Sorgente Dati ODBC. Se per ipotesi nel mio tracciato la 
tabella che voglio importare è quella delle zone, nell'archivio di destinazione dovrà essere indicato il 
codice dell'archivio Zone (ZO).  
 Trascodifica  
Rispetto all'archivi o specificato è necessario indicare se è prevista una trascodifica, ovverosia una 
tabella di corrispondenze tra valori di origine e valori di destinazione.  
 Multiplo  
Si deve indicare se il file di import è a tracciato multiplo, ovverosia contenente più tr acciati (identificati


key: chroma:document
string_value:
dalle prime due lettere del tracciato).  
 Dettaglio  
Con questo tasto l'utente che si è posizionato a livello di riga può visualizzare il dettaglio dei campi 
oggetto di importazione per una specifica tabella. In caso di immissione manu ale dei tracciati, l'utente 
deve indicare il nome dei campi del file di origine e quello dell'archivio dove i dati devono essere 
scritti. Per ogni campo devono essere indicati la lunghezza ed eventuali decimali nel caso di campo 
numerico.  
Si aprirà la masc hera  
  
- Dettaglio


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
10 – C O N F I G U R A Z I O N I  Riportiamo sotto la maschera nel caso di tracciati in formato ASCII; si può notare che in questo caso 
viene richiesto il nome del file ASCII, anziché l'origine dati ODBC.  
  
 
Tracciati Importazione ASCII  
  
Tracciati Importazione - Impostazioni  
  
Nella cartella Impostazioni dei tracciati record si possono indicare sia i controlli che in fase di 
importazione devono essere eseguiti, sia il tipo di resoconto che si vuole ottenere  ad operazione 
terminata.  
  
 
Tracciati Importazione - Impostazioni


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
C O N F I G U R A Z I O N I  - 11  Controllo P . IVA  
Se attivato consente il riconoscimento dei Clienti e dei Fornitori attraverso il controllo della Partita 
Iva, prima di utilizzare il codice associato.  
 Azzera Movimenti  
Se il check è attivato la procedura prima dell'importazione provve de ad eliminare tutti i movimenti 
presenti negli archivi di destinazione.  
 Controllo Valori  
Se il check è attivato, la procedura in fase di importazione propone a video i valori dei campi che sono 
importati.  
 Opzioni di Scrittura dei Resoconti  
L'utente p uò specificare che dopo l'importazione venga prodotta una stampa di resoconto. La stampa 
può riferirsi solo agli errori oppure comprendere anche gli altri tipi di segnalazioni.  
  
Tutto quello che viene definito in questa maschera è riportato anche nella ma schera dell'Importazione 
Dati, dove l'utente può sempre controllare o variare quanto qui impostato.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
12 – C O N F I G U R A Z I O N I   Opzioni avanzate  
  
Vediamo come si presenta la maschera delle Opzioni avanzate  
  
Opzioni avanzate  
  
Relativamente all'archivio di Primanota, si ha la po ssibilità di definire specifiche opzioni in termini di 
aggiornamento archivi:  
 Espressione di Filtro  
Filtro di selezione sui record da importare.  
 Chiave Comune Record  
Rottura di codice (cambio chiave) dei record importati.  
 Conto Iva Indetraibile  
Conto  di Iva Indetraibile da specificare nelle registrazioni contabili con Iva indetraibile.  
 Numeri Registrazioni  
Se attivato la procedura calcola nuovamente il numero delle registrazioni.  
 Aggiorna Righe IVA  
Se attivato aggiorna le righe Iva della primanota . 
 Aggiorna Partite in Automatico  
Se attivato aggiorna le partite.  
 Aggiorna Analitica  
Se attivato aggiorna gli archivi della contabilità analitica.  
 Aggiorna Saldi  
Se attivato aggiorna i saldi degli archivi collegati.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
C O N F I G U R A Z I O N I  - 13  Dettaglio  
  
Di seguito un esemp io di dettaglio della tabella Zone.  
  
 
Dettaglio  
  
 Sequenza  
L'operatore deve indicare la sequenza con cui le tabelle del database ODBC devono essere importate. 
L'indicazione della sequenza di importazione ha un grande significato in quanto consente di r ispettare 
i vincoli di integrità referenziale.  
 Expr.  
Se il check è presente, rispetto al campo è possibile andare a definire un'espressione fatta con i campi 
dei tracciati di importazione, il cui risultato dovrà essere scritto nel campo dell'archivio di destinazione.  
 Campo  
Rappresenta il campo del tracciato di origine dal quale devono essere importati i dati.  
 Lunghezza  
Lunghezza del campo nel tracciato del file ASCII (nel caso la lunghezza del campo definito sulla 
Tabella di Ad Hoc Revolution sia mino re si consiglia di utilizzare questa come lunghezza e aggiungere 
per la parte restante un campo filler) o del file con origine dati ODBC.  
 Decimali  
Il campo indica il numero di decimali nel caso di campo numerico.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
14 – C O N F I G U R A Z I O N I   Tipo Destinazione  
La destinazione all'i nterno degli archivi di Ad Hoc Revolution può essere un campo, un campo 
dettaglio, oppure una variabile, da utilizzarsi all'interno di espressioni. Se è una variabile, in 
corrispondenza delle note si consiglia di definire tutti i valori che può assumere.  
 Destinazione  
Nome dell'eventuale campo di destinazione in Ad Hoc Revolution.  
 Tipo  
La destinazione può assumere le seguenti tipologie: carattere, data, numerico o campo memo.  
 Obbligatorio  
Specifica se il campo è obbligatorio in Ad Hoc Revolution.  
  
Cam pi Obbligatori  
Nel seguito è riportato un elenco dei campi considerati sempre obbligatori anche se non specificato 
nei tracciati record.  
 
 
 
 
 
 
 
 
 
  
  
 Trascodifiche  
Specifica se il valore nel campo di origine debba essere convertito in un valore corrispondente in Ad 
Hoc Revolution, attraverso una tabella di Trascodifiche (accessib ile con l'apposito bottone presente 
sulla maschera).  
 Espressione  
In questo campo deve essere digitata l'espressione da associare ad un campo di destinazione, nel caso 
sia stato attivato il relativo check presente sulle righe della griglia.  
 Lunghezza de i Campi dell'Archivio di Destinazione  
Indica la lunghezza dei campi di destinazione, ed il numero degli eventuali decimali. Se non è definita 
vengono assunte le informazioni della sorgente dati.  
 Nota  
In questo spazio possono essere riportate tutte le ann otazioni che si ritengono utili al fine 
dell'importazione. Possono riferirsi sia ai campi del tracciato che si desidera importare sia a quello di 
destinazione.  Codice 
Archivio  Descrizione  Nomi Campi  Descrizione Campi  
CF Clienti e Fornitori  w_ANTIPCON  
w_ANDESCRI  
w_ANCONSUP  
w_ANC ODLIN  
w_ANCATCON  Tipo Conto: C(Cliente), F(Fornitore)  
Ragione Sociale  
Mastro Contabile di Raggruppamento  
Codice Lingua  
Categoria Contabile


key: chroma:document
string_value:
Ragione Sociale  
Mastro Contabile di Raggruppamento  
Codice Lingua  
Categoria Contabile  
DF Destinazioni 
Diverse  w_DDTIPCON  
w_DDCODICE  
w_DDCODDES  
w_DDTIPRIF  Tipo Conto: C(Cliente), F(Fornitore)  
Codice Clie nte o Fornitore  
Codice Destinazione  
Tipologia Destinazione


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
C O N F I G U R A Z I O N I  - 15  Trascodifiche  
Il tasto risulta attivo solo nel caso in cui per un campo di destinazione sia pr evista una trascodifica. Il 
tasto è il collegamento diretto all'archivio delle trascodifiche.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
16 – C O N F I G U R A Z I O N I   Sorgente Dati ODBC  
  
In questo archivio sono riportate tutte le tabelle da importarsi da una database esterno attrave rso una 
connessione ODBC.  
  
Sorgente dati ODBC - Struttura  
  
 
Sorgente dati ODBC - Struttura  
  
 Codice e Descrizione  
Codice dell'origine dati ODBC da utilizzarsi nei Tracciati di Importazione e relativa descrizione.  
 Campo  
Vengono riportati tutti i campi delle tabelle da cui sono importati i dati. Per ogni campo sono 
riportate informazioni relati ve alla tipologia del campo (se è un campo data, memo, numerico), al 
numero decimali per i campi numerici ed alla relativa descrizione.  
  
Queste informazioni possono essere impostate manualmente dall'operatore, oppure caricate 
automaticamente attraverso la  funzione Copia Struttura presente nella cartella Cursore.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
C O N F I G U R A Z I O N I  - 17 Sorgente dati ODBC - Interrogazione SQL  
Nella cartella devono inserirsi frasi in linguaggio SQL secondo le quali si possono fare delle 
interrogazioni nelle tabelle da cui effettuare l'importazion e. 
  
 
Sorgente dati ODBC - Interrogazione SQL  
  
In questa cartella è necessario specificare una query di selezione dei dati dall'origine ODBC attraverso 
una frase in linguaggio SQL, allo scopo di definire i campi da importare (anche tutti), il nome della 
tabella da cui importare (o di più tabelle collegate) ed eventualmente i filtri di importazione (per 
escludere dei record presenti nella tabella di origine).  
  
Nella query è possibile utilizzare funzioni supportate dal driver ODBC, variabili globali (come 
riportato nella figura) ed eventualmente parametri che saranno richiesti all'utente al momento 
dell'importazione. Il nome delle variabili globali e dei parametri va fatto precedere dal simbolo ?.  
  
La query di selezione da digitare deve rispettare il segu ente formato (nei casi più semplici):  
  
SELECT < nome_campi > FROM < nome_tabella > WHERE < condizioni > 
  
Dove:  
 <nome_campi> rappresenta l'elenco dei campi della tabella di origine che si desiderano 
selezionare. Per selezionare più campi separarli con la virgola, mentre per selezionare tutti i 
campi digitare il simbolo *;  
 <nome_tabella> rappresenta il nome della  tabella di origine. È possibile importare dati da più 
tabelle collegate utilizzando l'operatore JOIN (a tale proposito si rimanda ad una trattazione 
completa del linguaggio SQL);  
 <condizioni> rappresenta un'espressione contenente campi della tabella di origine ed 
operatori logici (=, <> ,<=, LIKE, AND, OR ecc.), da utilizzarsi per filtrare i record da 
importare.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
18 – C O N F I G U R A Z I O N I    
Nel campo Routine elaborazione cursore può infine essere specificata una Routine di CodePainter alla 
quale passare il risultato della query, a l fine di consentire elaborazioni particolari sui dati prima della 
loro importazione.  
  
Sorgente dati ODBC - Cursore  
La seguente cartella Cursore permette il caricamento automatico della struttura della sorgente dati 
ODBC presente nella cartella Struttura.  In alternativa l'utente può impostare manualmente tali 
informazioni.  
  
 
Sorgente dati ODBC - Cursore  
  
In base alla query di selezione impostata nella cartella Interrogazione SQL, è possibile ottenere la 
struttura dell'origine ODBC (elenco campi con rela tiva tipologia e lunghezza), in modo da evitare di 
doverla caricare manualmente.  
  
A tale scopo è necessario eseguire le seguenti operazioni:  
1.     Origine Dati: impostare preventivamente il codice DSN (Data Source Name) della 
connessione ODBC al database ; 
2.     Path: definire il percorso dei file da importare;  
3.     User e Password: nel caso il database di origine abbia dei privilegi di accesso, è possibile 
impostare un codice utente (User) e la relativa password;  
4.     Esegui SQL: a questo punto, prem endo il bottone Esegui SQL, verrà visualizzato il 
contenuto dell'origine dati nella griglia presente nella cartella Cursore. L'utente ha così la 
possibilità di verificare la correttezza della connessione e della query di selezione impostata;  
5.     Copia S truttura: nel caso la connessione e la query siano state impostate correttamente, 
premendo il bottone Copia Struttura si potranno caricare automaticamente le informazioni 
presenti nella cartella Struttura;


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
C O N F I G U R A Z I O N I  - 19 6.     Chiudi Origine Dati: nel caso si desiderino  modificare alcune impostazioni (query e DSN), 
premendo il bottone Chiudi Origine Dati verrà annullato il contenuto della griglia.  
  
Importazione da foglio excel  
Arricchito il modulo import dell’importazione da foglio excel senza dover creare una sorgente dati. 
L’importazione da foglio Excel supera alcuni limiti con Database Oracle, per cui alcune importazioni 
non andavano a buon fine se nel foglio erano presenti campi numerici non in colonna.  
  
Sono stati aggiunti nelle Sorgenti dati.  
• 1. un flag attivabi le in corrispondenza del campo Origine dati dove l’attivazione modifica il 
campo da Origine dati a Nome File;  
  
 
Sorgente dati senza flag attivo  
  
Attivandolo occorre indicare


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
20 – C O N F I G U R A Z I O N I  
 
Sorgente dati con flag  
  
• 2. ‘Percorso e il nome file’ dal quale si inten de effettuare l’importazione, e in più anche 
dettagliare il ‘Nome del foglio excel’ nel campo successivo.  
• Nel caso in cui è indicato un nome file inesistente o un nome foglio inesistente in fase di 
esecuzione è restituito il messaggio:  
• ‘Errore d’import azione, file o foglio inesistente, o già in uso, o formato excel errato’.  
  
Una volta indicato il percorso e il nome dei file da cui s’intende importare si attivano due campi:


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
C O N F I G U R A Z I O N I  - 21 
 
Nuovi campi aggiunti  
  
1. ‘Riga iniziale’ :è possibile iniziare l’importazio ne dalla riga che indichiamo, ad esempio se la 
prima riga del foglio excel contiene il nome dei campi da importare come numero riga 
riporteremo 2, ciò sta ha significare che l’importazione inizierà dalla riga 2 e l’Interrogazione 
SQL riporterà WHERE RECNO( )>1; 
2. ‘Nomi colonne nella riga precedente’ :se attivato fa si che nella riga precedente alla riga da cui 
si importa viene riportato il nome dei campi presenti nel foglio excel; questo campo non 
risulterà più attivo nel momento in cui è specificata un’int errogazione SQL, per riattivarlo 
basterà pulire l’interrogazione SQL.  
  
A questo punto lanciando l’esecuzione, la procedura partendo dal foglio excel indicato costruisce la 
frase SQL.  
  
Con questo nuovo tipo d’importazione è stato aggiunto nei tracciati un  tipo tra le sorgenti dati 
‘EXCEL’ dove l’attivazione modifica il nome del campo successivo alla sequenza in ‘Nome file excel’  
  
Con questa nuova tipologia di importazione occorre che il file excel utilizzato sia salvato in formato ‘Cartella di 
lavoro di M icrosoft Excel 5.0/95’ e il nome del file non deve iniziare con caratteri numerici. Nel caso in cui si 
attivi il flag ‘Nomi colonne nella riga precedente’ nel foglio excel le colonne devono avere tutte un nome e il nome non 
deve iniziare con caratteri nume rici, l’operatore è comunque avvisato nel caso in oggetto con un messaggio in fase di 
esecuzione della sorgente dati.  
  
Attenzione: per una corretta importazione dei dati si consiglia la formattazione dei campi a tipologia 
Testo tranne che per i campi cont enenti date la formattazione deve essere tipo ‘Data’.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
22 – C O N F I G U R A Z I O N I   V alori Predefiniti  
  
L'archivio dei valori predefiniti permette di indicare come devono essere trattati i campi non 
valorizzati nei dati di origine.  
  
Come p er l'archivio delle trascodifiche, è possibile specificare l'archivio di riferimento di Ad Hoc 
Revolution e il nome del campo per il quale indicare un valore predefinito.  
  
 
Valori predefiniti  
  
 Archivio di Riferimento  
Il campo si riferisce al codice dell'archivio precedentemente inserito tra gli Archivi di Destinazione 
(selezionabile mediante uno Zoom).  
 Campo di Destinazione  
È il nome del campo di Ad Hoc Revolution, presente nei tracciati rec ord, per il quale si desidera 
specificare un valore predefinito.  
 Tipo  
Tipologia del valore predefinito da assegnare al campo considerato: Carattere, Numerico, Logico, 
Memo, Data ed Espressione. Quest'ultimo tipo permette di assegnare un valore calcolato mediante 
un'espressione, contenete una combinazione tra altri Campi, Variabili, ed Operatori (numerici e


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
C O N F I G U R A Z I O N I  - 23 logici).  
 Lunghezza  
Lunghezza del valore predefinito da assegnare al campo considerato.  
 Criterio di Assegnazione  
Se nel criterio di assegnazione abb iamo indicato Predefinito è possibile assegnare un valore specificato 
nel campo Valore Predefinito; tale valore avrà il tipo e la lunghezza specificati in precedenza. In caso 
contrario la riga sarà ignorata.  
 Valore Predefinito  
Contiene la costante o l'es pressione che ha come risultato un valore predefinito.  
  
E' anche possibile specificare valori predefiniti diversi per ogni tracciato di importazione, indicandoli 
nella griglia presente sul fondo della maschera.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
24 – C O N F I G U R A Z I O N I   Archivi di Destinazione  
  
In questa tabella sono contenuti i codici di riferimento degli archivi di Ad Hoc Revolution in cui 
importare dati esterni, da utilizzarsi nei Tracciati di Importazione. Tale archivio, difa tti, non richiama 
direttamente il codice della tabella presente in Ad Hoc Revolution, bensì un suo codice di riferimento 
specificato negli Archivi di Destinazione.  
  
Le tabelle di Ad Hoc Revolution nelle quali è possibile importare dati esterni sono state definite nell'architettura del 
modulo Import Dati, per cui non è possibile aggiungere nuove tabelle semplicemente impostando questo archivio.  
Si consiglia, quindi, di non modificare il contenuto preimpostato degli Archivi di Destinazione.  
  
 
Archivi di de stinazione  
  
 Codice e Descrizione  
Indica il codice che identifica l'archivio di destinazione presente in Ad hoc Revolution, con la relativa 
descrizione.  
 Archivio  
È il codice della tabella presente in Ad Hoc Revolution nella quale si desidera importare dati esterni.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
C O N F I G U R A Z I O N I  - 25  Trascodifiche  
  
Per mezzo delle Trascodifiche è possibile specificare una corrispondenza tra i valori presenti negli 
archivi di origine e quelli che invece si desidera vengano scritti negli archivi di d estinazione. Con 
riferimento ad un certo campo dati, possono essere specificati i valori da scrivere negli archivi di Ad 
Hoc Revolution per ciascun valore originario presente negli archivi da importare.  
  
Ad esempio, nel caso il campo Prorata presente nell 'archivio Codici IVA di origine contenga il valore 
+ per indicare un codice Iva esente, bisognerà specificare una trascodifica che associ a tale valore il 
codice S (utilizzato per lo stesso scopo da Ad Hoc Revolution).  
  
 
Trascodifiche  
  
 Archivio di Rif erimento  
Il campo si riferisce al codice dell'archivio precedentemente inserito tra gli Archivi di Destinazione 
(selezionabile mediante uno Zoom).  
 Trascodifica Parziale  
Se attivato e se il valore di origine non è presente nella trascodifica, questo viene  restituito invariato, 
senza segnalare alcun errore.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
26 – C O N F I G U R A Z I O N I   Nome Campo  
E' il nome del campo di Ad Hoc Revolution, presente nei tracciati record, del quale si vogliono 
specificare le trascodifiche per ogni valore passato dalla procedura esterna.  
 Si Applica A  
La trascodifica può riferirsi a tutti i tracciati di importazione, oppure essere specificata per uno 
determinato tracciato di importazione (da indicarsi nel campo predisposto a fianco).  
 Codice Esterno  
L'operatore può indicare tutti i valori usati dalla pr ocedura esterna rispetto ai quali si vuole stabilire il 
corrispondente valore in Ad Hoc Revolution.  
 Codice Interno  
L'utente deve indicare il corrispondente valore da scrivere negli archivi di Ad Hoc Revolution rispetto 
al valore della procedura esterna.  
  
Porre estrema attenzione all'allineamento dei tracciati. Ad esempio, se importo i codici Iva senza trascodifica, anche 
le altre tabelle che contengono il riferimento a codici Iva non devono avere trascodifiche.  
Se per un campo si attiva la trascodifica d evono essere previsti tutti i valori (anche quelli che hanno un identico 
valore corrispondente in Ad Hoc Revolution.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
C O N F I G U R A Z I O N I  - 27  Utilizzo di Campi EX  
  
I campi EX sono campi non compresi ne l tracciato standard di Ad Hoc Revolution. Vengono 
utilizzati per passare informazioni alla procedura.  
  
Possono essere utilizzati nella definizione dei tracciati record per gestire i valori che non hanno 
corrispondenza in ad hoc Revolution e negli archivi  Trascodifiche e Valori Predefiniti per assegnare 
automaticamente un valore a campi di Ad Hoc Revolution.  
  
Nel seguito si riporta un elenco dei campi utilizzati, con le specifiche di funzionamento per alcuni casi 
particolari.  
  
CAMPO EX  Specifiche  
EXMAS CON  Può essere utilizzato sia per l'import Piano dei conti (PC), sia per l'import saldi 
Conti (SC); può assumere valore M = Mastro, C = Conto , S = Sottoconto.  
Se questo campo è lasciato vuoto, vedi file ASCII export di Ad Hoc, la procedura 
considera conti  quelli che non hanno tre zeri come ultimi caratteri del codice e i 
sottoconti di tipo cliente/fornitore.  
EXTIPSOT  E' utilizzato nell'import degli automatismi contabili e contiene, prima 
dell'eventuale trascodifica, il tipo sottoconto.  
EXSEZBIL  Sezione d i bilancio della procedura esterna utilizzata al momento del caricamento 
dei conti e dei mastri.  
EXCODIVA  E' utilizzato nell'import dei modelli contabili e degli automatismi contabili e 
contiene il codice I.V .A. della procedura esterna; viene utilizzato p er riconoscere 
quali righe devono essere riportate anche negli automatismi I.V .A.  
EXCLFTIP  E' utilizzato nell'import degli automatismi contabili e contiene il tipo riga Cliente o 
Fornitore; può assumere valori C, F .  
EXTIPREG  E' utilizzato nell'import deg li automatismi contabili e contiene il tipo registro Iva; 
viene letto dalla testata delle Causali Contabili.  
EXFLPART  E' utilizzato nell'import degli automatismi contabili, viene letto dalle causali 
contabili e contiene il valore S o N.


key: chroma:document
string_value:
contabili e contiene il valore S o N.  
EXCONDET  E' utili zzato nell'import degli automatismi contabili, viene scritto sugli 
automatismi I.V .A. e contiene il conto I.V .A. detraibile letto dall'automatismo 
contabile.  
EXCONIND  E' utilizzato nell'import degli automatismi Iva; è lasciato a disposizione dell'utente.  
EXCODCLI  Codice cliente esterno: è utilizzato per elaborazioni.  
EXCODFOR  Codice fornitore esterno: è utilizzato per elaborazioni.  
EXCLFCON  E' utilizzato nell'import degli automatismi contabili e contiene il conto cliente o 
fornitore.  
EXNUMREG  E' utiliz zato nell'import degli automatismi contabili e contiene il numero del 
registro Iva; viene letto dalla testata delle Causali Contabili.  
EXCLIFOR  E' utilizzato nelle Anagrafiche Clienti Fornitori e contiene il codice utilizzato dalla 
procedura esterna.  
EXN UOCLF  E' utilizzato nell'import Clienti Fornitori; assume valori S o N e identifica un 
Cliente Fornitore nuovo o variato.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
28 – C O N F I G U R A Z I O N I  EXA VEPRO  
EXA VEPER  
EXDARPRO  
EXDARPER  Sono utilizzati dalla procedura per sommare i saldi da mettere nei saldi fuori linea 
in Ad Hoc Re volution.  
EXNUMPAR  Numero partita.  
EXDATSCA  Data scadenza.  
EXVALORE  Valore procedura esterna (es. importo registrazioni).  
EXVALVAL  Importo dare o avere in valuta.  
EXFLDA VE  Flag dare/avere.  
EXNUMREG  Numero registrazione.  
EXDATREG  Data registrazione.  
EXINICOM  Data inizio competenza.  
EXFINCOM  Data fine competenza.  
EXPARAME  Parametro di calcolo.  
EX_SEGNO  Segno (+, -). 
EXCODICE  Codice procedura esterna (es. codice conto).  
EXIMPONI  
EXIMPON1  
  
EXIMPON9  Imponibile Iva.  
EXIMPIVA  
EXIMPIV1  
  
EXIMPIV9  Impo rto Iva.  
EXCODIV1  
  
EXCODIV9  Codice Iva.  
EXDESCRI  Descrizione (es. descrizione Partite).  
EX_TIPO  Tipo.  
EXNUMDOC  Numero documento.  
EXALFDOC  Alfa documento.  
EXDATDOC  Data documento.  
EXCODVAL  Codice valuta.  
EXCODPAG  Codice pagamento.  
EXCODESE  Codice esercizio.  
EXCODVOC  Codice Voce di Costo/Ricavo.  
EXCODCEN  Codice Centro di Costo/Ricavo  
EXCODCOM  Codice Commessa.  
EXCODESE  Codice esercizio.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
C O N F I G U R A Z I O N I  - 29 
 
________________________________________________________________________________  
_______________________ _________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
____________________________________ ____________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
_________________________________________________ _______________________________  
________________________________________________________________________________  
________________________________________________________________________________  
______________________________________________________________ __________________  
________________________________________________________________________________  
________________________________________________________________________________  
___________________________________________________________________________ _____  
________________________________________________________________________________  
________________________________________________________________________________


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
30 – C O N F I G U R A Z I O N I  
 
________________________________________________________________________________  
_____ ___________________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
__________________ ______________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
_______________________________ _________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
____________________________________________ ____________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
_________________________________________________________ _______________________  
________________________________________________________________________________  
_______________________________________________________________________________


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
I M P O R T A Z I O N E  A R C H I V I  - 31  IMPORTAZIONE ARCHIVI  
  
Mediante questa funzione è possibile, dopo aver definito i tracciati, le trascodifiche e i valori 
predefiniti nelle apposite gestioni, effettuare l'importazione vera e propria delle Anagrafiche Contabili, 
dei Movimenti Contabili, delle Anagrafiche di Magazzi no e dei Movimenti di Magazzino e 
Documenti.  
  
Al termine dell'importazione potranno essere emessi dei resoconti di importazione, al fine di 
analizzare il risultato della procedura di Import.  
  
 
Menù Resoconti  
  
 Import archivi e movimenti contabili  
 Import magazzino e documenti  
 Resoconti  
 Stampa Resoconti


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
32 – I M P O R T A Z I O N E  A R C H I V I   Import archivi e movimenti  contabili  
  
L'importazione può riferirsi sia a sorgenti dati ODBC, sia a file ASCII. Nel primo caso è necessario 
indicare il Data Source Name (DSN), mentre nel secondo caso il percorso della cartella contenente i 
file. 
  
E' possibile specificare quali arc hivi importare, se si vuole il resoconto a fine importazione, se si vuole 
effettuare il controllo analitico di ogni record importato, se si vuole riconoscere l'esistenza di un 
cliente o fornitore prima per partita IVA e poi per codice o solo per codice, se  si vogliono azzerare le 
movimentazioni prima di importarle ed infine se si vuole eseguire l'intera procedura sotto transazione 
(in tal caso l'aggiornamento dei dati verrà effettuato solo alla fine di tutte le importazioni richieste).  
  
 
Import archivi e movimenti contabili  
  
 Tracciati  
In questo campo deve essere inserito il codice del tracciato di importazione.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
I M P O R T A Z I O N E  A R C H I V I  - 33  Origine Dati  
In questo campo deve essere inserito il Data Source Name (DSN), nel caso di importazione da 
origine ODBC, oppure il percorso dell a cartella contenente i file ASCII. Nel caso il database di 
origine abbia dei privilegi di accesso (origine ODBC), è possibile impostare un codice utente (User) e 
la relativa password.  
 Path  
In caso di importazione da origine ODBC, in questo campo è possi bile definire il percorso dei file 
DBF da importare. La visualizzazione di questo campo è condizionata all'attivazione del relativo 
check nella maschera Tracciati di Importazioni.  
  
Selezione Archivi  
L'operatore può selezionare gli archivi che vuole import are attivando il relativo check.  
  
Prestare attenzione alla selezione degli archivi da importare. I vincoli di integrità del database potrebbero non essere 
soddisfatti se alcuni archivi non venissero importati.  
  
Verifiche e resoconti  
 Controllo Valori  
Se attivato, la procedura controlla il valore assegnato a tutti i campi ed emette per ognuno di questi un 
messaggio a video. Finché si risponde Si, la procedura continua ad emettere per ogni campo un 
messaggio a video.  
 Opzioni di Scrit tura dei Resoconti  
L'utente può specificare che dopo l'importazione venga prodotta una stampa di resoconto. La stampa 
può riferirsi solo agli errori oppure comprendere anche gli altri tipi di segnalazione.  
  
Opzioni  
 Controllo P . IVA  
Se attivato e se la t rascodifica parziale non restituisce una corrispondenza per il codice esterno, 
consente il riconoscimento dei Clienti e dei Fornitori attraverso il controllo della Partita Iva e in 
seconda istanza del Codice Fiscale, prima di utilizzare il codice associato .  
 Azzera Movimenti  
Se il check è attivato, è possibile eseguire più volte l'import di alcune tabelle anagrafiche di tipo


key: chroma:document
string_value:
Master/Detail (Contratti, Distinta Base, Modelli Contabili, Pagamenti dettaglio) in modo da poter 
aggiornare una tabella sulla quale è stata aggiunta un'informazione di dettaglio nei dati di origine. 
Esempio: viene eseguito l'import di un contratto con una sola riga di dettaglio, successivamente nella 
procedura di origine viene aggiunta una ulteriore riga di dettaglio; attivando il check Azzera 
movimenti, alla riesecuzione dell'importazione, viene modificato il contratto precedentemente 
importato con l'aggiunta della nuova riga.  
 Sotto Transazione  
Se attivato, la procedura effettua l'importazione di tutti gli archivi all'interno di un'unica transazione: se


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
34 – I M P O R T A Z I O N E  A R C H I V I  nella fase di importazione si verifica un problema in un archivio, non viene scritto nulla negli archivi di 
destinazione. Se il check non è attivato l'importazione di ogni archivio viene vista dalla procedura 
come una transazione a sé stante.  
 Richiesta Conferma  
Se attivato, la procedura chiede conferma per effettuare l'aggiornamento del Database, anche se il 
processo di import azione è andato a buon fine.  
 Info 
Tramite questo bottone si accede ad una maschera che riporta delle avvertenze per il processo di 
importazione.  
  
La procedura eseguita sotto transazione offre la possibilità di verificare la correttezza dei dati di origi ne senza 
effettuare modifiche errate o parziali al Database.  
L'elaborazione sotto transazione ha il difetto di mantenere tutti i dati in memoria senza rilasciarla fino al termine. 
L'importazione Sotto Transazione di archivi molto grandi potrebbe perciò ess ere molto lenta o bloccarsi addirittura 
per insufficienza di memoria.  
Si consiglia di utilizzare questa opzione per effettuare delle prove e comunque nel caso di importazioni molto grandi 
suddividere i dati in successive elaborazioni.  
  
Al termine dell'imp ortazione, l'eventuale resoconto richiesto sarà memorizzato nell'archivio Resoconti 
e potrà poi essere stampato attraverso la Stampa Resoconti.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
I M P O R T A Z I O N E  A R C H I V I  - 35  Import magazzino e documenti  
  
E' possibile importare gl i archivi di magazzino ed i documenti. Riportiamo di seguito la relativa 
maschera  
  
 
Import magazzino e documenti  
  
 Tracciati  
In questo campo deve essere inserito il codice del tracciato di importazione.  
 Origine Dati  
In questo campo deve essere inserito il Data Source Name (DSN), nel caso di importazione da 
origine ODBC, oppure il percorso della cartella contenente i file ASCII. Nel caso il database di 
origine abbia dei privilegi di accesso (origine ODBC), è possibile impostare un codice utente (User) e 
la relativa password.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
36 – I M P O R T A Z I O N E  A R C H I V I   Path  
In caso di importazione da origine ODBC, in questo campo è possibile definire il perco rso dei file 
DBF da importare. La visualizzazione di questo campo è condizionata all'attivazione del relativo 
check nella maschera Tracciati di Importazioni.  
  
Selezione Archivi  
L'operatore può selezionare gli archivi che vuole importare attivando il relat ivo check.  
  
Prestare attenzione alla selezione degli archivi da importare. I vincoli di integrità del database potrebbero non essere 
soddisfatti se alcuni archivi non venissero importati.  
  
Verifiche e resoconti  
 Controllo Valori  
Se attivato, la procedura controlla il valore assegnato a tutti i campi ed emette per ognuno di questi un 
messaggio a video. Finché si risponde Si, la procedura continua ad emettere per ogni campo un 
messaggio a video.  
 Opzioni di Scrit tura dei Resoconti  
L'utente può specificare che dopo l'importazione venga prodotta una stampa di resoconto. La stampa 
può riferirsi solo agli errori oppure comprendere anche gli altri tipi di segnalazione.  
  
Opzioni  
 Controllo P . IVA  
Se attivato e se la t rascodifica parziale non restituisce una corrispondenza per il codice esterno, 
consente il riconoscimento dei Clienti e dei Fornitori attraverso il controllo della Partita Iva e in 
seconda istanza del Codice Fiscale, prima di utilizzare il codice associato .  
 Azzera Movimenti  
Se il check è attivato, è possibile eseguire più volte l'import di alcune tabelle anagrafiche di tipo 
Master/Detail (Contratti, Distinta Base, Modelli Contabili, Pagamenti dettaglio) in modo da poter 
aggiornare una tabella sulla quale è stata aggiunta un'informazione di dettaglio nei dati di origine. 
Esempio: viene eseguito l'import di un contratto con una sola riga di dettaglio, successivamente nella


key: chroma:document
string_value:
procedura di origine viene aggiunta una ulteriore riga di dettaglio; attivando il check Azzera 
movimenti, alla riesecuzione dell'importazione, viene modificato il contratto precedentemente 
importato con l'aggiunta della nuova riga.  
 Sotto Transazione  
Se attivato, la procedura effettua l'importazione di tutti gli archivi all'interno di un'unica transazione: se 
nella fase di importazione si verifica un problema in un archivio, non viene scritto nulla negli archivi di 
destinazione. Se il check non è attivato l'importazione di ogni archivio viene vista dalla procedura 
come una transazione a sé stante.  
 Richiesta Conferma  
Se attivato, la procedura chiede conferma per effettuare l'aggiornamento del Database, anche se il


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
I M P O R T A Z I O N E  A R C H I V I  - 37 processo di import azione è andato a buon fine.  
 Info 
Tramite questo bottone si accede ad una maschera che riporta delle avvertenze per il processo di 
importazione.  
  
La procedura eseguita sotto transazione offre la possibilità di verificare la correttezza dei dati di origi ne senza 
effettuare modifiche errate o parziali al Database.  
L'elaborazione sotto transazione ha il difetto di mantenere tutti i dati in memoria senza rilasciarla fino al termine. 
L'importazione Sotto Transazione di archivi molto grandi potrebbe perciò ess ere molto lenta o bloccarsi addirittura 
per insufficienza di memoria.  
Si consiglia di utilizzare questa opzione per effettuare delle prove e comunque nel caso di importazioni molto grandi 
suddividere i dati in successive elaborazioni.  
  
Al termine dell'imp ortazione, l'eventuale resoconto richiesto sarà memorizzato nell'archivio Resoconti 
e potrà poi essere stampato attraverso la Stampa Resoconti.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
38 – I M P O R T A Z I O N E  A R C H I V I   Resoconti  
  
Oltre alla possibilità di controllare ogni record durante il tr asferimento, la procedura mette a 
disposizione una gestione resoconti e la relativa stampa. L'utente può specificare al momento di 
definizione del criterio di importazione se compilare o meno il resoconto.  
  
L'archivio Resoconti contiene lo storico dei rec ord importati, data ed ora di inizio e di fine import e 
risultato dell'operazione (riepilogo dei record scartati ed il dettaglio dei problemi riscontrati).  
  
L'archivio storico dei resoconti mantiene traccia dell'ultima operazione eseguita per ogni tipo di  
tracciato di importazione definito.  
  
 
Resoconti  
  
 Import  
E' il nome dell'archivio importato a cui si riferisce il resoconto. Il resoconto può contenere, a seconda 
di quanto impostato nell'archivio del tracciati record, solo errori od anche segnalazioni.  
 Operazione Eseguita  
Vengono riportate tutte le f asi e/o passi dell'importazione. In questo campo viene memorizzata la 
descrizione della fase.  
 Dettaglio  
Informazioni dettagliate della fase di import (nell'esempio in valore contenuto nel campo chiave).


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
I M P O R T A Z I O N E  A R C H I V I  - 39  Stampa Res oconti  
  
La procedura permette di stampare il resoconto dell'import con possibili selezioni sul tracciato di 
importazione e sulla tipologia di resoconto (solo errori, segnalazioni, tutti).  
  
 
Stampa Resoconti  
  
 Tracciati  
L'utente deve indicare il codice  del Tracciato di Importazione a cui si riferisce il resoconto.  
 Tipologia  
La stampa del resoconto associato all'archivio che si è importato può essere fatta con la separata 
indicazione degli errori dalle sole segnalazioni oppure senza alcuna distinzione tra i due.  
  
Se ci sono errori, l'anteprima di stampa con il resoconto viene aperta automaticamente.


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


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
O P E R A Z I O N I  D I  S E R V I Z IO - 41   
 OPERAZIONI DI SERVIZIO  
  
Correlate al Modulo di Import sono forni te quattro operazioni di servizio per facilitare il 
mantenimento dei dati riguardanti i Tracciati di Importazione:  
 Caricamento Dizionario Dati  
 Import/Export Tabelle Import Dati  
 Duplicazione Tracciati  
 Cancellazione Tracciati  
  
 
Menù Servizi  
  
 Caricamento Dizionario Dati  
 Import/Export Tabelle Import Dati  
 Duplicazione Tracciati  
 Cancellazione Tracciati


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
42 – O P E R A Z I O N I  D I  S E R V I Z IO  Caricamento Dizionario Dati  
  
La procedura permette di salvare l'intero dizionario dati corrente in una tabella di servizio, nella quale 
vengono memorizzati i tracciati record di tutti gli archivi della procedura, con le relative strutture da ti 
(elenco campi con tipo e lunghezza).  
  
Questa funzionalità permette di accedere mediante uno Zoom alle tabelle ed ai campi di Ad Hoc 
Revolution, velocizzandone il caricamento ed evitando errori di digitazione.  
  
Si consiglia di eseguire questa procedura  prima del caricamento di un nuovo Tracciato di 
Importazione dati esterni.  
  
 
Caricamento Dizionario Dati  
  
 Cancella Dizionario Corrente  
Se attivato, la procedura cancella il contenuto della tabella di servizio, prima di procedere con il 
caricamento del  dizionario dati corrente.  
 Forza Aggiornamento  
Se attivato, la procedura provvede ad aggiornare la tabella di servizio senza effettuare nessun controllo 
sulla data dell'ultimo aggiornamento del dizionario dati. In caso contrario, tale tabella sarà aggior nata 
solo se il Dizionario Dati ha subito modifiche (dovute all'installazione di una nuova release di Ad Hoc 
Revolution, oppure a personalizzazioni).


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
O P E R A Z I O N I  D I  S E R V I Z IO - 43  Import/Export Tabelle Import Dati  
  
La procedu ra permette di importare o esportare i Tracciati di Importazione, gli Archivi di 
Destinazione, i Valori Predefiniti e le Trascodifiche attraverso un file in formato ASCII o DBF .  
  
La procedura può essere utilizzata per caricare i Tracciati di Importazione da procedure esterne 
rilasciati con il CD di installazione di Ad Hoc Revolution. Inoltre fornisce all'utente la possibilità di 
definire archivi di importazione su aziende di prova e trasportarli successivamente su altre aziende. La 
procedura effettua un ag giornamento degli archivi senza andare ad eliminare i dati preesistenti.  
  
L'utente può selezionare solo alcuni archivi che si desiderano importare od esportare.  
  
Per le tabelle dei Tracciati Record, Valori Predefiniti e Trascodifiche sono previsti due fi le: il primo 
contiene i dati di testata, mentre il secondo i dati del corpo.  
  
 
Import Export Tabelle Import Dati - Formato DBF


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
44 – O P E R A Z I O N I  D I  S E R V I Z IO 
 
Import Export Tabelle Import Dati - Formato ASCII  
  
Si consiglia di utilizzare l'import/export in formato DBF; il formato A SCII, mantenuto per ragioni di 
compatibilità verso il passato, ha difatti diversi limiti:  
1) è possibile importare/esportare sono tracciati con sorgente dati ASCII; non sono supportate le sorgenti dati 
ODBC;  
2) non è gestita la tipologia CAMPO nei campi di  destinazione dei tracciati, ma si utilizza sempre la tipologia 
V ARIABILE;  
3) non è gestita la tipologia ESPRESSIONE nei campi di origine dei tracciati.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
O P E R A Z I O N I  D I  S E R V I Z IO - 45  Duplicazione Tracciati  
  
La procedura permette di crea re un tracciato nuovo prendendo i dati da un tracciato di partenza 
esistente, selezionando eventualmente un intervallo di archivi di destinazione.  
  
 
Duplicazione Tracciati  
  
Il tracciato appena creato sarà visualizzabile nell'archivio dei Tracciati di Im portazione. In caso di 
esecuzione conclusa con successo viene emesso un messaggio.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
46 – O P E R A Z I O N I  D I  S E R V I Z IO  Cancellazione Tracciati  
  
Questa opzione permette di cancellare dal database tutti i tracciati di importazione e gli archiv i di 
supporto collegati.  
Di seguito riportiamo la maschera che avvisa delle conseguenze dell'operazione.  
  
 
Cancellazione Tracciati


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


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


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
S T A M P E  A R C H I V I  - 49  
  
 STAMPE ARCHIVI  
  
E' possibile stampare il  contenuto di tutti gli archivi del modulo Import Dati. Sono disponibili le 
stampe dei Tracciati di Importazione, delle Sorgenti Dati ODBC, degli Archivi di Destinazione, dei 
Valori Predefiniti e delle Trascodifiche.  
  
 
Menù Stampe  
  
 Stampa tracciati records  
 Stampa Sorgente Dati ODBC  
 Stampa Archivi di Destinazione  
 Stampa Valori Predefiniti  
 Stampa Trascodifiche


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
50 – S T A M P E  A R C H I V I   Stampa tracciati records  
  
 
Stampa tracciati records  
  
 Tracciati  
Il campo indica il codice del tracciato di importazione da stampare.  
 Da Archivio - Ad Archivio  
La stampa del tracciato record di un criterio di importazione può essere lanciata prendendo in 
considerazione un intervallo di codici archivio in  esso definiti.  
 Da Numero Campo - A Numero Campo  
L'utente può ulteriormente selezionare la stampa in relazione ad un intervallo di numeri, associati ai 
campi degli archivi.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
S T A M P E  A R C H I V I  - 51  Stampa Sorgenti Dati ODBC  
  
 
Stampa sorgenti dati ODBC  
  
 Da Codice - A Codice  
L'utente può definire un intervallo di selezione dei codici delle sorgenti dati ODBC che desidera 
stampare.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
52 – S T A M P E  A R C H I V I   Stampa Archivi di Destinazione  
  
L'utente può stampare la codifica degli Archivi di Destinazione andando a definire un intervallo di 
codici archivio.  
  
 
Stampa Archivi di Destinazione  
  
 Da Codice - A Codice  
La stampa può essere richiesta per un solo codic e Archivio di Destinazione o relativamente a più 
codici.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
S T A M P E  A R C H I V I  - 53  Stampa V alori Predefiniti  
  
 
Stampa Valori Predefiniti  
  
 Da Archivio - Ad Archivio  
L'utente può richiedere la stampa dei valori predefiniti in r elazione ad un archivio oppure a più archivi. 
La stampa prodotta conterrà tutti i campi degli archivi per cui si è stabilito un certo valore.  
 Da Campo - A Campo  
L'utente può ulteriormente selezionare la stampa in relazione a determinati campi all'interno  di uno o 
più archivi.  
 Tracciati  
Codice del Tracciato di Importazione per il quale si sono definiti valori predefiniti particolari. Se non 
si definisce nessun tracciato, la stampa prodotta sarà relativa a tutti i tracciati presenti nel 
corrispondente ar chivio.  
  
Nella stampa prodotta, oltre al campo con il valore generico, viene riportato anche il valore del campo 
assegnato per i tracciati di importazione con valore particolare.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
54 – S T A M P E  A R C H I V I   Stampa Trascodifiche  
  
 
Stampa Trascodifiche  
  
 Applicate A  
La stampa delle Trascodifiche può essere fatta per tutti i tracciati di importazione o per un 
determinato tracciato.  
  
Nel caso di stampa del singolo tracciato il campo sottostante risulta editabile altrimenti rimane 
protetto. La stampa prodo tta conterrà tutti i campi degli archivi per i quali è stata definita una 
trascodifica.  
 Tracciati  
Codice del Tracciato di Importazione per il quale sono state definite trascodifiche particolari. Risulta 
editabile solo se è stato scelto un singolo traccia to da stampare (selezione precedente).  
 Da Archivio - Ad Archivio  
L'utente può richiedere la stampa delle trascodifiche in relazione ad un archivio oppure a più archivi. 
La stampa prodotta conterrà tutti i campi degli archivi per i quali è stata stabilita  una trascodifica.  
 Da Campo - A Campo  
L'utente può ulteriormente selezionare la stampa in relazione a determinati campi all'interno di uno o 
più archivi.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
S T A M P E  A R C H I V I  - 55 
 
________________________________________________________________________________  
_____________ ___________________________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
__________________________ ______________________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
_______________________________________ _________________________________________  
________________________________________________________________________________  
________________________________________________________________________________  
____________________________________________________ ____________________________  
________________________________________________________________________________  
________________________________________________________________________________  
_________________________________________________________________ _______________  
________________________________________________________________________________  
________________________________________________________________________________


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


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
T R A C C I A T I  S T A N D A R D  - 57   
 TRACCIATI STAND ARD 
  
 Importazione da altri Gestionali  
 Importazione da Giove  
 Importazione da modulo Paghe di Apri


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
58 - T R A C C I A T I  S T A N D A R D   Importazione da altri Gestionali  
  
Riportiamo di seguito le procedure di conversione  da altri Gestionali rilasciate come tracciati standard 
di ad hoc Revolution.  
 Ad hoc Windows release 3.0 e successive  
 Esatto 2000  
 Gestionale 1 release 2.3 e successive  
 Fenice Dos v. 4.1.0  
 Zucchetti Giove  
 Modulo Paghe di APRI  
  
Per quanto riguar da le importazioni da Ad hoc Windows, Esatto, Gestionale 1 e Fenice sono 
disponibili i relativi manuali che indicano le operazioni da eseguire per una corretta importazione.  
Per quanto riguarda l'importazione da Giove e Modulo Paghe di Apri riportiamo di s eguito alcune 
informazioni relative alla procedura di importazione.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
T R A C C I A T I  S T A N D A R D  - 59  Import da Zucchetti Giove  
  
Utilizzando i tracciati standard GIOVE e GIOVE_VER_7_14 è possibile importare i movimenti 
contabili da Zucchetti Giove relativamente all'esercizio con il quale si accede a ad  hoc Revolution.  
  
I tracciati di importazione possono essere importati tramite la funzione "Imp/Exp Tabelle Import 
dati" dai Servizi del modulo import.  
  
Operazioni preliminari  
Per poter eseguire l'importazione dei movimenti contabili provenienti da Zucchetti Giove è 
necessario:  
 Inserire in ad hoc Revolution le stesse causali contabili e gli stessi conti presenti nel file Ascii 
prodotto da Giove;  
 Nelle proprietà avanzate del tracciato GIOVE è presente l'espressione di filtro 
w_EXCONIND=16 secondo la quale verranno importate so lo le registrazioni relative 
all'azienda 16 di Giove, mentre nel tracciato GIOVE_VER_7_14 è presente l'espressione di 
filtro w_EXCONIND=3 secondo la quale verranno importate solo le registrazioni relative 
all'azienda 3 di Giove.  
  
Import Movimenti  
Per effe ttuare l' importazione dei movimenti contabili è necessario entrare in Ad Hoc Revolution con 
data di sistema con la quale si desidera eseguire l'importazione; tale data viene utilizzata come data di 
registrazione per i movimenti contabili importati.  
  
Dalla maschera Import Archivi e Movimenti Contabili occorre selezionare il tracciato GIOVE (per le 
release antecedenti alla 7.14) oppure GIOVE_VER_7_14 (per la release 7.14 di Giove) ed il percorso 
nel quale è stato salvato il file da importare.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
60 - T R A C C I A T I  S T A N D A R D  
 
Maschera d i importazione da Zucchetti Giove


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
T R A C C I A T I  S T A N D A R D  - 61  Import da modulo Paghe di Apri  
  
Con i tracciati standard di importazione dal modulo Paghe di Apri è possibile importare in a d hoc 
Revolution i movimenti contabili relativi ai Salari e Stipendi del modulo PAGHE e PAGHE 1 di Apri.  
  
Operazioni Preliminari  
Per poter eseguire l'importazione è necessario che in ad hoc Revolution siano stati caricati:  
 Negli archivi contabili gli st essi conti utilizzati nel file prodotto da Apri;  
 Se l'azienda oggetto dell'importazione non gestisce l'analitica ovvero nel file di origine non è 
presente il codice del Centro di Costo Contabile (da posizione 10 a posizione 21) occorre 
caricare una causa le (codice XSTIN) come segue:  
  
 
Causale Contabile XSTIN per non gestire l’analitica  
  
 Se l'azienda oggetto dell'importazione gestisce l'analitica ovvero nel file di origine è presente il 
codice del Centro di Costo Contabile (da posizione 10 a posizione  21) occorre caricare una 
causale (codice XSTIP) come segue:


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
62 - T R A C C I A T I  S T A N D A R D  
 
Causale Contabile XSTIP per gestire l’analitica  
  
Supponiamo che l'utente abbia codificato in maniera diversa nel proprio archivio le causali contabili 
identificative di questa tipologia di o perazioni (ad esempio 010 invece di XSTIP e 011 invece di 
XSTIN).  
  
Per garantire il funzionamento dell'import dei movimenti, dopo aver importato i tracciati da apposita 
funzione di servizio (Import/Export tabelle import dati), occorrerà richiamare all' interno del modulo 
Import Dati Configurazioni  Trascodifiche l'archivio di riferimento PN per il tracciato 
APRI_PAGHE e sostituire il codice interno inserito (XSTIP e XSTIN) con i codici delle causali 
sostitutive (010 e 011).


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
T R A C C I A T I  S T A N D A R D  - 63 
 
Trascodifica da utilizzare  se le causali sono XSTIN e XSTIP  
  
 
Trascodifica da utilizzare se le causali sono diverse da quelle standard


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
64 - T R A C C I A T I  S T A N D A R D  Nel caso in cui venga gestita l'analitica è necessario fare ulteriori considerazioni:  
 Il centro di costo deve essere precaricato in ad hoc Revolution (il codice deve corrispondere a 
quello indicato nel file da importare alla posizione 10 - 21; 
 La voce di costo non è presente nel file di origine ma rappresenta un dato obbligatorio in ad 
hoc Revolution. Per questo motivo nei tracciati rilasciati (APRI_PAGHE) nella scheda dettaglio 
alla sequenza 45, è stato inserita, nel campo espressione, la voce di costo STIPENDI. Tale voce 
di costo dovrà essere caricata negli archivi del gestionale prima  di eseguire l'importazione.  
  
 
Tracciati Paghe – scheda dettaglio  
  
Se l'utente ha la necessità di utilizzare un'altra voce di costo rispetto a quella indicata nei tracciati 
standard sarà sufficiente modificare nel campo espressione il codice della voce di costo STIPENDI 
indicandone una diversa, anche in questo caso la voce dovrà essere precaricata negli archivi di ad hoc 
Revolution.  
  
Import movimenti  
Per effettuare l' importazione dei movimenti contabili è necessario entrare in Ad Hoc Revolution con 
data di sistema con la quale si desidera eseguire l'importazione; tale data viene utilizzata come data di 
registrazione per i movimenti contabili importati.  
  
Da Apri dovranno essere esportati i movimenti delle aziende UNA PER VOLTA.  
  
Dalla maschera Import A rchivi e Movimenti Contabili occorre selezionare il tracciato APRI_PAGHE 
ed il percorso nel quale è stato salvato il file da importare.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I M P O R T  D A T I  
T R A C C I A T I  S T A N D A R D  - 65 
 
Maschera di importazione dati da Apri Paghe


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


key: chroma:document
string_value:
Piattaforma Applicativa Gestionale  
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 Intra  
 
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 qualsiasi 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 
pubblicazio ne. 
 
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  – I N T R A  
I N D I C I  - III Indice  
 
 OPERAZIONI PRELIMINAR I ................................ ................................ ...................  5 
 Parametri Dati azienda  ................................ ................................ .............................  6 
 Anagrafica clienti/fornitori  ................................ ................................ .....................  9 
 Anagrafica articoli  ................................ ................................ ................................ ... 10 
 Anagrafica servizi  ................................ ................................ ................................ .... 12 
 Nomenclature  ................................ ................................ ................................ ..........  15 
 Tipi transazioni  ................................ ................................ ................................ ........ 16 
 Causali magazzino  ................................ ................................ ................................ ... 17 
 Documenti  ................................ ................................ ................................ ................  18 
Dati testata documento  ................................ ................................ ................................ ..............  19 
Documenti dati di riga  ................................ ................................ ................................ ................  20 
 GESTIONE ELENCHI  ................................ ................................ ............................  25 
 Generazione elenchi intra  ................................ ................................ ......................  26 
 Manutenzione elenchi intra  ................................ ................................ ...................  29 
 Modifica spese trasporto intra  ................................ ................................ ..............  43


key: chroma:document
string_value:
 Generazione disco i ntra ................................ ................................ .........................  45 
 STAMPE INTRASTAT  ................................ ................................ .............................  53 
 Stampa brogliaccio intra  ................................ ................................ ........................  54 
 Stampa movimenti Intra  ................................ ................................ ........................  56 
 Stampa nomenclature  ................................ ................................ .............................  58 
 Stampa tipi transazioni  ................................ ................................ ...........................  59 
 ESEMPI INTRA  ................................ ................................ ................................ ...... 61 
 Rettifiche cessioni/acquisti servizi  ................................ ................................ ....... 62 
 Registrazione  rettifica di servizi da documenti (nota di credito)  ....................  72 
 Riparazione a titolo oneroso con sostituzione di un elemento  ......................  74 
 Registrazione di fattura passiva intra ue e generazione elenchi beni  .............  78 
 Registrazione nota di credito ue a storno di precedente fattura beni  ...........  88 
 Registrazione nota di credito ue a rettifica di precedente fattura beni  ..........  92 
 
 
Le immagini della documentazione differiscono secondo il sistema operativo utilizza to 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  – I N T R A  
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  – I N T R A  
I N T R A  - 1 Intra  
  
In questo capitolo vengono trattate le funzionalità che permettono di mantenere i progressivi dei dati 
da riporta re sugli elenchi riepilogativi degli acquisti e delle cessioni intracomunitari di beni.  
  
Gli elenchi Intra vengono generati in base a documenti del ciclo attivo e passivo già contabilizzati in 
Primanota. Affinché tali documenti vengano riconosciuti dalla gestione Intra si rende necessario 
parametrizzare in modo opportuno alcune parti della procedura, come esposto nella sezione 
Operazioni Preliminari di questo manuale.  
Vediamo di seguito una rappresentazione grafica del flusso logico della gestione Elenchi Intra.  
  
 
Flusso Logico della gestione Elenchi Intra  
  
La figura seguente mostra il Menu degli archivi intracomunitari, ogni voce verrà trattata 
dettagliatamente nel rispettivo paragrafo.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I N T R A  
2 – I N T R A  
 
Menù archivi intracomunitari  
  
Nella Gestione Intra è stata dat a la possibilità di adeguare il gestionale alle norme di recepimento della 
Direttiva Comunitaria 2006/112/CE che:  
 Estendono l’obbligo della presentazione degli elenchi INTRA anche alle prestazioni di 
servizio effettuate in ambito comunitario  
 Rendono ob bligatoria la presentazione per via esclusivamente telematica delle dichiarazioni 
INTRA beni e/o servizi riferite a periodi decorrenti dal 2010;  
 Eliminano la cadenza di presentazione annuale;  
 Prevedono nuove soglie per determinare la periodicità di pre sentazione mensile/trimestrale;  
 Introducono nuove modalità per il cambio di periodicità.  
  
 OPERAZIONI PRELIMINAR I 
 GESTIONE ELENCHI  
 STAMPE INTRASTAT


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


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


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I N T R A  
O P E R A Z I O N I  P R E L I M I N A RI - 5  OPERAZIONI PRELIMINAR I 
  
Per il corretto funziona mento del modulo Operazioni Intra UE è necessario configurare 
opportunamente alcune parti della procedura.  
  
 Parametri Dati azienda  
 Anagrafica clienti/ fornitori  
 Anagrafica articoli  
 Anagrafica servizi  
 Nomenclature  
 Tipi transazioni  
 Causali magazzino  
 Documenti


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I N T R A  
6 – O P E R A Z I O N I  P R E L I M I N A RI  Parametri Dati azienda  
  
All'interno dei Dati Azienda, scheda Dati Intra, andrà definita la periodicità degli elenchi, la quale può 
essere differente per cessioni ed acquisti e l'obbligatorietà o meno di certi campi.  
  
 
Dati Azienda con in dettaglio le informazioni Intra  
  
 Data inizio generazione elenchi INTRA  
Questa data rappresenta la data di partenza dalla quale la procedura considererà i documenti per la 
generazione delle manutenzioni elenchi intra. L’inserimento di questa data consente all’operatore di 
stabilire da qu ale data iniziare a generare gli intra all’interno della procedura, evitando alla stessa di 
esaminare tutti i documenti che generano intra.  
 Data inizio generazione elenchi INTRA per i servizi  
Questa data rappresenta la data di partenza dalla quale la pro cedura considererà i documenti per la 
generazione delle manutenzioni elenchi intra relative ai  SOLI servizi (01/01/2010).  
Occorre prestare particolare attenzione alla valorizzazione delle date in oggetto perché un’errata 
parametrizzazione delle stesse pot rà portare alla mancata generazione di movimenti intra.


key: chroma:document
string_value:
A D  H O C  R E V O L U T I O N  – I N T R A  
O P E R A Z I O N I  P R E L I M I N A RI - 7 Esempio  
Supponiamo di caricare una fattura il 24/03/2010 usando un articolo e un servizio.  
Supponiamo di definire come data d’inizio generazione elenchi intra 01/03/2010, mentre come data 
d’inizio g enerazione elenchi intra per i servizi 25/03/2010.  
 N. progressivo elenco  
Il campo indica il numero progressivo degli elenchi presentati. Viene aggiornato automaticamente 
dalla procedura se in fase di generazione disco Intra su File viene confermato l’agg iornamento del 
progressivo.  
La procedura propone sulla maschera generazione disco Intra su File, come numero progressivo del 
disco, il numero indicato in dati azienda; tale numero verrà riportato anche nella stampa del 
frontespizio.  
Se l’utente conferma l’ aggiornamento nei dati azienda verrà riportato il numero progressivo 
successivo. Non confermando l’aggiornamento invece nei dati azienda verrà mantenuto lo stesso 
numero.  
 Periodicità INTRA 1 e 2  
La periodicità degli elenchi può essere differente per le cessioni (Intra 1) e per gli acquisti (Intra 2), in 
quando diverso può essere l’ammontare delle operazioni effettuate dall’azienda. La periodicità può 
essere mensile trimes trale  
 Mensile  
 Trimestrale  
 Ultima generazione INTRA  
Indica il periodo dell’ultima generazione degli elenchi e, alla conferma della Generazione Elenchi Intra 
su File, viene automaticamente incrementato di 1. La procedura provvede ad azzerare il numera tore 
su base annua, quindi nel caso di periodicità:  
Mensile, il campo assume i valori da 0 a 11, in quanto alla generazione del dodicesimo periodo il 
numeratore verrà azzerato e il campo riporterà valore 0.  
Trimestrale, il campo assume i valori da 0 a 3, i n quanto alla generazione del quarto periodo il 
numeratore verrà azzerato e il campo riporterà valore 0.  
 Obbligatorietà


