Personalizzazione

Campi e widget

Tipologie di campi disponibili per strutturare i modelli dati in Laundry ERP, con i relativi widget di visualizzazione.

Campi e widget

I campi strutturano i modelli di un database. Se immaginiamo un modello come una tabella o un foglio di calcolo, i campi sono le colonne in cui i dati vengono memorizzati nei record (cioe le righe). I campi definiscono anche il tipo di dato che contengono. Il modo in cui i dati vengono presentati e formattati nell'interfaccia utente e determinato dal loro widget.

Da un punto di vista tecnico, esistono 15 tipi di campo in Laundry ERP. Tuttavia, negli strumenti di personalizzazione sono disponibili 20 campi, poiche alcuni tipi sono disponibili piu volte con un widget predefinito diverso.

I Nuovi campi possono essere aggiunti solo nelle viste Modulo ed Elenco. Nelle altre viste e possibile aggiungere solo Campi esistenti (campi gia presenti sul modello).

Campi semplici

I campi semplici contengono valori di base, come testo, numeri, file, ecc.

I widget non predefiniti, quando disponibili, sono presentati come elenchi puntati o sotto-intestazioni di seguito.

Testo (`char`)

Il campo Testo viene utilizzato per testi brevi contenenti qualsiasi carattere. Viene visualizzata una singola riga di testo durante la compilazione del campo.

Badge: visualizza il valore all'interno di una forma arrotondata, simile a un'etichetta. Il valore non puo essere modificato dall'interfaccia, ma e possibile impostare un valore predefinito.
Copia negli Appunti: gli utenti possono copiare il valore facendo clic su un pulsante.
E-mail: il valore diventa un link mailto cliccabile.
Immagine: visualizza un'immagine tramite URL. Il valore non puo essere modificato manualmente, ma e possibile impostare un valore predefinito.
Questo funziona diversamente dalla selezione diretta del campo Immagine, poiche l'immagine non viene memorizzata in Laundry ERP quando si utilizza un campo Testo con il widget Immagine. Ad esempio, puo essere utile per risparmiare spazio su disco.
Telefono: il valore diventa un link tel cliccabile.
Spuntare Abilita SMS per aggiungere un'opzione per inviare un SMS direttamente da Laundry ERP accanto al campo.
URL: il valore diventa un URL cliccabile.

Testo multilinea (`text`)

Il campo Testo multilinea viene utilizzato per testi piu lunghi contenenti qualsiasi tipo di carattere. Vengono visualizzate due righe di testo nell'interfaccia durante la compilazione del campo.

Copia negli Appunti: gli utenti possono copiare il valore facendo clic su un pulsante.

Intero (`integer`)

Il campo Intero viene utilizzato per tutti i numeri interi (positivi, negativi o zero, senza decimali).

Grafico a torta percentuale: visualizza il valore all'interno di un cerchio percentuale, solitamente per un valore calcolato. Il valore non puo essere modificato dall'interfaccia, ma e possibile impostare un valore predefinito.
Barra di avanzamento: visualizza il valore accanto a una barra percentuale, solitamente per un valore calcolato. Il campo non puo essere modificato manualmente, ma e possibile impostare un valore predefinito.
Maniglia: visualizza un'icona di trascinamento per riordinare manualmente i record nella vista Elenco.

Decimale (`float`)

Il campo Decimale viene utilizzato per tutti i numeri decimali (positivi, negativi o zero, con decimali).

I numeri decimali vengono visualizzati con due cifre dopo la virgola nell'interfaccia, ma vengono memorizzati nel database con maggiore precisione.

Monetario: e simile all'uso del campo Monetario. Si consiglia di utilizzare quest'ultimo poiche offre piu funzionalita.
Percentuale: visualizza un carattere percentuale % dopo il valore.
Grafico a torta percentuale: visualizza il valore all'interno di un cerchio percentuale, solitamente per un valore calcolato. Il campo non puo essere modificato manualmente, ma e possibile impostare un valore predefinito.
Barra di avanzamento: visualizza il valore accanto a una barra percentuale, solitamente per un valore calcolato. Il campo non puo essere modificato manualmente, ma e possibile impostare un valore predefinito.
Ora: il valore deve seguire il formato hh:mm, con un massimo di 59 minuti.

