JD - SIGEAnext

Le funzioni del gestionale riscritte per il browser.

Cosa ci guadagni. Le stesse funzioni dell'ERP, più veloci da usare, con stampa e analisi su ogni tabella.

JD1 - A cosa serve

JD1 - A cosa serve

JD1.1 - Cosa cambia rispetto al legacy

In una frase. SIGEAnext è il gestionale SIGEA riscritto per il browser: stessi dati di sempre, pagine più comode.

Il gestionale di sempre, l'ERP legacy/COBOL, lavora a maschere: una per volta, con i tasti funzione. SIGEAnext riscrive quelle funzioni come pagine web. I dati non si spostano e non si copiano: le due versioni leggono e scrivono lo stesso archivio dell'azienda. Per questo si può passare al nuovo una funzione alla volta.

Oggi le funzioni riscritte sono ancora poche: la pagina I dodici moduli dice quali. Tutte le altre si aprono dallo stesso menu come pagine storiche (vedi il libro JH - SBHweb).

Una funzione di SIGEAnext: a sinistra il menu del modulo, in alto il percorso, sotto i filtri e la tabella

Una funzione di SIGEAnext: a sinistra il menu del modulo, in alto il percorso, sotto i filtri e la tabella

Nel legacy In SIGEAnext
Un programma da installare sul computer Una pagina del browser
L'elenco si scorre e si stampa così com'è La tabella si ordina, si filtra, si raggruppa
Per un totale o un grafico serve un report Analisi apre numeri e grafici sui dati che stai guardando
Le stampe sono quelle previste dal programma Ogni tabella esce in Excel, in PDF o con un modello di stampa

Cosa ci guadagni.
• Le stesse funzioni, senza un programma da installare su ogni PC: entri una volta con utente e password e lavori dal browser.
• Ogni tabella si lavora da sola: ordini, filtri, raggruppi, aggiungi una colonna calcolata, salvi il tuo modo di vederla.
• Stampa e analisi su ogni tabella: due pulsanti sempre nello stesso posto, senza chiedere un report a nessuno.

Nota. Le due versioni convivono. Una riga scritta da SIGEAnext la vede anche l'ERP legacy/COBOL, e viceversa, perché l'archivio è uno solo.

Per chi sviluppa. Il servizio è backend/business-logic/it_gsba_sigea_next (porta 5081). Le pagine sono in frontend/sigea-next/src, la cornice (menu, barra in alto, home) in frontend/shell/src. L'archivio è SIGEA2, lo stesso del server COBOL.

JD1 - A cosa serve

JD1.2 - I dodici moduli

In una frase. SIGEAnext è diviso in dodici moduli, gli stessi del gestionale: ecco quali sono e cosa c'è dentro oggi.

Un modulo è un'area del gestionale: acquisti, vendite, contabilità. I nomi e le sigle sono quelli che conosci dal legacy, così ritrovi le cose dove le cercavi. Ogni modulo ha la sua tessera nella home, la sua icona e il suo menu.

I sette moduli di amministrazione e finanza

I sette moduli di amministrazione e finanza

I cinque moduli operativi e dei servizi

I cinque moduli operativi e dei servizi

I moduli non sono tutti allo stesso punto. Le funzioni si riscrivono una alla volta e oggi la situazione è questa.

Modulo Cosa si apre oggi
E25 Ciclo Passivo Mezzi della flotta, tipi mezzo, porti, regioni, province, comuni, ordini clienti e righe, testata ordini, interrogazione dei movimenti pallet
EE0 Gestione Servizi Utenti e password, ruoli e permessi, controllo dell'installazione
E28 Magazzino Una sola funzione, non trattata in questo libro
Gli altri nove Il menu con l'elenco delle funzioni previste. Le pagine sono ancora da scrivere

Negli altri nove moduli (E10, E20, EA5, E21, E22, E23, E24, E26, E27) le voci del menu ci sono già, ma aprono una pagina vuota. Fino a quando una funzione non è riscritta, si usa quella storica.

