# Qualifications — Guide de l'utilisateur

Cette extension génère la **qualified riders list** et la **reserve list** pour une compétition de jumping dans Equipe, puis les importe dans Equipe en un clic.

Elle peut prendre en compte :

- les cavaliers qualifiés à partir d'**une ou deux classes de qualification** (Q1 / Q2) ;
- les cavaliers **pré-qualifiés par la FEI** (Jeux Olympiques, Championnats du Monde, Coupe du Monde Finale…) ;
- les **Champions Nationaux** (combinaison cheval + cavalier) ;
- une **liste de réserve**.

---

## Avant de commencer

- Les classes de qualification sont configurées dans Equipe et leurs **résultats ont été saisis**.
- Les listes de destination (**qualification list** et **reserve list**) existent dans Equipe.
- Si une classe de qualification a été divisée en deux groupes, fusionnez-les d'abord (voir [Split classes](#split-classes)).

> Seules les compétitions de la **semaine en cours** (du lundi au dimanche) sont affichées.

L'écran comporte trois parties : **Pre-qualified riders**, **Qualification setup** et **Reserves**.

---

## 1. Pre-qualified riders

### FEI pre-qualified riders

L'extension conserve la liste des cavaliers automatiquement qualifiés par la FEI pour le Grand Prix lors des événements CSI. Cette liste est partagée par toutes les compétitions.

**Mettre à jour la liste** (après chaque championnat majeur) :

1. Téléchargez le dernier PDF du site de la FEI (*Athletes/Horses automatically qualified for the Grand Prix Competition at CSI Events*).
2. Cliquez sur **Update from PDF** et sélectionnez le fichier.
3. Les cavaliers et leurs titres sont lus automatiquement ; un cavalier listé sous plusieurs titres n'apparaît qu'une seule fois.

Le panneau affiche la date de la dernière mise à jour et le nombre de cavaliers.

### National Champions

Un Champion National est pré-qualifié **avec un cheval spécifique**. Si ce cheval n'est pas présent au concours, le champion n'est pas pré-qualifié.

**Ajouter un champion** : remplissez le formulaire en bas du panneau, puis cliquez sur **Add champion**.

| Champ | Ce qu'il faut saisir |
|---|---|
| Rider | Nom exactement tel qu'il apparaît dans Equipe |
| Horse | Nom exactement tel qu'il apparaît dans Equipe |
| Country | Code à 3 lettres (FRA, BEL…) |
| Year | Année du championnat |

Il y a un champion par pays et par an : en ajouter un nouveau remplace le précédent.
Pour supprimer un champion, cliquez sur **×** à la fin de la ligne.

### Utiliser les cavaliers pré-qualifiés dans cette compétition

1. Cochez **Apply pre-qualified riders to this qualification**.
2. Sous **Sources**, cochez **FEI Pre-qualified** et/ou **National Champions**.
3. Pour les National Champions, cochez dans la liste les champions à inclure **pour ce concours** — vous n'êtes pas obligé de tous les utiliser.
4. Choisissez le **Placement** :

| Placement | Résultat |
|---|---|
| **Before Q1 (separate slot)** | Les cavaliers pré-qualifiés passent en premier, puis la Q1 prend son quota complet, puis la Q2 complète la liste jusqu'au **Total riders target** |
| **Counts in Q1 quota** | Les cavaliers pré-qualifiés occupent des places dans le quota de la Q1 |
| **Counts in Q2 quota** | Les cavaliers pré-qualifiés occupent des places dans le quota de la Q2 |

*Exemple avec "Before Q1" et une cible de 50 : 1 FEI + 15 de la Q1 + 34 de la Q2 = 50 cavaliers.*

---

## 2. Qualification setup

### Choisir les classes

| Champ | Ce qu'il faut choisir |
|---|---|
| **Qualification 1** | Première classe de qualification |
| **Qualification 2** | Deuxième classe de qualification (optionnel) |
| **Number of riders** | Nombre de cavaliers à prendre dans chaque classe |
| **Qualif 1 / Qualif 2 is a grouped list** | Cochez si la classe a été fusionnée avec *Group splitted classes* |
| **Qualification List** | La liste Equipe où les cavaliers qualifiés seront importés |

### Options

- **Return to Qualif 1 if the quota is not reached** — si la Q2 ne donne pas assez de cavaliers, la liste est complétée par les cavaliers suivants de la Q1.
- **Put Riders only in Qualif List** — importe les cavaliers sans leurs chevaux.

### Générer et vérifier la liste

Cliquez sur **Generate Qualified riders list**. Pour chaque cavalier, vous voyez la position, le numéro de cheval, le nom, le classement, l'**origin**, le titre FEI (le cas échéant) et un résumé du résultat.

| Origin | Signification |
|---|---|
| **FEI PRE-QUALIFIED** (violet) | Pré-qualifié par la FEI |
| **NAT CHAMPION XXX** (jaune) | Champion National du pays XXX |
| **QUALIFICATION 1** (bleu) | Qualifié via la Q1 |
| **QUALIFICATION 2** (vert) | Qualifié via la Q2 |
| **RETURN TO QUALIFICATION 1** (orange) | Ajouté depuis la Q1 car la Q2 n'était pas suffisante |

"Auto-qualified" dans la colonne résultat signifie que le cavalier est pré-qualifié et n'a pas eu besoin de concourir.

**Qui est pris en compte ?**

- Un cavalier **abandonné ou éliminé au premier tour** n'est pas qualifié.
- Un cavalier abandonné ou éliminé **uniquement lors du jump-off** reste qualifié, classé sur le premier tour.
- Un cavalier sans classement n'est pas retenu.
- Si le même cheval apparaît deux fois, seule la première entrée est conservée.

### Importer dans Equipe

Vérifiez la liste, puis cliquez sur **Import Qualified riders to Equipe** et confirmez la liste de destination.

> **Une importation ne peut pas être annulée.** Vérifiez toujours la liste avant d'importer.

---

## 3. Reserves

1. Choisissez la **Reserve List** (destination dans Equipe) et le **Number of reserves**.
2. Cliquez sur **Generate Reserves list** pour prévisualiser.
3. Cliquez sur **Import Reserves to Equipe**.

Les réserves suivent les mêmes règles que les cavaliers qualifiés : les cavaliers déjà qualifiés sont écartés, et les cavaliers abandonnés ou éliminés au premier tour ne sont pas retenus. Avec **Return to Qualif 1**, la Q1 complète les réserves lorsque la Q2 est épuisée.

---

## Split classes

Lorsqu'une classe de qualification comportait trop de cavaliers et a été divisée en deux groupes dans Equipe :

1. Fusionnez les groupes avec l'extension **Group splitted classes**.
2. Dans **Qualification setup**, sélectionnez la liste fusionnée et cochez **Qualif 1 is a grouped list** (ou Qualif 2).

---

## FAQ

**Un cavalier manque dans la liste des qualifiés.**
Il s'est retiré ou a été éliminé au premier tour, n'a pas de classement, ou son cheval apparaît déjà plus haut dans la liste.

**Un cavalier FEI n'apparaît pas comme pré-qualifié.**
Le cavalier n'est pas inscrit à ce concours.

**Un Champion National ne s'affiche pas.**
Le cheval n'est pas présent au concours, ou le nom du cavalier/cheval ne correspond pas exactement à Equipe.

**Les cavaliers de la Q2 sont manquants.**
Vérifiez que la `Qualification 2` est sélectionnée et que son nombre de cavaliers est défini.

**La liste de réserve est incomplète.**
La Q2 n'a plus de cavaliers : cochez **Return to Qualif 1** pour compléter à partir de la Q1.