Types de champs et paramètres
Quels types de champs personnalisés existent, quels paramètres a chaque type et quelles limites s'appliquent
Dernière mise à jour le
Lors de la création d'un champ, vous choisissez un type. Vous ne pouvez plus le modifier ensuite. Sous 2. Paramètres figurent les options de ce type. Toutes les options sont facultatives, sauf indication contraire ci-dessous.
Pour presque chaque type, vous pouvez aussi saisir un Message d'erreur. Il remplace le message par défaut lorsqu'une valeur n'est pas correcte. Avec Texte indicatif, vous définissez ce qui s'affiche dans le champ de saisie vide.
Texte et Texte long
Texte est une seule ligne, Texte long plusieurs lignes.
| Paramètre | Ce qu'il fait |
|---|---|
| Longueur minimale et Longueur maximale | Le nombre de caractères. Sans maximum, la limite est de 1 000 caractères pour Texte et de 10 000 pour Texte long |
| Format | Texte libre, Adresse e-mail, Numéro de téléphone, Adresse web, IBAN, Code postal, Chiffres uniquement ou Modèle personnalisé |
| Modèle (expression régulière) | Avec Modèle personnalisé. La valeur entière doit correspondre. Tillor refuse les modèles avec des répétitions imbriquées ou des références arrière et les modèles de plus de 200 caractères |
Nombre et Montant
Montant utilise la devise de votre organisation.
| Paramètre | S'applique à | Ce qu'il fait |
|---|---|---|
| Minimum et Maximum | Nombre, Montant | Limite inférieure et limite supérieure |
| Nombres entiers uniquement | Nombre | Aucune décimale autorisée |
| Affichage | Nombre, uniquement avec des nombres entiers | Champ de saisie ou Compteur (− / +) avec boutons |
| Pas | Nombre | La valeur doit être le minimum (ou 0) plus un nombre entier de pas |
| Décimales maximales | Nombre | Limite les décimales |
Oui / non
Un interrupteur activé/désactivé. Avec Doit être cochée, la fiche ne peut être enregistrée que si la case est cochée. Pratique pour un consentement.
Date
| Paramètre | Ce qu'il fait |
|---|---|
| Date la plus proche et Date la plus lointaine | Limites fixes |
| Pas dans le passé et Pas dans le futur | Comparé à aujourd'hui dans le fuseau horaire de votre organisation |
| À moins de jours d'aujourd'hui | Au maximum ce nombre de jours avant ou après aujourd'hui |
Choix et Choix multiple
Vous choisissez une liste de choix. Choix conserve une option, Choix multiple plusieurs. Pour Choix multiple, vous réglez Sélection minimale et Sélection maximale. Une liste a 200 options au maximum.
Lien vers une fiche
Le champ pointe vers une autre fiche dans Tillor.
| Paramètre | Ce qu'il fait |
|---|---|
| Lie vers | Client, Emplacement, Occupation, Compteur, Tâche, Facture, Réservation, Rapport de paiement, Appel téléphonique, Personne de contact, Produit, Armoire de compteurs, Paiement, Document, Tag NFC ou Méthode d'accès |
| Plusieurs fiches | Autorise plus d'une fiche liée. Vous pouvez alors aussi régler un minimum et un maximum |
| Affichage | Sélecteur ou Menu déroulant (une seule liste avec recherche) |
| Uniquement les enregistrements de ce client | Limite les options aux fiches du client que vous modifiez. Uniquement pour Personne de contact, Facture, Réservation, Occupation, Paiement, Document, Tag NFC et Méthode d'accès |
| Uniquement les éléments de l'emplacement | Limite les options aux compteurs de l'emplacement : pour une occupation, l'emplacement de cette occupation, pour un emplacement, l'emplacement lui-même. Uniquement pour Compteur. Un compteur d'un autre emplacement ne peut pas être enregistré |
| Filtrer les options | TypeScript facultatif qui détermine pour chaque option si elle figure dans la liste, voir Filtrer les options. Pour Personne de contact, Produit, Armoire de compteurs, Paiement, Document, Tag NFC, Méthode d'accès, Facture, Réservation, Occupation, Compteur et Emplacement |
Si une fiche liée est supprimée plus tard, le champ affiche Supprimé.
S'il y a au moins 50 fiches à choisir, vous saisissez d'abord 2 caractères pour rechercher. S'il y en a moins, comme les compteurs d'un seul emplacement, vous les voyez toutes aussitôt.
Filtrer les options
Avec Filtrer les options, vous décidez vous-même quelles fiches le champ propose. Vous écrivez du TypeScript, comme pour la formule tarifaire, que Tillor exécute pour chaque option. S'il renvoie true, l'option figure dans la liste ; sinon, non.
Dans le filtre, vous lisez des champs avec des accolades. Le menu Variable montre ce qui est disponible, y compris les champs personnalisés :
| Variable | Ce que c'est |
|---|---|
{option.…} | La fiche que vous pourriez choisir, par exemple {option.type} ou {option.terrainId} pour un compteur |
{occupation.…}, {terrain.…}, … | La fiche que vous modifiez, sous le nom de son type, avec customFields pour ses propres champs |
Exemple : uniquement les compteurs d'électricité de l'emplacement de l'occupation.
return {option.type} === "ELECTRICITY" && {option.terrainId} === {occupation.terrainId};Libellés personnalisés
Le même filtre peut aussi déterminer le nom d'une option dans la liste. Ce que vous renvoyez détermine le résultat :
| Vous renvoyez | Résultat |
|---|---|
true | L'option figure dans la liste sous son propre nom |
false, null ou un texte vide | L'option ne figure pas dans la liste |
| Un texte | L'option figure dans la liste sous ce texte |
{ label, group } | L'option reçoit ce libellé et se place sous le titre group. Les deux sont facultatifs |
Exemple : uniquement les compteurs d'ICY et d'Hydrodigit, avec le type ajouté et groupés par fournisseur.
if (!["ICY", "TILLOR_HYDRODIGIT"].includes({option.provider})) return false;
return { label: {option.name} + " · " + {option.type}, group: {option.provider} };Le libellé s'applique dans la liste de sélection et sur les pastilles choisies dans le formulaire. Aux endroits qui n'affichent que la valeur, comme la page de détail ou un export, c'est le nom propre de la fiche qui apparaît.
Insérer un exemple sous le champ donne un point de départ. Un filtre qui ne compile pas ne peut pas être enregistré ; le message sous le champ indique ce qui ne va pas.
Le filtre ne limite pas seulement la liste. Si vous choisissez malgré tout, via l'API ou un ancien formulaire, une fiche que le filtre écarte, Tillor refuse l'enregistrement en nommant le champ. Les automatisations et les imports ne sont pas contrôlés, tout comme elles peuvent remplir des champs masqués.
Groupe de champs
Un ensemble fixe de sous-champs qui figurent ensemble dans le formulaire, comme Chiens et Autres animaux sous Animaux.
| Paramètre | Ce qu'il fait |
|---|---|
| Ajouter un sous-champ | Chaque sous-champ a un libellé, un type et ses propres paramètres. Cliquez sur Plus pour la clé, la largeur et les conditions. Un groupe peut avoir 30 sous-champs au maximum |
| Affichage | Cadre (avec bordure) ou Intégré (les champs se poursuivent dans le formulaire) |
| Colonnes | De 1 à 4 |
| Largeur dans le groupe | Pour chaque sous-champ, le nombre de colonnes qu'il occupe |
Lignes répétées
Un tableau où vous ajoutez des lignes avec Ajouter une ligne, par exemple plusieurs véhicules. Vous réglez les sous-champs comme pour un groupe. Avec Lignes minimales et Lignes maximum, vous bornez la liste. Sans maximum, la limite est de 100 lignes, et plus de 500 est impossible.
Un groupe ou des lignes répétées peuvent contenir, sur un niveau de profondeur, un autre groupe ou d'autres lignes répétées, pas plus.
Fichiers
Pour les documents et les photos. Un fichier que vous téléversez n'est accessible qu'à celui qui peut voir le champ.
| Paramètre | Ce qu'il fait |
|---|---|
| Plusieurs fichiers | Autorise plus d'un fichier |
| Fichiers minimum et Fichiers maximum | Sans maximum, la limite est de 20 fichiers, et plus de 50 est impossible |
| Taille maximale par fichier (Mo) | 50 Mo au maximum par fichier, même si vous voulez une valeur plus élevée |
| Types de fichiers autorisés | Tout fichier, Images, PDF, Documents Office, ou une extension personnalisée comme .dwg ou un type MIME comme application/zip |
Tillor vérifie le type d'après le contenu du fichier, pas seulement d'après son nom.
JSON
Destiné aux données structurées qu'une intégration transmet. Vos collègues le remplissent rarement dans le formulaire. Avec Taille maximale (Ko), vous fixez une limite, 64 Ko par défaut et 256 Ko au maximum.
Paramètres pour chaque type
| Paramètre | Ce qu'il fait |
|---|---|
| Chiffrer cette valeur | Conserve la valeur chiffrée. Un champ chiffré ne peut pas être recherché, filtré ni trié et n'est pas disponible comme variable dans les automatisations. Uniquement pour les champs de plus haut niveau, donc pas pour les sous-champs. Toutes les valeurs des champs personnalisés sont de toute façon stockées chiffrées, que vous l'activiez ou non |
| API uniquement | Masque le champ dans les formulaires et les vues détaillées. Une intégration le remplit via l'API. Un tel champ ne peut pas être obligatoire |
| API uniquement, lecture seule | Affiche le champ, mais désactivé, pour que vos collègues voient la valeur sans pouvoir la modifier |
| Règles de validation | Comparez une date, un nombre ou un montant à un autre champ (Avant, Au plus tard, Après, Au plus tôt, avec un décalage en jours, semaines ou mois), ou vérifiez la valeur avec une expression. 10 règles au maximum par champ |
Une limite modifiée ne s'applique pas rétroactivement. Une valeur que vous ne modifiez pas ne bloque pas l'enregistrement de la fiche, même si elle ne respecte plus la nouvelle règle.