Skyplannerin tietorakenne #
Ennen kuin syvennymme aikapäiväkirjoihin, meidän on keskusteltava hieman Skyplannerin tietorakenteesta ja siitä, miten asiat toimivat konepellin alla. Kaikki tämä tulee esiin myöhemmin.
Jos olet integroinut tilaus-, työmääräys- tai työpaikkatietosi Skyplanneriin, olet todennäköisesti käyttänyt ainakin näitä API-päätteitä:
- phaser-orders
- phaser-Order-rows
- phaser-jobs
Näihin päätepisteisiin syötetyt tiedot esitetään Skyplannerin käyttöliittymässä seuraavasti:
Kun olet lisännyt tilauksesi Skyplanneriin, haluat viedä ne (tämä voidaan tehdä käyttöliittymän tai /phaser-tilaukset/vienti-päätepisteen kautta) tuotannon aikataulutusmoduuliin:
Kun Skyplanner vie tilauksia, se kopioi tilaustiedot tietokantataulukosta toiseen. Jos siis muutat jotakin esimerkiksi /phaser-orders -loppupisteen kautta, sinun on vietävä tiedot uudelleen, jotta voit päivittää ne tuotantosuunnittelussa. Tämä tarkoittaa myös sitä, että tuotantoaikatauluikkunassa näkyviä tilauksia varten on käytettävä eri API-päätteitä!
“Muutetut” päätepisteet ovat seuraavat:
Tämä on tärkeää tietää, koska kun käytät /timelogs-päätepistettä tuotantotapahtumien kirjaamiseen, sinun on käytettävä tuotantosuunnittelun päätepisteissä olevia asiaan liittyviä kokonaisuuksia!
Tarvitset esimerkiksi production_planning_job_id-tunnuksen (toistan vielä kerran: production_planning_jobs ovat kokonaisuuksia, joihin pääsee käsiksi /jobs-päätepisteestä), jotta voit POSTATA uuden aikapäiväkirjan:
Löydät tarvitsemasi production_planning_job_id:n joko /phaser-jobs -loppupisteestä:
Tai /job -loppupisteestä:
Aikapäiväkirjojen luominen REST-API:n avulla #
Skyplannerin aikapäiväkirjojen tekeminen API:n kautta käyttää samoja sääntöjä ja järjestelmiä kuin käyttöliittymässä. Siksi voi olla hyödyllistä tutustua siihen, miten järjestelmä toimii käyttöliittymässä, ennen kuin yrität käyttää sitä API:n kautta.
Aikapäiväkirjan perusteet #
Skyplannerissa on neljä aikapäiväkirjatapahtumatyyppiä:
- shift_begin
- keskeytetty
- jatkuu
- shift_end
Shift_begin-tapahtuma lähetetään, kun työ käynnistetään ensimmäistä kertaa. Älä koskaan lähetä useampaa kuin yhtä shift_begin-tapahtumaa kullekin työlle!
Paused-tapahtuma keskeyttää työn.
Continued-event jatkaa keskeytettyä työtä.
Shift_end päättää työn. Älä koskaan lähetä useampaa kuin yhtä shift_end-tapahtumaa kullekin työlle!
Ajastokirjojen edellyttämät tiedot:
- person_id
- Löytyy /people-päätepisteestä.
- Ei sama kuin user_id!
- planned_workstation_id
- Työpiste, jossa työtä tehdään
- Löytyy /workstations-päätepisteestä.
- date_time
- Ajankohta, jolloin tapahtuma suoritetaan
- Formaatti: 2024-01-01 10:30:11
Voit käyttää external_id-kenttää määrittääksesi, mikä Skyplannerin aikapäiväkirja on sidottu käyttämäsi ulkoisen järjestelmän aikapäiväkirjaan. Tämän jälkeen voit esimerkiksi tehdä GET-pyyntöjä käyttämällä tätä id:tä löytääksesi tietyn Skyplannerin ajopäiväkirjan.
Työn aloittaminen #
Voit käynnistää työt lähettämällä API:lle POST-pyynnön tällä tavalla:
Kun asetat POST-tiedot ajopäiväkirjoja varten, aseta workshift_id arvoksi 0 ja timelog_finalized arvoksi true.
Työn keskeyttäminen #
Keskeytä työt lähettämällä POST-pyyntö seuraavasti:
Paused-tyyppisissä aikapäiväkirjoissa voit asettaa summan ja faulty_amount. Huomaa myös ajopäiväkirjan tyyppi ja date_time.
Työn jatkaminen #
Näin jatkat keskeytettyä aikapäiväkirjaa:
Huomaa, että jos yrität jatkaa työtä, joka on päättynyt shift_end-tapahtumaan, saat virheilmoituksen.
Työn lopettaminen #
Näin lopetat työn shift_end timelogin avulla:
Shift_end-tapahtumissa voit antaa amount- ja faulty_amount-arvot aivan kuten paused-tapahtumissa. Huomaa, että jos yrität tehdä shift_end-tapahtuman tehtävälle, joka ei ole käynnissä, saat virheilmoituksen.
Aikapäiväkirjojen päivittäminen #
Voit päivittää aikapäiväkirjatietoja lähettämällä PUT-kyselyitä /timelogs-endpoint-pisteeseen seuraavasti:
Huomaa, että sinulla on oltava sekä beginTimelog- että endTimelog-tiedot , jotta voit tehdä päivityksen. Skyplannerin aikapäiväkirjat tallennetaan seuraavasti: jokaisella “täydellä” (aikapäiväkirjalla, jolla on sekä alku että loppu (esim. shift_begin/continued & paused/shift_end)) aikapäiväkirjalla on erillinen kokonaisuus alkua ja loppua varten.
Näiden parina on endlogista löytyvä begin_id-arvo . Yllä olevassa esimerkissä beginTimelogin id-arvo on 1, joten sen endTimelogin begin_id-arvo on 1.
Sinun on myös annettava person_id- ja endTimelog-arvot joka kerta, kun teet päivityspyynnön, vaikka et muuttaisi niitä.
Vaihtoehtoisia tapoja tehdä aikapäiväkirjoja #
Seuraavassa on joitakin vaihtoehtoisia tapoja, joilla voit kirjautua työpaikkoihin API:n avulla.
Logfull #
Jos haluat lähettää sekä alku- että loppuaikapäiväkirjat yhdessä pyynnössä, voit käyttää /timelogs/log-full -loppupistettä seuraavasti:
Huomaa, miten määrät lähetetään tässä: ensimmäinen “määrä”-arvo tarkoittaa virheellistä määrää ja toinen määrää. Tämä pyyntö luo beginlog- ja endlog-oliot yhdellä pyynnöllä.
Pikaloki #
“Quickloggaus” tehtävään viimeistelee sen yhdellä pyynnöllä, asettaa valmistuneiden tuotteiden määrän vastaamaan tilauserässä asetettua arvoa. Quickloggaus tehdään käyttämällä /timelogs/quick-log -loppupistettä:
Huomaa, että tässä tapauksessa sinun tarvitsee antaa vain production_planning_job_id, planned_workstation_id ja person_id. Aika- ja summa-arvot täytetään automaattisesti. Huomaa myös, että quicklogatut työt päätyvät aina shift_end-tapahtumaan, joten quicklogin jälkeen ei ole enää mahdollista tehdä kirjauksia!