ASN241 - Prestazioni/materiali previsti¶

Sorgente: cbl/asn241.cbl (2.563 righe) | Tipo: Programma interattivo di sola consultazione a due pagine (filtri + griglia) con file di transito

Menu: Assist 2.0 > Operativo > Visualizzazioni > Prestazioni/Materiali previsti

Scopo¶

Visualizza in griglia le prestazioni e i materiali previsti (ASNCHPRP) delle chiamate Assist aperte in un periodo, con la relativa quantita' prevista, gia' usata e residua. Considera solo le chiamate che hanno almeno un intervento non ancora chiuso/pre-chiuso, applicando filtri per cliente, brand, gruppo aziende, prestazione/materiale, serial number e data.

La maschera e' organizzata in due pagine (tab): pagina "Filtri" e pagina "Risultati" (griglia). E' un cruscotto di sola lettura con export Excel (S-F5), stampa report (F9), e innesco di funzioni collegate alla chiamata selezionata (gestione chiamata, storico, galleria immagini).

Interfaccia chiamato (linkage)¶

Dichiara util-asn241 (copy "utilasn241.cpy") con i campi asn241-id-chiam-in, asn241-ana-cli-in, asn241-matricola-in, asn241-ass-data-in, asn241-id-inter-ou, asn241-nom-in. Tuttavia il codice attivo non popola w-dati-called dai campi del linkage (viene solo inizializzato) e i rami if w-dc-called='S' per l'uso da chiamante sono in gran parte commentati. In pratica il programma funziona come standalone da menu; il linkage e' predisposto ma non utilizzato in modalita' called effettiva.

File acceduti¶

Input/lettura¶

File	Copybook	Uso
ASNCHTES	`acht-rec`	Testate chiamate: chiave k06 su `acht-data`. Cliente fatt./assist., brand, gruppo aziende, tipo attivita', priorita', destinazione, nominativo CRM
ASNINTES	`acit-rec`	Interventi: chiave k02 (per chiamata) e k03 (per data assegnazione). Filtro interventi non chiusi/pre-chiusi
ASNINTE1	`aci1-rec`	ASNINTES rinominato (secondo cursore): interventi eseguiti (stato `P`/`C`) per il calcolo qta usata
ASNCHPRP	`achp-rec`	Dettaglio prestazioni/materiali previsti della chiamata: tipo (`P`/`M`), merce, quantita', matricola, contratto
ASNINDET	`acid-rec`	Dettaglio materiali su interventi chiusi (qta usata)
ASNAPPPR	`asnapppr-rec`	Prestazioni su interventi pre-chiusi (ore/minuti convertiti in qta)
ASNAPPMT	`asnappmt-rec`	Materiali su interventi pre-chiusi (qta usata)
ASNCHDET	`achd-rec`	Dettaglio chiamata: matricola quando ASNCHPRP non la riporta
ASNMATRI	`amtr-rec`	Matricole: serial number per filtro e visualizzazione
ASNTPATT	`atpa-rec`	Tipi attivita': descrizione e colore riga (modo `A`)
ASNPRIOR	`apri-rec`	Priorita': colore riga (modo diverso da `A`)
COGGEANA	`ana-rec`	Clienti fatturazione/assistito
COGBRAND	`bra-rec`	Descrizione brand/marchio
GRPAZIEN	`ao-azi-rec`	Descrizione gruppo aziende (se configurato)
CRMANAGR	`cra-rec`	Nominativo CRM (prospect) come cliente assistito
CRMTIPCL	`tcl-rec`	Tipologia nominativo CRM (validazione tipo `C`)
COGDESTI	`dst-rec`	Destinazione intervento (ragione sociale, indirizzo)
COGMERCI	`mer-rec`	Validazione merce filtro

Transito¶

File	Scopo
t-grid-det (`w-nome-t-grid-det`)	Buffer righe griglia (`cogtrans.k03` rinominata `t-grid-det` / `t-gor-r-`). Chiave k03 su `t-gor-r-id-chi` per evitare duplicati chiamata. Gestito con l'infrastruttura standard `t-grd-filtri`/`maskgt...` di Screens

Chiavi secondarie¶

asnchtes.k06 (data)
asnintes.k02 (chiamata), .k03 (ass-data)
asninte1.k02 (secondo cursore su asnintes, dichiarata inline st-asninte1-notmin-chia2)
t-grid-det.k02/.k03 (transito)

Programmi chiamati¶

Programma	Contesto	Scopo
COGS65W	cliente assistito / fatturazione	Lookup cliente (con supporto nominativi CRM su cliente assistito)
COGS68	prestazione/materiale	Lookup merce completa
COGS52W	date da/a	Calendario
COGMAH	F8 su brand	Lookup brand/marchio
GRP002	F8 su gruppo aziende	Lookup gruppo aziende
ASN200 (`ASN200-CALLED`)	F9 su serial number	Ricerca avanzata matricola per SN
ASN110	F7 su riga griglia	Gestione chiamata
ASN034	F8 su riga griglia	Visualizzazione storico modifiche chiamata
ASN073	F1 su riga griglia	Galleria immagini chiamata (se `az-arc-ott=S`)
GRIDADMN	griglia	Prepara/personalizzazione
RNEWCONF	`x99-confi`	Lettura/modifica configurazioni

Report F9 (z-wordmdl-report) e filtri predefiniti (z-imppredf-*) sono gestiti dall'infrastruttura standard inclusa via asn241.imppredf e le relative copybook.

Configurazioni RNEWCONF (`x99-confi`)¶

