SportScoreboard › DocumentatieDocumentationDocumentation

10. Troubleshooting

Find the message or the symptom, then follow the steps. The exact wording of the messages is the program's own.

First: collect the evidence

If something looks wrong, before you close anything: Settings… → Save diagnostics… and keep the zip. It holds the logs of the last seven days and a short information file (program version, Windows, whether the engine runs). It holds no rosters, teams or match files; the logs can mention court names, and a quick match is named after its two sides, so you know what you are sending. Send it when you ask for help. Open logs folder shows the log files themselves (sportscoreboard-<date>.log for the app, engine-<date>.log for the engine).

The engine

"The Scoreboard Engine (preview build) was not found."

The app looks for SportScoreboard.Engine.exe next to its own .exe (and, for developers, in the sibling build folder). It is not there. Install or copy the engine files next to the app, or, from the sources, build the whole solution (building the app builds the engine too). The log line Engine exe not found. Looked next to the app (...) tells where it looked.

"Engine: not running" and a Retry button

The engine could not start in time. Press Retry. If it fails again: another copy of the engine may already hold port 5115 (close it in Task Manager: SportScoreboard.Engine), or the exe is blocked by antivirus. Check engine-<date>.log.

"A Scoreboard Engine from an older build is still running. Restart it with the current build?"

The app found an engine that does not match its own version, for instance after an update. Answer Yes: running matches are saved and come back after the restart. The Prepare page also shows a red banner This page is newer than the running engine ... when the page and the engine are out of step: restart the engine.

"The engine could not create the match", "Could not start the match"

The message names the reason, for example Team 'Zulte Waregem' has 15 players; the maximum is 14 (official mode, roster too large): shorten the roster (set players inactive) or use casual mode.

The engine keeps running after I closed the app

When you close the app it asks what to do with a running engine. Stop the engine and exit also stops it. If an engine was left behind by a crash it stops by itself when the app that started it is gone.

Phones and screens

  1. Is the engine open to phones? The status must read Engine: ready — open to phones. If it says this PC only, click Open to phones.
  2. Are the phone and the laptop on the same Wi-Fi? Guest networks often isolate devices from each other.
  3. Does the link use the laptop's address (like 192.168.10.107), not localhost? Links made on another PC with localhost only work on that PC.
  4. Windows Firewall: allow the program on private networks; port 5115.
  5. Several networks on the laptop (Ethernet and Wi-Fi)? Make sure the address in the links is the one of the phones' network: Which network?

The court was deleted or the link is wrong or old. Ask the organizer for a new QR code from Share….

"CONNECTION LOST — the clock is stopped and buttons are locked until it is back"

The page lost the engine. It retries by itself. Check the Wi-Fi and that the laptop is awake. When the connection is back the page catches up; nothing was lost.

"Wrong key — try again."

The organizer key is wrong. It is shown in the desktop app, printed when the engine starts and copied to the clipboard when you click Copy organizer key (tray menu). If you lost it, choose Copy organizer key in the tray menu (or Start page… in the classic window): it copies the key again. An engine started by hand shows its key in its own window; restarting it creates a new key, and your courts and matches stay.

A big screen shows an old score

Reload the page (F5). If the screen says connection lost, see above. Check that the screen's device did not go to sleep.

During a match

I scored for the wrong team

Undo, then score again. Undo goes back one step at a time.

The clock is wrong

Use Set clock… in the web controller, under the clock buttons (type the time as mm:ss), or −10 s / +10 s for a small nudge.

A card or substitution is refused

The message says why: the player is already sent off or suspended, is not on the field, the substitution limit is used up, or the sport does not use that card. The number pad greys out the numbers that cannot be picked. Check the rules page: a rule may be switched on or off for your tournament.

The match did not start: "Action not allowed."

The action is not possible in this state (for example scoring after the match ended, or a clock command in a sport without a clock).

The program crashed during a match

Start it again. The match is listed under the live matches on the start screen with its score: click Controller (and Big screen) to open the windows again, or open the operator link again. The engine kept the match.

