Palvelusta voidaan lähettää henkilöiden tilatietoja Mitel Aastra ja Telia VIP (ent. Telia Merex) puhelinjärjestelmiin. Tiedot lähetetään Flexim-kulunvalvontajärjestelmään, jonka tietoja puhelinjärjestelmät hyödyntävät.
Määrittäminen
Henkilöiden tunnusten määrittäminen
Henkilöiden tunnisteet integraatiota varten voidaan määrittää muokkaamalla henkilötietoja Työsuhde - Henkilön tiedot - Tunnisteet - Aastra. Sekä Aastra- että VIP (Merex)-tiedonsiirtoa varten käytetään asetuksissa olevaa "Aastra"-tunnistetta.
Tapahtumatyyppien koodien määrittäminen
Tapahtumatyyppien koodit voidaan määrittää työyhteisön asetuksista, Työaika - Hallinta - Työyhteisön asetukset - Liittymät. Aastran asetukset löytyvät kohdasta Mitel Aastra ja Telia VIPin asetukset kohdasta Telia Merex.
Tapahtumatyyppien koodit
Tapahtumatyypeille määritetään koodit alla olevan taulukon mukaisesti.
| Koodi | Selite |
|---|---|
| 1 | Kokous |
| 2 | Sisällä (vastaa työajan aloittamista) |
| 3 | Ulkona (vastaa työajan loppumista) |
| 5 | Matkatyö |
| 6 | Loma / Työajan lyhennysvapaa / Saldovapaa |
| 7 | Sairasloma |
| 8 | Koulutus |
| 9 | Työ muualla |
| 0 | Ulkona muu syy (vastaa työajan loppumista) |
| a | Lounas |
Tietojen lähettäminen
Aastran host-osoitteen ja muut viennin asetukset saa asetettua työyhteisön asetuksista, Työaika - Hallinta - Työyhteisön asetukset - Liittymät - Mitel Aastra - Kokoonpano.
Telia VIPin host-osoitteen ja muut viennin asetukset saa asetettua työyhteisön asetuksista, Työaika - Hallinta - Työyhteisön asetukset - Liittymät - Telia Merex - Kokoonpano.
Kummassakin integraatiossa tilapäivityksiä lähetetään oletuksena maksimissaan 100 minuutissa. Viive lähetettyjen tilarivien välissä on oletuksena 500 millisekuntia. Näitä voi muokata omista asetuskohdistaan.
Rajaukset
- Työntekijät henkilönumerolla 0 eivät tule osaksi aineistoa
Liittymän tekninen toiminta
Tilatiedot lähetetään minuutin välein määritetyn palvelimen osoitteeseen sellaisenaan yksi kerrallaan. Lähetys tapahtuu avatun TCP socketin kautta eikä liittymä ei odota paluusanomaa lähetettyihin tietoihin.
Sanoman sisältö
Liittymä on vakioitu eikä tietosisältöön ole tarvetta tehdä muutoksia. Tilatieto on tabulaattorimerkillä erotettua tekstimuotoista dataa. Merkistökoodauksena on ASCII. Lähetettävät tiedot ovat kuvattu alla.
| Tieto | Selite |
| Aloitusmerkki |
Aloitusmerkkinä käytetään aina |
| Tapahtumatyypin koodi | |
| Tabulaattori | |
| Henkilön Aastra -tunnus / henkilönumero | Maksimissaan 11 merkkiä pitkä. |
| Tabulaattori | |
| Muu syykoodi | Maksimissaan 3 merkkiä pitkä. Tietoa ei käytetä. |
| Tabulaattori | |
| Tapahtuman päättymispäivä | Jos tapahtumalla ei ole tiedossa olevaa päättymispäivää, tieto lähetetään tyhjänä. Muotona PPKK, esimerkiksi 3105. |
| Tabulaattori | |
| Tapahtuman päättymispäivä | Jos tapahtumalla ei ole tiedossa olevaa päättymisaikaa, tieto lähetetään tyhjänä. Muotona HHMM, esimerkiksi 1230. |
| Tilatiedon tarkistemerkki | Tarkiste lasketaan vain Telia VIPin tilatietoihin, Mitel Aastran tilatiedoissa se jätetään pois. |
| Lopetusmerkki |
Lopetusmerkkinä käytetään aina |
Odotettu vastaus
Liittymä ei odota vastausta lähetettyihin tilatietoihin. Jos tilatiedon lähetys TCP socketiin onnistuu, tilatieto katsotaan onnistuneesti lähetetyksi.
Tarkistemerkin laskukaava
- Jokaisen tilatiedossa olevan merkin sijainti ASCII-taulukossa lasketaan ja nämä arvot lasketaan yhteen. Vain merkit ennen tarkistemerkkiä katsotaan.
- Otetaan yhteen lasketun summan 7 alinta bittiä kokonaislukuna.
- Jos kokonaisluku on alle 32, arvoon lisätään 32.
- Laskentakaavan tulos kertoo tarkistemerkin sijainnin ASCII taulukossa.
PHP esimerkki:
<?php
function getChecksum(string $string): string
{
$sum = array_sum(
array_map(
static function (string $chr): int {
return ord($chr);
},
str_split($string)
)
);
$sum &= hexdec('0x7f');
if ($sum < hexdec('0x20')) {
$sum += hexdec('0x20');
}
return chr($sum);
}
Esimerkki
STX, TAB, tarkiste (CHECKSUM) ja CR merkit visualisoituna esimerkkisanomassa.
STX2TAB5642TABTAB1302TAB1208CHECKSUMCR