Idx	Gruppo	Chiave	Variabile	Effetto
01	`assist`	`tipo-colore-righe-vis-chiamate`	`tm-cfg-tipo-colore`	`A` = colore da tipo attivita', altro = da priorita'
02	`ass-chiam`	`intervento-piu-giorni`	`tm-cfg-inter-piu-giorni`	Gestione interventi su piu' giorni
03	`ass-chiam`	`clienti-assistiti-crm`	`tm-cfg-clienti-assistiti-crm`	Abilita nominativi CRM come cliente assistito (`s65-fl-nom`)
04	`assist`	`gestione-gruppo-aziende`	`tm-cfg-gestione-gruppo-aziende`	Abilita filtro/descrizione gruppo aziende
05	`azienda`	`gestione-brand-marchio`	`tm-cfg-gestione-brand`	Abilita gestione brand/marchio

Vedi assist, ass-chiam, azienda.

Logica di estrazione (`z-grid-det-crea-transito` → `z-grid-ricerca-dati`)¶

La ricerca copre due canali complementari:

Interventi non assegnati (z-grid-10-loop): scorre ASNCHTES su chia6 (acht-data nel range tm-data-da..tm-data-a). Considera la chiamata solo se ha almeno un intervento con acit-stato = A o spaces (non chiuso/pre-chiuso).
Interventi assegnati (z-grid-100-loop): scorre ASNINTES su chia3 (acit-ass-data nel range), tenendo solo gli interventi non chiusi/pre-chiusi, risalendo alla chiamata.

Entrambi confluiscono in z-grid-filtri.

Filtri e popolamento (`z-grid-filtri`)¶

Scarta la chiamata se gia' inserita nel transito (rd su k03).
Applica i filtri: cliente assistito (C = COGGEANA, P = nominativo CRM), cliente fatturazione, brand, gruppo aziende.
Scorre il dettaglio previsto ASNCHPRP della chiamata:
filtro tipo riga (P prestazione / M materiale) secondo tm-fl-prest/tm-fl-mater;
filtro singola merce (tm-prestazione);
filtro per serial number tramite la matricola ASNMATRI (range SN).
Per ogni riga che supera i filtri, popola t-grid-det con: chiamata, intervento, date, cliente fatt./assist. (o nominativo CRM), brand, gruppo aziende, tipo attivita', destinazione, classe (P/M), merce, quantita' prevista (achp-qta), quantita' usata e residua, matricola/serial number, contratto, colore riga.

Calcolo quantita' usata (`cerco-qta-usata`)¶

Scorre gli interventi eseguiti della chiamata (ASNINTE1 stato P/C):

Interventi chiusi (C): somma le quantita' da ASNINDET per la stessa merce.
Interventi pre-chiusi (P):
prestazioni (achp-tipo = "P"): da ASNAPPPR — se qta presente la somma, altrimenti converte ore+minuti in quantita' oraria;
materiali (achp-tipo = "M"): da ASNAPPMT.

La residua e' achp-qta - qta usata.

Visualizzazione e azioni (pagina Risultati)¶

Griglia di sola lettura (righe read-only, event-action-fail-terminate sull'entry). Azioni sulla riga selezionata:

F7 → ASN110 (gestione chiamata)
F8 → ASN034 (storico modifiche chiamata)
F1 → ASN073 (galleria immagini, se az-arc-ott=S)
F9 → report standard (z-wordmdl-report)
S-F4 personalizzazione griglia, S-F5 export Excel
Menu pop-up (right-click) con voci custom

Messaggi principali¶

I messaggi condividono il set m-asn240-* (procedura sorella ASN240):

ID	Contesto
`m-asn240-3-1`	Nessun dato trovato
`m-asn240-6-1`/`7-1`	Nessun tipo (prestazione/materiale) selezionato
`m-asn240-8-1`	Cliente fatturazione non esistente
`m-asn240-9-1`	Brand non esistente
`m-asn240-10-1`	Gruppo aziende non esistente
`m-asn240-11-1`/`12-1`/`13-1`	Nominativo CRM / tipologia / cliente non validi
`m-asn240-14-1`/`15-1`/`16-1`	Date obbligatorie / incongruenti
`m-asn240-18-1`	Prestazione/materiale non esistente
`m-asn240-19-1`..`23-1`	Etichette pulsanti custom
`m-asn240-200-1`	Etichetta "Cliente assistito" (variabile cliente/prospect)
`m-asn241-2`	Titolo maschera

Storico modifiche significative (dal sorgente)¶

101018: cliente assistito puo' essere un nominativo CRM (prospect); campi tm-ass-tip, tm-nom-ass-cod; config clienti-assistiti-crm
191218: gestione brand/marchio e gruppo aziende (filtri tm-brand, tm-grp-az-ese; config gestione-brand-marchio, gestione-gruppo-aziende); cliente fatturazione come filtro
200214: colore righe configurabile (tipo attivita' vs priorita')

Note implementative¶

Il file di transito t-grid-det e la relativa infrastruttura (filtri contestuali, ordinamento, export, filtri predefiniti) sono generati da Screens (asn241.select, asn241.imppredf, t-grd-filtri).
ASNINTE1 non e' una tabella distinta: e' ASNINTES inclusa una seconda volta con prefisso aci1-/asninte1 (secondo cursore), per scorrere gli interventi eseguiti mentre il cursore principale e' posizionato su un'altra chiamata.
La quantita' usata aggrega tre fonti diverse a seconda dello stato dell'intervento (chiuso → ASNINDET; pre-chiuso prestazione → ASNAPPPR con conversione oraria; pre-chiuso materiale → ASNAPPMT).
Filtri predefiniti (imppredf): all'avvio carica l'eventuale filtro di default; Ctrl-S salva, Ctrl-F seleziona.