Dans — Dokumentace programu

Dans — Technické informace

Dokumentace Dans — příprava prostředí

Stažení, instalace a spuštění

Požadavky pro běh Dans

Server

Operační systém Windows 10 nebo Windows 11 (64-bit)
Volný port severu
- Nejpohodlnější volný port 80
- Server lze alternativně provozovat na libovolném jiném portu, upraví se pouze spouštěcí příkaz (viz níže)
- Pro provoz mezi počítači musí být vybraný port serveru povolený pro obousměrný provoz, alternativně lze firewall vypnout zcela.

Tiskárna

Síťová tiskárna splňující následující:

S podporou přenosu IPP (Internet Print Protocol)
S podporou jednoho z formátů/standardů:
- přímý tisk PDF (formát PDF)
- Mopria (mobilní tisk z Androidu, formát PWG)
- AirPrint (tisk z Apple, formát URF).
Tiskárnu lze provozovat přes WiFi, kabelové připojení (Ethernet) je jistější

Klient

Internetové prohlížeče Chrome, Edge, Brave v aktuálních verzích
Firefox v aktuální verzi s povoleným nastavením layout.css.has-selector.enabled

Stažení, instalace a spuštění

V libovolném prohlížeči přejděte na stránku www.dancesport.services
Ze sekce Stažení programu stáhněte archiv s aktuální verzí programu Dans
Archiv rozbalte do libovolného adresáře
Spusťte server sart z příkazové řádky nebo dávkovým souborem příkazem (na výchozím portu 80):
sart
Je-li port 80 obsazený, spouštějte server sart alternativně příkazem:
sart -l 8686
kde -l 8686 udává port, na kterém běží server sart

Přístup k serveru z klienta

K běžícímu serveru sart se přistupuje v rámci sítě z klientů (požadavky výše)
Na počítači s běžícím serverem sart použijte v prohlížeči adresu:
http://127.0.0.1/control
Pokud server sart běží na jiném než výchozím portu 80, použijte adresu:
http://127.0.0.1:8686/control
Z dalších počítačů v síti přistupujte k běžícímu serveru přes adresy: http://192.168.x.y/control
http://192.168.x.y:8686/control
kde 192.168.x.y je IP adresa počítače s běžícím serverem sart a povoleným obousměrným provozem pro zvolený port

Adresy pro specifické využití

Při přístupu z klienta k serveru se podle použité adresy, respektive segmentu URL za lomítkem následujícím za IP adresou běžícího serveru, zobrazí rozhraní pro daný typ použití.

http://192.168.x.y/control - rozhraní pro zpracování soutěže
http://192.168.x.y/device - rozhraní pro tablety (hodnoticí zařízení pro porotce)
http://192.168.x.y/display - rozhraní pro displeje a promítání informací o probíhajících soutěžích (rozlosování párů do skupin, vyhlašování výsledků apod.)

Výše uvedené adresy lze použít (zejména pro testovací účely) i v rámci počítače s běžícím serverem sart ve tvaru http://127.0.0.1/xxx

Zjištění aktuálně používané verze

Aktuálně používanou verzi zjistíte dvěma možnými způsoby:

V příkazové řádce nebo dávkovém souboru (obdobně jako spouštíte server sart) použijte v adresáři s rozbaleným serverem příkaz:
sart -V
Vypíše se aktuální verze Dans.
S běžícím serverem sart klepněte v rozhraní pro zpracování soutěže v záhlaví na odkaz Dans. Informace o verzi Dans je uvedena v rámci prvního odstavce.

Konfigurace

Důležité adresáře

Server sart používá kromě adresáře, z něhož se spouští, další adresáře pro specifické použití. Jedná se o tyto:

C:\Users\Uzivatel\AppData\Roaming\dans (vytvořen automaticky při prvním spuštění sart)
V tomto adresáři se ukládají databázové soubory, jmenovitě:
- dans-event-XXXXXXXX.db - databázové soubory jednotlivých soutěžních akcí
- dans-realm-XXXXXXXX.db - databázový soubor říše
- dans-sys.db - databázový soubor s globálním nastavením
- csts-cache.db - databázový soubor s cache pro akce ČSTS
C:\Users\Uzivatel\AppData\Local\dans (vytvořen automaticky při prvním spuštění sart)
V tomto adresáři se ukládají pracovní a dočasné soubory (jejich případné smazání nemá na činnost programu vliv), jmenovitě:
- sart.YYYY-HH-MM.log - soubor s protokolem běžícího serveru sart pro daný den, slouží zejména ke zpětné diagnostice problémů během používání programu
- csts.YYYY-HH-MM.log - soubor s protokolem programu csts.exe (spouští se automaticky) pro daný den, slouží zejména ke zpětné diagnostice problémů během používání programu
- YYMMDD (XXXX) XXX.pdf - soubory PDF s reporty, které uživatel tiskne na nastavené tiskárně. Prefix YYMMDD odpovídá datu akce, v závorce je identifikace soutěže a kola a za závorkou typ reportu.
- YYMMDD result X csts XXXXX.json - soubory JSON s výsledky jednotlivých soutěží, které již byly odeslány na web ČSTS.
- XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX - dočasné soubory

Globální nastavení

Spusťte server sart a následně spusťte ve webovém prohlížeči Dans. V záhlaví přejděte na Konfigurace. Následně upravte nastavení v jednotlivých sekcích:

Výstupy

V sekci Výstupy definujete Tiskárny a Displeje, na kterých chcete tisknout/promítat reporty z Dans.

Tiskárny

Klepněte na tlačítko Tiskárny, čímž zobrazíte seznam tiskáren.
Vpravo klepněte na tlačítko Přidat.
V zobrazeném dialogovém okně Nová tiskárna zadejte její Zkratku (tak bude označena v seznamu tiskáren), IP adresu (192.168.x.y) a případně Popis. Nastavení nové tiskárny uložte klepnutím na tlačítko Uložit.
Nově přidaná tiskárna se zobrazí v seznamu tiskáren. Sloupec Stav ukazuje její dostupnost (připravená), další sloupce pak údaje zadané v dialogovém okně Nová tiskárna.
Po označení vybrané tiskárny pomocí zaškrtávacího políčka se zpřístupní v horní části další volby:
- Upravit - klepnutím zobrazíte pro danou tiskárnu stejné dialogové okno jako při jejím přidávání, v němž můžete upravit její nastavení
- Test - klepnutím vytisknete zkušební stránku
- Smazat - klepnutím tiskárnu odstraníte

Nově přidanou tiskárnu je potřeba přiřadit tiskové frontě (viz Fronty níže). Při přidávání tiskárny není nutné, aby tato byla nainstalovaná v počítači s běžícím serverem sart. tisk v Dans pouze posílá tištěný report na IP adresu tiskárny a samotný tisk nechává v její režii. Každý report odeslaný na tiskárnu se ukládá také jako soubor PDF v adresáři C:\Users\Uzivatel\AppData\Local\dans (více viz Důležité adresáře výše).

Displeje

Klepněte na tlačítko Displeje, čímž zobrazíte seznam displejů.
Vpravo klepněte na tlačítko Přidat.
V zobrazeném dialogovém okně Nový displej zadejte jeho Zkratku (tak bude označen v seznamu displejů), URL segment (slouží k adresování v síti) a případně Popis.
V rozevíracím seznamu Uspořádání volíte, zda bude daný displej zobrazovat pouze jeden report (Jedna plocha), nebo více včetně orientace (Více ploch vodorovně či Více ploch svisle). Pokud zvolíte více reportů (ploch), zadejte jejich počet (Počet ploch)
Nastavení nového displeje uložte klepnutím na tlačítko Uložit.
Nově přidaný displej se zobrazí v seznamu displejů. Následně je potřeba přiřadit jej odpovídající frontě (viz Fronty níže).
Po označení displeje pomocí zaškrtávacího tlačítka se v horní části zpřístupní další volby:
- Upravit - klepnutím zobrazíte pro daný displej stejné dialogové okno jako při jeho vytváření, v němž můžete upravit jeho nastavení
- Smazat - klepnutím displej odstraníte

Fronty

V sekci Fronty definujete propojení jednotlivých reportů s tiskárnami a displeji (co se kde tiskne a co se kde zobrazuje).

Nastavení výchozí tiskárny

V prostředním sloupci Fronta klepněte na Default Queue (výchozí tisková fronta).
V levé části se zobrazí propojení všech reportů (šedě zaškrtnutá zaškrtávací políčka) s touto tiskovou frontou.
V pravém sloupci označte pomocí zaškrtávacího tlačítka vybranou tiskárnu ze seznamu Tiskárna. Tímto dojde k jejímu propojení s tiskovou frontou.

Vytvoření a nastavení nové fronty

V prostředním sloupci Fronta klepněte v pravé části na tlačítko + (plus).
V zobrazeném dialogovém okně Nová fronta zadejte její Zkratku (označení) a případně Popis.
Nastavení nové fronty uložte klepnutím na tlačítko Uložit.
Nově vytvořená fronta se zobrazí v prostředním sloupci v seznamu front. Klepnutím na tlačítko s tužkou vedle vybrané fronty zobrazíte stejné dialogové okno jako při jejím vytváření, v němž můžete upravit její nastavení.
Klepnutím na frontu v seznamu front zpřístupníte výběr reportů, které bude zahrnovat (reporty vyberte pomocí zaškrtávacích políček z levého sloupce Report), a tiskárny/displeje, kam má směřovat (tiskárnu/displej vyberte pomocí zaškrtávacího políčka z pravého sloupce Tiskárna nebo Displej).
Klepnutím na vybraný Report (v levém sloupci), případně Tiskárnu či Displej (v pravém sloupci) se zobrazí tisková fronta/fronty, s níž jsou daný report, tiskárna či displej propojeny.

