Bevor wir uns mit den Zeitprotokollen befassen, m\u00fcssen wir ein wenig \u00fcber die Datenstruktur in Skyplanner sprechen und dar\u00fcber, wie die Dinge unter der Haube funktionieren. All dies wird sp\u00e4ter ins Spiel kommen. <\/p>\n\n
Wenn Sie Ihre Auftrags-\/Arbeitsauftrags-\/Jobdaten in Skyplanner integriert haben, haben Sie h\u00f6chstwahrscheinlich mindestens diese API-Endpunkte verwendet:<\/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
Die in diese Endpunkte eingegebenen Daten werden in der Skyplanner-Benutzeroberfl\u00e4che wie folgt dargestellt:<\/p>\n
Nachdem Sie Ihre Auftr\u00e4ge in Skyplanner eingef\u00fcgt haben, m\u00fcssen Sie sie<\/strong> in das Modul Produktionsplanung exportieren<\/strong> (dies kann \u00fcber die Benutzeroberfl\u00e4che oder den Endpunkt \/phaser-orders\/export erfolgen):<\/p>\n\nAbb. 3.<\/strong> Exportieren \u00fcber die Benutzeroberfl\u00e4che<\/figcaption><\/figure>\n\nAbb. 4.<\/strong> Exportierter Auftrag in der Produktionsplanung<\/figcaption><\/figure>\n\n
Beim Exportieren von Auftr\u00e4gen kopiert Skyplanner die Auftragsdaten von einer Datenbanktabelle in eine andere. Wenn Sie also z.B. \u00fcber den \/phaser-orders -Endpunkt etwas \u00e4ndern, m\u00fcssen Sie die Daten erneut exportieren, um sie in Production Scheduling zu aktualisieren. Das bedeutet auch, dass Sie f\u00fcr den Zugriff auf die Auftr\u00e4ge, die Sie im Produktionsplanungsfenster sehen, verschiedene API-Endpunkte verwenden m\u00fcssen! <\/p>\n\n
Die „ge\u00e4nderten“ Endpunkte sehen folgenderma\u00dfen aus:<\/p>\n\n
Dies ist wichtig zu wissen, denn wenn Sie den \/timelogs -Endpunkt verwenden, um Ihre Produktionsereignisse usw. zu protokollieren , m\u00fcssen Sie die entsprechenden Entit\u00e4ten verwenden, die Sie unter Produktionsplanungs -Endpunkten finden!<\/strong><\/p>\n\n
Sie ben\u00f6tigen zum Beispiel die production_planning_job_id <\/strong>(zur Erinnerung: production_planning_jobs sind die Entit\u00e4ten, auf die \u00fcber den \/jobs -Endpunkt zugegriffen wird), um ein neues Zeitprotokoll zu POSTen:<\/p>\n\nAbb. 5.<\/strong> Timelog POST-Anfrage<\/figcaption><\/figure>\n\n
Sie finden die production_planning_job_id, die Sie ben\u00f6tigen, entweder \u00fcber den \/phaser-jobs -Endpunkt:<\/p>\n\nAbb. 6.<\/strong> GET-Anfrage f\u00fcr einen Phaser-Job (rot ist phaser_job_id, verwenden Sie sie NICHT in TIMELOGS<\/strong>)<\/figcaption><\/figure>\n\n
Oder \u00fcber den \/job -Endpunkt:<\/p>\n\nAbb. 7.<\/strong> \/job GET-Anfrage<\/figcaption><\/figure>\n\n
Erstellen von Zeitprotokollen mit der REST-API<\/h4>\n\n
Bei der Erstellung von Zeitprotokollen f\u00fcr Skyplanner \u00fcber die API werden dieselben Regeln und Systeme verwendet, die auch in der Benutzeroberfl\u00e4che enthalten sind. Es k\u00f6nnte also von Vorteil sein, sich mit der Funktionsweise des Systems in der Benutzeroberfl\u00e4che vertraut zu machen, bevor Sie versuchen, es \u00fcber die API zu verwenden. <\/p>\n\n
Timelog Grundlagen<\/h5>\n\n
Skyplanner verf\u00fcgt \u00fcber vier Timelog-Ereignistypen:<\/p>\n\n
\n
verschieben_beginnen<\/li>\n\n\n\n
pausiert<\/li>\n\n\n\n
Fortsetzung<\/li>\n\n\n\n
shift_end<\/li>\n<\/ul>\n\n
Das Shift_begin-Ereignis wird gesendet, wenn der Auftrag zum ersten Mal gestartet wird. Senden Sie niemals mehr als ein shift_begin-Ereignis f\u00fcr jeden Auftrag!<\/strong><\/p>\n\n
Pausen-Ereignis pausiert den Auftrag.<\/p>\n\n
Fortsetzungs-Ereignis setzt eine angehaltene Arbeit fort.<\/p>\n\n
Shift_end schlie\u00dft den Auftrag ab. Senden Sie niemals mehr als ein shift_end-Ereignis f\u00fcr jeden Auftrag!<\/strong><\/p>\n\n
Erforderliche Daten f\u00fcr Timelogs:<\/p>\n\n
\n
person_id\n
\n
Kann \u00fcber den \/people-Endpunkt gefunden werden<\/li>\n\n\n\n
Nicht dasselbe wie user_id!<\/li>\n<\/ul>\n<\/li>\n\n\n\n
geplante_arbeitsplatz_id\n
\n
Der Arbeitsplatz, an dem die Arbeit ausgef\u00fchrt wird<\/li>\n\n\n\n
Kann \u00fcber den Endpunkt \/workstations gefunden werden<\/li>\n<\/ul>\n<\/li>\n\n\n\n
Datum_Zeit\n
\n
Der Zeitpunkt, zu dem das Ereignis durchgef\u00fchrt wird<\/li>\n\n\n\n
Um anzugeben, welches Skyplanner-Timelog mit dem Timelog des von Ihnen verwendeten externen Systems verkn\u00fcpft ist, k\u00f6nnen Sie das Feld external_id <\/strong>verwenden. Sie k\u00f6nnen dann zum Beispiel GET-Anfragen mit dieser ID stellen, um ein bestimmtes Timelog von Skyplanner zu finden. <\/p>\n\nAbb. 8.<\/strong> External_id in Timelogs<\/figcaption><\/figure>\n\n
Einen Job beginnen<\/h4>\n\n
Sie k\u00f6nnen Auftr\u00e4ge starten, indem Sie eine POST-Anfrage wie diese an die API senden:<\/p>\n\nAbb. 9.<\/strong> Schicht_Anfang Timelog<\/figcaption><\/figure>\n\n
Setzen Sie beim Einstellen der POST-Daten f\u00fcr die Zeitprotokolle workshift_id <\/strong>auf 0 und timelog_finalized <\/strong>auf true<\/strong><\/p>\n\n
Auftrag pausieren<\/h4>\n\n
Pausieren Sie Auftr\u00e4ge, indem Sie eine POST-Anfrage wie diese senden:<\/p>\n\nAbb. 10.<\/strong> Pausiertes Timelog<\/figcaption><\/figure>\n\n
In Timelogs vom Typ paused k\u00f6nnen Sie den Betrag <\/strong>und faulty_amount<\/strong> festlegen. Beachten Sie auch den Timelog-Typ <\/strong>und date_time<\/strong>. <\/p>\n\n
Einen Job fortsetzen<\/h4>\n\n
So setzen Sie ein angehaltenes Timelog fort:<\/p>\n\nAbb. 11.<\/strong> Fortsetzung Timelog<\/figcaption><\/figure>\n\n
Beachten Sie, dass Sie eine Fehlermeldung erhalten, wenn Sie versuchen, einen Auftrag fortzusetzen, der durch ein shift_end Ereignis beendet wurde.<\/p>\n\n
Beenden eines Jobs<\/h4>\n\n
Hier sehen Sie, wie Sie einen Auftrag mit einem shift_end timelog beenden:<\/p>\n\nAbb. 12.<\/strong> Schicht_Ende timelog<\/figcaption><\/figure>\n\n
In shift_end-events k\u00f6nnen Sie die Werte amount <\/strong>und faulty_amount <\/strong>genau wie in paused-events angeben. Beachten Sie, dass Sie eine Fehlermeldung erhalten, wenn Sie versuchen, ein shift_end-Ereignis f\u00fcr einen Job zu erzeugen, der nicht l\u00e4uft. <\/p>\n\n
Timelogs aktualisieren<\/h4>\n\n
Sie k\u00f6nnen die Zeitprotokolldaten aktualisieren, indem Sie PUT-Anfragen an den \/timelogs-endpoint senden, etwa so:<\/p>\n\nAbb. 13.<\/strong> Timelogs bearbeiten<\/figcaption><\/figure>\n\n
Beachten Sie, dass Sie sowohl beginTimelog- <\/strong>als auch endTimelog-Daten <\/strong>eingestellt haben m\u00fcssen, um eine Aktualisierung vornehmen zu k\u00f6nnen. Zeitprotokolle in Skyplanner werden wie folgt gespeichert: Jedes „vollst\u00e4ndige“ (Zeitprotokoll, das sowohl einen Anfang als auch ein Ende hat (z.B. Schichtbeginn\/fortgesetzt & pausiert\/Schichtende) hat eine separate Entit\u00e4t f\u00fcr den Anfang und das Ende. <\/p>\n\n
Diese werden durch den begin_id-Wert <\/strong>gepaart, der im endTimelog gefunden wurde. Im obigen Beispiel hat das beginTimelog den id-Wert 1 und somit hat sein endTimelog den begin_id-Wert <\/strong>1. <\/p>\n\n
Sie m\u00fcssen auch die Werte person_id <\/strong>und endTimelog <\/strong>bei jeder Aktualisierungsanfrage angeben, auch wenn Sie sie nicht \u00e4ndern.<\/p>\n\n
Alternative M\u00f6glichkeiten zur Erstellung von Timelogs<\/h4>\n\n
Hier finden Sie einige alternative M\u00f6glichkeiten, wie Sie sich \u00fcber die API bei Ihren Auftr\u00e4gen anmelden k\u00f6nnen.<\/p>\n\n
Logfull<\/h5>\n\n
Wenn Sie sowohl den Beginn als auch das Ende des Zeitprotokolls in einer einzigen Anfrage senden m\u00f6chten, k\u00f6nnen Sie den \/timelogs\/log-full<\/strong> -Endpunkt verwenden, etwa so:<\/p>\n\nAbb. 14.<\/strong> Logfull Anfrage<\/figcaption><\/figure>\n\n
Beachten Sie, wie die Betr\u00e4ge hier gesendet werden: der erste Wert „amount“ bezeichnet den fehlerhaften Betrag<\/strong> und der zweite den Betrag<\/strong>. Diese Anfrage erstellt die Entit\u00e4ten beginlog und endlog in einer einzigen Anfrage. <\/p>\n\n
Quicklog<\/h5>\n\n
Das „Quicklogging“ zu einem Auftrag schlie\u00dft diesen in einer einzigen Anfrage ab und setzt die abgeschlossene Anzahl der Produkte auf den Wert, der in der Auftragsposition festgelegt wurde. Das Quicklogging erfolgt \u00fcber den \/timelogs\/quick-log<\/strong> -Endpunkt: <\/p>\n\nAbb. 15.<\/strong> Quicklogging<\/figcaption><\/figure>\n\n
Beachten Sie, dass Sie hier nur die production_planning_job_id<\/strong>, planned_workstation_id <\/strong>und person_id<\/strong> angeben m\u00fcssen. Die Werte f\u00fcr Zeit und Betrag werden automatisch ausgef\u00fcllt. Beachten Sie auch, dass Quicklog-Auftr\u00e4ge immer mit dem shift_end-Ereignis abgeschlossen werden, so dass nach Quicklog keine weitere Protokollierung m\u00f6glich ist! <\/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\")