# Mappers data d'événements (/docs/planification/mappers-data-evenements) ## Vue d'ensemble [#vue-densemble] Un **mapper data d'événement** est un **formulaire personnalisé** que tu attaches à un événement pour saisir des données spécifiques à ton contexte : suivi médical, données externes saisies à la main, ressentis joueurs, infos de match… C'est avant tout un **moyen pour le coach (ou le staff) d'intégrer de la donnée**, à la différence des [questionnaires](/docs/questionnaires/creer-un-questionnaire) qui sont eux un canal pour **récolter de la donnée auprès des joueurs**. Concrètement : tu définis une **liste de champs** (texte, nombre, date, choix, oui/non, couleur…) avec une **portée** (« événement » ou « par joueur »), tu sauvegardes le mapper, et tu peux ensuite l'attacher à n'importe quel événement où une grille de saisie apparaîtra. **Mapper data ≠ Mapper de variables.** Les [mappers de variables](/docs/creation-seances/mappers-variables) sont attachés à un **exercice** et calculent automatiquement des charges (1RM, VMA…). Les mappers data décrits ici sont attachés à un **événement** et ne font **aucun calcul** : ce sont des conteneurs de champs que tu remplis à la main. ## Anatomie d'un mapper [#anatomie-dun-mapper] Trois éléments : 1. **Nom du mapper** — apparaît dans la sidebar et dans la fiche événement. 2. **Couleur** — pour le repérer visuellement. 3. **Portée** : * **Événement** — une seule saisie pour l'événement entier (ex: météo et arbitre d'un match). * **Par joueur** — un tableau avec une ligne par joueur convoqué (ex: ressenti post-séance individuel). 4. **Champs personnalisés** — ce que l'utilisateur devra remplir. ### Les 13 types de champs disponibles [#les-13-types-de-champs-disponibles] | Type | Cas d'usage | | ---------- | --------------------------------------------------------------- | | `text` | Texte court (nom d'arbitre, libellé) | | `textarea` | Texte long (commentaire, observations) | | `number` | Valeur numérique (distance, RPE, sévérité 1-10) | | `date` | Date isolée (date d'apparition d'une douleur) | | `time` | Heure (heure de prise de RPE) | | `datetime` | Date + heure | | `boolean` | Vrai / Faux | | `checkbox` | Case à cocher (présence d'un signe, validation) | | `select` | Choix dans une liste (état physique : frais / normal / fatigué) | | `color` | Sélecteur de couleur | | `email` | E-mail (avec validation format) | | `url` | URL (avec validation format) | | `phone` | Numéro de téléphone | Chaque champ peut avoir une **valeur par défaut** et être marqué **obligatoire**. ## Créer un mapper [#créer-un-mapper] 1. Ouvre le calendrier de **Planification**, dans la sidebar gauche, déplie la section **Mappers data**. 2. Clique sur **+** à côté de « Mes mappers » pour ouvrir la modale de création. 3. Renseigne : * **Nom du mapper** (ex: « Informations médicales ») * **Couleur** dans la palette * **Portée du mapper** — toggle entre « Événement » et « Par joueur » 4. Ajoute un ou plusieurs **champs personnalisés** : * **Nom du champ** * **Type de champ** (parmi les 13 listés) * **Options** (si type = `select` — au moins une option requise) * **Valeur par défaut** (optionnel) * **Champ obligatoire** (switch) 5. Tu peux **réordonner** les champs en les glissant (poignée à gauche). 6. Bouton **Créer le mapper**. ## Attacher un mapper à un événement [#attacher-un-mapper-à-un-événement] Deux façons : ### Depuis la fiche événement (onglet Data) [#depuis-la-fiche-événement-onglet-data] À la création ou à l'édition d'un événement, dans l'onglet **Data**, tu coches les mappers à attacher. Selon la portée : * **Portée « Événement »** — une grille de saisie en 3 colonnes apparaît avec les champs du mapper. * **Portée « Par joueur »** — un tableau apparaît : 1 ligne par joueur convoqué, 1 colonne par champ du mapper. Les valeurs sont **enregistrées avec l'événement** quand tu cliques Sauvegarder. Pour **retirer** un mapper attaché, décoche-le ou utilise le bouton X — les données saisies sont perdues. ### Drag & drop sur un événement existant [#drag--drop-sur-un-événement-existant] Depuis la sidebar, **glisse un mapper** sur un événement du calendrier. Le mapper s'attache à l'événement sans avoir à rouvrir la fiche. ## Préenregistrer un mapper sur un template [#préenregistrer-un-mapper-sur-un-template] Un template d'événement peut **inclure un ou plusieurs mappers par défaut**. Tous les événements créés à partir du template auront ces mappers attachés automatiquement, prêts à remplir. Cas typique : un template Match qui inclut un mapper « Conditions du match » (météo, arbitre, surface) — chaque match créé via le template attend simplement la saisie au moment du report. Voir [Templates d'événement](/docs/planification/templates-personnalises). ## 4 cas d'usage concrets [#4-cas-dusage-concrets] **1. Suivi médical par événement** Mapper « Bilan séance » en portée **Événement**, avec : zone douloureuse (text), sévérité (number 1-10), commentaire médecin (textarea). Attaché aux séances de réathlétisation, rempli en fin de séance par le préparateur ou le kiné. **2. Saisie GPS manuelle** Mapper « GPS manuel » en portée **Par joueur**, avec : distance totale (number), vitesse max (number), nombre de sprints (number), distance haute intensité (number). Utile quand tu n'as pas de boîtier GPS sur certaines séances mais que tu veux garder un suivi homogène. **3. Ressenti post-séance par joueur** Mapper « Post-séance » en portée **Par joueur**, avec : RPE perçu (number 0-10), état physique (select : frais / normal / fatigué / très fatigué), commentaire libre (textarea). Le staff remplit la ligne de chaque joueur en fin d'entraînement. **4. Conditions de match** Mapper « Match : conditions » en portée **Événement**, avec : arbitre principal (text), météo (select : beau / nuageux / pluie / neige), surface (select : herbe / synthétique / hybride), incidents notables (textarea). Préenregistré sur le template Match. ## Mappers personnels vs mappers club [#mappers-personnels-vs-mappers-club] * **Personnels** — créés par un coach pour son usage propre. * **Club** — créés par un compte club ou rattaché à un club, partagés avec tout le staff. Seul le **propriétaire** peut modifier ou supprimer un mapper. ## Limites actuelles [#limites-actuelles] À garder en tête : * **Pas de calcul automatique, pas de formule** — un mapper ne fait que **stocker** les valeurs saisies. Aucune dérivation, aucune agrégation. * **Pas de rétro-application** — attacher un mapper à un événement n'est valable que pour cet événement. Pour collecter une même donnée sur tous les événements existants, il faut les rouvrir un à un. Si tu cherches à **suivre statistiquement** une donnée dans le temps, regarde plutôt : * [Questionnaires](/docs/questionnaires/creer-un-questionnaire) — pour les données subjectives (bien-être, douleur, fatigue) que tu veux suivre dans la durée. * [Indicateurs de dashboard](/docs/dashboards/indicateurs-disponibles) — pour les sources standardisées (charge, GPS, tests, blessures). ## Erreurs à éviter [#erreurs-à-éviter] * **Mapper pour une donnée déjà standard** — avant de créer un mapper « RPE » en saisie manuelle, vérifie qu'un questionnaire RPE ne ferait pas mieux le job (il alimente les dashboards, le mapper non). * **Trop de champs dans un mapper** — passé 6-8 champs, la saisie devient pénible. Mieux vaut deux mappers dédiés (médical + logistique) qu'un mapper fourre-tout. * **Confusion portée Événement / Par joueur** — un ressenti se remplit par joueur (portée Par joueur), une condition de match se remplit une fois pour tous (portée Événement). Choisir la mauvaise portée oblige à recréer le mapper. ## Aller plus loin [#aller-plus-loin]