Prima di immergerci nei timelogrammi, dobbiamo parlare un po’ della struttura dei dati di Skyplanner e di come funzionano le cose sotto il cofano. Tutto questo entrer\u00e0 in gioco pi\u00f9 avanti. <\/p>\n\n
Se hai integrato i dati dei tuoi ordini\/lavori\/commesse in Skyplanner, molto probabilmente hai utilizzato almeno questi punti API:<\/p>\n\n
\n
ordini di phaser<\/li>\n\n\n\n
phaser-order-rows<\/li>\n\n\n\n
phaser-lavori<\/li>\n<\/ul>\n\n
In effetti, i dati inseriti in questi endpoint sono rappresentati nell’interfaccia utente di Skyplanner in questo modo:<\/p>\n
\nFigura 1.<\/strong> Ordine (phaser-ordini)<\/figcaption><\/figure>\n<\/div>\nFigura 2.<\/strong> Voci dell’ordine (phaser-order-rows (rosso)), Fasi del processo (phaser-jobs (verde))<\/figcaption><\/figure>\n\n
Dopo aver inserito gli ordini in Skyplanner, dovrai esportarli<\/strong> (questo pu\u00f2 essere fatto tramite l’interfaccia utente o il punto finale \/phaser-orders\/export) nel modulo di programmazione della produzione:<\/p>\n\nFigura 3.<\/strong> Esportazione attraverso l’interfaccia utente<\/figcaption><\/figure>\n\nFigura 4.<\/strong> Ordine esportato in Pianificazione della produzione<\/figcaption><\/figure>\n\n
Quando si esportano gli ordini, Skyplanner copia effettivamente i dati dell’ordine da una tabella del database a un’altra. Quindi, se cambi qualcosa, ad esempio attraverso l’endpoint \/phaser-orders, devi esportare nuovamente i dati per aggiornarli in Production Scheduling. Questo significa anche che per accedere agli ordini che vedi nella finestra di Production Scheduling devi utilizzare diversi endpoint API! <\/p>\n\n
Gli endpoint “modificati” sono i seguenti:<\/p>\n\n
Questo \u00e8 importante da sapere, perch\u00e9 quando utilizzi l’endpoint \/timelogs per registrare gli eventi di produzione, ecc. devi utilizzare le entit\u00e0 correlate che si trovano negli endpoint Production Scheduling!<\/strong><\/p>\n\n
Ad esempio, hai bisogno del production_planning_job_id <\/strong>(per ribadire: i production_planning_jobs sono le entit\u00e0 a cui si accede dall’endpoint \/jobs) per POSTARE un nuovo timelog:<\/p>\n\nFigura 5.<\/strong> Richiesta POST del timelog<\/figcaption><\/figure>\n\n
Puoi trovare il production_planning_job_id che ti serve dal punto finale \/phaser-jobs:<\/p>\n\nFigura 6.<\/strong> Richiesta GET di un lavoro Phaser (il rosso \u00e8 phaser_job_id, NON USARLO NEI TIMELOGS<\/strong>)<\/figcaption><\/figure>\n\n
Oppure dal punto finale \/job:<\/p>\n\nFigura 7.<\/strong> Richiesta GET di \/lavoro<\/figcaption><\/figure>\n\n
Creare timelog usando la REST-API<\/h4>\n\n
L’inserimento di timelogrammi in Skyplanner attraverso l’API utilizza le stesse regole e gli stessi sistemi presenti nell’interfaccia utente. Per questo motivo potrebbe essere utile familiarizzare con il funzionamento del sistema nell’interfaccia utente prima di provare a usarlo attraverso l’API. <\/p>\n\n
Nozioni di base del timelog<\/h5>\n\n
Skyplanner ha quattro tipi di eventi timelog:<\/p>\n\n
\n
shift_begin<\/li>\n\n\n\n
in pausa<\/li>\n\n\n\n
continua<\/li>\n\n\n\n
fine turno<\/li>\n<\/ul>\n\n
L’evento Shift_begin viene inviato quando il lavoro viene avviato per la prima volta. Non inviare mai pi\u00f9 di un evento shift_begin per ogni lavoro!<\/strong><\/p>\n\n
L’evento Pausa mette in pausa il lavoro.<\/p>\n\n
Continued-event riprende un lavoro in pausa.<\/p>\n\n
Shift_end completa il lavoro. Non inviare mai pi\u00f9 di un evento shift_end per ogni lavoro!<\/strong><\/p>\n\n
Dati richiesti per i timelogrammi:<\/p>\n\n
\n
persona_id\n
\n
Pu\u00f2 essere trovato dall’endpoint \/people<\/li>\n\n\n\n
Non \u00e8 la stessa cosa di user_id!<\/li>\n<\/ul>\n<\/li>\n\n\n\n
workstation_prevista_id\n
\n
La postazione di lavoro in cui viene svolto il lavoro<\/li>\n\n\n\n
Pu\u00f2 essere trovato dall’endpoint \/workstations<\/li>\n<\/ul>\n<\/li>\n\n\n\n
data_ora\n
\n
Il momento in cui l’evento viene realizzato<\/li>\n\n\n\n
Per specificare quale timelog di Skyplanner \u00e8 legato al timelog del sistema esterno che stai utilizzando, puoi utilizzare il campo external_id <\/strong>. Potrai quindi, ad esempio, fare richieste GET utilizzando questo id per trovare un timelog specifico da Skyplanner. <\/p>\n\nFigura 8.<\/strong> External_id nei timelog<\/figcaption><\/figure>\n\n
Iniziare un lavoro<\/h4>\n\n
Puoi avviare i lavori inviando una richiesta POST come questa all’API:<\/p>\n\nFigura 9.<\/strong> Shift_begin timelog<\/figcaption><\/figure>\n\n
Quando si impostano i dati POST per i timelog, impostare workshift_id <\/strong>come 0 e timelog_finalized <\/strong>come true<\/strong>.<\/p>\n\n
Mettere in pausa un lavoro<\/h4>\n\n
Metti in pausa i lavori inviando una richiesta POST come questa:<\/p>\n\nFigura 10.<\/strong> Timelog in pausa<\/figcaption><\/figure>\n\n
Nei timelog di tipo pausa puoi impostare l’importo <\/strong>e l’importo_guasto<\/strong>. Nota anche il tipo di <\/strong>timelog e la data_ora<\/strong>. <\/p>\n\n
Continuare a lavorare<\/h4>\n\n
Ecco come continuare un timelog in pausa:<\/p>\n\nFigura 11.<\/strong> Cronologia continua<\/figcaption><\/figure>\n\n
Nota che se cerchi di continuare un lavoro che \u00e8 stato terminato da un evento shift_end, otterrai un errore.<\/p>\n\n
Terminare un lavoro<\/h4>\n\n
Ecco come terminare un lavoro con un timelog shift_end:<\/p>\n\nFigura 12.<\/strong> Timelog Shift_end<\/figcaption><\/figure>\n\n
In shift_end-events puoi indicare i valori amount <\/strong>e faulty_amount <\/strong>proprio come in paused-events. Nota che se provi a fare uno shift_end-event a un lavoro che non \u00e8 in esecuzione, otterrai un errore. <\/p>\n\n
Aggiornamento dei timelogrammi<\/h4>\n\n
Puoi aggiornare i dati del timelog inviando richieste PUT all’endpoint \/timelogs, in questo modo:<\/p>\n\nFigura 13.<\/strong> Modifica dei timelogrammi<\/figcaption><\/figure>\n\n
Nota che per effettuare un aggiornamento \u00e8 necessario che siano impostati sia i dati di beginTimelog <\/strong>che di endTimelog <\/strong>. I timelog in Skyplanner sono memorizzati in questo modo: ogni timelog “completo” (timelog che ha sia un inizio che una fine (es. shift_begin\/continued & paused\/shift_end) ha un’entit\u00e0 separata per l’inizio e la fine. <\/p>\n\n
Questi sono accoppiati dal valore begin_id <\/strong>trovato nell’endlog. Nell’esempio precedente il beginTimelog ha il valore id 1 e quindi il suo endTimelog ha il valore begin_id <\/strong>1. <\/p>\n\n
Devi anche indicare i valori person_id <\/strong>e endTimelog <\/strong>ogni volta che fai una richiesta di aggiornamento, anche se non li stai modificando.<\/p>\n\n
Modi alternativi per fare i timelogrammi<\/h4>\n\n
Ecco alcuni modi alternativi per accedere ai tuoi lavori utilizzando l’API.<\/p>\n\n
Logfull<\/h5>\n\n
Se vuoi inviare sia il timelog iniziale che quello finale in un’unica richiesta, puoi utilizzare il punto \/timelogs\/log-full<\/strong> -end, in questo modo:<\/p>\n\nFigura 14.<\/strong> Richiesta di logfull<\/figcaption><\/figure>\n\n
Nota come vengono inviati gli importi: il primo valore “amount” indica l’importo difettoso<\/strong> e il secondo l’importo<\/strong>. Questa richiesta crea le entit\u00e0 beginlog e endlog in un’unica richiesta. <\/p>\n\n
Registro rapido<\/h5>\n\n
Il “Quicklogging” di un lavoro lo completa in un’unica richiesta e imposta la quantit\u00e0 di prodotti completati in modo che corrisponda al valore impostato nell’articolo dell’ordine. Il quicklogging si effettua utilizzando l’endpoint \/timelogs\/quick-log<\/strong>: <\/p>\n\nFigura 15.<\/strong> Quicklogging<\/figcaption><\/figure>\n\n
Nota che in questo caso devi indicare solo i dati production_planning_job_id<\/strong>, planned_workstation_id <\/strong>e person_id<\/strong>. I valori di tempo e importo vengono compilati automaticamente. Tieni inoltre presente che i lavori in quicklogger vengono sempre completati con l’evento shift_end, quindi non \u00e8 possibile effettuare ulteriori registrazioni dopo il quicklog! <\/p>\n\n
![\"\"](\"https:\/\/skyplanner.ai\/wp-content\/uploads\/2025\/03\/image-25-1024x714.png\")
![\"\"](\"https:\/\/skyplanner.ai\/wp-content\/uploads\/2025\/03\/image-26-1024x715.png\")
![\"\"](\"https:\/\/skyplanner.ai\/wp-content\/uploads\/2025\/03\/image-27-1024x596.png\")
![\"\"](\"https:\/\/skyplanner.ai\/wp-content\/uploads\/2025\/03\/image-28-1024x597.png\")
![\"\"](\"https:\/\/skyplanner.ai\/wp-content\/uploads\/2025\/03\/image-29.png\")
![\"\"](\"https:\/\/skyplanner.ai\/wp-content\/uploads\/2025\/03\/image-30.png\")
![\"\"](\"https:\/\/skyplanner.ai\/wp-content\/uploads\/2025\/03\/image-31.png\")
![\"\"](\"https:\/\/skyplanner.ai\/wp-content\/uploads\/2025\/03\/image-32-1024x438.png\")
![\"\"](\"https:\/\/skyplanner.ai\/wp-content\/uploads\/2025\/03\/image-33.png\")
![\"\"](\"https:\/\/skyplanner.ai\/wp-content\/uploads\/2025\/03\/image-34.png\")
![\"\"](\"https:\/\/skyplanner.ai\/wp-content\/uploads\/2025\/03\/image-35.png\")
![\"\"](\"https:\/\/skyplanner.ai\/wp-content\/uploads\/2025\/03\/image-36.png\")
![\"\"](\"https:\/\/skyplanner.ai\/wp-content\/uploads\/2025\/03\/image-37.png\")
![\"\"](\"https:\/\/skyplanner.ai\/wp-content\/uploads\/2025\/03\/image-38.png\")
![\"\"](\"https:\/\/skyplanner.ai\/wp-content\/uploads\/2025\/03\/image-39.png\")