Mitel Aastra ja Telia Merex tilatiedot (Flexim)

Palvelusta voidaan lähettää henkilöiden tilatietoja Mitel Aastra ja 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ä 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 Merexin asetukset kohdasta Telia Merex.

Tapahtumatyyppien koodit

Tapahtumatyypeille määritetään koodit alla olevan taulukon mukaisesti.

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.

Merexin 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.

Odotettu vastaus

Liittymä ei odota vastausta lähetettyihin tilatietoihin. Jos tilatiedon lähetys TCP socketiin onnistuu, tilatieto katsotaan onnistuneesti lähetetyksi.

Tarkistemerkin laskukaava

1. Jokaisen tilatiedossa olevan merkin sijainti ASCII-taulukossa lasketaan ja nämä arvot lasketaan yhteen. Vain merkit ennen tarkistemerkkiä katsotaan.
2. Otetaan yhteen lasketun summan 7 alinta bittiä kokonaislukuna.
3. Jos kokonaisluku on alle 32, arvoon lisätään 32.
4. 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