RaceResult integrácia

  • Na tejto stránke sa udalosť v Trakster prepojí s udalosťou v RaceResult a spravuje sa toto prepojenie
  • Karta je dostupná len ak je v nastaveniach udalosti zapnuté RaceResult API
  • Stránka má tri časti:
    • RaceResult Integration - API kľúč a API prepojenie udalosti
    • Actions - každodenné akcie, zobrazia sa až po úspešnom nastavení
    • Setup - prihlásenie do RaceResult a nastavenie prepojenia

Nastavenie prepojenia

  • Celé nastavenie je jedno prihlásenie do RaceResult a výber udalosti - nie je potrebná žiadna iná aplikácia
  1. Skontrolujte RaceResult server - predvolene events.raceresult.com
  2. Zadajte prihlasovacie údaje - buď používateľské meno a heslo, alebo API key (prepínačom si vyberiete ktoré)
  3. Skontrolujte pole so štartovými časmi - predvolene t0
  4. Vyplňte pole s kategóriou, ak udalosť kategórie používa - inak nechajte prázdne
  5. Kliknite na Sign in and choose event
  6. Zo zoznamu nadchádzajúcich udalostí vyberte tú správnu a kliknite Run setup
  • Aplikácia sa prihlási druhýkrát a v udalosti v RaceResult:
    • vytvorí pole TraksterId s hodnotou [Event.ID] & "-" & [ID]
    • vytvorí tri webhooky - nový účastník, zmena účastníka a cieľ
    • vytvorí dva Simple API linky - api a trakster_participants
    • prečíta a uloží odkaz simpleapi/get
    • hneď sa odhlási

Important

Prihlasovacie údaje do RaceResult sa nikam neukladajú. Použijú sa len na tieto dve prihlásenia a po dokončení sa z formulára vymažú - pri opakovanom nastavení ich bude potrebné zadať znova

Note

V zozname sú len nadchádzajúce udalosti. Nastavenie vytvára webhooky pre pretek, ktorý sa ešte len bude sledovať - už odbehnutá udalosť nemá čo posielať

Note

Všetko ostatné v RaceResult udalosti zostáva nedotknuté - API linky iných aplikácií aj webhooky iných nástrojov. API Creator už pre Trakster nie je potrebný, ale naďalej slúži na vytvorenie API pre ostatné aplikácie - a je jedno, či ho spustíte pred alebo po nastavení Trakster

Štartové časy

  • Pole Start times field určuje, v ktorom poli má táto udalosť v RaceResult uložené štartové časy
  • Väčšine udalostí stačí predvolené t0 a netreba ho meniť
  • Prepíšte ho, ak táto udalosť štartuje súťaže z iného poľa
  • Vymazaním poľa sa vráti predvolená hodnota t0

Important

Ak používate Splits/Medzičasy je potrebné použiť [názov splitu].ToD.Decimal, ak používate Special results/Špeciálne výsledky stačí použiť T[číslo]. Dôležité je aby Trakster načítal čas v sekundách

Important

Pole sa použije až spustením nastavenia - tvorí sa z neho Simple API link trakster_participants. Ak ho zmeníte na už nastavenej udalosti, je potrebné spustiť nastavenie znova

Kategórie

  • Pole Category field určuje, z ktorého poľa v RaceResult sa načíta kategória účastníka - súťaž, veková skupina alebo čokoľvek, podľa čoho udalosť rozdeľuje pole
  • Napríklad contest.name alebo agegroup1
  • Nastavuje sa pre každú udalosť zvlášť - tá istá časomiera robí preteky, ktoré rozdeľujú pole podľa rôznych vecí
  • Ak pole necháte prázdne, udalosť kategórie nemá:
    • do Simple API linku sa nič nepridá
    • nič sa neimportuje
    • mapa aj záznamy zobrazia jeden plochý zoznam, presne ako doteraz

Important

Pole sa - rovnako ako štartové časy - použije až spustením nastavenia. Po jeho zmene je potrebné spustiť nastavenie znova a potom raz importovať účastníkov

Note

Spustenie nastavenia s vyplneným poľom zapne aj prepínač Použiť kategórie v nastaveniach udalosti - vyplniť pole znamená povedať, že udalosť kategórie má. Vypnúť ich je potom možné tam

