🦺Maintenance et évolution

➗ Formules

Utiliser la formule LET

La formule LET permet d’améliorer la lisibilité de vos formules en vous offrant la possibilité de renommer les variables utilisées. Elle facilite ainsi la compréhension, la maintenance et la modification des formules complexes, en les découpant en étapes claires et logiques. C’est un excellent moyen de structurer vos formules de manière plus lisible et plus robuste.

Insérer des commentaires

N’hésitez pas à insérer des commentaires dans vos formules afin d’expliquer chaque étape ou logique mise en place. Cela permet une compréhension plus simple pour de la collaboration ou lorsque vous voudrez y apporter des modifications.

Exemple :

On souhaite récupérer des informations sur la rentrée scolaire des enfants :

LET( 
    nbJour, WEEKDAY({dateH_debut_planningEnfant}), 
    jour = IF(nbJour == 1, 7, nbJour - 1), 
    
    comment, "WEEKDAY renvoie la version anglaise avec dimanche en 1ere valeur,",
    comment, "donc je reformate avec lundi == 1",
    
    date, FORMAT_DATE({dateH_debut_planningEnfant}, "DD_MM_YY"), 
    etab, {sys_fml_lnk_etablissement_planningEnfant → txt_idBdd_etablissement}, 
    jour & "_" & date & "_" & etab
)

💬 Ajouter des commentaires

Lorsque vous ajoutez des lignes ou des colonnes avec des conditions d’affichage, n’hésitez pas à ajouter des commentaires explicatifs. Cela permet d’identifier rapidement les zones conditionnées dans une page et de comprendre clairement les critères d’affichage appliqués.

Pour cela, vous pouvez ajouter une ligne au dessus avec un arrière-plan coloré et en la masquant sur tous les appareils. Laissez alors un commentaire de la forme :

• [MAKER] Ligne -> qcu_ticketRedige_demande égal à "Oui"

• [MAKER] Colonne 3 -> lnkM_ticket_demande non null

Masquer une ligne pour laisser un commentaire

🌳 Multi-environnement

Avec le multi-environnement, il est fortement recommandé de créer régulièrement de nouvelles versions de développement avant d’effectuer des modifications. Cela vous permettra de :

• Revenir facilement en arrière si un changement ne vous convient pas

• Tester vos implémentations dans un environnement isolé, sans impacter la version en production

• Sécuriser vos déploiements en validant étape par étape

Bonnes pratiques

• Renommez chaque version de manière claire (ex. : v1.2 - Ajout du module de relance)

• Ajoutez une description explicite pour tracer les évolutions et faciliter la reprise par un collaborateur ou vous-même

📈 Éléments de données

Privilégier une configuration par usage

Réutiliser une même configuration de tableau à plusieurs endroits tout en gérant des droits spécifiques pour chaque emplacement peut entraîner des risques lors des modifications.

En effet, modifier les paramètres d’un tableau dans un endroit peut impacter involontairement les autres usages.

Il est donc recommandé de créer des configurations dédiées, adaptées à chaque contexte d’utilisation, tout en maintenant une syntaxe cohérente afin de préserver une organisation claire et facilement maintenable.

🗝️ Clé API

Créer une clé API par connexion externe

Pour chaque système tiers, utilisez une clé dédiée afin de faciliter la gestion, la révocation ou la mise à jour des accès sans impacter les autres intégrations.

Pensez à bien renommer vos clés API afin de pouvoir les retrouver facilement.