Sääntöjoukon poimintasääntöjen muodostaminen – Nepton

Poimintojen periaatteet

Sääntöjoukolla määritetään se sisältö, joka poimitaan siirrettävään aineistoon. Sääntäjoukoista yleisesti voit lukea täältä.

Sääntöjoukossa esitetään 100 riviä poimintasäännöille. Kullakin rivillä on poimintasäännön nimi, käytettävä palkkalaji, poimintasääntö ja yksikkötieto (tuntia, kappaletta, desimaalia), jossa tieto siirretään aineistoon.

Poimintasäännöt kirjoitetaan SQL lausekkeina, käyttäen SQLiten muotoa. Poimintasääntöjen lähdeaineistona on käytettävissä eri tietokantatauluja. Kun aineistoa muodostetaan, käydään jokaisen aineistomuodostuksessa valituttu henkilö yksitellen läpi ja poimittavassa tietokantataulussa on tiedot vain kyseistä henkilöä koskien.

Poimintasäännöt kirjoitetaan SQL muotoon:

SELECT ... FROM <taulun nimi> WHERE ...

SQL kielestä voidaan käyttää myös muuta toiminnallisuutta kuten JOIN, Aggrekaattifunktiot (SUM, COUNT, jne).

SQL-syntaksista ja toiminnallisuuksista voit tarkemmin lukea SQLiten omasta dokumentaatiosta.

Käytettävissä SQLiten toimintojen lisäksi palveluun on toteutettu apufunktioita. Apufunktioiden avulla on helpompi käsitellä esimerkiksi merkkijonoja kuin käyttäen SQLiten toiminnallisuutta.

Löydät kattavan listan sääntöjoukon poimintasääntöjen SQL esimerkkejä täältä

Sääntöjoukon käyttäminen aineistosiirrossa

Mikä tahansa perustettu sääntöjoukko voidaan ladata missä tahansa aineistomuodossa. Sääntöjoukolla kuvataan poiminnan sisältö. Sääntöjoukon muodostamisen jälkeen aineisto voidaan ladata missä tahansa muodossa. Mikäli käytetty aineistomuoto käyttää sellaisia tietokenttiä, joita poimintasäännössä ei ole määritetty niin ne siirtyvät aineistomuodosta riippuen oletusarvoisena tai tyhjänä.

Override - sarakenimen käyttö

Kun tietoa siirretään, niin tietokentät saavat automaattisesti sen sisällön mikä siirrettävässä aineistomuodossa on määritetty. Minkä tahansa kentän arvo voidaan korvata poimimalla SQL säännöllä sarake, jonka nimi sisältää tekstin Override+sarakkeen nimi.

Esimerkiksi useassa liittymässä siiretään tunti- tai kappalemääriä. Tulkinta voi muodostaa useita rivejä samalle päivälle ja usein näitä tuloksia halutaan laskea yhteen päivätasolla. Tällöin siirtyvä sarake 'Amount' voidaan korvata uudella arvolla poimimalla sisältö sarakkeeksi 'OverrideAmount'. Vastaavalla tavalla esimerkiksi kommentti-kentän arvoksi voidaan valita muutakin tietoa. Kommenttikenttään voi esimerkiksi liittää muutakin tietoa muodostamalla kyselyssä sarakkeen 'OverrideComment'. Siirtoaineiston sisältämä kenttä voidaan korvata käyttämällä tätä override-sarakenimeä. Tarkemmat tiedot sarakkeiden nimistä on esitetty liittymäkohtaisissa kuvauksissa täällä.

Käsiteltävän ajanjakson määrittely

Sääntöjoukon poimintasäännöt poimivat sisältöä aina joltakin ajanjaksolta. Käsiteltävä ajanjakso määritellään joko sääntöjoukon siirron automatisointi - artikkelissa tai on määritelty käyttöliittymässä sääntöjoukon tuloksia noudettaessa. Poimintasäännöt kohdistuvat käsiteltävään ajanjaksoon ja poimintasääntö palauttaa tulokset käsiteltävältä ajanjaksolta.

Tapahtumia voidaan poimintasäännössä rajata :exportPeriodStart ja :exportPeriodEnd -muuttujilla. :exportPeriodStart korvataan kyselyä suoritettaessa käsiteltävän jakson alkupäivällä YYYY-MM-DD HH:MM:SS -muotoisena. Vastaavasti :exportPeriodEnd korvataan vietävän jakson loppupäivällä.

Rajoituksia

Kirjainkoolla on merkitystä muilla kuin ASCII-merkeillä

Jos esimerkiksi poimitaan tapahtumatyypin koodin perusteella, kun koodina on YÖ, koodin jälkimmäinen merkki pitää esittää samalla kirjainkoolla kuin millä se on tapahtumatyypin koodiin asetettu.

Esimerkiksi seuraava lauseke toimii, koska tapahtumatyypin koodin Ö-merkki on kyselyssä isolla kirjankoolla. Pienellä kirjainkoolla kysely ei toimisi:

SELECT *, SUM(Amount) As OverrideAmount FROM UserSalaryData
WHERE CompensationType = 'BasicTime' AND ActivityTypeCode = 'YÖ'

