Feldtypen und Einstellungen
Welche Typen eigener Felder es gibt, welche Einstellungen jeder Typ hat und welche Grenzen gelten
Zuletzt aktualisiert am
Beim Anlegen eines Feldes wählen Sie einen Typ. Den Typ können Sie danach nicht mehr ändern. Unter 2. Einstellungen stehen die Optionen dieses Typs. Alle Optionen sind optional, sofern unten nichts anderes steht.
Bei fast jedem Typ können Sie auch eine Fehlermeldung eintragen. Sie ersetzt die Standardmeldung, wenn ein Wert nicht stimmt. Mit Platzhalter bestimmen Sie, was im leeren Eingabefeld steht.
Text und Langer Text
Text ist eine Zeile, Langer Text mehrere Zeilen.
| Einstellung | Was sie bewirkt |
|---|---|
| Mindestlänge und Maximale Länge | Die Anzahl der Zeichen. Ohne Maximum gelten 1.000 Zeichen bei Text und 10.000 bei Langer Text |
| Format | Beliebiger Text, E-Mail-Adresse, Telefonnummer, Webadresse, IBAN, Postleitzahl, Nur Ziffern oder Eigenes Muster |
| Muster (regulärer Ausdruck) | Bei Eigenes Muster. Der gesamte Wert muss passen. Tillor lehnt Muster mit verschachtelten Wiederholungen oder Rückverweisen und Muster mit mehr als 200 Zeichen ab |
Zahl und Betrag
Betrag verwendet die Währung Ihrer Organisation.
| Einstellung | Gilt für | Was sie bewirkt |
|---|---|---|
| Minimum und Maximum | Zahl, Betrag | Untergrenze und Obergrenze |
| Nur ganze Zahlen | Zahl | Keine Dezimalstellen erlaubt |
| Darstellung | Zahl, nur bei ganzen Zahlen | Eingabefeld oder Zähler (− / +) mit Schaltflächen |
| Schrittweite | Zahl | Der Wert muss das Minimum (oder 0) plus eine ganze Zahl von Schritten sein |
| Maximale Nachkommastellen | Zahl | Begrenzt die Dezimalstellen |
Ja / Nein
Ein Ein/Aus-Schalter. Mit Muss angekreuzt sein kann der Datensatz nur mit gesetztem Häkchen gespeichert werden. Praktisch für eine Einwilligung.
Datum
| Einstellung | Was sie bewirkt |
|---|---|
| Frühestes Datum und Spätestes Datum | Feste Grenzen |
| Nicht in der Vergangenheit und Nicht in der Zukunft | Verglichen mit heute in der Zeitzone Ihrer Organisation |
| Innerhalb von Tagen ab heute | Höchstens so viele Tage vor oder nach heute |
Auswahl und Mehrfachauswahl
Sie wählen eine Auswahlliste. Auswahl speichert eine Option, Mehrfachauswahl mehrere. Bei Mehrfachauswahl stellen Sie Mindestens ausgewählt und Höchstens ausgewählt ein. Eine Liste hat höchstens 200 Optionen.
Verknüpfung mit Datensatz
Das Feld verweist auf einen anderen Datensatz in Tillor.
| Einstellung | Was sie bewirkt |
|---|---|
| Verknüpft mit | Kunde, Stellplatz, Belegung, Zähler, Aufgabe, Rechnung, Reservierung, Zahlungsbericht, Telefonanruf, Kontaktperson, Produkt, Zählerschrank, Zahlung, Dokument, NFC-Tag oder Zugangsmethode |
| Mehrere Datensätze | Erlaubt mehr als einen verknüpften Datensatz. Sie können dann auch ein Minimum und Maximum einstellen |
| Darstellung | Auswahl oder Dropdown (eine durchsuchbare Liste) |
| Nur Datensätze dieses Kunden | Beschränkt die Optionen auf Datensätze des Kunden, den Sie bearbeiten. Nur bei Kontaktperson, Rechnung, Reservierung, Belegung, Zahlung, Dokument, NFC-Tag und Zugangsmethode |
| Nur Datensätze der Parzelle | Beschränkt die Optionen auf die Zähler der Parzelle: bei einer Belegung die Parzelle dieser Belegung, bei einer Parzelle die Parzelle selbst. Nur bei Zähler. Einen Zähler einer anderen Parzelle können Sie nicht speichern |
| Optionen filtern | Optionales TypeScript, das pro Option bestimmt, ob sie in die Liste kommt, siehe Optionen filtern. Bei Kontaktperson, Produkt, Zählerschrank, Zahlung, Dokument, NFC-Tag, Zugangsmethode, Rechnung, Reservierung, Belegung, Zähler und Parzelle |
Wird ein verknüpfter Datensatz später gelöscht, zeigt das Feld Gelöscht.
Gibt es mindestens 50 Datensätze zur Auswahl, geben Sie zuerst 2 Zeichen zum Suchen ein. Sind es weniger, etwa die Zähler einer einzelnen Parzelle, sehen Sie sofort alle.
Optionen filtern
Mit Optionen filtern bestimmen Sie selbst, welche Datensätze das Feld anbietet. Sie schreiben TypeScript, wie bei der Tarifformel, das Tillor für jede Option ausführt. Gibt es true zurück, kommt die Option in die Liste, sonst nicht.
Im Filter lesen Sie Felder mit geschweiften Klammern. Das Menü Variable zeigt, was es gibt, einschließlich eigener Felder:
| Variable | Was es ist |
|---|---|
{option.…} | Der Datensatz, den Sie auswählen könnten, zum Beispiel {option.type} oder {option.terrainId} bei einem Zähler |
{occupation.…}, {terrain.…}, … | Der Datensatz, den Sie bearbeiten, unter dem Namen seines Typs, mit customFields für seine eigenen Felder |
Beispiel: nur Stromzähler der Parzelle der Belegung.
return {option.type} === "ELECTRICITY" && {option.terrainId} === {occupation.terrainId};Eigene Bezeichnungen
Derselbe Filter kann auch bestimmen, wie eine Option in der Liste heißt. Was Sie zurückgeben, bestimmt das Ergebnis:
| Sie geben zurück | Ergebnis |
|---|---|
true | Die Option steht unter ihrem eigenen Namen in der Liste |
false, null oder ein leerer Text | Die Option steht nicht in der Liste |
| Ein Text | Die Option steht unter diesem Text in der Liste |
{ label, group } | Die Option erhält diese Bezeichnung und kommt unter die Überschrift group. Beide sind optional |
Beispiel: nur Zähler von ICY und Hydrodigit, mit dem Typ dabei und nach Lieferant gruppiert.
if (!["ICY", "TILLOR_HYDRODIGIT"].includes({option.provider})) return false;
return { label: {option.name} + " · " + {option.type}, group: {option.provider} };Die Bezeichnung gilt in der Auswahlliste und auf den gewählten Chips im Formular. An Stellen, die nur den Wert anzeigen, wie der Detailseite oder einem Export, steht der eigene Name des Datensatzes.
Beispiel einfügen unter dem Feld liefert einen Ausgangspunkt. Einen Filter, der nicht kompiliert, können Sie nicht speichern; die Meldung unter dem Feld sagt, was falsch ist.
Der Filter beschränkt nicht nur die Liste. Wählen Sie über die API oder ein altes Formular trotzdem einen Datensatz, den der Filter auslässt, verweigert Tillor das Speichern unter Nennung des Feldnamens. Automatisierungen und Importe werden nicht geprüft, so wie sie auch ausgeblendete Felder füllen dürfen.
Feldgruppe
Ein fester Satz von Unterfeldern, die gemeinsam im Formular stehen, wie Hunde und Andere Tiere unter Tiere.
| Einstellung | Was sie bewirkt |
|---|---|
| Unterfeld hinzufügen | Jedes Unterfeld hat eine Bezeichnung, einen Typ und eigene Einstellungen. Klicken Sie auf Mehr für den Schlüssel, die Breite und Bedingungen. Eine Gruppe kann höchstens 30 Unterfelder haben |
| Darstellung | Rahmen (mit Rand) oder Inline (die Felder laufen im Formular weiter) |
| Spalten | 1 bis 4 |
| Breite in der Gruppe | Pro Unterfeld, wie viele Spalten es einnimmt |
Wiederholende Zeilen
Eine Tabelle, der Sie mit Zeile hinzufügen Zeilen hinzufügen, zum Beispiel mehrere Fahrzeuge. Sie stellen die Unterfelder ein wie bei einer Gruppe. Mit Mindestanzahl Zeilen und Maximale Zeilen begrenzen Sie die Liste. Ohne Maximum gelten 100 Zeilen, und mehr als 500 sind nicht möglich.
Eine Gruppe oder wiederholende Zeile darf eine Ebene tief eine weitere Gruppe oder wiederholende Zeile enthalten, nicht weiter.
Dateien
Für Dokumente und Fotos. Eine hochgeladene Datei kann nur öffnen, wer das Feld sehen darf.
| Einstellung | Was sie bewirkt |
|---|---|
| Mehrere Dateien | Erlaubt mehr als eine Datei |
| Mindestanzahl Dateien und Höchstanzahl Dateien | Ohne Maximum gelten 20 Dateien, und mehr als 50 sind nicht möglich |
| Maximale Größe pro Datei (MB) | Höchstens 50 MB pro Datei, auch wenn Sie einen höheren Wert wünschen |
| Erlaubte Dateitypen | Jede Datei, Bilder, PDF, Office-Dokumente oder eine eigene Endung wie .dwg oder ein MIME-Typ wie application/zip |
Tillor prüft den Typ anhand des Inhalts der Datei, nicht nur anhand des Namens.
JSON
Gedacht für strukturierte Daten, die eine Verknüpfung mit einem anderen System mitliefert. Kollegen füllen dies selten im Formular aus. Mit Maximale Größe (KB) legen Sie eine Grenze fest, standardmäßig 64 KB und höchstens 256 KB.
Einstellungen für jeden Typ
| Einstellung | Was sie bewirkt |
|---|---|
| Diesen Wert verschlüsseln | Speichert den Wert verschlüsselt. Ein verschlüsseltes Feld lässt sich nicht durchsuchen, filtern oder sortieren und steht nicht als Variable in Automatisierungen zur Verfügung. Nur für Felder der obersten Ebene, also nicht für Unterfelder. Alle eigenen Felder werden ohnehin verschlüsselt gespeichert, ob Sie dies aktivieren oder nicht |
| Nur API | Blendet das Feld in Formularen und Detailansichten aus. Eine Verknüpfung füllt es über die API. Ein solches Feld kann kein Pflichtfeld sein |
| Nur API, schreibgeschützt | Zeigt das Feld an, aber deaktiviert, sodass Kollegen den Wert sehen, aber nicht ändern |
| Validierungsregeln | Vergleichen Sie ein Datum, eine Zahl oder einen Betrag mit einem anderen Feld (Vor, Am oder vor, Nach, Am oder nach, mit einem Abstand in Tagen, Wochen oder Monaten) oder prüfen Sie den Wert mit einem Ausdruck. Höchstens 10 Regeln pro Feld |
Eine geänderte Grenze gilt nicht rückwirkend. Ein Wert, den Sie nicht anpassen, blockiert das Speichern des Datensatzes nicht, auch wenn er der neuen Regel nicht mehr entspricht.