Bidji Template Directives - Référence Technique

Référence rapide de toutes les directives Bidji pour templates FreeMarker. Pour des explications détaillées et exemples, voir BidjicDirectives.md

Version : 2026-02-06 Source : BidjicTask.freemarkerize() lignes 1003-1072

📋 Table des Matières

• Variables Globales
• Application & Modèle
• Entités - Propriétés
• Entités - Métadonnées
• Entités - UI
• Entités - Relations
• Entités - Métier
• Propriétés - Types
• Propriétés - Attributs
• Entités Nested
• Widgets
• Debug
• Ordre d’Exécution

Variables Globales

Application & Modèle

Entités - Propriétés

Entités - Métadonnées

Entités - UI

Entités - Relations

Entités - Métier

Propriétés - Types

Propriétés - Attributs

⚠️ DEPRECATED - Utiliser .@ directement

Raison : Ces directives sont de simples aliases sans valeur ajoutée.

Entités Nested

⚠️ Ordre critique : nested?entity.@default_sort DOIT être avant nested?entity !

Widgets

Debug

Ordre d’Exécution

Les directives sont appliquées par ordre de priorité décroissante (plus haute d’abord).

⚠️ Ordre Critique

110 → nested?entity.@default_sort   [DOIT être AVANT nested?entity]
100 → nested?entity
100 → nested?properties
 80 → app?entities
 70 → entity?properties, entity?dataform_properties, etc.
 65 → entity?native_properties
 60 → entity?detail_tabs, entity?has_detail_tabs, etc.
 55 → entity?has_filter_by_month, entity?is_monthly_table, etc.
 50 → entity?one_to_many_properties, entity?many_to_many_properties
 50 → entity2.@name, entity2.@package
 45 → entity.@name, entity.@package, entity.@module, etc.
 40 → widget?property
 35 → property?type_or_string, property?dbtype, etc.
 30 → column?is_property
 20 → property?kind_of_* (DEPRECATED)
 10 → model?has_complex_types
  5 → entity?dump, property?dump

Règles Importantes

1. Plus spécifique = Priorité plus haute

   • nested?entity.@default_sort (110) avant nested?entity (100)
   • entity2.@name (50) avant entity.@name (45)

2. Les queries complexes avant les simples

   • entity?properties (70) avant entity.@name (45)

3. Deprecated = Priorité basse

   • property?kind_of_* (20) exécutés en dernier

Catégories par Priorité

Priorité Haute (100+) - Entités Nested

nested?entity.@default_sort  (110)
nested?entity                (100)
nested?properties            (100)

Priorité Moyenne-Haute (50-80) - Queries Entités

app?entities                 (80)
entity?properties            (70)
entity?dataform_properties   (70)
entity?one_to_many_properties(50)

Priorité Moyenne (40-49) - Métadonnées Entités

entity.@name                 (45)
entity.@package              (45)
widget?property              (40)

Priorité Moyenne-Basse (30-39) - Propriétés

property?type_or_string      (35)
property?dbtype              (35)
column?is_property           (30)

Priorité Basse (20-) - Deprecated & Debug

property?kind_of_*           (20) ← DEPRECATED
model?has_complex_types      (10)
entity?dump                  (5)

Mapping Catégories → Namespace Futur

Correspondance avec la nouvelle syntaxe (Phase 3 du refactoring) :

Extraction depuis le Code Source

// BidjicTask.java:1003-1072
private String freemarkerize(String templateContent) {
    String res = templateContent;

    // Les 60+ replaceAll() dans l'ordre du code source :
    res = res.replaceAll("app\\?entities", "app.getEntities()");
    res = res.replaceAll("nested\\?entity.@default_sort", "...");
    res = res.replaceAll("nested\\?entity", "...");
    // ... etc
    res = res.replaceAll("entity\\?dump", "Model\\?api.dump_entity(entity)");
    res = res.replaceAll("property\\?dump", "Model\\?api.dump_property(property)");

    return res;
}

⚠️ Problème : Ordre d’exécution = ordre dans le code, pas documenté ! ✅ Solution : Voir doc/Refactoring.md Phase 2 - BidjicPreprocessor avec priorités explicites

Statistiques

Règles de Nommage

Pattern ? (Query/Fonction)

<objet>?<action>
<objet>?<action>_<contexte>

Exemples :

• entity?properties - “donne-moi les propriétés”
• entity?dataform_properties - “donne-moi les propriétés pour un dataform”
• property?type_or_string - “donne-moi le type ou ‘string’”

Pattern .@ (Attribut)

<objet>.@<attribut>

Exemples :

• entity.@name - attribut name de entity
• property.@type - attribut type de property

Pattern Composé (Nested)

<objet>?<relation>.<action>
<objet>?<relation>.@<attribut>

Exemples :

• nested?entity - récupère l’entité référencée
• nested?entity.@default_sort - récupère le default_sort de l’entité référencée

Pièges Fréquents

1. Ordre des Nested ⚠️

[#-- ❌ INCORRECT --]
${nested?entity}
${nested?entity.@default_sort}

[#-- ✅ CORRECT --]
${nested?entity.@default_sort}
${nested?entity}

2. Confusion ? vs .@

[#-- ❌ INCORRECT --]
${property?name}      [#-- n'existe pas --]
${entity?package}     [#-- n'existe pas --]

[#-- ✅ CORRECT --]
${property.@name}
${entity.@package}

3. Utiliser Deprecated

[#-- ❌ DEPRECATED --]
[#if property?kind_of_string]

[#-- ✅ CORRECT --]
[#if property.@kind_of_string]

Références Croisées

• Guide détaillé : BidjicDirectives.md
• Plan de refactoring : Refactoring.md
• Code source : src/main/java/org/bidji/taskdefs/BidjicTask.java:1003-1072
• Helper API : src/main/java/org/bidji/util/ModelHelper.java

Génération Automatique

Ce document peut être généré automatiquement avec la classe BidjicPreprocessor (Phase 2 du refactoring) :

BidjicPreprocessor.printMarkdownReference();

Voir doc/Refactoring.md pour plus de détails.

Document généré le : 2026-02-06 Version : 1.0 Auteur : Analyse automatique du code source