COGV93 -- Visualizzazione Preventivi¶
Sorgente: cbl/cogv93.cbl | Tipo: Programma interattivo a griglia con filtri | Program-ID: COGV93
Menu:
- Vendite > Preventivi
Scopo¶
COGV93 e' il programma di visualizzazione e consultazione dei preventivi di vendita. Presenta una maschera con filtri (cliente, destinatario, periodo, tipo, stato) e una griglia navigabile con l'elenco dei preventivi. Dalla griglia e' possibile accedere alla gestione del preventivo (COGV91/COGV92), alla stampa, alla navigazione sul documento e alle funzionalita' CRM.
Supporta modalita' CALLED per essere richiamato dalla scheda CRM (CRM030) o da altri programmi.
Interfaccia utente¶
Maschera di filtro¶
| Campo | Tipo | Descrizione |
|---|---|---|
tm-tipo-prv |
x(01) | Tipo preventivo (default "T" = tutti) |
tm-sit-prv |
x(01) | Situazione/stato preventivo (default "T" = tutti) |
tm-applicato-a |
x(01) | Applicato a (default "P" = preventivo) |
tm-da-data / tm-a-data |
9(08) | Intervallo date (default: 01/01 - 31/12 anno corrente) |
tm-cli |
9(05) | Cliente intestatario |
tm-cli-d |
9(05) | Cliente destinatario |
tm-dst |
composito | Destinazione (tipo + indice) |
tm-nom-cod |
9(08) | Nominativo CRM |
Tasti funzione¶
| Tasto | Funzione |
|---|---|
| Invio | Apre il dettaglio del preventivo (COGV91) |
| F1 | Configurazione (RNEWCONF) |
| F3 | Conferma filtri / gestione |
| F7 | Filtro su griglia |
| F8 | Dettaglio / Calendario / Aiuto |
| F9 | Stampa (COGT52) / Ricerca avanzata |
| S-F2 | Navigazione sul documento (COGU70) |
| S-F4 | Gestione griglia (GRIDADMN) |
| S-F5 | Esportazione Excel |
| Ctrl+S | Salva impostazione filtri (IMPPREDF) |
| Ctrl+F | Cerca impostazione filtri salvata |
Modalita' CALLED¶
Quando richiamato con cogv93-called = "COGV93-CALLED" (via utilcogv93.cpy):
| Campo linkage | Descrizione |
|---|---|
cogv93-called |
Deve valere "COGV93-CALLED" |
cogv93-caller |
Programma chiamante (es. "CRM030") |
cogv93-in-cliente |
Codice cliente per prefiltro |
cogv93-in-cli-dst-tip / cogv93-in-cli-dst-cod |
Cliente destinatario (tipo + codice) |
cogv93-in-dst-tip / cogv93-in-dst-idx |
Destinazione (tipo + indice) |
cogv93-nom |
Nominativo CRM |
Comportamento specifico per CRM030¶
Se il chiamante e' CRM030 e il cliente ha un "padre" in anagrafica, il cliente di input diventa il destinatario (non l'intestatario).
Chiamanti noti¶
| Programma | Contesto |
|---|---|
| CRM030 | Scheda CRM cliente |
| Programmi menu | Accesso diretto da menu |
Logica di Elaborazione¶
Flusso principale¶
- Inizializzazione:
z-99-init-program, configurazione (RNEWCONF), apertura file, preparazione griglia - Restrizioni CRM: chiama CRMS12 con operazione "PREPARA" per verificare le restrizioni di visibilita' dell'operatore
- Se CALLED: carica i filtri dal linkage (cliente, destinatario, nominativo) e li preimposta
- Impostazioni predefinite: carica l'eventuale impostazione filtri salvata (IMPPREDF); se trovata, salta direttamente alla ricerca
- Accept filtri (pagina 1): tipo, stato, applicato-a, date, cliente, destinatario, nominativo
- Conferma (
a-controlla-filtri): validazione filtri e caricamento griglia - Griglia preventivi: navigazione, ordinamento, filtro contestuale
- Azioni su riga: dettaglio (COGV91), stampa (COGT52), navigazione documento (COGU70), gestione (COGV92), filiera CRM (COGMA3)
- Chiusura: chiude file e cancella programmi
Caricamento griglia¶
Il caricamento dei preventivi avviene nel paragrafo di caricamento dati richiamato dalla gestione griglia paginata. I preventivi vengono filtrati per:
- Tipo e stato preventivo
- Periodo date
- Cliente intestatario e/o destinatario
- Nominativo CRM
- Restrizioni CRM dell'operatore (CRMS12)
- Gruppo aziende (se configurato, via COGS0B/GRP002)
L'ordinamento predefinito e' per cliente (ascendente), salvo personalizzazioni aziendali (Sanitel, Ferrari Giuseppe: ordinamento per anno/numero preventivo).
File e Tabelle¶
File acceduti¶
| File/Tabella | Copybook | Uso |
|---|---|---|
| FEURTAB | cogfiles.cpy | Tabella nomi file |
| COGGEANA | (da cogv93.select) | Anagrafica clienti/destinatari |
| CRMANAGR | (da cogv93.select) | Anagrafica nominativi CRM |
| File preventivi | (da cogv93.select/fd) | Archivio preventivi |
Programmi chiamati¶
| Programma | Scopo |
|---|---|
| COGV91 | Gestione/dettaglio preventivo (Invio) |
| COGV92 | Gestione preventivo alternativa |
| COGT52 | Stampa preventivo (F9) |
| COGU70 | Navigazione sul documento (S-F2) |
| COGT90 | Gestione tipo documento |
| CRMS12 | Restrizioni CRM operatore |
| CRMS02 | Funzionalita' CRM |
| COGMA3 | Filiera CRM (S-F2 con filiera) |
| COGS0B | Verifica abilitazione gruppo aziende |
| GRP002 | Gestione gruppo aziende |
| COGS65W | Ricerca cliente/anagrafica |
| WIN017 | Finestra dettaglio |
| GRIDADMN | Gestore griglia interattiva |
| RNEWCONF | Lettura configurazioni |
| IMPPREDF | Gestione impostazioni predefinite filtri |
Copybook principali¶
Screen Designer (generati)¶
| Copybook | Contenuto |
|---|---|
cogv93-01.scr |
Maschera (screen section) |
cogv93.select |
SELECT file |
cogv93.fd |
FD file |
cogv93.wrk |
Working storage |
cogv93.tm |
Campi modificabili in tab-maschera |
cogv93.decla |
Declaratives |
cogv93.prc |
Procedure division generate |
cogv93.imppredf-wrk |
Working per impostazioni predefinite |
Gestionale¶
| Copybook | Contenuto |
|---|---|
cogazien.cpy |
Dati azienda |
utilcogv93.cpy |
Interfaccia linkage CALLED |
utilv91.cpy |
Interfaccia per COGV91 |
utilcrms12.cpy |
Interfaccia CRMS12 (restrizioni) |
utilcrms02.cpy |
Interfaccia CRMS02 (CRM) |
utilimppredf.cpy |
Interfaccia IMPPREDF (filtri salvati) |
utilcogt52.cpy |
Interfaccia COGT52 (stampa) |
utilt90.cpy |
Interfaccia COGT90 (tipo documento) |
utilu70.cpy |
Interfaccia COGU70 (navigazione documento) |
utilcogma3.cpy |
Interfaccia COGMA3 (filiera CRM) |
utilcogs0b.cpy |
Interfaccia COGS0B (gruppo aziende) |
utilgrp002.cpy |
Interfaccia GRP002 |
k-personal.cpy |
Costanti personalizzazione |
k-tipi-cogtabel.cpy |
Costanti tipi tabella |
Configurazioni¶
La configurazione viene letta tramite RNEWCONF nel paragrafo x99-confi:
| Campo | Descrizione |
|---|---|
tm-cfg-tipo-num-prv |
Tipo numerazione preventivi |
tm-cfg-nom-2-tcl |
Mappatura nominativo verso tipo cliente |
tm-cfg-gruppo-aziende |
"S" = verifica abilitazione per gruppo aziende |
Note tecniche¶
- La griglia supporta ordinamento dinamico tramite click sulle intestazioni colonna e filtro contestuale
- Massimo 900 elementi caricabili nella griglia (
k-max-ele-tab = 900) - Il programma gestisce il popup menu contestuale sulla griglia (eccezioni 151-199)
- Per le personalizzazioni Sanitel e Ferrari Giuseppe, l'ordinamento predefinito e' per anno/numero preventivo anziche' per cliente
- Le restrizioni CRM (CRMS12) filtrano i preventivi in base all'operatore corrente
Documentazione tecnica -- 2026-04-08