Widgetene

Alt du ser på en skjerm er en widget. Paletten Widgets, til venstre for canvaset, kommer med 32 widgets fra fabrikken — fra denne siden går du med vissheten om hva hver av dem er til, og med de viktigste forklart i detalj. Har appen widgets programmert av deg, dukker de opp i samme palett, i seksjonen Egendefinert.

#Katalogen, etter kategori

#Skjemafelt

Alle bindes til et felt i en post-datastore (seksjonen Databinding) og inngår i valideringen — se skjemaene.

Widget	Hva den er til
Tekstfelt	Tekst på én linje. Har Maske, modus Passord (skjul teksten) og plassholder.
Tekstområde	Lang tekst over flere linjer — notater, beskrivelser.
Tall	Numeriske verdier.
Ja/nei	En boolsk bryter.
Nedtrekksliste	Valg blant alternativer: Fast liste, Enum fra modellen eller Datastore; med Søkbar, Flervalg og modusen Tre (hierarkisk).
Dato	Dato, Dato og tid eller bare Klokkeslett (feltet Type avgjør).
Farge	Valg av en farge.
Filopplasting	Opplasting med draing og/eller knapp, med forhåndsvisning, størrelsesgrense og valg av lagring.

#Handlinger og navigasjon

Widget	Hva den er til
Knapp	Den klassiske handlingen. Vis: Ikon + tekst, Bare ikon eller Bare tekst; Handling ved klikk navigerer, åpner en modal eller kjører kode.
Knapp med meny	En knapp som åpner flere alternativer. Utseende: Delt (hoveddelen handler, pilen åpner menyen), Meny eller Hamburger. Hvert alternativ kan skjules eller deaktiveres etter betingelser.
Lenke	Klikkbar tekst — Mål: Skjerm i appen (med parametere) eller Ekstern URL (med Åpne i ny fane).
Brødsmulesti	«Du er her»-stien, med klikkbare nivåer og det siste nivået fast eller bundet til et felt.
Eksport	En knapp som laster ned dataene fra en datastore som regneark (.xlsx) — utvalgte felt, valgfri Overskriftsrad og Filnavn med {date}.

#Struktur

Widget	Hva den er til
Panel	En beholder med ramme og tittel — samler widgets som deretter flytter seg i flokk.
Faner	En beholder med faner; hver barnewidget tilhører én fane. Stil på fanene: Bokser, Piller eller Understreking.
Fast linje	En linje i full bredde, festet til Topp eller Bunn av skjermen — for handlingslinjer som alltid er synlige.
Strek	En skillestrek, Vannrett eller Loddrett — fargen og streken kommer fra Utseende.

#Innhold og media

Widget	Hva den er til
Etikett	Enkel tekst — titler, ledetekster, løse verdier. Godtar Verdier i setningen ({n} i teksten).
Markdown	Rik tekst skrevet i Markdown — fast eller fra et felt.
Bilde	Et bilde via Fast URL, Asset fra appen eller Felt (dynamisk); Tilpasning: Tilpass, Fyll eller Strekk.
Ekstern side	Bygger inn en side utenfra (et kart, en video, tredjeparts BI) eller HTML skrevet av deg. Kjører isolert: den ser verken økten eller dataene i appen.

#Data

Widget	Hva den er til
Tabell	Postrutenettet — typede kolonner, sortering, utvalg og handlingsknapper. Detaljer nedenfor.
Liste	Poster i loddrett liste, med felt i roller (Tittel, Undertittel, Brødtekst, Bildetekst) og valgfritt bilde.
Kort	Samme mal som Listen, men i et rutenett av kort med N Kolonner.
Diagram	Tegnede serier — søyler, linjer, kaker og mer. Detaljer nedenfor.
KPI	En stripe med numeriske indikatorer med trender, mål og sparkline. Detaljer nedenfor.

#Tavler og planlegging

Widget	Hva den er til
Kanban	Kort som kan dras mellom statuskolonner. Detaljer nedenfor.
Kalender	Hendelser i visningene Dag/Uke/Måned/År. Detaljer nedenfor.
Gantt	Start→slutt-søyler med fremdrift, grupper og avhengigheter. Detaljer nedenfor.

#Dokumenter og prosesser

Widget	Hva den er til
Rapport	Viser en rapport fra appen (PDF) inne på skjermen, med parametere bundet til det som er på skjermen og en Handlingslinje for å oppdatere og laste ned.
Status for prosessen	Historikken og det gjeldende steget i arbeidsflytene til en post, med beslutningsknapper når den åpne oppgaven tilhører den som ser på.
Mine oppgaver	Innboksen med arbeidsflytoppgaver for den påloggede brukeren — åpner skjermen til oppgaven og beslutter derfra.

#Tabellen

