4.07 Valeurs / Filtres / Tris par défaut

Chemin : Administration > Configuration > Valeurs/filtres/tris par défaut (/admin/defaultvalues.php) Cette page permet de définir des comportements par défaut pour les formulaires de création, les listes et les champs de saisie, sans modifier les fichiers sources. Un interrupteur global active ou désactive l’ensemble du mécanisme (constante MAIN_ENABLE_DEFAULT_VALUES). Lorsqu’il est désactivé, aucune règle n’est appliquée. La page est organisée en 5 onglets. Toutes les règles sont stockées en base de données et s’appliquent globalement à tous les utilisateurs de l’entité.

Note : Règle importante pour l’URL relative : pour les modules dans le répertoire custom/, n’incluez pas le préfixe custom/. Utilisez monmodule/mapage.php et non custom/monmodule/mapage.php. Vous pouvez aussi restreindre une règle à une URL avec paramètres spécifiques : societe/card.php?abc=val1&def=val2 — la règle ne s’applique alors que si tous ces paramètres sont présents.

Onglet 1 – Valeurs par défaut sur les formulaires de création :

Permet de pré-remplir automatiquement des champs dans les formulaires de création d’enregistrements. Condition d’activation : le remplacement ne fonctionne que pour les pages qui reçoivent le paramètre action=create ou action=presend dans leur URL.

Variables de substitution disponibles dans le champ Valeur :

Variable                 Description
                         __USER_ID__              Identifiant de l’utilisateur connecté
                         __USER_LOGIN__           Login de l’utilisateur connecté
                         __USER_LASTNAME__        Nom de l’utilisateur connecté
                         __USER_FIRSTNAME__       Prénom de l’utilisateur connecté
                         __DATE_TODAY__           Date du jour
                         __ENTITY_ID__            Identifiant de l’entité courante

Exemple pratique : pour pré-remplir automatiquement un extrafield liste déroulante d’utilisateurs nommé options_signature avec l’utilisateur connecté, saisissez la valeur __USER_ID__. Pour retrouver le nom du champ HTML, faites un clic droit sur l’élément dans le navigateur et choisissez Inspecter.

Figure 4.18 – Configuration d’une valeur par défaut avec constante de substitution

Onglet 2 – Filtres de recherche par défaut :

Permet de pré-remplir les champs de filtre dans les pages de liste, afin qu’une recherche prédéfinie soit active à l’ouverture de la liste. Cas d’usage type : afficher uniquement les tiers actifs à l’ouverture de la liste clients, sans que l’utilisateur ait à saisir le filtre manuellement. Renseignez societe/list.php comme URL et search_status comme champ. Les mêmes variables de substitution que l’onglet 1 sont disponibles pour les valeurs de filtre.

Onglet 3 – Ordre de tri par défaut :

Permet de définir le tri appliqué par défaut à l’ouverture d’une page de liste.

Avertissement : Le réglage d’un ordre de tri par défaut peut provoquer une erreur technique si le champ indiqué n’existe pas dans la liste. En cas d’erreur, revenez dans cet onglet pour supprimer la règle et restaurer le comportement natif. Pour les colonnes issues de jointures SQL, utilisez la syntaxe alias.champ (ex. s.nom, datec).

Onglet 4 – Champs par défaut ayant le focus :

Permet de définir quel champ reçoit automatiquement le focus (curseur actif) à l’ouverture d’une page. Cas d’usage type : placer le curseur automatiquement sur le champ « Nom » lors de la création d’un tiers. Cet onglet ne comporte pas de colonne Valeur : seul l’identifiant HTML du champ est nécessaire.

Onglet 5 – Champs de formulaire obligatoires :

Permet de rendre obligatoire un champ qui ne l’est pas nativement dans Dolibarr™. Dolibarr™ bloque la soumission du formulaire si le champ est vide, de la même façon que pour les champs obligatoires natifs.

Note : Cette fonctionnalité est supportée uniquement sur les champs de type texte.