Mukautetut Työajan viennit

Esittely

Mukautetun viennin avulla voit viedä työajan tietoja valitsemasi rakenteen mukaisena taulukkotiedostona muihin ohjelmistoihin. Voit mukauttaa tiedoston sisältöä ja formaatia tarpeidesi mukaan, jolloin tietojen siirtäminen eri järjestelmiin on helppoa ja joustavaa. Näet viennin tukemat tiedostotyypit täältä.

Viennin asetukset mahdollistavat useita tapoja siirtää tietoa:

• Manuaalinen vienti: Taulukko voidaan ladata määritetyillä käyttäjillä ja päivämäärillä välittömästi kohdasta Työaika > Hallinta > Liittymät > Mukautettu vienti.

• Ajastettu vienti: Vienti voidaan asettaa suorittamaan säännöllisesti ja toimittamaan tiedosto automaattisesti joko SFTP-palvelimelle tai haluttuihin sähköpostiosoitteisiin. Määritykset tehdään kohdassa Työaika > Hallinta > Työyhteisön asetukset > Liittymät > Liittymien ajastus (ohje ajastamiseen täällä).

• API-rajapinta: Työajan tietojen siirtäminen voidaan toteuttaa myös API-rajapintaa hyödyntämällä ajamalla sääntöjoukko tämän ohjeen mukaisesti.

Tuetut tiedostomuodot

• .CSV - Yksinkertainen taulukkotiedostomuoto, joka on yhteensopiva useiden järjestelmien kanssa, mukaan lukien yleiset taulukkolaskentaohjelmat kuten Microsoft Excel, Libre Calc tai Open Office Calc. Tämä on hyvä vaihtoehto tietojen viemiseksi muihin järjestelmiin, sillä se on laajasti tuettu ja helppo käsitellä eri sovelluksissa.
• .XLSX - Paras tiedostomuoto viedyn tiedon katseluun suoraan Microsoft Excelissä. Tukee maksimissaan 1 048 576 rivin viemistä tiedostoon.

Määritykset

Viennin asetukset (löytyvät poimintasääntökohtaisesti sivun alalaidasta) tulee tehdä työyhteisötasolle.

1. Mukautettu vienti vaatii että integraation sääntöjoukko on asetettu, joka määrittää haettavat tiedot integraatiokyselyillä. Vähintään yksi palkkalajikoodi ja kysely pitää sisältyä sääntöjoukkoon, mutta niitä voidaan lisätä useita. Katso integraation sääntöjoukot - osiosta lisätietoja.
   
   
   
   
2. Sarakemääritykset tulee määrittää samassa sääntöjoukossa siten että jokainen sarakkeen nimi vastaa joko mukautettua saraketta joka on määritetty kyselyssä, tai kenttää joka tulee automaattisesti sääntöjoukon tuloksissa, esimerkiksi:
   
   Arvojen muotoilu ja muuntaminen (esimerkiksi sekunteina olevan arvon muuttaminen tunneiksi desimaaleina) tulee määrittää sääntöjoukon kyselyissä eikä sarakemäärityksissä. Oletuksena sekunnit kuitenkin muunnetaan desimaalimuotoisiksi tunneiksi.
   
   Voit myös asettaa haluatko sisällyttää sarakkeiden otsikot taulukkotiedoston ensimmäisellä rivillä asettamalla "Sisällytä otsikkorivi viennissä" kohtaan "Kyllä".
   
   
3. Jos haluat käyttää CSV-muotoista tiedostoa, tulee tiedoston muodon määäritykset asettaa. Jos olet epävarma että mitkä määritykset ovat oikeat, niin yleensä alla olevat määritykset toimivat hyvin:
   Asetuksella "Sisällytä rivinvaihtomerkki vientitiedoston viimeiselle riville" voidaan määrittääkö, muodostuuko tiedoston loppuun yksi tyhjä rivi. Joihinkin järjestelmiin tietoa siirrettäessä voi olla välttämätöntä käyttää tätä asetusta. 
4. Voit testata vientitiedostoa ajamalla sen manuaalisesti Työaika > Hallinta > Liittymät - sivulta, tai luomalla ajastuksen ja painamalla "Suorita nyt".
   Huom: Vain henkilöt joilla on voimasssa oleva henkilönumero sisällytetään vietyihin tietoihin
   
   

Esimerkki mukautetusta työajan viennistä

Alla olevassa esimerkissä haetaan taulukolle tietoja UserInfoData-tietokantataulusta (henkilönumero ja henkilöryhmä) sekä UserSalaryData-tietokantataulusta (päivämäärä ja summa tietyntyyppisestä tulkitusta työajasta kyseisenä päivänä). Voit lukea lisää eri tietokantatauluista saatavilla olevasta datasta tästä artikkelista.

Kyseisellä työajan viennillä on tarkoitus raportoida sellaiset työpäivät, jolloin säännöllisenä työnä tulkittua työaikaa on kirjattu yli kuusi tuntia eikä samana päivänä ole lounastaukoa.

SELECT
  uid.Value AS 'Henkilönumero', 
  uid2.Value AS 'Henkilöryhmä', 
  Salaryrenderingdate AS 'Pvm', 
  SUM(Amount) / 3600 AS 'Säännöllisen työajan tunnit' 
FROM 
  Usersalarydata usd 
  LEFT JOIN UserInfoData uid ON usd.UserId = uid.UserId 
  AND uid.InfoTypeName = 'PersonnelNumber' 
  LEFT JOIN UserInfoData uid2 ON usd.UserId = uid2.UserId 
  AND uid2.InfoTypeName = 'UserGroupName_SDSQL' 
WHERE 
  CompensationType IN ('Basictime') 
  AND ActivitytypecategoryID = 1 
  AND SalaryRenderingDate NOT IN (
    SELECT 
      SalaryrenderingDate 
    FROM 
      UserSalaryData 
    WHERE 
      CompensationType = 'Lunch')
      AND istimeborrowedfrombalance = 'N' 
GROUP BY 
  uid.value, 
  Salaryrenderingdate 
HAVING 
  SUM(Amount) > 21600