Titania noutaa tapahtumia

Titania työvuorosuunnittelu on kehitetty työvuorojen systemaattiseen suunnitteluun ja seurantaan. Neptoniin merkityt tapahtumat voidaan määritellä siirrettäväksi Titaniaan. Siirrossa käytetään SOAP web services -rajapintaa, jonka tarkempi kuvaus on nähtävissä täältä.

Jos Nepton-ympäristössä on asetettu IP-rajoituksia Työsuhde > Hallinta > Turvallisuus > Salli kutsut Nepton API web service rajapintaan vain alla listatuissa IP-osoitteissa -asetuksessa, tällöin tulee olla tietoja hakevalle IP-osoitteelle annettu pääsy.

Tapahtumien vientimuoto

Titania käsittelee työtapahtumia erilailla kuin Nepton. Neptonissa tapahtumat ovat tietyllä tapahtumatyypillä ja niillä on alku- ja loppuaika. Titaniassa tapahtumat ovat joko aloitus- tai lopetustapahtumia yhdellä ajalla.

Nepton tekee tätä varten muunnoksia. Esimerkiksi seuraavat Neptoniin kirjatut tapahtumat:

• 08:00 - 13:00 Työ
• 13:00 - 14:00 Koulutus
• 14:00 - 16:00 Työ

Muutetaan seuraavaan muotoon, jonka Titania ymmärtää:

• 08:00 Aloitus (ei syykoodia)
• 13:00 Lopetus (koulutus)
• 14:00 Aloitus (ei syykoodia)
• 16:00 Lopetus (ei syykoodia)

Määrittäminen

Henkilöiden tunnusten määrittäminen

Titania käyttää henkilön tunnisteena joko henkilönumeroa tai henkilötunnusta, sekä joissain tapauksissa molempia.

Henkilön henkilönumero voidaan määrittää muokkaamalla henkilötietoja Työsuhde > Henkilön tiedot -näkymässä, Tunnisteet -osiossa.

Henkilöiden henkilötunnukset voidaan määrittää muokkaamalla henkilötietoja Työsuhde > Henkilön tiedot -näkymässä.

Tapahtumatyyppien koodien ja käyttäytymisen määrittäminen

Nämä voidaan määritellä Titanian asetuksista: Työaika -> Hallinta -> Työyhteisön asetukset -> Liittymät -> Titania.

Kaikille tapahtumatyypeille voi määrittää seuraavat tiedot:

• Tapahtumatyypin syykoodi - Titania käyttää tätä tunnistamaan, mistä tapahtumasta on kyse
• Käsittele tapahtumatyyppi - Onko tapahtumatyypillä kirjattu tapahtuman alku joko sisään (aloitus) vai ulos (lopetus) leimaus. Asetuksen alla kerrotaan, mikä on tapahtumatyypin oletuskäsittelytapa, jos asetusta ei ole asetettu.
• Käsittele tapahtumatyyppi ylityönä - Onko tapahtuma ylityötä vai ei. Ylitöiden kirjauksesta enemmän alla olevissa esimerkeissä. Tämä asetus on asetettavissa vain työtä vastaaville tapahtumille, sitä ei esimerkiksi voi asettaa poissaoloille.

Oletuksena kaikki tapahtumatyypit viedään, vaikka niille ei olisi määritetty syykoodia. Jos halutaan, että tiettyä tapahtumatyyppiä ei viedä, sen syykoodiksi määritetään 0.

Viennin asetukset

Vientitiedoston nimi -kenttää ei ole tarve määritellä koska kyseessä on SOAP-kutsu Neptoniin.

Tapahtumatyyppien määritys- ja käyttöesimerkkejä

Koulutus

Titaniassa koulutus on leimausten kannalta poissaoloa perustehtävän mukaisesta työstä. Koulutukseen mentäessä kesken työpäivän leimataan aina lopetus (koulutus).

Neptonissa koulutus saadaan määritettyä seuraavalla tavalla:

Ylityömääräys

