# Import Hippodata — Guide utilisateur

Cette extension importe un événement FEI depuis **Hippodata** vers Equipe : les **competitions**, les **start lists** et les **results**, y compris les **team competitions** (Coupe des Nations).

Vous pouvez tout importer en une seule fois, ou étape par étape au fur et à mesure du concours.

---

## Avant de commencer

- Ouvrez le concours dans Equipe.
- Munissez-vous du **FEI Show ID** de l'événement (l'identifiant de l'événement FEI).

---

## 1. Trouver l'événement

1. Dans Equipe, ouvrez le concours et cliquez sur **Import from Hippodata**.
2. Saisissez le **FEI Show ID**.
3. Cliquez sur **Search Event**.

L'extension affiche le nom de l'événement, le lieu, ainsi que la liste de toutes ses compétitions avec leur statut d'importation.

---

## 2. Choisir quoi importer

Pour chaque compétition, cochez ce que vous souhaitez importer :

| Option | Ce qu'elle importe |
|---|---|
| **Class Import** | La compétition elle-même : nom, dates, dotations, article FEI |
| **Startlist Import** | Cavaliers, chevaux et engagements |
| **Result Import** | Résultats : temps, fautes, classements, statuts |
| **Team Class** | Marque la compétition comme un événement par équipe (Coupe des Nations) |
| **FEI Article** | Le format de la compétition selon les règles de la FEI |

**Statut de chaque élément**

| Indicateur | Signification |
|---|---|
| ✓ Crochet vert | Déjà importé |
| Case à cocher | Disponible pour l'importation |
| Case grisée | Pas encore disponible — importez d'abord les éléments précédents (ex: la compétition avant sa start list) |

**Combinaisons possibles**

| Vous cochez | Utilisation typique |
|---|---|
| Uniquement les classes | Préparer le concours |
| Uniquement les start lists | Les compétitions existent déjà |
| Uniquement les résultats | Mise à jour après la compétition |
| Classes + start lists | Importation complète avant la compétition |
| Classes + résultats | Importation après coup, avec les résultats |
| Start lists + résultats | Mise à jour complète |
| Tout | Importation complète en une seule fois |

Cliquez sur **Import** pour commencer.

Les cavaliers et les chevaux qui existent déjà dans Equipe sont reconnus et **ne sont pas dupliqués**.

---

## 3. Compétitions par équipe (Coupe des Nations)

Lorsque **Team Class** est coché, l'extension :

- crée une **équipe pour chaque nation avec au moins 3 cavaliers** ;
- crée les clubs nationaux avec leurs drapeaux ;
- lie chaque cavalier à son équipe nationale ;
- importe les résultats par équipe.

Un cavalier ayant effectué le premier tour mais n'ayant **pas démarré le second tour** est marqué **Abstained** : ses fautes du premier tour comptent toujours pour l'équipe, et le résultat affiche par exemple `8-ABST`.
Un cavalier **éliminé** ou **abandon** conserve ce statut ; il n'est pas marqué comme "abstention".

---

## 4. Contenu des résultats

- Jusqu'à **5 tours** par compétition, avec les temps, les fautes et les classements.
- Statuts spéciaux : **Eliminated**, **Retired**, **Disqualified**, **Withdrawn**, **No show** et, pour les équipes, **Abstained**.

---

## FAQ

**Une compétition ne peut pas être cochée pour les start lists ou les résultats.**
La compétition elle-même n'a pas encore été importée : cochez également **Class Import**, ou importez-la d'abord.

**Un cavalier affiche "Abstained" dans une compétition individuelle.**
Cela n'arrive que dans les compétitions par équipe. Vérifiez que **Team Class** n'a été coché que pour les événements par équipe, puis réimportez les résultats.

**Un cavalier éliminé ou ayant abandonné affiche le mauvais statut.**
Réimportez les résultats une fois que Hippodata a publié les résultats finaux.

**Des cavaliers ou des chevaux apparaissent deux fois.**
Ils existent dans Equipe sous un nom ou un ID FEI différent de celui de Hippodata. Fusionnez-les dans Equipe.