Variables live output v1 legacy — Tennis¶

V1 legacy déprécié

Cette page documente les anciennes clés tennis. Elles sont conservées uniquement pour relire un template historique et préparer la migration vers les clés v2.

Le tennis a une structure fondamentalement différente des sports collectifs. En v2, T1 et T2 représentent les deux côtés du match : un joueur en simple, ou une paire en double. En v1 legacy, les mêmes côtés étaient nommés E1 et E2.

Migration v1 -> v2¶

En v2, les côtés du match sont nommés T1 et T2. En simple, T1 / T2 représentent les joueurs. En double, ils représentent les paires.

Famille v2	Usage tennis
`STATUS`, `PERIOD`, `DATE`, `SURFACE`, `FORMAT`, `COURT`, `FIN_RULE`	Contexte match et tournoi.
`T1_NAME` / `T2_NAME`	Nom complet du joueur ou de la paire.
`T1_LAST` / `T2_LAST`	Nom de famille du joueur principal.
`T1_FIRST` / `T2_FIRST`	Prénom du joueur principal.
`T1P_NAME` / `T2P_NAME`	Nom du partenaire en double.
`T1_LOGO` / `T2_LOGO`	Photo joueur principal.
`T1_RANK`, `T2_RANK`, `T1_RSUF`, `T2_RSUF`	Rang et suffixe de rang.
`T1_NAT` / `T2_NAT`	Nationalité.
`T1_ATP` / `T2_ATP`	Classement ATP/WTA.
`T1_HAND` / `T2_HAND`	Main dominante.
`T1_SERVE`, `T2_SERVE`, `T1_SRV_IMG`, `T2_SRV_IMG`	Indicateur de service.
`T1_SETS`, `T2_SETS`, `SETS`, `SET_CUR`	Sets remportés et set courant.
`T1_GAMES`, `T2_GAMES`, `GAMES`	Jeux du set courant.
`T1_PTS`, `T2_PTS`, `POINTS`	Points du jeu courant.
`SERVER`, `SERV_SIDE`, `SERV_TEXT`	Serveur courant.
`TNS_SCORE`	Ligne scoreboard complète tennis.
`SET{N}_T1`, `SET{N}_T2`, `SET{N}_TB1`, `SET{N}_TB2`	Score par set et tie-break, de 1 à 5.
`T1_ACE`, `T2_ACE`, `T1_DBLF`, `T2_DBLF`, `T1_BRK`, `T2_BRK`, `T1_BRKS`, `T2_BRKS`	Statistiques tennis principales.

Correspondances v1 -> v2 tennis¶

V1 legacy déprécié	V2 actuel
`PERIODE`	`PERIOD`
`MESSAGE`	`MSG`
`ERROR`	`ERR_MSG`
`SET_ACTUEL` / `CURRENT_SET`	`SET_CUR`
`E1SCORE` / `E2SCORE`	`T1_SETS` / `T2_SETS`
`E1GAME` / `E2GAME`	`T1_GAMES` / `T2_GAMES`
`POINT_E1` / `POINT_E2`	`T1_PTS` / `T2_PTS`
`SETS_MLS` / `TENNIS_SCOREBOARD_MLS`	`TNS_SCORE`
`SERVER_SIDE` / `SERVER_MLS`	`SERV_SIDE`
`SERVER_TEXT`	`SERV_TEXT`
`FINAL_SET_RULE`	`FIN_RULE`
`E1NOM_FULL` / `E2NOM_FULL`	`T1_NAME` / `T2_NAME`
`E1NOM` / `E2NOM`	`T1_LAST` / `T2_LAST`
`E1PRENOM` / `E2PRENOM`	`T1_FIRST` / `T2_FIRST`
`E1LOGO` / `E2LOGO`	`T1_LOGO` / `T2_LOGO`
`E1CLASSEMENT` / `E2CLASSEMENT`	`T1_RANK` / `T2_RANK`
`E1NATIONALITE` / `E2NATIONALITE`	`T1_NAT` / `T2_NAT`
`E1ATP` / `E2ATP`	`T1_ATP` / `T2_ATP`
`E1MAIN` / `E2MAIN`	`T1_HAND` / `T2_HAND`
`E1_SERVE_IMG` / `E2_SERVE_IMG`	`T1_SRV_IMG` / `T2_SRV_IMG`
`SET{N}_E1` / `SET{N}_E2`	`SET{N}_T1` / `SET{N}_T2`
`E1_ACE` / `E2_ACE`	`T1_ACE` / `T2_ACE`
`E1_DBL_FAUTE` / `E2_DBL_FAUTE`	`T1_DBLF` / `T2_DBLF`
`E1_BREAK` / `E2_BREAK`	`T1_BRK` / `T2_BRK`
`E1_BREAK_SAVE` / `E2_BREAK_SAVE`	`T1_BRKS` / `T2_BRKS`
`E1_ABANDON` / `E2_ABANDON`	`T1_RET` / `T2_RET`
`E1_BLESSURE` / `E2_BLESSURE`	`T1_INJ` / `T2_INJ`