Úprava a odstranění fronty

V prostředním sloupci Fronta klepněte v řádku fronty, kterou chcete upravovat, v pravé části na tlačítko s tužkou.
V zobrazeném dialogovém okně upravte její Zkratku a případně Popis a následně změny uložte klepnutím na tlačítko Uložit.
Obdobně jako při vytváření nové fronty upravte po klepnutí na požadovanou frontu její propojení s reporty (sloupec Report vlevo) a tiskárnou/displejem (sloupce Tiskárna a Displej vpravo).
Chcete-li frontu zcela odstranit, odstraňte nejprve její propojení se všemi reporty i tiskárnami/displeji a poté klepněte na tlačítko minus (vedle tlačítka s tužkou).

Tablety

V sekci Tablety definujete tablety (zařízení pro porotce) pro hodnocení. Tlačítky Vše a Schválené filtrujete seznam dostupných tabletů.

Registrace nového tabletu

Na tabletu, který chcete registrovat do systému, přejděte na stránku http://192.168.x.y/device (více viz Stažení, instalace a spuštění část Adresy pro specifické využití). Zobrazí se text Čeká na schválení doplněný pětimístným alfanumerickým kódem (aa111).
V sekci Tablety zobrazte seznam všech tabletů klepnutím na Vše v horní části.
V seznamu najděte tablet se stejným alfanumerickým kódem, pomocí zaškrtávacího políčka jej označte a poté klepněte v horní části na tlačítko Schválit.
U tabletu se změní ve sloupci Registrace stav na schváleno.
Na tabletu se zobrazí numerická klávesnice sloužící k zadání PINu (přihlášení porotce). V záhlaví se zobrazuje pětimístný alfanumerický kód sloužící ke snadnější identifikaci jednotlivých tabletů.

Editace tabletu

V seznamu tabletů označte tablet, který chcete upravit, pomocí zaškrtávacího políčka. Při větší počtu tabletů lze využít filtr pomocí tlačítek Vše, Schválené a Dostupné v záhlaví.
V horní části klepněte na Upravit.
V dialogovém okně upravte původní pětimístný kód na vlastní označení daného tabletu a změny uložte klepnutím na tlačítko Uložit.
Označenému tabletu v seznamu lze alternativně Zamítnout registraci, případně jej lze zcela Odstranit.

Číselníky

V sekci Číselníky najdete seznam všech předdefinovaných číselníků sloužících k definici jednotlivých soutěží a rolí účastníků soutěže. Pro specifické soutěže lze definovat číselníky vlastní a vytvářet tak soutěže/role dle potřeby.

Vytvoření nového číselníku

Klepnutím na odpovídající skupinu číselníků ji rozevřete a klepněte v pravé části na tlačítko Přidat.
V otevřeném dialogovém okně vyplňte pro nový číselník Klíč, Jméno, Zkratku a případně Popis.
Nový číselník uložte klepnutím na tlačítko Uložit.

Oprávnění

Sekce Oprávnění slouží k přihlašování k federacím či dalším zdrojům, které mohou poskytovat data pro soutěžní akce.

Přihlášení k ČSTS (nebo jinému zdroji)

Pomocí zaškrtávacího tlačítka označte řádek Český svaz tanečního sportu.
V horní části klepněte na Přihlásit.
V dialogovém okně zadejte Jméno a Heslo, jimiž se přihlašujete ke členskému profilu na webu ČSTS.
Potvrďte přihlášení klepnutím na tlačítko Přihlásit.
Ve sloupci Přihlášen jako se u dané federace zobrazí přihlašovací jméno, pod kterým je Dans ke zdroji přihlášen.

Odhlášení od zdroje

Pomocí zaškrtávacího tlačítka označte zdroj, od něhož se chcete odhlásit.
V horní části klepněte na tlačítko Odhlásit.
Alternativně se lze pomocí tlačítka Odhlásit vše odhlásit od všech zdrojů.

Dokumentace Dans — soutěžní akce

Založení a nastavení nové soutěžní akce

Založení nové akce pomocí importu z webu

Novou soutěžní akci založíte takto:

Spusťte server sart.
Spusťte Dans.
V rámci nabídky Konfigurace se v sekci Oprávnění přesvědčte, že jste přihlášení ke zdroji Český svaz tanečního sportu.
Přejděte do nabídky Soutěžní akce.
V horní části seznamu akcí klepněte na ČSTS a poté na Neimportované.
Z rozevíracího seznamu Načíst další dostupné akce vyberte měsíc, v němž se akce koná.
Pomocí zaškrtávacího políčka označte v seznamu požadovanou akci.
V horní části seznamu klepněte na Importovat: Akce.
Zvolená akce se přidá do seznamu Importovaných akcí a zůstane označená. Klepnutím na tlačítko Otevřít: Akce ji zvolíte jako aktuální. Klepnutím na její název v hlavní nabídce přejdete přímo do jejího prostředí, v němž lze celou akci zpracovat.

Změna aktuální soutěžní akce

Aktuální soutěžní akce je k dispozici jako druhá položka hlavní nabídky. Chcete-li ji změnit na jinou (z již založených) postupujte takto:

V hlavní nabídce klepněte na Soutěžní akce.
Pomocí zaškrtávacího políčka označte v seznamu požadovanou akci.
V horní části seznamu klepněte na Otevřít: Akce, čímž se tato nastaví jako aktuální. Klepnutím na její název v hlavní nabídce přejdete do jejího prostředí.

Úprava soutěžní akce

U soutěžních akcí můžete upravovat jejich parametry, postupujte takto:

V hlavní nabídce klepněte na Soutěžní akce.
Pomocí zaškrtávacího políčka označte v seznamu požadovanou akci.
V horní části seznamu klepněte na Upravit.
Zobrazí se dialogové okno s nastavením dané akce, kde lze změnit:
- Název akce - název soutěžní akce, načítá se při importu akce
- Lokace - místo konání akce, načítá se při importu akce
- Datum/první den akce - datum konání akce, načítá se při importu akce
- Rozvržení čísel - volba formátu tištěného startovního čísla při prezenci (případně bez tisku čísel)
- ID ve federaci - číslo soutěžní akce v URL propozic, načítá se při importu akce
- Limit počtu soutěží porotce/den - maximum soutěží pro porotce/den, načítá se při importu akce
Změny potvrďte klepnutím na tlačítko Uložit.
Alternativně lze označenou akci ze seznamu Odstranit.

Manuální založení nové místní akce

Novou místní soutěžní akci založíte takto:

Přejděte do nabídky Soutěžní akce.
V sekci místní klepněte vpravo nahoře na tlačítko Přidat.
Zobrazí se dialogové okno Nová soutěžní akce se stejnými poli, jako v případě úpravy soutěžní akce (viz výše).
Vyplňte požadované parametry nové akce.
Akci uložte klepnutím na tlačítko Uložit.
Nově vytvořenou akci označte pomocí zaškrtávacího políčka v seznamu akcí a otevřete klepnutím na tlačítko Otevřít: Akce.

Aktualizace dat soutěžní akce online

U akce se mohou průběžně aktualizovat její data z webu ČSTS, zejména stav přihlášených soutěžících, ale i další atributy.

V hlavní nabídce klepněte na Soutěžní akce.
Pomocí zaškrtávacího políčka označte v seznamu požadovanou akci.
V horní části seznamu klepněte na Připojit. Akce změní svůj stav ve stejnojmenném sloupci na Připojeno.
U připojených soutěží se v pravidelném intervalu (před akcí hodina, v den akce 5 minut) aktualizují jejich data (přihlášení, omluvení, časy konců prezencí atd.).
Aktualizaci dat online vypnete klepnutím na tlačítko Odpojit.

Export a import akce na jiný server

Soutěžní akci lze přesunout na jinou instanci běžícího serveru sart.

V hlavní nabídce klepněte na Soutěžní akce.
Pomocí zaškrtávacího políčka označte v seznamu požadovanou akci.
V horní části seznamu klepněte na Exportovat. Stáhne se archiv zip s databází zvolené akce.
Při importu na jiném serveru sart přejděte do seznamu soutěžních akcí (Soutěžní akce) a archiv s databází importujte pomocí tlačítka Importovat.

Exporty se ukládají ve formě archivu zip s databází akce do adresáře dle nastavení prohlížeče.

Zálohování akce

Běžící soutěžní akce se zálohují automaticky po uzavření každé soutěže, zálohu je možné vytvořit i ručně. Postupujte následovně:

V hlavní nabídce klepněte na Soutěžní akce.
Není-li aktuálně běžící akce označena, označte ji pomocí zaškrtávacího políčka v seznamu akcí.
V horní části seznamu klepněte na Zálohovat.

Zálohy se ukládají ve formě archivu zip s databází akce do adresáře
C:\Users\Uzivatel\AppData\Roaming\dans\backup

Kalkulace

V seznamu soutěžních akci najdete také informaci o výši licenčního poplatku za jednotlivé akce. Ten je určen jako součet poplatků za jednotlivé soutěže, který se určuje takto:
Poplatek za soutěž = počet startů × počet porotců × počet tanců × 0,25 Kč

