Innan vi dyker ner i tidsloggarna m\u00e5ste vi diskutera lite om datastrukturen i Skyplanner och hur saker och ting fungerar under huven. Allt detta kommer att spela in senare. <\/p>\n\n
Om du har integrerat dina order-\/arbetsorder-\/jobbdata i Skyplanner har du troligen anv\u00e4nt \u00e5tminstone dessa API-endpoints:<\/p>\n\n
\n
phaser-order<\/li>\n\n\n\n
phaser-ordning-rader<\/li>\n\n\n\n
phaser-jobb<\/li>\n<\/ul>\n\n
I praktiken representeras data som matas in i dessa \u00e4ndpunkter i Skyplanner-gr\u00e4nssnittet p\u00e5 f\u00f6ljande s\u00e4tt:<\/p>\n
N\u00e4r du har infogat dina best\u00e4llningar i Skyplanner vill du exportera dem<\/strong> (detta kan g\u00f6ras via anv\u00e4ndargr\u00e4nssnittet eller \/ phaser-orders\/export-endpoint) till produktionsschemal\u00e4ggningsmodulen:<\/p>\n\nBild 3.<\/strong> Exportera via anv\u00e4ndargr\u00e4nssnittet<\/figcaption><\/figure>\n\nBild 4.<\/strong> Exporterad order i Produktionsplanering<\/figcaption><\/figure>\n\n
Vid export av order kopierar Skyplanner i praktiken orderdata fr\u00e5n en databastabell till en annan. S\u00e5 om du \u00e4ndrar n\u00e5got, till exempel via \/phaser-orders -\u00e4ndpunkten, m\u00e5ste du exportera data igen f\u00f6r att uppdatera dem i produktionsplaneringen. Detta inneb\u00e4r ocks\u00e5 att du m\u00e5ste anv\u00e4nda olika API-endpoints f\u00f6r att komma \u00e5t de order som du ser i f\u00f6nstret f\u00f6r produktionsplanering! <\/p>\n\n
De ”\u00e4ndrade” slutpunkterna ser ut s\u00e5 h\u00e4r:<\/p>\n\n
Detta \u00e4r viktigt att veta, f\u00f6r n\u00e4r du anv\u00e4nder \/timelogs -endpoint f\u00f6r att logga dina produktionsh\u00e4ndelser etc. m\u00e5ste du anv\u00e4nda de relaterade enheterna som finns i Production Scheduling -endpoints!<\/strong><\/p>\n\n
Du beh\u00f6ver till exempel production_planning_job_id <\/strong>(f\u00f6r att upprepa: production_planning_jobs \u00e4r de enheter som n\u00e5s fr\u00e5n \/jobs -endpoint) f\u00f6r att POSTA en ny tidslogg:<\/p>\n\nBild 5.<\/strong> Timelog POST-beg\u00e4ran<\/figcaption><\/figure>\n\n
Du kan hitta det production_planning_job_id du beh\u00f6ver antingen fr\u00e5n \/phaser-jobs -endpoint:<\/p>\n\nFig 6.<\/strong> GET-beg\u00e4ran f\u00f6r Phaser-jobb (r\u00f6tt \u00e4r phaser_job_id, ANV\u00c4ND DET INTE I TIMELOGS<\/strong>)<\/figcaption><\/figure>\n\n
Eller fr\u00e5n \/job -slutpunkten:<\/p>\n\nBild 7.<\/strong> \/job GET-beg\u00e4ran<\/figcaption><\/figure>\n\n
Skapa tidsloggar med hj\u00e4lp av REST-API<\/h4>\n\n
F\u00f6r att skapa tidsloggar till Skyplanner via API:et anv\u00e4nds samma regler och system som i anv\u00e4ndargr\u00e4nssnittet. Det kan d\u00e4rf\u00f6r vara bra att bekanta sig med hur systemet fungerar i anv\u00e4ndargr\u00e4nssnittet innan man f\u00f6rs\u00f6ker anv\u00e4nda det via API:et. <\/p>\n\n
Grunderna i tidslogg<\/h5>\n\n
Skyplanner har fyra typer av h\u00e4ndelser i tidsloggen:<\/p>\n\n
\n
skift_b\u00f6rjan<\/li>\n\n\n\n
pausad<\/li>\n\n\n\n
fortsatt<\/li>\n\n\n\n
skift_slut<\/li>\n<\/ul>\n\n
Shift_begin-event skickas n\u00e4r jobbet startas f\u00f6r f\u00f6rsta g\u00e5ngen. Skicka aldrig mer \u00e4n en shift_begin-h\u00e4ndelse f\u00f6r varje jobb!<\/strong><\/p>\n\n
Paused-event pausar jobbet.<\/p>\n\n
Continued-event \u00e5terupptar ett pausat jobb.<\/p>\n\n
Shift_end avslutar jobbet. Skicka aldrig mer \u00e4n en shift_end-h\u00e4ndelse f\u00f6r varje jobb!<\/strong><\/p>\n\n
F\u00f6r att ange vilken Skyplanner-tidslogg som \u00e4r kopplad till tidsloggen fr\u00e5n det externa system du anv\u00e4nder kan du anv\u00e4nda f\u00e4ltet external_id <\/strong>. Du kan d\u00e5 t.ex. g\u00f6ra GET-f\u00f6rfr\u00e5gningar med detta id f\u00f6r att hitta en specifik tidslogg fr\u00e5n Skyplanner. <\/p>\n\nBild 8.<\/strong> Extern_id i tidsloggar<\/figcaption><\/figure>\n\n
Starta ett nytt jobb<\/h4>\n\n
Du kan starta jobb genom att skicka en POST-request som denna till API:et:<\/p>\n\nBild 9.<\/strong> Skift_b\u00f6rja tidslogg<\/figcaption><\/figure>\n\n
N\u00e4r du st\u00e4ller in POST-data f\u00f6r tidsloggarna ska du ange workshift_id <\/strong>som 0 och timelog_finalized <\/strong>som true<\/strong><\/p>\n\n
Pausa ett jobb<\/h4>\n\n
Pausa jobb genom att skicka en POST-beg\u00e4ran s\u00e5 h\u00e4r:<\/p>\n\nFig 10.<\/strong> Pausad tidslogg<\/figcaption><\/figure>\n\n
I tidsloggar av pausad typ kan du st\u00e4lla in belopp <\/strong>och faulty_amount<\/strong>. Observera \u00e4ven tidloggtyp <\/strong>och date_time<\/strong>. <\/p>\n\n
Forts\u00e4tta ett arbete<\/h4>\n\n
S\u00e5 h\u00e4r forts\u00e4tter du en pausad tidslogg:<\/p>\n\nFig 11.<\/strong> Fortsatt tidslogg<\/figcaption><\/figure>\n\n
Observera att om du f\u00f6rs\u00f6ker forts\u00e4tta ett jobb som har avslutats av en shift_end-h\u00e4ndelse, kommer du att f\u00e5 ett felmeddelande.<\/p>\n\n
Avsluta en anst\u00e4llning<\/h4>\n\n
S\u00e5 h\u00e4r avslutar du ett jobb med en shift_end timelog:<\/p>\n\nFig 12.<\/strong> Skift_slut timelog<\/figcaption><\/figure>\n\n
I shift_end-events kan du ange v\u00e4rdena amount <\/strong>och faulty_amount <\/strong>precis som i paused-events. Observera att om du f\u00f6rs\u00f6ker g\u00f6ra en shift_end-event f\u00f6r ett jobb som inte k\u00f6rs kommer du att f\u00e5 ett felmeddelande. <\/p>\n\n
Uppdatering av tidsloggar<\/h4>\n\n
Du kan uppdatera tidsloggdata genom att skicka PUT-beg\u00e4randen till \/timelogs-endpoint, s\u00e5 h\u00e4r:<\/p>\n\nFig 13.<\/strong> Redigera tidsloggar<\/figcaption><\/figure>\n\n
Observera att du m\u00e5ste ha b\u00e5de beginTimelog- <\/strong>och endTimelog-dataupps\u00e4ttningar <\/strong>f\u00f6r att kunna g\u00f6ra en uppdatering. Timelogs i Skyplanner lagras p\u00e5 f\u00f6ljande s\u00e4tt: varje ”fullst\u00e4ndig” (timelog som har b\u00e5de start och slut (t.ex. shift_begin\/continued & paused\/shift_end) timelog har en separat enhet f\u00f6r start och slut. <\/p>\n\n
Dessa paras ihop med begin_id-v\u00e4rdet <\/strong>som finns i endlog. I exemplet ovan har beginTimelog id-v\u00e4rdet 1 och d\u00e4rmed har dess endTimelog begin_id-v\u00e4rdet <\/strong>1. <\/p>\n\n
Du m\u00e5ste ocks\u00e5 ange v\u00e4rdena person_id <\/strong>och endTimelog <\/strong>f\u00f6r varje g\u00e5ng du g\u00f6r en uppdateringsbeg\u00e4ran, \u00e4ven om du inte \u00e4ndrar dem.<\/p>\n\n
Alternativa s\u00e4tt att g\u00f6ra tidsloggar<\/h4>\n\n
H\u00e4r \u00e4r n\u00e5gra alternativa s\u00e4tt du kan logga in p\u00e5 dina jobb med hj\u00e4lp av API:et.<\/p>\n\n
Logfull<\/h5>\n\n
Om du vill skicka b\u00e5de b\u00f6rjan och slutet av tidsloggen i en enda beg\u00e4ran kan du anv\u00e4nda \/timelogs\/log-full<\/strong> -endpoint, s\u00e5 h\u00e4r:<\/p>\n\nFig 14.<\/strong> Logfull beg\u00e4ran<\/figcaption><\/figure>\n\n
Observera hur beloppen skickas h\u00e4r: det f\u00f6rsta ”amount”-v\u00e4rdet anger det felaktiga beloppet<\/strong> och det andra beloppet<\/strong> beloppet. Denna beg\u00e4ran skapar entiteterna beginlog och endlog i en enda beg\u00e4ran. <\/p>\n\n
Quicklog<\/h5>\n\n
”Quickloggning” till ett jobb slutf\u00f6r det i en enda beg\u00e4ran, st\u00e4ller in den slutf\u00f6rda m\u00e4ngden produkter s\u00e5 att den matchar det v\u00e4rde som anges i orderposten. Quickloggning g\u00f6rs genom att anv\u00e4nda \/timelogs\/quick-log<\/strong> -endpoint: <\/p>\n\nFig 15.<\/strong> Kvickloggning<\/figcaption><\/figure>\n\n
Observera att du h\u00e4r endast beh\u00f6ver ange produktions_planering_job_id<\/strong>, planerad_arbetsstation_id <\/strong>och person_id<\/strong>. V\u00e4rdena f\u00f6r tid och belopp fylls i automatiskt. Observera ocks\u00e5 att kvickloggade jobb alltid avslutas med shift_end-h\u00e4ndelsen, s\u00e5 ingen ytterligare loggning \u00e4r m\u00f6jlig efter kvickloggning! <\/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\")