Détail des clés v1 legacy¶

Les sections ci-dessous décrivent l'ancien contrat tennis. Elles ne doivent plus être utilisées pour un nouveau template.

Modèle de données¶

Le tennis ne suit pas le même workflow que les sports d'équipe pour la composition :

il n'y a pas de titulaires ni de remplaçants ;
il n'y a pas de feuille de match à découper en lignes de composition dans ce référentiel ;
les données portent sur deux côtés de match, leurs sets, leurs statistiques et leur contexte de tournoi.

En simple, chaque côté contient un joueur. En double, chaque côté contient un joueur principal et un partenaire, affichés sous la forme Joueur / Partenaire dans les champs de nom complet.

Spécificités tennis¶

Simples et doubles : E1 = côté 1, E2 = côté 2. En double, les partenaires sont exposés avec les variables E1_PARTNER_... et E2_PARTNER_....
Score par sets : jusqu'à 5 sets, chaque set composé de jeux et d'un éventuel tie-break.
Scoreboard live : sets, jeux, points et serveur sont disponibles dans plusieurs alias pour faciliter le raccord avec les habillages.
Surface : exposée dans SURFACE (Terre battue, Gazon, Dur, Indoor).
Classement ATP/WTA : E1ATP et E2ATP.
Main dominante : E1MAIN et E2MAIN.

Variables générales¶

Champ	Type	Description
`STATUS`	Numérique	Statut brut du match (0–7)
`PERIODE`	Texte	Label du statut (ex : `EN COURS`, `SCORE FINAL`, `PAUSE`)
`DATE`	Texte	Date du match en français (ex : `Vendredi 8 août 2025`)
`SURFACE`	Texte	Surface de jeu : `TERRE_BATTUE`, `GAZON`, `DUR`, `INDOOR`
`SET_ACTUEL`	Numérique	Numéro du set en cours (1 à 5)
`E1SCORE`	Numérique	Nombre de sets remportés par le joueur 1
`E2SCORE`	Numérique	Nombre de sets remportés par le joueur 2
`TIMER`	Texte	Chrono ou durée saisie côté match, si utilisé par le template
`DUREE`	Texte	Durée calculée depuis `TIMER`
`SERVER`	Numérique	Serveur courant : `0` inconnu, `1` côté E1, `2` côté E2
`FORMAT`	Numérique	Format du match, par exemple meilleur des 3 ou 5 sets
`FINAL_SET_RULE`	Texte	Règle du set final, par exemple `tiebreak`
`COURT`	Texte	Court ou terrain du match
`MESSAGE`	Texte	Message d'accueil ou d'information
`ERROR`	Texte	Message d'erreur

Statuts de match¶

Valeur	Label `PERIODE`
`1`	EN COURS
`2`	PAUSE
`3`	SCORE FINAL
`4`	SUSPENSION
`5`	ABANDON
`6`	ANNULÉ
`7`	REPORTÉ

Variables journée / tour¶

Champ	Type	Description
`DAY`	Texte	Numéro du tour/journée (ex : `2`)
`DAY_EME`	Texte	Suffixe ordinal (ex : `e`, `er`)
`DAY_JOURNEE`	Texte	Type de phase (ex : `Tour`, `Journée`)
`DAY_FINALE`	Texte	Indication de finale (ex : `Quarts de Finale`)
`DAY_TERM`	Texte	Terme complet du tour (ex : `1er Tour`)

Variables météo¶

Champ	Type	Description
`METEO_CIEL`	Chemin image	Icône météo (ex : `Soleil.png`, `Pluie.png`)
`METEO_TEMP`	Texte	Température (ex : `22°C`)
`METEO_HUM`	Texte	Humidité (ex : `55%`)
`PICTO-TEMP`	Chemin image	Icône thermomètre (`TEMP_BAS.png` ou `TEMP_HAUT.png`)
`METEO_VENT`	Texte	Vitesse du vent (ex : `12km/h`)