Voit lukea enemmän ASCII-merkeistä / merkistöstä Wikipedian artikkelista.

Tietokantataulujen sisältö

Alla on kuvattuna yhdeksän tietokantataulua, jonka sisältöä voi poimia siirtoihin.

Tietokantataulun nimi	Kuvaus	Tuettu asetusarvojen poikkeuksissa
UserSalaryData	Taulu sisältää henkilön tulkitun työaikatiedon voimassaolevien sääntöjen mukaisesti. Poimittaessa tulkittuja tapahtumia, kannattaa poimintajakso pitää mahdollisimman lyhyenä, jotta tietojen hakuaika ei kasvaisi pitkäksi. Suosittelemme poimintajaksoksi enintään kaksi kuukautta eteen- ja taaksepäin.	Ei
UserEventData	Taulu sisältää henkilölle kirjatut tapahtumat sellaisena kuin ne on kirjattu. Poimittaessa kirjattuja tapahtumia, voi poimintajakso olla pidempi kuin tulkittuja tapahtumia poimittaessa. Suosittelemme poimintajaksoksi enintään yksi vuosi eteen- ja taaksepäin.	Kyllä, poislukien ne asetukset joilla määritetään työvuorokauden ajoittuminen.
UserEventHistoryData	Taulu sisältää henkilölle kirjatut tapahtumat sellaisina kuin ne on kirjattu mukaan lukien muokattujen tapahtumien aiemmat versiot, poistetut tapahtumat ja asetetulla aikavälillä muokatut tapahtumat. Tapahtumien eri versiot saattavat ajoittua myös asetetun aikavälin ulkopuolelle, jos tapahtuman jonkin version muokkaus- tai tapahtuma-aika sijoittuu kuitenkin annetulle välille.	Kyllä, poislukien ne asetukset joilla määritetään työvuorokauden ajoittuminen.
UserEventProjectData	Jokaiselle tapahtumaan liitetylle projektille on tässä taulukossa rivi, joka sisältää projektin tunnuksen ja muistiinpanot.	Kyllä
UserTravelExpenseTripData	Taulu sisältää henkilön matkalaskuille kirjattujen matkojen tiedot	Ei
UserData	Taulu sisältää voimassaolevat henkilö- sekä työsuhdetiedot. Voidaan yhdistää kyselyihin UserSalaryData- sekä UserEventData-tauluista.	Kyllä
UserInfoData	Taulu sisältää kaikki henkilö- ja työsuhdetiedot historia-arvoineen. Voidaan yhdistää kyselyihin UserSalaryData- sekä UserEventData-tauluista	Kyllä
UserGroupData	Taulu sisältää henkilöryhmätiedot henkilöille, jotka ovat aineistossa. Valittujen henkilöryhmien kaikki yläprojektit löytyvät taulusta.	Kyllä
ProjectData	Sisältää täydelliset projektitiedot projekteista, joita käyttäjä käyttää raportointikaudella.	Kyllä

UserSalaryData