The match could not be saved (disk full or no access)

The engine saves the match after every action. If the disk is full or the folder is locked, free some space; meanwhile use Save (or Ctrl+S) in the web controller to download the match as a file.

Windows and files

A window will not close

Big-screen and controller windows opened by the app have a title bar and an X. If one is left over after a crash, close it from the taskbar, or use Stop the engine and exit next time: it also closes the windows the app opened.

The browser asks "Leave site?"

The controller page asks before it closes, so one click on the X does not lose your place. Choose Leave to close it.

The installer says "Windows protected your PC"

The installer is not code-signed. Choose More info → Run anyway, after checking the .sha256 file of the release.

Still stuck

Send the diagnostics zip with a short description: what you did, what you expected, what happened, and the time. The log lines carry the time to the millisecond.

10. Problemen oplossen

Zoek de melding of het verschijnsel op en volg dan de stappen. De exacte bewoording van de meldingen is die van het programma zelf.

Eerst: verzamel het bewijs

Als er iets mis lijkt, voor je iets sluit: Instellingen… → Diagnose opslaan… en bewaar het zipbestand. Het bevat de logs van de laatste zeven dagen en een kort infobestand (programmaversie, Windows, of de engine draait). Het bevat geen selecties, teams of wedstrijdbestanden; de logs kunnen veldnamen vermelden en een snelle wedstrijd heet naar haar twee kanten, dus je weet wat je opstuurt. Stuur het mee als je om hulp vraagt. Logmap openen toont de logbestanden zelf (sportscoreboard-<date>.log voor de app, engine-<date>.log voor de engine).

De engine

"De Scoreboard Engine (previewversie) is niet gevonden."

De app zoekt SportScoreboard.Engine.exe naast haar eigen .exe (en, voor ontwikkelaars, in de naastgelegen buildmap). Ze staat er niet. Installeer of kopieer de enginebestanden naast de app, of bouw, vanuit de broncode, de hele oplossing (de app bouwen bouwt ook de engine). De logregel Engine exe not found. Looked next to the app (...) zegt waar er gezocht werd.

"Engine: draait niet" en een knop Opnieuw proberen

De engine kon niet op tijd starten. Druk op Opnieuw proberen. Als het weer mislukt: een andere kopie van de engine kan poort 5115 al bezetten (sluit ze in Taakbeheer: SportScoreboard.Engine), of het exe-bestand wordt door het antivirusprogramma geblokkeerd. Kijk in engine-<date>.log.

"Er draait nog een Scoreboard Engine van een oudere versie. Opnieuw starten met de huidige versie?"

De app vond een engine die niet bij haar eigen versie past, bijvoorbeeld na een update. Antwoord Ja: lopende wedstrijden worden opgeslagen en komen terug na de herstart. De pagina Voorbereiden toont ook een rode banner Deze pagina is nieuwer dan de draaiende engine ... wanneer de pagina en de engine niet gelijk lopen: herstart de engine.

"De engine kon de wedstrijd niet aanmaken", "Kon de wedstrijd niet starten"

De melding noemt de reden, bijvoorbeeld Team 'Zulte Waregem' has 15 players; the maximum is 14 (officiële modus, selectie te groot): kort de selectie in (zet spelers op inactief) of gebruik de casual modus.

De engine blijft draaien nadat ik de app sloot

Wanneer je de app sluit, vraagt ze wat er met een lopende engine moet gebeuren. Engine stoppen en afsluiten stopt ze ook. Als er door een crash een engine is achtergebleven, stopt ze vanzelf wanneer de app die haar startte weg is.

Gsm's en schermen

  1. Staat de engine open voor gsm's? De status moet Engine: klaar — open voor gsm's tonen. Als er enkel deze pc staat, klik je op Openen voor gsm's.
  2. Zitten de gsm en de laptop op dezelfde wifi? Gastnetwerken isoleren toestellen vaak van elkaar.
  3. Gebruikt de link het adres van de laptop (zoals 192.168.10.107), niet localhost? Links die op een andere pc met localhost gemaakt zijn, werken enkel op die pc.
  4. Windows Firewall: laat het programma toe op privénetwerken; poort 5115.
  5. Meerdere netwerken op de laptop (Ethernet en wifi)? Zorg dat het adres in de links dat van het netwerk van de gsm's is: Welk netwerk?