Nota. Nella pagina di un modulo, i numeri in alto (per esempio «Ordini» o «Fornitori») oggi sono di esempio: non vengono ancora contati dai dati.

Per chi sviluppa. L'elenco dei moduli è in config/modules.json, il menu di ciascuno in config/modules/ (un file per sigla, per esempio config/modules/E25.json). Una voce che punta a /pages/empty è una funzione non ancora scritta. Le icone sono in frontend/core/src/assets/icons/modules/new/. Nella stessa home compaiono anche le tessere degli altri componenti (ADEnext, GPEnext, SBHweb): non sono moduli dell'ERP.

JD1 - A cosa serve

JD1.3 - Dove sta nella mappa

In una frase. SIGEAnext sta in mezzo: tra le pagine che usi nel browser e i dati dell'azienda.

Sapere dove sta aiuta a capire cosa succede quando una pagina non risponde: il problema può essere nella pagina, nel servizio o nell'archivio.

La mappa di ADSWnext con accese le tre tessere di SIGEAnext: le pagine nuove, l'ERP nuovo e i dati aziendali

La mappa di ADSWnext con accese le tre tessere di SIGEAnext: le pagine nuove, l'ERP nuovo e i dati aziendali

SIGEAnext è fatto di due parti. Le pagine nuove sono quello che vedi: menu, form, tabelle. L'ERP nuovo è il servizio che lavora dietro: riceve le richieste, legge e scrive i dati, fa i calcoli.

Per chi sviluppa. Le pagine chiamano /api/sigea/...: il prefisso lo aggiunge il Gateway (backend/middleware/it_gsba_api_gateway), i controller del servizio non lo scrivono. Il servizio si registra nel Monitor servizi come SIGEA-NEXT-SERVICE. Form e tabelle delle pagine sono letti per nome da ADEnext (backend/middleware/it_gsba_ade_next).

JD2 - Muoversi

JD2 - Muoversi

JD2.1 - La home dei moduli

In una frase. Dalla home scegli il modulo; dal modulo arrivi alla funzione in due passaggi.

La home è la prima pagina dopo l'accesso. Non devi ricordare codici o percorsi: ogni modulo è una tessera, con icona, sigla, nome e una riga che dice a cosa serve.

Dalla home alla funzione: scegli il modulo, apri la gestione, apri la funzione

Dalla home alla funzione: scegli il modulo, apri la gestione, apri la funzione

  1. Scegli il modulo. Nella home premi la tessera del modulo, per esempio E25 Ciclo Passivo. Se sotto le tessere c'è il riquadro Accessi rapidi, da lì apri subito le pagine più usate.

    La home: una tessera per modulo, con icona, sigla, nome e a cosa serve

    La home: una tessera per modulo, con icona, sigla, nome e a cosa serve

  2. Guarda la pagina del modulo. In alto ci sono le Azioni rapide: le funzioni che servono più spesso. Sotto ci sono le Gestioni: ogni riquadro raccoglie le funzioni di un argomento e dice quante sono.

    La pagina del modulo E25 Ciclo Passivo: i numeri e i grafici in alto, le azioni rapide, le gestioni. I numeri e i grafici sono di esempio

    La pagina del modulo E25 Ciclo Passivo: i numeri e i grafici in alto, le azioni rapide, le gestioni. I numeri e i grafici sono di esempio

  3. Apri la gestione. Premi sul riquadro per vedere le sue funzioni, divise in Configurazioni, Operazioni e Report. Con Apri gestione entri nella sua pagina.

  4. Apri la funzione. Premi il nome della funzione. In alto, il percorso dice sempre dove sei: ogni pezzo si può premere per tornare indietro.

    Il percorso in alto: Home, modulo, gestione, funzione

    Il percorso in alto: Home, modulo, gestione, funzione

  5. Cambia modulo senza tornare alla home. Dentro un modulo, in alto a sinistra, il pulsante Tutti i moduli apre l'elenco delle tessere sopra la pagina.

Nota. Se la home dice «Impossibile caricare i moduli», premi Riprova: di solito un servizio si sta riavviando.