Kentän nimi	Tyyppi	Kuvaus
CompensationType	enum	Käytettävissä ainoastaan SalaryData-taulun dataan. "BasicTime" - Tehty säännöllinen työaika. "ReducedRateTime" - Vähennetyn korvauksen aika. Joistakin poissaolotyypeistä ja sairauslomista voidaan ansaita alennettua palkkaa. "UnpaidBasicTime" - Perustyöaika, josta ei makseta korvausta. Esimerkiksi palkattomasta poissaolosta muodostuu enintään työvelvoitteen verran. "AdditionalWork" - Lisätyö, jota ansaitaansäännöllisen työajan (työpäivän ja työviikon pituus) jälkeen, mutta ennen työpäivän- ja työviikon enimmäispituutta. "OvertimeDaily50" - Vuorokautinen ylityö 50%. "OvertimeDaily100" - Vuorokautinen ylityö 100%. "OvertimeWeekly50" - Viikottainen ylityö 50%. "OvertimeWeekly100" - Viikottainen ylityö 100%. "OvertimeSunday50" - Sunnuntaiylityö 50%. Ylityö, jota ansaitaan sunnuntaiylityöasetusten mukaisesti. "OvertimeSunday100" - Sunnuntaiylityö 100%. Ylityö, jota ansaitaan sunnuntaiylityöasetusten mukaisesti. "OvertimeBaseFixed" - Ylityö 1, käytetään osassa pohjoismaissa käytössä olevia TESejä. "OvertimeExtraFixed" - Ylityö 2, käytetään osassa pohjoismaissa käytössä olevia TESejä. "LevellingPeriodAdditional" - Lisätyö, joka ansaitaan tasoittumisjakson lopussa. "LevellingPeriodOvertime50" - 50% ylityö, joka ansaitaan tasoittumisjakson lopussa. "LevellingPeriodOvertime100" - 100% ylityö, joka ansaitaan tasoittumisjakson lopussa. "UnpaidOvertime" - Ylityö, jonka korvaus on asetettu "Ei korvata" ja ei siksi makseta. "WorkRise" - Työkorotus eli korvaus, joka ansaitaan tiettynä aikana tehdystä työstä, esim. ilta- ja sunnuntailisä. "WorkRisePercentagePart" - Laskettu prosentti -tai minuuttikorotus per tunti työkorotukseen "WorkIncrement" - Työlisä, manuaalisesti merkitty korvaus esim. esimieslisä "WorkIncrementPercentagePart" - Laskettu prosenttiosa työlisästä, joka kerryttää kertymää jollain prosentilla "PublicHoliday" - Juhlapyhä, korvauksen määrä tulee siitä, kuinka paljon juhlapyhä lyhentää työviikkoa. "YearLeave" - Vuosiloma "WeeklyRestTime" - Viikkolepoaika "ProjectOverAllocation" - Projektille kirjatty aika joka ylittää tapahtuman keston "Accrual" - Kertymä, juokseva/kumulatiivinen arvo tietylle kertymälle esim. saldo ja pankki "AccrualChange" - Kertymän muutos edellisestä päivästä "MarkedTime" - Tapahtumalle kirjattu aika. EventStartTime- ja EventEndtime-kentät kuvaavat kirjauksen kellonajat. "Lunch" - Ruokatauko. Tämä kertoo, miten ruokatauko on laskennallisesti sijoitettu päivään.
AccrualType	enum\|null	Käytettävissä kertymien ja kertymien muutosten kanssa. Tuetut tyypit ovat: "Balance" - Saldo "Bank" - Pankki
Amount	decimal	Määrä, arvo sekunneissa (ellei ole kyse työlisästä tai matkakorvauksista, katso UnitType)
UnitType	enum\|null	"U" - yksiköitä "D" - desimaaliluku "S" - sekunteja "H" - tunteja "J" - päiviä "C" - valuutta
SalaryRenderingDate	date	Päivä, johon maksu/vuoro kuuluu. Formaatti: YYYY-MM-DD
StartDateTime	datetime	Alkupäivä ja -aika, milloin salary data on ansaittu (jos käytettävissä). Huom. Pitkät merkinnät, kuten sairauslomat jaetaan laskentapäiville. Formaatti: YYYY-MM-DD HH:MM:SS Aikavyöhyke: Käyttäjän paikallinen aikavyöhyke
EndDateTime	datetime	Loppupäivä ja -aika, milloin salary data on ansaittu (jos käytettävissä). Huom. Pitkät merkinnät, kuten sairauslomat jaetaan laskentapäiville. Formaatti: YYYY-MM-DD HH:MM:SS Aikavyöhyke: Käyttäjän paikallinen aikavyöhyke
EventStartDateTime	datetime	Alkupäivä ja -aika, milloin tulkittuun työaikaan liittyvä tapahtuma on merkitty kalenteriin (jos käytettävissä). Formaatti: YYYY-MM-DD HH:MM:SS Aikavyöhyke: Käyttäjän paikallinen aikavyöhyke
EventEndDateTime	datetime	Loppupäivä ja -aika, milloin tulkittuun työaikaan liittyvä tapahtuma on merkitty kalenteriin (jos käytettävissä). Formaatti: YYYY-MM-DD HH:MM:SS Aikavyöhyke: Käyttäjän paikallinen aikavyöhyke
CreatedDatetime	datetime\|null	Päivä ja aika, milloin tähän riviin liittyvä tapahtuma on luotu. Formaatti: YYYY-MM-DD HH:MM:SS Aikavyöhyke: Suomen aikavyöhyke
ModifiedDatetime	datetime\|null	Päivä ja aika, milloin riviin liittyvää tapahtumaa on viimeksi muokattu. Formaatti: YYYY-MM-DD HH:MM:SS Aikavyöhyke: Suomen aikavyöhyke
ActivityId	int\|null	Tapahtuman yksilöllinen tunniste Tapahtumattaulusta. Hyödyllinen, jos haluaa ryhmitellä aikoja, jotka tulevat samasta tapahtumasta, esim. vuosilomapalkka.
ActivityTypeCode	string\|null	Tapahtumatyypin koodi.
WorkRiseNumber	int\|null	Työkorotuksen numero asetuksissa
WorkRisePercentageIncrease	decimal(4,1)\|null	Prosentti, jota käytetään työkorotuksen keston laskentaan "WorkRisePercentagePart"-rivillä
WorkRiseMinutesPerHourIncrease	smallint\|null	Minuuttia/tunti-lisä, jota käytetään työkorotuksen keston laskentaan "WorkRisePercentagePart"-rivillä
WorkIncrementNumber	int\|null	Työlisän numero/indeksi asetuksissa
WorkIncrementTripNumber	int	Matkalaskun matkan juokseva numero tapahtumalla mihin työlisä liittyy. Jos työlisä ei liity matkaan, arvona on `null`
WorkIncrementPercentageIncrease	decimal(4,1)\|null	Prosentti, jota käytetään Työlisän keston laskentaan "WorkIncrementPercentagePart"-rivillä
WorkIncrementPercentageAccrualTarget	string\|null	Sisäinen nimi kertymälle, johon "work increment percentage part" kohdennetaan
WorkIncrementCode	string\|null	Työlisän palkkalajinumero, joka voidaan asettaa Työlisän asetuksissa (Työyhteisö- tai Asetusryhmätasolla)
WorkIncrementDate	date\|null	If the supplement has the date field enabled, the date will appear here (YYYY-MM-DD) Aikavyöhyke: Käyttäjän paikallinen aikavyöhyke
WorkIncrementComment	string\|null	If the supplement has the comment field enabled, the comments will appear here
WorkIncrementType	enum\|null	"normal" - Normal supplement type for normal event types "correction" - Supplements that only appear on Correction events "cafe" - Supplements that only appear in terminal cafeteria mode "expense" - Supplements that only as a travel invoice expense "allowance" - supplements that only appear as a travel invoice daily allowance "tripReimbursement" - supplements that only appear as a travel invoice trip/transportation reimbursement null - not a supplement
WorkRiseEarnedAtCompensationType	enum\|null	Suodattaa työkorotukset perustuen korvaustyyppiin (compensationtype), jolla se ansaittiin. Katso CompensationType-lista tuetuista arvoista
ProjectId1	int\|null	Tapahtumalla ensimmäisenä olevan projektin sisäinen tunniste. Sarake toistuu liitetylle projektille siten että ensimmäinen projekti on numerolla 1, toinen projekti numerolla 2 ja niin edelleen. Sarake esiintyy numeroille liitetyille projekteille 1-6.
ProjectExternalIdentifier1	string\|null	Tapahtumalla ensimmäisenä olevan projektin ulkoinen tunniste. Sarake toistuu liitetylle projektille siten että ensimmäinen projekti on numerolla 1, toinen projekti numerolla 2 ja niin edelleen. Sarake esiintyy numeroille liitetyille projekteille 1-6.
ProjectCode1	string\|null	Tapahtumalla ensimmäisenä olevan projektin koodi. Sarake toistuu liitetylle projektille siten että ensimmäinen projekti on numerolla 1, toinen projekti numerolla 2 ja niin edelleen. Sarake esiintyy numeroille liitetyille projekteille 1-6.
ProjectName1	string\|null	Tapahtumalla ensimmäisenä olevan projektin nimi. Sarake toistuu liitetylle projektille siten että ensimmäinen projekti on numerolla 1, toinen projekti numerolla 2 ja niin edelleen. Sarake esiintyy numeroille liitetyille projekteille 1-6.
ProjectType1	string\|null	Tapahtumalla ensimmäisenä olevan projektin sisäinen nimi projektin tyypille. Esimerkiksi: "toimipiste" (location), "projektityö" (project_work), and "yksikkö" (unit). Sarake toistuu liitetylle projektille siten että ensimmäinen projekti on numerolla 1, toinen projekti numerolla 2 ja niin edelleen. Sarake esiintyy numeroille liitetyille projekteille 1-6.
BasePartTarget	string\|null	Päivän pituuden ylittävä työ jaetaan ylityön perusosan kohdistukseen "BasePartTarget" sekä ylityöosan kohdistukseen "OvertimeTarget". BasePartTarget kertoo kuinka kirjauksen perusosa on kohdistettu. Esimerkiksi kun korvataan tunti-tunnista saldoon, niin korotusosaa ei korvata, jolloin korvattu aika sisältää kohdistukset BasePartTarget = 'balance' ja OvertimeTarget = 'uncompensated'. Tuetut valinnat ovat: "salary" - Kun perusosa on kohdistettu palkkaan "balance" - Kun perusosa on kohdistettu saldoon. "bank" - Kun perusosa on kohdistettu pankkiin. "overtimebalance" - Kun perusosa on kohdistettu ylityökertymään. "uncompensated" - Kun perusosaa ei korvata. "flexiblehours" - Kun peruosa on kohdistettu joustokertymään.
OvertimeTarget	string\|null	Päivän pituuden ylittävä työ jaetaan ylityön perusosan kohdistukseen "BasePartTarget" sekä ylityöosan kohdistukseen "OvertimeTarget". OvertimeTarget kertoo kuinka kirjauksen ylityöosa on kohdistettu. Esimerkiksi kun työ korvataan ylityönä niin OvertimeTarget saa muun arvon kuin NULL tai 'uncompensated'. Ylityönä pankkiin kohdistettu työ sisältäisi BasePartTarget = 'bank' ja OvertimeTarget = 'bank'. Tuetut valinnat ovat: "salary" - Kun ylityöosa on kohdistettu palkkaan. "balance" - Kun ylityöosa on kohdistettu saldoon. "bank" - Kun ylityöosa on kohdistettu pankkiin. "overtimebalance" - Kun ylityöosa on kohdistettu ylityökertymään. "uncompensated" - Kun korotusosaa ei korvata "flexiblehours" - Kun korotusosa on kohdistettu joustokertymään. NULL - Ylityöosaa ei ole. Arvoa käytetään kun työ on tehty säännöllisenä työaikana.
UserId	int	Henkilön palvelun sisäinen tunniste. Ei ole esillä käyttöliittymässä, ja aina kun mahdollista tulisi käyttää henkilön muita tunnisteita.
UserCostGroup	string	Henkilön oletuskustannuspaikka
EmployeeSalaryType	enum	"hourly" - tuntipalkka "monthly" - kuukausipalkka
EmployeeWorkContractActive	enum	Onko henkilö työsuhteessa kyseisenä päivänä "Y" - kyllä "N" - ei
EmployeeWorkContractStartDate	date	Työsuhteen alkupäivä, null, jos tyhjä. Muoto: YYYY-MM-DD
EmployeeWorkContractEndDate	date	Työsuhteen loppupäivä, null, jos tyhjä. Muoto: YYYY-MM-DD
Comment	string	Kommentti, rajattu 2000 merkkiin
IsTimeBorrowedFromBalance	enum	Jos työntekijä, jolla on käytössä saldopankki, ei ole töissä päivänä, jolloin hänellä on työvelvoite, työtunnit lainataan saldopankista "Y" - kyllä "N" - ei
IsTesOvertime	enum	Onko TES-ylityötä? "Y" - kyllä "N" - ei
IsEmergencyWork	enum	Onko hälytystyötä? "Y" - kyllä "N" - ei
IsApproved	enum	Onko tapahtuma hyväksytty? "Y" - kyllä "N" - ei
SickLeaveTypeId	int	Sairausloman syy 1 = sairas 2 = lapsi sairas 3 = työtapaturma 4 = tapaturma työmatkalla 5 = vapaa-ajan tapaturma
SickLeaveMedicalCertificateId	int	Lääkärintodistus 0 = ei tiedossa 1 = ei vastaanotettu 2 = vastaanotettu 3 = esimiehen hyväksyntä
AbsenceTypeId	int	Poissaolotyypin tunniste. NULL jos arvoa ei ole. Näkyy asetuksissa taulukossa Työtunnit->Käytössä olevat poissaolotyypit
EarnsVacationDays	enum	Ansaitaanko tapahtumasta vuosilomapäiviä. Tulee joko vuosiloman asetuksista tai tapahtumalle kirjatusta tiedosta. "Y" - kyllä "N" - ei Arvona voi myös olla `null` jos tieto ei ole relevantti työaikatiedolle.
FromRounding	enum	"Y" = Time has been created due to rounding "N" = Time has not been created due to rounding
OverlapsUnderlyingActivityTypeIds	CSV	Pilkuilla erotettu lista tapahtumatyyppien koodeista, jotka ovat päällekkäin leimauksen kanssa. Nämä ovat tarkoituksella asetettu jäämän toisen leimauksen alle, esim. varallaolo. Nämä tulee käsitellä WHERE-lauseissa alla olevalla tavalla. WHERE overlapsunderlyingactivitytypeids LIKE '%,33,%'
AdjacencyGroupingId	int	Yksilöllinen tunniste keskeytymättömille jaksoille, jotka tulkitaan yhdeksi työjaksoksi. Useampikin tapahtuma ryhmitellään samalle jaksolle, jos tulkittu palkanmaksu ei keskeydy. Ryhmittelemällä tulokset tämän kentän mukaan saat maksetut jaksot pitkille leimauksille, katkottuna välissä olevilla päivillä, joita ei makseta. Esimerkiksi poissaolo-merkintä 2. - 22.5.2016: 2. - 4.5.2016 - Poissaolo maanantaista keskiviikkoon 6.5.2016 - Poissaolo perjantaina (helatorstai 5.5.2016) 9. - 13.5.2016 - Poissaolo maanantaista perjantaihin 16. - 20.5.2016 - Poissaolo maanantaista perjantaihin