Variables joueurs¶

Les joueurs sont identifiés par E1 (Joueur 1) et E2 (Joueur 2).

Champ	Type	Description
`E1NOM_FULL`	Texte	Nom complet (ex : `Rafael NADAL`)
`E1NOM`	Texte	Nom de famille en majuscules (ex : `NADAL`)
`E1PRENOM`	Texte	Prénom (ex : `Rafael`)
`E1LOGO`	Chemin image	Photo du joueur
`E1CLASSEMENT`	Texte	Classement dans le tournoi (rang)
`E1EME`	Texte	Suffixe du rang (`ER` pour 1er, `E` pour les autres)
`E1NATIONALITE`	Texte	Nationalité en majuscules (ex : `ESPAGNE`)
`E1ATP`	Texte	Classement ATP/WTA officiel (ex : `12`)
`E1MAIN`	Texte	Main dominante (ex : `DROITIER`, `GAUCHER`)
`E1_PARTNER_FULL`	Texte	Nom complet du partenaire côté E1 en double
`E1_PARTNER_NOM`	Texte	Nom du partenaire côté E1 en double
`E1_PARTNER_PRENOM`	Texte	Prénom du partenaire côté E1 en double
`E1_SERVE`	Texte	`1` si le joueur 1 est au service, sinon vide
`E1_SERVE_IMG`	Chemin image	Icône service : `/SOURCE/IMAGES/SERVE.png` ou `EMPTY.png`
`E1_SEED`	Texte	Tête de série du joueur 1 si renseignée

Même structure pour E2.

Pour E2, les variables partenaires équivalentes sont E2_PARTNER_FULL, E2_PARTNER_NOM et E2_PARTNER_PRENOM.

Photos joueurs¶

Les photos principales E1LOGO et E2LOGO pointent vers :

/SOURCE/PLAYERS/{player_name_serveur}.png

Les listes de résultats, programme, classement et tableau peuvent utiliser l'image exportée par l'application :

{player_name_serveur}.png

Si aucune image n'est disponible, l'export utilise EMPTY.png.

Variables scoreboard live¶

Ces variables décrivent le score courant du match. Plusieurs noms existent volontairement pour faciliter le raccord avec des habillages déjà construits.

Champ	Type	Description
`E1SCORE` / `E2SCORE`	Numérique	Sets remportés par E1 / E2
`E1SET` / `E2SET`	Numérique	Alias des sets remportés par E1 / E2
`E1SETS` / `E2SETS`	Numérique	Alias des sets remportés par E1 / E2
`SETS`	Texte	Score des sets au format `1-0`
`SETS_SCORE`	Texte	Alias de `SETS`
`SET_ACTUEL`	Numérique	Numéro du set courant
`CURRENT_SET`	Numérique	Alias de `SET_ACTUEL`
`E1GAME` / `E2GAME`	Numérique	Jeux remportés dans le set courant
`E1GAMES` / `E2GAMES`	Numérique	Alias des jeux du set courant
`E1JEUX` / `E2JEUX`	Numérique	Alias français des jeux du set courant
`GAMES`	Texte	Score des jeux au format `3-2`
`JEUX`	Texte	Alias français de `GAMES`
`POINT_E1` / `POINT_E2`	Texte	Points du jeu courant pour E1 / E2
`E1POINT` / `E2POINT`	Texte	Alias des points du jeu courant
`E1POINTS` / `E2POINTS`	Texte	Alias des points du jeu courant
`POINT`	Texte	Score des points au format `40-30`
`POINTS`	Texte	Alias de `POINT`
`SERVER`	Numérique	Serveur courant : `0`, `1` ou `2`
`SERVER_SIDE`	Texte	Côté au service : `E1`, `E2` ou vide
`SERVER_TEXT`	Texte	Nom affichable du joueur ou de la paire au service
`SETS_MLS` / `sets_mls`	Texte	Ligne complète : sets, jeux, points et service
`TENNIS_SCOREBOARD_MLS`	Texte	Alias de la ligne complète
`GAMES_MLS` / `games_mls`	Texte	Score des jeux au format `3-2`
`POINTS_MLS` / `points_mls`	Texte	Score des points au format `40-30`
`SERVER_MLS` / `server_mls`	Texte	Côté au service : `E1`, `E2` ou vide