Per chi sviluppa. La home è frontend/shell/src/pages/dashboard/modules-home, la pagina del modulo frontend/shell/src/pages/dashboard/module-dashboard. Tessere, azioni rapide e gestioni vengono dai file in config/modules/.

Per approfondire.
• Menu Ad Albero Enterprise - ADSW-NEXT: docs/guide/sviluppo/GUIDA-MENU-AD-ALBERO.md

JD2 - Muoversi

JD2.2 - Menu, ricerca e preferiti

In una frase. Il menu a sinistra porta a ogni funzione del modulo: la cerchi per nome e tieni a portata di mano quelle di tutti i giorni.

Un modulo può avere decine di funzioni, su più livelli. Scendere ogni volta lo stesso ramo fa perdere tempo: la ricerca e i preferiti servono a non farlo.

  1. Apri il menu. Dentro un modulo il menu è a sinistra. Si apre a rami: categoria, gestione, funzione. La striscia di icone sul bordo apre la pagina del modulo e le sue gestioni. Il pulsante Menu, in alto, lo nasconde quando ti serve spazio.

    Il menu del modulo E25 Ciclo Passivo: la ricerca in alto, i rami aperti fino alla funzione

    Il menu del modulo E25 Ciclo Passivo: la ricerca in alto, i rami aperti fino alla funzione

  2. Cerca una funzione. Scrivi nella casella Cerca una funzione…. Al posto dei rami compare un elenco: ogni riga ha il nome della funzione e, sotto, il percorso per arrivarci. Così distingui due voci con lo stesso nome. Se non c'è niente leggi «Nessuna funzione trovata.».

    La ricerca nel menu: due funzioni trovate, ognuna con il suo percorso

    La ricerca nel menu: due funzioni trovate, ognuna con il suo percorso

  3. Segna un preferito. Passa sulla voce di una funzione e premi la stella. La funzione entra nell'elenco Preferiti, in fondo al menu. Un altro clic sulla stella la toglie.

    Due funzioni con la stella piena nel menu, e in fondo l'elenco Preferiti aperto

    Due funzioni con la stella piena nel menu, e in fondo l'elenco Preferiti aperto

  4. Riapri una funzione recente. Sempre in fondo, Recenti tiene le ultime otto funzioni che hai aperto, la più recente in cima. Con svuota riparti da zero. Preferiti e Recenti si aprono uno alla volta: aprendone uno, l'altro si chiude.

    L'elenco Recenti aperto, con il comando svuota

    L'elenco Recenti aperto, con il comando svuota

Nota. Preferiti e recenti sono salvati nel browser che stai usando. Su un altro computer, o in un altro browser, li trovi vuoti.

Per chi sviluppa. Il menu è frontend/shell/src/layout/components/app.menu.ts; preferiti e recenti sono in frontend/shell/src/layout/services/menu-favorites.service.ts e stanno nel localStorage. La casella «Cerca nel sistema» della barra in alto oggi è solo disegnata: non restituisce risultati.

Per approfondire.
• Menu Ad Albero Enterprise - ADSW-NEXT: docs/guide/sviluppo/GUIDA-MENU-AD-ALBERO.md

JD2 - Muoversi

JD2.3 - Personalizzare aspetto e densità

In una frase. Dal pannello Personalizzazione scegli colori, grandezza dei caratteri e quante righe stanno nello schermo.

