Fincati Gestionale 1: nuove funzioni per i campi calcolati relative alla tracciabilità documentale Indice degli argomenti Introduzione Descrizione delle nuove funzioni Elenco delle nuove funzioni Modalità di costruzione delle funzioni Assistenza tecnica Gestionale 1 0371 / 594.3500 locon4@zucchetti.it Fax: 0371 / 594.2026
Introduzione A partire dalla versione 4.6.1, all'interno dei campi calcolati utilizzati nei Fincati, sono state inserite delle nuove funzioni che, avvalendosi della tracciabilità documentale sul ciclo attivo e passivo, consentono di stampare sul documento corrente qualsiasi informazione ad esso riferita, reperendola da tabelle o documenti che rientrano nel flusso documentale del documento in stampa. Per flusso documentale del documento in stampa si intendono tutti quei documenti che risultano collegati al documento da stampare (direttamente o indirettamente); ad esempio i documenti appartenenti al flusso documentale di una fattura di vendita sono: i DDT e gli ordini da cui la fattura è stata generata (anche indirettamente per quanto riguarda gli ordini); gli effetti, i movimenti contabili, i movimenti di magazzino ed altri elementi che sono stati a loro volta generati dalla fattura. Grazie a queste nuove funzioni sarà, quindi, possibile, ad esempio: stampare su una fattura generata da DDT i riferimenti agli ordini clienti che hanno dato origine al flusso; stampare su una fattura generata da più DDT aventi indirizzi di spedizione diversi, l'indirizzo di spedizione di ogni DDT; stampare su una fattura di acquisto i riferimenti ai DDT di carico collegati alla fattura stessa. Descrizione delle funzioni Le funzioni che si avvalgono della tracciabilità documentale, inserite con la versione 4.6.1 nella gestione dei campi Calcolati dei Fincati, sono state raggruppate in due nuove categorie: Tracciabilità (generanti) ; Tracciabilità (generati). - 2 -
Tracciabilità (generanti) La categoria Tracciabilità (generanti) contiene le funzioni che consentono di stampare le informazioni relative ai documenti che hanno generato il documento corrente (ad esempio, in stampa di una fattura, è possibile reperire le informazioni relative ai DDT e agli ordini che l'hanno generata). Tracciabilità (generati) La categoria Tracciabilità (generati) contiene le funzioni che consentono di stampare le informazioni relative ai documenti/elementi che sono stati generati dal documento corrente (es: in stampa di una fattura, è possibile reperire le informazioni relative agli effetti o ai movimenti contabili e di magazzino che sono stati generati dalla fattura stessa). Entrambe le categorie contengono sia funzioni di tipo generico, che funzioni di tipo specifico: le funzioni di tipo generico richiedono che sia l'utente a specificare, in fase di costruzione del campo calcolato, quali informazioni desidera stampare (es: numero ordine) e l'entità da cui reperire tale informazione (es: dai DDT, piuttosto che dagli ordini); le funzioni di tipo specifico sono invece funzioni già predefinite da Zucchetti messe a disposizione degli utenti, che contengono già l'entità da cui reperire le informazioni, per cui l'utente si limita a definire solo quali informazioni dell'entità desidera stampare. In entrambi i casi la definizione del campo calcolato risulta molto semplice e immediata. - 3 -
Elenco delle nuove funzioni Nella categoria Tracciabilità (generanti) sono presenti le seguenti funzioni: funzioni generiche: o TRACCIA_SORG; funzioni specifiche: o ORDINE_SORG; o BOLLA_SORG. Queste funzioni consentono di stampare sul documento corrente le informazioni relative ai documenti che lo hanno generato. Nella categoria Tracciabilità (generati) sono presenti le seguenti funzioni: funzioni generiche: o TRACCIA_DEST; funzioni specifiche: o BOLLA_DEST; o FATTURA_DEST; o MOVMAG_DEST; o MOVCON_DEST; o EFFETTO_DEST. Queste funzioni consentono di stampare sul documento corrente le informazioni relative ai documenti, movimenti di magazzino, movimenti contabili, effetti ed altri elementi che sono stati successivamente generati dal documento che si desidera stampare. Modalità di costruzione delle funzioni Caratteristiche generali Di seguito sono elencate alcune caratteristiche generali riguardanti i campi calcolati che si avvalgono della tracciabilità documentale. - 4 -
Il campo calcolato deve essere necessariamente definito di Tipo Carattere, indipendentemente dal tipo dei campi che si vogliono recuperare. Il campo calcolato, una volta posizionato nel fincato, deve essere adeguatamente dimensionato affinché possa contenere ed esporre su più righe tutte le informazioni reperite tramite la funzione di tracciabilità. Costruzione funzioni generiche (TRACCIA_SORG, TRACCIA_DEST) Le funzioni generiche TRACCIA_SORG (della categoria generanti ) e TRACCIA_DEST (della categoria generati ) sono così costituite: TRACCIA_SORG(<stringa1>,<stringa2>,<stringa3>); TRACCIA_DEST(<stringa1>,<stringa2>,<stringa3>). L'utente, nel definire l'espressione di calcolo del campo calcolato, deve compilare le stringhe come descritto di seguito: <stringa1>: definire l'entità Target, cioè l'entità da cui reperire l'informazione che si desidera stampare (es. AORDINE, ABOLLA, MMOVMAG ). Il nome dell'entità Target può essere reperito nell'appendice Lista entità e relazioni presente alla fine di questo documento; <stringa2>: definire l'espressione da restituire e quindi da stampare; l'espressione in formato stringa deve contenere tra parentesi quadre i campi relativi alle informazioni che si desidera stampare; è inoltre possibile inserire nell espressione eventuali stringhe descrittive; <stringa3>: indicare un Valore di default nel caso in cui i campi richiamati non contengano alcun valore, oppure nel caso in cui la traccia richiamata non venisse trovata. Esempio 1 Si desidera stampare sulla fattura di vendita generata da D.d.T. i riferimenti (numero e data) dell'ordine originale. Sintassi del comando: TRACCIA_SORG("AORDINE","Ordine nr. [NUMORD] del [DATORD]","Non trovato ) In base alla sintassi sopra scritta, nell'archivio ORDCL01.DBF verranno ricercati i campi [NUMORD] e [DATORD]. - 5 -
Sul fincato nella posizione in cui è stato inserito il campo calcolato, verrà stampato: Ordine nr. 100 del 27/12/2010. Nel caso in cui la traccia non venisse trovata, il valore restituito sarà il testo fisso Non trovato. Esempio 2 Si desidera stampare su una fattura di acquisto, per ogni riga articolo, i riferimenti al DDT di carico collegati alla fattura stessa. Sintassi del comando: TRACCIA_SORG("PRIGABOLLA","DDT. NR. [TIPDOC]/[NUMDOC] ","NN. ) Nell'archivio QTBFAT01.DBF verranno ricercati i campi [TIPDOC] e [NUMDOC] e per ogni riga articolo, in base alla posizione del campo calcolato nel fincato, verrà stampato il riferimento al D.d.T. di provenienza. Nel caso in cui la traccia non venisse trovata, il valore restituito sarà il testo fisso NN.. - 6 -
Costruzione funzioni specifiche Le funzioni specifiche della categoria generanti e della categoria generati sono così costituite: categoria generanti : o ORDINE_SORG(<stringa1>,<stringa2>); o BOLLA_SORG(<stringa1>,<stringa2>); categoria generati : o BOLLA_DEST(<stringa1>,<stringa2>); o FATTURA_DEST(<stringa1>,<stringa2>); o MOVMAG_DEST(<stringa1>,<stringa2>); o MOVCON_DEST(<stringa1>,<stringa2>); o EFFETTO_DEST(<stringa1>,<stringa2>). Queste funzioni preimpostano automaticamente l'entità Target da cui reperire le informazioni, pertanto l'utente, nel definire l'espressione di calcolo, deve solamente compilare le stringhe come descritto di seguito: <stringa1>: definire l'espressione da restituire e quindi da stampare; l'espressione in formato stringa deve contenere tra parentesi quadre i campi relativi alle informazioni che si desidera stampare; è inoltre possibile inserire nell espressione eventuali stringhe descrittive; <stringa2>: indicare un Valore di default nel caso in cui i campi richiamati non contengano alcun valore, oppure nel caso in cui la traccia richiamata non venisse trovata. Esempio 1 Si desidera stampare sulla fattura di vendita generata da D.d.T., i riferimenti dell'ordine originale. Sintassi del comando: ORDINE_SORG("ORD.NR. [TIPORD]/[NUMORD] del [DATORD]","Non disponibile") In base alla sintassi sopra scritta, nell'archivio ORDCL01.DBF verranno ricercati i campi [TIPORD], [NUMORD] e [DATORD]. Sul fincato, nella posizione in cui è stato inserito il campo calcolato, verrà stampato: ORD.NR. C1/100 del 27/12/2010. - 7 -
Nel caso in cui la traccia non fosse trovata, il valore restituito sarà il testo fisso Non disponibile. Esempio 2 Si desidera stampare sulla conferma d'ordine, i riferimenti ai D.d.T. generati dall'evasione dell'ordine stesso. Sintassi del comando: BOLLA_DEST("DdT. nr. [NUMDOC] del [DATDOC]","N.D.") Nell'archivio TABFAT01.DBF verranno ricercati i campi [NUMDOC] e [DATDOC]. Sul fincato, nella posizione in cui è stato inserito il campo calcolato, verrà stampato: DdT. nr. 185 del 27/12/2010 DdT. nr. 190 del 29/12/2010 Nel caso in cui la traccia non venisse trovata, il valore restituito sarà il testo fisso N.D.. - 8 -
Esempio 3 Si ha come cliente una catena di negozi e nell arco del mese sono state fatte più spedizioni ai diversi punti vendita; a fine mese si desidera emettere un unica fattura per tutti i D.d.T. spediti, stampando sulla fattura riepilogativa i diversi indirizzi di spedizione cui facevano riferimento i D.d.T.. Sintassi del comando: BOLLA_SORG("D.d.T. nr. [NUMDOC] indirizzo di spedizione [INDIR] [CAP] [LOCAL] [PROV]","n.d.") Nell'archivio TABFAT01.DBF verranno ricercati i campi [NUMDOC], [INDIR], [CAP], [LOCAL] e [PROV]. Sul fincato, nella posizione in cui è stato inserito il campo calcolato, verrà stampato: D.d.T. nr. 369 indirizzo di spedizione via Degli Aceri 26010 Crema CR D.d.T. nr. 378 indirizzo di spedizione c.so Mazzini 26900 Lodi LO Nel caso in cui la traccia non venisse trovata, il valore restituito sarà il testo fisso n.d.. Funzione riservata a personale con competenze tecniche avanzate Per dare la possibilità di costruire espressioni completamente personalizzate sfruttando la tracciabilità documentale, è stata introdotta un ulteriore funzione di nome TRACCIA nella categoria Varie. La funzione è così costituita: TRACCIA(<stringa1>,<stringa2>,<logico1>,<stringa3>,<stringa4>,<stringa5>). Per avere supporto sull utilizzo di questa funzione contattare il servizio di Assistenza tecnica. Copyright Zucchetti S.p.A. Tutti i diritti sono riservati, è vietata la distribuzione senza il consenso della Zucchetti S.p.A. Il presente documento ha una funzione esclusivamente di supporto tecnico; è vietata la riproduzione per scopi commerciali. - 9 -
Appendice: Lista entità e relazioni Lista entità Ciclo Attivo 'AORDINE' 'ARIGAORDIN' 'ABOLLA' 'ARIGABOLLA' 'AFATTURA' 'ARIGAFATTU' 'AEFFETTI' 'ALSPRE' 'ARIGLSPRE' : Testata ordine clienti; : Riga ordine clienti; : Testata d.d.t. vendita; : Riga d.d.t. vendita; : Testata fattura vendita; : Riga fattura vendita; : Effetto; : Testata lista prelievo; : Riga lista prelievo; Ciclo Passivo 'PORDINE' 'PRIGAORDIN' 'PBOLLA' 'PRIGABOLLA' 'PFATTURA' 'PRIGAFATTU' : Testata ordine fornitori; : Riga ordine fornitori; : Testata d.d.t. acquisto; : Riga d.d.t. acquisto; : Testata fattura acquisto; : Riga fattura acquisto. Magazzino e Lotti 'MMOVMAG' : Testata movimento magazzino; 'MRIGMOVMAG' : Riga movimento magazzino; 'MLOTTO' 'MTRASLOT' 'MRIGTSFLOT' : Anagrafica lotto; : Testata trasformazione lotti; : Riga trasformazione lotti; - 10 -
'MMOVLOT' 'MRIGAMLOT' : Testata movimento lotti; : Riga movimento lotti. Contabilità 'GMOVCON' : Testata movimento contabile; 'GRIGMOVCON' : Riga movimento contabile; 'GSALREG' 'GGENRARI' : Movimento di registrazione saldaconto; : Movimento di generazione ratei e risconti. Ordini di produzione 'DORDPRO' : Ordine di produzione. Relazioni Ciclo attivo AORDINE ABOLLA AFATTURA ARIGAORDIN ARIGABOLLA ARIGAFATTU MMOVMAG ABOLLA MMOVMAG ABOLLA AFATTURA MLOTTO ARIGABOLLA ARIGAFATTU MMOVMAG MRIGMOVMAG - 11 -
AFATTURA MMOVMAG AFATTURA GMOVCON AEFFETTI MLOTTO ARIGAFATTU MRIGMOVMAG MMOVMAG AEFFETTI GMOVCON ALSPRE AORDINE MMOVMAG ARIGLSPRE ARIGAORDIN MRIGMOVMAG Ciclo passivo PORDINE PBOLLA PFATTURA PRIGAORDIN PRIGABOLLA PRIGAFATTU PBOLLA MMOVMAG PFATTURA MLOTTO PRIGABOLLA PRIGAFATTU MRIGMOVMAG PFATTURA MMOVMAG GMOVCON MLOTTO PRIGAFATTU MRIGMOVMAG - 12 -
Magazzino e Lotti MMOVMAG MLOTTO MMOVLOT MRIGMOVMAG MRIGAMLOT MLOTTO DORDPRO MMOVMAG ABOLLA AFATTURA MTRASLOT PBOLLA PFATTURA MTRASLOT MMOVLOT MLOTTO MRIGTSFLOT MRIGAMLOT Contabilità GMOVCON GMOVCON GRIGMOVCON GRIGMOVCON GSALREG GMOVCON GGENRARI GMOVCON Ordini di produzione DORDPRO MMOVMAG MLOTTO Copyright Zucchetti S.p.A. Tutti i diritti sono riservati, è vietata la distribuzione senza il consenso della Zucchetti S.p.A. Il presente documento ha una funzione esclusivamente di supporto tecnico; è vietata la riproduzione per scopi commerciali. - 13 -