English (GB)
Palvelun tila: -
  1. Nepton
  2. Tuki
  3. Liittymät
  4. Sääntöjoukot

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

  • Päivitetty

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 valittu 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ä.

Asetusryhmän ylätasolla määritetty sääntö on mahdollista korvata asettamalla aliryhmään toinen sääntö. Asetusryhmien selkeyden vuoksi emme suosittele tätä vaihtoehtoa. Ylätasolle muodostettava sääntö voi jo poissulkea tiedon poiminnan alaryhmässä. Tällöin käyttöympäristöön ei muodosteta alaryhmiin poikkeuksia, vaan kaikkia sääntöjoukon sääntöjä voidaan hallita yhtenä listana. Esimerkiksi jos tietyn palkkalajin muodostuminen halutaan estää alaryhmässä niin yläryhmän sääntöön voidaan määritellä poissulkeva ehto alla olevan esimerkin mukaisesti. Tällöin sääntöjoukkoa tarkastelemalla nähdään aineiston muodostumisen periaatteet kokonaisuudessaan, eikä määrittelyä ole jaettu usean asetusryhmän asetuksiin.

Esimerkki, jossa kysely kohdistetaan UserSalaryData-tauluun ja tuloksista jätetään pois henkilöt jotka kuuluvat asetusryhmään jonka koodi on "tuntipalkkaiset urakkamiehet":

SELECT ...,
IFNULL(
  (
    SELECT ui.Value FROM UserInfoData ui
    WHERE ui.InfoTypeName = 'SettingGroupCode_SDSQL' AND
    datetime(UserSalaryData.SalaryRenderingDate) BETWEEN ui.ValidFrom AND ui.ValidTo
    LIMIT 1
  ),
  ''
) AS _SettingGroupCode
FROM UserSalaryData
WHERE _SettingGroupCode NOT IN ('tuntipalkkaiset urakkamiehet')

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ä siirretää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 kommenttikentä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ä.

Ero UserEventData- ja UserSalaryData-taulujen ajan määrässä

Kun tapahtuma merkitään palveluun, merkitty aika on taulussa UserEventData ja merkitystä ajasta muodostettu tulkittu data on taulussa UserSalaryData. Molemmissa tauluissa on kenttä MarkedTime, mutta niiden arvot voivat poiketa toisistaan riippuen siitä, onko tapahtuma tehty reaaliaikaisena eli ns. kellotettuna vai ei.

Reaaliaikasesti merkityn tapahtuman alku- ja loppuajassa on mukana myös sekuntiosuus, esim. alku 08:02:57 ja loppu 16:13:12. Vastaava merkintä ei-reaaliaikaisena olisi alku 08:02:00 ja loppu 16:13:00. UserEventData-taulussa olisi määrä (Amount) 08h10min15sek, UserSalaryData-taulussa määrä olisi 08h11min00sek eli 45 sekuntia enemmän. Tällä on harvoin merkitystä, mutta jos tietoja poimitaan molemmista tauluista, niin saattaa olla tarve saada sama määrä riippumatta tapahtuman merkintätavasta.

Alla olevalla esimerkillä saadaan UserEventData-taulusta poimittua sama määrä kuin UserSalaryData-taulusta riippumatta tapahtuman merkintätavasta.

CAST(strftime('%s', strftime('%Y-%m-%d %H:%M:00', EndDateTime)) AS INT)
- CAST(strftime('%s', strftime('%Y-%m-%d %H:%M:00', StartDateTime)) AS INT)

Ajat ja aikavyöhykkeet

Tapahtumien ja palkkatietojen alku- ja päättymisajat tallennetaan ja noudetaan "kuten ne on kirjattu" eli käyttäjän tarkoituksen mukaisesti. On tärkeää huomata, että emme välttämättä tiedä aikavyöhykettä, jolla aika on tallennettu, ellei tätä tietoa ole määritelty palveluun.

Esimerkkejä löydät ohjeesta Aikavyöhykkeet ja tapahtumien luonti.

On myös tärkeää huomata, että integroinnin sääntöjoukon kysely käyttää SQLitea, jonka päivämäärä- ja aika-avustajat käyttävät oletusarvoisesti UTC-aikastandardia.

Tästä seuraa, että jos käytät kyselyssä käsitettä 'nyt' tai CURRENT_TIMESTAMP hakeaksesi nykyisen ajan ja sen muodon, se näytetään 2-3 tuntia todellisesta ajasta jäljessä (olettaen, että olet Suomen aikavyöhykeellä ja riippuen siitä, vaikuttaako kesäaika).

Tässä on esimerkki mahdollisesti ongelmallisesta kyselystä, joka palauttaa tiedot vain kuun 1. päivänä:

SELECT * FROM UserEventData WHERE strftime('%d', 'now') = '01'