Tabellen er den mest brukte widgeten på plattformen: den bindes til en liste-datastore og viser postene i et rutenett, med paginering, sortering og utvalg.

#Kolonner

Når du binder datastoren, fødes kolonnene én per felt. Etterpå finpusser du: under Kolonner, bruk + kolonne for å legge til, og klikk på en kolonne på canvaset for å redigere den — inspektøren bytter til den.

Hver kolonne har Overskrift, Bredde, Kan sorteres på overskriften, Skjult — og en Type:

Type	Hva den gjør
Tekst	Verdien slik den er, med valgfri Maske (# = tegn).
Tall	Formaterer verdien: Tall (regionalt) (med Desimaler, Tusenskilletegn, Kompakt — 1,2 mill. i stedet for 1 234 567 —, Prefiks og Suffiks) eller Maske (# = siffer).
Lenke	Cellen blir klikkbar. Mål: Skjerm i appen (med parametere fra Felt i raden, URL-parameter eller Fast verdi) eller Skript — din egen kode som kjører ved klikk.
Bilde	Viser bildet hvis adresse/innhold ligger i feltet.
Fil	En nedlastingslenke til filen som feltet refererer til.

#Handlingene til tabellen

I kategorien Oppførsel oppretter handlingsseksjonen CRUD-knappene: Oppdater, Legg til ny, Rediger post, Slett post og Slett flere. Hver handling som slås på, lager en løs knapp på canvaset, koblet til tabellen — du plasserer og styler den knappen som en hvilken som helst annen.

• Legg til ny og Rediger post åpner en skjerm eller en modal etter ditt valg (typisk skjemaet til posten), med parameterne fylt inn fra raden.
• Rediger post og Slett post er bare aktive med en rad valgt; Slett flere jobber på Flervalg (bryteren som legger til kolonnen med avkrysningsbokser).
• Handlingene som skriver krever at datastoren har primærnøkkel — inspektøren varsler: Datastoren trenger en primærnøkkel.

#Skjemaer (inputer + post + validering)

Det finnes ingen «skjema»-widget: et skjema er summen av tre deler, og det er den friheten som lar deg tegne kortet slik du vil.

1. Opprett en post-datastore på skjermen (se Datastorer og data) — for eksempel conta, lastet med nøkkelen fra parameteren id i ruten.
2. Dra ut skjemafeltene (Tekstfelt, Nedtrekksliste, Dato…) og bind Databinding i hvert av dem til riktig felt i datastoren.
3. Sett inn en Knapp «Gravar» hvis hendelse lagrer datastoren — den forhåndsdefinerte handlingen Lagre datastore i hendelseseditoren skriver koden for deg (se Hendelser og SDK-et).

Valideringen bor i hvert felt, i kategorien Validering:

• Påkrevd — feltet må komme utfylt.
• Standardreglene: Min. tegn, Maks. tegn, Er e-post, Er telefonnummer, Er tall, Minverdi, Maksverdi, Mønster (regex) og Lik feltet (bekreftelse av passord, for eksempel).
• Validering med skript — for din egen logikk: koden mottar value (den gjeldende verdien i feltet) og gir tilbake true hvis gyldig, eller feilmeldingen. Et organisasjonsnummer, en IBAN, en forretningsregel.

Ved lagring kjører hele valideringen: påkrevde felt først, deretter reglene, så skriptet. Posten går bare videre hvis alt passerer.

#Diagrammet

Diagrammet bindes til en datastore og tegner serier. Under Diagramtype velger du: Søyler, Linje, Areal, Kake / Donut, Punkt, Radar, Måler, Trakt eller Varmekart.

Det vesentlige er koblingen, i kategorien Data:

• Kategorifelt (X-akse / sektorer) — det som skiller søylene/sektorene.
• Verdifelt — ett eller flere numeriske felt; hvert av dem er en serie.
• Seriefelt (gruppering) — som alternativ til flere verdier: pivoterer på det første verdifeltet og lager en serie per distinkt verdi (uten verdier telles poster).

Og deretter finpussen:

Alternativ	Hva det gjør
Stablet, Vannrett, Myke linjer, Verdier på punktene	Variasjoner av tegningen, avhengig av typen.
Forklaring, Plassering av forklaringen, Verktøytips	Diagramrammen. Forklaringen kan også dras direkte i diagrammet for å plasseres.
Verdiformat	Samme format som Tall-kolonnene i tabellen, brukt på akser, etiketter og verktøytips.
Verdiskala	Lineær eller Logaritmisk — den logaritmiske er til når seriene har ulike størrelsesordener.
Bruk en andre akse	En akse til høyre med egen skala — for å sette en sum i euro og et antall i samme diagram.
Serier	Type per serie (kombinasjoner av søyler og linjer) og hvilke serier som går til den andre aksen.
Avanserte alternativer	En kodeeditor med alle egenskapene til diagrammotoren, med autofullføring — lagt oppå konfigurasjonen, for tilfellene feltene ikke dekker.

#KPI-en

KPI-en er en stripe med indikatorer — fire tall side om side lages med én widget med fire indikatorer, ikke med fire widgets: justeringen og avstanden er garantert.

Hver indikator (under Indikatorer ▸ Legg til indikator) har:

• Etikett og ikon, med Plassering av teksten (Over verdien / Under verdien).
• Verdi (felt) + Aggregering (Sum, Gjennomsnitt, Antall, Maksimum, Minimum, Første, Siste) over datasettet — eller en Manuell verdi når det ikke er data koblet til.
• Trender (Legg til trend) — sammenligninger under tallet, med Referansefelt, format Prosent eller Absoluttverdi, og Lavere er bedre (bytter om fargene): på en gjeld som vokser må pilen være rød.
• Mål — Uten mål, Manuell verdi eller Felt fra datakilden, med valgfri Fremdriftslinje.
• Vis sparkline — minilinjen med historikken, med Seriefelt.
• Periode (fra felt) — hvilken periodeavslutning tallet gjelder (en ISO-dato vises som MM/ÅÅÅÅ).

Datasettet deles av widgeten, men hver indikator kan ha et Eget datasett.

#Kanbanen

Kanbanen viser postene som kort i kolonner — salgspipelinen i Gestão de Clientes er en kanban etter status.

1. Bind datastoren og velg Statusfelt (kolonne) — feltet som sier hvilken kolonne hvert kort står i.
2. Definer Kilde for kolonnene: Statisk (du legger til hver kolonne med Etikett, Verdi og farge) eller Enum (kolonnene kommer fra verdiene i en enum i modellen).
3. Sett sammen Mal for kortet — feltene og rollene, som i Listen.

Med Tillat å dra kort på, lagrer flytting av et kort den nye statusen i posten med én gang. Rekkefølgefelt (et numerisk felt) gjør sorteringen inne i kolonnen varig. Kolonne for uten kategori fanger postene hvis status ikke stemmer med noen kolonne; Antall kort viser totalen i overskriften.

Handlingene: Klikk på et kort (rediger) og Opprett kort (knapp i kolonnen) — hver av dem kan navigere til en skjerm, åpne en modal (med parameterne fra raden og kolonnen) eller sende en hendelse til din egen kode.

#Kalenderen

Kalenderen viser poster med dato som hendelser, i visningene Dag, Uke, Måned og År.

• Felt: Datofelt (start), Sluttfelt (valgfritt) (hendelser over flere dager), Tittelfelt.
• Farge på hendelser: Én farge eller Per felt — med et kart verdi → farge (en type-enum, for eksempel).
• Visning: Startvisning, Tilgjengelige visninger, Ukens første dag (Mandag/Søndag), Maks. hendelser per dag i månedsvisningen, Start/Slutt-timer i dag-/ukevisningene, Navigasjonslinje og Knapper for visningsbytte.
• Handlinger: Klikk på en hendelse (rediger) og Valg av dag/periode (opprett) — start/slutt sendes til målskjermen som parametere, klare til å forhåndsutfylle opprettelsesskjemaet.

Kalenderen laster bare postene i det synlige intervallet — å bytte måned henter den nye måneden, ikke hele tabellen.

#Gantten

Gantten tegner start→slutt-søyler på en tidslinje — planlegging av prosjekter, kampanjer, onboarding av kunder.

• Felt: Startfelt, Sluttfelt, Etikettfelt, Fremdriftsfelt (0–100) og Gruppefelt (grupperer rader).
• Avhengighetsfelt — ID-ene (primærnøkkel) til forgjengerne, som JSON-liste eller atskilt med komma; Gantten tegner pilene.
• Startzoom (Dag, Uke, Måned), Linje for i dag og Skyggelegg helger.
• Handlinger: Klikk på en søyle (rediger) og Klikk på tomt område (opprett) — den klikkede datoen sendes som parameter.

Gantten er til lesing: søylene kan ikke dras — datoene endres i skjemaet til posten.

#Hvorfor ikke…?

• Hvorfor vises ikke seksjonen Validering i widgeten min? Bare skjemafeltene validerer — en Knapp eller en Etikett har ingen verdi å validere.
• Hvorfor vises widgeten i paletten, men grå på canvaset? Den er deaktivert (bryteren Aktivert i kategorien Layout) eller en regel/hendelse har deaktivert den.
• Hvorfor ser jeg ikke data på canvaset? Canvaset viser eksempler — de ekte dataene vises i forhåndsvisningen og i den publiserte appen. Sjekk bindingen i kapitlet Datastorer og data.