Les points peuvent être 0, 15, 30, 40, Av ou une valeur numérique en tie-break.

Variables de score par set¶

Pour chaque set de 1 à 5 :

Champ	Type	Description
`SET1_E1`	Numérique	Jeux remportés par le joueur 1 au set 1
`SET1_E2`	Numérique	Jeux remportés par le joueur 2 au set 1
`SET1_TB1`	Numérique	Score tie-break joueur 1 au set 1
`SET1_TB2`	Numérique	Score tie-break joueur 2 au set 1

Pattern : SET{N}_E1, SET{N}_E2, SET{N}_TB1, SET{N}_TB2 — de N=1 à N=5.

Variables d'événements¶

Les événements sont comptabilisés par joueur et par type.

Champ	Type	Description
`E1_ACE`	Numérique	Nombre d'aces du joueur 1
`E2_ACE`	Numérique	Nombre d'aces du joueur 2
`E1_DBL_FAUTE`	Numérique	Doubles fautes — joueur 1
`E2_DBL_FAUTE`	Numérique	Doubles fautes — joueur 2
`E1_BREAK`	Numérique	Breaks réalisés — joueur 1
`E2_BREAK`	Numérique	Breaks réalisés — joueur 2
`E1_BREAK_SAVE`	Numérique	Breaks sauvés — joueur 1
`E2_BREAK_SAVE`	Numérique	Breaks sauvés — joueur 2
`E1_ABANDON`	Numérique	Abandons — joueur 1 (0 ou 1)
`E2_ABANDON`	Numérique	Abandons — joueur 2 (0 ou 1)
`E1_BLESSURE`	Numérique	Blessures signalées — joueur 1
`E2_BLESSURE`	Numérique	Blessures signalées — joueur 2

Ces mêmes données sont aussi accessibles via les identifiants numériques : EVENT_1_E1 (Aces), EVENT_2_E1 (Double fautes), EVENT_3_E1 (Breaks), EVENT_4_E1 (Breaks sauvés), EVENT_5_E1 (Abandon), EVENT_6_E1 (Blessure).

Variables commentateurs & arbitre¶

Champ	Type	Description
`LINER_REFEREE`	Texte	Nom de l'arbitre de chaise
`LINER_COM1`	Texte	Commentateur 1 (Prénom NOM)
`LINER_COM2`	Texte	Commentateur 2 (Prénom NOM)
`LINERCOM`	Texte	Les deux commentateurs combinés (séparateur `-`)

Variables résultats (SED — 20 positions)¶

Pour un affichage de scores d'autres matchs en cours, positions SED_1 à SED_20 :

Champ	Type	Description
`SED_{N}_E1`	Texte	Nom du joueur 1 du match N
`SED_{N}_E2`	Texte	Nom du joueur 2 du match N
`SED_{N}_S1`	Numérique	Sets remportés par le joueur 1
`SED_{N}_S2`	Numérique	Sets remportés par le joueur 2
`SED_{N}_SETS`	Texte	Détail des sets (ex : `6-3 7-5`)
`SED_{N}_L1`	Chemin image	Photo joueur 1
`SED_{N}_L2`	Chemin image	Photo joueur 2
`SED_{N}_T`	Texte	Séparateur de score, généralement `-`
`SED_{N}_F`	Chemin image	Fond graphique du résultat

Variables programme (P — 20 positions)¶

Champ	Type	Description
`P_{N}_DATE`	Texte	Date du match N
`P_{N}_E1`	Texte	Nom complet joueur 1
`P_{N}_E2`	Texte	Nom complet joueur 2
`P_{N}_S1`	Numérique	Sets joueur 1 (si terminé)
`P_{N}_S2`	Numérique	Sets joueur 2 (si terminé)
`P_{N}_L1`	Chemin image	Photo joueur 1
`P_{N}_L2`	Chemin image	Photo joueur 2
`P_{N}_T`	Texte	Séparateur de score
`P_{N}_H`	Texte	Heure de début (ex : `14H30`)
`P_{N}_F`	Chemin image	Fond graphique

Variables classement (CL)¶

Par groupe (4 groupes × 20 joueurs)¶

