Veldtypes en instellingen
Welke typen eigen velden er zijn, welke instellingen elk type heeft en welke grenzen gelden
Laatst bijgewerkt op
Bij het aanmaken van een veld kies je een type. Het type kun je daarna niet meer wijzigen. Onder 2. Instellingen staan de opties van dat type. Alle opties zijn optioneel, tenzij hieronder anders staat.
Bij bijna elk type kun je ook een Foutmelding invullen. Die vervangt de standaardmelding als een waarde niet klopt. Met Voorbeeldtekst bepaal je wat er in het lege invoerveld staat.
Tekst en Lange tekst
Tekst is één regel, Lange tekst meerdere regels.
| Instelling | Wat het doet |
|---|---|
| Minimale lengte en Maximale lengte | Het aantal tekens. Zonder maximum geldt 1.000 tekens bij Tekst en 10.000 bij Lange tekst |
| Formaat | Vrije tekst, E-mailadres, Telefoonnummer, Webadres, IBAN, Postcode, Alleen cijfers of Eigen patroon |
| Patroon (reguliere expressie) | Bij Eigen patroon. De hele waarde moet overeenkomen. Tillor weigert patronen met geneste herhalingen of terugverwijzingen en patronen langer dan 200 tekens |
Getal en Bedrag
Bedrag gebruikt de valuta van je organisatie.
| Instelling | Geldt voor | Wat het doet |
|---|---|---|
| Minimum en Maximum | Getal, Bedrag | Ondergrens en bovengrens |
| Alleen hele getallen | Getal | Geen decimalen toegestaan |
| Weergave | Getal, alleen bij hele getallen | Invoerveld of Teller (− / +) met knoppen |
| Stap | Getal | De waarde moet het minimum (of 0) plus een geheel aantal stappen zijn |
| Maximaal aantal decimalen | Getal | Beperkt de decimalen |
Ja / nee
Een aan/uit-schakelaar. Met Moet aangevinkt zijn kan het record alleen worden opgeslagen met het vakje aan. Handig voor een toestemming.
Datum
| Instelling | Wat het doet |
|---|---|
| Vroegste datum en Laatste datum | Vaste grenzen |
| Niet in het verleden en Niet in de toekomst | Vergeleken met vandaag in de tijdzone van je organisatie |
| Binnen dagen van vandaag | Maximaal zoveel dagen voor of na vandaag |
Keuze en Meerkeuze
Je kiest een keuzelijst. Keuze bewaart één optie, Meerkeuze meerdere. Bij Meerkeuze stel je Minimaal geselecteerd en Maximaal geselecteerd in. Een lijst heeft maximaal 200 opties.
Koppeling naar record
Het veld wijst naar een ander record in Tillor.
| Instelling | Wat het doet |
|---|---|
| Koppelt naar | Klant, Terrein, Bezetting, Meter, Taak, Factuur, Reservering, Betaalrapport, Telefoongesprek, Contactpersoon, Product, Meterkast, Betaling, Document, NFC-tag of Toegangsmethode |
| Meerdere records | Sta meer dan één gekoppeld record toe. Je kunt dan ook een minimum en maximum instellen |
| Weergave | Keuzelijst of Dropdown (één doorzoekbare lijst) |
| Alleen records van deze klant | Beperkt de opties tot records van de klant die je bewerkt. Alleen bij Contactpersoon, Factuur, Reservering, Bezetting, Betaling, Document, NFC-tag en Toegangsmethode |
| Alleen records van het terrein | Beperkt de opties tot de meters van het terrein: bij een bezetting het terrein van die bezetting, bij een terrein het terrein zelf. Alleen bij Meter. Een meter van een ander terrein kun je niet opslaan |
| Opties filteren | Optionele TypeScript die per optie bepaalt of ze in de lijst komt, zie Opties filteren. Bij Contactpersoon, Product, Meterkast, Betaling, Document, NFC-tag, Toegangsmethode, Factuur, Reservering, Bezetting, Meter en Terrein |
Wordt een gekoppeld record later verwijderd, dan toont het veld Verwijderd.
Zijn er minstens 50 records om uit te kiezen, dan typ je eerst 2 tekens om te zoeken. Zijn het er minder, zoals de meters van één terrein, dan zie je ze meteen allemaal.
Opties filteren
Met Opties filteren bepaal je zelf welke records het veld aanbiedt. Je schrijft TypeScript, net als de tariefformule, die Tillor voor elke optie uitvoert. Geeft ze true terug, dan komt de optie in de lijst; anders niet.
In de filter lees je velden met accolades. Het menu Variabele toont wat er is, inclusief eigen velden:
| Variabele | Wat het is |
|---|---|
{option.…} | Het record dat je zou kunnen kiezen, bijvoorbeeld {option.type} of {option.terrainId} bij een meter |
{occupation.…}, {terrain.…}, … | Het record dat je bewerkt, onder de naam van zijn type, met customFields voor zijn eigen velden |
Voorbeeld: alleen elektriciteitsmeters van het terrein van de bezetting.
return {option.type} === "ELECTRICITY" && {option.terrainId} === {occupation.terrainId};Eigen labels
Dezelfde filter kan ook bepalen hoe een optie in de lijst heet. Wat je teruggeeft, bepaalt het resultaat:
| Je geeft terug | Resultaat |
|---|---|
true | De optie staat in de lijst onder haar eigen naam |
false, null of een lege tekst | De optie staat niet in de lijst |
| Een tekst | De optie staat in de lijst onder die tekst |
{ label, group } | De optie krijgt dat label en komt onder de kop group. Beide zijn optioneel |
Voorbeeld: alleen meters van ICY en Hydrodigit, met het type erbij en gegroepeerd per leverancier.
if (!["ICY", "TILLOR_HYDRODIGIT"].includes({option.provider})) return false;
return { label: {option.name} + " · " + {option.type}, group: {option.provider} };Het label geldt in de keuzelijst en op de gekozen chips in het formulier. Op plekken die alleen de waarde tonen, zoals de detailpagina of een export, staat de eigen naam van het record.
Voorbeeld invoegen onder het veld geeft een beginpunt. Een filter die niet compileert kun je niet opslaan; de melding onder het veld zegt wat er mis is.
De filter beperkt niet alleen de lijst. Kies je via de API of een oud formulier toch een record dat de filter weglaat, dan weigert Tillor het opslaan met de naam van het veld. Automatiseringen en imports worden niet gecontroleerd, zoals ze ook verborgen velden mogen invullen.
Groep velden
Een vaste set subvelden die samen in het formulier staan, zoals Honden en Andere dieren onder Dieren.
| Instelling | Wat het doet |
|---|---|
| Subveld toevoegen | Elk subveld heeft een label, type en eigen instellingen. Klik op Meer voor de sleutel, breedte en voorwaarden. Een groep kan maximaal 30 subvelden hebben |
| Weergave | Kader (met rand) of Inline (de velden lopen door in het formulier) |
| Kolommen | 1 tot en met 4 |
| Breedte in de groep | Per subveld hoeveel kolommen het beslaat |
Herhalende rijen
Een tabel waar je rijen aan toevoegt met Rij toevoegen, bijvoorbeeld meerdere voertuigen. Je stelt de subvelden in zoals bij een groep. Met Minimaal aantal rijen en Maximaal aantal rijen begrens je de lijst. Zonder maximum geldt 100 rijen, en meer dan 500 kan niet.
Een groep of herhalende rij mag één niveau diep nog een groep of herhalende rij bevatten, niet verder.
Bestanden
Voor documenten en foto's. Een bestand dat je uploadt is alleen te openen door wie het veld mag zien.
| Instelling | Wat het doet |
|---|---|
| Meerdere bestanden | Sta meer dan één bestand toe |
| Minimaal aantal bestanden en Maximaal aantal bestanden | Zonder maximum geldt 20 bestanden, en meer dan 50 kan niet |
| Maximale grootte per bestand (MB) | Maximaal 50 MB per bestand, ook als je een hogere waarde wilt |
| Toegestane bestandstypes | Elk bestand, Afbeeldingen, PDF, Office-documenten, of een eigen extensie zoals .dwg of een MIME-type zoals application/zip |
Tillor controleert het type aan de hand van de inhoud van het bestand, niet alleen aan de naam.
JSON
Bedoeld voor gestructureerde gegevens die een koppeling met een ander systeem meegeeft. Collega's vullen dit zelden in het formulier in. Met Maximale grootte (KB) stel je een grens in, standaard 64 KB en maximaal 256 KB.
Instellingen voor elk type
| Instelling | Wat het doet |
|---|---|
| Deze waarde versleutelen | Bewaart de waarde versleuteld. Een versleuteld veld is niet te doorzoeken, filteren of sorteren en is niet beschikbaar als variabele in automatiseringen. Alleen voor velden op het hoogste niveau, dus niet voor subvelden. Alle eigen velden worden sowieso versleuteld opgeslagen, of je dit aanzet of niet |
| Alleen API | Verbergt het veld in formulieren en detailweergaven. Een koppeling vult het via de API. Zo'n veld kan niet verplicht zijn |
| Alleen API, alleen-lezen | Toont het veld wel, maar uitgeschakeld, zodat collega's de waarde zien maar niet wijzigen |
| Validatieregels | Vergelijk een datum, getal of bedrag met een ander veld (Voor, Op of voor, Na, Op of na, met een verschuiving in dagen, weken of maanden), of controleer de waarde met een expressie. Maximaal 10 regels per veld |
Een gewijzigde grens geldt niet terugwerkend. Een waarde die je niet aanpast, blokkeert het opslaan van het record niet, ook al voldoet ze niet meer aan de nieuwe regel.