V hlavní nabídce klepněte na Soutěžní akce.
Pomocí zaškrtávacího políčka označte v seznamu požadovanou akci.
V horní části seznamu klepněte na Kalkulace.
Zobrazí se dialogové okno s odhadem poplatku podle počtu přihlášených a definic jednotlivých soutěží i skutečnou výší podle již proběhlých soutěží.

Úpravy nové soutěžní akce

Úpravy jednotlivých soutěží

V otevřené soutěžní akci přejděte do sekce Soutěže. Definice jednotlivých soutěží se stahují při importu akce a v drtivé většině případů není zapotřebí do nich zasahovat. Pokud to ovšem situace vyžaduje, lze jednotlivé parametry vybraných soutěží měnit. Navíc je dostupných i několik doplňkových voleb, které usnadňují celkové zpracování jednotlivých soutěží.

Změna tanců

Tance v soutěži upravíte takto:

U vybrané soutěže klepněte v pravé části řádku na tlačítko Tance.
V zobrazeném dialogovém okně upravte výběr a/nebo pořadí jednotlivých tanců.
- Tlačítky STT a LAT pod označením soutěže volíte přímo tance dané disciplíny (všechny)
- Tlačítky se šipkami v levé části posouváte vybraný tanec v pořadí
- Tanec volíte klepnutím na jeho název a následným výběrem z rozevíracího seznamu. Ten obsahuje pouze tance obsažené v odpovídajícím číselníku (více viz Konfigurace část Číselníky).
- Tlačítky Plus a Minus přidáváte (nad), respektive odebíráte jednotlivé tance.
Změny uložte klepnutím na tlačítko Uložit.

Tance je možné upravit i při vytváření nového kola v dialogovém okně Nové kolo (více viz Uzavření prezence a tvorba kol část Uzavření prezence a vytvoření prvního kola).

Změna parametrů soutěže

U vybrané soutěže klepněte v pravé části řádku na tlačítko Definice.
V zobrazeném dialogovém okně můžete upravit v horní polovině nastavení definice soutěže, ve spodní pak doplňkové informace, jmenovitě:
- Číslo soutěže - unikátní označení soutěže, nelze jej duplikovat (zobrazí se upozornění Číslo už patří jiné soutěži), řada čísle však nemusí být souvislá, nemusí ani začínat číslem 1. Výchozí hodnota se stahuje při importu soutěžní akce.
- Blok - číslo bloku soutěží, slouží ke zpřehlednění práce. Výchozí hodnota je 1 (všechny soutěže v jednom bloku) a stahuje se při importu soutěžní akce. Čísla bloků nemusí tvořit souvislou řadu.
- Velikost skupiny - určuje maximální počet soutěžících na parketu, podle něhož Dans automaticky nabízí pro jednotlivá kola odpovídající počet skupin. Výchozí hodnota neurčena.
- Min. počet porotců - minimální počet porotců pro danou soutěž, bez kterého ji nelze spustit. Výchozí hodnota odpovídá parametrům dané soutěže a SŘ, stahuje se při importu soutěžní akce.
Změny uložte klepnutím na tlačítko Uložit.

Manuální vytvoření nové soutěže

V seznamu soutěží klepněte vpravo nahoře na tlačítko Přidat.
Zobrazí se dialogové okno Nová soutěž se stejnými poli jako v případě změny parametrů již existující soutěže (viz výše).
Vyplňte požadované parametry nové soutěže.
Soutěž uložte klepnutím na tlačítko Uložit.
Nově vytvořená soutěž se zobrazí v seznamu soutěží dané akce. Upravte u ní složení tanců (tlačítko Tance).

Hromadné vytvoření soutěží importem

Soutěže je možné přidávat i hromadně pomocí importu ze souboru xlsx. U něj je potřeba dodržet tuto strukturu:

Název souboru - libovolně
Název listu Competitions
Sloupce s parametry dané soutěže, jejichž hodnoty odpovídají číselníkům (více viz Konfigurace část Číselníky).
Povinné sloupce (záhlaví):
- number - číslo soutěže - unikátní v rámci akce
- grade - druh soutěže (číselník Úrovně soutěží)
- competitors - kdo soutěží (číselník Soutěžící)
Volitelné sloupce (záhlaví):
- id - id soutěže
- series - seriál (číselník Seriály)
- age - věková kategorie (číselník Věkové kategorie)
- class - výkonnostní třída (číselník Výkonnostní třídy)
- discipline - disciplína (číselník Disciplíny)
- dances - tance (číselník Tance) - výčet tanců dané soutěže
- check_in_end - konec prezence (časový údaj)
- heat_size - velikost skupiny (počet soutěžících na parket)
- block - blok
- floor - parket

V seznamu soutěží klepněte vpravo nahoře na tlačítko Načíst.
Zobrazí se dialogové okno Načtení soutěží, ve kterém vyberte soubor xlsx s definicemi importovaných soutěží.
Soutěže načtěte klepnutím na tlačítko Načíst.
V případě chyby při importu je tato indikována červeným tlačítkem vedle tlačítka Načíst, klepnutím na něj zobrazíte další podrobnosti.
Importované soutěže se zobrazí v seznamu soutěží. Jejich parametry lze upravit pomocí tlačítek Definice a Tance.

Úpravy porotců

V otevřené soutěžní akci přejděte do sekce Porota. Seznam porotců se stahuje při importu akce, v případě potřeby ovšem lze nové porotce doplnit.

Přidání porotce

V sekci Porota >>> Registrace zobrazte seznam importovaných porotců.
Vpravo nahoře klepněte na tlačítko Přidat.
V zobrazeném dialogovém okně Registrace nového porotce zadejte jeho Jméno, Příjmení, u zahraničních Stát, v případě porotců s licencí ČSTS zadejte i jeho Federace.ID ve tvaru csts.12345678, kde 12345678 představuje jeho IDT.
Porotce uložte klepnutím na tlačítko Uložit.
Nově přidaný porotce se zobrazí v seznamu porotců, label (unikátní označení v prvním sloupci seznamu) mu systém přiřadí automaticky. Porotce lze přidávat i hromadným importem (viz níže).

Úprava porotce

V sekci Porota >>> Registrace vyhledejte požadovaného porotce a označte jej pomocí zaškrtávacího tlačítka.
Po klepnutí na tlačítko Upravit v záhlaví se obrazí dialogové okno Porotce se stejnými poli jako v případě přidání nového porotce.
Upravte požadované hodnoty a změny uložte klepnutím na tlačítko Uložit.

Přiřazení porotců do jednotlivých soutěží

V Sekci Porota >>> Soutěže přiřaďte jednotlivým soutěžím příslušné porotce. Počet již zadaných porotců pro danou soutěž se zobrazuje pod číslem soutěže (červeně jsou označeny nedostatečně obsazené soutěže), počet přiřazených soutěží pro jednotlivé porotce napravo vedle jména (červeně jsou označeny případy překročení limitu soutěží porotce/den). Pro snadnější vyplňování lze seznam soutěží řadit podle čísel nebo bloků (tlačítka Po blocích a Podle čísel v horní části), případně filtrovat vybrané bloky rozevíracím seznamem Bloky: všechny.

Hromadné přiřazení porotců do jednotlivých soutěží importem

Porotce lze do jednotlivých soutěží přiřadit i hromadně importem ze souboru xlsx. U něj je potřeba dodržet tuto strukturu:

Název souboru - libovolně
Název listu Judges
Sloupec se záhlavím label nese unikátní označení jednotlivých porotců
Soutěže jednotlivým porotcům (hodnota 1) přiřazujete v odpovídajících sloupcích se záhlavím #1, kde číslo odpovídá číslu soutěže

Přiřazení porotců do jednotlivých soutěží importujete hromadně takto:

V sekci Porota klepněte na Soutěže >>> Načíst a v dialogovém okně Načtení soutěží porotců zvolte soubor xlsx s připravenými rozřazením porotců do soutěží.
V přehledu se zobrazí přiřazení porotců do jednotlivých soutěží.
V případě chyby při importu je tato indikována červeným tlačítkem vedle tlačítka Načíst, klepnutím na něj zobrazíte další podrobnosti.

Tisk reportů pro porotce

Systém umožňuje pro každého porotce tisk seznamu soutěží, které hodnotí. V případě hodnocení pomocí tabletů potřebuje každý porotce PIN, kterým se přihlašuje k hodnocení na tabletu.

Tisk soutěží pro porotce

V sekci Porota klepněte na Soutěže >>> Tisk a v dialogovém okně Soutěže pro porotce zvolte, jak se má daný report vytisknout:
- Z rozevíracího seznamu Pro koho seznam tisknout vyberte Všichni porotci nebo Jeden porotce.
- Pokud zvolíte tisk pouze pro jednoho porotce, zobrazí se další rozevírací seznam Porotce. Z něj vyberte požadovaného porotce.
- V rozevíracím seznamu Řazení soutěží volíte řazení Podle čísel (soutěží) nebo Podle prezence (chronologicky).
Report vytisknete klepnutím na tlačítko Tisk.

Zobrazení a tisk PINů

V sekci Porota klepněte na Registrace.
PINy zobrazíte zaškrtnutím políčka Ukázat PINy. Tyto jsou neměnné a platí pro celou soutěžní akci.
PINy vytisknete klepnutím na tlačítko Tisk PINů vpravo nahoře

Úprava funkcionářů