Champ	Description
`CL_G{G}_NOM`	Nom du groupe (ex : `GROUPE A`)
`CL_G{G}_{P}_RANK`	Rang dans le groupe
`CL_G{G}_{P}_NOM`	Nom de famille du joueur
`CL_G{G}_{P}_PRENOM`	Prénom du joueur
`CL_G{G}_{P}_FULL`	Nom complet (Prénom NOM)
`CL_G{G}_{P}_IMG`	Photo du joueur
`CL_G{G}_{P}_MJ`	Matchs joués
`CL_G{G}_{P}_V`	Victoires
`CL_G{G}_{P}_D`	Défaites
`CL_G{G}_{P}_SG`	Sets gagnés
`CL_G{G}_{P}_SP`	Sets perdus
`CL_G{G}_{P}_PTS`	Points
`CL_G{G}_{P}_UP`	Nombre de places gagnées
`CL_G{G}_{P}_DN`	Nombre de places perdues
`CL_G{G}_{P}_MV`	Icône `UP.png`, `DOWN.png` ou `EMPTY.png`

Classement global (80 joueurs)¶

Même colonnes avec CL_{1-80}_*, plus CL_{N}_GROUP (nom du groupe). Les icônes de mouvement doivent être disponibles dans /SOURCE/IMAGES/CLASSEMENT/.

Variables tableau (bracket)¶

Le tableau tennis est exposé par phase/tour et en liste globale.

Variable	Type	Description
`BR_P{PHASE}_NOM`	Texte	Nom de la phase.
`BR_P{PHASE}_CODE`	Texte	Code de la phase.
`BR_P{PHASE}_R{ROUND}_NOM`	Texte	Nom du tour.
`BR_P{PHASE}_R{ROUND}_{MATCH}_E1`	Texte	Joueur 1 du match.
`BR_P{PHASE}_R{ROUND}_{MATCH}_E2`	Texte	Joueur 2 du match.
`BR_P{PHASE}_R{ROUND}_{MATCH}_L1`	Chemin image	Photo joueur 1 ou `EMPTY.png`.
`BR_P{PHASE}_R{ROUND}_{MATCH}_L2`	Chemin image	Photo joueur 2 ou `EMPTY.png`.
`BR_P{PHASE}_R{ROUND}_{MATCH}_S1`	Texte	Sets joueur 1.
`BR_P{PHASE}_R{ROUND}_{MATCH}_S2`	Texte	Sets joueur 2.
`BR_P{PHASE}_R{ROUND}_{MATCH}_STATUS`	Texte	Statut brut du match.
`BR_{N}_E1` / `BR_{N}_E2`	Texte	Joueurs du match global N.
`BR_{N}_L1` / `BR_{N}_L2`	Chemin image	Photos du match global N.
`BR_{N}_S1` / `BR_{N}_S2`	Texte	Sets du match global N.
`BR_{N}_STATUS`	Texte	Statut brut.
`BR_{N}_ROUND`	Texte	Nom du tour.
`BR_{N}_PHASE`	Texte	Nom de la phase.

Contrairement aux sports collectifs, le tableau tennis n'exporte pas TAB1 / TAB2.

Résumé des différences avec les sports collectifs¶

Élément	Sports collectifs (Football, etc.)	Tennis
Entités E1/E2	Équipes (clubs)	Joueur en simple ou paire en double
Score	Buts/points totaux	Sets remportés (`E1SCORE`, `E2SCORE`)
Détail du score	Par période/quart	Par set : `SET1_E1` à `SET5_E1`
Tie-break	(non)	`SET{N}_TB1`, `SET{N}_TB2`
Chrono exporté	`CLOCK_MLS`	(aucun)
Variable de surface	(non)	`SURFACE`
Classement joueur	`E1CLASSEMENT` (tournoi)	`E1CLASSEMENT` + `E1ATP`
Main dominante	(non)	`E1MAIN`, `E2MAIN`
Nationalité	(non)	`E1NATIONALITE`, `E2NATIONALITE`
Formations	Oui (football)	(non)
Joueurs (rosters)	Titulaires + remplaçants + staff selon championnat	(non — joueurs/paires)

Préparation de l'habillage¶

Les noms de champs doivent correspondre exactement aux noms de variables (casse incluse).
Les images vides utilisent EMPTY.png.
Chemins d'images : photos principales dans /SOURCE/PLAYERS/, autres listes avec les images exposées par l'application.
Le £_0 à £_99 suffix fonctionne aussi pour le tennis : E1NOM_FULL£_0 est identique à E1NOM_FULL.
Les données tennis doivent être préparées directement au niveau des joueurs et du tableau, sans logique de composition collective.