--- title: Ajakirjad description: "#### Skyplanneri andmestruktuur Enne kui me sukeldume ajagraafikutesse, peame veidi rääkima Skyplanneri andmestruktuurist ja sellest, kuidas asjad kapoti all toimivad. Kõik see tuleb mängu hiljem. Kui te integreerisite oma tellimuse/töötellimuse/töö andmed Skyplannerisse, kasutasite tõenäoliselt vähemalt neid API-punkte: - phaser-orders -…" url: "https://skyplanner.ai/et/docs/ajakirjad/" updated: "2025-10-07" category: Integratsioonid tags: - API - Integratsioon --- # Ajakirjad #### Skyplanneri andmestruktuur Enne kui me sukeldume ajagraafikutesse, peame veidi rääkima Skyplanneri andmestruktuurist ja sellest, kuidas asjad kapoti all toimivad. Kõik see tuleb mängu hiljem. Kui te integreerisite oma tellimuse/töötellimuse/töö andmed Skyplannerisse, kasutasite tõenäoliselt vähemalt neid API-punkte: - phaser-orders - phaser-order-rows - phaser-jobs Tegelikkuses esitatakse nendesse lõpp-punktidesse sisestatud andmed Skyplanneri kasutajaliideses järgmiselt: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-25-1024x714.png) **Joonis 1.** Tellimus (phaser-order) ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-26-1024x715.png) **Joonis 2.** Tellimuse elemendid (phaser-order-rows (punane)), Protsessi etapid (phaser-jobs (roheline)) Pärast tellimuste sisestamist Skyplannerisse soovite **need eksportida** (seda saab teha kasutajaliidese või /phaser-orders/export-endpunkti kaudu) tootmise planeerimise moodulisse: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-27-1024x596.png) **Joonis 3.** Eksportimine kasutajaliidese kaudu ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-28-1024x597.png) **Joonis 4.** Eksporditud tellimus tootmise planeerimisel Tellimuste eksportimisel kopeerib Skyplanner tellimuse andmed ühest andmebaasi tabelist teise. Seega, kui te muudate midagi näiteks /phaser-orders -endpunkti kaudu, peate andmed uuesti eksportima, et neid tootmisplaani ajakohastada. See tähendab ka seda, et selleks, et pääseda ligi tellimustele, mida näete Production Schedulingi aknas, peate kasutama erinevaid API-pääsupunkte! "Muudetud" lõpp-punktid on järgmised: - /phaser-orders → /orders - /phaser-order-rows → /order-rows - /phaser-jobs → /jobs Seda on oluline teada, sest kui kasutate /timelogs -endpunkti oma tootmissündmuste jms logimiseks **, peate kasutama seotud üksusi, mis leiate Production Scheduling -endpunktidest!** Näiteks vajate uue ajaplaani POSTI tegemiseks **production_planning_job_id**(kordan veel kord: production_planning_jobs on üksused, millele pääseb ligi /jobs -endpunktist): ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-29.png) **Joonis 5.** Ajaregistri POST päring Vajaliku production_planning_job_id leiate kas /phaser-jobs -endpunktist: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-30.png) **Joonis 6.** Phaser job GET päring (punane on phaser_job_id, **EI KASUTA seda TIMELOGIS**) Või /job -endpunktist: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-31.png) **Joonis 7.** /töö GET päring #### Ajakirjade loomine REST-API abil Skyplanneri ajagraafikute tegemine API kaudu kasutab samu reegleid ja süsteeme, mis on kasutajaliideses. Seega võib olla kasulik tutvuda sellega, kuidas süsteem töötab kasutajaliideses, enne kui proovite seda API kaudu kasutada. ##### Timelogi põhitõed Skyplanneril on neli ajaregistri sündmuse tüüpi: - shift_begin - pausis - jätkub - shift_end Shift_begin-event saadetakse, kui tööd alustatakse esimest korda. **Ärge kunagi saatke rohkem kui üks shift_begin sündmus iga töö kohta!** Paused-juhtum peatab töö. Continued-event jätkab peatatud tööd. Shift_end lõpetab töö. **Ärge kunagi saatke rohkem kui üks shift_end sündmus iga töö kohta!** Ajakirjade jaoks nõutavad andmed: - person_id - Saab leida /people-endpunktist - Ei ole sama mis user_id! - planned_workstation_id - Töökoht, kus tööd tehakse - Võib leida /workstations-endpoint'ist - date_time - Sündmuse toimumise aeg - Formaat: 2024-01-01 10:30:11 Selleks, et määrata, milline Skyplanneri ajaregister on seotud mis tahes välissüsteemi ajaregistriga, mida te kasutate, saate kasutada väljal **external_id**. Seejärel saate näiteks teha GET-päringuid, kasutades seda id-d, et leida Skyplannerist konkreetne timelog. ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-32-1024x438.png) **Joonis 8.** External_id ajalogides #### Töö alustamine Tööde käivitamiseks saate saata API-le POST-küsitluse järgmiselt: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-33.png) **Joonis 9.** Shift_begin timelog POST andmete seadmisel ajaregistrite jaoks seadke **workshift_id**väärtuseks 0 ja **timelog_finalized**väärtuseks **true**. #### Töö peatamine Peatage tööd, saates POST-päringu järgmiselt: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-34.png) **Joonis 10.** Pausitud ajalogi Paused-tüüpi ajalogides saate määrata **summa**ja **vigase_määra**. Pange tähele ka timelogi **tüüpi**ja **date_time**. #### Töö jätkamine Nii jätkate peatatud ajaregistrit: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-35.png) **Joonis 11.** Jätkuv ajagraafik Pange tähele, et kui püüate jätkata tööd, mis on lõpetatud shift_end sündmuse tõttu, saate veateate. #### Töö lõpetamine Siin on kirjeldatud, kuidas lõpetada töö shift_end timelogi abil: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-36.png) **Joonis 12.** Shift_end timelog Shift_end-eventides saate anda **summa**ja **faulty_amount**väärtused nagu paused-eventides. Pange tähele, et kui proovite teha shift_end-event'i tööga, mis ei ole töös, saate veateateate. #### Ajakirjade ajakohastamine Saate uuendada ajalogi andmeid, saates PUT-päringuid /timelogs-endpoint'ile, näiteks nii: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-37.png) **Joonis 13.** Ajakirjade redigeerimine Pange tähele, et teil peavad olema määratud nii **beginTimelogi**kui ka **endTimelogi**andmed, et teha uuendusi. Skyplanneris salvestatakse ajalogisid järgmiselt: iga "täielik" (ajalogi, millel on nii algus kui ka lõpp (nt shift_begin/continued & paused/shift_end) ajalogi jaoks on eraldi üksus alguse ja lõpu jaoks. Need on paaritatud endlogis leitud **begin_id**väärtuse järgi. Ülaltoodud näites on beginTimelogi id-väärtus 1 ja seega on selle endTimelogi **begin_id**väärtus 1. Samuti peate andma **person_id**ja **endTimelogi**väärtused iga kord, kui teete uuendustaotluse, isegi kui te neid ei muuda. #### Alternatiivsed viisid ajagraafikute tegemiseks Siin on mõned alternatiivsed viisid, kuidas saate API abil oma töökohtadesse sisse logida. ##### Logfull Kui soovite saata nii algus- kui ka lõpp-ajakirjad ühe taotlusega, võite kasutada **/timelogs/log-full** -endpoint, näiteks nii: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-38.png) **Joonis 14.** Täielik taotlus Pange tähele, kuidas summad siin saadetakse: esimene "summa" väärtus tähistab **vigast summat** ja teine **summat**. See taotlus loob beginlog ja endlog üksused ühe taotlusega. ##### Quicklog "Quicklogging" tööle lõpetab selle ühe taotlusega, seab lõpetatud toodete koguse vastavaks tellimuse elemendis määratud väärtusele. Quicklogimine toimub **/timelogs/quick-log** -endpunkti abil: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-39.png) **Joonis 15.** Quicklogging Pange tähele, et siin on vaja anda ainult **production_planning_job_id**, **planned_workstation_id**ja **person_id**. Aja ja summa väärtused täidetakse automaatselt. Pange tähele ka seda, et quicklogitud tööd lõpetatakse alati shift_end-eventiga, nii et pärast quicklogi ei ole edasine logimine võimalik!