Titaniassa ylityömääräys on joko aamulla tai illalla tehtyä ylityötä, sekä voi olla myös molempia. Jos henkilö tekee aamulla ylityötä, hän aloittaa päivän aloitus (ylityö) leimauksella. Erillistä leimausta ei tehdä, kun ylityö päättyy ja normaali työ alkaa. Sama toimintaperiaate on myös illalla. Erillistä ylityön aloitusta ei leimata, vaan työt päättyvät lopetus (ylityö) leimaukseen.

Neptonissa tämä saadaan aikaseksi perustamalla oma "Ylityö" tapahtumatyyppi ja antamalla sille seuraavat asetukset:

Aamun ylityö kirjattaisiin Neptoniin seuraavasti:

• 06:30 - 08:00 Ylityö
• 08:00 - 16:00 Työ

Jolloin titaniaan siirtyvät seuraavat leimaukset:

• 06:30 Aloitus (YT)
• 16:00 Lopetus (ei syykoodia)

Illan / iltapäivän ylityö kirjattaisiin Neptoniin seuraavasti:

• 08:00 - 16:00 Työ
• 16:00 - 18:00 Ylityö

Jolloin titaniaan siirtyvät seuraavat leimaukset:

• 08:00 Aloitus (ei syykoodia)
• 18:00 Lopetus (YT)

Käyttöesimerkkejä

Yön yli kestävät työvuorot

Kyselyn tiedot

Kyselyn esimerkki

<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tyo="http://tyoaika.tyoteho.fi">
  <soapenv:Header/>
  <soapenv:Body>
    <tyo:ParametersForGetTitaniaWorkingTimeEvents>
      <CallerAuthentication /> <!-- Autentikoituminen vaaditaan, mutta on jätetty tässä esimerkissä pois -->
      <period>
        <beginDate>20200501</beginDate>
        <endDate>20200531</endDate>
      </period>
      <schedulingUnit>
        <code>E1100</code>
        <name>Suunnittelupiste A</name>
        <person>
          <SSN/>
          <employeeId>9001</employeeId>
          <name>Yli Yhdeksän Tuhatta</name>
        </person>
        <person>
          <SSN>999999-9999</SSN>
        </person>
      </schedulingUnit>
    </tyo:ParametersForGetTitaniaWorkingTimeEvents>
  </soapenv:Body>
</soapenv:Envelope>

Vastauksen tiedot

Vastauksen esimerkki

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://tyoaika.tyoteho.fi">
  <SOAP-ENV:Body>
    <ns1:ReturnValueForGetTitaniaWorkingTimeEvents>
      <ResponseCode>1000</ResponseCode>
      <ResponseString>All clear. No errors.</ResponseString>
      <schedulingUnit>
        <code>E1100</code>
        <name>Suunnittelupiste A</name>
        <person>
          <ResponseCode>1000</ResponseCode>
          <ResponseString>All clear. No errors.</ResponseString>
          <SSN/>
          <employeeId>9001</employeeId>
          <name>Yli Yhdeksän Tuhatta</name>
          <stampedWorkingTimeEvents>
            <event>
              <date>20200505</date>
              <beginTime>0800</beginTime>
            </event>
            <event>
              <date>20200505</date>
              <endTime>2000</endTime>
              <endReasonCode>YT</endReasonCode>
            </event>
          </stampedWorkingTimeEvents>
        </person>
        <person>
          <ResponseCode>1000</ResponseCode>
          <ResponseString>All clear. No errors.</ResponseString>
          <SSN>999999-9999</SSN>
          <stampedWorkingTimeEvents>
            <event>
              <date>20200505</date>
              <beginTime>0800</beginTime>
            </event>
            <event>
              <date>20200505</date>
              <endTime>1200</endTime>
              <endReasonCode>KO</endReasonCode>
            </event>
          </stampedWorkingTimeEvents>
        </person>
      </schedulingUnit>
    </ns1:ReturnValueForGetTitaniaWorkingTimeEvents>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>