# Extension FFE ⇄ Equipe — Guide d'utilisation 🇫🇷 [Français](#français) · 🇬🇧 [English](#english) --- ## Français ### 1. À quoi sert l'extension L'extension fait le lien entre la **FFE (FFECompet)** et **Equipe**, pour le **saut d'obstacles (CSO)** et le **dressage** : - **Import** : elle lit le fichier XML des engagés exporté de FFECompet et crée automatiquement dans Equipe les épreuves, cavaliers, chevaux, clubs, officiels et engagements. - **Export** : une fois les épreuves courues, elle génère les fichiers de résultats au format FFE (TXT FFECompet V24 ou XML SIF) à réimporter dans FFECompet. ### 2. Prérequis - L'extension FFE est activée sur le concours dans Equipe. - Vous disposez du fichier XML des engagés téléchargé depuis FFECompet (ex. `202642038.xml`). - **Un fichier par discipline** : la FFE exige un fichier de résultats distinct pour chaque discipline. Un concours mixte CSO + dressage donne donc deux fichiers d'export (voir section 7). ### 3. Ouvrir l'extension Ouvrez le concours dans Equipe, puis lancez l'extension FFE. La connexion à Equipe est automatique : aucune clé ni URL à saisir. Les drapeaux 🇫🇷 / 🇬🇧 en haut à droite permettent de changer la langue de l'interface. À l'ouverture, l'extension vérifie si des épreuves FFE existent déjà dans le concours : - **aucune** → l'écran d'import s'affiche directement ; - **au moins une** → la liste des épreuves importées s'affiche. Les deux boutons **Voir les imports** et **Nouvel import** permettent de passer d'un écran à l'autre. ### 4. Importer les engagés 1. Cliquez sur **Nouvel import**. 2. Sélectionnez le fichier XML FFE, puis cliquez sur **Analyser le fichier**. 3. Vérifiez le résumé affiché : - nom, numéro FFE, dates et organisateur du concours ; - nombre d'épreuves, cavaliers, officiels, chevaux, clubs et engagements. 4. **Sélectionnez les épreuves** à importer. Elles sont regroupées par date ; un badge indique la discipline (**H** = CSO, **D** = dressage). Toutes sont cochées par défaut ; utilisez *Tout sélectionner* / *Tout désélectionner* dans le bloc **Sélection rapide**. 5. Choisissez le **niveau** des épreuves (Club, Local, Régional, National, Élite, International). 6. Cliquez sur **Importer**. #### Ce qui est créé dans Equipe | Élément | CSO | Dressage | |---|---|---| | Épreuves | Nom = catégorie FFE (ex. « Préparatoire (1,10 m) »), numéro affiché `FFE-1`, `FFE-2`… | Idem | | Jugement | Barème converti de l'article FFE vers l'article FEI 2026 (ex. 238.1.1 → 220.1.1.1) | Reprise reconnue à partir du protocole FFE | | Hauteur | Lue dans le nom de catégorie (ex. « (1,10 m) ») | — | | Piste et heure | Nom de la piste et heure de début | Idem | | Engagés | Cavaliers, chevaux (SIRE), clubs, dossards | Idem | | Officiels | Officiels déclarés dans le XML | Idem | | Champs personnalisés | « Engagement terrain » et « Invitation organisateur », créés si au moins une épreuve importée les autorise | Idem | > **Réimport** : vous pouvez réimporter un fichier XML mis à jour (nouveaux engagés, etc.). Les épreuves que vous avez **modifiées à la main** dans Equipe ne sont pas écrasées. > **Barèmes** : l'analyse du XML enregistre aussi le barème FFE de chaque épreuve, affiché ensuite dans la liste des épreuves importées. Pour des épreuves déjà importées, il suffit d'analyser à nouveau le XML (Nouvel import → Analyser → Retour), sans relancer l'import. ### 5. Gérer le concours dans Equipe Faites tourner le concours normalement dans Equipe : ordres de départ, saisie des résultats, classements, répartition des gains. **Engagements terrain** : un engagement pris sur place est signalé par un **dossard négatif** (ex. `-5`) ou par le champ personnalisé *Engagement terrain*. Il est déclaré automatiquement à la FFE dans le fichier d'export. **Dressage** : placez les juges sur leurs positions (C, H, M, B, E) et saisissez les notes de chaque juge dans Equipe. L'export reprend les points et le pourcentage de chaque juge, la moyenne, le total et les notes d'ensemble. ### 6. Suivre les épreuves importées L'écran **Voir les imports** liste les épreuves FFE du concours, regroupées par date. Chaque ligne indique : - la discipline (**H** = CSO, **D** = dressage), le numéro et le nom de l'épreuve, le numéro de concours FFE ; - le barème FFE (ex. « Barème A sans chrono, sans barrage `238.1.1` »), s'il a été enregistré à l'analyse du XML ; - **Résultats** : 🏆 au moins un couple a un résultat · 🕓 épreuve pas encore courue ; - **Exports** : boutons d'export, visibles seulement quand il y a des résultats. Au-dessus de la liste, une ligne indique l'état des **champs personnalisés** : - ✅ **présents** : tout est en place ; - ❌ **manquants** : cliquez sur **Créer** pour les ajouter au concours. #### Afficher les champs personnalisés dans la liste de départ Les deux champs (*Engagement terrain* et *Invitation organisateur*) ne sont pas visibles par défaut dans les listes de départ d'Equipe. Pour les afficher : 1. Ouvrez la liste de départ d'une épreuve dans Equipe. 2. Menu **Tools** → **Field selector** (raccourci `v` `v`). 3. Ajoutez la colonne **Start custom fields**. Les deux champs apparaissent alors en colonnes : vous pouvez vérifier d'un coup d'œil quels couples sont engagés sur le terrain ou invités par l'organisateur, et cocher ou décocher la case si besoin. Ce sont ces valeurs qui sont déclarées à la FFE dans le fichier d'export. Le bouton **Actualiser** recharge la liste. ### 7. Exporter les résultats vers la FFE | Bouton | Contenu | Format | |---|---|---| | **FFE** (sur une ligne) | Résultats d'une seule épreuve | TXT FFECompet V24 | | **SIF** (sur une ligne) | Résultats d'une seule épreuve | XML WinJump / SIF | | **Exporter tout** (bas de la liste) | Toutes les épreuves courues du concours | TXT FFECompet V24 | Le fichier est téléchargé automatiquement ; importez-le ensuite dans FFECompet. > **Concours mixte CSO + dressage** : **Exporter tout** prépare un fichier par discipline mais **ne télécharge que le premier**. Un message indique alors le nombre de fichiers générés. Pour l'autre discipline, utilisez le bouton **FFE** de chaque épreuve. #### Ce que contient l'export | | CSO | Dressage | |---|---|---| | Par couple | Points et temps (manche et barrage), place, gains | Points et pourcentage de chaque juge (C, H, M, B, E), moyenne en %, total, notes d'ensemble, place, gains | | Statuts | Éliminé (EL), abandon (AB), disqualifié (DI), non-partant (NP) | Idem | Dans tous les cas : - seuls les **couples réellement passés** sont exportés ; - une **épreuve pas encore courue n'est jamais exportée**, et un couple qui n'a pas encore pris le départ n'apparaît pas ; - les **engagements terrain** et **invitations organisateur** sont déclarés automatiquement ; - le **jury** et les **gains** sont exportés s'ils sont renseignés dans Equipe ; ces deux informations sont facultatives dans le format FFE. ### 8. Questions fréquentes **L'épreuve affiche « En attente » alors qu'elle est terminée.** Vérifiez que les résultats ont bien été saisis dans Equipe, puis cliquez sur **Actualiser**. **Il manque un couple dans l'export.** Le couple n'a probablement aucun résultat saisi (ni classement, ni statut EL/AB/NP). Complétez-le dans Equipe, puis exportez à nouveau. **Le barème (CSO) ou la reprise (dressage) n'a pas été repris.** Le code FFE n'a pas de correspondance connue. Réglez-le à la main dans Equipe ; il ne sera plus écrasé par un réimport. **La hauteur n'a pas été reprise (CSO).** La hauteur n'apparaît pas dans le nom de la catégorie FFE. Réglez-la à la main dans Equipe. **Le barème ne s'affiche pas dans la liste des épreuves importées.** Analysez à nouveau le XML (Nouvel import → Analyser → Retour), sans relancer l'import. **Les champs personnalisés sont indiqués « manquants ».** Cliquez sur **Créer** dans l'écran *Voir les imports*. Les champs personnalisés déjà définis sur le concours sont conservés. **Un seul fichier téléchargé avec « Exporter tout » sur un concours mixte.** C'est normal pour l'instant : utilisez le bouton **FFE** de chaque épreuve de l'autre discipline. --- ## English ### 1. What the extension does The extension connects the **FFE (French Equestrian Federation, FFECompet)** with **Equipe**, for **show jumping** and **dressage**: - **Import**: it reads the entries XML file exported from FFECompet and automatically creates competitions, riders, horses, clubs, officials and entries in Equipe. - **Export**: once competitions have been run, it generates result files in FFE format (FFECompet V24 TXT or SIF XML) to upload back into FFECompet. ### 2. Requirements - The FFE extension is enabled on the show in Equipe. - You have the entries XML file downloaded from FFECompet (e.g. `202642038.xml`). - **One file per discipline**: the FFE requires a separate result file for each discipline. A mixed jumping + dressage show therefore produces two export files (see section 7). ### 3. Opening the extension Open the show in Equipe, then launch the FFE extension. The connection to Equipe is automatic: no key or URL to enter. Use the 🇫🇷 / 🇬🇧 flags at the top right to switch the interface language. On opening, the extension checks whether the show already contains FFE competitions: - **none** → the import screen is shown directly; - **at least one** → the list of imported competitions is shown. Use the **View imports** and **New import** buttons to switch between screens. ### 4. Importing entries 1. Click **New import**. 2. Select the FFE XML file, then click **Analyse file**. 3. Check the summary: - show name, FFE number, dates and organiser; - number of competitions, riders, officials, horses, clubs and entries. 4. **Select the competitions** to import. They are grouped by date; a badge shows the discipline (**H** = jumping, **D** = dressage). All are ticked by default; use *Select all* / *Deselect all* in the **Quick selection** block. 5. Choose the competition **level** (Club, Local, Regional, National, Elite, International). 6. Click **Import**. #### What is created in Equipe | Item | Jumping | Dressage | |---|---|---| | Competitions | Name = FFE category (e.g. "Préparatoire (1,10 m)"), displayed number `FFE-1`, `FFE-2`… | Same | | Judging | Judging table converted from the FFE article to the matching 2026 FEI article (e.g. 238.1.1 → 220.1.1.1) | Test recognised from the FFE protocol | | Height | Read from the category name (e.g. "(1,10 m)") | — | | Arena and time | Arena name and start time | Same | | Entries | Riders, horses (SIRE number), clubs, back numbers | Same | | Officials | Officials listed in the XML | Same | | Custom fields | "Engagement terrain" (on-site entry) and "Invitation organisateur" (organiser's invitation), created if at least one imported competition allows them | Same | > **Re-import**: you can re-import an updated XML file (new entries, etc.). Competitions you have **edited manually** in Equipe are not overwritten. > **Judging tables**: analysing the XML also stores the FFE judging table of each competition, then shown in the list of imported competitions. For competitions already imported, just analyse the XML again (New import → Analyse → Back), without re-importing. ### 5. Running the show in Equipe Run the show as usual in Equipe: starting orders, scoring, rankings, prize money. **On-site entries**: an entry taken on site is marked with a **negative back number** (e.g. `-5`) or with the *Engagement terrain* custom field. It is automatically declared to the FFE in the export file. **Dressage**: place the judges on their positions (C, H, M, B, E) and enter each judge's marks in Equipe. The export includes each judge's score and percentage, the average, the total and the collective marks. ### 6. Monitoring imported competitions The **View imports** screen lists the FFE competitions of the show, grouped by date. Each row shows: - the discipline (**H** = jumping, **D** = dressage), the competition number and name, the FFE show number; - the FFE judging table (e.g. "Barème A sans chrono, sans barrage `238.1.1`"), if it was stored when the XML was analysed; - **Results**: 🏆 at least one combination has a result · 🕓 competition not run yet; - **Exports**: export buttons, shown only when results exist. Above the list, a line shows the status of the **custom fields**: - ✅ **present**: everything is in place; - ❌ **missing**: click **Create** to add them to the show. #### Showing the custom fields in the start list The two fields (*Engagement terrain* — on-site entry, and *Invitation organisateur* — organiser's invitation) are not shown by default in Equipe start lists. To display them: 1. Open a competition's start list in Equipe. 2. **Tools** menu → **Field selector** (shortcut `v` `v`). 3. Add the **Start custom fields** column. Both fields then appear as columns: you can see at a glance which combinations entered on site or were invited by the organiser, and tick or untick them if needed. These values are the ones declared to the FFE in the export file. The **Refresh** button reloads the list. ### 7. Exporting results to the FFE | Button | Content | Format | |---|---|---| | **FFE** (on a row) | Results of one competition | FFECompet V24 TXT | | **SIF** (on a row) | Results of one competition | WinJump / SIF XML | | **Export all** (below the list) | All competitions that have been run | FFECompet V24 TXT | The file is downloaded automatically; then upload it into FFECompet. > **Mixed jumping + dressage show**: **Export all** prepares one file per discipline but **only downloads the first one**. A message then shows how many files were generated. For the other discipline, use the **FFE** button of each competition. #### What the export contains | | Jumping | Dressage | |---|---|---| | Per combination | Faults and time (round and jump-off), placing, prize money | Each judge's score and percentage (C, H, M, B, E), average %, total, collective marks, placing, prize money | | Statuses | Eliminated (EL), retired (AB), disqualified (DI), non-starter (NP) | Same | In all cases: - only **combinations that actually competed** are exported; - a **competition not yet run is never exported**, and a combination that has not started yet is left out; - **on-site entries** and **organiser's invitations** are declared automatically; - **judges** and **prize money** are exported when filled in Equipe; both are optional in the FFE format. ### 8. FAQ **The competition shows "Pending" although it is finished.** Check that the results have been entered in Equipe, then click **Refresh**. **A combination is missing from the export.** It probably has no result entered (no ranking, no EL/AB/NP status). Complete it in Equipe and export again. **The judging table (jumping) or the test (dressage) was not set.** The FFE code has no known match. Set it manually in Equipe; it will no longer be overwritten by a re-import. **The height was not set (jumping).** The height is not in the FFE category name. Set it manually in Equipe. **The judging table is not shown in the list of imported competitions.** Analyse the XML again (New import → Analyse → Back), without re-importing. **Custom fields are shown as "missing".** Click **Create** on the *View imports* screen. Custom fields already defined on the show are preserved. **Only one file downloaded with "Export all" on a mixed show.** This is expected for now: use the **FFE** button of each competition of the other discipline.