Chi guarda tabelle tutto il giorno vuole tante righe. Chi ha uno schermo piccolo o fatica a leggere vuole caratteri più grandi. Ognuno regola il suo, senza cambiare niente agli altri.

  1. Apri il pannello. In alto a destra premi il pulsante Personalizzazione, quello con i cursori. Il pannello si apre di lato e la pagina resta visibile: ogni scelta si vede subito.

    Il pannello Personalizzazione aperto sulla destra, alla sezione Aspetto

    Il pannello Personalizzazione aperto sulla destra, alla sezione Aspetto

  2. Scegli chiaro o scuro. In Aspetto, alla voce Modalità, premi Chiaro o Scuro. Lo stesso cambio si fa con il pulsante del sole e della luna nella barra in alto. Alto contrasto rende testo e bordi più netti.

  3. Scegli la densità. In Layout, alla voce Densità interfaccia, scegli Compatta, Normale o Spaziosa. Compatta mostra più righe; Spaziosa lascia più aria.

  4. Regola i caratteri. In Tipografia scegli il Carattere e la Scala carattere, dal 70 al 150 per cento.

  5. Rifinisci le tabelle. Sempre in Layout: Righe zebrate alterna il colore delle righe, Header tabelle maiuscolo scrive le intestazioni in maiuscolo.

  6. Metti il logo dell'azienda. In Branding, con Carica logo, il logo compare nella barra in alto, accanto a quello di SIGEAnext.

  7. Torna com'era. In Avanzate, Ripristina predefiniti annulla tutte le scelte. Esporta impostazioni e Importa impostazioni le portano su un altro computer.

Nota. Le scelte sono salvate nel browser che stai usando. Per ritrovarle altrove usa Esporta e Importa.

Per chi sviluppa. Il pannello è frontend/shell/src/layout/components/app.configurator.ts; le scelte passano da frontend/shell/src/layout/services/layout.service.ts, che le salva nel localStorage.

JD3 - Lavorare con le tabelle

JD3 - Lavorare con le tabelle

JD3.1 - La griglia: ordinare, filtrare, raggruppare

In una frase. Ogni tabella di SIGEAnext si ordina, si filtra e si raggruppa da sola, senza passare da Excel.

La tabella è la stessa in tutte le pagine: quello che impari su una vale per tutte. Le risposte che prima chiedevano un'esportazione, per esempio «quanti sono per categoria» o «quali superano una soglia», si ottengono sul posto.

  1. Ordina. Premi l'intestazione di una colonna: le righe si ordinano. Un secondo clic inverte l'ordine, il terzo lo toglie. Tenendo premuto Ctrl ordini per più colonne: un numerino dice quale viene prima.

    Una tabella ordinata per due colonne: prima la categoria, poi l'importo. Pagina di prova con dati finti

    Una tabella ordinata per due colonne: prima la categoria, poi l'importo. Pagina di prova con dati finti

  2. Cerca. Scrivi nella casella Cerca…, in alto a sinistra della tabella. Restano le righe che contengono quel testo.

  3. Filtra una colonna. Premi l'imbuto nell'intestazione e scegli la condizione: contiene, inizia per, uguale, vuoto. Per date e numeri le condizioni sono quelle adatte. In alto a destra il contatore dice quante righe vedi sul totale, per esempio «5 di 106 righe».

    La stessa tabella con un filtro: il contatore dice quante righe restano sul totale. Pagina di prova con dati finti

    La stessa tabella con un filtro: il contatore dice quante righe restano sul totale. Pagina di prova con dati finti

  4. Raggruppa. Apri il pannello dell'analisi avanzata dalla barra della tabella e scegli un campo. Le righe si raccolgono sotto il loro gruppo, ognuno con il conteggio e i suoi totali.

    Le righe raggruppate per categoria, ogni gruppo con conteggio e totali. Pagina di prova con dati finti

    Le righe raggruppate per categoria, ogni gruppo con conteggio e totali. Pagina di prova con dati finti

  5. Torna com'era. Quando c'è un filtro o un gruppo, nella barra compare un pulsante che li toglie tutti insieme.

Cosa ci guadagni.
• In fondo alla tabella ci sono già somme e medie, nel formato della colonna.
• Selezioni alcune celle e leggi subito somma, media e conteggio della selezione.
• Le colonne si allargano e si spostano trascinando: l'ordine che scegli resta.

Nota. Se la tabella carica i dati a pagine, ordinamento e filtri vengono chiesti al servizio e valgono per tutte le righe, non solo per quelle a schermo.

Per chi sviluppa. La griglia è una sola per tutta l'app: frontend/core/src/grid. Le tabelle disegnate la usano attraverso il componente app-dynamic-table di ADEnext.

