# Impostazioni

Il menu **Impostazioni** raccoglie le maschere di configurazione del Portale Gestione Investimenti NIBOR: le **tabelle di base** (settori, mercati, voci di bilancio) e i **valori di bilancio** dei titoli.

> Sono i dati su cui si appoggiano la Dashboard e le pagine di analisi.

## Aprire il menu

1. Da qualsiasi pagina del portale cliccare il pulsante **⚙ Impostazioni** in alto a destra, accanto al nome dell'utente connesso.
2. Si apre un pannello sulla sinistra con tre voci.
3. Per chiuderlo senza scegliere nulla: cliccare fuori dal pannello o premere **Esc**.

<table id="bkmrk-voce-a-cosa-serve-ta"><thead><tr><th>Voce</th><th>A cosa serve</th></tr></thead><tbody><tr><td>**Tabelle**</td><td>Apre la maschera *Gestione Tabelle*: settori, mercati e voci di bilancio, con importazione da Excel.</td></tr><tr><td>**Valori di bilancio**</td><td>Apre la maschera *Valori di bilancio*: consultazione, inserimento, modifica ed importazione da Excel dei valori di ogni titolo.</td></tr><tr><td>**Impostazioni**</td><td>Voce predisposta per le impostazioni generali del portale. **Al momento non è attiva**: cliccandola il menu si chiude senza aprire nulla.</td></tr></tbody></table>

<p class="callout info">Le maschere si aprono in una finestra sopra la pagina corrente: chiudendole con la **×** in alto a destra (o con **Esc**) si torna esattamente dove si era.</p>

## Tabelle

La maschera **Gestione Tabelle** contiene tutti gli elenchi di base del portale. Ogni elenco è un **tipo tabella**; le righe di un elenco si chiamano **voci**.

### Tipi tabella

<table id="bkmrk-tipo-tabella-contenu"><thead><tr><th>Tipo tabella</th><th>Contenuto</th><th>Dove viene usato</th></tr></thead><tbody><tr><td>**SETTORE**</td><td>Settori economici (es. *Energia*).</td><td>Campo *Settore* della scheda titolo; card di riepilogo della Dashboard.</td></tr><tr><td>**MERCATO**</td><td>Mercati di quotazione (es. *NASDAQ*).</td><td>Campo *Mercato* della scheda titolo; card *Mercati coperti*.</td></tr><tr><td>**STATO\_PATRIMONIALE**</td><td>Voci dello Stato Patrimoniale (es. *Cassa ed equivalenti*).</td><td>Righe del prospetto *Stato Patrimoniale* nell'analisi del titolo; maschera *Valori di bilancio*.</td></tr><tr><td>**CONTO\_ECONOMICO**</td><td>Voci del Conto Economico.</td><td>Analisi del titolo; maschera *Valori di bilancio*.</td></tr><tr><td>**INDICI\_DI\_BILANCIO**</td><td>Voci degli indici di bilancio.</td><td>Predisposto per l'analisi del titolo.</td></tr></tbody></table>

<p class="callout warning">Nell'elenco dei tipi compare anche **ND** (non definito): è un valore tecnico e **non va usato**. L'importazione da Excel su ND viene rifiutata.</p>

### Consultare un elenco