Het veld werd verwijderd of de link is verkeerd of oud. Vraag de organisator om een nieuwe QR-code via Delen….

"VERBINDING VERLOREN — de klok staat stil en de knoppen zijn geblokkeerd tot ze terug is"

De pagina verloor de engine. Ze probeert vanzelf opnieuw. Controleer de wifi en of de laptop wakker is. Wanneer de verbinding terug is, haalt de pagina zich in; er ging niets verloren.

"Verkeerde sleutel — probeer opnieuw."

De organisatorsleutel is verkeerd. Ze wordt getoond in de desktop-app, afgedrukt wanneer de engine start en naar het klembord gekopieerd wanneer je op Kopieer organisatorsleutel (menu van het systeemvak) klikt. Als je ze kwijt bent, kies je Kopieer organisatorsleutel in het menu van het systeemvak (of Startpagina… in het klassieke venster): die kopieert de sleutel opnieuw. Een engine die met de hand gestart werd, toont haar sleutel in haar eigen venster; herstarten maakt een nieuwe sleutel, en je velden en wedstrijden blijven.

Een groot scherm toont een oude score

Laad de pagina opnieuw (F5). Als het scherm verbinding verloren zegt, zie hierboven. Controleer dat het toestel van het scherm niet in slaapstand ging.

Tijdens een wedstrijd

Ik scoorde voor het verkeerde team

Ongedaan, en score dan opnieuw. Ongedaan gaat één stap per keer terug.

De klok is fout

Gebruik Klok instellen… in de webcontroller, onder de klokknoppen (typ de tijd als mm:ss), of −10 s / +10 s voor een kleine correctie.

Een kaart of wissel wordt geweigerd

De melding zegt waarom: de speler is al uitgesloten of geschorst, staat niet op het veld, de wisselbeperking is opgebruikt, of de sport gebruikt die kaart niet. Het nummerpaneel maakt de nummers die niet gekozen kunnen worden grijs. Controleer de regelpagina: een regel kan voor jouw toernooi aan- of uitgezet zijn.

De wedstrijd startte niet: "Actie niet toegestaan."

De actie is in deze toestand niet mogelijk (bijvoorbeeld scoren nadat de wedstrijd afgelopen is, of een klokopdracht in een sport zonder klok).

Het programma crashte tijdens een wedstrijd

Start het opnieuw. De wedstrijd staat onder de wedstrijden die bezig zijn op het startscherm, met haar score: klik op Controller (en Groot scherm) om de vensters opnieuw te openen, of open de operatorlink opnieuw. De engine bewaarde de wedstrijd.

De wedstrijd kon niet opgeslagen worden (schijf vol of geen toegang)

De engine slaat de wedstrijd na elke actie op. Is de schijf vol of de map vergrendeld, maak dan wat ruimte vrij; gebruik intussen Opslaan (of Ctrl+S) in de webcontroller om de wedstrijd als bestand te downloaden.

Windows en bestanden

Een venster wil niet sluiten

Groot-scherm- en controllervensters die door de app geopend werden, hebben een titelbalk en een X. Als er na een crash een overblijft, sluit je het via de taakbalk, of gebruik je de volgende keer Engine stoppen en afsluiten: die sluit ook de vensters die de app opende.

De browser vraagt "Site verlaten?"

De controllerpagina vraagt dit voor ze sluit, zodat één klik op de X je plaats niet kost. Kies Verlaten om ze te sluiten.

Het installatieprogramma zegt "Windows heeft je pc beveiligd"

Het installatieprogramma is niet digitaal ondertekend. Kies Meer info → Toch uitvoeren, nadat je het .sha256-bestand van de release gecontroleerd hebt.

Nog altijd vast