Monetario (`monetary`)

Il campo Monetario viene utilizzato per tutti i valori monetari.

Quando si aggiunge un campo Monetario per la prima volta, viene richiesto di aggiungere un campo Valuta se non ne esiste gia uno sul modello. Laundry ERP propone di aggiungere il campo Valuta automaticamente. Una volta aggiunto, aggiungere nuovamente il campo Monetario.

Html (`html`)

Il campo Html viene utilizzato per aggiungere testo modificabile tramite l'editor HTML di Laundry ERP.

Testo multilinea: disabilita l'editor HTML per consentire la modifica diretta dell'HTML grezzo.

Data (`date`)

Il campo Data viene utilizzato per selezionare una data da un calendario.

Giorni rimanenti: viene visualizzato il numero di giorni rimanenti prima della data selezionata (es. Tra 5 giorni), basato sulla data corrente. Questo campo dovrebbe essere impostato come Sola lettura.

Data e Ora (`datetime`)

Il campo Data e Ora viene utilizzato per selezionare una data da un calendario e un orario da un orologio. L'orario corrente dell'utente viene utilizzato automaticamente se non viene impostato alcun orario.

Oltre alle proprieta generali, sono disponibili alcune proprieta specifiche per i campi Data e Ora che hanno il widget Data e Ora o Intervallo di date impostato.

Intervallo di date (`daterange`)

Il widget Intervallo di date viene utilizzato per visualizzare un periodo di tempo definito da una data di inizio e una data di fine su una singola riga. Un intervallo di date puo avere una data di inizio e fine obbligatoria, ad esempio per un evento di piu giorni, oppure consentire una data di inizio o fine facoltativa, ad esempio per un intervento di assistenza o un'attivita di progetto.

L'aggiunta di un intervallo di date richiede due campi: un campo Data e Ora con il widget Intervallo di date impostato e un altro campo selezionato come data di inizio o data di fine. Questo campo sottostante puo essere un campo Data o Data e Ora esistente, oppure uno creato appositamente.

Per aggiungere un intervallo di date:

Identificare un campo Data o Data e Ora esistente che puo essere utilizzato come campo di data di inizio/fine sottostante, oppure aggiungerne uno nuovo. Se l'intervallo di date:
- ha una data di inizio e di fine obbligatoria, questo campo puo essere la data di inizio o la data di fine; il risultato e lo stesso.
- consente una data di inizio o fine facoltativa, questo campo e rispettivamente la data di inizio o la data di fine.
Per evitare di visualizzare le stesse informazioni due volte, il campo di data di inizio/fine sottostante puo essere reso invisibile abilitando Invisibile o rimosso dalla vista facendo clic su Rimuovi dalla vista.
Aggiungere un campo Data e Ora e impostare il campo Widget su Intervallo di date.
Inserire un'Etichetta appropriata.
Selezionare il campo di data di inizio/fine sottostante dal menu a tendina Campo data di inizio o Campo data di fine, a seconda del caso.
Se l'intervallo di date deve avere una data di inizio e fine obbligatoria, abilitare Sempre intervallo.
Aggiornare le altre proprieta generali o proprieta specifiche per campi Data e Ora secondo necessita, quindi fare clic su Chiudi nell'angolo in alto a destra dello schermo.

Giorni rimanenti (`remaining_days`)

Il widget Giorni rimanenti visualizza il numero di giorni rimanenti prima della data selezionata (es. Tra 5 giorni), basato sulla data e ora corrente. Questo campo dovrebbe essere impostato come Sola lettura.

Casella di controllo (`boolean`)

Il campo Casella di controllo viene utilizzato quando un valore deve essere solo vero o falso, indicato dal segno di spunta o dalla casella vuota.