UserEventData, UserEventHistoryData

Kentän nimi	Tyyppi	Kuvaus
ActivityId	int	Tapahtuman yksilöllinen tunniste Tapahtumattaulusta. Hyödyllinen, jos haluaa ryhmitellä aikoja, jotka tulevat samasta tapahtumasta, esim. vuosilomapalkka. ActivityId pysyy muuttumattomana jos tapahtumaa muokataan.
ActivityTypeCode	string	Tapahtumatyypin koodi, käytössä ainoastaan asiakaskohtaisissa tapahtumatyypeissä.
BasePartTarget	string	Päivän pituuden ylittävä työ jaetaan ylityön perusosan kohdistukseen "BasePartTarget" sekä ylityöosan kohdistukseen "OvertimeTarget". BasePartTarget kertoo kuinka kirjauksen perusosa on kohdistettu. Esimerkiksi kun korvataan tunti-tunnista saldoon, niin korotusosaa ei korvata, jolloin korvattu aika sisältää kohdistukset BasePartTarget = 'balance' ja OvertimeTarget = 'uncompensated'. Tuetut valinnat ovat: "salary" - Kun perusosa on kohdistettu palkkaan "balance" - Kun perusosa on kohdistettu saldoon. "bank" - Kun perusosa on kohdistettu pankkiin. "overtimebalance" - Kun perusosa on kohdistettu ylityökertymään. "uncompensated" - Kun perusosaa ei korvata. "flexiblehours" - Kun peruosa on kohdistettu joustokertymään.
OvertimeTarget	string	Päivän pituuden ylittävä työ jaetaan ylityön perusosan kohdistukseen "BasePartTarget" sekä ylityöosan kohdistukseen "OvertimeTarget". OvertimeTarget kertoo kuinka kirjauksen ylityöosa on kohdistettu. Esimerkiksi kun työ korvataan ylityönä niin OvertimeTarget saa muun arvon kuin NULL tai 'uncompensated'. Ylityönä pankkiin kohdistettu työ sisältäisi BasePartTarget = 'bank' ja OvertimeTarget = 'bank'. Tuetut valinnat ovat: "salary" - Kun ylityöosa on kohdistettu palkkaan. "balance" - Kun ylityöosa on kohdistettu saldoon. "bank" - Kun ylityöosa on kohdistettu pankkiin. "overtimebalance" - Kun ylityöosa on kohdistettu ylityökertymään. "uncompensated" - Kun korotusosaa ei korvata "flexiblehours" - Kun korotusosa on kohdistettu joustokertymään. NULL - Ylityöosaa ei ole. Arvoa käytetään kun työ on tehty säännöllisenä työaikana.
AccrualType	enum	Käytössä kertymän Muutos- ja Asetustapahtumilla. Tuetut tyypit ovat: "Annualabsence" - Vuosivapaa "Balance" - Saldo "Bank" - Pankki "Flexiblehours" - Jousto "Flexibleworkhours" - Joustotyötunnit "Levellingperiodhours" - Tasoittumisjaksotunnit "Worktimeshorteningleave" - Työajan lyhennysvapaa "YearLeave" - Vuosiloma
Amount	decimal	Määrä sekunteina
UnitType	enum	"U" - yksiköitä "D" - desimaaliluku "S" - sekunteja "H" - tunteja "J" - päiviä "C" - valuutta
StartDatetime	datetime	Päivä ja aika, jolloin tapahtuma alkaa. Formaatti: YYYY-MM-DD HH:MM:SS Aikavyöhyke: Käyttäjän paikallinen aikavyöhyke
EndDatetime	datetime	Päivä ja aika, jolloin tapahtuma loppuu. Formaatti: YYYY-MM-DD HH:MM:SS Aikavyöhyke: Käyttäjän paikallinen aikavyöhyke
CreatedDatetime	datetime	Päivä ja aika, jolloin tapahtuma on luotu. Muoto: YYYY-MM-DD HH:MM:SS Aikavyöhyke: Suomen aikavyöhyke
ModifiedDatetime	datetime	Päivä ja aika, jolloin tapahtumaa on viimeksi muokattu. Huom! UserEventHistoryData-taulussa, jos kyseessä on muokatun tapahtuman aiempi versio, ModifiedDatetime osoittaa muokkausajan, jolloin kyseinen versio on luotu. Muoto: YYYY-MM-DD HH:MM:SS Aikavyöhyke: Suomen aikavyöhyke
ProjectId1	int	Tapahtumalla ensimmäisenä olevan projektin sisäinen tunniste
ProjectCode1	string	Tapahtumalla ensimmäisenä olevan projektin koodi
ProjectExternalIdentifier1	string	Tapahtumalla ensimmäisenä olevan projektin ulkoinen tunniste
ProjectName1	string	Tapahtumalla ensimmäisenä olevan projektin nimi
ProjectType1	string	Tapahtumalla ensimmäisenä olevan projektin sisäinen nimi projektin tyypille. Esimerkiksi "toimipiste" (location), "projektityö" (project_work), tai "yksikkö" (unit).
UserId	int	Henkilön palvelun sisäinen tunniste. Ei ole esillä käyttöliittymässä, ja aina kun mahdollista tulisi käyttää henkilön muita tunnisteita.
ApprovedByUserId	int	Tapahtuman hyväksyneen henkilön sisäinen tunniste.
UserCostGroup	string	Henkilön kalleusluokka
EmployeeSalaryType	enum	Henkilön palkkaustyyppi "hourly" - tuntipalkka "monthly" - kuukausipalkka
EmployeeWorkContractActive	enum	Onko henkilöllä voimassaoleva työsopimus käsiteltävänä päivänä. "Y" - kyllä "N" - ei
EmployeeWorkContractStartDate	date	Työsuhteen alkupäivä, null, jos tyhjä. Muoto: YYYY-MM-DD
EmployeeWorkContractEndDate	date	Työsuhteen loppupäivä, null, jos tyhjä. Muoto: YYYY-MM-DD
Comment	string	Kommentti, rajattu 2000 merkkiin
IsApproved	enum	Onko tapahtuma hyväksytty? "Y" - kyllä "N" - ei
IsEmergencyWork	enum	Onko hälytystyötä? "Y" kyllä "N" ei
SickLeaveCompensationTypeId	int	Sairausloman palkallisuus 1 = palkallinen 2 = palkaton 3 = vähennetty palkka
SickLeaveTypeId	int	Sairausloman syy 1 = sairas 2 = lapsi sairas 3 = työtapaturma 4 = tapaturma työmatkalla 5 = vapaa-ajan tapaturma
SickLeaveMedicalCertificateId	int	Lääkärintodistus 0 = ei tiedossa 1 = ei vastaanotettu 2 = vastaanotettu 3 = esimiehen hyväksyntä
AbsenceCompensationTypeId	int	Poissaolon palkallisuus 1 = palkallinen 2 = palkaton 3 = vähennetty palkka
AbsenceTypeId	int	Poissaolotyypin tunniste, voi olla myös asiakaskohtaisesti määritetty. Näkyy asetuksissa taulukossa Työtunnit->Käytössä olevat poissaolotyypit
EarnsVacationDays	enum	Ansaitaanko tapahtumasta vuosilomapäiviä. Tulee joko vuosiloman asetuksista tai tapahtumalle kirjatusta tiedosta. "Y" - kyllä "N" - ei
TravelBeginDateTime	datetime	Matkan alkamispäivä Formatti: YYYY-MM-DD HH:MM:SS Aikavyöhyke: Käyttäjän vakituinen aikavyöhyke
TravelEndDateTime	datetime	Matkan päättymispäivä Formatti: YYYY-MM-DD HH:MM:SS Aikavyöhyke: Käyttäjän vakituinen aikavyöhyke
IsActive	string	Käytössä vain UserEventHistoryData-taulussa. Y = Tapahtuma on aktiivinen N = Tapahtuma on poistettu tai muokatun tapahtuman aiempi versio. Jos tapahtuma on muokatun tapahtuman aiempi versio, sille on asetettu OriginalActivityId.
OriginalActivityId	int\|null	Käytössä vain UserEventHistoryData-taulussa. Sisäinen tunniste muokatulle tapahtumalle, josta tämä tapahtuma on aiempi versio. Tapahtuman OriginalActivityId on sama kuin sen viimeisimmän version ActivityId. Jos OriginalActivityId on `null`, on kyseessä tapahtuman viimeisin versio.

