Tipi di campo e impostazioni
Quali tipi di campi personalizzati esistono, quali impostazioni ha ogni tipo e quali limiti valgono
Ultimo aggiornamento il
Quando crei un campo scegli un tipo. Dopo non puoi più cambiarlo. Sotto 2. Impostazioni trovi le opzioni di quel tipo. Tutte le opzioni sono facoltative, salvo diversa indicazione qui sotto.
Per quasi ogni tipo puoi anche compilare un Messaggio di errore. Sostituisce il messaggio standard quando un valore non è corretto. Con Testo segnaposto decidi cosa c'è nel campo di inserimento vuoto.
Testo e Testo lungo
Testo è una riga, Testo lungo più righe.
| Impostazione | Cosa fa |
|---|---|
| Lunghezza minima e Lunghezza massima | Il numero di caratteri. Senza massimo valgono 1.000 caratteri per Testo e 10.000 per Testo lungo |
| Formato | Testo libero, Indirizzo email, Numero di telefono, Indirizzo web, IBAN, CAP, Solo cifre o Modello personalizzato |
| Modello (espressione regolare) | Con Modello personalizzato. L'intero valore deve corrispondere. Tillor rifiuta i modelli con ripetizioni annidate o riferimenti all'indietro e i modelli più lunghi di 200 caratteri |
Numero e Importo
Importo usa la valuta della tua organizzazione.
| Impostazione | Vale per | Cosa fa |
|---|---|---|
| Minimo e Massimo | Numero, Importo | Limite inferiore e superiore |
| Solo numeri interi | Numero | Nessun decimale consentito |
| Visualizzazione | Numero, solo con numeri interi | Campo di immissione o Contatore (− / +) con pulsanti |
| Passo | Numero | Il valore deve essere il minimo (o 0) più un numero intero di passi |
| Decimali massimi | Numero | Limita i decimali |
Sì / no
Un interruttore acceso/spento. Con Deve essere selezionata la scheda si può salvare solo con la casella attiva. Utile per un consenso.
Data
| Impostazione | Cosa fa |
|---|---|
| Data minima e Data massima | Limiti fissi |
| Non nel passato e Non nel futuro | Confrontato con oggi nel fuso orario della tua organizzazione |
| Entro giorni da oggi | Al massimo questo numero di giorni prima o dopo oggi |
Scelta e Scelta multipla
Scegli un elenco di scelta. Scelta conserva una sola opzione, Scelta multipla più opzioni. Con Scelta multipla imposti Minimo selezionati e Massimo selezionati. Un elenco ha al massimo 200 opzioni.
Collegamento a scheda
Il campo punta a un'altra scheda in Tillor.
| Impostazione | Cosa fa |
|---|---|
| Collega a | Cliente, Terreno, Occupazione, Contatore, Attività, Fattura, Prenotazione, Rapporto pagamenti, Telefonata, Persona di contatto, Prodotto, Armadio contatori, Pagamento, Documento, Tag NFC o Metodo di accesso |
| Più schede | Consenti più di una scheda collegata. Puoi allora impostare anche un minimo e un massimo |
| Visualizzazione | Selettore o Menu a tendina (un unico elenco con ricerca) |
| Solo i record di questo cliente | Limita le opzioni ai record del cliente che stai modificando. Solo per Persona di contatto, Fattura, Prenotazione, Occupazione, Pagamento, Documento, Tag NFC e Metodo di accesso |
| Solo record della piazzola | Limita le opzioni ai contatori del terreno: per un'occupazione il terreno di quell'occupazione, per un terreno il terreno stesso. Solo per Contatore. Un contatore di un altro terreno non puoi salvarlo |
| Filtra opzioni | TypeScript facoltativo che decide per ogni opzione se compare nell'elenco, vedi Filtrare le opzioni. Per Persona di contatto, Prodotto, Armadio contatori, Pagamento, Documento, Tag NFC, Metodo di accesso, Fattura, Prenotazione, Occupazione, Contatore e Terreno |
Se una scheda collegata viene eliminata in seguito, il campo mostra Eliminato.
Se ci sono almeno 50 schede tra cui scegliere, digiti prima 2 caratteri per cercare. Se sono meno, come i contatori di un solo terreno, le vedi subito tutte.
Filtrare le opzioni
Con Filtra opzioni decidi tu quali schede offre il campo. Scrivi TypeScript, come per la formula della tariffa, che Tillor esegue per ogni opzione. Se restituisce true, l'opzione compare nell'elenco; altrimenti no.
Nel filtro leggi i campi con le parentesi graffe. Il menu Variabile mostra cosa c'è, inclusi i campi personalizzati:
| Variabile | Cos'è |
|---|---|
{option.…} | La scheda che potresti scegliere, ad esempio {option.type} o {option.terrainId} per un contatore |
{occupation.…}, {terrain.…}, … | La scheda che stai modificando, con il nome del suo tipo, con customFields per i suoi campi personalizzati |
Esempio: solo contatori elettrici del terreno dell'occupazione.
return {option.type} === "ELECTRICITY" && {option.terrainId} === {occupation.terrainId};Etichette personalizzate
Lo stesso filtro può anche decidere come si chiama un'opzione nell'elenco. Ciò che restituisci determina il risultato:
| Cosa restituisci | Risultato |
|---|---|
true | L'opzione è nell'elenco con il suo nome |
false, null o un testo vuoto | L'opzione non è nell'elenco |
| Un testo | L'opzione è nell'elenco con quel testo |
{ label, group } | L'opzione riceve quell'etichetta e finisce sotto l'intestazione group. Entrambi sono facoltativi |
Esempio: solo contatori di ICY e Hydrodigit, con il tipo accanto e raggruppati per fornitore.
if (!["ICY", "TILLOR_HYDRODIGIT"].includes({option.provider})) return false;
return { label: {option.name} + " · " + {option.type}, group: {option.provider} };L'etichetta vale nell'elenco di scelta e sui chip selezionati nel modulo. Nei punti che mostrano solo il valore, come la pagina di dettaglio o un'esportazione, compare il nome proprio della scheda.
Inserisci esempio sotto il campo offre un punto di partenza. Un filtro che non compila non puoi salvarlo; il messaggio sotto il campo dice cosa non va.
Il filtro non limita solo l'elenco. Se tramite l'API o un vecchio modulo scegli comunque una scheda che il filtro esclude, Tillor rifiuta il salvataggio indicando il nome del campo. Automazioni e importazioni non vengono controllate, così come possono compilare anche i campi nascosti.
Gruppo di campi
Un insieme fisso di sottocampi che stanno insieme nel modulo, come Cani e Altri animali sotto Animali.
| Impostazione | Cosa fa |
|---|---|
| Aggiungi sottocampo | Ogni sottocampo ha un'etichetta, un tipo e impostazioni proprie. Fai clic su Altro per la chiave, la larghezza e le condizioni. Un gruppo può avere al massimo 30 sottocampi |
| Visualizzazione | Riquadro (con bordo) o In linea (i campi proseguono nel modulo) |
| Colonne | Da 1 a 4 |
| Larghezza nel gruppo | Per ogni sottocampo, quante colonne occupa |
Righe ripetute
Una tabella a cui aggiungi righe con Aggiungi riga, ad esempio più veicoli. Imposti i sottocampi come per un gruppo. Con Righe minime e Righe massime limiti l'elenco. Senza massimo valgono 100 righe, e più di 500 non è possibile.
Un gruppo o una riga ripetuta può contenere, a un solo livello di profondità, un altro gruppo o un'altra riga ripetuta, non oltre.
File
Per documenti e foto. Un file che carichi può essere aperto solo da chi può vedere il campo.
| Impostazione | Cosa fa |
|---|---|
| Più file | Consenti più di un file |
| File minimi e File massimi | Senza massimo valgono 20 file, e più di 50 non è possibile |
| Dimensione massima per file (MB) | Al massimo 50 MB per file, anche se vuoi un valore più alto |
| Tipi di file consentiti | Qualsiasi file, Immagini, PDF, Documenti Office, oppure un'estensione propria come .dwg o un tipo MIME come application/zip |
Tillor controlla il tipo in base al contenuto del file, non solo al nome.
JSON
Pensato per dati strutturati che un collegamento con un altro sistema fornisce. I colleghi raramente li compilano nel modulo. Con Dimensione massima (KB) imposti un limite, di default 64 KB e al massimo 256 KB.
Impostazioni per ogni tipo
| Impostazione | Cosa fa |
|---|---|
| Cifra questo valore | Conserva il valore cifrato. Un campo cifrato non si può cercare, filtrare né ordinare e non è disponibile come variabile nelle automazioni. Solo per campi di primo livello, quindi non per sottocampi. Tutti i campi personalizzati vengono comunque salvati cifrati, che tu attivi questa opzione o no |
| Solo API | Nasconde il campo nei moduli e nelle viste di dettaglio. Un collegamento lo compila tramite l'API. Un campo così non può essere obbligatorio |
| Solo API, sola lettura | Mostra il campo, ma disattivato, così i colleghi vedono il valore ma non lo modificano |
| Regole di validazione | Confronta una data, un numero o un importo con un altro campo (Prima di, Entro, Dopo, Da, con uno scarto in giorni, settimane o mesi), oppure verifica il valore con un'espressione. Al massimo 10 regole per campo |
Un limite modificato non vale retroattivamente. Un valore che non modifichi non blocca il salvataggio della scheda, anche se non soddisfa più la nuova regola.