Stuur het diagnosezipbestand mee met een korte beschrijving: wat je deed, wat je verwachtte, wat er gebeurde, en het tijdstip. De logregels dragen het tijdstip tot op de milliseconde.

10. Dépannage

Trouvez le message ou le symptôme, puis suivez les étapes. La formulation exacte des messages est celle du programme.

D'abord : rassembler les preuves

Si quelque chose semble anormal, avant de fermer quoi que ce soit : Paramètres… → Enregistrer le diagnostic… et conservez le zip. Il contient les journaux des sept derniers jours et un court fichier d'informations (version du programme, Windows, état du moteur). Il ne contient ni effectifs, ni équipes, ni fichiers de match ; les journaux peuvent mentionner des noms de terrains, et un match rapide porte le nom de ses deux côtés : vous savez donc ce que vous envoyez. Envoyez-le quand vous demandez de l'aide. Ouvrir le dossier des journaux affiche les fichiers journaux eux-mêmes (sportscoreboard-<date>.log pour l'application, engine-<date>.log pour le moteur).

Le moteur

« Le Scoreboard Engine (version d'essai) est introuvable. »

L'application cherche SportScoreboard.Engine.exe à côté de son propre .exe (et, pour les développeurs, dans le dossier de compilation voisin). Il n'y est pas. Installez ou copiez les fichiers du moteur à côté de l'application, ou, à partir des sources, compilez toute la solution (compiler l'application compile aussi le moteur). La ligne de journal Engine exe not found. Looked next to the app (...) indique où il a cherché.

« Moteur : arrêté » et un bouton Réessayer

Le moteur n'a pas pu démarrer à temps. Appuyez sur Réessayer. Si cela échoue à nouveau : une autre copie du moteur occupe peut-être déjà le port 5115 (fermez-la dans le Gestionnaire des tâches : SportScoreboard.Engine), ou l'exécutable est bloqué par l'antivirus. Consultez engine-<date>.log.

« Un Scoreboard Engine d'une ancienne version tourne encore. Le redémarrer avec la version actuelle ? »

L'application a trouvé un moteur qui ne correspond pas à sa propre version, par exemple après une mise à jour. Répondez Oui : les matchs en cours sont enregistrés et reviennent après le redémarrage. La page Préparer affiche aussi un bandeau rouge Cette page est plus récente que le moteur en cours ... quand la page et le moteur ne sont pas synchronisés : redémarrez le moteur.

« Le moteur n'a pas pu créer le match », « Impossible de démarrer le match »

Le message indique la raison, par exemple Team 'Zulte Waregem' has 15 players; the maximum is 14 (mode officiel, effectif trop grand) : réduisez l'effectif (mettez des joueurs en inactif) ou utilisez le mode casual.

Le moteur continue de tourner après que j'ai fermé l'application

Quand vous fermez l'application, elle demande ce qu'il faut faire d'un moteur en cours d'exécution. Arrêter le moteur et quitter l'arrête aussi. Si un moteur a été laissé par un plantage, il s'arrête tout seul quand l'application qui l'a démarré a disparu.

Téléphones et écrans

Un téléphone n'arrive pas à ouvrir le lien

  1. Le moteur est-il ouvert aux téléphones ? L'état doit indiquer Moteur : prêt — ouvert aux téléphones. S'il indique ce PC seulement, cliquez sur Ouvrir aux téléphones.
  2. Le téléphone et l'ordinateur portable sont-ils sur le même Wi-Fi ? Les réseaux pour invités isolent souvent les appareils les uns des autres.
  3. Le lien utilise-t-il l'adresse de l'ordinateur portable (du genre 192.168.10.107), et non localhost ? Les liens créés sur un autre PC avec localhost ne fonctionnent que sur ce PC.
  4. Pare-feu Windows : autorisez le programme sur les réseaux privés ; port 5115.
  5. Plusieurs réseaux sur l'ordinateur portable (Ethernet et Wi-Fi) ? Vérifiez que l'adresse dans les liens est celle du réseau des téléphones : Quel réseau ?

« ce lien ne fonctionne pas (terrain supprimé ou QR/lien incorrect) — demandez-en un nouveau »

Le terrain a été supprimé ou le lien est incorrect ou ancien. Demandez à l'organisateur un nouveau QR code depuis Partager….

« CONNEXION PERDUE — le chronomètre est arrêté et les boutons sont verrouillés jusqu'au retour »

La page a perdu le moteur. Elle réessaie toute seule. Vérifiez le Wi-Fi et que l'ordinateur portable est éveillé. Quand la connexion est revenue, la page rattrape son retard ; rien n'a été perdu.

« Mauvaise clé — réessayez. »

La clé de l'organisateur est incorrecte. Elle est affichée dans l'application de bureau, imprimée au démarrage du moteur et copiée dans le presse-papiers quand vous cliquez sur Copier la clé d'organisateur (menu de la zone de notification). Si vous l'avez perdue, choisissez Copier la clé d'organisateur dans le menu de la zone de notification (ou Page de démarrage… dans la fenêtre classique) : elle copie à nouveau la clé. Un moteur démarré à la main affiche sa clé dans sa propre fenêtre ; le redémarrer crée une nouvelle clé, et vos terrains et vos matchs restent.

Un grand écran affiche un ancien score

Rechargez la page (F5). Si l'écran indique connexion perdue, voyez ci-dessus. Vérifiez que l'appareil de l'écran ne s'est pas mis en veille.

Pendant un match

J'ai marqué pour la mauvaise équipe

Annuler, puis marquez à nouveau. Annuler revient en arrière une étape à la fois.

Le chrono est faux

Utilisez Régler le chrono… dans le contrôleur web, sous les boutons du chrono (tapez l'heure sous la forme mm:ss), ou −10 s / +10 s pour une petite correction.

Un carton ou un remplacement est refusé

Le message en donne la raison : le joueur est déjà exclu ou suspendu, n'est pas sur le terrain, la limite de remplacements est épuisée, ou le sport n'utilise pas ce carton. Le pavé numérique grise les numéros qui ne peuvent pas être choisis. Consultez la page des règles : une règle peut être activée ou désactivée pour votre tournoi.

Le match n'a pas démarré : « Action non autorisée. »

L'action n'est pas possible dans cet état (par exemple marquer après la fin du match, ou une commande de chrono dans un sport sans chrono).

Le programme a planté pendant un match

Redémarrez-le. Le match est listé parmi les matchs en cours de l'écran de départ avec son score : cliquez sur Contrôleur (et Grand écran) pour rouvrir les fenêtres, ou rouvrez le lien de l'opérateur. Le moteur a gardé le match.

Le match n'a pas pu être enregistré (disque plein ou accès refusé)

Le moteur enregistre le match après chaque action. Si le disque est plein ou si le dossier est verrouillé, libérez de l'espace ; en attendant, utilisez Enregistrer (ou Ctrl+S) dans le contrôleur web pour télécharger le match sous forme de fichier.

Windows et fichiers

Une fenêtre ne se ferme pas

Les fenêtres de grand écran et de contrôleur ouvertes par l'application ont une barre de titre et une croix. S'il en reste une après un plantage, fermez-la depuis la barre des tâches, ou utilisez Arrêter le moteur et quitter la prochaine fois : cela ferme aussi les fenêtres ouvertes par l'application.

Le navigateur demande « Quitter le site ? »

La page du contrôleur demande confirmation avant de se fermer, afin qu'un clic sur la croix ne vous fasse pas perdre votre place. Choisissez Quitter pour la fermer.

Le programme d'installation indique « Windows a protégé votre ordinateur »

Le programme d'installation n'est pas signé numériquement. Choisissez Informations complémentaires → Exécuter quand même, après avoir vérifié le fichier .sha256 de la version.

Toujours bloqué

Envoyez le zip de diagnostic avec une courte description : ce que vous avez fait, ce que vous attendiez, ce qui s'est passé, et l'heure. Les lignes de journal portent l'heure à la milliseconde près.

An unhandled error has occurred. Reload 🗙