UserEventProjectData

Kentän nimi	Tyyppi	Kuvaus
Id	int	Internal ID for the event to project relation. Can be used for joining with UserSalaryData.eventprojectrowidX
ActivityId	int	Internal ID for the event/activity that the project recording is attached to
ProjectId	int	Internal ID for the Project information. Can be joined with ProjectData.id
ProjectDurationMarked	string	This is not the calculated project duration (see UserSalaryData) but the time as recorded by the user either as a percentage or time value in minutes.
ApprovedByUserId	int	Internal ID of the user that approved the project recording. Not to be confused with the event approval, project recording level approval is typically performed by project managers using the project approval tool.
InternalNotes	string	Notes that have been added to the "internal notes" field
PublicNotes	string	Notes that have been added to the "public notes" field

UserTravelExpenseTripData

Kentän nimi	Tyyppi	Kuvaus
ActivityId	int	Tapahtuman yksilöllinen tunniste Tapahtumataulusta.
TripNumber	int	Matkan juokseva numero tapahtumalla.
TransportationMethodId	int	Käytetyn matkustusmuodon tunnus. Voi sisältää seuraavat arvot: 1 - auto 2 - lentokone 3 - laiva 4 - julkinen liikenne 5 - muu
StartDateTime	datetime	Matkan lähtöpäivä ja -aika. Muoto `YYYY-MM-DD HH:MM:SS`
StartTimeZone	string	Matkan lähtöajan aikavyöhyke. Esimerkiksi `Europe/Helsinki`
EndDateTime	datetime	Matkan päättymispäivä ja -aika. Muoto `YYYY-MM-DD HH:MM:SS`
EndTimeZone	string	Matkan päättymisajan aikavyöhyke. Esimerkiksi `Europe/Helsinki`
StartLocation	string	Lähtöpaikan osoite
StartRegion	string	Lähtöpaikan maa
EndLocation	string	Kohdepaikan osoite
EndRegion	string	Kohdepaikan maa
ReasonForTrip	string	Matkan tarkoitus