V otevřené soutěžní akci přejděte do sekce Funkcionáři. Seznam funkcionářů se stahuje při importu akce, v případě potřeby ovšem lze nové funkcionáře doplnit.

Přidání funkcionáře

V sekci Funkcionáři >>> Registrace zobrazte seznam importovaných funkcionářů.
Vpravo nahoře klepněte na tlačítko Přidat.
V zobrazeném dialogovém okně Registrace nového funkcionáře zadejte jeho Jméno, Příjmení, u zahraničních Stát a u funkcionáře s licencí ČSTS Federace.ID ve tvaru csts.12345678, kde 12345678 představuje jeho IDT.
Funkcionáře uložte klepnutím na tlačítko Uložit.
Nově přidaný funkcionář se zobrazí v seznamu funkcionářů s rolí Sčitatel, další role lze přiřadit hromadným importem funkcionářů (viz níže).

Úprava funkcionáře

V sekci Funkcionáři >>> Registrace vyhledejte požadovaného funkcionáře a označte jej pomocí zaškrtávacího tlačítka.
Po klepnutí na tlačítko Upravit v záhlaví se obrazí dialogové okno Funkcionář se stejnými poli jako v případě přidání nového funkcionáře.
Upravte požadované hodnoty a změny uložte klepnutím na tlačítko Uložit.

Přiřazení rolí funkcionářům

V Sekci Funkcionáři >>> Soutěže přiřaďte jednotlivým soutěžím příslušné funkcionáře. Pro snadnější vyplňování lze seznam soutěží řadit podle čísel nebo bloků (tlačítka Po blocích a Podle čísel v horní části), případně filtrovat vybrané bloky rozevíracím seznamem Bloky: všechny.

Hromadný import porotců/funkcionářů

Porotce/funkcionáře lze do systému přidávat i hromadně importem ze souboru xlsx. U něj je potřeba dodržet tuto strukturu:

Název souboru - libovolně
Název listu Officials
Sloupec se záhlavím label nese unikátní označení jednotlivých porotců (obvykle písmena abecedy). Pokračujte s volnými písmeny (navažte na již obsazené labely u existujících porotců akce) u nově přidávaných porotců, případně lze do xlsx zahrnout již existující porotce a v rámci xlsx jim změnit označení (label). U funkcionářů musí být tento sloupec prázdný.
Sloupec se záhlavím id nese ID příslušné federace, u porotců licencovaných ČSTS zadejte IDT ve tvaru csts.12345678.
Sloupec se záhlavím surname nese příjmení porotce/funkcionáře.
Sloupec se záhlavím name nese jméno porotce/funkcionáře.
Jméno a příjmení porotce lze zadat alternativně v rámci jednoho pole nesoucího jméno a příjmení (záhlaví name_surname) nebo příjmení a jméno (záhlaví surname_name)
Role jednotlivých pracovníků (hodnota 1) specifikujte v odpovídajících sloupcích se záhlavím:
- judge - porotce
- chair - vedoucí soutěže
- inv - odborný dozor
- scrl - hlavní sčitatel
- scr - sčitatel
U funkcionářů lze přiřadit rolí více (dle odpovídající licence funkcionáře).

Porotce/funkcionáře importujete hromadně takto:

V sekci Porota klepněte na Registrace >>> Načíst a v dialogovém okně Načtení porotců a funkcionářů zvolte soubor xlsx s připravenými porotci/funkcionáři.
V seznamu porotců se zobrazí nově importovaní porotci. Současně s porotci se načtou i funkcionáři (lze ověřit v sekci Funkcionáři >>> Registrace).
V případě chyby při importu je tato indikována červeným tlačítkem vedle tlačítka Načíst, klepnutím na něj zobrazíte další podrobnosti.

Úprava nastavení

V sekci Nastavení přiřazujete k dané akci jednotlivé Displeje.

Pomocí zaškrtávacího políčka označte v seznamu displejů požadovaný displej a následně klepněte v záhlaví na tlačítko Připojit.
U daného displeje se ve sloupci Připojení změní stav na Připojeno. Klepnutím na tlačítko Odpojit v záhlaví daný displej odpojíte.
V záhlaví se objeví 6 tlačítek s volbou stavu (změnu reflektuje sloupec Stav)
Akci lze přiřadil libovolný počet displejů.

Prezence

Otevření prezence

Před prezentováním jednotlivých účastníků je nezbytné prezenci otevřít. Postupujte takto:

Spusťte server sart a následně spusťte ve webovém prohlížeči Dans.
V záhlaví přejděte na Soutěžní akce, požadovanou akci označte pomocí zaškrtávacího políčka a v horní části klepněte na tlačítko Otevřít: akce.
V záhlaví klepněte na název akce a poté přejděte do sekce Soutěže >>> Vše.
Tlačítkem Otevřít prezenci vpravo nahoře otevřete prezenci pro všechny soutěže akce, případně otevřete prezenci pouze pro vybrané soutěže klepnutím na stejnojmenné tlačítko u jednotlivých soutěží.

Prezentování nového soutěžícího

K prezenci soutěžících slouží sekce Soutěžící >>> Prezence. Postupujte takto:

Do pole Část jména, startovní číslo nebo ID (dle federace) zadejte některý ze zmíněných parametrů prezentovaného soutěžícího:
- část jména - zadejte alespoň dva znaky. Systém hledá shodu ve všech jménech i příjmeních soutěžících, a to nejen na začátku, ale i uprostřed jmen, nerozlišuje velikost písmen, rozlišuje diakritiku.
- startovní číslo - systém hledá shodu mezi startovními čísly již prezentovaných soutěžících
- ID - zadejte alespoň 4 číslice. Systém hledá shodu s IDT.
Pod vyhledávacím polem se v seznamu Nalezení soutěžící zobrazují shody s vyhledávaným řetězcem. Požadovaného soutěžícího označte klepnutím myší, je-li mezi nalezenými jediná shoda, lze použít k jeho označení šipku dolů na klávesnici.
Po označení požadovaného soutěžícího se pod nalezenými shodami zobrazí jeho detail:
- Jméno - jméno soutěžícího/soutěžících
- (Stát) Klub - klubová příslušnost soutěžícího, u zahraničních účastníků včetně označení státu. Po klepnutí na tlačítko Upravit lze Klub a Stát v oprávněných případech změnit (hostování, chyba při přihlašování u zahraničních účastníků)
- Startovní číslo - pole slouží k zadání startovního čísla, u prezentovaných účastníků je pole zašedlé
- Soutěž - seznam soutěží, do kterých je soutěžící přihlášen
Do pole Startovní číslo zadejte startovní a následně klepněte na Prezentovat do přihlášených soutěží (do všech), případně prezentujte jen do vybraných soutěží tlačítkem Prezentovat na odpovídajícím řádku. U soutěží, v nichž soutěžící nehodlá startovat, klepněte na tlačítko Omluvit. Pokud u soutěže, v níž soutěžící nestartoval, nepoužijete tlačítko Omluvit, dotyčnému nebude možné vytisknout výsledky po ukončení všech jeho soutěží.
Počet prezentovaných soutěží se zobrazuje ve sloupci Soutěže u jednotlivých Nalezených soutěžících vyhovujících vyhledávání.

Prezence pomocí klávesnice

Při prezenci lze mezi jednotlivými poli (vyhledávání, Nalezení soutěžící, Startovní číslo atd.) přecházet klávesou Enter, respektive kombinací Ctrl+Enter v opačném směru.
V rámci pole s více položkami (např. Nalezení soutěžící) vybíráte pomocí šipek nahoru a dolů. V poli Startovní číslo šipkami nahoru a dolů měníte zadané startovní číslo.
V rámci pole s možností volby (Soutěž) měníte pomocí šipek vpravo a vlevo požadovaný stav.
Klávesou Esc přejdete do vyhledávacího pole.
Při vyhledávání soutěžících načtením IDT pomocí čtečky minimalizujete výsledky na jedinou shodu (ve většině případů), odpadá nutnost výběru požadovaného soutěžícího a výrazně se snižuje pravděpodobnost vzniku chyby (shoda jmen).

Úprava soutěžícího

Během prezence, případně i po ní, lze u jednotlivých soutěžících upravovat některé údaje:

Vyhledejte požadovaného soutěžícího a označte jej.
Po klepnutí na tlačítko Upravit můžete v dialogovém okně změnit Klub, Stát, případně Sponzora.
Chcete-li změnit Startovní číslo, zaškrtněte nejprve políčko Přepsat číslo a následně číslo upravte
Změnu registrace u jednotlivých soutěží provedete pomocí tlačítek Prezentovat či Omluvit na odpovídajících řádcích v seznamu soutěží.
Pokud chcete prezentovat soutěžícího do soutěže, do které nebyl přihlášen (např. při zisku vyšší třídy), zaškrtněte v horní části políčko Ostatní otevřené soutěže. V seznamu soutěží se zobrazí všechny soutěže s otevřenou soutěží, vyhledejte požadovanou a proveďte prezenci pomocí tlačítka Prezentovat

Hromadné přihlášení soutěžících importem

Soutěžící je možné přihlásit do jednotlivých soutěží i hromadně pomocí importu ze souboru xlsx. U něj je potřeba dodržet tuto strukturu:

Název souboru - libovolně
Název listu - Competitors
Sloupce s následujícími záhlavími:
- id - id soutěžícího dle federace
- component - pořadí složky v rámci družstva (hodnoty 1, 2, 3...)
- backup - náhradník v rámci družstva/týmu (hodnota 1), plnohodnotný člen bez pořadí (hodnota 0).
- number - soutěžní číslo
- name - název - platné pro družstva/týmy
- p1_id - id jedince nebo 1. člena dvoučlenného soutěžícího (IDT)
- p1_name_surname - jméno a příjmení jedince nebo 1. člena dvoučlenného soutěžícího
- p1_surname_name - příjmení a jméno jedince nebo 1. člena dvoučlenného soutěžícího
- p1_surname - příjmení jedince nebo 1. člena dvoučlenného soutěžícího
- p1_name - jméno jedince nebo 1. člena dvoučlenného soutěžícího
- p2_id - id 2. člena dvoučlenného soutěžícího (IDT)
- p2_name_surname - jméno a příjmení 2. člena dvoučlenného soutěžícího
- p2_surname_name - příjmení a jméno 2. člena dvoučlenného soutěžícího
- p2_surname - příjmení 2. člena dvoučlenného soutěžícího
- p2_name - jméno 2. člena dvoučlenného soutěžícího
- captain - kapitán
- club - klub
- country - stát
- sponsor - sponzor
Sloupce se záhlavími nesoucími čísla jednotlivých soutěží, v nichž hodnotou 1 nastavujete přihlášení daného soutěžícího do dané soutěže. Číslo soutěže lze zadat dvěma způsoby:
- #1 - nevyplněná pole (nepřihlášen) přepisují již nastavená přihlášení (např. z dřívějšího importu), vhodné pro definici soutěžícího v rámci jednoho řádku a jednorázový import.
- &1 - nevyplněná pole (nepřihlášen) nepřepisují již nastavená přihlášení (např. z dřívějšího importu), vhodné pro definici soutěžícího v rámci více řádků, vícekrokový import, doplnění přihlášení u již existujících soutěžících.

U definice jména je nutné zadat pole name_surname nebo surname_name nebo dvojici polí name a surname

Přejděte do sekce Soutěžící >>> Přihlášení.
Vpravo nahoře klepněte na tlačítko Načíst.
Zobrazí se dialogové okno Načtení soutěžících, ve kterém vyberte soubor xlsx s definicemi soutěžících.
Soutěžící načtěte klepnutím na tlačítko Načíst.
V případě chyby při importu je tato indikována červeným tlačítkem vedle tlačítka Načíst, klepnutím na něj zobrazíte další podrobnosti.
Načtení soutěžící se zobrazí v seznamu přihlášených. Vybrané parametry lze upravit přímo v rámci prezence.

Užitečné seznamy a informace

V sekci Soutěžící jsou k dispozici dva seznamy soutěžících:

V sekci Soutěžící >>> Prezentovaní se zobrazují soutěžící, kteří jsou prezentovaní alespoň v jedné soutěži. V tomto seznamu se u nich zobrazují i startovní čísla. Pomocí tlačítka Uložit uložíte seznam prezentovaných do souboru xlsx, který lze následně použít např. při tisku diplomů.
V sekci Soutěžící >>> Přihlášení se zobrazují všichni přihlášení soutěžící včetně klubové příslušnosti a státu. Pomocí tlačítka Uložit uložíte seznam přihlášených do souboru xlsx, který lze následně použít např. při platbě startovného.
V sekci Soutěžící >>> Součty se zobrazuje přehled s počty soutěžících pro všechny možné stavy.

Uzavření prezence a tvorba kol

Data jednotlivých soutěží se zpracovávají v sekci Soutěže. Seznam soutěží lze pro věší přehlednost filtrovat podle stavu (tlačítka Vše, Budoucí, Běžící, Hotové), podle bloků (rozevírací seznam Bloky) a řadit Po blocích nebo Podle čísel.

Klepnutím na řádek soutěže (případně na šipku dolů na pravém konci řádku) se zobrazí další ovládací prvky soutěže (platí pro soutěže běžící a hotové).

Pod názvem soutěže se zobrazuje informace o počtu prezentovaných z počtu přihlášených, stejně jako časový údaj do konce prezence.

Uzavření prezence a vytvoření prvního kola

Prezenci uzavřete klepnutím na tlačítko Uzavřít prezenci. Nejsou-li zatím vytvořena žádná kola, je možné kdykoliv opět odpovídajícím tlačítkem Otevřít prezenci.
Informace o nasazování soutěžících do dalších kol najdete na stránce Různé v části Nasazování soutěžících do dalších kol.
Klepněte na tlačítko První kolo, čímž otevřete dialogové okno se specifikací daného kola. Zde můžete upravovat:
- Postupový klíč - předvyplněn postupový klíč dle odpovídající legislativy. Je-li zapotřebí jej změnit, upravte jej v tomto poli (jednotlivá kola oddělujte pomlčkou), původní nastavení vrátíte tlačítkem Obnovit. Po zaškrtnutí políčka Upravit detaily kola se zobrazí další volby, kterými změníte Typ kola (Vyřazovací nebo Finále), odpovídající Jméno kola (mění se automaticky podle klíče a typu kola), případně Počet postupujících.
- Určit tance a jejich rozlosování - v rozevíracím seznamu Počet skupin v tancích lze kromě výchozí volby Všechny tance stejně zvolit pro speciální případy (upravené formáty finálových kol vrcholových soutěží) odlišný počet skupin pro jednotlivé tance (Každý tanec jinak). V poli Tance upravujete volbu tanců a jejich pořadí. V případě odlišného počtu skupin pro jednotlivé tance použijte rozevírací seznam Skupiny pro , kde postupně vybíráte jednotlivé tance a jim následně specifikujete Počet skupin (a Rozlosování).
  - Počet skupin - udává počet skupin v daném kole. Výchozí hodnota je 1, je-li zadána Velikost skupiny v Definici soutěže, použije se k výpočtu tato hodnota.
  - Ve skupině - maximální počet soutěžících ve skupině. Výchozí hodnota je celkový počet, je-li zadána Velikost skupiny v Definici soutěže, použije se k výpočtu tato hodnota.
  - Pole Počet skupin a Ve skupině se vzájemně ovlivňují (změnou jednoho pole se přepočítá druhé).
  - Rozlosování - volba losování párů do skupin pro jednotlivé tance
- Upravit porotce - zaškrtnutím tohoto políčka se zpřístupní tlačítko Porotci. Klepnutím na něj můžete upravit složení poroty pro dané kolo. Pokud změny neprovedete, systém použije stejné složení poroty jako v předchozím kole.
- Hodnocení - dle Typu kola se volí způsob hodnocení
Po zadání potřebných parametrů kola jej vytvoříte klepnutím na tlačítko Vytvořit.
V rozbalením řádku soutěže se objeví první kolo s odpovídajícími tiskovými reporty. Pokud ho nevidíte, klepněte v levé části pod číslem soutěže na ikonu s posuvníky.
Je-li potřeba upravit parametry kola (změna klíče, porotce, doplnění páru), klepněte na tlačítko Zrušit kolo (v pravé části) a po specifikování důvodu jej znovu vytvořte.

Vytvoření dalšího kola

Jakmile jsou zadány veškeré známky v daném kole, zobrazí se u dané soutěže vedle tlačítka Hodnocení tlačítko Výsledky a postup (v předkolech). Klepněte na něj.
V dialogovém okně se zobrazenými výsledky kola je modrou linkou označen poslední postupující soutěžící do dalšího kola (v souladu s hodnocením a postupovým klíčem). Klepnutím na jiného soutěžícího lze případně počet postupujících upravit.
Klepněte na tlačítko Urči postup.
Klepněte na tlačítko Další kolo a v zobrazeném dialogovém okně upravte parametry daného kola obdobně jako v kole prvním.

Zadávání hodnocení

Bez ohledu na způsob hodnocení (lístky, tablety) je zapotřebí nejprve pro danou soutěž Povolit hodnocení. Tlačítko se změní na Hodnocení.

Ruční zadávání hodnocení

Klepněte na Hodnocení, čímž zobrazíte dialogové okno s hodnocením kola.
Vlevo se zobrazuje seznam jednotlivých tanců a porotců (včetně informace o stavu zadání), vpravo pak hodnocení pro daný tanec u vybraného porotce.
Pole pro zadávání hodnocení má stejnou podobu jako na lístcích. Ručně zadejte hodnocení daného porotce a zadání potvrďte klávesou Enter. Prostředí automaticky přechází na následujícího porotce/tanec. K zadání použijte tyto klávesy:
- Předkola
  - 0 - bez kříže
  - 1 nebo x nebo , nebo . - kříž
  - 2 nebo šipka vlevo - posun vlevo
  - 3 nebo šipka vpravo - posun vpravo
  - 4 nebo d - návrh na vyloučení
  - 5 nebo w - napomenutí (bez kříže)
  - 6 - napomenutí s křížem
  - c - odstranění napomenutí/návrhu na vyloučení
- Finále
  - čísla pro jednotlivá umístění (nejvýše 9)
  - d - návrh na vyloučení
  - w - napomenutí
  - c - odstranění napomenutí/návrhu na vyloučení
Po zadání hodnocení posledního porotce u posledního tance klepněte na Spočítat a zavřít.
Klepnutím na tlačítko Výsledky a postup (ve finále Uzavřít kolo) dané kolo uzavřete.

Hodnocení s tablety