Pulsante: visualizza un pulsante radio. Il widget funziona senza passare alla modalita di modifica.
Interruttore: visualizza un pulsante a levetta. Il widget funziona senza passare alla modalita di modifica.

Selezione (`selection`)

Il campo Selezione viene utilizzato quando gli utenti devono selezionare un singolo valore da un gruppo di valori predefiniti.

Badge: visualizza il valore all'interno di una forma arrotondata, simile a un'etichetta. Il valore non puo essere modificato dall'interfaccia, ma e possibile impostare un valore predefinito.
Badges: visualizza tutti i valori selezionabili contemporaneamente all'interno di forme rettangolari, organizzate orizzontalmente.
Priorita: visualizza simboli a stella al posto dei valori, che possono essere utilizzati per indicare un livello di importanza o soddisfazione, ad esempio. Questo ha lo stesso effetto della selezione del campo Priorita.
Radio: visualizza tutti i valori selezionabili contemporaneamente come pulsanti radio.
Per impostazione predefinita, i pulsanti radio sono organizzati verticalmente. Abilitare Visualizzazione orizzontale per cambiare il modo in cui vengono visualizzati.
Barra di stato: visualizza tutti i valori selezionabili contemporaneamente come una barra di avanzamento a freccia.
Per impostazione predefinita, i valori sulla barra di stato sono selezionabili. Disabilitare Cliccabile per impedire la modifica del valore dall'interfaccia.

Priorita (`selection`)

Il campo Priorita viene utilizzato per visualizzare un sistema di valutazione a tre stelle, che puo essere utilizzato per indicare il livello di importanza o soddisfazione. Questo tipo di campo e un campo Selezione con il widget Priorita selezionato per impostazione predefinita e quattro valori di priorita predefiniti. Di conseguenza, i widget Badge, Badges, Radio e Selezione hanno gli stessi effetti descritti nella sezione Selezione.

Per modificare il numero di stelle disponibili aggiungendo o rimuovendo valori, fare clic su Modifica valori. Il primo valore equivale a 0 stelle (cioe quando non e stata effettuata alcuna selezione), quindi avere quattro valori produce un sistema di valutazione a tre stelle, ad esempio.

File (`binary`)

Il campo File viene utilizzato per caricare qualsiasi tipo di file o per firmare un modulo (widget Firma).

Immagine: gli utenti possono caricare un file immagine, che viene poi visualizzato nella vista Modulo. Questo ha lo stesso effetto dell'uso del campo Immagine.
Visualizzatore PDF: gli utenti possono caricare un file PDF, che puo essere consultato dalla vista Modulo.
Firma: gli utenti possono firmare elettronicamente il modulo. Questo ha lo stesso effetto della selezione del campo Firma.

Immagine (`binary`)

Il campo Immagine viene utilizzato per caricare un'immagine e visualizzarla nella vista Modulo. Questo tipo di campo e un campo File con il widget Immagine selezionato per impostazione predefinita. Di conseguenza, i widget File, Visualizzatore PDF e Firma hanno gli stessi effetti descritti nella sezione File.

Per modificare la dimensione di visualizzazione delle immagini caricate, selezionare Piccola, Media o Grande nell'opzione Dimensione.

Firma (`binary`)

Il campo Firma viene utilizzato per firmare elettronicamente il modulo. Questo tipo di campo e un campo File con il widget Firma selezionato per impostazione predefinita. Di conseguenza, i widget File, Immagine e Visualizzatore PDF hanno gli stessi effetti descritti nella sezione File.

Per offrire agli utenti l'opzione Auto quando devono disegnare la propria firma, selezionare uno dei campi Autocompletamento con disponibili (campi Testo, Many2One e Campo correlato presenti sul modello). La firma viene generata automaticamente utilizzando i dati del campo selezionato.

Campi relazionali

I campi relazionali vengono utilizzati per collegare e visualizzare i dati dai record di un altro modello.

