# Extensie FFE ⇄ Equipe — Gebruikershandleiding

### 1. Wat de extensie doet

De extensie verbindt de **FFE (Franse Equestrische Federatie, FFECompet)** met **Equipe**, voor **springen** en **dressuur**:

- **Import**: het leest het XML-inschrijvingsbestand dat uit FFECompet is geëxporteerd en maakt automatisch wedstrijden, ruiters, paarden, clubs, officials en inschrijvingen aan in Equipe.
- **Export**: zodra de wedstrijden zijn voltooid, genereert het resultatenbestanden in FFE-formaat (FFECompet V24 TXT of SIF XML) om deze weer te uploaden naar FFECompet.

### 2. Vereisten

- De FFE-extensie is ingeschakeld voor de show in Equipe.
- U heeft het XML-inschrijvingsbestand gedownload van FFECompet (bijv. `202642038.xml`).
- **Eén bestand per discipline**: de FFE vereist een apart resultatenbestand voor elke discipline. Een gemengde spring- en dressuurshow produceert daarom twee exportbestanden (zie sectie 7).

### 3. De extensie openen

Open de show in Equipe en start vervolgens de FFE-extensie. De verbinding met Equipe is automatisch: er hoeft geen sleutel of URL te worden ingevoerd.

Gebruik de 🇫🇷 / 🇬🇧 vlaggen rechtsboven om de taal van de interface te wijzigen.

Bij het openen controleert de extensie of de show al FFE-wedstrijden bevat:
- **geen** → het scherm voor import wordt direct getoond;
- **minstens één** → de lijst met geïmporteerde wedstrijden wordt getoond.

Gebruik de knoppen **View imports** en **New import** om tussen de schermen te schakelen.

### 4. Inschrijvingen importeren

1. Klik op **New import**.
2. Selecteer het FFE XML-bestand en klik op **Analyse file**.
3. Controleer de samenvatting:
   - naam van de show, FFE-nummer, datums en organisator;
   - aantal wedstrijden, ruiters, officials, paarden, clubs en inschrijvingen.
4. **Selecteer de wedstrijden** om te importeren. Ze zijn gegroepeerd per datum; een badge geeft de discipline aan (**H** = springen, **D** = dressuur). Alles is standaard aangevinkt; gebruik *Select all* / *Deselect all* in het blok **Quick selection**.
5. Kies het **level** van de wedstrijd (Club, Local, Regional, National, Elite, International).
6. Klik op **Import**.

#### Wat er wordt aangemaakt in Equipe

| Item | Springen | Dressuur |
|---|---|---|
| Competitions | Naam = FFE-categorie (bijv. "Préparatoire (1,10 m)"), weergegeven nummer `FFE-1`, `FFE-2`… | Zelfde |
| Judging | Judging table omgezet van het FFE-artikel naar het overeenkomstige 2026 FEI-artikel (bijv. 238.1.1 → 220.1.1.1) | Test herkend vanuit het FFE-protocol |
| Height | Uitgelezen uit de categorienaam (bijv. "(1,10 m)") | — |
| Arena and time | Arena naam en starttijd | Zelfde |
| Entries | Ruiters, paarden (SIRE-nummer), clubs, startnummers | Zelfde |
| Officials | Officials vermeld in de XML | Zelfde |
| Custom fields | "Engagement terrain" (inschrijving ter plaatse) en "Invitation organisateur" (uitnodiging organisator), aangemaakt als minstens één geïmporteerde wedstrijd deze toestaat | Zelfde |

> **Opnieuw importeren**: u kunt een bijgewerkt XML-bestand opnieuw importeren (nieuwe inschrijvingen, etc.). Wedstrijden die u **handmatig heeft bewerkt** in Equipe, worden niet overschreven.

> **Judging tables**: bij het analyseren van de XML wordt ook de FFE-jurytafel van elke wedstrijd opgeslagen, die vervolgens wordt getoond in de lijst met geïmporteerde wedstrijden. Voor wedstrijden die al zijn geïmporteerd, analyseert u simpelweg de XML opnieuw (New import → Analyse → Back), zonder opnieuw te importeren.

### 5. De show draaien in Equipe

Draai de show zoals gebruikelijk in Equipe: startvolgorde, scoren, ranglijsten, prijzengeld.

**Inschrijvingen ter plaatse**: een inschrijving die ter plaatse is gemaakt, wordt gemarkeerd met een **negatief startnummer** (bijv. `-5`) of met het custom field *Engagement terrain*. Deze wordt automatisch aan de FFE doorgegeven in het exportbestand.

**Dressuur**: plaats de juryleden op hun posities (C, H, M, B, E) en voer de scores van elke juryleden in in Equipe. De export bevat de score en het percentage van elke juryleden, het gemiddelde, het totaal en de collectieve scores.

### 6. Geïmporteerde wedstrijden monitoren

