Sebelum kita masuk ke dalam catatan waktu, kita perlu membahas sedikit tentang struktur data di Skyplanner dan bagaimana segala sesuatunya bekerja di balik layar. Semua ini akan berperan nanti. <\/p>\n\n
Jika Anda mengintegrasikan data pesanan\/perintah kerja\/pekerjaan Anda ke dalam Skyplanner, kemungkinan besar Anda menggunakan setidaknya API-endpoint ini:<\/p>\n\n
\n
pesanan phaser<\/li>\n\n\n\n
urutan-baris phaser<\/li>\n\n\n\n
phaser-pekerjaan<\/li>\n<\/ul>\n\n
Secara efektif, data yang dimasukkan ke dalam titik akhir ini direpresentasikan dalam UI Skyplanner seperti ini:<\/p>\n
Setelah memasukkan pesanan Anda ke Skyplanner, Anda harus mengekspornya<\/strong> (ini dapat dilakukan melalui UI atau \/phaser-orders\/export-endpoint) ke dalam modul Penjadwalan Produksi:<\/p>\n\nGbr 3.<\/strong> Mengekspor melalui UI<\/figcaption><\/figure>\n\nGbr 4.<\/strong> Pesanan yang diekspor dalam Penjadwalan Produksi<\/figcaption><\/figure>\n\n
Ketika mengekspor pesanan, Skyplanner secara efektif menyalin data pesanan dari satu tabel database ke tabel database lainnya. Jadi, jika anda mengubah sesuatu misalnya melalui \/phaser-orders -endpoint, anda perlu mengekspor data lagi untuk memperbaruinya di Penjadwalan Produksi. Hal ini juga berarti bahwa untuk mengakses pesanan yang Anda lihat di jendela Penjadwalan Produksi, Anda harus menggunakan API-endpoint yang berbeda! <\/p>\n\n
Titik akhir yang “diubah” adalah seperti ini:<\/p>\n\n
Hal ini penting untuk diketahui, karena ketika menggunakan \/timelogs -endpoint untuk mencatat peristiwa produksi Anda, dll. , Anda harus menggunakan entitas terkait yang ditemukan di Penjadwalan Produksi -endpoint!<\/strong><\/p>\n\n
Sebagai contoh, Anda memerlukan production_planning_job_id <\/strong>(untuk mengulangi: production_planning_jobs adalah entitas yang diakses dari titik akhir \/jobs) untuk POST timelog baru:<\/p>\n\nGbr 5.<\/strong> Permintaan POST Timelog<\/figcaption><\/figure>\n\n
Anda dapat menemukan production_planning_job_id yang Anda butuhkan dari titik akhir \/phaser-jobs:<\/p>\n\nGambar 6.<\/strong> Permintaan GET pekerjaan phaser (warna merah adalah phaser_job_id, JANGAN GUNAKAN DALAM TIMELOG<\/strong>)<\/figcaption><\/figure>\n\n
Atau dari titik akhir \/job:<\/p>\n\nGbr 7.<\/strong> \/job Dapatkan permintaan<\/figcaption><\/figure>\n\n
Membuat catatan waktu menggunakan REST-API<\/h4>\n\n
Membuat catatan waktu ke Skyplanner melalui API menggunakan aturan dan sistem yang sama dengan yang ada di UI. Jadi, akan lebih baik jika Anda membiasakan diri dengan cara kerja sistem di UI sebelum mencoba menggunakannya melalui API. <\/p>\n\n
Dasar-dasar catatan waktu<\/h5>\n\n
Skyplanner memiliki empat jenis peristiwa catatan waktu:<\/p>\n\n
\n
shift_begin<\/li>\n\n\n\n
berhenti sejenak<\/li>\n\n\n\n
lanjutan<\/li>\n\n\n\n
shift_end<\/li>\n<\/ul>\n\n
Shift_begin-event dikirim ketika pekerjaan dimulai untuk pertama kalinya. Jangan pernah mengirim lebih dari satu peristiwa shift_begin untuk setiap pekerjaan!<\/strong><\/p>\n\n
Acara yang dijeda akan menghentikan pekerjaan.<\/p>\n\n
Acara lanjutan melanjutkan pekerjaan yang dijeda.<\/p>\n\n
Shift_end menyelesaikan pekerjaan. Jangan pernah mengirim lebih dari satu peristiwa shift_end untuk setiap pekerjaan!<\/strong><\/p>\n\n
Data yang diperlukan untuk catatan waktu:<\/p>\n\n
\n
person_id\n
\n
Dapat ditemukan dari titik akhir \/people<\/li>\n\n\n\n
Tidak sama dengan user_id!<\/li>\n<\/ul>\n<\/li>\n\n\n\n
rencana_stasiun_kerja_id\n
\n
Stasiun kerja tempat pekerjaan sedang dilakukan<\/li>\n\n\n\n
Dapat ditemukan dari titik akhir \/workstations<\/li>\n<\/ul>\n<\/li>\n\n\n\n
Untuk menentukan timelog Skyplanner apa yang terkait dengan timelog dari sistem eksternal apa pun yang Anda gunakan, Anda dapat menggunakan bidang external_id <\/strong>. Anda kemudian dapat membuat permintaan GET menggunakan id ini untuk menemukan timelog tertentu dari Skyplanner. <\/p>\n\nGbr 8.<\/strong> External_id dalam catatan waktu<\/figcaption><\/figure>\n\n
Memulai pekerjaan<\/h4>\n\n
Anda dapat memulai pekerjaan dengan mengirimkan permintaan POST seperti ini ke API:<\/p>\n\nGbr 9.<\/strong> Catatan waktu Shift_begin<\/figcaption><\/figure>\n\n
Saat mengatur data POST untuk timelog, atur workshift_id <\/strong>sebagai 0 dan timelog_finalized <\/strong>sebagai true<\/strong><\/p>\n\n
Menjeda pekerjaan<\/h4>\n\n
Jeda pekerjaan dengan mengirimkan permintaan POST seperti ini:<\/p>\n\nGbr 10.<\/strong> Catatan waktu yang dijeda<\/figcaption><\/figure>\n\n
Pada timelog tipe jeda, Anda dapat mengatur jumlah <\/strong>dan faulty_amount<\/strong>. Perhatikan juga tipe <\/strong>timelog dan date_time<\/strong>. <\/p>\n\n
Melanjutkan pekerjaan<\/h4>\n\n
Berikut ini adalah cara Anda melanjutkan catatan waktu yang dijeda:<\/p>\n\nGbr 11.<\/strong> Catatan waktu lanjutan<\/figcaption><\/figure>\n\n
Perhatikan bahwa jika Anda mencoba melanjutkan pekerjaan yang telah diakhiri oleh peristiwa shift_end, Anda akan mendapatkan kesalahan.<\/p>\n\n
Mengakhiri pekerjaan<\/h4>\n\n
Berikut ini adalah cara Anda mengakhiri pekerjaan dengan catatan waktu shift_end:<\/p>\n\nGbr 12.<\/strong> Catatan waktu shift_akhir<\/figcaption><\/figure>\n\n
Dalam shift_end-events anda dapat memberikan nilai amount <\/strong>dan faulty_amount <\/strong>seperti pada paused-events. Perhatikan bahwa jika Anda mencoba melakukan shift_end-event pada pekerjaan yang tidak sedang berjalan, Anda akan mendapatkan kesalahan. <\/p>\n\n
Memperbarui catatan waktu<\/h4>\n\n
Anda dapat memperbarui data log waktu dengan mengirimkan permintaan PUT ke titik akhir \/timelogs, seperti ini:<\/p>\n\nGbr 13.<\/strong> Mengedit catatan waktu<\/figcaption><\/figure>\n\n
Perhatikan bahwa Anda harus memiliki set data beginTimelog <\/strong>dan endTimelog <\/strong>untuk melakukan pembaruan. Timelog di Skyplanner disimpan seperti ini: setiap timelog “penuh” (timelog yang memiliki awal dan akhir (contoh: shift_begin\/continued & paused\/shift_end) memiliki entitas terpisah untuk awal dan akhir. <\/p>\n\n
Ini dipasangkan dengan nilai begin_id <\/strong>yang ditemukan di endlog. Pada contoh di atas, beginTimelog memiliki nilai id 1 dan dengan demikian endTimelog memiliki nilai begin_id <\/strong>1. <\/p>\n\n
Anda juga harus memberikan nilai person_id <\/strong>dan endTimelog <\/strong>untuk setiap kali Anda melakukan permintaan pembaruan meskipun Anda tidak mengubahnya.<\/p>\n\n
Cara-cara alternatif untuk melakukan pencatatan waktu<\/h4>\n\n
Berikut adalah beberapa cara alternatif untuk masuk ke pekerjaan Anda menggunakan API.<\/p>\n\n
Logfull<\/h5>\n\n
Jika Anda ingin mengirim timelog awal dan akhir dalam satu permintaan, Anda dapat menggunakan titik \/timelogs\/log-full<\/strong> -endpoint, seperti ini:<\/p>\n\nGbr 14.<\/strong> Permintaan logfull<\/figcaption><\/figure>\n\n
Perhatikan bagaimana jumlah yang dikirim di sini: nilai “jumlah” pertama menunjukkan jumlah yang salah<\/strong> dan yang kedua jumlah<\/strong>. Permintaan ini membuat entitas beginlog dan endlog dalam satu permintaan tunggal. <\/p>\n\n
Quicklog<\/h5>\n\n
“Quicklogging” ke pekerjaan menyelesaikannya dalam satu permintaan, menetapkan jumlah produk yang diselesaikan agar sesuai dengan nilai yang ditetapkan dalam item pesanan. Pencatatan cepat dilakukan dengan menggunakan perintah \/timelogs\/quick-log<\/strong> -endpoint: <\/p>\n\nGbr 15.<\/strong> Pencatatan cepat<\/figcaption><\/figure>\n\n
Perhatikan bahwa di sini Anda hanya perlu memberikan production_planning_job_id<\/strong>, planned_workstation_id <\/strong>dan person_id<\/strong>. Nilai waktu dan jumlah akan terisi secara otomatis. Perhatikan juga bahwa pekerjaan yang dicatat dengan cepat selalu diselesaikan dengan shift_end-event, jadi tidak ada pencatatan lebih lanjut yang mungkin dilakukan setelah 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\")