Zanim zag\u0142\u0119bimy si\u0119 w dzienniki czasowe, musimy om\u00f3wi\u0107 nieco struktur\u0119 danych w Skyplanner i spos\u00f3b dzia\u0142ania pod mask\u0105. Wszystko to zostanie om\u00f3wione p\u00f3\u017aniej. <\/p>\n\n
Je\u015bli zintegrowa\u0142e\u015b swoje dane dotycz\u0105ce zam\u00f3wie\u0144\/zlece\u0144\/zada\u0144 w Skyplanner, najprawdopodobniej korzysta\u0142e\u015b przynajmniej z tych punkt\u00f3w ko\u0144cowych API:<\/p>\n\n
\n
phaser-orders<\/li>\n\n\n\n
phaser-order-rows<\/li>\n\n\n\n
phaser-jobs<\/li>\n<\/ul>\n\n
W rzeczywisto\u015bci dane wprowadzane do tych punkt\u00f3w ko\u0144cowych s\u0105 reprezentowane w interfejsie u\u017cytkownika Skyplanner w nast\u0119puj\u0105cy spos\u00f3b:<\/p>\n
\nRys. 1.<\/strong> Zam\u00f3wienie (phaser-orders)<\/figcaption><\/figure>\n<\/div>\nRys. 2.<\/strong> Pozycje zam\u00f3wienia (phaser-order-rows (czerwony)), Kroki procesu (phaser-jobs (zielony))<\/figcaption><\/figure>\n\n
Po wstawieniu zam\u00f3wie\u0144 do Skyplannera nale\u017cy je wyeksportowa\u0107<\/strong> (mo\u017cna to zrobi\u0107 za po\u015brednictwem interfejsu u\u017cytkownika lub punktu ko\u0144cowego \/phaser-orders\/export-endpoint) do modu\u0142u planowania produkcji:<\/p>\n\nRys. 3.<\/strong> Eksportowanie przez interfejs u\u017cytkownika<\/figcaption><\/figure>\n\nRys. 4.<\/strong> Wyeksportowane zlecenie w harmonogramie produkcji<\/figcaption><\/figure>\n\n
Podczas eksportowania zam\u00f3wie\u0144 Skyplanner skutecznie kopiuje dane zam\u00f3wienia z jednej tabeli bazy danych do drugiej. Je\u015bli wi\u0119c zmienisz co\u015b, na przyk\u0142ad za pomoc\u0105 punktu ko\u0144cowego \/phaser-orders, musisz ponownie wyeksportowa\u0107 dane, aby zaktualizowa\u0107 je w Harmonogramie produkcji. Oznacza to r\u00f3wnie\u017c, \u017ce aby uzyska\u0107 dost\u0119p do zam\u00f3wie\u0144 widocznych w oknie harmonogramu produkcji, nale\u017cy u\u017cy\u0107 r\u00f3\u017cnych punkt\u00f3w ko\u0144cowych API! <\/p>\n\n
„Zmienione” punkty ko\u0144cowe wygl\u0105daj\u0105 nast\u0119puj\u0105co:<\/p>\n\n
Warto o tym wiedzie\u0107, poniewa\u017c podczas korzystania z punktu ko\u0144cowego<\/strong> \/timelogs do rejestrowania zdarze\u0144 produkcyjnych itp. nale\u017cy u\u017cywa\u0107 powi\u0105zanych jednostek znajduj\u0105cych si\u0119 w punktach ko\u0144cowych harmonogramu produkcji!<\/strong><\/p>\n\n
Na przyk\u0142ad, potrzebujesz production_planning_job_id <\/strong>(aby powt\u00f3rzy\u0107: production_planning_jobs to jednostki dost\u0119pne z punktu ko\u0144cowego \/jobs), aby POST nowy dziennik czasu:<\/p>\n\nRys. 5.<\/strong> \u017b\u0105danie POST dziennika czasu<\/figcaption><\/figure>\n\n
Potrzebny identyfikator production_planning_job_id mo\u017cna znale\u017a\u0107 w punkcie ko\u0144cowym \/phaser-jobs:<\/p>\n\nRys. 6.<\/strong> \u017b\u0105danie GET zadania Phaser (czerwony to phaser_job_id, NIE U\u017bYWAJ GO W TIMELOGACH<\/strong>)<\/figcaption><\/figure>\n\n
Lub z punktu ko\u0144cowego \/job:<\/p>\n\nRys. 7.<\/strong> \/job GET request<\/figcaption><\/figure>\n\n
Tworzenie dziennik\u00f3w czasu przy u\u017cyciu interfejsu REST-API<\/h4>\n\n
Tworzenie dziennik\u00f3w czasowych do Skyplanner przez API wykorzystuje te same zasady i systemy, kt\u00f3re s\u0105 w interfejsie u\u017cytkownika. Warto wi\u0119c zapozna\u0107 si\u0119 z dzia\u0142aniem systemu w interfejsie u\u017cytkownika przed podj\u0119ciem pr\u00f3by korzystania z niego za po\u015brednictwem API. <\/p>\n\n
Podstawy dziennika czasu<\/h5>\n\n
Skyplanner posiada cztery typy zdarze\u0144 dziennika czasu:<\/p>\n\n
\n
shift_begin<\/li>\n\n\n\n
wstrzymany<\/li>\n\n\n\n
cd.<\/li>\n\n\n\n
shift_end<\/li>\n<\/ul>\n\n
Zdarzenie Shift_begin jest wysy\u0142ane, gdy zadanie jest uruchamiane po raz pierwszy. Nigdy nie wysy\u0142aj wi\u0119cej ni\u017c jednego zdarzenia shift_begin dla ka\u017cdego zadania!<\/strong><\/p>\n\n
Aby okre\u015bli\u0107, kt\u00f3ry dziennik czasu Skyplanner jest powi\u0105zany z dziennikiem czasu z dowolnego u\u017cywanego systemu zewn\u0119trznego, mo\u017cna u\u017cy\u0107 pola external_id <\/strong>. Nast\u0119pnie mo\u017cna na przyk\u0142ad wysy\u0142a\u0107 \u017c\u0105dania GET przy u\u017cyciu tego identyfikatora w celu znalezienia okre\u015blonego dziennika czasowego ze Skyplanner. <\/p>\n\nRys. 8.<\/strong> External_id w dziennikach czasowych<\/figcaption><\/figure>\n\n
Rozpocz\u0119cie pracy<\/h4>\n\n
Zadania mo\u017cna uruchamia\u0107, wysy\u0142aj\u0105c do interfejsu API \u017c\u0105danie POST w nast\u0119puj\u0105cy spos\u00f3b:<\/p>\n\nRys. 9.<\/strong> Shift_begin timelog<\/figcaption><\/figure>\n\n
Podczas ustawiania danych POST dla dziennik\u00f3w czasowych ustaw workshift_id <\/strong>na 0 i timelog_finalized <\/strong>na true<\/strong>.<\/p>\n\n
Wstrzymywanie zadania<\/h4>\n\n
Wstrzymaj zadania, wysy\u0142aj\u0105c \u017c\u0105danie POST w nast\u0119puj\u0105cy spos\u00f3b:<\/p>\n\nRys. 10.<\/strong> Wstrzymany dziennik czasu<\/figcaption><\/figure>\n\n
W dziennikach czasu typu wstrzymanego mo\u017cna ustawi\u0107 kwot\u0119 <\/strong>i faulty_amount<\/strong>. Nale\u017cy r\u00f3wnie\u017c zwr\u00f3ci\u0107 uwag\u0119 na typ <\/strong>dziennika czasu i date_time<\/strong>. <\/p>\n\n
Kontynuacja pracy<\/h4>\n\n
Oto jak kontynuowa\u0107 wstrzymany dziennik czasu:<\/p>\n\nRys. 11.<\/strong> Ci\u0105g dalszy dziennika czasu<\/figcaption><\/figure>\n\n
Oto jak zako\u0144czy\u0107 zadanie za pomoc\u0105 dziennika czasu shift_end:<\/p>\n\nRys. 12.<\/strong> Dziennik czasu Shift_end<\/figcaption><\/figure>\n\n
W shift_end-events mo\u017cna poda\u0107 warto\u015bci amount <\/strong>i faulty_amount <\/strong>, tak jak w paused-events. Nale\u017cy pami\u0119ta\u0107, \u017ce pr\u00f3ba wykonania zdarzenia shift_end dla zadania, kt\u00f3re nie jest uruchomione, spowoduje wy\u015bwietlenie b\u0142\u0119du. <\/p>\n\n
Aktualizacja dziennik\u00f3w czasowych<\/h4>\n\n
Dane dziennika czasu mo\u017cna aktualizowa\u0107, wysy\u0142aj\u0105c \u017c\u0105dania PUT do punktu ko\u0144cowego \/timelogs-endpoint w nast\u0119puj\u0105cy spos\u00f3b:<\/p>\n\nRys. 13.<\/strong> Edycja dziennik\u00f3w czasowych<\/figcaption><\/figure>\n\n
Nale\u017cy pami\u0119ta\u0107, \u017ce aby wykona\u0107 aktualizacj\u0119, trzeba mie\u0107 ustawione zar\u00f3wno dane beginTimelog <\/strong>, jak i endTimelog <\/strong>. Dzienniki czasowe w Skyplanner s\u0105 przechowywane w nast\u0119puj\u0105cy spos\u00f3b: ka\u017cdy „pe\u0142ny” (dziennik czasowy, kt\u00f3ry ma zar\u00f3wno pocz\u0105tek, jak i koniec (np. shift_begin\/continued & paused\/shift_end) dziennik czasowy ma oddzieln\u0105 jednostk\u0119 dla pocz\u0105tku i ko\u0144ca. <\/p>\n\n
S\u0105 one sparowane przez warto\u015b\u0107 begin_id <\/strong>znalezion\u0105 w endlog. W powy\u017cszym przyk\u0142adzie beginTimelog ma warto\u015b\u0107 id r\u00f3wn\u0105 1, a zatem jego endTimelog ma warto\u015b\u0107 begin_id <\/strong>r\u00f3wn\u0105 1. <\/p>\n\n
Musisz r\u00f3wnie\u017c poda\u0107 warto\u015bci person_id <\/strong>i endTimelog <\/strong>za ka\u017cdym razem, gdy wykonujesz \u017c\u0105danie aktualizacji, nawet je\u015bli ich nie zmieniasz.<\/p>\n\n
Alternatywne sposoby tworzenia dziennik\u00f3w czasowych<\/h4>\n\n
Oto kilka alternatywnych sposob\u00f3w logowania si\u0119 do zada\u0144 przy u\u017cyciu interfejsu API.<\/p>\n\n
Logfull<\/h5>\n\n
Je\u015bli chcesz wys\u0142a\u0107 zar\u00f3wno pocz\u0105tkowe, jak i ko\u0144cowe dzienniki czasowe w jednym \u017c\u0105daniu, mo\u017cesz u\u017cy\u0107 punktu ko\u0144cowego \/timelogs\/log-full<\/strong>, jak poni\u017cej:<\/p>\n\nRys. 14.<\/strong> \u017b\u0105danie logfull<\/figcaption><\/figure>\n\n
Zwr\u00f3\u0107 uwag\u0119, w jaki spos\u00f3b przesy\u0142ane s\u0105 tutaj kwoty: pierwsza warto\u015b\u0107 „amount” oznacza b\u0142\u0119dn\u0105 kwot\u0119<\/strong>, a druga kwot\u0119<\/strong>. To \u017c\u0105danie tworzy encje beginlog i endlog w jednym \u017c\u0105daniu. <\/p>\n\n
Quicklog<\/h5>\n\n
„Szybkie logowanie” do zadania ko\u0144czy je w jednym \u017c\u0105daniu, ustawia uko\u0144czon\u0105 ilo\u015b\u0107 produkt\u00f3w, aby odpowiada\u0142a warto\u015bci ustawionej w pozycji zam\u00f3wienia. Szybkie logowanie odbywa si\u0119 za pomoc\u0105 punktu ko\u0144cowego \/timelogs\/quick-log<\/strong>: <\/p>\n\nRys. 15.<\/strong> Szybkie logowanie<\/figcaption><\/figure>\n\n
Nale\u017cy pami\u0119ta\u0107, \u017ce tutaj wystarczy poda\u0107 tylko production_planning_job_id<\/strong>, planned_workstation_id <\/strong>i person_id<\/strong>. Warto\u015bci czasu i kwoty s\u0105 wype\u0142niane automatycznie. Nale\u017cy r\u00f3wnie\u017c pami\u0119ta\u0107, \u017ce szybkie rejestrowanie zada\u0144 jest zawsze zako\u0144czone zdarzeniem shift_end, wi\u0119c dalsze rejestrowanie nie jest mo\u017cliwe po szybkim rejestrowaniu! <\/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\")