Structure des donn\u00e9es de Skyplanner<\/h4>\n\n
Avant de nous plonger dans les timelogs, nous devons parler un peu de la structure des donn\u00e9es dans Skyplanner et de la fa\u00e7on dont les choses fonctionnent sous le capot. Tout cela entrera en ligne de compte plus tard. <\/p>\n\n
Si vous avez int\u00e9gr\u00e9 vos donn\u00e9es de commande, d’ordre de travail ou d’emploi dans Skyplanner, vous avez probablement utilis\u00e9 au moins ces points API :<\/p>\n\n
\n
commandes de phasers<\/li>\n\n\n\n
phaser-order-rows<\/li>\n\n\n\n
phaser-jobs<\/li>\n<\/ul>\n\n
En effet, les donn\u00e9es ins\u00e9r\u00e9es dans ces points de terminaison sont repr\u00e9sent\u00e9es dans l’interface utilisateur de Skyplanner de la mani\u00e8re suivante :<\/p>\n
\nFig. 1.<\/strong> Commande (phaser-orders)<\/figcaption><\/figure>\n<\/div>\nFig. 2.<\/strong> Articles de commande (phaser-order-rows (rouge)), \u00e9tapes du processus (phaser-jobs (vert))<\/figcaption><\/figure>\n\n
Apr\u00e8s avoir ins\u00e9r\u00e9 vos commandes dans Skyplanner, vous voudrez les exporter<\/strong> (vous pouvez le faire via l’interface utilisateur ou le point de terminaison \/phaser-orders\/export) dans le module Production Scheduling :<\/p>\n\nFig. 3.<\/strong> Exporter via l’interface utilisateur<\/figcaption><\/figure>\n\nFig. 4.<\/strong> Ordre export\u00e9 dans l’ordonnancement de la production<\/figcaption><\/figure>\n\n
Lors de l’exportation des commandes, Skyplanner copie effectivement les donn\u00e9es de la commande d’une table de base de donn\u00e9es \u00e0 une autre. Par cons\u00e9quent, si vous modifiez quelque chose, par exemple via le point de terminaison \/phaser-orders, vous devez exporter \u00e0 nouveau les donn\u00e9es pour les mettre \u00e0 jour dans la planification de la production. Cela signifie \u00e9galement que pour acc\u00e9der aux commandes que vous voyez dans la fen\u00eatre de planification de la production, vous devez utiliser diff\u00e9rents points de terminaison API ! <\/p>\n\n
Les points de terminaison \u00ab\u00a0modifi\u00e9s\u00a0\u00bb se pr\u00e9sentent comme suit :<\/p>\n\n
Il est important de le savoir, car lorsque vous utilisez le point de terminaison \/timelogs pour enregistrer vos \u00e9v\u00e9nements de production, etc., vous devez utiliser les entit\u00e9s connexes trouv\u00e9es dans les points de terminaison Production Scheduling !<\/strong><\/p>\n\n
Par exemple, vous avez besoin du production_planning_job_id <\/strong>(pour rappel : les production_planning_jobs sont les entit\u00e9s auxquelles on acc\u00e8de \u00e0 partir du point de terminaison \/jobs) pour POST un nouveau timelog :<\/p>\n\nFig. 5.<\/strong> Demande POST de l’historique<\/figcaption><\/figure>\n\n
Vous pouvez trouver le production_planning_job_id dont vous avez besoin \u00e0 partir du point de terminaison \/phaser-jobs :<\/p>\n\nFig. 6.<\/strong> Demande GET d’un travail Phaser (le rouge est le phaser_job_id, NE L’UTILISEZ PAS DANS LES TIMELOGS<\/strong>)<\/figcaption><\/figure>\n\n
Ou \u00e0 partir du point de terminaison \/job :<\/p>\n\nFig. 7.<\/strong> \/job GET request<\/figcaption><\/figure>\n\n
Cr\u00e9ation de timelogs \u00e0 l’aide de l’API REST<\/h4>\n\n
La cr\u00e9ation d’enregistrements temporels pour Skyplanner via l’API utilise les m\u00eames r\u00e8gles et syst\u00e8mes que ceux de l’interface utilisateur. Il peut donc \u00eatre utile de vous familiariser avec le fonctionnement du syst\u00e8me dans l’interface utilisateur avant d’essayer de l’utiliser via l’API. <\/p>\n\n
Principes de base du journal chronologique<\/h5>\n\n
Skyplanner propose quatre types d’\u00e9v\u00e9nements :<\/p>\n\n
\n
d\u00e9but_mise_en_place<\/li>\n\n\n\n
en pause<\/li>\n\n\n\n
continue<\/li>\n\n\n\n
shift_end<\/li>\n<\/ul>\n\n
L’\u00e9v\u00e9nement Shift_begin est envoy\u00e9 lorsque le travail est lanc\u00e9 pour la premi\u00e8re fois. N’envoyez jamais plus d’un \u00e9v\u00e9nement shift_begin pour chaque travail !<\/strong><\/p>\n\n
L’\u00e9v\u00e9nement Paused met le travail en pause.<\/p>\n\n
Continued-event reprend un travail en pause.<\/p>\n\n
Shift_end termine le travail. N’envoyez jamais plus d’un \u00e9v\u00e9nement shift_end pour chaque travail !<\/strong><\/p>\n\n
Donn\u00e9es requises pour les calendriers :<\/p>\n\n
\n
identifiant_personne\n
\n
Vous pouvez le trouver \u00e0 partir du point de terminaison \/people<\/li>\n\n\n\n
Pas la m\u00eame chose que user_id !<\/li>\n<\/ul>\n<\/li>\n\n\n\n
planned_workstation_id\n
\n
Le poste de travail o\u00f9 le travail est effectu\u00e9<\/li>\n\n\n\n
Peut \u00eatre trouv\u00e9 \u00e0 partir du point de terminaison \/workstations-endpoint<\/li>\n<\/ul>\n<\/li>\n\n\n\n
date_heure\n
\n
Le moment o\u00f9 l’\u00e9v\u00e9nement est r\u00e9alis\u00e9<\/li>\n\n\n\n
Format : 2024-01-01 10:30:11<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n
Afin de sp\u00e9cifier quel timelog de Skyplanner est li\u00e9 au timelog du syst\u00e8me externe que vous utilisez, vous pouvez utiliser le champ external_id <\/strong>. Vous pouvez alors, par exemple, effectuer des requ\u00eates GET en utilisant cet identifiant afin de trouver un historique sp\u00e9cifique de Skyplanner. <\/p>\n\nFig. 8.<\/strong> External_id dans les timelogs<\/figcaption><\/figure>\n\n
D\u00e9marrer un emploi<\/h4>\n\n
Vous pouvez lancer des t\u00e2ches en envoyant une demande POST comme celle-ci \u00e0 l’API :<\/p>\n\nFig. 9.<\/strong> D\u00e9but de l’historique<\/figcaption><\/figure>\n\n
Lorsque vous d\u00e9finissez les donn\u00e9es POST pour les timelogs, d\u00e9finissez workshift_id <\/strong>comme 0 et timelog_finalized <\/strong>comme true.<\/strong><\/p>\n\n
Mise en pause d’un travail<\/h4>\n\n
Mettez les travaux en pause en envoyant une requ\u00eate POST comme suit :<\/p>\n\nFig. 10.<\/strong> Journal de bord en pause<\/figcaption><\/figure>\n\n
Dans les journaux temporels de type pause, vous pouvez d\u00e9finir le montant <\/strong>et faulty_amount<\/strong>. Notez \u00e9galement le type de <\/strong>journal et la date_heure<\/strong>. <\/p>\n\n
Poursuivre un emploi<\/h4>\n\n
Voici comment poursuivre un journal chronologique en pause :<\/p>\n\nFig. 11.<\/strong> Suite de l’historique<\/figcaption><\/figure>\n\n
Notez que si vous essayez de poursuivre un travail qui a \u00e9t\u00e9 termin\u00e9 par un \u00e9v\u00e9nement shift_end, vous obtiendrez une erreur.<\/p>\n\n
Fin d’un emploi<\/h4>\n\n
Voici comment vous terminez un travail par un journal de bord shift_end :<\/p>\n\nFig. 12.<\/strong> Journal de fin d’\u00e9quipe<\/figcaption><\/figure>\n\n
Dans shift_end-events, vous pouvez indiquer les valeurs amount <\/strong>et faulty_amount <\/strong>comme dans paused-events. Notez que si vous essayez d’effectuer un shift_end-event sur un travail qui n’est pas en cours d’ex\u00e9cution, vous obtiendrez une erreur. <\/p>\n\n
Mise \u00e0 jour des calendriers<\/h4>\n\n
Vous pouvez mettre \u00e0 jour les donn\u00e9es du timelog en envoyant des requ\u00eates PUT au point de terminaison \/timelogs, comme ceci :<\/p>\n\nFig. 13.<\/strong> \u00c9dition des calendriers<\/figcaption><\/figure>\n\n
Notez que vous devez disposer des donn\u00e9es beginTimelog <\/strong>et endTimelog <\/strong>pour effectuer une mise \u00e0 jour. Dans Skyplanner, les calendriers sont stock\u00e9s de la mani\u00e8re suivante : chaque calendrier \u00ab\u00a0complet\u00a0\u00bb (qui comporte \u00e0 la fois un d\u00e9but et une fin (par exemple, shift_begin\/continued & paused\/shift_end)) poss\u00e8de une entit\u00e9 distincte pour le d\u00e9but et la fin. <\/p>\n\n
Ils sont associ\u00e9s \u00e0 la valeur begin_id <\/strong>trouv\u00e9e dans endlog. Dans l’exemple ci-dessus, le beginTimelog a pour valeur id 1 et le endTimelog a donc pour valeur begin_id <\/strong>1. <\/p>\n\n
Vous devez \u00e9galement indiquer les valeurs person_id <\/strong>et endTimelog <\/strong>\u00e0 chaque fois que vous effectuez une demande de mise \u00e0 jour, m\u00eame si vous ne les modifiez pas.<\/p>\n\n
D’autres fa\u00e7ons de r\u00e9aliser des timelogs<\/h4>\n\n
Voici d’autres fa\u00e7ons de vous connecter \u00e0 vos travaux \u00e0 l’aide de l’API.<\/p>\n\n
Logfull<\/h5>\n\n
Si vous souhaitez envoyer les timelogs de d\u00e9but et de fin en une seule requ\u00eate, vous pouvez utiliser le point de terminaison \/timelogs\/log-full<\/strong>, comme ceci :<\/p>\n\nFig. 14.<\/strong> Demande d’enregistrement<\/figcaption><\/figure>\n\n
Notez comment les montants sont envoy\u00e9s ici : la premi\u00e8re valeur \u00ab\u00a0amount\u00a0\u00bb indique le montant d\u00e9fectueux<\/strong> et la seconde le montant<\/strong>. Cette requ\u00eate cr\u00e9e les entit\u00e9s beginlog et endlog en une seule requ\u00eate. <\/p>\n\n
Fiche d’information<\/h5>\n\n
\u00ab\u00a0L’enregistrement rapide d’une t\u00e2che permet de la terminer en une seule demande et de faire correspondre la quantit\u00e9 de produits achev\u00e9s \u00e0 la valeur d\u00e9finie dans l’\u00e9l\u00e9ment de la commande. Le Quicklogging se fait en utilisant le point de terminaison \/timelogs\/quick-log<\/strong>: <\/p>\n\nFig. 15.<\/strong> Quicklogging<\/figcaption><\/figure>\n\n
Notez que vous ne devez indiquer ici que l’identifiant du travail de planification de la production<\/strong>, l’identifiant du poste de travail planifi\u00e9 <\/strong>et l’identifiant de la personne<\/strong>. Les valeurs de temps et de montant sont automatiquement remplies. Notez \u00e9galement que les travaux \u00e0 enregistrement rapide sont toujours termin\u00e9s avec l’\u00e9v\u00e9nement shift_end, de sorte qu’aucun enregistrement suppl\u00e9mentaire n’est possible apr\u00e8s l’enregistrement rapide ! <\/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\")