Het scherm **View imports** toont de FFE-wedstrijden van de show, gegroepeerd per datum. Elke regel toont:

- de discipline (**H** = springen, **D** = dressuur), het wedstrijdnummer en de naam, het FFE-shownummer;
- de FFE-jurytafel (bijv. "Barème A sans chrono, sans barrage `238.1.1`"), indien deze is opgeslagen tijdens het analyseren van de XML;
- **Results**: 🏆 minstens één combinatie heeft een resultaat · 🕓 wedstrijd nog niet voltooid;
- **Exports**: exportknoppen, worden alleen getoond wanneer er resultaten zijn.

Boven de lijst wordt de status van de **custom fields** weergegeven:
- ✅ **present**: alles is aanwezig;
- ❌ **missing**: klik op **Create** om ze aan de show toe te voegen.

#### Het tonen van de custom fields in de startlijst

De twee velden (*Engagement terrain* — inschrijving ter plaatse, en *Invitation organisateur* — uitnodiging organisator) worden standaard niet getoond in de startlijsten van Equipe. Om deze weer te geven:

1. Open de startlijst van een wedstrijd in Equipe.
2. Menu **Tools** → **Field selector** (sneltoets `v` `v`).
3. Voeg de kolom **Start custom fields** toe.

Beide velden verschijnen dan als kolommen: u kunt in één oogopslag zien welke combinaties ter plaatse zijn ingeschreven of door de organisator zijn uitgenodigd, en deze indien nodig aanvinken of uitvinken. Deze waarden zijn de waarden die in het exportbestand aan de FFE worden doorgegeven.

De knop **Refresh** ververst de lijst.

### 7. Resultaten exporteren naar de FFE

| Knop | Inhoud | Formaat |
|---|---|---|
| **FFE** (op een rij) | Resultaten van één wedstrijd | FFECompet V24 TXT |
| **SIF** (op een rij) | Resultaten van één wedstrijd | WinJump / SIF XML |
| **Export all** (onder de lijst) | Alle wedstrijden die zijn voltooid | FFECompet V24 TXT |

Het bestand wordt automatisch gedownload; upload het vervolgens in FFECompet.

> **Gemengde spring- + dressuurshow**: **Export all** bereidt één bestand per discipline voor, maar **downloadt alleen het eerste bestand**. Er verschijnt vervolgens een melding waarin staat hoeveel bestanden er zijn gegenereerd. Gebruik voor de andere discipline de **FFE** knop van elke wedstrijd.

#### Wat de export bevat

| | Springen | Dressuur |
|---|---|---|
| Per combinatie | Fouten en tijd (rondgang en jump-off), plaatsing, prijzengeld | Score en percentage van elke juryrechter (C, H, M, B, E), gemiddeld %, totaal, collectieve punten, plaatsing, prijzengeld |
| Status | Geëlimineerd (EL), gestopt (AB), gediskwalificeerd (DI), non-starter (NP) | Zelfde |

In alle gevallen:
- alleen **combinaties die daadwerkelijk hebben deelgenomen** worden geëxporteerd;
- een **wedstrijd die nog niet is voltooid wordt nooit geëxporteerd**, en een combinatie die nog niet is gestart wordt overgeslagen;
- **inschrijvingen ter plaatse** en **uitnodigingen van de organisator** worden automatisch aangegeven;
- **juryleden** en **prijzengeld** worden geëxporteerd wanneer deze zijn ingevuld in Equipe; beide zijn optioneel in het FFE-formaat.

### 8. FAQ

**De wedstrijd toont "Pending" hoewel deze is afgelopen.**
Controleer of de resultaten zijn ingevoerd in Equipe en klik dan op **Refresh**.

**Een combinatie ontbreekt in de export.**
Er is waarschijnlijk geen resultaat ingevoerd (geen rangschikking, geen EL/AB/NP status). Vul dit aan in Equipe en exporteer opnieuw.

**De beoordelingstabel (springen) of het testprogramma (dressuur) was niet ingesteld.**
De FFE-code heeft geen bekende overeenkomst. Stel deze handmatig in in Equipe; deze zal niet langer worden overschreven door een re-import.

**De hoogte was niet ingesteld (springen).**
De hoogte staat niet in de FFE-categorie naam. Stel deze handmatig in in Equipe.

**De beoordelingstabel wordt niet getoond in de lijst met geïmporteerde wedstrijden.**
Analyseer de XML opnieuw (New import → Analyse → Back), zonder opnieuw te importeren.

**Custom fields worden weergegeven als "missing".**
Klik op **Create** op het *View imports* scherm. Custom fields die al voor de show zijn gedefinieerd, blijven behouden.

**Er is slechts één bestand gedownload met "Export all" bij een gemengde show.**
Dit is momenteel te verwachten: gebruik de **FFE** knop van elke wedstrijd van de andere discipline.