Note

Kategória je posledný stĺpec v Simple API linku. Udalosť nastavená pred touto zmenou teda funguje ďalej - len kategórie neposiela, a Trakster neprepíše to, čo je už uložené

Opakované nastavenie

  • Tlačidlo Re-run setup spustí nastavenie znova - rovnaké prihlásenie a výber udalosti
  • Nastavenie najprv porovná, čo v udalosti už je:
    • čo chýba, sa vytvorí
    • čo je nastavené inak, sa opraví
    • čo je správne, sa nechá tak, aj s prístupovými kľúčmi Simple API linkov
  • Ak je všetko v poriadku, nastavenie nič nezmení a oznámi to
  • Aplikácia vypíše, čo presne urobila - napríklad či pole TraksterId vytvorila, opravila alebo nechala tak

Tip

Keďže opakované nastavenie nič správne neprepisuje, je možné ho spustiť aj počas preteku na overenie, či je prepojenie v poriadku

Akcie

  • Zobrazia sa až po úspešnom nastavení - predtým nemajú odkiaľ čítať
  • Import participants - načíta účastníkov, ktorých má RaceResult v tejto chvíli
    • Ďalej ich už udržiavajú aktuálnych webhooky, netreba to opakovať
  • Started - načíta štartové časy účastníkov z RaceResult

API kľúč

  • API kľúč touto udalosťou overuje volania webhookov z RaceResult - je možné ho zobraziť aj skopírovať
  • Pri obnove kľúča bude pôvodný kľúč zneplatnený

Important

Po obnove kľúča je potrebné spustiť nastavenie znova (Re-run setup) - webhooky v RaceResult majú starý kľúč a nebudú prijímané, kým na ne nastavenie nenasmeruje nový

API prepojenie

  • Pole API Link je odkaz simpleapi/get, cez ktorý sa nachádza Simple API link s účastníkmi
  • Vypĺňa ho nastavenie - nie je potrebné ho nikam kopírovať ani prepisovať, preto je len na čítanie

Odstránenie prepojenia

  • Tlačidlo Remove connection prepojenie zruší - opäť cez prihlásenie do RaceResult
  • Z udalosti v RaceResult sa odstránia:
    • tri Trakster webhooky
    • Simple API link trakster_participants
    • pole TraksterId
  • Trakster si prestane pamätať, ku ktorej udalosti bol pripojený

Note

Simple API link api zostáva - číta ho každý nástroj, ktorý s RaceResult pracuje, preto ho Trakster nemaže

Note

Účastníci, ktorí už boli načítaní, v Trakster zostávajú - patria už udalosti v Trakster, nie prepojeniu

Nedostupná RaceResult udalosť

  • Ak sa do udalosti v RaceResult už nedá prihlásiť - bola vymazaná, alebo je na účte, ku ktorému už nie je prístup - odstránenie neprejde
  • Až potom sa zobrazí možnosť Forget the connection anyway, ktorá prepojenie zruší len na strane Trakster

Important

Týmto sa v RaceResult nič neodstráni. Ak tá udalosť stále existuje, webhooky, trakster_participants aj pole TraksterId v nej zostanú a je potrebné ich odstrániť ručne

Note

Aplikácia pritom udalosti vymení API kľúč. Webhooky, ktoré v RaceResult zostali, majú starý kľúč, takže od tej chvíle nebudú prijímané a nemôžu do udalosti nič zapísať

Funkcie RaceResult integrácie

  • Načítanie existujúcich účastníkov
  • Automatické pridanie nových účastníkov po pripojení
  • Automatická aktualizácia existujúcich účastníkov po pripojení
    • Ak má účastník nový stav 5/neukázal sa a existuje v Trakster, je z Trakster vymazaný
    • Naopak, ak má účastník nový stav 1/2/3/4 a neexistuje v Trakster, je do Trakster pridaný
  • Načítanie štartových časov
  • Ak účastník prejde cieľom, automaticky sa mu nastaví že je v cieli a oznámi sa jeho klientskej aplikácii aby vypla sledovanie polohy