I widget non predefiniti, quando disponibili, sono presentati come elenchi puntati di seguito.

Many2One (`many2one`)

Il campo Many2One viene utilizzato per collegare un altro record (da un altro modello) al record in fase di modifica. Il nome del record dall'altro modello viene quindi visualizzato sul record in fase di modifica.

Per impedire agli utenti di creare un nuovo record nel modello collegato, spuntare Disabilita creazione.
Per impedire agli utenti di aprire i record in una finestra pop-up, spuntare Disabilita apertura.
Per aiutare gli utenti a selezionare solo il record corretto, fare clic su Dominio per creare un filtro.
Per attivare la ricerca di un record collegato solo dopo che e stato inserito un numero minimo di caratteri, inserire il numero desiderato nel campo Ricerca anticipata. In situazioni con dataset di grandi dimensioni, questo puo migliorare sia la pertinenza della ricerca che le prestazioni. ::
Badge: visualizza il valore all'interno di una forma arrotondata, simile a un'etichetta. Il valore non puo essere modificato dall'interfaccia.
Radio: visualizza tutti i valori selezionabili contemporaneamente come pulsanti radio.

One2Many (`one2many`)

Il campo One2Many viene utilizzato per visualizzare le relazioni esistenti tra un record del modello corrente e piu record di un altro modello.

Per utilizzare un campo One2Many, i due modelli devono essere gia stati collegati tramite un campo Many2One. Le relazioni One2Many non esistono in modo indipendente: viene eseguita una ricerca inversa delle relazioni Many2One esistenti.

Righe (`one2many`)

Il campo Righe viene utilizzato per creare una tabella con righe e colonne (ad esempio le righe dei prodotti in un ordine di vendita).

Per modificare le colonne, fare clic sul campo Righe e poi su Modifica vista elenco. Per modificare il modulo che appare quando un utente fa clic su Aggiungi una riga, fare clic su Modifica vista modulo.

Many2Many (`many2many`)

Il campo Many2Many viene utilizzato per collegare piu record da un altro modello a piu record del modello corrente. I campi Many2Many possono utilizzare Disabilita creazione, Disabilita apertura, Dominio, come i campi Many2One.

Per attivare la ricerca del record collegato solo dopo che e stato inserito un numero minimo di caratteri, inserire il numero desiderato nel campo Ricerca anticipata. In situazioni con dataset di grandi dimensioni, questo puo migliorare sia la pertinenza della ricerca che le prestazioni.

Caselle di controllo: gli utenti possono selezionare piu valori utilizzando caselle di controllo.
Tag: gli utenti possono selezionare piu valori che appaiono in forme arrotondate, noti anche come tag. Questo ha lo stesso effetto della selezione del campo Tag.

Tag (`many2many`)

Il campo Tag viene utilizzato per visualizzare piu valori da un altro modello che appaiono in forme arrotondate, noti anche come tag. Questo tipo di campo e un campo Many2Many con il widget Tag selezionato per impostazione predefinita. Di conseguenza, i widget Caselle di controllo e Many2Many hanno gli stessi effetti descritti nella sezione Many2Many.

Per visualizzare i tag con colori di sfondo diversi, spuntare Usa colori.

Un Campo correlato non e un campo relazionale in senso stretto; non viene creata alcuna relazione tra i modelli. Utilizza una relazione esistente per recuperare e visualizzare informazioni da un altro record.

Proprieta

Proprieta generali

Invisibile: abilitare questa proprieta quando non e necessario che gli utenti visualizzino un campo nell'interfaccia. Questo aiuta a rendere l'interfaccia piu ordinata mostrando solo i campi essenziali in base a una situazione specifica.
L'attributo Invisibile si applica anche all'interno degli strumenti di personalizzazione. Per visualizzare i campi nascosti, fare clic sulla scheda Vista di una vista e abilitare Mostra elementi invisibili.
Obbligatorio: abilitare questa proprieta se un campo deve essere sempre compilato dall'utente prima di poter procedere.
Sola lettura: abilitare questa proprieta se gli utenti non devono poter modificare un campo.

