Modelli di stampa e modelli di import/export¶
Panoramica¶
Il sistema gestisce due famiglie di modelli configurabili:
- Modelli di stampa: template Word/Jasper/Stimulsoft utilizzati dai programmi di stampa per generare documenti (preventivi, ordini, chiamate, ecc.).
- Modelli di import/export: tracciati configurabili per importare/esportare dati su fogli Excel, con mapping colonne-informazioni definibile dall'utente.
| Programma | Funzione |
|---|---|
| COGPA2 | Gestione modelli di stampa (microanalisi) |
| COGPA3 | Selezione modello di stampa (richiamato dai programmi di stampa) |
| COGPA7 | Gestione versioni modelli import/export |
| COGPA8 | Composizione versione modello import/export (mapping colonne) |
| GESMDSTS | Gestione tabella modelli di stampa (sviluppo) |
| GESMDSDT | Gestione tabella dettagli modelli di stampa (sviluppo) |
| GESMDSDC | Gestione tabella campi dettaglio modelli di stampa (sviluppo) |
| GESMDIET | Gestione/consultazione modelli import/export (anagrafica modelli) |
Modelli di stampa¶
Struttura dati¶
La definizione dei modelli si appoggia su tre tabelle:
| Tabella | Contenuto |
|---|---|
| COGMDSTS | Elenco modelli (uno per programma di stampa) |
| COGMDSDT | Tabelle di dettaglio configurabili per ciascun modello |
| COGMDSDC | Campi disponibili per ciascuna tabella di dettaglio |
In ambiente di sviluppo le tabelle risiedono in P:\MENUGEN\MENU2000; in produzione sono sotto ARC-DIR.
Motori di esecuzione¶
| Motore | Descrizione |
|---|---|
| Word | Modello costruito su documento Word, eseguito localmente sul PC utente |
| Jasper | Modelli progettati su portale AREAGATE, selezionabili dall'utente |
| Stimulsoft | Report generato sul server gestionale, reso disponibile immediatamente |
| NiceLabel | Processore di stampa proprietario per etichette |
COGPA2 -- Gestione modelli di stampa¶
Programma non a menu. Per ciascuna classe di report (preventivo, chiamate, ordini cliente, ordini fornitore, ecc.) l'utente gestisce uno o piu' modelli in griglia.
Attributi di ciascun modello:
| Campo | Descrizione |
|---|---|
| Id | Identificativo modello |
| Pertinenza | G=Generale, A=Anagrafica specifica, L=Lingua specifica |
| Tipo anagrafico / Anagrafica | Valorizzati se pertinenza = A |
| Lingua | Valorizzata se pertinenza = L |
| Descrizione | Descrizione interna del modello |
| Tipo percorso | L=Locale (percorso completo), R=Remoto (solo nome file, cercato su server) |
| Percorso | Ubicazione e nome del file modello |
| Brand | Brand di riferimento (se attiva gestione brand) |
| Azienda | Azienda di riferimento (se attiva gestione multi-azienda) |
| Motore | Word / Jasper / Stimulsoft / NiceLabel |
| Id Jasper | Identificativo modello Jasper (F8 per ricerca) |
Tasti funzione:
- F5 sulla colonna Percorso: apre la ricerca file di Windows.
- F6: apre la configurazione delle tabelle di dettaglio (solo motore Word; per Jasper la configurazione e' importata dal modello stesso).
Configurazione tabelle di dettaglio¶
Programma non a menu, richiamato da COGPA2 con F6. Mostra le tabelle di dettaglio configurabili per il modello. Per ciascuna tabella si puo' definire la composizione della riga di dettaglio selezionando i campi con F8 (funzione Selezione campo). Le tabelle disponibili sono definite a livello di sviluppo in GESMDSDT; l'utente non puo' aggiungerne di nuove.
COGPA3 -- Selezione modello da programma di stampa¶
Chiamato dai programmi di stampa per ottenere il modello appropriato.
Parametri in ingresso:
| Parametro | Contenuto |
|---|---|
| COGPA3-TIP | Codice modello (es. "COGV92") |
| COGPA3-ANA | Riferimento anagrafico interessato alla stampa |
| COGPA3-LNG / COGPA3-STATO-ESTERO | Codice lingua o stato estero (facoltativi) |
Parametri in uscita:
| Parametro | Contenuto |
|---|---|
| COGPA3-MODELLO | Nome del modello selezionato |
| COGPA3-DES-MODELLO | Descrizione del modello selezionato |
| COGPA3-TABELLE | Elenco righe di dettaglio configurabili trovate sul modello |
Definizione nuovi modelli (sviluppo)¶
- In GESMDSTS aggiungere una riga con codice = nome programma di stampa (primi 6 caratteri).
- Se il programma contiene righe di dettaglio configurabili, in GESMDSDT aggiungere una riga per ciascuna tabella di dettaglio.
- Per ciascuna tabella, in GESMDSDC definire i campi disponibili.
Il codice modello deve corrispondere ai primi 6 caratteri del nome programma: in fase di rilascio i modelli vengono estratti automaticamente in base a questa corrispondenza.
Rilascio modelli¶
In fase di rilascio i modelli sono estratti in tre file sequenziali nella sottocartella PRG:
| File | Contenuto |
|---|---|
| EXPMDSTS | Modelli di stampa |
| EXPMDSDT | Dettagli su modelli di stampa |
| EXPMDSDC | Campi su tabella dettaglio |
L'importazione avviene durante la procedura SCRREL (importazione griglie modificate).
Modelli di import/export¶
Logica generale¶
Alcune funzioni operative permettono di importare o esportare dati su fogli Excel con tracciato configurabile. Per ciascun modello (processo di import o export) si possono definire piu' versioni (profili), ciascuna associabile a un'anagrafica specifica (es. un fornitore che fornisce un tracciato predefinito).
COGPA7 -- Gestione versioni¶
Programma non a menu. Per ciascun modello selezionato, mostra le versioni in griglia.
Attributi di ciascuna versione:
| Campo | Descrizione |
|---|---|
| Id | Identificativo modello/versione |
| Descrizione | Descrizione della versione |
| Note | Descrizione dettagliata |
| Tipo anagrafico / Codice / Descrizione anagrafica | Associazione ad anagrafica specifica (preselezione automatica) |
| Tipo percorso | L=Locale, R=Remoto |
| Percorso | Percorso e nome file di default |
| Tipo di output | Formato di export (XLS, TXT, ecc.) |
| Delimitatore | Delimitatore per formato TXT (default: tabulazione) |
| Intestazione? | Presenza della riga di intestazione nel file |
Tasto F5: apre COGPA8 per definire il mapping delle colonne.
COGPA8 -- Composizione versione¶
Programma non a menu. Definisce il formato del file da importare/esportare: per ciascuna colonna Excel (A, B, ... Z, AA, AB, ...) si associa un'informazione tra quelle previste dal modello.
Attributi di ciascuna colonna:
| Campo | Descrizione |
|---|---|
| Nome colonna | Lettera colonna Excel (sola lettura) |
| Prog. informazione | Codice informazione associata (F8 per selezione) |
| Descrizione informazione | Descrizione dell'informazione |
| Classe dato | Tipologia dato (alfanumerico, numerico, data, ecc.) |
| Validazione | L=Libera, W=Facoltativa, O=Obbligatoria (solo import) |
| Operazione | Trattamento del dato in import/export (default: Nessuna) |
| Attributo | Parametro dell'operazione scelta |
| Valore default | Valore di default per colonne vuote (solo export) |
Operazioni sui dati¶
E' possibile applicare un trattamento ai dati durante import/export. Esempio:
| Codice | Nome | Attributo | Effetto |
|---|---|---|---|
| A | Separa-dx | Caratteri separatori | Mantiene la parte a sinistra del separatore (es. "ABCDE-FG" diventa "ABCDE" con separatore "-") |
Riconoscimento informazioni¶
Programma a menu (Sistema > Configurazioni > Riconoscimento informazioni). Per ciascuna classe di documento si definiscono le regole di riconoscimento delle informazioni all'interno di un testo.
| Campo | Descrizione |
|---|---|
| Descrizione | Nome dell'informazione (sola lettura) |
| Prefisso | Prefisso che precede l'informazione nel testo |
| Suffisso | Suffisso che segue l'informazione (delimitabile con " per includere spazi) |
| Lunghezza | Lunghezza dell'informazione |
Almeno uno tra prefisso e suffisso e' obbligatorio.
Catalogo modelli di importazione¶
I-BDP -- Importazione buoni di prelievo¶
Importa il dettaglio di un buono di prelievo per aziende che gestiscono serial number.
| Id | Nome | Descrizione | Obbligatorio |
|---|---|---|---|
| 1 | MERCE-MA | Codice merce avanzato | No (ricavato dal s/n) |
| 2 | MERCE-MI | Codice merce interno (GGSSCCCCC) | No |
| 3 | SN-SN | Serial number da evadere | Si (alternativo a 4) |
| 4 | SN-KEY-ALT | Chiave alternativa s/n da evadere | Si (alternativo a 3) |
Utilizzato in: creazione buoni di prelievo.
I-BSDET -- Importazione dettaglio benestare¶
Importa il dettaglio di un benestare ricevuto dal cliente in formato Excel.
| Id | Nome | Descrizione | Obbligatorio |
|---|---|---|---|
| 1 | MERCE-MA | Codice merce avanzato | Si (alternativo a 2/3) |
| 2 | MERCE-MI | Codice merce interno (GGSSCCCCC) | Si (alternativo a 1/3) |
| 3 | MERCE-CMC | Codice merce attribuito dal cliente | Si (alternativo a 1/2) |
| 4 | QTA | Quantita' movimento | Si |
| 5 | PREZZO | Prezzo unitario netto | Si |
| 6 | IMPORTO | Importo movimento | Si |
| 7 | DESCRIZIONE | Descrizione riga di dettaglio | No |
Utilizzato in: COGV8A (inserimento/gestione benestare).
I-BSMOV-QUADRATURA -- Importazione movimenti benestare per quadratura¶
Importa i movimenti dal cliente per quadratura con i movimenti presenti nel sistema. L'abbinamento avviene a parita' di codice prestazione e identificativo lavoro/numero linea.
| Id | Nome | Descrizione | Obbligatorio |
|---|---|---|---|
| 1 | MERCE-MA | Codice merce avanzato / Codice merce cliente | Si (alternativo a 2) |
| 2 | MERCE-MI | Codice merce interno (GGSSCCCCC) | Si (alternativo a 1) |
| 3 | CHIAMATA-CLI | Codice chiamata del cliente / numero linea | Si |
| 4 | QTA | Quantita' del movimento | No |
| 5 | PREZZO | Prezzo unitario netto | No |
| 6 | IMPORTO | Importo movimento | No |
Utilizzato in: COGV8C (consultazione movimenti benestare).
I-BSMOV-MANUALI -- Importazione movimenti benestare manuali¶
Importa movimenti manuali da aggiungere a benestare, prevalentemente per rifatturazione tra aziende.
| Id | Nome | Descrizione | Obbligatorio |
|---|---|---|---|
| 1 | ID-MOV | Id movimento (solo per modifica esistente) | No |
| 2 | DATA | Data movimento | Si |
| 3 | CLI-FAT-COD | Codice cliente di fatturazione | Si |
| 4 | AZ-COD | Codice azienda esecutrice | Si (se config. gruppo aziende) |
| 5 | BRAND-COD | Codice brand associato | No |
| 6 | MERCE-MA | Codice merce avanzato | Si (alternativo a 7) |
| 7 | MERCE-MI | Codice merce interno (GGSSCCCCC) | Si (alternativo a 6) |
| 8 | QTA | Quantita' movimento | Si |
| 9 | PREZZO | Prezzo unitario netto | Si |
| 10 | IMPORTO | Importo movimento | Si |
| 11 | FL-CONTINUATIVO | Movimento continuativo (S/N) | No |
| 12 | PERIODICITA | Periodicita' (obbligatorio se continuativo) | Condizionale |
| 13 | TECNICO-COD | Codice tecnico | No (alternativo a 14) |
| 14 | TECNICO-DES | Descrizione tecnico (deve corrispondere esattamente) | No (alternativo a 13) |
Utilizzato in: COGV8D (gestione movimento benestare).
I-CHIAMATE -- Importazione chiamate di assistenza¶
Importa un elenco di chiamate da un committente o cliente di fatturazione. Tracciato ampio che include il destinatario dell'assistenza (codificabile automaticamente come cliente potenziale o destinazione diversa). Non vengono importate prestazioni o materiali.
| Id | Nome | Descrizione | Obbligatorio |
|---|---|---|---|
| 1 | AZ-COD | Codice azienda esecutrice | Si (se config. gruppo aziende) |
| 2 | AZ-DES | Descrizione azienda (ricerca per testo univoco) | Alternativo a 1 |
| 3 | CLI-FAT-COD | Codice cliente di fatturazione | Si (se non indicato a video) |
| 4 | CLI-FAT-DES | Descrizione cliente fatturazione (ricerca per inizio ragione sociale) | Alternativo a 3 |
| 5 | CHIAMATA-CLI | Codice chiamata del cliente | Si |
| 6 | TPAT-COD | Codice tipo attivita' | No |
| 7 | TPAT-DES | Descrizione tipo attivita' (ricerca univoca) | Alternativo a 6 |
| 8 | CLI-ASS-COD | Codice cliente assistito | Si |
| 9-11 | CLI-ASS-RAGSOC / NOME / COGNOME | Ragione sociale e nome/cognome cliente assistito | No |
| 12 | CLI-ASS-IND | Indirizzo (piu' colonne concatenabili) | No |
| 13 | CLI-ASS-LOCA | Localita' | No |
| 14-18 | CHI-DATA / CHI-ORA / APP-DATA / APP-ORA / SCAD-DATA / SCAD-ORA | Date e orari (inserimento, appuntamento, scadenza) | No |
| 19-23 | MTR-ID / MTR-SN | Matricola di assistenza (id o serial number) | No |
| 26 | OGGETTO | Oggetto chiamata | No |
| 27 | DESCR | Descrizione (piu' colonne concatenabili, max 2000 car.) | No |
| 28 | DST-ID | Id destinazione diversa | No |
| 29 | AREA-COD | Codice area tecnica | No |
| 30 | GARANZIA | "S"/"SI" = in garanzia (non fatturare) | No |
| 31 | BRAND-COD | Codice brand/committente | No |
| 32 | ACCOUNT | Codice account/punto vendita del committente | No |
| 33 | GG-GARANZIA | Giorni di garanzia | No |
| 34 | ID-GARANZIA | Codice chiamata originale di riferimento | No |
| 35-44 | CLI-ASS-PROV / CAP / TEL / EMAIL / ZON / AGE | Dati anagrafici aggiuntivi cliente assistito | No |
| 45-47 | STC-COD / STC-DES / PRI-DES | Stato chiamata, priorita' | No |
Utilizzato in: acquisizione chiamate.
I-MOD-CHIAMATE -- Modifica dati chiamata¶
Importa modifiche ai dati di testata di chiamate gia' esistenti.
| Id | Nome | Descrizione | Obbligatorio |
|---|---|---|---|
| 1 | ID-CHIAMATA | Id chiamata da modificare | Si |
| 2 | AZ-ESE-CCOD | Codice azienda esecutrice | No |
| 3 | CLI-FAT-COD | Codice cliente di fatturazione | No |
| 4 | ID-ORIGINALE | Id chiamata originale (stesso cliente) | No |
| 5 | FL-GARANZIA | Chiamata in garanzia (S/N) | No |
Utilizzato in: modifica dati chiamate.
I-SN-ENT -- Importazione s/n in ingresso¶
Importa l'elenco dei serial number in entrata in magazzino. L'acquisizione avviene per un singolo codice merce.
| Id | Nome | Descrizione | Obbligatorio |
|---|---|---|---|
| 1 | MERCE-MA | Codice merce avanzato | Si (alternativo a 2/6) |
| 2 | MERCE-MI | Codice merce interno (GGSSCCCCC) | Si (alternativo a 1/6) |
| 3 | SN-SN | Serial number da caricare | Si |
| 4 | SN-KEY-ALT | Chiave alternativa s/n | Si (se prevista sulla merce) |
| 5 | SN-SW-VERSION | Versione software abbinata | No |
| 6 | MERCE-PN | Part number associato alla merce | Si (alternativo a 1/2) |
Utilizzato in: aggiornamento s/n (entrata).
I-INVENTARIO-MS -- Importazione inventario magazzini secondari¶
Importa l'inventario dei magazzini secondari. Il file puo' contenere dati di un solo magazzino o di tutti i magazzini di un tipo (esterni, cliente, fornitore).
| Id | Nome | Descrizione | Obbligatorio |
|---|---|---|---|
| 1 | MAG-COD | Codice magazzino da inventariare | Si |
| 2 | MERCE-MA | Codice merce avanzato | Si (alternativo a 3 o 4+5+6) |
| 3 | MERCE-MI | Codice merce interno (GGSSCCCCC) | Si (alternativo a 2 o 4+5+6) |
| 4 | MERCE-MI-GRU | Codice merce: gruppo | Si (formato esploso, alternativo a 2/3) |
| 5 | MERCE-MI-SOT | Codice merce: sottogruppo | Si (formato esploso) |
| 6 | MERCE-MI-COD | Codice merce: codice | Si (formato esploso) |
| 7 | QTA-INV | Quantita' in inventario | Si |
Utilizzato in: inventario magazzini secondari.
I-BDG-PRD -- Importazione budget produttivo¶
Importa i budget produttivi mensili per tecnico.
| Id | Nome | Descrizione | Obbligatorio |
|---|---|---|---|
| 1 | TEC-COD | Codice tecnico | Si |
| 2 | TEC-DES | Nome tecnico | No |
| 3 | AA-BDG | Anno budget | Si |
| 4 | MM-BDG | Mese budget | Si |
| 5 | OBI-GIO | Obiettivo giornaliero | No |
| 6 | GG-LAV | Giorni lavorativi del mese | No |
| 7 | DATA-FR | Data fine rapporto lavorativo | No |
Utilizzato in: importazione budget produttivo.
Catalogo modelli di esportazione¶
E-ATTIVITA-CRM -- Esportazione attivita' CRM¶
Esporta il dettaglio di un'attivita' CRM.
| Id | Nome | Descrizione |
|---|---|---|
| 1 | ATT-NUM | Numero attivita' |
| 2 | AUTORE-COD | Codice operatore autore |
| 3 | DATA-INS | Data inserimento |
| 4 | DATA-PREV | Data prevista esecuzione |
| 5 | ORA-PREV | Ora prevista esecuzione |
| 6 | TIPOLOGIA | Codice tipologia attivita' |
| 7 | TIPO | Tipo attivita' |
| 8 | OGGETTO | Oggetto dell'attivita' |
| 9 | DES | Descrizione dell'attivita' |
| 10 | OPE-COD | Codice operatore assegnato |
| 11 | OPE-DATA-ESE | Data esecuzione |
| 12 | OPE-ORA-ESE | Ora esecuzione |
| 13 | OPE-FL-ESE | Indica "S" quando eseguita |
| 14 | NOM-COD | Codice nominativo collegato |
| 15 | NOM-CONTATTO | Codice contatto collegato |
Utilizzato in: CRM06B (esportazione attivita' CRM).
E-DDT -- Esportazione dettaglio DDT¶
Esporta il dettaglio di un documento di uscita. Ogni riga DDT corrisponde a una riga nel file. Non sono esportate le descrizioni aggiuntive riga. La versione puo' essere selezionata in base al cliente del DDT.
| Id | Nome | Descrizione |
|---|---|---|
| 1 | MERCE-MA | Codice merce avanzato |
| 2 | MERCE-MI | Codice merce interno (GGSSCCCCC) |
| 3 | MERCE-CMC | Codice merce cliente |
| 4 | MERCE-DES | Descrizione merce |
| 5 | R-UM | Unita' di misura riga |
| 6 | R-QTA | Quantita' riga |
| 7 | R-PREZZO-L | Prezzo lordo |
| 8 | SCO-1 | Sconto 1 |
| 9 | SCO-2 | Sconto 2 |
| 10 | R-PREZZO-N | Prezzo netto |
| 11 | IMPORTO | Importo riga |
| 12 | RIF-ORD-INT | Riferimento ordine interno (formato C/AAAA/NNNNNNN/0) |
| 13 | RIF-ORD-CLI | Riferimento ordine cliente |
| 14 | DDT-NUM | Numero documento |
| 15 | DDT-KEY | Chiave completa documento (es. 1/2021/I/000123) |
| 16 | DDT-DATA | Data documento |
| 17 | DDT-RIGA | Numero riga documento |
| 18 | LOTTO-EXT | Codice lotto esterno (lotto fornitore o lotto produzione) |
Utilizzato in: esportazione dettaglio DDT (richiamabile da diverse funzioni).
E-SN-DDT -- Esportazione s/n su DDT¶
Esporta l'elenco dei serial number abbinati a un documento di uscita. Considera solo i prodotti gestiti a s/n. Genera un unico file per tutte le righe del DDT. La versione puo' essere selezionata in base al cliente.
| Id | Nome | Descrizione |
|---|---|---|
| 1 | MERCE-MA | Codice merce avanzato |
| 2 | MERCE-MI | Codice merce interno (GGSSCCCCC) |
| 3 | MERCE-PN | Part number associato alla merce |
| 4 | MERCE-TIPO | Tipo di prodotto (descrizione tipo matricola) |
| 5 | MERCE-FORN | Fornitore (descrizione marca da anagrafica merci) |
| 6 | MERCE-DES | Descrizione merce |
| 7 | DDT-RIF-1 | Riferimento DDT (formato m/aaaa/t/nnnnnn) |
| 8 | ID-DEST | Id destinazione |
| 9 | SN-SN | Serial number scaricato |
| 10 | SN-KEY-ALT | Chiave alternativa s/n scaricato |
| 11 | SN-SW-VERSION | Versione software abbinata al s/n |
Utilizzato in: gestione s/n in uscita (matricole).
E-DOP -- Esportazione dichiarazioni O.P.¶
Esporta l'elenco dei prodotti acquistati da un fornitore in un periodo, in formato importabile da IMPDOMER (dichiarazioni di origine).
| Id | Nome | Descrizione |
|---|---|---|
| 1 | MERCE-MA | Codice merce avanzato |
| 2 | MERCE-MI | Codice merce interno (GGSSCCCCC) |
| 3 | MERCE-DES | Descrizione merce |
| 4 | MERCE-CMF | Codice merce fornitore |
| 5 | ANA-COD | Codice fornitore |
| 6 | DATA-COMP | Data compilazione (segnaposto per import, non popolato in export) |
| 7 | FL-CANC | Cancellazione logica |
| 8 | FL-ORIGINE | Indicazione dell'origine |
| 9 | NAZ-COD | Codice nazione di origine |
| 10 | FL-PSP | Presenza sostanze pericolose |
Utilizzato in: richieste a fornitore (esportazione dopo pre-elaborazione dati).