V levé části klepněte pod číslem soutěže na tlačítko s piktogramem kompasu, čímž zobrazíte přehled porotců dané soutěže a stav jejich přihlášení.
Klepnutím na tlačítko Povolit Hodnocení zpřístupníte hodnocení dané soutěže porotcům. Ti po přihlášení v tabletu zvolí dané kolo (obvykle jediné dostupné) a přecházejí k hodnocení prvního tance.
O stavu přihlašování a aktuálně zobrazeném tanci informuje přehled porotců (kontrola, zda jsou všichni porotci připraveni hodnotit).
Po ohodnocení posledního tance porotci na tabletech potvrzují odeslání hodnocení. Jakmile všichni hodnocení odešlou, vedle tlačítka Hodnocení se objeví tlačítko Výsledky a postup (ve finále Uzavřít kolo), kterým dané kolo uzavřete.

Je-li zapotřebí upravit hodnocení z tabletů (např. nedopatřením zadané napomenutí), po skončení kola klepněte na Hodnocení, v dialogovém okně zaškrtněte vlevo dole Přepsat hodnocení z tabletů, vyhledejte požadované hodnocení, ručně upravte a potvrďte klepnutím na tlačítko Spočítat a zavřít.

Porušení pravidel

V případě, že dojde ze strany soutěžících k porušení pravidel (obvykle porušení předepsaného repertoáru) a porotce tuto skutečnost zaznamená do hodnocení, objeví se vedle tlačítka Hodnocení tlačítko Porušení pravidel:

Po klepnutí na tlačítko Porušení pravidel se zobrazí stejnojmenné dialogové okno se seznamem všech soutěžících, kteří se v daném kole provinili vůči pravidlům.
U každého soutěžícího se pro jednotlivé tance zobrazují ve sloupcích s labely porotců, kteří porušení pravidel zaznamenali, znaky n (napomenutí) nebo v (návrh na vyloučení).
Tlačítko Porušení pravidel funguje identicky i při ručním zadávání hodnocení (stačí zavřít dialogové okno Hodnocení).

Uzavření soutěže a výsledky

Uzavření soutěže a odeslání výsledků

Jakmile jsou zadány veškeré známky ve finále, zobrazí se u dané soutěže vedle tlačítka Hodnocení tlačítko Uzavřít kolo. Klepněte na něj.
Klepnutím na tlačítko Uzavřít soutěž ji uzavřete. Soutěže mění stav na Hotová. Při uzavření soutěže se automaticky vytvoří záloha celé soutěžní akce (více viz Konfigurace část Důležité adresáře).
Tlačítkem Otevřít soutěž vrátíte do stavu Běžící.
V pravé části se zobrazí tlačítko Odeslat do ČSTS. Klepnutím na něj odešlete výsledky do IS, jakmile jsou doručeny, tlačítko se změní na Odstranit z ČSTS. Klepnutím na něj výsledky z IS smažete. Před vlastním odesláním výsledků se vytvoří v dočasném adresáři soubor s výsledky (JSON), který lze použít k doručení výsledků dané soutěže v případě, že výsledky odeslat nelze (více viz Konfigurace část Důležité adresáře).

Tisk výsledků pro soutěžící

Přejděte do sekce Soutěžící >>> Výsledky, kde najdete seznam soutěžících, kteří absolvovali všechny své prezentované soutěže. Sloupec stav informuje o tisku výsledků pro daného soutěžícího.
Vpravo nahoře klepněte na tlačítko Tisknout nevytištěné a vytiskněte výsledky pro nově ukončené soutěžící. Tlačítko se zobrazuje pouze v případě, jsou-li nějaké výsledky k dispozici.
Alternativně (dotisk) lze pomocí zaškrtávacích políček vybrat jednotlivé soutěžící a tlačítkem Tisknout vybrané vytisknout výsledky pro daný výběr.

Různé

Nasazování soutěžících do dalších kol

U soutěží lze nasazovat vybrané soutěžící do dalších kol. Tuto akci je třeba provést před vytvořením prvního kola:

Před vytvořením prvního kola klepněte v seznamu soutěží u vybrané soutěže na tlačítko Soutěžní listina.
Pomocí zaškrtávacích políček označte soutěžící (lze i hromadně), kteří mají být nasazeni do dalšího kola.
V poli Nasazen do kola zvolte požadované kolo a volbu potvrďte klepnutím na tlačítko Nasadit.
U nasazených soutěžících se ve sloupci S objeví číslo kola, do kterého jsou nasazeni.
Při uzavírání prvního kola se v dialogovém okně s jeho parametry zobrazí postupový klíč, jehož začátek má tvar A-B/C*D, kde:
- A - udává počet účastníků prvního kola (všichni prezentovaní včetně nasazených)
- B - udává celkový počet účastníků druhého kola (tvořen C a D)
- C - udává počet účastníků druhého kola postupující z kola prvního
- D - udává počet účastníků druhého kola, kteří jsou do něj nasazení přímo
- Informace o počtu účastníků se zobrazuje i na řádku Typ kola

Odstoupení soutěžících, diskvalifikace

Před uzavřením kola, v němž došlo k odstoupení nebo diskvalifikaci soutěžícího, klepněte na tlačítko Startovní listina.
Pomocí zaškrtávacího políčka označte soutěžícího, který odstoupil nebo byl diskvalifikován.
Z rozevíracího seznamu Soutěžní stav vyberte odpovídající stav (Odstoupil nebo Diskvalifikovaný).
Změna stavu se zobrazí ve stejnojmenném sloupci startovní listiny daného kola.
Stav je možné změnit i v seznamu s výsledky kola (tlačítko Výsledky a postup po ukončení hodnocení kola) nebo v soutěžní listině soutěže (tlačítko Soutěžní listina v řádku dané soutěže).

Dokumentace Dans — promítání

Nastavení a ovládání promítání

V průběhu soutěžní akce je možné promítat relevantní reporty na displeje (televize, velkoplošná LED tabule apod.). Promítání na displejích je pasivní, ovládá se z rozhraní pro zpracování soutěže samostatně pro každý nastavený typ displeje.

Nastavení promítání

Vlastnímu promítání předchází jeho nastavení a povolení v rámci příslušné soutěžní akce.

Vytvořte požadované displeje, více viz Konfigurace část Globální nastavení >>> Výstupy >>> Displeje.
Jednotlivým displejům přiřaďte odpovídající fronty s reporty, více viz Konfigurace část Globální nastavení >>> Fronty >>> Vytvoření a nastavení nové fronty
V aktuální soutěžní akci klepněte na Nastavení, pomocí zaškrtávacích políček označte displej, který chcete v rámci akce používat, a následně jej aktivujte klepnutím na tlačítko Připojit. Připojení displeje k akci indikuje stejnojmenný sloupec.
K akci připojte případné další displeje, připojené displeje odpojíte po označení zaškrtávacím políčkem a klepnutím na tlačítko Odpojit.
U označeného displeje se v záhlaví zobrazují dostupné stavy, aktivní se zobrazuje v přehledu displejů ve sloupci Stav.
U označeného displeje se po klepnutí na tlačítko Upravit v záhlaví zobrazí stejné dialogové okno jako při vytváření nového displeje. Zde lze upravit jeho nastavení, zejména Uspořádání.
K jednotlivým displejům přistupujete z webového prohlížeče přes adresu:
http://192.168.x.y/display/URLsegment
kde URLsegment odpovídá stejnojmennému poli v nastavení příslušného displeje
U displeje, který má nastavených více ploch, lze přistupovat i k jednotlivým plochám, použijte adresu: http://192.168.x.y/display/URLsegment?slots=2,3
kde slots=2,3 udává druhou a třetí plochu daného displeje (s nastavenými třemi nebo více plochami)

Nastavené displeje jsou dostupné pouze u akce, jejíž datum odpovídá aktuálnímu +- jeden den, tedy den před akcí, v den akce a den po akci.

Ovládání promítání

Pro jednotlivé typy displejů lze použít libovolný počet fyzických zobrazovacích jednotek, na všech se bude promítat identický obsah. Takto lze např. rozlosování do skupin promítat na několika televizích na různých místech.

Ovládání displeje je dostupné u každé soutěže. Rozbalte soutěž (klepnutím na její řádek v přehledu soutěží nebo na šipku dolů u pravého okraje).
V levé části klepněte na tlačítko s piktogramem obdélníku se dvěma čtvrtkruhy, zobrazí se připojené displeje pro aktuální soutěžní akci.
Na řádku každého displeje se v prostřední části zobrazují dostupné reporty (pouze relevantní pro aktuální stav soutěže). Klepnutím se stane report aktivní a zobrazí se na příslušném displeji. Pokud na displej míří více reportů, v pravidelném časovém intervalu cyklují na obrazovce.
Rozbalte displej (klepnutím na jeho řádek v přehledu displejů soutěže nebo na šipku dolů u pravého okraje) a zobrazí se detailní nastavení promítaných reportů. Označte požadovaný report pomocí zaškrtávacího políčka, čímž pro něj zpřístupníte ovládání detailů daného reportu.
V pravé části řádku s displejem se zobrazují tlačítka ke změně stavu displeje. Stejnou funkci mají tlačítka nad seznamem displejů v Nastavení soutěže po označení daného displeje. Ovládají displej jako celek, jsou nadřazena aktivním reportům jednotlivých soutěží. Zleva se jedná o:
- Promítá - na displeji se cyklicky promítají aktivní reporty všech soutěží
- Zmraženo - při aktivaci zůstane na displeji aktuální zobrazení, vhodné k detailní přípravě dalšího reportu
- Pozadí - zobrazuje se nastavení pozadí, více viz Pozadí
- Přestávka - zobrazuje se nastavená grafika pro přestávku, více viz Pozadí
- Klíč - zobrazuje se klíčovací pozadí (přednastavená zelená)
- Info - zobrazuje se seznam soutěžních akcích aktuálně dostupných pro promítání

