Les propriétés personnalisées permettent d’ajouter, dans Zero Friction, des champs supplémentaires et entièrement configurables sur différentes entités (par exemple : clients, contrats, adresses ou dossiers de recouvrement).
Elles servent à collecter des informations qui ne figurent pas par défaut dans le modèle de données, mais qui sont utiles à votre organisation, que ce soit pour vos reportings, vos processus internes ou votre facturation.
1. Que trouve-t-on dans l'onglet « propriétés » ?
La page de configuration « propriétés » affiche un aperçu de tous les types de propriétés définis. Pour chaque propriété, vous pouvez voir :
Nom : le nom de la propriété personnalisée (ex. Type de bâtiment, Priorité).
Description : une explication de son objectif et de son utilisation.
Entité : le type d’entité à laquelle la propriété s’applique (ex. Client, Contrat, Adresse).
Type de données : le format de la valeur attendue (Texte, Numéro, Décimal, Oui/Non, Date & heure, Liste de choix).
Unité de mesure : applicable uniquement pour les types Nombre et Décimal (ex. kWh, m³, €).
Afficher dans l’en-tête : indique si la propriété apparaît comme une étiquette dans l’en-tête de l’entité.
Couleur de l'étiquette : la couleur de l'étiquette affichée dans l’en-tête (si l’option est activée).
Traductions : possibilité de traduire les libellés et/ou descriptions.
La liste contient aussi bien les types de propriétés actifs que les types supprimés (filtrables).
2. Mise en page
La page principale affiche un tableau reprenant tous les types de « propriétés personnalisées ». Chaque ligne est cliquable et ouvre le panneau de détails.
2.1 Panneau de détails – Type de propriété
Dans ce tableau, vous pouvez configurer : le nom, la description, le type de données, l’unité de mesure (si applicable), l’affichage dans l’en-tête, la couleur de l'étiquette, les traductions.
2.2 Listes de choix (menu déroulant)
Lorsque dans la section « type de donnée » vous sélectionnez « Liste de choix », vous pouvez gérer les options :
ajouter des options ;
modifier des options ;
supprimer des options (suppression « douce » / soft delete).
Les options supprimées restent visibles sur les enregistrements existants qui les utilisent, mais elles ne peuvent plus être sélectionnées pour de nouveaux enregistrements.
3. Actions possibles dans l'onglet « propriétés »
Dans cet onglet, les utilisateurs peuvent :
Créer une nouvelle propriété personnalisée ;
Modifier une propriété existante ;
Gérer les options d’une liste de choix ;
Supprimer une propriété (suppression « douce » / soft delete).
Limitations et validations :
Le nom doit être unique au sein d’un même type d’entité.
Une fois la propriété créée, le type d’entité et le type de données ne peuvent plus être modifiés.
La suppression est toujours une suppression « douce » : les valeurs déjà utilisées restent conservées.
4. Comportements et logique
Les propriétés personnalisées sont enregistrées sous forme de valeurs sur les entités (ex. : par client ou par contrat). Les valeurs sont découpées dans le temps (timesliced) et disposent d'une date de début et d'une date de fin. Sans date de fin, une valeur reste valide jusqu'à sa modification.
Si « Afficher dans l'en-tête » est activé :
La propriété s'affiche sous forme de tag coloré dans l'en-tête de l'entité.
Plusieurs valeurs s'affichent sous forme de tags distincts.
Pour les types de données numériques, l'unité de mesure est toujours affichée avec la valeur.
Les propriétés personnalisées peuvent être utilisées (selon la configuration) dans :
La facturation
Les tarifs
Les rapports
Les sélections et filtres
Problème | Solution |
La propriété personnalisée n’apparaît pas sur une entité | Vérifiez que vous avez bien sélectionné le bon type d’entité pour cette propriété (ex. Client, Contrat, Facture, etc.). |
Une option manque dans une liste de choix | Vérifiez que l’option n’a pas été supprimée dans la configuration de la propriété. |
Impossible d’utiliser un nom en double | Choisissez un autre nom : deux propriétés ne peuvent pas porter le même nom au sein d’un même type d’entité. |
La propriété n’est pas visible dans l’en-tête | Vérifiez que l’option « Afficher dans l’en-tête » est bien activée. |
Le type de données ne peut pas être modifié | Ce n’est pas modifiable après création. La solution est de créer une nouvelle propriété avec le bon type de données. |
Les valeurs ne semblent pas historisées | Vérifiez les dates de début et de fin de la valeur : ce sont elles qui gèrent l’historique (validité dans le temps). |
La propriété ne peut pas être modifiée. | Vérifiez que vous avez les permissions nécessaires pour la modifier. |
Puis-je modifier le type d’entité après la création ?
Non. Ce n’est pas possible. Il faut créer une nouvelle propriété avec le bon type d’entité.
Que se passe-t-il si je supprime une propriété ?
La propriété est supprimée via une suppression « douce » (soft delete). Les valeurs déjà enregistrées restent visibles et conservées.
Puis-je utiliser le même nom plusieurs fois ?
Oui, à condition que ce soit pour des types d’entité différents. En revanche, le nom doit rester unique au sein d’un même type d’entité.
Pourquoi je ne vois pas la liste de choix comme type de données ?
Ce type nécessite l’activation d’une feature flag. Contactez votre administrateur ou l’équipe en charge de la configuration.
Puis-je savoir quand une valeur a été modifiée ?
Oui. Les valeurs sont historisées dans le temps : elles ont une date de début et, le cas échéant, une date de fin.
Les propriétés personnalisées sont-elles prises en compte dans la facturation ?
Oui, à condition qu’elles soient correctement intégrées dans la configuration des tarifs ou des calculs.
Que se passe-t-il si je ne renseigne pas de date de fin ?
La valeur reste valable jusqu’à ce qu’elle soit modifiée.
Propriété personnalisée : champ supplémentaire défini par l’organisation (non présent par défaut dans Zero Friction).
Type de propriété : définition d’une propriété personnalisée (nom, type de données, entité concernée, etc.).
Valeur de propriété : valeur concrète renseignée sur une entité spécifique (par ex. sur un client ou un contrat).
Entité : objet dans Zero Friction (par ex. Client, Contrat, Adresse, ...).
Type de données : format de la valeur (Texte, Nombre, Date, Oui/Non, Liste de choix, etc.).
Unité de mesure : unité associée aux valeurs numériques (ex. kWh, m³, €).
Historisation dans le temps : valeurs valables sur une période, avec une date de début et une date de fin.
Suppression « douce » : suppression qui n’efface pas les données existantes ; les valeurs restent visibles.
Afficher dans l’en-tête : option qui affiche la propriété sous forme de tag/d'étiquette dans l’en-tête de l’entité.
Couleur de l'étiquette : couleur de l'étiquette affichée dans l’en-tête.
Feature flag : paramètre d’activation d’une fonctionnalité (par exemple, l’accès au type « Liste de choix »).