Manuale · 8

Elementi

Ogni proprietà può essere fissa o calcolata con un binding {{ … }}. Ogni elemento ha inoltre Visibile se (un binding; vuoto = sempre).

Elemento Proprietà Evento
Titolo testo, livello 1–4, allineamento –
Testo testo, markdown, attenuato, allineamento –
Separatore etichetta (facoltativa), allineamento dell’etichetta, linea (continua, tratteggiata, punteggiata), verticale –
Spazio – (solo spazio vuoto nella griglia) –
HTML HTML con segnaposto {{ … }}, facoltativamente una query e parametri (allora record e records), come scheda –
Immagine indirizzo immagine (URL), testo alternativo, adattamento, angoli arrotondati –
Pulsante etichetta, stile (primary, secondary, danger, ghost), allineamento, larghezza piena, disattivato se clic
Campo etichetta, nome, tipo (testo, numero, e-mail, telefono, URL, password, multiriga), segnaposto, valore iniziale, obbligatorio, disattivato se, aiuto modifica
Selezione etichetta, nome, opzioni (una per riga) oppure una query con campo valore e campo etichetta, segnaposto, valore iniziale, obbligatorio modifica
Data etichetta, nome, con ora, valore iniziale, obbligatorio modifica
Casella etichetta, nome, valore iniziale modifica
Interruttore etichetta, nome, valore iniziale; come una casella (sì/no), mostrato come levetta Modifica
Opzioni etichetta, nome, opzioni oppure una query con campo valore ed etichetta, affiancate, valore iniziale, obbligatorio – esattamente una scelta Modifica
Scelta multipla come Opzioni, ma quante se ne vuole; il valore è un elenco Modifica
Cursore etichetta, nome, minimo, massimo, passo, unità, valore iniziale; il valore è un numero Modifica
Valutazione etichetta, nome, massimo (5 stelle), valore iniziale; un clic sulla stella attuale la azzera, Freccia sinistra/destra la cambia Modifica
Selezione con ricerca etichetta, nome, query, parametri, parametro di ricerca (predefinito q), campo valore ed etichetta, etichetta mostrata, segnaposto, obbligatorio Modifica
File etichetta, nome, tipi consentiti (ad es. image/*,.pdf), più file, obbligatorio, disattivato se, testo di aiuto; sta in un modulo Modifica
Modulo titolo, testo pulsante, svuota dopo l’invio; contiene campi invio
Tabella titolo, query, parametri, colonne (campo, etichetta, formato), righe per pagina, ordinabile, testo se vuota selezione
Vista dettaglio titolo, record (binding, ad es. {{el.leadsTable.selected}}) oppure una query con parametri, campi (campo, etichetta, formato; vuoto = tutti), colonne (1–4), nascondi i campi vuoti, testo se vuota –
Elenco query, parametri, titolo/testo/badge per voce, colonne 1–4, massimo, testo se vuoto selezione
Grafico titolo, query, parametri, tipo (colonne, barre orizzontali, linea, area, torta, anello), campi etichetta, valore e serie, raggruppa (per record, conteggio, somma, media), in pila, formato dei valori (numero, valuta, percentuale, ore) Selezione
Indicatore titolo, valore (binding) oppure una query con campo valore e aggregazione (primo record, numero, somma, media, minimo, massimo), formato (numero, valuta, percentuale, ore), decimali, unità, sottotitolo, confronta con (mostra la variazione in % con una freccia), testo del confronto, in aumento è positivo/negativo, icona Clic
Calendario titolo, query, parametri, campi inizio, fine (facoltativo), titolo e colore (colore etichetta come blue o #hex), vista mese/settimana Selezione, clic su un giorno
Mappa titolo, query, parametri, tipo (punti, aree), campo latitudine/longitudine, titolo/testo per punto, campo colore, raggruppa i punti vicini, campo area, campo valore, aggrega, formato, mappa di base, centro, zoom selezione
Kanban titolo, query, parametri, campo colonne, colonne (ordine; vuoto = come nei dati), titolo/testo/badge per scheda, campo somma e formato, testo se vuoto Selezione, Sposta
Galleria titolo, query, parametri, campo immagine (colonna allegati o indirizzo immagine), titolo/testo/badge per riquadro, colonne 2–6, proporzioni (orizzontale, quadrato, verticale), adattamento, testo se vuoto Selezione
Badge testo, colore (colore etichetta; vuoto = in base al testo), allineamento –
Avanzamento etichetta, valore, massimo (100), nascondi valore, testo del valore, colore (vuoto = accento, ok, warn, danger – anche come binding) –
Contenitore titolo, stile (scheda, semplice); griglia propria –
Schede schede con etichette; una griglia per scheda –
Finestra titolo, dimensione; mostrata con il passo Apri finestra –

Campo (input, selezione, data, casella): la colonna da cui Compila modulo prende il valore quando il nome dell’elemento è diverso (p. es. nome due_date, campo due date).

Indicatore: percentuale si aspetta il valore già in percentuale (42 → «42 %»). Confronta con è di solito un binding al valore precedente, ad es. {{query.kpis.data.hoursPrev}}; la variazione appare in verde quando va nella direzione giusta (per costi o insoluti scegli in aumento è negativo).

Grafico: il campo serie suddivide i valori secondo una seconda colonna – colonne e barre stanno allora affiancate (o una sopra l’altra con in pila), ogni serie ha la propria linea o area; torta e anello non lo usano. Una serie prende il colore d’accento dell’app, più serie e le fette ricevono fino a otto colori fissi, distinguibili anche con deficit nella visione dei colori (le successive finiscono in «Altro»), sempre con una legenda – con valore e quota per la torta. Ogni colonna, punto e fetta mostra i valori al passaggio del mouse. Selezione scatta al clic, con point = {label, series, value} – ad es. Apri pagina con il parametro stage = {{point.label}}; nella pagina di destinazione {{url.stage}} legge il valore.

Download CSV (tabelle, elenchi, grafici; disattivato finché non lo attivi): un pulsante CSV in alto a destra dell’elemento. Tabelle ed elenchi caricano tutti i record della loro query (non solo la pagina mostrata, nell’ordinamento attuale), le tabelle con colonne e intestazioni, gli elenchi con tutti i campi; un grafico fornisce ciò che mostra (una riga per etichetta, una colonna per serie, valore e quota per la torta). Il file è UTF-8 e segue la lingua dell’interfaccia: virgola come separatore se il separatore decimale è il punto (inglese), altrimenti punto e virgola e virgola decimale – così Excel lo apre direttamente. I valori sono grezzi (numeri senza separatore delle migliaia, date come 2026-11-12); un testo che inizia come una formula (=, +, -, @) riceve un apostrofo davanti. L’azione Esporta CSV crea lo stesso file – anche senza pulsante sull’elemento.

Calendario: mese o settimana, con navigazione e Oggi; le voci su più giorni compaiono in ogni giorno, oltre tre in un giorno «+n altri» apre la settimana. el.<id>.from e el.<id>.to sono il periodo visibile (AAAA-MM-GG) – come parametri della query carica solo quello. Selezione scatta al clic su una voce (con item, anche el.<id>.selected), clic su un giorno con date (ad es. Compila modulo con {"day": "{{date}}"} e apri una finestra per creare).

HTML: HTML libero per riquadri, note o schede personalizzati. I segnaposto vengono codificati prima dell’inserimento – un valore con <b> appare come testo, non come markup. Poi l’HTML viene ripulito: niente script, niente gestori di eventi (onclick …), niente link javascript:, niente blocchi <style>, moduli o frame; stili in linea (style="…"), link (anche mailto:, tel:) e immagini restano. I link con target="_blank" si aprono senza accesso all’app. Il browser mostra immagini da altri indirizzi solo se le impostazioni di sicurezza lo consentono. Con una query l’elemento carica i dati da sé: {{record.name}} è il record (o il primo), {{records}} l’elenco.

File: Esegui query con una query Carica un file invia ogni file scelto del modulo (o del campo file scelto nell’azione) al record, uno alla volta – con un’autorizzazione di scrittura proprio su quella tabella, mai più di quanto l’account possa già. Dimensione (al massimo 50 MB per file) e tipi consentiti dipendono anche dalla colonna allegati; viene controllato il contenuto, non l’estensione. Un nuovo record con file: prima Crea record, poi Carica un file con {{query.<crea>.record.id}} come record. el.<id>.value è l’elenco dei file scelti; Svuota modulo lo svuota.

Kanban: una colonna per valore del campo colonne, l’intestazione mostra il numero e (con un campo somma) la somma. Le schede si trascinano in un’altra colonna con mouse o dito; da tastiera Freccia sinistra/destra sposta la scheda attiva, Invio la seleziona. Sposta parte con item (la scheda), lane (la colonna di destinazione) e from – di solito Esegui query con una query di modifica {"id": "{{item.id}}", "stage": "{{lane}}"} e poi Ricarica query. La scheda appare subito nella nuova colonna; se un’azione fallisce, torna indietro. Numeri, importi e percentuali da soli come badge appaiono in grigio neutro.

Galleria: se il campo immagine è una colonna allegati, il riquadro mostra la prima immagine come anteprima; senza un proprio evento Selezione, un clic apre l’immagine in grande (Esc chiude). Immagini e file delle colonne allegati passano dall’indirizzo proprio dell’app (vedi fileUrl in Binding e azioni) – anche per utenti app e app pubbliche, che non possono usare l’API REST.

Selezione con ricerca: cerca mentre digiti – la query riceve il testo nel suo parametro di ricerca, ad es. un elenco con il filtro name contiene {{params.q}} (testo vuoto = tutti). Per chiavi esterne in tabelle grandi, dove una Selezione diventerebbe troppo lunga. Obbligatorio significa una voce dell’elenco, non solo testo. Quando Compila modulo imposta un valore, l’etichetta mostrata (ad es. {{query.lead.record.client_name}}) ne mostra il nome; el.<id>.label è l’etichetta della scelta. Scelta multipla fornisce un elenco – come parametro di tipo qualsiasi.

Separatore e spazio strutturano una pagina: un separatore è una linea, a richiesta con un piccolo titolo (a sinistra, al centro o a destra) oppure verticale tra due colonne. Uno spazio è spazio vuoto, ad esempio per tenere un pulsante a destra. Sul telefono, dove tutti gli elementi si impilano, spazi e separatori verticali spariscono; i separatori orizzontali restano.

Mappa

La mappa mostra i record come punti oppure colora paesi e regioni in base a un valore.

  • Punti: campo latitudine e longitudine (predefinito latitude/longitude, gradi decimali). Titolo e testo per punto con segnaposto ({{item.name}}) compaiono al passaggio del mouse. Il campo colore accetta un colore etichetta (red, blue …), #hex o una categoria (fino a otto, con legenda). I punti vicini vengono raggruppati in un numero; un clic ingrandisce, e se si trovano nello stesso posto compare un elenco tra cui scegliere. Evento selezione con item.
  • Aree: il campo area contiene un codice paese (ISO 3166 alpha-2 come DE o alpha-3 come DEU), un codice regione (ISO 3166-2 come DE-BY) o il nome di un paese; più campo valore e aggrega (somma, numero, media). Cinque tonalità di un colore, una legenda con il valore minimo e massimo e un tooltip con nome e valore. Evento selezione con area (code, name, value).
  • Inquadratura: si adatta ai dati (per le aree alla parte continentale, senza territori d’oltremare); centro (lat, lng) e zoom la fissano. Trascinare sposta; doppio clic, + / − e Ctrl + rotellina ingrandiscono – la rotellina da sola solo dopo un clic nella mappa, altrimenti scorre la pagina; ⤢ mostra di nuovo tutto. Tastiera: frecce, + / −, 0. Sui touchscreen uno scorrimento verticale fa scorrere la pagina finché non tocchi la mappa; due dita ingrandiscono.
  • Mappa di base: integrata, da Natural Earth (pubblico dominio): paesi, coste e dallo zoom 5 i confini delle regioni – senza richieste esterne, anche senza internet. Non mostra strade né luoghi. Se è impostato un server di tile (Impostazioni → Sicurezza → Mappe), i suoi tile stanno sotto; mappa di base: outline usa comunque quella integrata.
  • Le coordinate dagli indirizzi (geocodifica) non sono integrate – le portano i dati, ad esempio tramite uno script o un workflow con il tuo servizio.

Valori degli elementi

  • Campo, selezione, data, casella: el.<id>.value – es. {{el.search.value}} come parametro di una query.
  • Modulo: el.<id>.values – nome del campo (o il suo ID) → valore. All’invio lo stesso contenuto è disponibile come values.
  • Tabella ed elenco: el.<id>.selected – l’ultimo record selezionato; nell’evento selezione come row (tabella) o item (elenco).
  • Schede: el.<id>.tab – l’ID della scheda aperta.

Elementi di dati

Tabelle, elenchi, grafici e selezioni con query caricano i dati da soli: appena cambia un parametro (per esempio un campo di ricerca), interrogano di nuovo poco dopo. Senza elenco di colonne una tabella mostra tutti i campi della query. Formati: data, data e ora, numero, valuta, sì/no, badge (il valore come pillola colorata) e avanzamento (0–100 come barra). Senza un colore proprio gli stati comuni ricevono un colore eloquente: Done, Paid, Won, Approved, Active verde, Overdue, Lost, Urgent, Blocked rosso, Review, Sent, Proposal, In progress, High ambra, Qualified, Scheduled, Medium blu, New, Open, To do, Backlog, Draft, Low grigio; ogni altro valore sempre lo stesso colore.

La vista dettaglio mostra un record come elenco di campi con etichette – ad esempio il record selezionato in una tabella o il risultato di una query Un record (per un elenco, la prima voce). Le colonne si dispongono da sole: sulle superfici strette i campi si impilano. Oltre ai formati della tabella c’è qui Markdown (per testi lunghi, su tutta la larghezza). I valori vuoti appaiono come «–», oppure non appaiono con Nascondi i campi vuoti.