Onglet Données

Guide de référence pour la gestion des mappages, calculs et sources de données dans le Concepteur de Modèle.

L'onglet Données du Concepteur de Modèle est l'endroit où vous définissez la logique de votre document. Il connecte votre design visuel à vos sources de données réelles (Excel/CSV) et gère la logique métier comme les calculs et le regroupement.

Aperçu des sections

L'onglet Données est organisé en sections suivantes :

  1. Mappages : Connecte les colonnes du fichier de données aux variables du modèle.
  2. Calculs : Crée de nouvelles variables à l'aide de formules.
  3. Regroupement (obligatoire) : Définit comment les lignes sont réparties en documents PDF distincts.
  4. Liaison de données : Joint les données transactionnelles aux données maîtres (style VLOOKUP).
  5. Configuration de sortie : Définit la convention de nommage des PDF générés.
  6. Sources de données : Charge des données d'exemple pour l'aperçu et le mappage.

1. Mappages

Les mappages permettent au modèle de « lire » les valeurs des colonnes de votre fichier de données source.

  • Données transactionnelles (icône reçu) : Représente vos données principales (ex : factures, lignes de vente). Ces données varient généralement à chaque ligne.
  • Données maîtres (icône personne) : Représente les données de référence (ex : liste de clients, catalogue de produits). Ces données sont souvent statiques ou jointes par un identifiant.

Lorsque vous chargez une source de données (voir Sources de données ci-dessous), les mappages sont souvent créés automatiquement. Vous pouvez aussi les ajouter manuellement.

2. Calculs

Les calculs vous permettent de créer de nouvelles variables dérivées de données existantes. Utilisez-les pour calculer des montants, des taxes ou combiner des champs texte.

Exemple : Pour calculer un prix total à partir de UnitPrice et Quantity :

  • Name : TotalAmount
  • Formula : {{UnitPrice}} * {{Quantity}}

Une fois créé, {{TotalAmount}} devient disponible comme variable dans votre design.

Agrégation (Somme)

Pour les totaux au niveau du groupe, vous pouvez utiliser le type sum au lieu d'une formule. Cela additionne automatiquement un champ sur toutes les lignes du groupe :

  • Type : sum
  • Field : La variable à additionner (ex : TotalAmount)

Utile pour calculer des sous-totaux, des totaux généraux ou d'autres valeurs agrégées à partir des lignes de détail.

Arrondi

Les calculs prennent en charge une option d'Arrondi pour contrôler la façon dont les résultats numériques sont arrondis :

  • floor : Arrondi à l'entier inférieur (ex : 10.9 → 10)
  • ceil : Arrondi à l'entier supérieur (ex : 10.1 → 11)
  • round : Arrondi standard à l'entier le plus proche (ex : 10.5 → 11)

Particulièrement utile pour les calculs de taxes et le formatage des devises.

3. Regroupement

Ce paramètre est obligatoire. La Clé de regroupement détermine comment les lignes multiples sont traitées.

  • Mode ligne unique : Si chaque ligne de vos données représente un document unique, sélectionnez une colonne d'identifiant unique (ex : InvoiceID).
  • Mode multi-lignes : Si vos données contiennent plusieurs lignes pour un même document (ex : une facture avec 5 articles), sélectionnez la colonne qui identifie le document (ex : InvoiceID). Le moteur regroupera ces 5 lignes en un seul PDF.

4. Liaison de données

Utilisez cette section pour joindre les Données maîtres à vos Données transactionnelles, comme un VLOOKUP dans Excel.

  • Match Value (Import Data) : La colonne de vos données transactionnelles servant de « clé étrangère » (ex : CustomerID).
  • Lookup Key (Master Data) : La colonne d'identifiant unique dans vos données maîtres (ex : CustomerID).

Pourquoi utiliser cette fonction ? Si vos données transactionnelles ne contiennent que CustomerID « C001 » mais que vous souhaitez imprimer l'adresse complète du client sur la facture, liez vos données maîtres. Le système récupérera automatiquement l'adresse associée à « C001 ».

5. Configuration de sortie

  • Règle de nommage PDF : Définit le nom de fichier du PDF généré.
  • Par défaut : {{InvoiceNo}}.pdf

Vous pouvez utiliser des variables pour créer des noms de fichiers dynamiques, comme Invoice_{{InvoiceNo}}_{{Date}}.pdf.

6. Sources de données

Cette section vous aide à vérifier les mappages et à prévisualiser la connexion. Bien que le mappage manuel soit possible, le chargement de vos fichiers de données réels réduit considérablement les erreurs.

Formats pris en charge

  • Fichiers CSV (.csv)
  • Fichiers Excel (.xlsx, .xls)

Utilisation

  1. Cliquez sur Charger Données Source ou Charger Données Maître.
  2. Sélectionnez votre fichier dans l'explorateur de fichiers.
  3. Un dialogue d'Aperçu des Données apparaîtra.
  4. Vérifiez les données et cliquez sur Charger. Le système proposera automatiquement des mappages pour toutes les colonnes trouvées dans le fichier.