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

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

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

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.