Koska strftimelle ei anneta aikavyöhyketietoja, se käyttää UTC-aikaa ja sen jälkeen kysely ei palauta tuloksia, jos se suoritetaan 00:00 ja 02:00 välillä 1. päivänä (Suomessa). Voimme tarjota palvelun paikallisen aikavyöhykkeen tämän odottamattoman toiminnan korjaamiseksi mm:

SELECT * FROM UserEventData WHERE strftime('%d', 'now', 'localtime') = '01'

Lisätietoja UTC:stä ja aikavyöhykkeistä SQLitessa löytyy SQLiten omasta dokumentaatiosta.

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 * FROM UserSalaryData
WHERE CompensationType = 'BasicTime' AND ActivityTypeCode = 'YÖ'

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

Uusia tietotyyppejä saatetaan lisätä myöhemmin

Joihinkin tietokantatauluihin saatetaan lisätä rivejä ja uusia tietotyyppejä järjestelmän päivityksissä. Mikäli kyselyssä rajataan tietoja jonkin tyypin perusteella, kannattaa rajaus tehdä niin, ettei kysely ala jonkin päivityksen jälkeen poimimaan myös uusia tietotyyppejä. 

Esimerkiksi seuraavissa kahdessa lausekkeessa on riskinä, että se poimii mukaan myös jonkin myöhemmin lisätyn työaikatulkinnan.

SELECT * FROM UserSalaryData WHERE CompensationType != 'BasicTime';

SELECT * FROM UserSalaryData WHERE CompensationType NOT IN ('PublicHoliday', 'MarkedTime');

 

Tietokantataulujen sisältö

Alla on kuvattuna tietokantataulut, joiden sisältöä voi poimia siirtoihin.

Tietokantataulun nimi Kuvaus Tuettu asetusarvojen poikkeuksissa
UserSalaryData

Taulu sisältää henkilön tulkitun työaikatiedon voimassa olevien 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ä, pois lukien ne asetukset joilla määritetään työvuorokauden ajoittuminen.

Tämän lisäksi UserCostGroup-tieto ei ole käytettävissä. Tieto löytyy UserInfoData-taulusta.
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ä, pois lukien ne asetukset joilla määritetään työvuorokauden ajoittuminen.

Tämän lisäksi UserCostGroup-tieto ei ole käytettävissä. Tieto löytyy UserInfoData-taulusta.
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
UserEventExternalIdentifierData Taulu sisältää tapahtumien ulkoisten tunnisteiden tiedot.

Kyllä, pois lukien ne asetukset joilla määritetään työvuorokauden ajoittuminen.
UserData Taulu sisältää voimassa olevat henkilö- sekä työsuhdetiedot. Voidaan yhdistää kyselyihin UserSalaryData- sekä UserEventData-tauluista. Kyllä
UserInfoData

Taulu sisältää henkilö- ja työsuhdetietoja historia-arvoineen. Voidaan yhdistää kyselyihin UserSalaryData- sekä UserEventData-tauluista

Lista saatavilla olevista tiedoista:

  • AdministrativeAdditionalInfo
  • AdditionalReportingInfo
  • BIC
  • City
  • DefaultCostGroupCode
  • DefaultProjectId
  • DefaultProjectCode_SDSQL
  • DefaultProjectName_SDSQL
  • Email
  • EventsLockedDate
  • FinnishTaxNumber
  • Firstname
  • IBAN
  • IntegrationIdAastra
  • IntegrationIdDLSoftware
  • IntegrationIdEmce
  • IntegrationIdFivaldi
  • IntegrationIdHeeros
  • 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
  • NeptonPaymentGroupIdentifier
  • NeptonPaymentGroupCode_SDSQL
  • NeptonPaymentGroupId_SDSQL
  • NeptonPaymentGroupName_SDSQL
  • 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

Myös yrityksen omat lisätietokentät ovat oletuksena saatavilla tiedoissa.

Kyllä, lukuunottamatta arkaluontoisia tietoja:

  • RFIDTagNumber
  • SocialSecurityNumber
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ä
PaymentGroupDateData Sisältää maksuryhmien maksukausien tiedot henkilöille, jotka ovat aineistossa. Kyllä

UserSalaryData

Kentän nimi Tyyppi Kuvaus
CompensationType enum

