Plugin e1_ws_webdispecing
Plugin e1_ws_webdispecing umožňuje komunikáciu s WebDispecink (https://www.webdispecink.cz/), využíva API 2.0 podľa dokumentácie z https://developers.webdispecink.cz/guides/api-version-2-0. Plugin poskytuje 6 dátových providerov pre získanie informácií o vozidlách, pozíciách, knihách jázd, vodičoch a spoločnosti.
Plugin má podporu pre filtrovanie a vyhľadávanie, konfigurovateľné prihlasovacie údaje a podporuje dávkové spracovanie cez pumpu (DataRepeater).
Konfigurácia
Plugin podporuje dva spôsoby zadania prihlasovacích údajov pre WebDispecink:
- V konfiguračnom súbore (
e1_ws_webdispecing.config) - Vo volaní providera (parameter má prednosť pred konfiguračným súborom)
Konfiguračný súbor
<?xml version="1.0" encoding="utf-8"?>
<configuration>
<appSettings>
<add key="wdCompanyCode" value="" />
<add key="wdUserName" value="" />
<add key="wdPassword" value="" />
</appSettings>
</configuration>
Poznámka: Hodnoty poslané priamo vo volaní providera majú vždy prednosť pred hodnotami v konfiguračnom súbore.
Dátoví provideri
1. CarsList (Zoznam vozidiel)
SysName: e1_ws_webdispecing_carslist
Vráti zoznam všetkých vozidiel. Kombinuje dáta z GetCarsList.
Parametre
| Parameter | Typ | Popis |
|---|---|---|
@wdCompanyCode | Povinný* | Kód spoločnosti (* z requestu alebo z configu) |
@wdUserName | Povinný* | Prihlasovacie meno (* z requestu alebo z configu) |
@wdPassword | Povinný* | Prihlasovacie heslo (* z requestu alebo z configu) |
Výstupné stĺpce
| Stĺpec | Typ | Popis |
|---|---|---|
| CarId | int | ID vozidla |
| Identifikator | string | Evidenčné číslo vozidla |
| Driver | string | Východiskový vodič |
| Mobil | string | Telefónne číslo na komunikáciu |
| Type | int | Typ vozidla (1=autobus, 4=nákladiak, 6=osobné, atd.) |
| Online | int | Stav aktivity (0=neaktívne, 1=aktívne) |
| Disabled | int | Stav evidencie (0=povolené, 1=deaktivované) |
| CarGroupId | int | ID skupiny |
| UserRights | int | Práva používateľa |
| IdDriver | string | ID východiskového vodiča |
| AlarmSms | string | Telefón pre alarmy |
2. CarsPositions (Pozície vozidiel)
SysName: e1_ws_webdispecing_carspositions
Vráti zoznam vozidiel s aktuálnou GPS pozíciou, rýchlosťou a lokáciou.
Parametre
| Parameter | Typ | Popis |
|---|---|---|
@wdCompanyCode | Povinný* | Kód spoločnosti (* z requestu alebo z configu) |
@wdUserName | Povinný* | Prihlasovacie meno (* z requestu alebo z configu) |
@wdPassword | Povinný* | Prihlasovacie heslo (* z requestu alebo z configu) |
Výstupné stĺpce
| Stĺpec | Typ | Popis |
|---|---|---|
| CarId | int | ID vozidla |
| Latitude | float | Zemepisná šírka |
| Longitude | float | Zemepisná dĺžka |
| Zs | float | Zemepisná šírka (staršie) |
| Zd | float | Zemepisná dĺžka (staršie) |
| Speed | int | Rýchlosť v km/h |
| PositionTime | string | Čas pozície (GMT) |
| LocalPositionTime | string | Čas pozície (lokálny čas) |
| Location | string | Názov lokácie |
| LocationCity | string | Mesto |
| LocationStreet | string | Ulica |
| LocationState | string | Štát |
| Odometer | float | Stav tachometra |
| UsedFuel | float | Spotrebované palivo |
| FuelTank | float | Stav paliva v nádrži |
| Input1-4 | string | Vstupné signály |
| AcDallas | string | Dallas kľúč vodiča |
3. LogBook (Kniha jázd)
SysName: e1_ws_webdispecing_logbook
Vráti knihu jázd pre vybrané vozidlo za zadané obdobie.
Parametre
| Parameter | Typ | Popis |
|---|---|---|
@wdCompanyCode | Povinný* | Kód spoločnosti (* z requestu alebo z configu) |
@wdUserName | Povinný* | Prihlasovacie meno (* z requestu alebo z configu) |
@wdPassword | Povinný* | Prihlasovacie heslo (* z requestu alebo z configu) |
@wdCarId | Povinný | ID vozidla |
@wdDateTimeFrom | Povinný | Počiatočný dátum a čas |
@wdDateTimeTo | Povinný | Koncový dátum a čas |
Výstupné stĺpce
| Stĺpec | Typ | Popis |
|---|---|---|
| Den | string | Deň |
| Weekday | string | Deň v týždni |
| Casod | string | Čas od |
| Casdo | string | Čas do |
| Mistood | string | Miesto od |
| Mistodo | string | Miesto do |
| Ucel | string | Účel jazdy |
| Vzdalenost | double | Vzdialenosť v km |
| VzdalMesto | double | Vzdialenosť v meste |
| TachStart | double | Stav tachometra – štart |
| TachEnd | double | Stav tachometra – koniec |
| DobaJizdy | string | Trvanie jazdy |
| Ridic | string | Meno vodiča |
| Oskod | string | Osobné číslo vodiča |
| IdDriver | int | ID vodiča |
| Druh | int | Typ (0=služobná, 1=súkromná) |
| Phm | double | Natankované palivo |
| Phmcena | double | Cena paliva |
| Naklady | double | Ďalšie náklady |
| Poznamka | string | Poznámka |
| Firma | string | Navštívená firma |
| IdJizda | long | ID jazdy |
| MaxSpeed | double | Maximálna rýchlosť |
| AvgSpeed | double | Priemerná rýchlosť |
| EwStart, ElStart | double | Súradnice štartu |
| EwEnd, ElEnd | double | Súradnice konca |
| Idcar | int | ID vozidla |
| CarVin | string | VIN vozidla |
| CarType | string | Typ vozidla |
| CarFactory | string | Výrobca vozidla |
| CarModel | string | Model vozidla |
4. LogBookByVIN (Kniha jázd podľa VIN)
SysName: e1_ws_webdispecing_logbookbyvin
Vráti knihu jázd pre vozidlo identifikované VIN kódom.
Parametre
| Parameter | Typ | Popis |
|---|---|---|
@wdCompanyCode | Povinný* | Kód spoločnosti (* z requestu alebo z configu) |
@wdUserName | Povinný* | Prihlasovacie meno (* z requestu alebo z configu) |
@wdPassword | Povinný* | Prihlasovacie heslo (* z requestu alebo z configu) |
@wdVIN | Povinný | VIN kód vozidla |
@wdDateTimeFrom | Povinný | Počiatočný dátum |
@wdDateTimeTo | Povinný | Koncový dátum |
Výstupné stĺpce
Rovnaké ako pri LogBook.
5. Drivers (Zoznam vodičov)
SysName: e1_ws_webdispecing_drivers
Vráti zoznam všetkých vodičov vo firme.
Parametre
| Parameter | Typ | Popis |
|---|---|---|
@wdCompanyCode | Povinný* | Kód spoločnosti (* z requestu alebo z configu) |
@wdUserName | Povinný* | Prihlasovacie meno (* z requestu alebo z configu) |
@wdPassword | Povinný* | Prihlasovacie heslo (* z requestu alebo z configu) |
@wdIdDriver | Voliteľný (predvolené: -1) | ID vodiča (-1 = všetci) |
@wdPersonalNumber | Voliteľný | Osobné číslo |
@wdDisabled | Voliteľný (predvolené: 0) | Zobraziť deaktivovaných (0=nie, 1=áno) |
Výstupné stĺpce
| Stĺpec | Typ | Popis |
|---|---|---|
| IdSkupina | int | ID skupiny |
| IdDriver | int | ID vodiča |
| Jmeno | string | Meno |
| Prijmeni | string | Priezvisko |
| Mobil | string | Telefón |
| Dallas | string | Dallas kľúč |
| GroupName | string | Názov skupiny |
| Dallas1, Dallas2 | string | Dallas kľúče |
| Ucel | string | Účel |
| Divize | string | Divízia |
| Stredisko | string | Stredisko |
| OsobniCislo | string | Osobné číslo |
| Disabled | int | Deaktivovaný (0/1) |
| Vozidlo | string | Priradené vozidlo |
| Spz | string | ŠPZ vozidla |
| Pozn | string | Poznámka |
| Amor | double | Amortizácia |
| Pracdoba | double | Pracovná doba |
| Adresa | string | Adresa |
6. Company (Informácie o firme)
SysName: e1_ws_webdispecing_company
Vráti základné informácie o firme.
Parametre
| Parameter | Typ | Popis |
|---|---|---|
@wdCompanyCode | Povinný* | Kód spoločnosti (* z requestu alebo z configu) |
@wdUserName | Povinný* | Prihlasovacie meno (* z requestu alebo z configu) |
@wdPassword | Povinný* | Prihlasovacie heslo (* z requestu alebo z configu) |
Výstupné stĺpce
| Stĺpec | Typ | Popis |
|---|---|---|
| Kodf | string | Kód firmy |
| Name | string | Názov firmy |
| Curr | string | Mena |
| Lg | string | Jazyk |