Segnalazioni¶
Panoramica¶
Il sistema di segnalazioni gestisce avvisi automatici e notifiche generate in risposta a eventi applicativi. Le segnalazioni vengono recapitate agli operatori tramite notifica interna, e-mail o SMS, e possono essere consultate da menu, all'apertura dell'applicazione o dalla scheda CRM.
Per l'invio di documenti e segnalazioni ai clienti tramite Areagate si veda la pagina dedicata Messaggistica.
| Ambito | Programmi principali |
|---|---|
| Configurazione segnalazioni | COGT40 |
| Definizione tipi avviso CRM | CRM082 |
| Configurazione avviso CRM | CRM083 |
| Schedulazione avvisi CRM | AVVCRM |
| Filtri su nominativi | CRM040 |
| Operazioni su informazioni CRM | CRMS06 |
Tipologie di segnalazione¶
Le segnalazioni si dividono in due categorie:
- Avvisi: generati da procedure pianificate e schedulate a intervalli regolari; possono essere ripetitivi.
- Notifiche: generate in risposta a operazioni specifiche effettuate dagli utenti.
Elenco avvisi¶
| Codice | Descrizione | Modulo |
|---|---|---|
| A | Ritardo su avviso da fornitore rispetto alla data consegna | Magazzino |
| B | Ritardo su arrivo da fornitore rispetto alla data limite | Magazzino |
| C | Ritardo su conferma ordine da parte di un fornitore | Magazzino |
| D | Ritardo su restituzione materiale in prova | Magazzino |
| E | C/Visione scaduti | Magazzino |
| F | Ritardo su scarico componenti dopo notifica dell'UT | Magazzino |
| G | Ritardo su riordino merce su una commessa dopo notifica dell'UT | Produzione |
| H | Sostituzione in garanzia scaduti | Magazzino |
| I | Ritardo su esecuzione step di workflow | CRM |
| J | Articolo in sottoscorta | Magazzino |
| K | Prodotto con listino a 0 | Vendite |
| L | Segnalazioni/avvisi CRM | CRM |
| M | Mancata evasione per componenti mancanti | Vendite |
| N | Commesse non fatturate | Commesse |
Elenco notifiche¶
| Codice | Descrizione | Modulo |
|---|---|---|
| A | Richiesta di riordino su commessa di produzione | Produzione |
| B | Richiesta di prelevamento materiale su commessa di produzione | Produzione |
| C | Modifica effettuata su commessa di prod: notifica al magazzino | Produzione |
| D | Modifica effettuata su commessa di prod: notifica all'ufficio acquisti | Produzione |
| E | Avanzamento diverso da commessa di prod: notifica all'UT | Produzione |
| F | Inserimento/variazione ordini di vendita; notifica a logistica | Vendite |
| G | Cancellazione ddt: notifica ad amministrazione | Vendite |
La procedura di gestione segnalazioni e' oggetto di revisione. Non tutte le tipologie sono attive: quelle attualmente operative sono la N (commesse non fatturate) e le segnalazioni CRM (tipo L).
Modalita' di attivazione¶
Le segnalazioni vengono configurate dalla funzione Definizione segnalazioni (COGT40). Per gli avvisi, l'attivazione inserisce un processo schedulato nel pannello di sincronizzazione Areagate (COGSKP).
COGT40 -- Definizione segnalazioni¶
Identificazione¶
- Menu: Sistema > Configurazione > Segnalazioni
- Funzione: Configurazione delle tipologie di segnalazioni del gestionale
Logica¶
COGT40 presenta una griglia con le tipologie avvisi disponibili (A-N) e la tipologia L per le segnalazioni CRM. Su ciascuna riga l'utente puo' premere Invio o F2 per accedere alla configurazione specifica.
Per la tipologia "L" (Segnalazioni su CRM), il programma richiama CRM082 per la definizione dei tipi avviso.
CRM082 -- Definizione tipi avviso¶
Identificazione¶
- Menu: CRM > Archivi > Allarmi (richiamabile anche da COGT40)
- Funzione: Definizione delle tipologie di avviso per una determinata tipologia nominativo
Linkage¶
| Direzione | Dato | Descrizione |
|---|---|---|
| Input | Tipologia nominativo | Codice tipologia CRM |
| Input | Modalita' | Selezione / Aggiornamento |
| Output | Id avviso selezionato | Progressivo avviso scelto |
Struttura maschera¶
Testata: tipologia nominativo (controllata su CRMTIPCL, F8 richiama CRM010). Se richiamato dall'esterno, il campo e' read-only con la tipologia passata in input.
Griglia modificabile -- colonne:
| Colonna | Campo | Note |
|---|---|---|
| Progr. | AVT-PROG | Read-only |
| Descrizione | AVT-DES | Obbligatorio |
| Note | AVT-NOTE | Read-only |
Tasti funzione:
- F3: commuta tra modalita' Selezione e Aggiornamento
- F6 (Gestione): esegue aggiornamento e richiama CRM083 passando tipo nominativo e progressivo
Elaborazione¶
Carica in griglia il contenuto di CRMAVTES per tutti i record con AVT-TCL = tipologia selezionata. In aggiornamento l'utente puo' inserire nuove righe (solo descrizione modificabile), modificare descrizioni esistenti o cancellare righe (con conferma).
CRM083 -- Configurazione avviso¶
Identificazione¶
- Menu: non a menu (richiamato da CRM082)
- Funzione: Configurazione completa di una tipologia di avviso CRM
Linkage¶
| Direzione | Dato | Descrizione |
|---|---|---|
| Input | Tipologia nominativo | Codice tipologia |
| Input | Progressivo avviso | Da CRMAVTES |
Struttura maschera¶
La maschera e' organizzata in 4 pagine (tab-control).
Pagina 1 -- Dati generali¶
Tutti i campi collegati a CRMAVTES.
| Campo | Collegamento | Note |
|---|---|---|
| Avviso attivo | AVT-FL-ATTIVO | Se non spuntato l'avviso non viene schedulato |
| Descrizione dettagliata | AVT-NOTE | Note, non obbligatorio |
| Informazione da controllare | AVT-INF-AVVISO | Obbligatorio; solo tipo Data o Numero; F8 richiama CRM013; deve esistere su CRMSKINF per la tipologia |
| Confrontare con | AVT-INF-CONFRONTO | Obbligatorio se l'informazione non e' di tipo Data; stessa tipologia dell'informazione da controllare |
| Soglia | AVT-SOGLIA-1 | Positivo = posticipo, negativo = anticipo; per date e' in giorni |
| Informazione da aggiornare | AVT-INF-DA-AGGIORNARE | Non obbligatorio; stessa tipologia dell'informazione da controllare |
| Tipo aggiornamento | AVT-TIPO-AGGIORNAMENTO | "A" = con dato controllato, "B" = con data sistema, "C" = incrementare |
| Incremento | AVT-INCREMENTO | Abilitato se tipo aggiornamento = "C" |
Regole sul tipo aggiornamento: per informazioni di tipo Data sono ammessi solo "A" e "B"; per tipo Numero solo "A" e "C".
Pagina 2 -- Filtri su nominativi¶
Griglia modificabile collegata a CRMFLTDT (FLD-TIP = K-CPT-FILTRO-ALLARME, FLD-COD = AVT-CHIA1, FLD-TIP-DET = "F").
| Colonna | Campo | Note |
|---|---|---|
| Progr. | FLD-PROG | Read-only, auto-attribuito |
| Specie | FLD-INF-SPECIE | "F" = Fissa, "I" = Variabile |
| Informazione | FLD-INF-COD | Codice informazione |
| Deve essere | FLD-OPE | Operatore di confronto (costanti k-cnd-* da costanti-clipot.cpy) |
| Valore | FLD-VAL | Valore di confronto |
Pagina 3 -- Destinatari¶
Griglia modificabile collegata a CRMAVDST (AVD-TCL = tipologia, AVD-PROG-AVV = progressivo, AVD-LIVELLO = "1").
| Colonna | Campo | Note |
|---|---|---|
| Progr. | AVD-PROG-DST | Read-only, auto-attribuito |
| Tipo dest. | AVD-DST-TIP | "G" = Gruppo, "O" = Operatore, "P" = Proprietario scheda |
| Gruppo | AVD-DST-GRUPPO | Abilitato se tipo = "G"; controllato su COGT07 |
| Operatore | AVD-DST-OPE | Abilitato se tipo = "O"; controllato su COGT20 |
| Tipo notifica | AVD-TIP-NOTIFICA | E-mail / SMS / Notifica; se tipo dest. = "P" non e' ammesso "N" |
Campi aggiuntivi:
- Proprietario (AVT-INF-PROPRIETARIO): informazione che rappresenta il proprietario della scheda; tipo K-INF-TIP-NOMINATIVO; abilitato se almeno un destinatario ha notifica diversa da "N"
- Posizione contatto (AVT-POSIZIONE): obbligatorio se proprietario abilitato; controllato su tabella posizioni (COGG33)
Pagina 4 -- Dati avviso¶
| Campo | Collegamento | Note |
|---|---|---|
| Oggetto messaggio | AVT-OGGETTO | Obbligatorio se notifica e-mail o notifica |
| Testo messaggio | AVT-MESSAGGIO | Sempre obbligatorio |
Aggiornamento¶
Al salvataggio (F3 Aggiorna) vengono aggiornate le tabelle CRMAVTES, CRMAVDST e CRMFLTDT.
AVVCRM -- Schedulazione avvisi¶
Identificazione¶
- Menu: non a menu (richiamato da COGSKP, scheduler)
- Funzione: Analisi delle tipologie di avviso attive e generazione segnalazioni
Flusso di elaborazione¶
A -- Ricerca filtri attivi¶
Scansione di CRMAVTES usando AVT-CHIA3; considera solo i record con AVT-FL-ATTIVO = "S". Per ciascun avviso attivo esegue il punto B.
B -- Filtro su nominativi¶
Definisce un file di transito TRAN-CRM040. Chiama CRM040 con i parametri:
| Dato | Contenuto |
|---|---|
| CRM040-OPE | "ESEGUI-FILTRO" |
| CRM040-FLT-TIP | K-CPT-FILTRO-ALLARME |
| CRM040-FLT-COD | AVT-CHIA1 |
All'uscita apre il transito TRAN-CRM040 e per ciascun nominativo trovato esegue il punto C.
C -- Verifica nominativo¶
Legge l'informazione da controllare tramite CRMS06 (operazione "LEGGI", CRMS06-INF = AVT-INF-AVVISO, CRMS06-INF-SPECIE = "I"). Il dato restituito puo' essere una data (CRMS06-DATO) o un valore numerico (CRMS06-DATO-NUM).
Logica di confronto:
- Al valore dell'informazione somma AVT-SOGLIA-1
- Se AVT-INF-CONFRONTO e' vuoto (solo per tipo data): il valore di confronto e' la data di sistema
- Se AVT-INF-CONFRONTO e' significativo: il valore di confronto e' il contenuto dell'informazione
- L'avviso scatta se (INF-AVVISO + SOGLIA) >= VALORE-CONFRONTO
Se la condizione e' verificata, prosegue con l'emissione (punto D).
D -- Emissione avviso¶
Esegue prima la compilazione dei tag nel testo messaggio (punto D.4), poi per ciascun destinatario (punto D.5), in base al tipo notifica:
| Tipo notifica | Azione |
|---|---|
| "E" (e-mail) | Chiamata a POSTA con operazione "COMPLETO", AVT-OGGETTO come oggetto, AVT-MESSAGGIO compilato come testo, MYMAIL-INVIO-AUTO = "S" |
| "S" (SMS) | Chiamata a AREASMS con operazione "INVIA-SILENT", AVT-MESSAGGIO compilato come testo |
| "N" (notifica) | Inserimento su COGSEGNA / COGSGNT / COGSGNDT (punto D.3) |
Dopo l'emissione, se AVT-INF-DA-AGGIORNARE > 0, esegue l'aggiornamento informazione (punto E).
D.3 -- Emissione notifica interna¶
Verifica duplicati: cerca su COGSEGNA tramite SGN-CHIA2 un record con SGN-CAT = "A", SGN-TIP = "L", SGN-KEY-LIV = "1", SGN-KEY = codice nominativo + AVT-CHIA1, SGN-FL-EVA = "N". Se esiste gia' una segnalazione non evasa, esce senza generarne una nuova.
Altrimenti inserisce:
COGSEGNA (testata segnalazione):
| Campo | Contenuto |
|---|---|
| SGN-NUM | Primo numero libero |
| SGN-CAT | "A" |
| SGN-TIP | "L" |
| SGN-KEY-LIV | "1" |
| SGN-KEY | Codice nominativo + AVT-CHIA1 |
| SGN-AUT-TIP | "P" |
| SGN-AUT | k-program-id |
| SGN-DATA-EMI | Data sistema |
| SGN-ORA-EMI | Ora sistema |
| SGN-FL-EVA | "N" |
| SGN-OGG | AVT-OGGETTO |
| SGN-FL-AGG | "S" |
COGSGNT (testo segnalazione):
| Campo | Contenuto |
|---|---|
| SGL-NUM | SGN-NUM |
| SGN-LEN | Lunghezza di AVT-MESSAGGIO compilato |
| SGN-NOTE | AVT-MESSAGGIO compilato |
COGSGNDT (destinatari segnalazione) -- un record per ciascun destinatario:
| Campo | Contenuto |
|---|---|
| SGO-NUM | SGN-NUM |
| SGO-OPE | Codice operatore destinatario |
| SGO-DATA-EMI / SGO-ORA-EMI | Data e ora sistema |
| SGO-FL-EVA | "N" |
| SGO-FL-ALLARME | "N" |
| SGO-FL-VISTA | "N" |
D.4 -- Compilazione testo messaggio¶
Il testo del messaggio puo' contenere tag nella forma <INFO-xnnnn> dove:
- x = specie informazione ("F" = fissa, "I" = variabile)
- nnnn = codice informazione (4 cifre)
Esempio: Il contratto n. <INFO-F0002> scadra' in data <INFO-I0151> diventa Il contratto n. 153 scadra' in data 31/10/2013.
Il programma esegue un loop sul testo cercando occorrenze di <INFO-. Per ciascuna, chiama CRMS06 con operazione "LEGGI" e sostituisce il tag con il dato restituito, formattato in base al tipo:
| Tipo informazione | Formato sostituzione |
|---|---|
| Data (K-INF-TIP-DATA) | Editato con barre (gg/mm/aaaa) |
| Numero (K-INF-TIP-NUMERO) | CRMS06-DATO-EDIT |
| Nominativo (K-INF-TIP-NOMINATIVO) | Lettura CRMANAGR con CRMS06-DATO-NUM, usa CRA-NOME |
D.5 -- Ricerca destinatari¶
Per ciascun record in CRMAVDST, in base al tipo destinatario:
| Tipo | Logica |
|---|---|
| "O" (Operatore) | Legge PRNTOPE2 usando AVD-DST-OPE; usa PTO2-SMS o PTO2-EMAIL in base al tipo notifica |
| "G" (Gruppo) | Scansione PRNTGROD per AVD-DST-GRUPPO; per ciascun operatore del gruppo legge PRNTOPE2 |
| "P" (Proprietario) | Se AVT-INF-PROPRIETARIO e' impostata, estrae il nominativo proprietario tramite CRMS06; altrimenti il proprietario e' il nominativo stesso. Cerca il contatto su COGRIFER con posizione = AVT-POSIZIONE; usa RIF-MAIL per e-mail, RIF-TEL-1/2/3 per SMS (primo mobile valido) |
E -- Aggiornamento informazione¶
Se AVT-INF-DA-AGGIORNARE > 0, dopo l'emissione dell'avviso aggiorna l'informazione tramite CRMS06 (operazione "SCRIVI"):
| AVT-TIPO-AGGIORNAMENTO | Valore scritto |
|---|---|
| "A" | Contenuto dell'informazione AVT-INF-AVVISO letta in precedenza |
| "B" | Data di sistema |
| "C" | Informazione incrementata di AVT-INCREMENTO (solo per tipo Numero) |
CRM040 -- Filtri su nominativi¶
Programma di utilita' che esegue l'estrazione filtrata di nominativi CRM. Utilizzato da AVVCRM per ottenere l'elenco dei nominativi su cui verificare le condizioni di avviso.
Accetta in input il tipo filtro (K-CPT-FILTRO-ALLARME per gli avvisi) e il codice filtro, e restituisce i risultati nel file di transito TRAN-CRM040.
CRMS06 -- Operazioni su informazioni CRM¶
Programma di servizio per la lettura e scrittura di informazioni sulle schede CRM. Utilizzato da AVVCRM per:
- Lettura: operazione "LEGGI" -- restituisce il contenuto di un'informazione fissa o variabile, con tipo (CRMS06-INF-TIP) e dato editato (CRMS06-DATO-EDIT) per le informazioni numeriche; per informazioni di tipo "nominativo" il trattamento e' numerico
- Scrittura: operazione "SCRIVI" -- aggiorna un'informazione su una scheda nominativo; il dato viene passato in CRMS06-DATO o CRMS06-DATO-NUM a seconda del tipo
Avviso N -- Commesse non fatturate¶
Evidenzia le commesse a preventivo non interamente fatturate. Le commesse considerate sono quelle per cui e' stata gia' emessa almeno una fattura ma l'importo non copre l'intero preventivo.
Se dall'ultima fattura sono passati piu' di N giorni, viene emesso un avviso.
Parametri: GG soglia 1 = numero giorni dall'ultima fattura.
Avviso J -- Articolo in sottoscorta¶
Genera un avviso quando un articolo si trova in una delle seguenti condizioni:
Giacenza sotto scorta minima¶
L'avviso scatta se la giacenza (inclusa la quantita' ordinata entro N giorni, configurabile in avv-j-gg-ord-for) e' inferiore alla scorta minima definita sull'articolo. Se la scorta minima e' 0, l'avviso scatta solo se la giacenza e' negativa.
| Scorta minima | Giacenza | Avviso |
|---|---|---|
| 0 | 0 | No |
| 0 | 5 | No |
| 0 | -1 | Si' |
| 10 | 10 | No |
| 10 | 9 | Si' |
Giacenza inferiore al fabbisogno giornaliero¶
Se il controllo precedente non genera avviso, viene verificato il fabbisogno giornaliero. Il numero di giorni di copertura e' configurabile:
| Configurazione | Valore |
|---|---|
| Pacchetto | Eurocoge |
| Codice/programma | segnalaz |
| Parametro | avv-j-gg-fabbisogno |
Se il parametro vale 0 o 9999 il controllo viene ignorato. Altrimenti: fabbisogno giornaliero * giorni copertura viene confrontato con la giacenza; se questa e' inferiore, scatta l'avviso.
Restrizioni su operatori¶
Nell'ambito dei gruppi di aziende e' possibile limitare la visibilita' dei dati per operatore. Il criterio attuale e':
| Criterio | Descrizione |
|---|---|
| GRPAZ | Codice azienda del gruppo: l'utente vede solo i documenti dell'azienda abilitata |
Regola generale: ogni operatore e' abilitato a tutti i criteri per default ("jolly"). Se viene definita almeno una abilitazione specifica, l'operatore vede solo i criteri indicati.
Conseguenze:
- Nuovo operatore: abilitato a tutte le aziende, salvo abilitazione specifica successiva
- Nuova azienda: visibile a tutti gli operatori "jolly", non a quelli con abilitazioni specifiche
Funzioni gestite: Consultazione Chiamate, Consultazione Interventi, Consultazione Produzione sintetica, Consultazione Produzione analitica.
| Configurazione | Valore |
|---|---|
| Gruppo | assist |
| Parametro | gestione-gruppo-aziende |
Programma di ricerca abilitazioni/restrizioni: COGS0B.
Restrizioni su agenti¶
Le restrizioni su agenti operano nell'ambito CRM e si basano su due parametri dell'operatore: codice agente e codice zona. Le restrizioni si sommano.
Criteri di visibilita'¶
- Superuser CRM: nessuna restrizione
- Operatore con zona: vede i clienti della propria zona (o senza zona), e tutti i nominativi non-cliente
- Operatore agente: vede solo i clienti collegati al proprio codice agente o ad agenti "figli"; non vede i clienti senza agente (direzionali)
- Operatore agente con zona: entrambi i filtri si applicano contemporaneamente
Il collegamento agente padre/figlio e' dato dall'informazione "Agente padre" sull'anagrafica fornitore di tipo Agente.
| Zona | Agente | Tipo nominativo | Risultato |
|---|---|---|---|
| (vuota) | 0 | Tutti | Abilitato (vede tutto) |
| valorizzata | 0 | Non-cliente | Abilitato |
| valorizzata | 0 | Cliente, zona corrispondente o vuota | Abilitato |
| valorizzata | 0 | Cliente, zona diversa | Non abilitato |
| (vuota) | valorizzato | Non-cliente | Abilitato |
| (vuota) | valorizzato | Cliente senza agente | Non abilitato |
| (vuota) | valorizzato | Cliente, agente proprio o figlio | Abilitato |
| (vuota) | valorizzato | Cliente, agente diverso | Non abilitato |
| valorizzata | valorizzato | Cliente, agente proprio, zona corrispondente | Abilitato |
| valorizzata | valorizzato | Cliente, agente proprio, zona diversa | Non abilitato |