Pozadí promítání

Popisované nastavení promítání reflektuje aktuální vývojový stav, který se postupně bude upravovat ve prospěch lepší ergonomie používání.

Adresáře a soubory pro promítání

Promítání spojuje údaje ze tří míst:

Data: soutěžní data doplněná programem běžícím v prohlížeči (více viz rozhraní pro displeje). Tato data odpovídají zvolenému reportu a nelze je měnit.
Stránka: promítaná stránka, soubor ve formátu HTML předlohy, s možností volit barvy, druh pozadí, apod.
Soubory: obrázky a jiné soubory použité uvnitř stránky podle předešlého bodu.

Stránky

Soubory se stránkami pro jednotlivé displeje se jmenují stejně jako URL segment v nastavení displeje. Zvolíte-li např. za URL segment televize, pojmenujte stránku televize.html.
Všechny stránky pro všechny použité displeje uložte do stejného adresáře.
Při spuštění sart použijte parametr --templates "<adresář>\*.html".

Pro uvedený příklad displeje televize, pokud soubor televize.html uložíte do adresáře C:\promitani\predlohy, spusťte sart následovně (případně i s dalšími parametry):

sart --templates "C:\promitani\predlohy\*.html"

Soubory se stránkami využívají mechanismus předloh, který v aktuální verzi není nijak dále využitý. Formát HTML souborů se stránkami je proto doplněný o značky {% ... %} předlohového mechanismu. Pro správnou funkci promítání je nutné tyto značky a řádky zachovat.

⚠️ Upozornění

sart načítá předlohy jen jedenkrát při svém spuštění. Pokud změníte předlohu, například jména obrázků, nebo barvu textu, musíte sart restartrovat.

Prázdná předloha

Příklad předlohy stránky bez pozadí s linkami pod rozlosováním skupin soutěžících (typicky pro televizi):

{% extends "base.html" %}
{% block headcss %}
<style>
    :root {
        --text: #242424; /* barva textu #rrggbb */
        --highlight: #cf57ff; /* barva zvýrazněného textu #rrggbb */
        --dimmed-background: #eee;
        --dimmed-content: #eee;
    }

    .report-heats-by-competitors .filling-row {
        box-shadow: 0 0 0 0.5px #00000040;
    }
</style>
{% endblock headcss %}
{% block headscript %}{% endblock headscript %}
{% block content %}{% endblock content %}

Předloha s pozadím

Příklad předlohy stránky s pozadím a světlým textem na tmavém pozadí (typicky pro pódiovou velkoplošnou obrazovku):

{% extends "base.html" %}
{% block headcss %}
<style>
    :root {
        --text: #F0F0F0; /* barva textu #rrggbb */
        --highlight: #cf57ff; /* barva zvýrazněného textu #rrggbb */
        --dimmed-background: #00000068; /* ztmavení pozadí stránky #000000αα, α je opacita-překryvnost 0–ff */
        --dimmed-content: #000000e6; /* ztmavení pozadí obsahu #000000αα, α je opacita-překryvnost 0–ff */
    }

    .background-box {
        /* obrázek pozadí při promítání obsahu */
        background-image: url("/background.jpg");
    }

    .break-background {
        /* obrázek pozadí při přerušení */
        background-image: url("/break-background.jpg");
    }
</style>
{% endblock headcss %}
{% block headscript %}{% endblock headscript %}
{% block content %}{% endblock content %}

Soubory

Soubory použité uvnitř stránek poskytuje sart z adresáře určeného parametrem --assets "<adresář>", např. --assets "C:\promitani". Pro uvedený příklad předlohy s pozadím uložte soubory background.jpg a break-background.jpg do adresáře C:\promitani a spusťte sart následovně:

sart --assets "C:\promitani" --templates "C:\promitani\predlohy\*.html"

Pro ověření správného nastavení vložte do prohlížeče odkaz http://127.0.0.1/background.jpg a ověřte, že se zobrazí správný obrázek uložený v adresáři.

Při změně obsahu souborů s obrázky nemusíte sart restartovat.

Načítání souborů

Soubory je možné uložit do adresáře assets, který je podadresářem adresáře se serverem sart.exe. Při jejich načítání se postupuje v tomto pořadí:

Jako první se bere --assets <XXX>, tedy adresář XXX explicitně nastavený příslušným parametrem při spuštění serveru sart.
Pokud se soubor nenajde, bere se adresář assets (podadresář pracovního adresáře serveru sart).
Pokud se ani tam soubor nenajde, použije se výchozí nastavení přímo z programu.

Příklady

Obsah adresářů

Stránky a soubory použité v příkladech tohoto dokumentu včetně adresářové struktury, s doplněnou stránkou led pro velkoplošnou obrazovku:

c:\promitani\background.jpg
c:\promitani\break-background.jpg
c:\promitani\predlohy\televize.html
c:\promitani\predlohy\led.html

Formátování pozadí

Kompletní technické detaily: CSS background na stránkách MDN.

Jen barva pozadí

    .background-box {
        background-color: blue; /* nebo místo blue #rrggbb */
    }

Obrázek s přizpůsobenou velikostí

    .background-box {
        background-image: url("/background.jpg");
        background-size: cover; /* nebo contain */
    }

Obrázek s umístěním jiným než levý horní roh

    .background-box {
        background-image: url("/background.jpg");
        background-position: center; /* nebo right top bottom */
    }

Obrázek opakující se jen jedenkrát

    .background-box {
        background-image: url("/background.jpg");
        background-repeat: no-repeat;
    }

Obrázek ve středu přizpůsobený velikosti stránky bez opakování

    .background-box {
        background-image: url("/background.jpg");
        background-size: cover;
        background-position: center;
        background-repeat: no-repeat;
    }

Doplňky

Doplňkové texty

Tablety — zařízení a spojení

Dans dovoluje vkládat hodnocení porotců pomocí tabletů. Pro hodnocení je určená aplikace dostupná na adrese http://<ip-sart.exe>/device.

Hodnocení na tabletech je v Dans možnost rovnocenná s ručním zapisováním hodnocení na lístky.

O tabletech

Pro hodnocení se typicky používají malá zařízení, buď telefony, nebo malé tablety. Oba druhy zařízení nejsou primárně určeny pro dlouhodobé nepřetržité použití, jaké je při soutěžních akcích běžné.

Problematické jsou zejména dvě oblasti:

snaha výrobců zařízení šetřit co nejvíce energie versus potřeba zajistit při sčítání stabilní a robustní spojení,
snaha výrobců poskytnout uživateli co nejvyšší zabezpečení versus potřeba zajistit předvídatelné a opakovatelné chování při práci i spojení.

Šetření energií

Příklady šetření energií, které nepříznivě ovlivňují spojení:

zařízení degradují webový prohlížeč, např. vypínají časovače, či uzavírají spojení,
zařízení se snaží zhasínat obrazovku, načež okamžitě pozastavují všechny aplikace,
zařízení se odpojují od přípojného bodu WiFi, spojení se po té musí obnovovat.

Tablety udržují spojení aktivním aplikacím při rozsvícené obrazovce. Této skutečnosti využívají všechny metody, které se snaží zajistit trvalé spojení.

Bezpečnostní opatření

Operační systémy na tabletech (většinově Android a iOS) implementují řadu chování, která zpomalují přístup ke spojení a která do konfigurace sítě a komunikace vnášejí náhodné a nestabilní chování.

Typické případy:

WiFi bez zabezepeční (bez hesla) se používá až jako druhé v řadě, případně se vůbec na zařízeních nezapamatuje,
zařízení permutují své hardwarové adresy a nutí tak při navázání WiFi spojení přístupový bod ke složitějšímu postupu připojení nového zařízení,
zařízení před spojením prohledávájí databáze důvěryhodných WiFi sítí,
zařízení se automaticky aktualizují,
zařízení automaticky provádějí různé bezpečnostní skeny.

Většinu popsaných případů je možné zcela nebo alespoň částečně potlačit. V jednotlivých verzích operačních systémů se možnosti i umístění nastavení bohužel značně liší a nelze proto pro nastavení poskytnout všeobecný přehled.

Počty a souvislosti usínání a navazováním spojení

první připojení k zapamatové síti po zapnutí/restartu zařízení trvá typicky 15 s, doba se prodlužuje s rostoucím rušením (v přítomnosti cizích sítí)
80 % připojení je hotovo do 5 s
3 % připojení trvá více jak 15 s

Při přepočtu na typické počty tabletů vychází, že usne-li mezi koly osm tabletů, jednomu až dvěma trvá obnova spojení po probuzení více jak 5 sekund a jeden z nich občas hledá spojení více jak 10 sekund. Pokud je na běžné soutěži 50 kol s prodlevami, potíže se spojením v důsledku usínání jsou časté, pravidelné a nevyhnutelné.

Potíže se spojením nejsou na první pohled vidět, protože po probuzení zařízení se displej rozsvítí okamžitě, zatímco spojení se uzavře teprve po sekundách. Pozorování uživatele v takovém případě je, že aplikace "nefunguje", nebo že se "chová pokaždé jinak".

Co v zařízeních nastavit

