m |
|||
(18 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
Tämä sivu käsittelee J2Chrono ohjelmaan luotavia liitännäisiä. Liitännäisillä voidaan kasvattaa ohjelman ominaisuuksia. | Tämä sivu käsittelee J2Chrono ohjelmaan luotavia liitännäisiä. Liitännäisillä voidaan kasvattaa ohjelman ominaisuuksia. | ||
+ | |||
+ | Liitännäiset kirjoitetaan JavaScript kielellä. Lisää aiheesta: http://fi.wikipedia.org/wiki/JavaScript | ||
==Esimerkkejä== | ==Esimerkkejä== | ||
===HTML liitännäinen=== | ===HTML liitännäinen=== | ||
− | Esimerkki HTML-tulosteita luovasta liitännäisestä. | + | Esimerkki HTML -tulosteita luovasta liitännäisestä. |
− | + | HTML -liitännäisillä voidaan luoda hyvinkin monimutkaisia rakenteita ja tyylejä, kuten taulukoita ja listoja. | |
+ | Voit käyttää hyväksesi mitä tahansa HTML -kielen merkkauksia. | ||
+ | |||
+ | Lue lisää: http://fi.wikipedia.org/wiki/HTML | ||
+ | |||
+ | Valmiita liitännäisiä: https://gitlab.com/enyone/plugins | ||
+ | |||
+ | Esimerkkiliitännäinen: [https://gitlab.com/enyone/plugins/-/blob/master/demoplugin_html.js demoplugin_html.js] | ||
====Esimerkkituloste==== | ====Esimerkkituloste==== | ||
Line 22: | Line 31: | ||
Esimerkki taulukoita luovasta liitännäisestä. | Esimerkki taulukoita luovasta liitännäisestä. | ||
− | [ | + | LIST -liitännäisten avulla luodaan staattisia taulukoita. J2Chrono lisää taulukoihin automaattisesti mm. sarakejärjestelijän ja tulostusasetukset. |
+ | |||
+ | Esimerkkiliitännäinen: [https://gitlab.com/enyone/plugins/-/blob/master/demoplugin_list.js demoplugin_list.js] | ||
+ | |||
+ | ====Esimerkkituloste==== | ||
+ | [[File:Demolist.png]] | ||
==Luominen== | ==Luominen== | ||
* Luo tyhjä tiedosto tiedostopäätteellä <tt>.js</tt> | * Luo tyhjä tiedosto tiedostopäätteellä <tt>.js</tt> | ||
− | * Kirjoita tiedostoon määrittelyn mukaiset metodit ja toiminnallisuus tai käytä apuna tyhjää liitännäistä: [ | + | * Kirjoita tiedostoon määrittelyn mukaiset metodit ja toiminnallisuus tai käytä apuna tyhjää liitännäistä: [https://gitlab.com/enyone/plugins/-/blob/master/empty_plugin.js empty_plugin.js] |
* Lataa <tt>.js</tt> tiedosto käyttöön J2Chrono -ohjelman valikosta <tt>Tiedosto->Asetukset->Liitännäiset</tt> | * Lataa <tt>.js</tt> tiedosto käyttöön J2Chrono -ohjelman valikosta <tt>Tiedosto->Asetukset->Liitännäiset</tt> | ||
− | == | + | ==JSON API== |
− | Käytössä olevat invokeWith metodit. | + | Käyttääksesi tätä APIa sinun tulee käynnistää http tulospalvelin sekä ottaa liitännäiset käyttöön J2Chrono ohjelman asetuksista. |
+ | |||
+ | API on käytettävissä osoitteessa: http://localhost:8080/api/json | ||
+ | |||
+ | ===Parametrit=== | ||
+ | * invoke | ||
+ | ** esim: http://localhost:8080/api/json?invoke=getRoundResults | ||
+ | |||
+ | ===Esimerkkituloste=== | ||
+ | [ [ | ||
+ | [ "Mattinen, Matti","","1","2","SM","1","00:00:07.000","1.0","","00:00:00.000","00:00:00.000","0.0" ], | ||
+ | [ "Tepponen, Teppo","","2","4","SM","2","00:00:04.000","0.0","","00:00:00.000","00:00:00.000","0.0" ] | ||
+ | ] ] | ||
+ | |||
+ | ==APIn metodit== | ||
+ | Käytössä olevat invoke ja invokeWith metodit. Nämä ovat käytettävissä sekä liitännäisissä että JSON APIssa. | ||
+ | ===getRounds=== | ||
+ | Palauttaa kaikki erät 2-uloitteisessa taulukossa. | ||
+ | |||
+ | Taulukon indeksit: | ||
+ | 0 id 1 name 2 time 3 sequence 4 start 5 stop 6 part | ||
+ | |||
===getPassings=== | ===getPassings=== | ||
Palauttaa kaikki erän/kilpailun ohitukset 2-uloitteisessa taulukossa. | Palauttaa kaikki erän/kilpailun ohitukset 2-uloitteisessa taulukossa. | ||
Line 36: | Line 71: | ||
Taulukon indeksit: | Taulukon indeksit: | ||
0 id 1 transponder 2 name 3 time 4 strength 5 noise 6 hits 7 lap | 0 id 1 transponder 2 name 3 time 4 strength 5 noise 6 hits 7 lap | ||
+ | |||
+ | ===getRoundLaptimes=== | ||
+ | Palauttaa kilpailijoiden kierrosajat 2-uloitteisessa taulukossa. | ||
+ | |||
+ | Taulukon indeksit: | ||
+ | 0 name 1 additional 2 number 3 competitorId 4 class 5 transponder 6 lap 7 gap | ||
+ | |||
+ | ===getEnduroGapTimes=== | ||
+ | Palauttaa kilpailijoiden reittiajat 2-uloitteisessa taulukossa. | ||
+ | |||
+ | Taulukon indeksit: | ||
+ | 0 name 1 additional 2 number 3 competitorId 4 class 5 transponder 6 lap 7 gap | ||
+ | |||
+ | ===getCompetitionResults=== | ||
+ | Palauttaa reittikilpailun tulokset 2-uloitteisessa taulukossa. | ||
+ | |||
+ | Taulukon indeksit: | ||
+ | 0 name 1 additional 2 number 3 competitorId 4 class 5 transponder 6 total 7 laps | ||
+ | 8 penalties 9 penalties_time 10 dns_time 11 penalties_laps | ||
+ | |||
+ | ===getRoundResults=== | ||
+ | Palauttaa erän tulokset 2-uloitteisessa taulukossa. | ||
+ | |||
+ | Taulukon indeksit: | ||
+ | 0 name 1 additional 2 number 3 competitorId 4 class 5 transponder 6 total 7 laps | ||
+ | 8 penalties 9 penalties_time 10 dns_time 11 penalties_laps | ||
+ | |||
+ | ===getRoundsPoints=== | ||
+ | Palauttaa yhteenlasketut pisteet 2-uloitteisessa taulukossa. | ||
+ | |||
+ | Taulukon indeksit: | ||
+ | 0 name 1 additional 2 number 3 competitorId 4 class 5 transponder 6 penalties 7 total_time | ||
+ | 8 parts 9 total 10 penalties_time 11 penalties_laps | ||
+ | |||
+ | ===getRoundsPointsAsTime=== | ||
+ | Palauttaa yhteenlasketut ajat 2-uloitteisessa taulukossa. | ||
+ | |||
+ | Taulukon indeksit: | ||
+ | 0 name 1 additional 2 number 3 competitorId 4 class 5 transponder 6 penalties 7 total_time | ||
+ | 8 parts 9 total 10 penalties_time 11 penalties_laps | ||
+ | |||
+ | ===getRoundsPointsAsLaps=== | ||
+ | Palauttaa yhteenlasketut kierrokset 2-uloitteisessa taulukossa. | ||
+ | |||
+ | Taulukon indeksit: | ||
+ | 0 name 1 additional 2 number 3 competitorId 4 class 5 transponder 6 penalties 7 total_time | ||
+ | 8 parts 9 total 10 penalties_time 11 penalties_laps | ||
+ | |||
+ | ===getRoundLaptimesWithSectorTimes=== | ||
+ | Palauttaa kilpailijoiden kierrosajat ja väliajat 2-uloitteisessa taulukossa. "sector" on luku 1,2,3.. joka on normaalissa kierrosajassa tyhjä. | ||
+ | |||
+ | List indexes: | ||
+ | 0 name 1 additional 2 number 3 competitorId 4 class 5 transponder 6 lap 7 gap 8 sector |
Latest revision as of 11:09, 8 November 2020
Tämä sivu käsittelee J2Chrono ohjelmaan luotavia liitännäisiä. Liitännäisillä voidaan kasvattaa ohjelman ominaisuuksia.
Liitännäiset kirjoitetaan JavaScript kielellä. Lisää aiheesta: http://fi.wikipedia.org/wiki/JavaScript
Contents
Esimerkkejä
HTML liitännäinen
Esimerkki HTML -tulosteita luovasta liitännäisestä.
HTML -liitännäisillä voidaan luoda hyvinkin monimutkaisia rakenteita ja tyylejä, kuten taulukoita ja listoja. Voit käyttää hyväksesi mitä tahansa HTML -kielen merkkauksia.
Lue lisää: http://fi.wikipedia.org/wiki/HTML
Valmiita liitännäisiä: https://gitlab.com/enyone/plugins
Esimerkkiliitännäinen: demoplugin_html.js
Esimerkkituloste
Passing times: 23:34:03.421 23:34:19.996 23:34:26.944 23:54:31.672 23:54:42.103 02:40:26.316 Selected option: -1 which does not exist
LIST liitännäinen
Esimerkki taulukoita luovasta liitännäisestä.
LIST -liitännäisten avulla luodaan staattisia taulukoita. J2Chrono lisää taulukoihin automaattisesti mm. sarakejärjestelijän ja tulostusasetukset.
Esimerkkiliitännäinen: demoplugin_list.js
Esimerkkituloste
Luominen
- Luo tyhjä tiedosto tiedostopäätteellä .js
- Kirjoita tiedostoon määrittelyn mukaiset metodit ja toiminnallisuus tai käytä apuna tyhjää liitännäistä: empty_plugin.js
- Lataa .js tiedosto käyttöön J2Chrono -ohjelman valikosta Tiedosto->Asetukset->Liitännäiset
JSON API
Käyttääksesi tätä APIa sinun tulee käynnistää http tulospalvelin sekä ottaa liitännäiset käyttöön J2Chrono ohjelman asetuksista.
API on käytettävissä osoitteessa: http://localhost:8080/api/json
Parametrit
Esimerkkituloste
[ [ [ "Mattinen, Matti","","1","2","SM","1","00:00:07.000","1.0","","00:00:00.000","00:00:00.000","0.0" ], [ "Tepponen, Teppo","","2","4","SM","2","00:00:04.000","0.0","","00:00:00.000","00:00:00.000","0.0" ] ] ]
APIn metodit
Käytössä olevat invoke ja invokeWith metodit. Nämä ovat käytettävissä sekä liitännäisissä että JSON APIssa.
getRounds
Palauttaa kaikki erät 2-uloitteisessa taulukossa.
Taulukon indeksit:
0 id 1 name 2 time 3 sequence 4 start 5 stop 6 part
getPassings
Palauttaa kaikki erän/kilpailun ohitukset 2-uloitteisessa taulukossa.
Taulukon indeksit:
0 id 1 transponder 2 name 3 time 4 strength 5 noise 6 hits 7 lap
getRoundLaptimes
Palauttaa kilpailijoiden kierrosajat 2-uloitteisessa taulukossa.
Taulukon indeksit:
0 name 1 additional 2 number 3 competitorId 4 class 5 transponder 6 lap 7 gap
getEnduroGapTimes
Palauttaa kilpailijoiden reittiajat 2-uloitteisessa taulukossa.
Taulukon indeksit:
0 name 1 additional 2 number 3 competitorId 4 class 5 transponder 6 lap 7 gap
getCompetitionResults
Palauttaa reittikilpailun tulokset 2-uloitteisessa taulukossa.
Taulukon indeksit:
0 name 1 additional 2 number 3 competitorId 4 class 5 transponder 6 total 7 laps 8 penalties 9 penalties_time 10 dns_time 11 penalties_laps
getRoundResults
Palauttaa erän tulokset 2-uloitteisessa taulukossa.
Taulukon indeksit:
0 name 1 additional 2 number 3 competitorId 4 class 5 transponder 6 total 7 laps 8 penalties 9 penalties_time 10 dns_time 11 penalties_laps
getRoundsPoints
Palauttaa yhteenlasketut pisteet 2-uloitteisessa taulukossa.
Taulukon indeksit:
0 name 1 additional 2 number 3 competitorId 4 class 5 transponder 6 penalties 7 total_time 8 parts 9 total 10 penalties_time 11 penalties_laps
getRoundsPointsAsTime
Palauttaa yhteenlasketut ajat 2-uloitteisessa taulukossa.
Taulukon indeksit:
0 name 1 additional 2 number 3 competitorId 4 class 5 transponder 6 penalties 7 total_time 8 parts 9 total 10 penalties_time 11 penalties_laps
getRoundsPointsAsLaps
Palauttaa yhteenlasketut kierrokset 2-uloitteisessa taulukossa.
Taulukon indeksit:
0 name 1 additional 2 number 3 competitorId 4 class 5 transponder 6 penalties 7 total_time 8 parts 9 total 10 penalties_time 11 penalties_laps
getRoundLaptimesWithSectorTimes
Palauttaa kilpailijoiden kierrosajat ja väliajat 2-uloitteisessa taulukossa. "sector" on luku 1,2,3.. joka on normaalissa kierrosajassa tyhjä.
List indexes:
0 name 1 additional 2 number 3 competitorId 4 class 5 transponder 6 lap 7 gap 8 sector