ASN230 - Interventi (visualizzazione / ricerca)¶
Intestazione¶
| Campo | Valore |
|---|---|
| Programma | ASN230 |
| Titolo | Visualizzazione / ricerca interventi |
| Modulo | Assist 2.0 |
| Posizione menu | Assist 2.0 > Operativo > Visualizzazioni > Interventi |
Scopo e logica generale¶
ASN230 e' il pannello di ricerca e consultazione degli interventi di assistenza. Consente di combinare piu' filtri (zona, tecnico, cliente, oggetto/descrizione, stato chiamata, provenienza, squadra, responsabile, tipo attivita', area tecnica, contratto, matricola/marca/modello/serial number, periodo, ecc.) e di presentare i risultati in una griglia. Ogni utente puo' salvare filtri predefiniti e definirne uno di default; se configurato, la griglia esegue un auto-refresh e la funzione diventa un "pannello di controllo".
Oltre a essere una voce di menu autonoma, ASN230 e' anche il motore di ricerca/selezione chiamate richiamato da altre funzioni Assist (ad esempio da ASN140 in fase di ricerca chiamata).
La documentazione utente della funzione (filtri, ordinamenti, tipologie) e' mantenuta nella pagina utente corrispondente; questa scheda si concentra sulla costruzione della riga di risultato e sulle configurazioni, che sono le aree soggette alle modifiche recenti.
Costruzione della riga di risultato¶
Per ogni intervento estratto, il programma compone una riga di griglia (t-gor-r-*) arricchendola
con dati provenienti da piu' tabelle collegate:
| Campo riga | Origine | Contenuto |
|---|---|---|
t-gor-r-ord-mate |
ASNCHORD (acho) + COGTESOR (tor) |
Riferimento ordine materiali collegato alla chiamata |
t-gor-r-bdp-mate |
ASNCHORD / documenti di magazzino | Riferimento BDP (Buono di Prelievo) collegato |
t-gor-r-bdp-note |
COGTESBP (tbp) |
Riepilogo di "Rif:" e/o "Note:" della testata BDP |
t-gor-r-postit |
COGPOSTT (ptt) |
Nota post-it del cliente (assistenza / fatturazione) |
t-gor-r-agente / t-gor-r-agente-d |
COGGEANA (ana) |
Codice e nome dell'agente del cliente |
Ordine materiali collegato (tipo "O")¶
Il riferimento ordine materiali viene ricavato leggendo ASNCHORD per acho-id-chiamata. Se non
si trova un ordine di tipo materiale, la ricerca viene ripetuta cercando anche i record con
acho-tip = "O" (ordine), allineando ASN230 al comportamento di ASN210 (TASK-5052).
Nota del BDP collegato¶
Letta la testata BDP su COGTESBP (chiave tbp-mag/aa/num/mm/gg dai campi rbp-*), il campo
t-gor-r-bdp-note viene composto a partire da tbp-rif e tbp-note:
- solo
Rif:se e' valorizzato il solo riferimento; - solo
Note:se e' valorizzata la sola nota; Rif: ... ; Note: ...se entrambi presenti.
Post-it e agente del cliente (TASK-5572)¶
Determinato il cliente da considerare (il cliente di fatturazione acht-cli-fat-* se presente,
altrimenti il cliente assistito acht-cli-ass-*), il programma:
- Legge l'anagrafica
COGGEANA(ana) del cliente. -
Cerca la nota post-it su
COGPOSTT(ptt, paragrafocerca-postit) perptt-ana = ana-chiaeptt-merce = k-merce-null(post-it di anagrafica, non di merce), scartando i record cancellati (ptt-fl-canc = "C"). La scansione (st-cogpostt-notmin+rdnxt-cogpostt) itera i post-it del cliente e si arresta quando cambia chiave (ptt-ana/ptt-merce). Il valore della configurazioneass-chiam / visualizza-area-postit-cliente(tm-cfg-area-postit-cliente) determina quale nota viene selezionata: -
"N"o"T": viene presa la prima nota valida del cliente, indipendentemente dall'area (ptt-areanon filtrata; in avvio scansioneptt-area = spaces); "G": viene presa solo la nota generica, cioe' quella conptt-area = spaces;- qualsiasi altro valore: viene usato come codice area (
ptt-area = tm-cfg-area-postit-cliente) e viene presa la nota di quella specifica area.
La ricerca e' un'unica scansione: la nota selezionata e' la prima incontrata che soddisfa la regola
dell'area per il valore configurato. Se nessun record soddisfa la regola, t-gor-r-postit resta a
spazi.
3. Riporta l'agente dall'anagrafica (ana-agente) in t-gor-r-agente e ne risolve il nome
rileggendo COGGEANA come fornitore (k-ana-tipo-for) in t-gor-r-agente-d.
File e tabelle acceduti (per l'arricchimento risultato)¶
| File | Record | Modalita' | Uso |
|---|---|---|---|
| ASNCHTES | acht-rec | Input | Testata chiamata (cliente assistito / fatturazione) |
| ASNCHORD | acho-rec | Input | Ordini/materiali collegati alla chiamata (tipo "M"/"O") |
| COGTESOR | tor-rec | Input | Testata ordini materiali |
| COGTESBP | tbp-rec | Input | Testata Buoni di Prelievo (Rif./Note) |
| COGGEANA | ana-rec | Input | Anagrafica cliente/fornitore (agente, nomi) |
| COGPOSTT | ptt-rec | Input | Post-it (annotazioni rapide) di anagrafica |
Configurazioni (RNEWCONF)¶
Le configurazioni vengono lette in x99-confi dal pacchetto generale (k-pack-coge) con una tabella
ncnf di 18 voci. Alcune chiavi rilevanti:
| # | Gruppo | Chiave | Destinazione |
|---|---|---|---|
| 01 | assist | tipo-colore-righe-vis-chiamate | tm-cfg-tipo-colore |
| 16 | assist | gestione-esito-interventi | tm-cfg-gestione-esito-interventi |
| 17 | ass-strum | modo-chiusura | tm-cfg-modo-chiusura |
| 18 | ass-chiam | visualizza-area-postit-cliente | tm-cfg-area-postit-cliente |
La chiave ass-chiam / visualizza-area-postit-cliente (indice 18, TASK-5572) determina se e da quale
area estrarre il post-it del cliente da mostrare in griglia (vedi sopra). Con RNEWCONF la tabella
ncnf passa da 17 a 18 voci (move 18 to ncnf-pnt in x99-confi). La stessa chiave e' usata da
ASN140 per l'apertura automatica dei post-it in fase di intervento.
Storico modifiche¶
2026-07-11: revisione descrizione selezione area post-it¶
Allineata la descrizione del paragrafo cerca-postit al sorgente: la selezione della nota post-it e'
un'unica scansione di COGPOSTT (non un doppio giro). Il valore di configurazione
visualizza-area-postit-cliente seleziona: "N"/"T" la prima nota del cliente (qualsiasi area),
"G" la sola nota generica (ptt-area = spaces), qualsiasi altro valore la nota dell'area con quel
codice. Nessuna modifica al codice: solo correzione documentale (le voci TASK-5052, BDP e TASK-5572
sottostanti restano valide).
2026-05-14: TASK-5052 - Riferimento ordine materiali di tipo "O"¶
La colonna "Riferimento Ord. Materiali" viene ora popolata anche quando l'ordine collegato alla
chiamata e' di tipo "Ordine" (acho-tip = "O"), oltre al tipo "Materiale" gia' gestito. Allineamento
ad ASN210.
2026-05-22: Riferimento e note della testata BDP¶
Aggiunto il campo t-gor-r-bdp-note: quando l'intervento e' collegato a un ordine materiali con BDP
generato, oltre al riferimento del BDP viene riportato il contenuto di tbp-rif e tbp-note della
testata BDP (COGTESBP), riepilogati in "Rif: ... ; Note: ...".
2026-07-09: TASK-5572 - Agente e post-it del cliente¶
Aggiunta nuova configurazione ass-chiam / visualizza-area-postit-cliente (tm-cfg-area-postit-cliente,
indice 18 di RNEWCONF, che passa da 17 a 18 voci). Per ogni intervento vengono ora ricavati e
mostrati l'agente del cliente (t-gor-r-agente / t-gor-r-agente-d da COGGEANA) e la nota post-it
del cliente (t-gor-r-postit da COGPOSTT), scegliendo il cliente di fatturazione se presente,
altrimenti il cliente assistito. L'area del post-it e' filtrata in base al valore di configurazione,
con ripiego sulla prima nota disponibile.
Note¶
- Scheda tecnica focalizzata sulla costruzione della riga di risultato e sulle configurazioni: ASN230 e' un programma esteso (~9.400 righe) con ampia gestione di filtri, filtri salvati e auto-refresh; la logica di filtro/ordinamento di dettaglio non e' qui esaustivamente descritta.
COGPOSTTviene interrogata sui post-it di anagrafica (ptt-merce = k-merce-null); i post-it legati a una specifica merce non concorrono a questa visualizzazione.- La documentazione utente della funzione (elenco completo dei filtri, tipologie chiamata, ordinamenti, periodi) e' mantenuta nella corrispondente pagina utente.
Documentazione tecnica -- creata 2026-07-10