--- title: Cronologii description: "#### Structura datelor Skyplanner Înainte de a ne apuca de cronologii, trebuie să discutăm puțin despre structura datelor din Skyplanner și despre cum funcționează lucrurile sub capotă. Toate acestea vor intra în joc mai târziu. Dacă v-ați integrat datele privind…" url: "https://skyplanner.ai/ro/docs/cronologii/" updated: "2025-10-07" category: Integrări tags: - API - Integrare --- # Cronologii #### Structura datelor Skyplanner Înainte de a ne apuca de cronologii, trebuie să discutăm puțin despre structura datelor din Skyplanner și despre cum funcționează lucrurile sub capotă. Toate acestea vor intra în joc mai târziu. Dacă v-ați integrat datele privind comenzile/ordinele de lucru/locurile de muncă în Skyplanner, cel mai probabil ați utilizat cel puțin aceste puncte finale API: - phaser-ordine - phaser-order-rows - phaser-jobs Efectiv, datele introduse în aceste puncte finale sunt reprezentate în interfața de utilizator Skyplanner astfel: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-25-1024x714.png) **Fig 1.** Comandă (phaser-orders) ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-26-1024x715.png) **Fig 2.** Elemente de comandă (phaser-order-rows (roșu)), Etape de proces (phaser-jobs (verde)) După inserarea comenzilor în Skyplanner, veți dori să **le exportați** (acest lucru se poate face prin intermediul interfeței sau al punctului final /phaser-orders/export) în modulul de planificare a producției: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-27-1024x596.png) **Fig 3.** Exportul prin interfața de utilizator ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-28-1024x597.png) **Fig 4.** Comanda exportată în programarea producției Atunci când exportați comenzi, Skyplanner copiază efectiv datele comenzii dintr-un tabel al bazei de date în altul. Astfel, dacă modificați ceva, de exemplu, prin intermediul punctului final /phaser-orders, trebuie să exportați din nou datele pentru a le actualiza în planificarea producției. Acest lucru înseamnă, de asemenea, că pentru a accesa comenzile pe care le vedeți în fereastra de planificare a producției trebuie să utilizați puncte finale API diferite! Punctele finale "modificate" se prezintă astfel: - /phaser-orders → /orders - /phaser-order-rows → /order-rows - /phaser-jobs → /jobs Acest lucru este important de știut, deoarece atunci când folosiți punctul final /timelogs pentru a înregistra evenimentele de producție etc., **trebuie să folosiți entitățile aferente găsite în punctele finale Production Scheduling!** De exemplu, aveți nevoie de **production_planning_job_id**(pentru a reitera: production_planning_jobs sunt entitățile accesate de la punctul final /jobs) pentru a posta un nou cronolog: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-29.png) **Fig 5.** Cerere POST pentru cronolog Puteți găsi ID-ul production_planning_job_de care aveți nevoie fie din punctul final /phaser-jobs: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-30.png) **Fig 6.** Cerere Phaser job GET (roșu este phaser_job_id, **NU-l folosiți în cronologii**) Sau din punctul final /job: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-31.png) **Fig 7.** Cerere GET /job #### Crearea de cronologii folosind REST-API Realizarea de cronologii pentru Skyplanner prin API utilizează aceleași reguli și sisteme care sunt în interfața utilizator. Prin urmare, ar putea fi benefic să vă familiarizați cu modul în care funcționează sistemul în interfața utilizator înainte de a încerca să îl utilizați prin API. ##### Bazele timelogului Skyplanner are patru tipuri de evenimente timelog: - shift_begin - oprită - continuă - shift_end Shift_begin-event este trimis atunci când sarcina este lansată pentru prima dată. **Nu trimiteți niciodată mai mult de un eveniment shift_begin pentru fiecare sarcină!** Paused-event întrerupe activitatea. Continued-event reia o sarcină întreruptă. Shift_end finalizează lucrarea. **Nu trimiteți niciodată mai mult de un eveniment shift_end pentru fiecare sarcină!** Date necesare pentru cronologii: - ID_persoană - Poate fi găsit din punctul final /people - Nu este același lucru cu user_id! - ID_stație_de_lucru planificată - Stația de lucru la care se desfășoară activitatea - Poate fi găsit din /workstations-endpoint - data_timp - Momentul în care evenimentul este realizat - Format: 2024-01-01 10:30:11 Pentru a specifica ce cronolog Skyplanner este legat de cronologul din orice sistem extern pe care îl utilizați, puteți utiliza câmpul **external_id**. Puteți apoi, de exemplu, să efectuați cereri GET utilizând acest id pentru a găsi un anumit jurnal de bord din Skyplanner. ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-32-1024x438.png) **Fig 8.** External_id în jurnalele de timp #### Începerea unui loc de muncă Puteți lansa sarcini de lucru trimițând o solicitare POST ca aceasta către API: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-33.png) **Fig 9.** Shift_begin cronolog La setarea datelor POST pentru jurnalele de timp, setați **workshift_id**ca 0 și **timelog_finalized**ca **true** #### Întreruperea unei lucrări Întrerupeți lucrările trimițând o cerere POST după cum urmează: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-34.png) **Fig 10.** Cronolog pauză În jurnalele cronologice de tip pauză, puteți seta **valoarea**și **valoarea defectuoasă (faulty_amount**). Rețineți, de asemenea, **tipul de**cronolog și **data_timp**. #### Continuarea unui loc de muncă Iată cum puteți continua o cronologie întreruptă: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-35.png) **Fig 11.** Continuarea cronologiei Rețineți că dacă încercați să continuați o sarcină care a fost încheiată de un eveniment shift_end, veți primi o eroare. #### Încetarea unui loc de muncă Iată cum se încheie o lucrare cu ajutorul unui timelog shift_end: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-36.png) **Fig 12.** Shift_end cronolog În shift_end-events puteți da valorile **amount**și **faulty_amount**la fel ca în paused-events. Rețineți că, dacă încercați să efectuați un shift_end-event pentru un job care nu rulează, veți primi o eroare. #### Actualizarea cronologiei Puteți actualiza datele timelog prin trimiterea de cereri PUT către punctul final /timelogs, astfel: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-37.png) **Fig 13.** Editarea jurnalelor cronologice Rețineți că trebuie să aveți atât datele **beginTimelog**, cât și cele **endTimelog**pentru a efectua o actualizare. Cronologiile în Skyplanner sunt stocate astfel: fiecare cronolog "complet" (cronolog care are atât un început, cât și un sfârșit (de exemplu, shift_begin/continued & paused/shift_end) are o entitate separată pentru început și sfârșit. Acestea sunt împerecheate de valoarea **begin_id**găsită în endlog. În exemplul de mai sus, beginTimelog are valoarea id 1 și, prin urmare, endTimelog are valoarea **begin_id**1. De asemenea, trebuie să furnizați valorile **person_id**și **endTimelog**de fiecare dată când faceți o cerere de actualizare, chiar dacă nu le modificați. #### Modalități alternative de a realiza cronologii Iată câteva modalități alternative prin care vă puteți conecta la locurile de muncă utilizând API. ##### Logfull Dacă doriți să trimiteți atât cronologiile de început, cât și cele de sfârșit într-o singură cerere, puteți utiliza punctul **/timelogs/log-full** -endpoint, astfel: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-38.png) **Fig 14.** Cerere Logfull Observați modul în care sumele sunt trimise aici: prima valoare "amount" denotă **suma defectă**, iar cea de-a doua, **suma**. Această cerere creează entitățile beginlog și endlog într-o singură cerere. ##### Quicklog "Quicklogging" la o sarcină o finalizează într-o singură cerere, stabilește cantitatea de produse finalizată pentru a corespunde valorii stabilite în elementul de comandă. Quicklogging se realizează prin utilizarea punctului final **/timelogs/quick-log**: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-39.png) **Fig 15.** Quicklogging Rețineți că aici trebuie să furnizați doar **ID_job_de_planificare_producție**, **ID_stație_de_lucru_planificată**și **ID_persoană**. Valorile timp și sumă sunt completate automat. Rețineți, de asemenea, că lucrările quicklogged sunt întotdeauna finalizate cu evenimentul shift_end, astfel încât nu mai este posibilă înregistrarea ulterioară după quicklog!