Fédération Française de Natation Spécifications du format FFNex

Please download to get full document.

View again

of 24
324 views
PDF
All materials on our website are shared by users. If you have any questions about copyright issues, please report us to resolve them. We are always happy to assist you.
Document Description
Page 1 sur 53 Suivi des modifications v1.0.0 (26/04/2011) Version initiale. v1.0.1 (24/06/2011) Nouvelle propriété nation pour l'élément SWIMMER. Nouvelle propriété qualifyingdate pour l'élément RESULT.
Document Share
Documents Related
Document Transcript
Page 1 sur 53 Suivi des modifications v1.0.0 (26/04/2011) Version initiale. v1.0.1 (24/06/2011) Nouvelle propriété nation pour l'élément SWIMMER. Nouvelle propriété qualifyingdate pour l'élément RESULT. Nouvelle propriété swimoff pour l'élément RESULT. Nouvelle propriété clubid pour l'élément RELAYPOSITION. v1.0.2 (28/06/2011) Les éléments facultatifs avec des valeurs par défaut deviennent obligatoires. Nouvelle propriété gsm pour l'élément CONTACT. Suppression de la propriété order de l'élément EVENT. Suppression de la propriété number de l'élément JUDGE. Correction et ajout d'informations dans les annexes. Corrections diverses. v1.0.3 (16/09/2011) Nouvel élément TEAM pour l'élément RESULT (eau libre). Nouvel élément TEAMPOSITIONS pour l'élément TEAM (eau libre). Nouvel élément TEAMPOSITION pour l'élément TEAMPOSITIONS (eau libre). Nouvel élément ENVIRONMENT pour l'élément MEET (eau libre). Table de référence des codes de disqualification pour la discipline eau libre. v1.0.4 (20/10/2011) Nouvelle propriété nextroundid pour l'élément RESULT. Déplacement de la propriété grade de l'élément OFFICIAL à l'élément JUDGE. v1.0.5 (03/01/2012) Nouvelle propriété cap pour l'élément RESULT. v1.0.6 (08/02/2012) Nouvelle présentation du document. Correction de l'exemple. Correction et ajout d'informations dans les annexes. Corrections diverses. v1.0.7 (15/02/2012) Nouvelle propriété order pour l'élément EVENT. Page 2 sur 53 v1.0.8 (01/03/2012) Changement du type integer en string de la propriété raceid . v1.0.9 (10/04/2012) Nouvel élément REFERENCE pour l'élément FFNEX. Contraintes sur les identifiants des clubs (élément CLUB, propriété id ) et des nageurs (élément CLUB, propriété id ). v (16/04/2012) Ajout de la discipline Eau Libre Indoor . v (25/04/2012) Précision sur la valeur particulière de la propriété lane de l'élément JUDGE pour les juges volants. v (16/07/2012) Suppression de l'élément RECORDS et tout ce qu'il lui est associé. v (03/08/2012) Modification de la table de référence des codes épreuves (raceid). Changement du type string en integer de la propriété raceid . v (13/08/2012) Correction d une référence sur les codes épreuves (raceid). Mise à jour de l annexe «Rôles des officiels» (A.6.5. ). v (23/08/2012) Nouvelle propriété swimdate pour l'élément RESULT. Nouvelle propriété type pour l'élément FFNEX, indiquant quelles informations sont contenues dans le fichier. Précisions sur les types de fichiers FFNex. Précisions sur la propriété clubid de l'élément SWIMMER. Ajout d'un exemple par type de fichier FFNex. v (30/08/2012) Ajout de l'élément RECORDS et de tout ce qui lui est associé. Nouveau type de fichier FFNex : record . v (17/10/2012) Correction des valeurs acceptées pour les champs booléens : true et false au lieu de yes et no . Nouvelles propriétés byteam , regionid et departmentid pour l'élément MEET. Nouvelle propriété mixedteam pour l'élément RESULT. Mise à jour de l'annexe «Types de compétition» (A.6.7. ). Ajout de l'annexe «Codes région» (A ). Page 3 sur 53 Ajout de l'annexe «Codes département» (A ). v (13/09/2013) Nouvelles propriétés typeid et gender pour l élément AGEGROUP. Nouvelle propriété nextagegroupid pour l'élément RESULT. Ajout de l'annexe «Types de catégories» (A ). Mise à jour de l'annexe «Formats d'épreuves» (A.6.4. ). v (04/12/2013) Nouvel élément RACESEQUENCES pour l'élément MEET. Nouvel élément RACESEQUENCE pour l'élément RACESEQUENCES. Nouvel élément RACESEQUENCEELEMENTS pour l'élément RACESEQUENCE. Nouvel élément RACESEQUENCEELEMENT pour l'élément RACESEQUENCEELEMENTS. Ajout de l'annexe «Types de formats d'épreuves» (A.6.5. ). Mise à jour du chapitre «Transmission des informations» (4. ). v (25/09/2014) Suppression des propriétés exam et grade de l'élément JUDGE. Nouvelle propriété gradeid pour l'élément JUDGE. Mise à jour de l'annexe Rôles des officiels (A.6.6. ). Ajout de l'annexe Niveaux des officiels (A.6.7. ). v (14/10/2014) Suppression de la propriété lane de l'élément JUDGE. v (20/10/2014) Déplacement de la propriété gradeid de l'élément JUDGE à l'élément OFFICIAL. La propriété devient obligatoire. Mise à jour de l'annexe Niveaux des officiels (A.6.7. ). v (12/11/2014) Nouvelle propriété clubid pour l'élément OFFICIAL. v (23/02/2015) Nouveau type de fichier FFNex : result . Page 4 sur 53 Table des matières 1. INTRODUCTION 7 2. STRUCTURE D UN FICHIER FFNEX 7 3. ÉLEMENTS D'UN FICHIER FFNEX Convention d'écriture Éléments AGEGROUP AGEGROUPS CLUB CLUBS CONTACT ENVIRONMENT EVENT EVENTS FFNEX JUDGE JUDGES MEET MEETS OFFICIAL OFFICIALS ORIGIN POINTTABLE POOL RACESEQUENCE RACESEQUENCEELEMENT RACESEQUENCEELEMENTS RACESEQUENCES RECORD RECORDS REFERENCE RELAY RELAYPOSITION RELAYPOSITIONS RESULT RESULTS SESSION SESSIONS SOLO SPLIT SPLITS SWIMMER SWIMMERS TEAM TEAMPOSITION TEAMPOSITIONS TRANSMISSION DES INFORMATIONS 23 Page 5 sur 53 4.1. Compétiteurs Engagements Compétitions Résultats Performances Records 24 A. ANNEXES 25 A.1. Exemple de fichier FFNex Compétiteurs 25 A.2. Exemple de fichier FFNex Engagements 25 A.3. Exemple de fichier FFNex Compétitions 27 A.4. Exemple de fichier FFNex Performances 29 A.5. Exemple de fichier FFNex Records 31 A.6. Tables de référence 33 A.6.1. Liste des fédérations affiliées à la FINA (code ISO CIO/FINA, mis à jour le 28/06/2011) 33 A.6.2. Types de structure (typeid) 40 A.6.3. Types d'épreuves (raceid) 41 A.6.4. Formats d'épreuves (roundid) 42 A.6.5. Types de formats d'épreuves (typeroundid) 42 A.6.6. Rôles des officiels (roleid) 43 A.6.7. Niveau des officiels (gradeid) 43 A.6.8. Types de compétition (typeid) 44 A.6.9. Disciplines (disciplineid) 47 A Types de chronométrage (timingid) 47 A Codes de disqualification (disqualificationid) 47 A Codes de disqualification spécifiques à l'eau libre (disqualificationid) 48 A Milieux pour l'eau libre (environmentid) 49 A Types de fichiers FFNex (type) 49 A Types de records (typeid) 49 A Codes région (regionid) 50 A Codes département (departmentid) 51 A Types de catégories (typeid) 53 Page 6 sur 53 1. Introduction Le format FFNex est un nouveau protocole d échange des données de compétitions de Natation Course qui remplacera progressivement l ancien standard de la FFN, la PCE3. Un fichier FFNex est un fichier d échange au format XML qui regroupe soit l ensemble des informations d une compétition de Natation Course : programme, engagements et/ou résultats, soit une collection de compétiteurs et de clubs (en remplacement de l'extraction PCE des compétiteurs). 2. Structure d un fichier FFNex FFNEX Racine d un fichier FFNex ORIGIN Informations sur la provenance du fichier CONTACT Contact REFERENCE Collection de nageurs et de clubs (dans les fichiers de type reference ou record ) et de records (uniquement dans les fichiers de type record ). CLUBS Collection de clubs CLUB Informations sur un club SWIMMERS Collection de nageurs SWIMMER Informations sur un nageur RECORDS Collection de records RECORD Informations sur un record SOLO Nageur lié au record RELAY Relais lié au record RELAYPOSITIONS Composition du relais RELAYPOSITION Informations sur un relayeur SPLITS Temps de passages SPLIT Informations sur un temps de passage MEETS Collection de compétitions MEET Racine d une compétition POINTTABLE Table de cotation POOL Informations sur la piscine ENVIRONMENT Informations sur le milieu (eau libre) Page 7 sur 53 OFFICIALS Collection d officiels OFFICIAL Informations sur un officiel CLUBS Collection de clubs CLUB Informations sur un club SWIMMERS Collection de nageurs SWIMMER Informations sur un nageur AGEGROUPS Collection de catégories d'âge AGEGROUP Informations sur une catégorie d'âge SESSIONS Programme de la compétition SESSION Réunion de la compétition JUDGES Jury JUDGE Informations sur un membre du jury EVENTS Collection d'évènements EVENT Informations sur un évènement non sportif ou une épreuve RACESEQUENCES Collection d'enchaînements des épreuves RACESEQUENCE Informations sur l'enchaînement d'une épreuve RACESEQUENCEELEMENTS Collection d'éléments formant un enchaînement d'épreuves. RACESEQUENCEELEMENT Informations sur un élément formant un enchaînement d'épreuves. RESULTS Collection d'engagements / résultats RESULT Informations sur un engagement / résultat SOLO Nageur lié au résultat RELAY Relais lié au résultat RELAYPOSITIONS Composition du relais RELAYPOSITION Informations sur un relayeur TEAM Equipe liée au résultat (eau libre) TEAMPOSITIONS Composition de l'équipe (eau libre) TEAMPOSITION Informations sur un membre de l'équipe (eau libre) SPLITS Temps de passages SPLIT Informations sur un temps de passage RECORDS Collection de records suivis / battus Page 8 sur 53 RECORD Informations sur un record SOLO Nageur lié au record RELAY Relais lié au record RELAYPOSITIONS Composition du relais RELAYPOSITION Informations sur un relayeur SPLITS Temps de passages SPLIT Informations sur un temps de passage Page 9 sur 53 3. Éléments d'un fichier FFNex 3.1. Convention d'écriture Dans la description de chacun des éléments constituant un fichier FFNex, les conventions d'écritures suivantes seront utilisées : les éléments seront en majuscules, les attributs en minuscules. les cardinalités des éléments et des attributs seront les suivantes : Cardinalité Signification? 0 ou 1 instance * de 0 à n instances + de 1 à n instances {n} exactement n instances {m,n} de m à n instances les types de données des attributs seront les suivants : Type de données Signification boolean booléen, accepte les valeurs true ou false date date au format AAAA-MM-JJ (ex : ) datetime date / heure au format AAAA-MM-JJ hh:mm:ss (ex : :30:35 ) float nombre à virgule (ex : 3.14, -2.21, 1.0) integer nombre entier (ex : 3, -2) string chaîne de caractères (ex : toto ) swimtime temps au format h`h`mm.sscc . Peut être négatif dans le cas des temps de réaction. Exemple : 1h pour 1 h 23 minutes 34 secondes et 56 centièmes, 4.3942 pour 4 minutes 39 secondes et 42 centièmes, pour -14 centièmes de seconde. Page 10 sur 53 3.2. Éléments Afin de faciliter la lecture, les différents éléments sont présentés dans l'ordre alphabétique AGEGROUP AGEGROUP contient des informations sur une catégorie. id integer {1} Id de la catégorie. typeid integer {1} Type de catégorie. Voir en annexe A les types acceptés. Attention : chaque compétition doit posséder une et une seule catégorie englobante (typeid = 0). name string {1} Nom de la catégorie. gender string? Sexe de l'officiel. Accepte les valeurs M ou F . Requis sauf pour la catégorie englobante. agemin integer {1} Age minimum de la catégorie. agemax integer {1} Age maximum de la catégorie AGEGROUPS AGEGROUPS est une collection de catégories. AGEGROUP CLUB CLUB contient des informations sur un club. id integer {1} Id du club. Doit correspondre à l'id sur extranat (information fournie par la FFN dans le fichier des compétiteurs), ou doit être négatif dans le cas des bannières. name string {1} Nom du club. code string? Code du club, par exemple le code fédéral à 9 chiffres (ex : ). nation string? Code pays du club. Voir en annexe A.6.1. les codes pays acceptés. typeid string? Type de structure. Voir en annexe A.6.2. les types acceptés CLUBS CLUBS est une collection de clubs. Page 11 sur 53 CLUB CONTACT CONTACT contient des informations sur la personne à contacter (par exemple le responsable de la compétition). name string {1} Nom du contact. address string? Adresse du contact. zip string? Code postal du contact. city string? Ville du contact. phone string? Numéro de téléphone du contact. gsm string? Numéro de portable du contact. fax string? Fax du contact. string? Adresse électronique du contact. internet string? Adresse du site internet du contact ENVIRONMENT ENVIRONMENT contient des informations sur le milieu d'une compétition eau libre. environmentid integer {1} Id du milieu. Voir en annexe A les valeurs acceptées airtemperature integer? Température de l'air en C. watertemperature integer? Température de l'eau en C. distance integer {1} Distance en mètres EVENT EVENT contient des informations sur un événement. id integer {1} Id de l'événement. type string {1} Type de l'évènement. Accepte les valeurs EVENT (événement non sportif) et RACE (épreuve). name string? Nom de l'évènement. Requis si le type est EVENT . raceid integer? Id de l'épreuve. Voir en annexe A.6.3. les valeurs acceptées. Requis si le type est RACE . roundid integer? Id du format d'épreuve. Voir en annexe A.6.4. les valeurs acceptées. Requis si le type est RACE . agegroupid integer? Id de la catégorie, lié à l'élément AGEGROUP. Requis si le type est RACE . datetime datetime {1} Date et heure de l'évènement. Si la Page 12 sur 53 compétition n'est pas distribuée, mettre la valeur :00:00. order integer? Ordre de l'évènement. Sert à connaître l'ordre de déroulement des épreuves quand la compétition n'est pas distribuée. Le numéro d'ordre de chaque événement doit être unique EVENTS EVENTS est une collection d'évènements. EVENT FFNEX FFNEX est l'élément racine d'un fichier FFNex. ORIGIN - {1} REFERENCE -? Requis dans un fichier de type reference ou record . Dans ce cas l'élément MEETS ne doit pas être présent. MEETS -? Requis dans un fichier de type competition ou result . Dans ce cas l'élément REFERENCE ne doit pas être présent. type string {1} Type de fichier FFNex, indique quelles informations il transporte. Voir en annexe A les valeurs acceptées, et le chapitre 4. pour plus d'informations. version string {1} La version du fichier FFNEX est de la forme x.y.z (ex : 1.0.2 ) JUDGE JUDGE contient des informations sur un membre de jury. officialid integer {1} Id d'officiel lié à l'élément OFFICIAL. roleid string {1} Id du rôle de l'officiel. Voir en annexe A.6.6. les valeurs acceptées JUDGES JUDGES est une collection de membres de jury. JUDGE - + Page 13 sur 53 MEET MEET est l'élément racine d'une compétition. POINTTABLE -? Informations sur la table de cotations utilisée. POOL -? Informations sur la piscine. ENVIRONMENT -? Informations sur le milieu (eau libre). OFFICIALS -? Collection d'officiels, utilisés dans la composition du jury. CLUBS -? Collection des clubs d'appartenance des nageurs, et des clubs ou des bannières pour lesquels ces derniers concourent. SWIMMERS -? Collection de nageurs engagés à la compétition, ou faisant partie d'un relais. AGEGROUPS -? Collection des catégories utilisées dans la compétition. SESSIONS -? Collection des réunions de la compétition. Requis dans un fichier de type competition ou result . RACESEQUENCES -? Collection d'enchaînements des épreuves. Uniquement requis dans les fichiers de type competition ou result si la compétition comporte des enchaînements spécifiques. RESULTS -? Collection des engagements / résultats de la compétition. RECORDS -? Collection des records suivis / battus de la compétition. id integer? Id de la compétition, facultatif, mais peut être utilisé pour fournir l'id utilisé dans un système d'informations. name string? Nom de la compétition. zip string? Code postal de la compétition. city string? Ville de la compétition. nation string? Code pays de la compétition. Voir en annexe A.6.1. les codes pays acceptés. startdate date? Date de début de la compétition. stopdate date? Date de fin de la compétition. typeid integer {1} Type de compétition. Voir en annexe A.6.7. les valeurs acceptées. disciplineid integer {1} Discipline. Voir en annexe A.6.9. les valeurs acceptées. timingid integer {1} Chronométrage automatique. Voir en annexe A les valeurs acceptées. regionid string? Région de l'organisateur de la compétition. departementid string? Département de l'organisateur de la compétition. byteam boolean? Compétition par équipe. Page 14 sur 53 MEETS MEETS est une collection de compétitions. MEET OFFICIAL OFFICIAL contient des informations sur un officiel. id integer {1} Id de l'officiel. firstname string {1} Prénom de l'officiel lastname string {1} Nom de l'officiel. gender string {1} Sexe de l'officiel. Accepte les valeurs M ou F . birthdate date {1} Date de naissance de l'officiel. nation string {1} Nationalité de l'officiel. Voir en annexe A.6.1. les codes pays acceptés. gradeid string {1} Id du niveau de l'officiel. Voir en annexe A.6.7. les valeurs acceptées. clubid integer {1} Structure des officiels licenciés. Mettre la valeur 0 pour les officiels non licenciés. Lié à l'élément CLUB OFFICIALS OFFICIALS est une collection d'officiels. OFFICIAL ORIGIN ORIGIN contient des informations sur l'origine du fichier. CONTACT -? name string {1} Nom du logiciel / système ayant fabriqué le fichier FFNex. version string? Version du logiciel / système ayant fabriqué le fichier FFNex POINTTABLE POINTTABLE contient des informations sur la table de cotations utilisée dans la compétition. name string {1} Nom de la table de cotations. Page 15 sur 53 version string? Version de la table de cotations POOL POOL contient des informations sur la piscine utilisée lors de la compétition. name string {1} Nom de la piscine. lanes integer {1} Nombre de lignes de la piscine. size integer {1} Taille du bassin. Les valeurs acceptées sont 25 ou 50 RACESEQUENCE RACEQUENCE contient des informations sur l'enchaînement d'une épreuve. raceid string {1} Id de l'épreuve. Voir en annexe A.6.3. les valeurs acceptées. RACESEQUENCEELEME NTS RACESEQUENCEELEMENT RACEQUENCEELEMENT contient des informations sur un élément formant un enchaînement d'épreuves. typeroundid string {1} Id du type de format d'épreuve. Voir en annexe A.6.5. les valeurs acceptées. raceid string {1} Id de l'épreuve. Voir en annexe A.6.3. les valeurs acceptées RACESEQUENCEELEMENTS RACESEQUENCEELEMENTS est une collection d'éléments formant un enchaînement d'épreuves. RACESEQUENCEELEME NT RACESEQUENCES RACESEQUENCES est une collection d'enchaînements des épreuves. RACESEQUENCE - + Page 16 sur 53 RECORD RECORD contient des informations sur un record battu ou suivi. SPLITS -? Temps de passage. SOLO -? Nageur. Requis dans le cas d'un record individuel. Ne peut être présent en même temps que l'élément RELAY. RELAY -? Relais. Requis dans le cas d'un record de relais. Ne peut être présent en même temps que l'élément SOLO. poolsize integer? Taille du bassin. Les valeurs acceptées sont 25 ou 50 . Nécessaire dans le type de fichier record . typeid string {1} Id du type de record. Voir en annexe A les valeurs acceptées. raceid string {1} Id de l'épreuve. Voir en annexe A.6.3. les valeurs acceptées. name string? Nom du record. Nécessaire si typeid = 0. place string {1} Lieu du record. date date {1} Date du record. time swimtime {1} Temps du record. nation string {1} Code pays dans lequel le record a été effectué. Voir en annexe A.6.1. les codes pays acceptés. clubid integer? Club pour lequel le record a été comptabilisé RECORDS RECORDS est une collection de records. RECORD REFERENCE REFERENCE est une collection de nageurs, de clubs (fichier de type reference ) et de records (fichier de type record ). CLUBS -? SWIMMERS -? RECORDS -? RELAY RELAY contient des informations sur un relais. RELAYPOSITIONS -? Composition du relais. Page 17 sur 53 name string? Nom du relais RELAYPOSITION RELAYPOSITION contient des informations sur un relayeur. number integer {1} Numéro du relayeur. swimmerid integer? Id de nageur, lié à l'élément SWIMMER. Non requis, les relais non composés sont acceptés. clubid integer? Club du relayeur. reactiontime swimtime? Temps de réaction du r
Similar documents
View more...
Search Related
We Need Your Support
Thank you for visiting our website and your interest in our free products and services. We are nonprofit website to share and download documents. To the running of this website, we need your help to support us.

Thanks to everyone for your continued support.

No, Thanks
SAVE OUR EARTH

We need your sign to support Project to invent "SMART AND CONTROLLABLE REFLECTIVE BALLOONS" to cover the Sun and Save Our Earth.

More details...

Sign Now!

We are very appreciated for your Prompt Action!

x