F\u00f8r vi dykker ned i tidsloggene, er vi n\u00f8dt til at tale lidt om datastrukturen i Skyplanner, og hvordan tingene fungerer under motorhjelmen. Alt dette kommer i spil senere. <\/p>\n\n
Hvis du har integreret dine ordre-\/arbejdsordre-\/jobdata i Skyplanner, har du h\u00f8jst sandsynligt brugt mindst disse API-endpoints:<\/p>\n\n
N\u00e5r du har indsat dine ordrer i Skyplanner, skal du eksportere dem<\/strong> (dette kan g\u00f8res via brugergr\u00e6nsefladen eller \/phaser-orders\/export-endpoint) til produktionsplanl\u00e6gningsmodulet:<\/p>\n\nFig. 3.<\/strong> Eksport via brugergr\u00e6nsefladen<\/figcaption><\/figure>\n\nFig. 4.<\/strong> Eksporteret ordre i produktionsplanl\u00e6gningen<\/figcaption><\/figure>\n\n
N\u00e5r man eksporterer ordrer, kopierer Skyplanner effektivt ordredataene fra en databasetabel til en anden. S\u00e5 hvis du f.eks. \u00e6ndrer noget via \/phaser-orders -endpoint, skal du eksportere dataene igen for at opdatere dem i produktionsplanl\u00e6gningen. Det betyder ogs\u00e5, at du skal bruge forskellige API-endpoints for at f\u00e5 adgang til de ordrer, du ser i produktionsplanl\u00e6gningsvinduet! <\/p>\n\n
De “\u00e6ndrede” slutpunkter ser s\u00e5dan ud:<\/p>\n\n
Det er vigtigt at vide, for n\u00e5r du bruger \/timelogs -endpointet til at logge dine produktionsh\u00e6ndelser osv., skal du bruge de relaterede enheder, der findes i Production Scheduling -endpointet!<\/strong><\/p>\n\n
For eksempel skal du bruge production_planning_job_id <\/strong>(for at gentage: production_planning_jobs er de enheder, der er adgang til fra \/jobs -endpoint) for at POSTe en ny timelog:<\/p>\n\nFig. 5.<\/strong> Timelog POST-anmodning<\/figcaption><\/figure>\n\n
Du kan finde det production_planning_job_id, du skal bruge, fra enten \/phaser-jobs -endpoint:<\/p>\n\nFig. 6.<\/strong> Phaser-job GET-anmodning (r\u00f8d er phaser_job_id, BRUG DEN IKKE I TIMELOGS<\/strong>)<\/figcaption><\/figure>\n\n
Eller fra \/job-slutpunktet:<\/p>\n\nFig. 7.<\/strong> \/job GET-anmodning<\/figcaption><\/figure>\n\n
Oprettelse af timelogs ved hj\u00e6lp af REST-API<\/h4>\n\n
N\u00e5r man laver tidslogs til Skyplanner via API’en, bruger man de samme regler og systemer som i brugergr\u00e6nsefladen. S\u00e5 det kan v\u00e6re en fordel at s\u00e6tte sig ind i, hvordan systemet fungerer i brugergr\u00e6nsefladen, f\u00f8r man fors\u00f8ger at bruge det via API’en. <\/p>\n\n
Grundl\u00e6ggende om tidslog<\/h5>\n\n
Skyplanner har fire typer timelog-begivenheder:<\/p>\n\n
\n
skift_begyndelse<\/li>\n\n\n\n
holdt pause<\/li>\n\n\n\n
fortsat<\/li>\n\n\n\n
shift_end<\/li>\n<\/ul>\n\n
Shift_begin-event sendes, n\u00e5r jobbet startes for f\u00f8rste gang. Send aldrig mere end \u00e9n shift_begin-begivenhed for hvert job!<\/strong><\/p>\n\n
For at specificere, hvilken Skyplanner-tidslog der er knyttet til tidsloggen fra det eksterne system, du bruger, kan du bruge feltet external_id <\/strong>. Du kan s\u00e5 f.eks. lave GET-anmodninger ved hj\u00e6lp af dette id for at finde en bestemt tidslog fra Skyplanner. <\/p>\n\nFig. 8.<\/strong> Eksternt_id i timelogs<\/figcaption><\/figure>\n\n
At starte et job<\/h4>\n\n
Du kan starte jobs ved at sende en POST-request som denne til API’en:<\/p>\n\nFig. 9.<\/strong> Skift_begynd timelog<\/figcaption><\/figure>\n\n
N\u00e5r du indstiller POST-dataene for tidsloggene, skal du s\u00e6tte workshift_id <\/strong>til 0 og timelog_finalized <\/strong>til true<\/strong>.<\/p>\n\n
S\u00e6tte et job p\u00e5 pause<\/h4>\n\n
S\u00e6t jobs p\u00e5 pause ved at sende en POST-anmodning som denne:<\/p>\n\nFig. 10.<\/strong> Pauseret tidslog<\/figcaption><\/figure>\n\n
I tidslogge af pausetypen kan du indstille bel\u00f8bet <\/strong>og faulty_amount<\/strong>. Bem\u00e6rk ogs\u00e5 tidslogtypen <\/strong>og date_time<\/strong>. <\/p>\n\n
Forts\u00e6ttelse af et job<\/h4>\n\n
S\u00e5dan forts\u00e6tter du en pauset timelog:<\/p>\n\nFig. 11.<\/strong> Fortsat tidslinje<\/figcaption><\/figure>\n\n
Bem\u00e6rk, at hvis du pr\u00f8ver at forts\u00e6tte et job, der er blevet afsluttet af en shift_end-begivenhed, f\u00e5r du en fejl.<\/p>\n\n
At afslutte et job<\/h4>\n\n
S\u00e5dan afslutter du et job med en shift_end timelog:<\/p>\n\nFig. 12.<\/strong> Skift_slut timelog<\/figcaption><\/figure>\n\n
I shift_end-events kan du angive bel\u00f8b <\/strong>og faulty_amount-v\u00e6rdier <\/strong>ligesom i paused-events. Bem\u00e6rk, at hvis du pr\u00f8ver at lave en shift_end-event p\u00e5 et job, der ikke k\u00f8rer, f\u00e5r du en fejl. <\/p>\n\n
Opdatering af timelogs<\/h4>\n\n
Du kan opdatere timelog-data ved at sende PUT-foresp\u00f8rgsler til \/timelogs-endpoint, s\u00e5dan her:<\/p>\n\nFig. 13.<\/strong> Redigering af timelogs<\/figcaption><\/figure>\n\n
Bem\u00e6rk, at du skal have b\u00e5de beginTimelog- <\/strong>og endTimelog-datas\u00e6t <\/strong>for at kunne foretage en opdatering. Timelogs i Skyplanner gemmes p\u00e5 denne m\u00e5de: Hver “fuld” (timelog, der har b\u00e5de en start og en slutning (f.eks. shift_begin\/continued & paused\/shift_end) timelog har en separat enhed til start og slut. <\/p>\n\n
Disse er parret med begin_id-v\u00e6rdien <\/strong>, der findes i endlog. I ovenst\u00e5ende eksempel har beginTimelog id-v\u00e6rdien 1, og dermed har endTimelog begin_id-v\u00e6rdien <\/strong>1. <\/p>\n\n
Du skal ogs\u00e5 angive person_id- <\/strong>og endTimelog-v\u00e6rdierne <\/strong>, hver gang du laver en opdateringsanmodning, selv om du ikke \u00e6ndrer dem.<\/p>\n\n
Alternative m\u00e5der at lave timelogs p\u00e5<\/h4>\n\n
Her er nogle alternative m\u00e5der, du kan logge p\u00e5 dine jobs ved hj\u00e6lp af API’en.<\/p>\n\n
Logfuld<\/h5>\n\n
Hvis du vil sende b\u00e5de start- og sluttidsloggen i en enkelt anmodning, kan du bruge \/timelogs\/log-full<\/strong> -endpoint, s\u00e5dan her:<\/p>\n\nFig. 14.<\/strong> Logfuld anmodning<\/figcaption><\/figure>\n\n
Bem\u00e6rk, hvordan bel\u00f8bene sendes her: Den f\u00f8rste “amount”-v\u00e6rdi angiver det fejlbeh\u00e6ftede<\/strong> bel\u00f8b, og den anden angiver bel\u00f8bet<\/strong>. Denne anmodning opretter beginlog- og endlog-enhederne i en enkelt anmodning. <\/p>\n\n
Quicklog<\/h5>\n\n
“Quicklogging” til et job afslutter det i en enkelt anmodning og indstiller det afsluttede antal produkter til at matche den v\u00e6rdi, der er angivet i ordreposten. Quicklogging udf\u00f8res ved at bruge \/timelogs\/quick-log<\/strong> -endpoint: <\/p>\n\nFig. 15.<\/strong> Quicklogging<\/figcaption><\/figure>\n\n
Bem\u00e6rk, at du her kun beh\u00f8ver at angive production_planning_job_id<\/strong>, planned_workstation_id <\/strong>og person_id<\/strong>. V\u00e6rdierne for tid og bel\u00f8b udfyldes automatisk. Bem\u00e6rk ogs\u00e5, at quickloggede jobs altid afsluttes med shift_end-begivenheden, s\u00e5 der er ikke mulighed for yderligere logning efter 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\")