Per approfondire.
• La tabella — una sola griglia, e cosa sa fare: docs/guide/tabella/griglia/README.md

JD3 - Lavorare con le tabelle

JD3.2 - Viste e colonne calcolate

In una frase. Una vista ricorda come vuoi vedere una tabella; una colonna calcolata aggiunge un valore che nei dati non c'è.

Senza le viste, ogni mattina rimetti gli stessi filtri e lo stesso ordine. Con una vista lo fai una volta, le dai un nome e la ritrovi. La colonna calcolata evita il passaggio in Excel per un margine, una percentuale o i giorni fra due date.

  1. Apri il menu delle viste. A sinistra nella barra della tabella c'è un pulsante con il nome della vista in uso. All'inizio è Standard: la tabella come la manda il programma.

    Il menu delle viste aperto: Standard, Salva come, Colonne calcolate, Formattazione condizionale. Pagina di prova con dati finti

    Il menu delle viste aperto: Standard, Salva come, Colonne calcolate, Formattazione condizionale. Pagina di prova con dati finti

  2. Sistema la tabella e salva. Metti filtri, ordine, gruppi e colonne come ti servono, poi scegli Salva come… e scrivi un nome. Decidi anche chi la vede: Solo mia, Del ruolo o Aziendale. Le ultime due sono per chi ha il permesso di pubblicare.

  3. Falla aprire da sola. Premi la stella accanto al nome: la vista diventa la predefinita e si apre con la tabella.

  4. Aggiungi una colonna calcolata. Dal menu delle viste scegli Colonne calcolate…, oppure premi il tasto destro su un'intestazione. Scegli un modello, per esempio Differenza A − B o Giorni fra due date, e indica i campi. L'anteprima mostra il risultato sulle prime righe.

    La finestra della vista alla voce Calcolate: i modelli pronti e, a sinistra, la colonna «Margine» già creata

    La finestra della vista alla voce Calcolate: i modelli pronti e, a sinistra, la colonna «Margine» già creata

  5. Usala come le altre. La colonna nuova ha il segno «fx» nell'intestazione. Si ordina, si filtra, entra nei totali e nell'esportazione.

Cosa ci guadagni.
• Le viste stanno sul server: le ritrovi su un altro computer, senza fare niente.
• Una vista del ruolo o aziendale mette tutti i colleghi sulla stessa tabella.
• Con Formattazione condizionale… le celle che contano si colorano da sole.

Nota. Una colonna calcolata è solo un modo di guardare: non scrive niente nei dati dell'azienda.

Per chi sviluppa. Le viste delle pagine di SIGEAnext sono servite dal servizio stesso (backend/business-logic/it_gsba_sigea_next, pacchetto grid_views). Se l'archivio delle viste non risponde, la tabella continua a lavorare con le viste del browser e lo segnala.

Per approfondire.
• Griglie: viste, colonne calcolate, formattazione condizionale: docs/guide/moduli/griglie-viste-calcolate-formati/README.md

JD3 - Lavorare con le tabelle

JD3.3 - Esportare in Excel e PDF

In una frase. Da ogni tabella scarichi un file Excel, CSV o PDF, oppure stampi con un modello impaginato.

