Nepton voidaan määrittää lähettämään tapahtumien hyväksynnät IFS-järjestelmään. Tiedot lähetetään, kun henkilöiden tapahtumia hyväksytään tai niiden hyväksyntää poistetaan. Hyväksyntää tai hyväksynnän poistoa ei tehdä, jos IFS ei palauta vastauksena, että hyväksynnän muutos onnistui.
Tietojen lähettämiseen vaaditaan IFS:n SOAP-verkkopalvelu (tai välijärjestelmä, kuten BizTalk). Tämän verkkopalvelun WSDL-skeema kuvataan alla.
Määrittäminen
1. Henkilöiden tunnusten määrittäminen
Henkilöiden IFS-tunnukset voidaan määrittää muokkaamalla henkilötietoja Työsuhde > Henkilön tiedot > Tunnisteet -näkymässä.
HUOM.! Jos henkilön IFS-tunnusta ei ole asetettu, käytetään henkilönumeroa.
2. Tietojen lähettäminen
Web servicen päätepisteen (minne hyväksynnät ja niiden poistot lähetetään) ja yrityksen tunnuksen / nimen määritys tapahtuu työyhteisön asetuksista, Työaika > Hallinta > Työyhteisön asetukset > Liittymät > IFS Tapahtumien hyväksyntä. Jos liittymässä käytetään API avaimella tunnistamista, se asetetaan myös samassa paikassa.
Web servicen päätepisteen ja API avaimen voi myös asettaa asetusryhmäkohtaisesti Työaika > Hallinta > Asetusryhmät > Asetusryhmä-valikko: Haluttu asetusryhmä > Toiminto-valikko: Asetusryhmän asetukset > Liittymät > IFS Tapahtumien hyväksyntä
Rajoitukset
- Työntekijät henkilönumerolla 0 eivät tule osaksi aineistoa
- Jos henkilön hyväksyntää tai sen poistoa ei saatu käsiteltyä vastaanottavassa päässä, sitä ei tehdä
- Tapahtumien hyväksyntä ja hyväksynnän poisto voidaan lähettää vain yhteen web servicen päätepisteeseen kerrallaan. Jos hyväksyntää tai hyväksynnän poistoa tehdään henkilöille, joilla on eri web servicen päätepisteitä asetusryhmän asetusten kautta, toiminto estetään.
- Yksittäisten tapahtumien hyväksyntää ei tueta, koska sen sijaan lähetetään hyväksyttyjä / hyväksymättömiä päiviä. Voit poistaa yksittäisten tapahtumien hyväksynnän / hyväksynnän poiston käytöstä ottamalla "Hyväksy tapahtumat päivältä" -kohdan päälle työkaudella > Ylläpito > Työyhteisön asetukset > Työajat > Tapahtumien lukitseminen ja hyväksyminen.
- Jos Web servicen päätepiste ja API avain on asetettu asetusryhmätasolla, tulee hyväksyjän ja hyväksyttäjän olla samassa asetusryhmässä jotta hyväksyntä menee oikeaan päätepisteeseen
Viennin käynnistys
Vientiä ei ole aikataulutettu, mutta se käynnistetään reaaliajassa aina, kun käyttäjä hyväksyy tai hylkää tapahtumia. Vientiä ei käynnistetä yksittäisiä tapahtumia hyväksyttäessä.
Lähetettävät tiedot
| Taso | Kentän nimi | Sääntöjoukon kentän nimi | Formaatti | Esiintymiskerrat | Selite |
|---|---|---|---|---|---|
| Root, under SOAP body |
AUTHORIZE_REPORT | XML element | 1 | ||
| 1 | COMPANY | string (20) | 0..1 | Yrityksen tunnus / nimi. Annetaan IFS Tapahtumien hyväksynnän asetuksissa | |
| 1 | EMP_ID | Lisätään automaattisesti, ei korvattavissa | string (11) | 0..1 | Henkilön IFS-tunnus / henkilönumero |
| 1 | AUTHORIZE_TRANSACTIONS | XML element | 1 | ||
| 2 | AUTHORIZE_TRANSACTION | XML element | 0..n | ||
| 3 | START_DATE | StartDateTime | date | 1 | Hyväksynnän aikavälin alkupäivä, formaatti YYYY-MM-DD |
| 3 | END_DATE | EndDateTime | date | 0..1 | Hyväksynnän aikavälin loppupäivä, formaatti YYYY-MM-DD |
| 3 | STATE | If SalaryCode equals 'Approve' 1 is returned, otherwise 0 | string (1) | 1 | Hyväksynnän tila:
|
| 3 | AUTH_ID | Lisätään automaattisesti, ei korvattavissa | string (20) | 1 | Hyväksynnän tekijän IFS-tunnus / henkilönumero |
Kyselyn esimerkki:
<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:wo="WO.fi.TyoTeho.Schemas.AuthorizationFromTyoTeho">
<soapenv:Header/>
<soapenv:Body>
<wo:AUTHORIZE_REPORT>
<wo:COMPANY>CompanyID</wo:COMPANY>
<wo:EMP_ID>1230</wo:EMP_ID>
<wo:AUTHORIZE_TRANSACTIONS>
<wo:AUTHORIZE_TRANSACTION>
<wo:START_DATE>2019-06-01</wo:START_DATE>
<wo:END_DATE>2019-06-30</wo:END_DATE>
<wo:STATE>1</wo:STATE>
<wo:AUTH_ID>1240</wo:AUTH_ID>
</wo:AUTHORIZE_TRANSACTION>
<wo:AUTHORIZE_TRANSACTION>
<wo:START_DATE>2019-06-01</wo:START_DATE>
<wo:END_DATE>2019-06-30</wo:END_DATE>
<wo:STATE>1</wo:STATE>
<wo:AUTH_ID>1250</wo:AUTH_ID>
</wo:AUTHORIZE_TRANSACTION>
</wo:AUTHORIZE_TRANSACTIONS>
</wo:AUTHORIZE_REPORT>
</soapenv:Body>
</soapenv:Envelope>
Odotettu vastaus
Liittymä odottaa suoraa vastausta paluusanomana. Paluusanoman muoto on seuraava:
| Taso | Kentän nimi | Formaatti | Esiintymiskerrat | Selite |
|---|---|---|---|---|
| Root, under SOAP body |
Response | XML element | 1 | |
| 1 | Success | boolean | 1 | Saatiinko lähetetyt hyväksynnät tai hyväksynnän poistot käsiteltyä onnistuneesti vai ei |
| 1 | Message | string | 0..1 | Valinnainen viesti, käytetään virheviestin esittämiseen kun hyväksynnät / hyväksynnän poistoja ei saatu käsiteltyä. Jos hyväksynnät tai niiden poistoja saatiin käsiteltyä, viestissä odotetaan olevan niiden henkilöiden IFS-tunnukset / henkilönumerot, joiden hyväksyntä tai sen poisto onnistui. Henkilönumerot erotetaan toisistaan pilkulla. |
Sanoman esimerkki:
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://WO.fi.TyoTeho.Schemas.TimeReportResponse">
<SOAP-ENV:Body>
<ns1:Response>
<Success>true</Success>
<Message>1011,2011,3011</Message>
</ns1:Response>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>