E possibile scegliere di abilitare Invisibile, Obbligatorio e Sola lettura solo per record specifici facendo clic su Condizionale e creando un filtro.

Etichetta: il nome del campo nell'interfaccia. Questo non e il nome utilizzato nel database PostgreSQL.
Tooltip di aiuto: per spiegare lo scopo di un campo, aggiungere una descrizione. Il testo viene visualizzato in un tooltip quando si passa il mouse sul punto interrogativo accanto all'etichetta del campo.
Widget: per modificare l'aspetto o la funzionalita predefinita di un campo, selezionare uno dei widget disponibili.
Segnaposto: per fornire un esempio di come compilare un campo, aggiungere un testo segnaposto. Il testo appare in grigio chiaro fino a quando non viene inserito un valore.
Valore predefinito: per visualizzare un valore predefinito in un campo quando viene creato un record, aggiungere un valore.
Consenti visibilita a gruppi: per limitare quali utenti possono visualizzare il campo, selezionare uno o piu gruppi di accesso utente.
Vieta visibilita a gruppi: per impedire a determinati utenti di vedere il campo, selezionare uno o piu gruppi di accesso utente.

Proprieta per campi Data e Ora

Per i campi Data e Ora che hanno il widget Data e Ora o Intervallo di date impostato, sono disponibili alcune proprieta specifiche:

Precisione minima: determina la piu piccola unita di data che deve essere selezionata nel selettore di date. I valori possibili sono Giorno, Mese, Anno o Decennio. Se non viene selezionato alcun valore, l'utente deve selezionare un giorno nel selettore di date.
Precisione massima: determina la piu grande unita di data che puo essere utilizzata per navigare nel selettore di date. I valori possibili sono Giorno, Mese, Anno o Decennio. Se non viene selezionato alcun valore, l'utente puo navigare nel selettore di date per decennio.
Avviso per date future: abilitare questa proprieta per visualizzare un'icona di avviso se viene selezionata una data futura.
Formato data: per impostazione predefinita la data viene mostrata come 2 apr 2025, 08:05. Abilitare questa proprieta per mostrare la data nel formato 02/04/2025 08:05:00. La modalita numerica corrisponde al formato impostato nella lingua corrente. In questa modalita i secondi vengono sempre visualizzati.
Mostra data: questa proprieta e abilitata per impostazione predefinita per i campi Data e Ora. Disabilitare questa proprieta per mostrare solo l'orario.
Mostra ora: questa proprieta e abilitata per impostazione predefinita per i campi Data e Ora. Su un campo di sola lettura, disabilitare la proprieta per mostrare solo la data. Questo puo rendere una vista elenco meno affollata, ad esempio.
Mostra secondi: questa proprieta e disabilitata per impostazione predefinita per i campi Data e Ora. Abilitare la proprieta per mostrare i secondi.
Intervallo temporale: inserire un valore per determinare gli intervalli di minuti mostrati nel selettore di orario. Ad esempio, inserire 15 per consentire intervalli di un quarto d'ora. Il valore predefinito e impostato a 5 minuti.
Data piu antica accettata: inserire la data piu antica che puo essere selezionata nel selettore di date in formato ISO, cioe AAAA-MM-GG. Se la data corrente e sempre la data piu antica accettata, inserire today. Nel selettore di date, le date precedenti alla data piu antica accettata sono visualizzate in grigio.
Data piu recente accettata: inserire la data piu recente che puo essere selezionata nel selettore di date in formato ISO, cioe AAAA-MM-GG. Se la data corrente e sempre la data piu recente accettata, inserire today. Nel selettore di date, le date successive alla data piu recente accettata sono visualizzate in grigio.

Personalizzazione

Personalizzare campi, viste, report e automazioni in Laundry ERP.

Viste

Le diverse modalita di visualizzazione dei dati in Laundry ERP: modulo, elenco, kanban, calendario, grafici e altro.