1. Aprire **⚙ Impostazioni → Tabelle**.
2. Scegliere il **Tipo tabella** nel menu in alto a sinistra (all'apertura è selezionato *SETTORE*).
3. La griglia mostra solo le voci di quel tipo. Se le voci sono molte, la griglia scorre al suo interno mentre il selettore resta fermo in alto.

Ordinamento delle voci:

- **SETTORE** e **MERCATO**: in ordine alfabetico di descrizione;
- **STATO\_PATRIMONIALE**, **CONTO\_ECONOMICO** e **INDICI\_DI\_BILANCIO**: secondo la colonna **Ordinamento**, cioè lo stesso ordine con cui le voci compaiono nei prospetti di bilancio.

Cliccando sull'intestazione di una colonna si può riordinare temporaneamente la griglia.

### Colonne di una voce

<table id="bkmrk-colonna-significato-"><thead><tr><th>Colonna</th><th>Significato</th></tr></thead><tbody><tr><td>**Codice**</td><td>Codice identificativo della voce all'interno del suo tipo tabella. È la chiave usata dall'importazione da Excel per riconoscere le voci già presenti.</td></tr><tr><td>**Descrizione**</td><td>Testo mostrato nel portale (negli elenchi a discesa, nei prospetti, nelle card).</td></tr><tr><td>**Descrizione 2** / **Descrizione 3**</td><td>Descrizioni aggiuntive facoltative (es. una dicitura alternativa o una nota).</td></tr><tr><td>**Valore** / **Ordinamento**</td><td>Per settori e mercati si chiama *Valore* ed è un numero libero. Per le voci di bilancio si chiama *Ordinamento* e stabilisce la **posizione della voce nel prospetto** (1 = prima riga).</td></tr><tr><td>**Predefinito**</td><td>Indicatore per segnare la voce proposta di default. Al momento è solo informativo.</td></tr><tr><td>**Disabilitato**</td><td>Indicatore per segnare una voce non più in uso. Al momento è solo informativo: la voce resta comunque visibile negli elenchi.</td></tr></tbody></table>

### Aggiungere una voce

1. Selezionare il **Tipo tabella** in cui aggiungere la voce.
2. Cliccare il **⊕** nell'intestazione della prima colonna della griglia.
3. Compilare la finestra **Voce di tabella** (Codice, Descrizione, Descrizione 2, Descrizione 3, Valore/Ordinamento, Predefinito, Disabilitato).
4. Salvare.

La voce viene salvata automaticamente nel tipo tabella selezionato: il tipo non si sceglie nel form.

### Modificare una voce

1. Cliccare la **matita** sulla riga della voce.
2. Modificare i campi nella finestra **Voce di tabella**.
3. Salvare: la griglia si aggiorna subito.

<p class="callout info">Per spostare una voce di bilancio in un'altra posizione del prospetto basta cambiarne l'**Ordinamento**. Conviene numerare le voci lasciando qualche spazio (10, 20, 30…) per poterne inserire di nuove in mezzo senza rinumerare tutto.</p>

### Eliminare una voce

1. Cliccare il **cestino** sulla riga della voce.
2. Confermare l'eliminazione.

<p class="callout warning">L'eliminazione è **logica**: la voce sparisce dagli elenchi ma resta nel database, così i titoli e i valori che la usano non perdono il collegamento. Se in seguito si importa da Excel una voce con lo **stesso codice**, la voce eliminata viene **ripristinata** e aggiornata invece di crearne una doppia.</p>

### Importare le voci da Excel

Il pulsante **Importa da Excel**, in alto a destra, carica in un colpo solo un elenco di voci nel tipo tabella selezionato.

#### Preparare il file

- Formato **.xls** o **.xlsx**, dimensione massima 10 MB.
- Viene letto solo il **primo foglio**.
- La **prima riga** contiene le intestazioni, **uguali a quelle della griglia**: `Codice`, `Descrizione`, `Descrizione2`, `Descrizione3`, `Valore` (oppure `Ordinamento`), `Predefinito`, ` Disabilitato`.
- Le colonne possono essere in **qualsiasi ordine**; maiuscole e spazi nelle intestazioni non contano.
- Solo **Codice** è obbligatoria. Le colonne che non servono si possono omettere.
- Nelle colonne *Predefinito* e *Disabilitato* si può scrivere *Sì/No*, *Vero/Falso*, *1/0* oppure *X*; una cella vuota vale *No*.
- I numeri possono essere scritti anche come testo in formato italiano (es. *2,5*).

Esempio per le voci dello Stato Patrimoniale:

<table id="bkmrk-codice-descrizione-o"><thead><tr><th>Codice</th><th>Descrizione</th><th>Ordinamento</th></tr></thead><tbody><tr><td>1</td><td>Cassa ed equivalenti</td><td>1</td></tr><tr><td>2</td><td>Titoli commerciabili</td><td>2</td></tr><tr><td>3</td><td>Contanti, equivalenti e investimenti</td><td>3</td></tr></tbody></table>

#### Eseguire l'importazione

1. Selezionare il **Tipo tabella** di destinazione.
2. Cliccare **Importa da Excel** e scegliere il file.
3. L'importazione parte subito; al termine compare un **riepilogo** sopra la griglia.

#### Come vengono trattate le righe

<table id="bkmrk-situazione-risultato"><thead><tr><th>Situazione</th><th>Risultato</th></tr></thead><tbody><tr><td>Il **codice esiste già** nel tipo tabella</td><td>La voce viene **aggiornata** (non ne viene creata una nuova).</td></tr><tr><td>Il **codice è nuovo**</td><td>Viene **creata** una nuova voce. In questo caso la colonna *Descrizione* è necessaria.</td></tr><tr><td>Colonna **assente** dal file</td><td>Il dato corrispondente delle voci esistenti **non viene toccato**.</td></tr><tr><td>Colonna presente ma **cella vuota**</td><td>Il dato viene **svuotato**, come se lo si cancellasse in griglia (la Descrizione invece non può essere svuotata).</td></tr><tr><td>Codice mancante, numero o Sì/No non valido</td><td>La riga viene **scartata**.</td></tr><tr><td>Stesso codice ripetuto nel file</td><td>Vale la **prima** riga, le successive vengono scartate.</td></tr><tr><td>Righe completamente vuote</td><td>Ignorate.</td></tr></tbody></table>

Il riepilogo indica quante voci sono state **create**, **aggiornate** e **scartate**, con il numero di riga Excel e il motivo di ogni scarto. Il riquadro è **verde** se tutto è andato a buon fine, **arancione** se ci sono righe scartate.

<p class="callout warning">Se un'intestazione del file non corrisponde a nessuna colonna della griglia (ad esempio per un errore di battitura come *Descrzione*), l'importazione **si ferma** senza salvare nulla e il messaggio indica quali intestazioni sono ammesse. È una protezione per evitare che un dato finisca nel campo sbagliato.</p>

<p class="callout info">Le righe valide vengono salvate tutte insieme: se il salvataggio non riesce, non viene salvata nessuna riga e il file può essere reimportato dopo la correzione.</p>

## Valori Titolo

La maschera **Valori Titolo** contiene i valori numerici delle voci di bilancio per ogni titolo e per ogni data. Sono i dati mostrati nei prospetti della pagina *Analisi*.

Ogni valore è identificato da tre elementi: **titolo**, **voce** e **data**. Per la stessa combinazione può esistere un solo valore.

<p class="callout info">Le voci di bilancio sono **comuni a tutti i titoli**: si definiscono una volta in *Tabelle* (tipi STATO\_PATRIMONIALE, CONTO\_ECONOMICO e INDICI\_DI\_BILANCIO) e valgono per ogni titolo.</p>

### Filtri

In testa alla maschera ci sono cinque filtri. Ogni modifica aggiorna subito la griglia.

<table id="bkmrk-filtro-uso-titolo-mo"><thead><tr><th>Filtro</th><th>Uso</th></tr></thead><tbody><tr><td>**Titolo**</td><td>Mostra solo i valori di un titolo. Vuoto = *Tutti i titoli*. Si può scrivere parte del nome per cercarlo. **Necessario per l'importazione da Excel.**</td></tr><tr><td>**Tipo bilancio**</td><td>*STATO\_PATRIMONIALE*, *CONTO\_ECONOMICO* o *INDICI\_DI\_BILANCIO*. È sempre impostato; cambiandolo cambiano anche le voci disponibili. Consultazione, modifica e importazione funzionano allo stesso modo per tutti e tre.</td></tr><tr><td>**Voce**</td><td>Mostra solo i valori di una voce. Vuoto = *Tutte le voci*. Si può scrivere parte della descrizione per cercarla.</td></tr><tr><td>**Dal** / **Al**</td><td>Limitano il periodo. Le date sono comprese (la data *Al* include tutta la giornata).</td></tr></tbody></table>

Sotto i filtri è indicato quanti valori sono mostrati. Il pulsante **Azzera filtri** (visibile quando almeno un filtro è impostato) svuota titolo, voce e periodo.

I filtri restano impostati anche chiudendo e riaprendo la maschera, così si riprende il lavoro da dove lo si era lasciato.

### La griglia

<table id="bkmrk-colonna-contenuto-ti"><thead><tr><th>Colonna</th><th>Contenuto</th></tr></thead><tbody><tr><td>**Titolo**</td><td>Nome del titolo.</td></tr><tr><td>**Descrizione Voce**</td><td>Voce di bilancio.</td></tr><tr><td>**Data**</td><td>Data a cui si riferisce il valore (gg/mm/aaaa).</td></tr><tr><td>**Valore**</td><td>Importo, con fino a quattro decimali.</td></tr></tbody></table>

- L'elenco è ordinato per **titolo**, poi per **voce** nell'ordine del prospetto, poi dalla **data più recente**.
- Sotto le intestazioni c'è una **riga di ricerca**: scrivendo in una cella si filtra ulteriormente quella colonna (utile ad esempio per cercare un valore preciso).
- In fondo si sceglie quante righe mostrare per pagina (**20**, **50** o **100**) e si passa da una pagina all'altra.
- Se non ci sono valori per i filtri impostati compare *"Nessun valore trovato con i filtri impostati."*

### Inserire un valore

1. Impostare, se possibile, i filtri **Titolo** e **Voce**: il nuovo valore li riprende già compilati. Se è impostata la data **Al**, viene proposta quella; altrimenti la data di oggi.
2. Cliccare il **⊕** nell'intestazione della prima colonna: in cima alla griglia compare una riga modificabile.
3. Completare titolo, voce, data e valore direttamente nella riga.
4. Confermare con l'icona di salvataggio della riga (oppure annullare).

### Modificare un valore

1. Cercare il valore con i filtri o con la riga di ricerca.
2. Cliccare la **matita**: la riga diventa modificabile **direttamente nella griglia**.
3. Cambiare i campi necessari (anche titolo, voce o data) e confermare.

<p class="callout warning">Se per lo stesso **titolo**, **voce** e **data** esiste già un valore, il salvataggio viene rifiutato con il messaggio *"Esiste già un valore per questa voce al gg/mm/aaaa: modifica quello presente."* In questo caso si modifica il valore già esistente invece di inserirne uno nuovo.</p>

### Eliminare un valore

1. Cliccare il **cestino** sulla riga.
2. Confermare nella finestra di richiesta.

Come per le altre maschere, l'eliminazione è logica: il valore non è più visibile ma resta nel database.

### Importare i valori da Excel

Il pulsante **Importa da Excel** carica tutti i valori di un titolo da un file, ad esempio l'intero Stato Patrimoniale di un esercizio.

#### Preparare il file

- Formato **.xls** o **.xlsx**, dimensione massima 10 MB; viene letto solo il **primo foglio**.
- La prima riga contiene le intestazioni `Descrizione Voce`, `Data`, `Valore` (in qualsiasi ordine; è accettato anche `Voce` al posto di `Descrizione Voce`). Tutte e tre sono obbligatorie.
- **Descrizione Voce** deve corrispondere alla descrizione della voce in *Tabelle* (maiuscole e spazi iniziali/finali non contano).
- **Data** può essere una cella data di Excel o un testo nel formato *gg/mm/aaaa*.
- **Valore** può essere un numero o un testo in formato italiano (es. *1.234,56*).
- Il file **non contiene il titolo**: il titolo e il tipo di bilancio si scelgono nei filtri della maschera.

Esempio:

<table id="bkmrk-descrizione-voce-dat"><thead><tr><th>Descrizione Voce</th><th>Data</th><th>Valore</th></tr></thead><tbody><tr><td>Cassa ed equivalenti</td><td>31/12/2026</td><td>1,2345</td></tr><tr><td>Titoli commerciabili</td><td>31/12/2026</td><td>2,2345</td></tr><tr><td>Attività totali</td><td>31/12/2026</td><td>16,2345</td></tr></tbody></table>

#### Eseguire l'importazione

1. Nel filtro **Titolo** selezionare il titolo a cui appartengono i valori. Finché il titolo non è scelto il pulsante resta disattivato e un avviso lo ricorda.
2. Nel filtro **Tipo bilancio** selezionare il bilancio del file (es. *STATO\_PATRIMONIALE*).
3. Cliccare **Importa da Excel** e scegliere il file.
4. Al termine compare il riepilogo con titolo e tipo di bilancio usati, e la griglia si aggiorna.

#### Come vengono trattate le righe

<table id="bkmrk-situazione-risultato-1"><thead><tr><th>Situazione</th><th>Risultato</th></tr></thead><tbody><tr><td>Esiste già un valore per titolo, voce e data</td><td>Il valore viene **aggiornato**. Se era stato eliminato, viene ripristinato.</td></tr><tr><td>Non esiste un valore per titolo, voce e data</td><td>Viene **creato** un nuovo valore.</td></tr><tr><td>La voce non esiste nel tipo di bilancio scelto</td><td>Riga **scartata** (controllare la descrizione o il tipo di bilancio selezionato).</td></tr><tr><td>La stessa descrizione è usata da più voci</td><td>Riga **scartata**: non si può stabilire a quale voce appartenga. Correggere le descrizioni in *Tabelle*.</td></tr><tr><td>Data o valore mancante o non valido</td><td>Riga **scartata**.</td></tr><tr><td>Stessa voce e data ripetuta nel file</td><td>Vale la **prima** riga, le successive vengono scartate.</td></tr><tr><td>Righe completamente vuote</td><td>Ignorate.</td></tr></tbody></table>

Il riepilogo indica quanti valori sono stati **creati**, **aggiornati** e **scartati**, con il numero di riga Excel e il motivo di ogni scarto.

<p class="callout success">Reimportare lo stesso file è sicuro: i valori già presenti vengono aggiornati, non duplicati. È quindi il modo più rapido per correggere in blocco</p>

## Flusso consigliato per un nuovo titolo

1. **Tabelle**: verificare che esistano il **settore** e il **mercato** del titolo; se mancano, aggiungerli (tipi SETTORE e MERCATO).
2. **Tabelle**: verificare che le **voci di bilancio** siano complete e ordinate (tipi STATO\_PATRIMONIALE e CONTO\_ECONOMICO). Si fa una volta sola, valgono per tutti i titoli.
3. **Dashboard**: aggiungere il titolo con **+ Aggiungi Titolo**, scegliendo settore e mercato.
4. **Valori di bilancio**: selezionare il titolo e il tipo di bilancio e **importare il file Excel** dei valori (oppure inserirli a mano).
5. **Dashboard → Apri analisi**: controllare i prospetti del titolo.

## <span style="background-color: rgb(191, 237, 210);">Domande frequenti</span>

**Il pulsante "Importa da Excel" dei Valori di bilancio è grigio.**  
Non è stato scelto il titolo: selezionarlo nel filtro *Titolo*.

**L'importazione si ferma con "Intestazioni non riconosciute".**  
Una delle intestazioni della prima riga del file è scritta in modo diverso da quelle ammesse (spesso un errore di battitura). Il messaggio elenca le intestazioni corrette: correggere il file e reimportarlo.

**Nel riepilogo compare "la voce … non esiste in STATO\_PATRIMONIALE".**  
La descrizione nel file non corrisponde a nessuna voce di quel tipo di bilancio. Verificare di aver selezionato il tipo di bilancio corretto e che la descrizione sia scritta come in *Tabelle*.

**Non riesco a salvare un valore: "Esiste già un valore per questa voce…".**  
Per quel titolo, voce e data c'è già un valore: cercarlo con i filtri e modificarlo.

**Le voci compaiono nel prospetto in un ordine sbagliato.**  
Correggere la colonna **Ordinamento** delle voci in *Tabelle*, direttamente in griglia o reimportando il file delle voci.

**Ho eliminato una voce o un valore per errore.**  
Il dato non è perso (eliminazione logica). Una voce si ripristina reimportandola da Excel con lo stesso codice; un valore reimportandolo con stessa voce e data. In alternativa rivolgersi all'amministratore.