--- title: Aikapäiväkirjat description: "#### Skyplannerin tietorakenne Ennen kuin syvennymme aikapäiväkirjoihin, meidän on keskusteltava hieman Skyplannerin tietorakenteesta ja siitä, miten asiat toimivat konepellin alla. Kaikki tämä tulee esiin myöhemmin. Jos olet integroinut tilaus-, työmääräys- tai työpaikkatietosi Skyplanneriin, olet todennäköisesti käyttänyt ainakin näitä API-päätteitä: -…" url: "https://skyplanner.ai/fi/docs/aikapaivakirjat/" updated: "2025-10-07" category: Integraatiot tags: - API - Integrointi --- # Aikapäiväkirjat #### Skyplannerin tietorakenne Ennen kuin syvennymme aikapäiväkirjoihin, meidän on keskusteltava hieman Skyplannerin tietorakenteesta ja siitä, miten asiat toimivat konepellin alla. Kaikki tämä tulee esiin myöhemmin. Jos olet integroinut tilaus-, työmääräys- tai työpaikkatietosi Skyplanneriin, olet todennäköisesti käyttänyt ainakin näitä API-päätteitä: - phaser-orders - phaser-order-rows - phaser-jobs Näihin päätepisteisiin syötetyt tiedot esitetään Skyplannerin käyttöliittymässä seuraavasti: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-25-1024x714.png) **Kuva 1.** Tilaus (phaser-orders) ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-26-1024x715.png) **Kuva 2.** Tilauserät (phaser-order-rows (punainen)), prosessin vaiheet (phaser-jobs (vihreä)) Kun olet lisännyt tilauksesi Skyplanneriin, haluat **viedä ne** (tämä voidaan tehdä käyttöliittymän tai /phaser-tilaukset/vienti-päätepisteen kautta) tuotannon aikataulutusmoduuliin: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-27-1024x596.png) **Kuva 3.** Vienti käyttöliittymän kautta ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-28-1024x597.png) **Kuva 4.** Viety tilaus tuotannon aikataulutuksessa Kun Skyplanner vie tilauksia, se kopioi tilaustiedot tietokantataulukosta toiseen. Jos siis muutat jotakin esimerkiksi /phaser-orders -loppupisteen kautta, sinun on vietävä tiedot uudelleen, jotta voit päivittää ne tuotantosuunnittelussa. Tämä tarkoittaa myös sitä, että tuotantoaikatauluikkunassa näkyviä tilauksia varten on käytettävä eri API-päätteitä! "Muutetut" päätepisteet ovat seuraavat: - /phaser-orders → /orders - /phaser-order-rows → /order-rows - /phaser-jobs → /jobs Tämä on tärkeää tietää, koska kun käytät /timelogs-päätepistettä tuotantotapahtumien kirjaamiseen, **sinun on käytettävä tuotantosuunnittelun päätepisteissä olevia asiaan liittyviä kokonaisuuksia!** Tarvitset esimerkiksi **production_planning_job_id-tunnuksen**(toistan vielä kerran: production_planning_jobs ovat kokonaisuuksia, joihin pääsee käsiksi /jobs-päätepisteestä), jotta voit POSTATA uuden aikapäiväkirjan: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-29.png) **Kuva 5.** Ajopäiväkirjan POST-pyyntö Löydät tarvitsemasi production_planning_job_id:n joko /phaser-jobs -loppupisteestä: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-30.png) **Kuva 6.** Phaser-työn GET-pyyntö (punainen on phaser_job_id, **ÄLÄ KÄYTÄ SITÄ AIKALUETTELOISSA**). Tai /job -loppupisteestä: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-31.png) **Kuva 7.** /job GET-pyyntö #### Aikapäiväkirjojen luominen REST-API:n avulla Skyplannerin aikapäiväkirjojen tekeminen API:n kautta käyttää samoja sääntöjä ja järjestelmiä kuin käyttöliittymässä. Siksi voi olla hyödyllistä tutustua siihen, miten järjestelmä toimii käyttöliittymässä, ennen kuin yrität käyttää sitä API:n kautta. ##### Aikapäiväkirjan perusteet Skyplannerissa on neljä aikapäiväkirjatapahtumatyyppiä: - shift_begin - keskeytetty - jatkuu - shift_end Shift_begin-tapahtuma lähetetään, kun työ käynnistetään ensimmäistä kertaa. **Älä koskaan lähetä useampaa kuin yhtä shift_begin-tapahtumaa kullekin työlle!** Paused-tapahtuma keskeyttää työn. Continued-event jatkaa keskeytettyä työtä. Shift_end päättää työn. **Älä koskaan lähetä useampaa kuin yhtä shift_end-tapahtumaa kullekin työlle!** Ajastokirjojen edellyttämät tiedot: - person_id - Löytyy /people-päätepisteestä. - Ei sama kuin user_id! - planned_workstation_id - Työpiste, jossa työtä tehdään - Löytyy /workstations-päätepisteestä. - date_time - Ajankohta, jolloin tapahtuma suoritetaan - Formaatti: 2024-01-01 10:30:11 Voit käyttää **external_id-kenttää**määrittääksesi, mikä Skyplannerin aikapäiväkirja on sidottu käyttämäsi ulkoisen järjestelmän aikapäiväkirjaan. Tämän jälkeen voit esimerkiksi tehdä GET-pyyntöjä käyttämällä tätä id:tä löytääksesi tietyn Skyplannerin ajopäiväkirjan. ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-32-1024x438.png) **Kuva 8.** External_id aikapäiväkirjoissa #### Työn aloittaminen Voit käynnistää työt lähettämällä API:lle POST-pyynnön tällä tavalla: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-33.png) **Kuva 9.** Shift_begin timelog Kun asetat POST-tiedot aikapäiväkirjoja varten, aseta **workshift_id**arvoksi 0 ja **timelog_finalized**arvoksi **true**. #### Työn keskeyttäminen Keskeytä työt lähettämällä POST-pyyntö seuraavasti: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-34.png) **Kuva 10.** Keskeytetty aikapäiväkirja Paused-tyyppisissä aikapäiväkirjoissa voit asettaa **summan**ja **faulty_amount**. Huomaa myös ajopäiväkirjan **tyyppi**ja **date_time**. #### Työn jatkaminen Näin jatkat keskeytettyä aikapäiväkirjaa: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-35.png) **Kuva 11.** Jatkuva aikapäiväkirja Huomaa, että jos yrität jatkaa työtä, joka on päättynyt shift_end-tapahtumaan, saat virheilmoituksen. #### Työn lopettaminen Näin lopetat työn shift_end timelogin avulla: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-36.png) **Kuva 12.** Shift_end timelog Shift_end-tapahtumissa voit antaa **amount-**ja **faulty_amount-arvot**aivan kuten paused-tapahtumissa. Huomaa, että jos yrität tehdä shift_end-tapahtuman tehtävälle, joka ei ole käynnissä, saat virheilmoituksen. #### Aikapäiväkirjojen päivittäminen Voit päivittää aikapäiväkirjatietoja lähettämällä PUT-kyselyitä /timelogs-endpoint-pisteeseen seuraavasti: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-37.png) **Kuva 13.** Aikapäiväkirjojen muokkaaminen Huomaa, että sinulla on oltava sekä **beginTimelog-**että **endTimelog-tiedot**, jotta voit tehdä päivityksen. Skyplannerin aikapäiväkirjat tallennetaan seuraavasti: jokaisella "täydellä" (aikapäiväkirjalla, jolla on sekä alku että loppu (esim. shift_begin/continued & paused/shift_end)) aikapäiväkirjalla on erillinen kokonaisuus alkua ja loppua varten. Näiden parina on endlogista löytyvä **begin_id-arvo**. Yllä olevassa esimerkissä beginTimelogin id-arvo on 1, joten sen endTimelogin **begin_id-arvo**on 1. Sinun on myös annettava **person_id-**ja **endTimelog-arvot**joka kerta, kun teet päivityspyynnön, vaikka et muuttaisi niitä. #### Vaihtoehtoisia tapoja tehdä aikapäiväkirjoja Seuraavassa on joitakin vaihtoehtoisia tapoja, joilla voit kirjautua työpaikkoihin API:n avulla. ##### Logfull Jos haluat lähettää sekä alku- että loppuaikapäiväkirjat yhdessä pyynnössä, voit käyttää **/timelogs/log-full** -loppupistettä seuraavasti: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-38.png) **Kuva 14.** Logfull-pyyntö Huomaa, miten määrät lähetetään tässä: ensimmäinen "määrä"-arvo tarkoittaa **virheellistä määrää** ja toinen **määrää**. Tämä pyyntö luo beginlog- ja endlog-oliot yhdellä pyynnöllä. ##### Pikaloki "Quickloggaus" tehtävään viimeistelee sen yhdellä pyynnöllä, asettaa valmistuneiden tuotteiden määrän vastaamaan tilauserässä asetettua arvoa. Quickloggaus tehdään käyttämällä **/timelogs/quick-log** -loppupistettä: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-39.png) **Kuva 15.** Quicklogging Huomaa, että tässä tapauksessa sinun tarvitsee antaa vain **production_planning_job_id**, **planned_workstation_id**ja **person_id**. Aika- ja summa-arvot täytetään automaattisesti. Huomaa myös, että quicklogatut työt päätyvät aina shift_end-tapahtumaan, joten quicklogin jälkeen ei ole enää mahdollista tehdä kirjauksia!