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.
|
AccrualType | enum|null |
Käytettävissä kertymien ja kertymien muutosten kanssa. Tuetut tyypit ovat:
|
Amount | decimal | Määrä, arvo sekunneissa (ellei ole kyse työlisästä tai matkakorvauksista, katso UnitType) |
UnitType | enum|null |
|
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. |
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 |
|
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:
|
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:
|
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 |
|
EmployeeWorkContractActive | enum |
Onko henkilö työsuhteessa kyseisenä päivänä
|
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
|
IsTesOvertime | enum |
Onko TES-ylityötä?
|
IsEmergencyWork | enum |
Onko hälytystyötä?
|
IsApproved | enum |
Onko tapahtuma hyväksytty?
|
SickLeaveTypeId | int |
Sairausloman syy
|
SickLeaveMedicalCertificateId | int |
Lääkärintodistus
|
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.
Arvona voi myös olla |
FromRounding | enum |
|
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:
|
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:
|
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:
|
AccrualType | enum |
Käytössä kertymän Muutos- ja Asetustapahtumilla. Tuetut tyypit ovat:
|
Amount | decimal | Määrä sekunteina |
UnitType | enum |
|
StartDatetime | datetime |
Päivä ja aika, jolloin tapahtuma alkaa. Formaatti: YYYY-MM-DD HH:MM:SS |
EndDatetime | datetime |
Päivä ja aika, jolloin tapahtuma loppuu. Formaatti: YYYY-MM-DD HH:MM:SS |
CreatedDatetime | datetime |
Päivä ja aika, jolloin tapahtuma on luotu. Muoto: YYYY-MM-DD HH:MM:SS |
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 |
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
|
EmployeeWorkContractActive | enum |
Onko henkilöllä voimassaoleva työsopimus käsiteltävänä päivänä.
|
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?
|
IsEmergencyWork | enum |
Onko hälytystyötä?
|
SickLeaveCompensationTypeId | int |
Sairausloman palkallisuus
|
SickLeaveTypeId | int |
Sairausloman syy
|
SickLeaveMedicalCertificateId | int |
Lääkärintodistus
|
AbsenceCompensationTypeId | int |
Poissaolon palkallisuus
|
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.
|
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.
|
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 |
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:
|
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:
|
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:
|
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: |
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: |
Value | string |
Kentän arvo merkkijonona. Tieto esitetään tietokentän tyypin perusteella seuraavassa muodossa:
|
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ää.
|
Depth | kokonaisluku |
Numeerinen arvo siitä, kuinka syvällä henkilöryhmä on puurakenteessa. Esimerkiksi:
|
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.
|
IsRoot | merkki |
Onko projekti juuritason projekti, eli projekti jolla ei ole yläprojektia.
|
IsAssignedProject | merkki |
Onko projekti tapahtumalle kirjattu projekti.
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:
|