Cookbook — Syntaxe et fonctions

Exemples de modèles de rapport complets combinant plusieurs fonctions de syntaxe pour des cas d'usage terrain réels dans Daxium-Air.

Cette page complète la référence Syntaxe et fonctions avec des modèles de rapport complets, prêts à adapter, pour les scénarios terrain les plus courants dans Daxium-Air.

Recette 1 — Rapport d'intervention par fiche (Word)

Cas d'usage : Générer un document Word par fiche d'intervention, incluant les coordonnées du technicien, la localisation GPS, des photos avec filigrane GPS, et une section anomalies conditionnelle.

Structure du modèle

<%Inspector.FullName%> — <%F('dd/MM/yyyy', InspectionDate)%>

Site : <%List(', ', SiteAddress, PostalCode, City)%>
Statut : <%If(InspectionResult = 'Conforme', 'CONFORME ✓', 'NON CONFORME ✗')%>

<%Map(SubmissionLatitude, SubmissionLongitude, 15, 400, 250, 0)%>

Photos (avec coordonnées GPS en filigrane) :

<%Images(Photos)%><%ImageWatermark(200, 0,
  List(' | ',
    ImageExif(Photos, 'GpsLatitudeDM'),
    ImageExif(Photos, 'GpsLongitudeDM'),
    ImageExif(Photos, 'DateTime')
  ), 'Left', 'Bottom', 'White', '#000000', 0.5, 11)%>

Section anomalies conditionnelle (masquée s'il n'y en a pas) :

<%Display(DefectCount > 0)%>
## Anomalies constatées

<%Relation('Anomalies', 'DefectDate')%>
  <%DefectDescription%> — <%F('dd/MM/yyyy', DefectDate)%>
<%End%>

Signature :

<%Image(InspectorSignature, 120)%>

Fonctions utilisées

• List() — assemble les champs d'adresse en omettant les vides
• If() — affiche un statut lisible
• Map() — carte de la position GPS de l'intervention
• Images() + ImageWatermark() + ImageExif() — photos avec GPS et date en filigrane
• Display() / End — masque la section anomalies si vide
• Relation() — liste les fiches anomalies liées

---

Recette 2 — Rapport de synthèse mensuel en mode listing (Excel)

Cas d'usage : Un rapport Excel en mode listing envoyé par e-mail chaque mois, couvrant toutes les fiches du mois précédent, avec comptage, total et graphique en barres.

Feuille PPActions

Type:table ; TableName:Interventions ; Value:Id	Type:table ; TableName:Interventions ; Value:TechnicianName	Type:table ; TableName:Interventions ; Value:InterventionDate	Type:table ; TableName:Interventions ; Value:Duration

Feuille de données (tableau Interventions — ligne modèle)

#	Technicien	Date	Durée (min)
<%Value:Id%>	<%Value:TechnicianName%>	<%Value:F('dd/MM/yyyy', InterventionDate)%>	<%Value:N(Duration)%>

Section récapitulative (sous le tableau)

Total interventions :     <%Count()%>
Durée totale (min) :      <%Sum('N(Duration)')%>
Durée moyenne (min) :     <%Avg('N(Duration)')%>

Graphique (interventions par technicien) :

<%Chart('Bar', 'Count()', 'TechnicianName', true, 500, 300)%>

Filtre Repeat dans PPActions

<%Repeat(InterventionDate > #date-1m# AND InterventionDate < #date#, InterventionDate)%>

Fonctions utilisées

• N() / Sum() / Avg() / Count() — agrégation sur l'ensemble des données
• Chart() — graphique en barres par technicien
• Repeat() avec filtre de date — limite au mois précédent
• F() — formatage de la date dans le tableau

---

Recette 3 — Bon de livraison avec articles liés (Word)

Cas d'usage : Un bon de livraison par fiche, listant les produits commandés via un champ relation, avec comptage et total.

Section fiche principale

Bon de livraison n°<%SubmissionId%>
Date : <%F('dd/MM/yyyy', DeliveryDate)%>
Client : <%ClientName%>
Adresse : <%List(', ', DeliveryAddress, PostalCode, City)%>

Tableau de relation (une ligne par produit)

Placez Relation() dans la première cellule d'une ligne de tableau :

<%Relation('ProduitsCommandes', 'ProductName')%>

Ligne modèle :

<%ProductName%>	<%ProductReference%>	<%Quantity%>	<%F('0.00', UnitPrice)%>	<%F('0.00', Quantity * UnitPrice)%>

Ligne de pied (sous le tableau de relation) :

<%[ProduitsCommandes.Count]%> articles — Total : <%Sum('N(Quantity) * N(UnitPrice)')%> €

Fonctions utilisées

• Relation() — une ligne par fiche produit liée
• [Relation.Count] — nombre total de lignes produits
• List() — adresse de livraison formatée
• Arithmétique dans les balises — Quantity * UnitPrice
• Sum() — total général sur toutes les lignes produits

---

Recette 4 — Rapport multi-sections conditionnel (Word)

Cas d'usage : Un modèle unique qui adapte son contenu selon la valeur d'un champ liste (p. ex. TypeIntervention). Chaque section n'est générée que pour le type d'intervention correspondant.

Modèle

<%Display(TypeIntervention = 'Maintenance')%>
## Checklist de maintenance
<%ChecklistItem1%> — <%If(ChecklistItem1Result = 'OK', 'Conforme', 'Non conforme')%>
<%ChecklistItem2%> — <%If(ChecklistItem2Result = 'OK', 'Conforme', 'Non conforme')%>
<%End%>

<%Display(TypeIntervention = 'Installation')%>
## Fiche d'installation
Date d'installation : <%F('dd/MM/yyyy', InstallationDate)%>
Installé par : <%Technician.FullName%>
Numéro de série : <%SerialNumber%>
<%End%>

<%Display(TypeIntervention = 'Audit')%>
## Résultats d'audit
Score : <%AuditScore%> / 100
<%If(AuditScore >= 80, 'Résultat : SATISFAISANT', 'Résultat : ACTION REQUISE')%>
<%End%>

Fonctions utilisées

• Display() / End — affiche chaque section uniquement pour le type correspondant
• If() — rendu des libellés conforme/non conforme et résultat
• F() — formatage de la date

---

Conseils pour toutes les recettes

• Testez avec des données réelles. Générez un rapport depuis une fiche qui couvre les cas limites (champs optionnels vides, nombre maximum de photos) avant de finaliser le modèle.
• Utilisez Exists() pour protéger les champs image. Si une photo peut être absente, encadrez la balise : <%If(Exists('Photos#1'), Image([Photos#1], 200), '')%> pour éviter un espace vide dans le document.
• Limite du mode listing. Les rapports Excel et les rapports Word planifiés sont limités à 30 000 fiches. Ajoutez un filtre de date dans Repeat() pour maintenir des temps de génération raisonnables.
• Apostrophes. Dans les modèles PowerPoint, remplacez les guillemets typographiques (') par des guillemets droits (') avant d'enregistrer — voir la page PowerPoint pour les détails.