Voordat we in de timelogs duiken, moeten we eerst iets vertellen over de gegevensstructuur in Skyplanner en hoe alles onder de motorkap werkt. Dit zal later allemaal aan bod komen. <\/p>\n\n
Als je je order-\/werkorder-\/jobgegevens in Skyplanner hebt ge\u00efntegreerd, heb je waarschijnlijk ten minste deze API-endpoints gebruikt:<\/p>\n\n
\n
faser-bestellingen<\/li>\n\n\n\n
faser-order-rows<\/li>\n\n\n\n
faser-jobs<\/li>\n<\/ul>\n\n
Gegevens die in deze eindpunten worden ingevoerd, worden in de Skyplanner UI als volgt weergegeven:<\/p>\n
Na het invoegen van je orders in Skyplanner wil je ze exporteren<\/strong> (dit kan via de UI of het \/phaser-orders\/export-endpoint) naar de module Productieplanning:<\/p>\n\nFig 3.<\/strong> Exporteren via de UI<\/figcaption><\/figure>\n\nFig 4.<\/strong> Ge\u00ebxporteerde order in Productieplanning<\/figcaption><\/figure>\n\n
Bij het exporteren van orders kopieert Skyplanner de ordergegevens van de ene databasetabel naar de andere. Dus als je iets wijzigt via bijvoorbeeld het \/phaser-orders -endpoint, moet je de gegevens opnieuw exporteren om ze bij te werken in Productieplanning. Dit betekent ook dat je verschillende API-endpoints moet gebruiken om toegang te krijgen tot de orders die je ziet in het venster Productieplanning! <\/p>\n\n
De “gewijzigde” eindpunten gaan als volgt:<\/p>\n\n
Dit is belangrijk om te weten, want als je het \/timelogs -endpoint gebruikt om je productiegebeurtenissen etc. te loggen , moet je de gerelateerde entiteiten gebruiken die je vindt in Production Scheduling -endpoints!<\/strong><\/p>\n\n
Je hebt bijvoorbeeld de production_planning_job_id <\/strong> nodig (om te herhalen: production_planning_jobs zijn de entiteiten die worden benaderd vanaf het \/jobs -endpoint) om een nieuw timelog te POST’en:<\/p>\n\nFig 5.<\/strong> Tijdlog POST verzoek<\/figcaption><\/figure>\n\n
Je kunt de production_planning_job_id die je nodig hebt vinden via het \/phaser-jobs -endpoint:<\/p>\n\nFig 6.<\/strong> Phaser job GET verzoek (rood is phaser_job_id, NIET GEBRUIKEN IN TIMELOGS<\/strong>)<\/figcaption><\/figure>\n\n
Of vanaf het \/job -eindpunt:<\/p>\n\nFig 7.<\/strong> \/job GET-verzoek<\/figcaption><\/figure>\n\n
Tijdlogs maken met de REST-API<\/h4>\n\n
Het maken van tijdschema’s naar Skyplanner via de API maakt gebruik van dezelfde regels en systemen als in de UI. Het kan dus nuttig zijn om jezelf vertrouwd te maken met hoe het systeem werkt in de UI voordat je het probeert te gebruiken via de API. <\/p>\n\n
Basisprincipes tijdlog<\/h5>\n\n
Skyplanner heeft vier soorten tijdloggebeurtenissen:<\/p>\n\n
\n
shift_begin<\/li>\n\n\n\n
gepauzeerd<\/li>\n\n\n\n
vervolg<\/li>\n\n\n\n
shift_einde<\/li>\n<\/ul>\n\n
Shift_begin-event wordt verzonden wanneer de taak voor de eerste keer wordt gestart. Stuur nooit meer dan \u00e9\u00e9n shift_begin-event voor elke taak!<\/strong><\/p>\n\n
Met Paused-event wordt de taak gepauzeerd.<\/p>\n\n
Continued-event hervat een gepauzeerde taak.<\/p>\n\n
Shift_end voltooit de taak. Stuur nooit meer dan \u00e9\u00e9n shift_end gebeurtenis voor elke taak!<\/strong><\/p>\n\n
Vereiste gegevens voor timelogs:<\/p>\n\n
\n
persoon_id\n
\n
Kan worden gevonden via het \/people-endpoint<\/li>\n\n\n\n
Niet hetzelfde als user_id!<\/li>\n<\/ul>\n<\/li>\n\n\n\n
gepland_werkstation_id\n
\n
De werkplek waar de taak wordt uitgevoerd<\/li>\n\n\n\n
Kan worden gevonden vanaf het \/workstations-eindpunt<\/li>\n<\/ul>\n<\/li>\n\n\n\n
datum_tijd\n
\n
Het tijdstip waarop de gebeurtenis plaatsvindt<\/li>\n\n\n\n
Om te specificeren welke Skyplanner timelog gekoppeld is aan de timelog van welk extern systeem je ook gebruikt, kun je het external_id <\/strong>veld gebruiken. Je kunt dan bijvoorbeeld GET-verzoeken doen met dit id om een specifiek timelog van Skyplanner te vinden. <\/p>\n\nFig 8.<\/strong> External_id in timelogs<\/figcaption><\/figure>\n\n
Een baan beginnen<\/h4>\n\n
Je kunt taken starten door een POST-verzoek als dit naar de API te sturen:<\/p>\n\nFig 9.<\/strong> Shift_begin tijdlog<\/figcaption><\/figure>\n\n
Stel bij het instellen van de POST-gegevens voor de timelogs workshift_id <\/strong>in op 0 en timelog_finalized <\/strong>op true<\/strong>.<\/p>\n\n
Een taak onderbreken<\/h4>\n\n
Taken pauzeren door een POST-verzoek als dit te verzenden:<\/p>\n\nFig 10.<\/strong> Gepauzeerd tijdlogboek<\/figcaption><\/figure>\n\n
In timelogs van het gepauzeerde type kun je het bedrag <\/strong>en fout_bedrag<\/strong> instellen. Let ook op het timelogtype <\/strong>en de date_time<\/strong>. <\/p>\n\n
Een baan voortzetten<\/h4>\n\n
Zo ga je verder met een gepauzeerd timelog:<\/p>\n\nFig 11.<\/strong> Voortgezet tijdlogboek<\/figcaption><\/figure>\n\n
Merk op dat als je een taak probeert voort te zetten die is be\u00ebindigd door een shift_end gebeurtenis, je een foutmelding krijgt.<\/p>\n\n
Een baan be\u00ebindigen<\/h4>\n\n
Hier zie je hoe je een taak be\u00ebindigt met een shift_end timelog:<\/p>\n\nFig 12.<\/strong> Tijdlog shift_einde<\/figcaption><\/figure>\n\n
In shift_end-events kun je de waarden amount <\/strong>en faulty_amount <\/strong>opgeven, net als in paused-events. Merk op dat als je een shift_end-event probeert uit te voeren op een taak die niet actief is, je een foutmelding krijgt. <\/p>\n\n
Tijdlogs bijwerken<\/h4>\n\n
Je kunt timeloggegevens bijwerken door PUT-verzoeken te sturen naar het \/timelogs-endpoint, zoals dit:<\/p>\n\nFig 13.<\/strong> Tijdlogboeken bewerken<\/figcaption><\/figure>\n\n
Merk op dat je zowel de beginTimelog <\/strong>als de eindTimelog <\/strong>gegevens moet hebben om een update te kunnen doen. Timelogs in Skyplanner worden als volgt opgeslagen: elke “volledige” (timelog die zowel een begin als einde heeft (bijv. shift_begin\/continued & paused\/shift_end) timelog heeft een aparte entiteit voor het begin en einde. <\/p>\n\n
Deze worden gekoppeld door de begin_id <\/strong>waarde die gevonden wordt in het eindlog. In het bovenstaande voorbeeld heeft de beginTimelog de id-waarde 1 en dus heeft de eindTimelog de begin_id <\/strong>waarde 1. <\/p>\n\n
Je moet ook de person_id <\/strong>en endTimelog <\/strong>waarden opgeven voor elke keer dat je een updateverzoek doet, zelfs als je ze niet wijzigt.<\/p>\n\n
Alternatieve manieren om tijdlogs te maken<\/h4>\n\n
Hier zijn enkele alternatieve manieren waarop je je kunt aanmelden bij je taken met behulp van de API.<\/p>\n\n
Logfull<\/h5>\n\n
Als je zowel de begin- als eindtijdlogs in een enkel verzoek wilt verzenden, kun je het \/timelogs\/log-full<\/strong> -endpoint gebruiken, zoals dit:<\/p>\n\nFig 14.<\/strong> Logfull verzoek<\/figcaption><\/figure>\n\n
Merk op hoe de bedragen hier worden verzonden: de eerste “amount” waarde duidt het foutieve bedrag<\/strong> aan en de tweede het bedrag<\/strong>. Dit verzoek cre\u00ebert de entiteiten beginlog en endlog in \u00e9\u00e9n enkel verzoek. <\/p>\n\n
Snellog<\/h5>\n\n
“Quicklogging” naar een taak voltooit deze in een enkele aanvraag en stelt het voltooide aantal producten in op de waarde die is ingesteld in het bestelitem. Quicklogging wordt gedaan met behulp van het \/timelogs\/quick-log<\/strong> -endpoint: <\/p>\n\nFig 15.<\/strong> Snelloggen<\/figcaption><\/figure>\n\n
Merk op dat je hier alleen de production_planning_job_id<\/strong>, planned_workstation_id <\/strong>en person_id<\/strong> hoeft op te geven. De waarden voor tijd en bedrag worden automatisch ingevuld. Merk ook op dat quicklogged jobs altijd worden voltooid met de shift_end-event, dus er is geen verdere logging mogelijk na 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\")