Non serve chiedere una stampa nuova a chi sviluppa. Scegli tu le colonne e le righe, e il file esce con i valori come li vedi a schermo: date, importi e decimali già formattati.

  1. Apri la finestra. In fondo alla barra della tabella premi una delle icone CSV, Excel o PDF. Si apre sempre la stessa finestra, Esporta e stampa, con il formato già scelto.

  2. Scegli titolo e colonne. Il titolo diventa il nome del file. Spunta le colonne che vuoi e trascinale per cambiare l'ordine. Con Tutte e Nessuna fai prima.

    La finestra «Esporta e stampa»: formato Excel, quattro colonne scelte su undici. Pagina di prova con dati finti

    La finestra «Esporta e stampa»: formato Excel, quattro colonne scelte su undici. Pagina di prova con dati finti

  3. Scegli le righe. Tutte, Filtrate (se c'è un filtro) o Selezionate (le righe spuntate).

  4. Esporta. Premi il pulsante in basso: il file si scarica.

  5. Stampa con un modello. Scegli il formato di stampa, che a schermo si chiama GPE-NEXT. La finestra elenca i modelli adatti a questi dati: scegline uno e premi Stampa. Il PDF si apre in un'altra scheda. Se il modello non c'è, scrivi un nome in Nuovo modello e premi Crea e apri il designer: nasce un documento già impaginato, con intestazione, tabella e totali.

    La stessa finestra sul formato di stampa: i modelli per questi dati e il nome del modello nuovo. Pagina di prova con dati finti

    La stessa finestra sul formato di stampa: i modelli per questi dati e il nome del modello nuovo. Pagina di prova con dati finti

Cosa ci guadagni.
• Le colonne scelte valgono sia per il file sia per il modello nuovo.
• Il PDF semplice va bene per un elenco al volo. Il modello serve quando il documento va consegnato.
• Lo stesso modello stampa domani gli stessi dati aggiornati: non lo rifai.

Nota. Se il formato di stampa è grigio, il servizio delle stampe è spento o il tuo ruolo non basta: la finestra dice quale dei due. Per creare un modello serve un livello più alto che per stampare. Per i modelli vedi il libro JK - GPEnext.

Per chi sviluppa. La finestra è un componente unico in frontend/core/src, usato dalla barra di ogni griglia e dalla barra delle azioni della pagina (frontend/shell/src/layout/components/app.actionbar.ts).

Per approfondire.
• Esportare e stampare da una griglia: docs/guide/tabella/esporta-e-stampa/README.md
• La tabella — una sola griglia, e cosa sa fare: docs/guide/tabella/griglia/README.md
• Creare un documento dai tuoi dati: docs/guide/gpe-next/cliente/13-documenti-dai-tuoi-dati.md

JD4 - Un esempio completo

JD4 - Un esempio completo

JD4.1 - Mezzi della flotta: dalla ricerca agli avvisi

In una frase. Un giro completo su una funzione vera: cerchi i mezzi della flotta e vedi quali hanno una scadenza vicina.

Bollo, revisione, assicurazione, tagliando, chilometri del contratto: sono date e numeri che nessuno tiene a mente. Questa funzione li controlla per te. Tu dici con quanti giorni di anticipo vuoi saperlo.

  1. Apri la funzione. Nel modulo E25 Ciclo Passivo apri Flotta Mezzi, poi Gestione Mezzi Flotta, poi Anagrafica Mezzi Flotta e infine Inquiry mezzi flotta. La trovi anche fra le azioni rapide del modulo, come Anagrafica Mezzi.

  2. Imposta i filtri. In alto scegli cosa cercare: Ditta, Spedizioniere, Fornitore, Targa, Stato. In Gg. Preavviso scrivi con quanti giorni di anticipo vuoi l'avviso. In Alert scegli Tutti, Con problemi, Con alert oppure Alert + Problemi.

    La funzione appena aperta: i filtri in alto, la tabella dei mezzi sotto, ancora vuota

    La funzione appena aperta: i filtri in alto, la tabella dei mezzi sotto, ancora vuota

  3. Conferma. Premi Convalida. La tabella si riempie: targa, spedizioniere, contratto, chilometri iniziali e percorsi. I chilometri percorsi oltre i centomila si colorano di rosso. Reset svuota i filtri.

  4. Leggi gli avvisi. Per ogni mezzo il servizio confronta le scadenze con la data di oggi. Una scadenza passata, o mancante, è un problema. Una scadenza che cade entro i giorni di preavviso è un avviso.

  5. Lavora la tabella. Ordina per targa, filtra un fornitore, salva la vista: vale tutto quello che hai letto nel capitolo sulle tabelle.

  6. Analizza o stampa. I due pulsanti nella barra della tabella aprono un cruscotto con numeri e grafici sui mezzi trovati, oppure la finestra di stampa. Per il cruscotto vedi il libro JF - Analytics, pagina «JF6.1 - Mezzi della flotta: chilometri e scadenze».

Chi lavora quando premi Convalida: la richiesta passa dal Gateway, l'ERP nuovo legge i dati e calcola gli avvisi

Chi lavora quando premi Convalida: la richiesta passa dal Gateway, l'ERP nuovo legge i dati e calcola gli avvisi

Nota. Alcune parti sono ancora da completare. Il pulsante Stampa accanto ai filtri non produce ancora un documento: per stampare usa quello della tabella. L'invio per posta degli avvisi e i due report PDF (scadenze e chilometri) del programma legacy non sono ancora riscritti. La pagina di modifica del singolo mezzo non c'è ancora. Nello stesso menu, Tipi Mezzo è la tabella dei tipi.

Per chi sviluppa. Pagina: frontend/sigea-next/src/modules/ciclo-passivo/gestione-mezzi-flotta/components/anagrafica-mezzi-flotta. Servizio: pacchetto gestione_mezzi_flotta di backend/business-logic/it_gsba_sigea_next, chiamata inquiry-alert. La logica viene dal programma COBOL RFAMEZ2D. Form e tabella sono disegnati in ADEnext. Esiste una seconda pagina, «Inquiry / Alert Mezzi Flotta», non ancora nel menu.

JD5 - Per chi sviluppa

JD5 - Per chi sviluppa

JD5.1 - Come nasce una funzione nuova

In una frase. Una funzione nuova parte dalla tabella dei dati: la si descrive una volta, poi il codice si genera o la pagina si disegna.

Il lavoro ripetitivo non si scrive a mano. Così una funzione arriva prima, e tutte le pagine si somigliano: stessa tabella, stessi pulsanti, stesse regole.

Dalla tabella dei dati alla voce di menu: descrivi la tabella, generi o disegni, aggiungi la voce

Dalla tabella dei dati alla voce di menu: descrivi la tabella, generi o disegni, aggiungi la voce

  1. Descrivi la tabella. In ADEnext, nel registro delle tabelle, si controlla che la tabella dei dati aziendali sia descritta bene: campi, chiavi, nomi. Il registro è la fonte unica: se è incompleto, non si genera niente.

  2. Scegli la strada. La prima domanda è sempre se basta disegnare. Si scrive codice a mano solo quando il disegno non arriva.

  3. Genera, oppure disegna. Il generatore scrive il servizio e la pagina con elenco, inserimento, modifica e cancellazione. In alternativa form, tabella e interrogazione si disegnano in ADEnext e la pagina li mostra, senza codice nuovo.

  4. Aggiungi la voce al menu. La funzione compare quando ha una riga nel file del suo modulo: etichetta, icona e indirizzo della pagina.

  5. Prova. La pagina nuova ha già la tabella con filtri, viste, esportazione, analisi e stampa: non si aggiungono, ci sono.

Un esempio che si può guardare: nel modulo E25 Ciclo Passivo, l'interrogazione dei movimenti pallet c'è in due versioni, Inquiry (low-code) e Inquiry (a codice). Stesso risultato, due strade.

Nota. Il codice generato porta un segno di riconoscimento. Non si corregge a mano: si corregge il generatore e si rigenera.

Per chi sviluppa. Il segno è il marker ADE-GEN. Cosa il disegno sa fare e cosa no è scritto in docs/low-code/capabilities.md: si legge prima di decidere. Il servizio segue i livelli api, data, services dentro backend/business-logic/it_gsba_sigea_next; le pagine stanno in frontend/sigea-next/src/modules; il menu in config/modules/. Per ADEnext vedi il libro JE - ADEnext.

Per approfondire.
• Come aggiungere un nuovo record o una tabella: docs/guide/sviluppo/come-aggiungere-record-o-tabella.md
• Migrare una inquiry COBOL — esercitazione guidata: docs/guide/sviluppo/corso-migrare-una-inquiry-cobol.md

JD5 - Per chi sviluppa

JD5.2 - I dati: SIGEA2

In una frase. SIGEAnext non ha un archivio suo: legge e scrive i dati aziendali, gli stessi dell'ERP legacy/COBOL.

È la scelta che permette di passare al nuovo senza fermarsi. Non c'è una migrazione dei dati e non ci sono due copie da tenere allineate. Una funzione riscritta e la sua versione storica vedono le stesse righe.

SIGEAnext e l'ERP legacy/COBOL leggono e scrivono lo stesso archivio

SIGEAnext e l'ERP legacy/COBOL leggono e scrivono lo stesso archivio

Cosa c'è dentro. Clienti, fornitori, ordini, magazzino, mezzi: le tabelle del gestionale, con i nomi brevi che hanno sempre avuto. SIGEAnext li mantiene, così chi conosce il legacy li riconosce.

Cosa SIGEAnext non fa. Non cambia la struttura dell'archivio: non crea tabelle e non le modifica all'avvio. La struttura resta quella del gestionale.

Su quale motore. L'archivio può stare su MySQL o su Oracle. Il servizio parla con tutti e due: si sceglie all'installazione.

Cosa non sta qui. Il disegno di form e tabelle sta in un archivio a parte, quello di ADEnext. I modelli di stampa stanno in quello di GPEnext. Vedi il libro JL - Archivi.

Attenzione. SIGEA2 è l'archivio vero dell'azienda. Una prova fatta sull'ambiente sbagliato scrive dati veri. Per questo il servizio non parte se non gli si dice in modo esplicito a quale archivio collegarsi.

Per chi sviluppa. Collegamento: variabili SIGEA_DB_URL, SIGEA_DB_USER, SIGEA_DB_PASSWORD, senza valore predefinito (registro in docs/devops/ENVIRONMENT.md). I profili sono mysql e oracle, tutti e due con ddl-auto=none. Il servizio non ha migrazioni proprie. Le classi che descrivono le tabelle tengono i nomi COBOL (per esempio AMEZ per i mezzi). Il codice generato può leggere anche gli archivi ISAM del legacy, dal pacchetto shared/isam.

JD5 - Per chi sviluppa

JD5.3 - Se qualcosa non va

In una frase. I problemi più comuni in SIGEAnext, uno per riga: cosa vedi e cosa fare.

Quasi sempre il problema è piccolo: un servizio che si sta riavviando, un filtro dimenticato, un permesso che manca. Prima di chiamare qualcuno, cerca qui la riga che ti riguarda.

Vedo questo Faccio questo
«Impossibile caricare i moduli» o «Impossibile caricare il modulo» Premi Riprova. Se dopo qualche minuto non cambia, avvisa chi amministra
La voce di menu apre una pagina vuota La funzione non è ancora riscritta: usa quella storica
Nel menu manca un modulo o una funzione Il tuo ruolo non la prevede: chiedi a chi amministra i permessi
La tabella è vuota Controlla i filtri della pagina e conferma di nuovo. Guarda se la vista in uso ha un filtro
Mancano delle righe Cerca l'imbuto acceso su una colonna, o togli filtri e gruppi con il pulsante nella barra
Non trovo la mia vista su un altro computer L'archivio delle viste non era raggiungibile quando l'hai salvata. Riapri la tabella da dove l'hai creata
«Nessuna griglia o form con dati in questa pagina» Carica prima i dati nella tabella, poi premi di nuovo il pulsante
Il formato di stampa è grigio Il servizio delle stampe è spento o il tuo ruolo non basta: la finestra dice quale
Preferiti, recenti o colori sono spariti Sono salvati nel browser: hai cambiato browser o computer, o hai svuotato i suoi dati

Se il problema riguarda l'accesso, vedi il libro JB - Accesso e permessi. Se nessuna pagina risponde, vedi il libro JC - Gateway e Monitor servizi.

Parole da sapere

Per chi sviluppa. Per capire quale parte non risponde: le pagine sono in frontend/shell/src e frontend/sigea-next/src, il servizio è backend/business-logic/it_gsba_sigea_next (porta 5081), il menu viene da config/modules/.