UserData

Kentän nimi	Tyyppi	Kuvaus
UserId	int	Henkilön palvelun sisäinen tunniste. Ei ole esillä käyttöliittymässä, ja aina kun mahdollista tulisi käyttää henkilön muita tunnisteita.
UserIntegrationId	string	Henkilön liittymässä yksilöivä tunniste. Muodostuu valitun liittymän mukaisesti. Voi olla jokin seuraavista: Tiettyä integraatiota varten asetettu tunniste Henkilönumero Henkilötunnus
FirstName	string	Henkilön etunimi
LastName	string	Henkilön sukunimi
DefaultProjectId1	int	Henkilön oletusprojektin sisäinen tunniste
DefaultProjectCode1	string	Henkilön oletusprojektin koodi
DefaultProjectType1	string	Henkilön oletusprojektin sisäinen nimi projektin tyypille. Esimerkiksi "toimipiste" (location), "projektityö" (project_work), tai "yksikkö" (unit).
DefaultCostGroup	string	Henkilön kalleusluokka
UserGroupCode	string	Henkilön henkilöryhmän koodi
RootGroupCode	string	Juuritason henkilöryhmän koodi, mihin henkilön henkilöryhmä kuuluu.

UserInfoData

Kentän nimi	Tyyppi	Kuvaus
UserId	int	Henkilön tuniste User-taulusta
InfoTypeName	string	Henkilötiedon tunniste. Taulu sisältää henkilölle luodut lisätietokentät. Arvo voi esimerkiksi olla: AdministrativeAdditionalInfo AdditionalReportingInfo BIC City DefaultCostGroupCode DefaultProjectId DefaultProjectCode_SDSQL DefaultProjectName_SDSQL Email EventsLockedDate FinnishTaxNumber Firstname IBAN IntegrationIdAastra IntegrationIdAboa IntegrationIdDLSoftware IntegrationIdEmce IntegrationIdFivaldi IntegrationIdHogia IntegrationIdIFS IntegrationIdKieku IntegrationIdLessor5 IntegrationIdLiksa IntegrationIdMepco IntegrationIdOscar IntegrationIdPersonecF IntegrationIdPersonecW IntegrationIdProCountor IntegrationIdScala IntegrationIdSedab IntegrationIdSonet IntegrationIdTikon IntegrationIdVisma IntegrationIdElisaRing IsSalaryAdvanceAllowed JobTitle Language LastWorkingContractBeginDate LastWorkingContractEndDate LastWorkingContractEndReason LastWorkingContractHourlyWage LastWorkingContractWeeklyHours MicrosoftAxHourlyCost NextOfKinName NextOfKinTel PersonnelNumber Postcode PhoneNumber RFIDTagNumber Role RootUserGroupCode_SDSQL RootUserGroupId_SDSQL RootUserGroupName_SDSQL SettingGroupCode_SDSQL SettingGroupId_SDSQL SettingGroupName_SDSQL SocialSecurityNumber StreetAddress Surname TrialPeriodEndDate UserGroupCode_SDSQL UserGroupId_SDSQL UserGroupName_SDSQL Username WebPageURL WorkArea
InfoTypeId	int	Henkilötiedon tyypin sisäinen tunnus. Ainoastaan informatiivisiin tarkoituksiin. Saattavat muuttua ja ovat subjektiivisia.
ValidFrom	datetime	Päivä ja aika, mistä lähtien henkilötieto on voimassa. Jos henkilötiedolle ei ole asetettu voimassaolon alkupäivää, arvona on 1970-01-01 00:00:00 Formaatti: `YYYY-MM-DD HH:MM:SS`
ValidTo	datetime	Päivä ja aika, mihin asti henkilötieto on voimassa. Jos henkilötiedolle ei ole asetettu voimassaolon päättymispäivää, arvona on 2999-12-31 23:59:59 Formaatti: `YYYY-MM-DD HH:MM:SS`
Value	string	Kentän arvo merkkijonona. Tieto esitetään tietokentän tyypin perusteella seuraavassa muodossa: Boolean (valintaruutu) - True / False Date - `YYYY-MM-DD` Datetime - `YYYY-MM-DD HH:MM:SS`