Následující přehled obsahuje typické a hlavní body. V každém zařízení je patrně spousta dalších nastavení, která je vhodné učinit. Obecné doporučení je:

vypínat mechanismy nesouvisející se sčítáním,
vypínat šetření energií,
odstraňovat a vypínat nastavení, která brání uživateli dostat se do zařízení,
vypínat automatické kontroly různých druhů,
odstraňovat bariéry a mechanismy bránící rychlému připojení k WiFi.

Aplikace

Doporučuje se:

Odinstalovat všechny aplikace kromě Google Play, klávesnice, prohlížeče, nebo kiosku a WebView.
Zakázat/deaktivovat všechny ostatní aplikace, které není možné odinstalovat.
Vypnout automatické aktualizace aplikací.
Vypnout kontrolu zabezpečení/antivirovou kontrolu zařízení a aplikací.
Vypnout automatické aktualizace systému.
Pro aplikace, které slouží ke sčítání (buď prohlížeč, nebo kiosek), nastavit oprávnění neomezeného přenosu dat.

Zabezpečení a ovládání

Doporučuje se:

Vypnout zámek obrazovky (v některých verzích možné jedině v nastavení vývojářů).
Vypnout zhasínání displeje (toto patrně nebude možné).
Nastavit co nejdelší čas před usnutím zařízení.

Spojení a WiFi

Doporučuje se:

Nastavit vyhledávání sítí, avšak vypnout vyhledávání doporučených sítí (databáze výrobců).
Nastavit automatické obnovení WiFi spojení.
Vypnout automatické vypínání WiFi spojení.
Omezit seznam známých zapamatovaných sítí (SSID) jen na sítě, které slouží ke sčítání.
V nastavení každé zapamatované sítě nastavit automatické připojení k této síti.
V nastavení každé zapamatované sítě vypnout náhodné MAC adresy, ponechat MAC adresu zažízení.
V nastavení každé zapamatované sítě nastavit neomezený přenos dat.

Tablety pro porotce — software

Jak je popsáno v Tablety — zařízení a spojení, nepřetržitý běh tabletů při zadávání hodnocení neodpovídá záměru vydržet s energií co nejdéle.

Rovněž, snaha výrobců tabletů je dovolit uživateli co nejvíce možností a svobody ve využívání, jak různých funkcí, tak různých aplikací.

Pro sčítání soutěží je třeba oba záměry co nejvíce potlačit. Tablety potřebují udržovat co nejstabilnější spojení (což je v rozporu se šetřením energií) a nesmějí uživatele=porotce pustit k žádné jiné činnosti, než je hodnocení (což je v rozporu se svobodou použití).

Kiosek

Oba požadavky trvalého spojení i jednoúčelovosti nabízejí aplikace, které dovolují zamknout uživatele do omezeného množství funkčnosti tabletu, známé pod názvem kiosek (kiosk).

Název vychází z názvu informačního kiosku, což je dotykový displej s předem daným jedním způsobem využití.
Informační kiosek je například displej s tlačítky se seznamem odjezdů a řazení vlaků na nástupištích.

K čemu je kiosek pro sčítání

Kiosek pro účely sčítání zajistí tři věci:

Uzamkne porotce do sčítací aplikace a nedovolí mu žádné jiné ovládání tabletu. Toto uzamčení vyloučí náhodná selhání jako je opouštění aplikace, přechod na web, násobné spuštění sčítání, a podobně.
- Porotce v kiosku nemůže při ovládání způsobit náhodnou chybu.
Udrží obrazovku stále aktivní a zamezí tak automatickému zamykání a následnému odemykání.
- Porotce v kiosku vždy vidí jen svou aplikaci a není nucen dělat nesouvisející operace.
Udrží trvalé spojení tabletu a serveru Dans. Dans je odolný proti výpadkům spojení ve smyslu ztráty dat, Dans sám nicméně nedokáže tabletu zabránit spojení ukončovat. Během hodnocení jsou výpadky skryté, porotce nic nepozná, ostatní operace (přihlašování, nabídka kol, řízení z Dansu směrem do tabletů) jsou však na spojení závislé a jakýkoli výpadek způsobuje zdržení soutěže, vyžaduje případný zásah sčitatele a obecně vede k dočasně nepředvídatelnému chování tabletu (nelze poznat, v jaké fázi spojení tablet zrovna je).
- Použití kiosku zajistí trvalé a stabilní spojení tabletu a Dans.

Celkově platí, že smysl práce sčitatele je převést hodnocení poroty do výsledků, což v případě použití tabletů znamená i zajištění co nejhladší práce porotce na tabletech. Použití kiosku znamená, že sčitatel dělá svou práci, vynechání kiosku znamená, že sčitatel svou práci nedělá (a že by mohlo být lépe použít lístky).

Dans a kiosek

Podpora a funkce

Dans je vyzkoušený ve dvou kioscích, se kterými plně spolupracuje. Plná spolupráce znamená:

tablety udržují trvalé spojení, jednak díky kiosku a jednak díky trvalému svitu obrazovky,
nedochází ke zhasnutí obrazovky, kdy Dans po 2×40 sekundách nastaví jas obrazovky na 1, což tablet stále považuje za rozsvícenou a aktivní obrazovku,
Dans získává z tabletů informace o stavu baterie a síle WiFi signálu.

Vyzkoušené a podporované kiosky jsou:

Kiosk Browser, zelený,
Fully Kiosk, ve verzi PLUS.

Použití Dans s kioskem a bez

Oba podporované kiosky jsou placené, jednorázově i na bázi předplatného (s centrální správou).

Fully Kiosk lze s omezenou funkčností instalovat bezplatně, přičemž tato omezená funkčnost je pro uzamknutí porotce a udržování spojení téměř dostatečná.

Pro použití Dans proto platí následující pravidla:

Je doporučeno použít placenou verzi kiosků, která zaručí maximální funkčnost Dans z pohledu kvality použití.
Pro soutěže ČSTS a WDSF je přikázáno použít alespoň bezplatnou verzi kiosku.

Software tabletu pro práci v kiosku i bez něj

Základní informace jsou tyto:

Mimo kiosek sčítání pro Dans vyžaduje v tabletu prohlížeč, vyzkoušený je Chrome for Android v aktuální verzi (nyní 121), pracovat by měl od verze 105 (není ovšem důvod neaktualizovat).
Uvnitř kiosku obě kioskové aplikace používají Android System WebView. Podle zkušeností je tato komponenta v tabletech většinou neaktuální a je třeba ji aktualizovat či nainstalovat.
- Je-li komponenta WebView neaktuální, kiosek se s /device spustí, avšak obrazovka je zcela bílá.
- (Sada tabletů pořízená ČSTS před dvěma lety (fialové Huawei Y6p) jsou omezené embargem USA a Android System WebView na nich neběží. Vyzkoušené a funkční v kiosku Fully Kiosk je použití analogického Huawei WebView ve verzi 14.)

Displeje a promítání

Předběžná verze: MČR STT/LAT 2024

Záznam ze schůzky cílené na promítání na MČR LAT 2024
Funkce a způsob ovládání popsaný ve videu jsou předběžné. Ovládání, chování i možnosti celkově se můžou značně měnit a vyvíjet.

Stažení programů Dans

sart-csts-0.5.8-beta

Změny ve verzích

Known issues — známé chyby a nedostatky

postupně přibývá: hlášení chyb, signalizace probíhajících operací, lokalizace
při zmenšení počtu postupujících se pro další kolo nabídne redance se špatnými čísly, ručně se to musí předělat
průběžná aktualizace soutěžících (Připojit) se může srazit s prezencí (nebo přidělováním čísla), kdy se "soutěžící nezaprezentuje", stačí akci zopakovat
výpočet získaných bodů nefunguje spolehlivě:
- mezi akcemi jednoho přihlašovacího období (jednoho víkendu) se body do následných akcí náhodně z ČSTS nepřenesou, jak mezi různými instalacemi Dans, tak i na počítači jednoho sčitatele
- platí, že pokud se zisk třídy vypočítá, tak je to správně, a že pokud se zisk nové třídy nevypočítá, tak to nemusí být správně
Rozšířit: (připojení jedné akce ke druhé) nefunguje dohromady s Připojit akce, při aktualizaci dat se odstraní soutěžící z připojených soutěží

🆕 2025-10-27 0.5.10-beta

New

v seznamu porotců v běžícím kole se ukazují všechny jeho přihlášené tablety
- dosud měl každý porotce jediný řádek, takže pokud byl porotce přihlášený víckrát, tak se pro něj ukazovala zmatečná informace
- nyní má každý přihlášený tablet svůj samostatný řádek, takže jeden porotce může být v seznamu víckrát
  - v takovém případě je zabarvený červeně
  - násobný řádek se ztratí, pokud se porotce odhlásí
- výběr porotce vybere porotce jen pro jeden tablet, takže operace s tabletem (nastavit tanec...) je vizuálně jednoznačná

Changes

v promítání finálové listiny se změnilo pořadí, nejdřív je klub, pak sponzor
rozlosování skupin složených soutěžících má v hlavičce soutěžícího nově i soutěž
rozlosování skupin složených soutěžících při jedné skupině se tiskně bez řádku se složkami, tisknou se jen série, tance a číslo složky, při jedné skupině stačí kapitánům jen pořadí složek a tanců, skupiny byly matoucí (a taky to šteří papír)

Keyboard shortcuts

DanceSport Services System