Ce guide utilisateur décrit l'intégration de la plateforme Roster Athletics avec le système ALGE-TIMING et son logiciel OPTIc3.NET.


Ce guide est divisé en plusieurs sections ci-dessous.



Que devez-vous faire pour configurer l'intégration ?


Le programme RosterAgent est un petit programme qui permet la communication entre la plateforme Roster et le logiciel OPTIc3.NET afin qu'ils restent synchronisés pendant la compétition pour le téléchargement des start-lists de Roster vers OPTIc3.NET et le téléchargement et la synchronisation des résultats d'OPTIc3.NET vers la plateforme Roster (et immédiatement dans l'application).


Maintenant, vous devriez avoir tout ce qu'il faut pour commencer l'intégration. Assurez-vous d'avoir les trois programmes suivants ouverts :

  1. Roster Athletics dans un navigateur

  2. RosterAgent en cours d'exécution

  3. OPTIc3.Net en cours d'exécution



Intégration


Le RosterAgent partage les données entre OPTIc3.NET et Roster en utilisant des fichiers LIF partagés. Il fonctionne si vous utilisez le même ordinateur ou un dossier de fichiers partagé entre les ordinateurs (par exemple, un ordinateur exécutant Roster/Roster Agent et un autre exécutant OPTIc3.NET).



Préparer l'intégration


Tout d'abord, choisissez les participants que vous souhaitez exporter de Roster Athletics vers OPTIc3.NET. Cette option se trouve dans la section Intégration au système de chronométrage des Détails de la compétition.


Vous pouvez exporter tous les participants ou exclure ceux ayant les statuts DNS et SCR (par exemple, lorsque vous savez avant la compétition qu'un athlète ne se présentera pas mais que vous ne voulez pas le supprimer de la liste).



Dans le champ Épreuves exportées, vous pouvez choisir une option pour la catégorie d'épreuves que vous souhaitez envoyer à OPTIc3.NET pour le chronométrage. Vous pouvez exporter toutes les épreuves ou exclure les épreuves terminées afin qu'elles n'apparaissent pas dans OPTIc3.NET.


Dans la même section en dessous, choisissez le format d'affichage qui sera visible et utilisé dans OPTIc3.NET lors de la visualisation des épreuves/séries.


Il y a 3 types de formats de description des épreuves parmi lesquels choisir. Les épreuves seront affichées dans OPTIc3.NET comme suit :

  • Format Détaillé : horaire de l'épreuve, nom de l'épreuve, sexe (si plusieurs sexes), catégorie d'âge (si plusieurs castégories d'âge), label de l'épreuve (si un label est attribué), groupe /numéro de la série (si un numéro a été attribué).

  • Format Simple : nom de l'épreuve, sexe (si plusieurs sexes), catégorie d'âge (si plusieurs catégories d'âge), groupe / numéro de la série (si un numéro a été attribué).
  • Format Customisé : vous permet de choisir le format de votre épreuve pour l'affichage dans OPTIc3.NET.



Le champ Format Customisé vous permet de choisir les paramètres de description d'épreuves et l'ordre à afficher. Cliquer sur les paramètres de votre choix pour les ajouter au champ. Les effacer simplement en les supprimant. Veuillez noter que le format du champ nécessite des deux-points autour de chaque paramètre et que les paramètres doivent être séparés par un seul espace. 

Ainsi :EventName: : Gender: afficherait uniquement les noms des épreuves et le sexe des participants pour chaque épreuve dans OPTIc3.NET.


Les options sont les suivantes :

  • Age group : la catégorie d'âge du groupe ou de la série est toujours visible
  • Age group opt. : montre la catégorie d'âge de l'épreuve uniquement s'il y a plus qu'une seule catégorie d'âge dans la compétition (Note : il est recommandé de choisir Age group ou Age group opt., mais pas les deux)
  • Combined prefix opt. : montre l'épreuve combinée maître s'il s'agit d'une épreuve combinée
  • Date : date de l'épreuve sera toujours au format AAAAMMJJ
  • Event label opt. : montre le label de l'épreuve s'il en existe un pour cette épreuve
  • Event name : le nom de l'épreuve est toujours visible
  • Gender : le sexe des participants de l'épreuve est toujours visible
  • Gender opt. : montre le sexe des participants uniquement s'il y a plus qu'un seul sexe parmi les participants de la compétition (Note : il est recommandé de choisir Gender ou Gender opt., mais les deux).
  • Group opt. : montre les numéros des groupes ou des séries uniquement s'il sont présents dans la compétition
  • Stage : le niveau de la compétition est toujours visible
  • Time : l'horaire de l'épreuve est toujours visible


Il faudra appuyer sur le symbole des paramètres par Défaut pour retourner aux paramètres initiaux recommandés s'il y a besoin de réinitialiser les paramètres de cette customisation.



Télécharger le fichier d'authentification

 

Restez dans les Détails de la compétition. Sur le côté gauche, cliquez sur le bouton Support de configuration et sélectionnez ALGE.



Cela téléchargera un fichier d'authentification .roster spécifique à votre compétition, qui indiquera au RosterAgent (voir plus bas) d'utiliser cette compétition pour se connecter à OPTIc3.NET. Veuillez sauvegarder le fichier à un endroit où vous pourrez facilement le retrouver.


Veuillez noter : vous devez utiliser le dernier fichier d'authentification téléchargé pour le charger dans le RosterAgent. Sinon, les autorisations ne correspondront pas et vous ne pourrez pas vous connecter à votre compétition  (“Can’t connect - permission denied”) - ("Ne peut pas se connecter - autorisation refusée").

 


Chargez le fichier d'authentification dans le Roster Agent


Une fois le Roster Athletics Agent ouvert, sélectionnez le Répertoire d'entrée (mises à jour des start-lists) pour les fichiers EVT et le Répertoire de sortie (fichiers de résultats) pour les fichiers LIF. Ces répertoires DOIVENT ÊTRE LES MÊMES que les répertoires d'entrée et de sortie que vous utiliserez dans OPTIc3.NET pour l'importation et l'exportation des données (voir ci-dessous pour la configuration d'OPTIc3.NET).


Conseil : le répertoire d'entrée et le répertoire de sortie doivent être des dossiers ou sous-dossiers sur un disque (par exemple, C:) et vous devez éviter d’ajouter directement le dossier sur votre bureau.



Cliquez sur Charger la configuration et sélectionnez le dernier fichier d'authentification .roster (par exemple, meeting-xxx-auth.roster) que vous avez téléchargé pour cette compétition, comme indiqué ci-dessus. Cela enregistrera les informations des répertoires, ce qui vous évitera de devoir les saisir à chaque fois.


Cliquez sur Commencer. Si le statut du Moniteur de résultat est Actif et que le statut de Connexion est Connecté, la session en direct entre OPTIc3.NET et Roster Athletics est maintenant établie.



Remarque : Interrompre coupera la connexion, et Quitter fermera complètement le programme. Pour changer de fichier de configuration ou de répertoires d'entrée/sortie, la connexion doit être arrêtée (c’est-à-dire qu’il ne doit pas y avoir de connexion active).


 

Vous pourrez voir des messages de statut si vous avez le champ Montrer les notifications activé par défaut, un exemple est montré ci-dessous  :




Vous pouvez désactiver les notifications en cliquant sur le bouton Montrer les notifications, il apparaîtra ensuite d'une couleur plus claire.


Faites attention aux statuts du Moniteur de résultats et de la Connexion lorsque le logiciel Roster Agent est en cours d'exécution  :


Moniteur de résultat :

  • Actif - mode opérationnel normal
  • En attente
  • Initialisation
  • Interruption


Connexion :

  • En cours de connexion
  • Connecté - Mode opérationnel normal
  • En cours de déconnexion
  • Déconnecté
  • En cours de reconnexion - l'agent va automatiquement chercher à se reconnecter
  • Invalide - en utilisant un fichier de configuration obsolète : essayez de télécharger à nouveau, puis recharger le fichier de configuration



Configurez le logiciel OPTIc3.NET


Passons maintenant à OPTIc3.NET et ouvrez les Paramètres d'échange ATL (ou dialogue d'échange ATL) en cliquant sur l'icône des outils dans la barre supérieure du programme, puis activez les paramètres suivants :



(ouvrir les fenêtres vers le bas de chaque groupe de paramètres)


FinishLynxExport

  • AutomaticExportDirectory - identique au répertoire de sortie de l'Agent (fichiers de résultats). par exemple C:\Roster\Out

  • Enabled - True

  • RosterAthleticsMapping - True

  • UnicodeExport - True


FinishLynxImport

  • MapRoundIdsToEvents - True

  • RosterAthleticsMapping - True


Fermez la fenêtre des Paramètres d'échange ATL pour sauvegarder les modifications.


Allez maintenant dans Paramètres → Liste de manche → Modifier le reste de la liste de manche, et dans la nouvelle fenêtre, sélectionnez Noms d'alias 1 (le numéro 1), activez Utiliser des noms d'alias 5 pour l'exportation ATL, puis dans la deuxième colonne, ajoutez DNS à côté du statut DNS, DNF à côté du statut DNF et DQ à côté du statut DISQ.



Vous n'aurez à modifier ces paramètres que la première fois que vous configurez l'intégration ; après cela, ils seront disponibles par défaut.



Importer les start-lists


Une fois que vous avez préparé vos start-lists dans Roster Athletics, vous pouvez les importer dans OPTIc3.NET. Pour ce faire, faites un clic droit sur le nom de la compétition dans la fenêtre du navigateur de rencontre, sélectionnez Importer un événement et trouvez le fichier EVT (il devrait être enregistré dans le répertoire d'entrée que vous avez configuré dans Roster Agent).



La configuration de la synchronisation est maintenant terminée, et les start-lists d'une épreuve particulière sont chargées dans OPTIc3.NET. OPTIc3.NET est maintenant prêt à être utilisé, et l'épreuve peut commencer selon la procédure standard d'OPTIc3.NET.



Exporter les résultats


Une fois l'épreuve terminée et les résultats marqués dans OPTIc3.NET, cliquez sur l'icône en forme de flèche rouge dans la fenêtre Liste de manche : nom de l'événement et sélectionnez Terminer l'exportation Lynx. Cela sauvegardera le fichier LIF dans le dossier que vous avez spécifié dans le paramètre AutomaticExportDirectory. Après la sauvegarde, attendez environ 10 secondes ou moins pendant que les données se synchronisent avec Roster Athletics.



Maintenant, vous pouvez retourner dans Roster Athletics et voir les temps et classements des athlètes mis à jour depuis OPTIc3.NET. Les résultats sont également immédiatement disponibles dans l'application et sur le site web de Roster Athletics. 


Note importante : chaque fois que vous mettez à jour la start-list dans Roster Athletics, elle est automatiquement envoyée au Roster Athletics Agent, mais vous devez toujours Mettre à jour un événement dans OPTIc3.NET pour charger ces modifications.


La mise à jour des start-lists se fait dans le même menu que l'import de ces mêmes start-lists.


Si vous avez une lecture du vent dans OPTIc3.NET, cette information sera automatiquement transférée à Roster Athletics. 


Si vous n'avez pas ajouté les numéros de dossard, le champ Dossars dans OPTIc3.NET aura un identifiant d'athlète généré automatiquement. Veuillez noter que OPTIc3.NET prend en charge uniquement les BIB numériques. 


Temps de réaction : Si activés dans OPTIc3.NET, les temps de réaction seront transférés à Roster Athletics.


Statut des compétiteurs : dans OPTIc3.NET, le statut non OK pour chaque athlète peut être défini sous la colonne Disq. Ces options de statut se traduisent dans Roster de la manière suivante :

  • Champ vide → OK

  • DNS → DNS

  • DNF → DNF

  • DISQ → DQ (+ sélection de la règle de DQ)


Les règles de DQ peuvent être ajoutées dans Roster, mais pas directement depuis OPTIc3.NET.


Précision : nous recommandons d'utiliser les Millièmes comme précision des résultats dans OPTIc3.NET. En réglant sur les millièmes, tous les résultats seront envoyés au système Roster avec une précision de 1/1000, permettant à Roster d'attribuer les places correctement de manière automatique. Lorsque l'on règle sur les millièmes, l'application Roster et les impressions des résultats en .pdf afficheront toujours les centièmes, sauf lorsqu'il y a une égalité dans la place des centièmes, auquel cas la place des millièmes sera utilisée pour calculer la place et sera affichée en conséquence, par exemple, lorsque deux athlètes de deux séries différentes ont le même résultat.

Pour définir la précision par défaut, cliquez sur en haut à gauche de l'écran sur Chronométrage → Précision → 1/1000.



Conseils et astuces de dépannage


  • Assurez-vous d'utiliser la dernière version du RosterAgent (consultez la section Télécharger et installer l'agent de configuration Roster Athletics pour connaître le dernier numéro de version).

  • Si un message « Connexion impossible - permission refusée » apparaît lors de la tentative de connexion au RosterAgent, assurez-vous d'avoir chargé la dernière version du fichier de configuration agent pour la compétition. Ce fichier se télécharge depuis Détails de la compétition → Support de configuration.

  • Si vous utilisez des dossiers partagés et que votre statut de connexion est bon, mais que : a) vos start-lists dans Roster ne se mettent pas à jour, ou b) vos résultats sauvegardés ne sont pas mis à jour dans Roster,

    alors vérifiez soigneusement que les chemins des répertoires dans RosterAgent et OPTIc3.NET correspondent exactement et que toutes les étapes de configuration décrites précédemment ont été suivies précisément.

  • Le RosterAgent a la capacité de mettre en file d'attente les résultats enregistrés d'OPTIc3.NET si vous perdez la connexion (par exemple en cas de mauvaise ou très lente connexion Internet). En cas de perte de connexion, les fichiers LIF enregistrés seront mis en attente et automatiquement téléchargés dès que la reconnexion sera détectée et rétablie par l'Agent. La file d'attente des téléchargements est visible dans le RosterAgent et est normalement vide lorsqu'il n'y a pas de problème de connexion ou qu'elle est vidée après l'envoi automatique des résultats en attente.