Käytettävissä ainoastaan SalaryData-taulun dataan.

  • "BasicTime" - Tehty säännöllinen työaika sekä tunti-tunnista korvatta 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 ansaitaan sää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 TES:ejä.
  • "OvertimeExtraFixed" - Ylityö 2, käytetään osassa pohjoismaissa käytössä olevia TES:ejä.
  • "TESOvertime50" - Osassa TES:ejä käytettävä TES:n mukainen ylityö, joka ansaitaan erillisenä viikottaisesta ylityöstä. Muodostuu vain, kun asetus 'Viikottaisesta ylityöstä erillisenä ansaittu TES:n mukainen ylityö' on käytössä; muuten TES:n mukainen ylityö on normaalia ylityötä, jolle on merkitty IsTesOvertime-arvoksi "Y".
  • "TESOvertime100" - Osassa TES:ejä käytettävä TES:n mukainen ylityö, joka ansaitaan erillisenä viikottaisesta ylityöstä. Muodostuu vain, kun asetus 'Viikottaisesta ylityöstä erillisenä ansaittu TES:n mukainen ylityö' on käytössä; muuten TES:n mukainen ylityö on normaalia ylityötä, jolle on merkitty IsTesOvertime-arvoksi "Y".
  • "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 kirjattu 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. Seuraavista tapahtumista ei muodosteta tätä tietoa:
    • Juhlapyhätapahtumat
    • Kertymien, kuten työaikasaldo tai vuosiloma, muutos- ja asetustapahtumat
  • "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 kaikissa muissa kuin kokonaisluvuissa. Kokonaisluvuissa arvo esitetään kokonaislukuna (katso UnitType)
UnitType enum|null
  • "U" - kokonaisluku
  • "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 Tapahtumat-taulusta. Hyödyllinen, jos haluaa ryhmitellä aikoja, jotka tulevat samasta tapahtumasta, esim. vuosilomapalkka.
ActivityTypeCode string|null Tapahtumatyypin koodi.
WorkRiseNumber int|null Työkorotuksen numero asetuksissa
WorkRiseSalaryCode string|null Työkorotuksen palkkakoodi 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 perusosa 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 poissaolomerkintä 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ä voimassa oleva 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
IsRequestType enum

Onko tapahtuma tyyppiä, joka vaatii esimiehen hyväksynnän etukäteen?

  • "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 Järjestelmän sisäinen tunniste tapahtuman ja projektin välisestä suhteesta. Voidaan liittää kyselyyn parametrillä UserSalaryData.eventprojectrowidX
ActivityId int Järjestelmän sisäinen tunniste tapahtumalle johon projektimerkintä on liitetty.
ProjectId int Järjstelmän sisäinen tunniste projektitiedolle. Voidaan liittää kyselyparametrillä ProjectData.id
ProjectDurationMarked string Projektille tallennettu kesto joko prosentteina tai aika-arvona kuten henkilö on projektin keston merkinnyt tapahtumalle. Eri asia kuin laskettu projektin kesto (katso UserSalaryData) 
ApprovedByUserId int Projektimerkinnän hyväksyneen henkilön järjestelmän sisäinen tunniste. Tätä ei tule sekoittaa tapahtuman hyväksymiseen, projektitason hyväksynnät tehdään usein projektijohtajien toimesta Projektituntien hyväksyntä -työkalulla.
InternalNotes string Projektimerkinnän sisäinen huomautus
PublicNotes string Projektimerkinnän ulkoinen huomautus

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

UserEventExternalIdentifierData

Kentän nimi Tyyppi Kuvaus
ActivityId int Tapahtuman yksilöllinen tunniste Tapahtumataulusta.
ExternalIdentifier string Tapahtuman ulkoinen tunniste
IdentifierType string Ulkoisen tunnisteen tyyppi. Tällä hetkellä ainoa tuettu tyyppi on External

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 palvelun sisäinen tunniste. Ei ole esillä käyttöliittymässä, ja aina kun mahdollista tulisi käyttää henkilön muita tunnisteita.
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
  • IntegrationIdDLSoftware
  • IntegrationIdEmce
  • IntegrationIdFivaldi
  • IntegrationIdHeeros
  • 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
  • NeptonPaymentGroupIdentifier
  • NeptonPaymentGroupCode_SDSQL
  • NeptonPaymentGroupId_SDSQL
  • NeptonPaymentGroupName_SDSQL
  • 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. Tätä tietoa ei tule käyttää tunnisteena tiedon hyödyntämisessä, sillä se voi muuttua.

 
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

UserGroupData

Kentän nimi Tyyppi Kuvaus
Id kokonaisluku 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 kokonaisluku 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.

PaymentGroupDateData

Kentän nimi Tyyppi Kuvaus
Id kokonaisluku Neptonin sisäinen maksuryhmän maksukauden tunniste
NeptonPaymentGroupDateIdentifier merkkijono Neptonin maksuryhmän maksukauden tunniste
PaymentGroupId kokonaisluku Neptonin sisäinen maksuryhmän tunniste johon maksuryhmän maksukausi liittyy
NeptonPaymentGroupIdentifier merkkijono Neptonin maksuryhmän tunniste johon maksuryhmän maksukausi liittyy
PaymentPeriodStartDate päivämäärä Maksuryhmän maksukauden alkupäivä
PaymentPeriodEndDate päivämäärä Maksuryhmän maksukauden loppupäivä
PaymentDate päivämäärä Maksuryhmän maksukauden maksupäivä
ValueDate päivämäärä Maksuryhmän maksukauden arvopäivä