PersonGroupData

Kentän nimi	Tyyppi	Kuvaus
Id	int	Neptonin sisäinen henkilöryhmän tunniste
Name	merkkijono	Henkilöryhmän nimi
Code	merkkijono	Henkilöryhmän koodi
Description	merkkijono	Henkilöryhmän kuvaus
ParentId	kokonaisluku	Yläryhmän Neptonin sisäinen tunnista. Jos henkilöryhmällä ei ole yläryhmää, arvona on `null`
IsRoot	merkki	Onko henkilöryhmä juuritason ryhmä, eli ryhmä jolla ei ole yläryhmää. `Y` - kyllä `N` - ei
Depth	kokonaisluku	Numeerinen arvo siitä, kuinka syvällä henkilöryhmä on puurakenteessa. Esimerkiksi: `0` - juuritason ryhmä `1` - juuritason ryhmän alaryhmä `2` - edellisen tason alaryhmä jne.

ProjectData

Kentän nimi	Tyyppi	Kuvaus
Id	int	Neptonin sisäinen projektin tunniste
ExternalId	kokonaisluku	Projektille annettu ulkoinen tunniste. Lue lisää ulkoisesta tunnisteesta täällä.
Name	merkkijono	Projektin nimi projektin tiedot -sivulla
Code	merkkijono	Projektin koodi projektin tiedot -sivulla
Description	merkkijono	Projektin kuvaus projektin tiedot -sivulla
ParentId	kokonaisluku	Yläprojektin Neptonin sisäinen tunnista. Jos projektilla ei ole yläprojektia, arvona on `null`
StartDate	päivämäärä	Projektin alkamispäivä projektin tiedot -sivulla. Muotona `YYYY-MM-DD`
EndDate	päivämäärä	Projektin päättymispäivä projektin tiedot -sivulla. Muotona `YYYY-MM-DD`
TypeInternalName	merkkijono	Projektityypin sisäinen nimi. Lue lisää projektityypeistä täällä.
IsLeaf	merkki	Onko projekti ns. lehtisolmu (leaf node), eli projekti jolla ei ole alaprojekteja. `Y` - kyllä `N` - ei
IsRoot	merkki	Onko projekti juuritason projekti, eli projekti jolla ei ole yläprojektia. `Y` - kyllä `N` - ei
IsAssignedProject	merkki	Onko projekti tapahtumalle kirjattu projekti. `Y` - kyllä `N` - ei Arvona on kyllä jos projekti on suoraan tapahtumalle kirjattu projekti. Arvona on ei jos projekti on tapahtumalle kirjatun projektin yläprojekti.
Depth	kokonaisluku	Numeerinen arvo siitä, kuinka syvällä projekti on puurakenteessa. Esimerkiksi: `0` - juuritason projekti `1` - juuritason projektin alaprojekti `2` - edellisen tason alaprojekti jne.