Liidestused / ERP / proALPHA ERP
proALPHA liidestusjuhend tootmise ajakava koostamiseks SkyPlanner APS-iga
See Proalpha liidestusjuhend näitab partneritele ja IT-meeskondadele, kuidas ühendada Proalpha ERP SkyPlanner APS-iga. SkyPlanner vahetab Proalphaga andmeid mõlemas suunas:
- SkyPlannerisse liiguvad artiklid, tootmistellimused koos operatsioonidega, ressursid, kalendrid, laoseisud ja ostutellimused.
- Iga operatsiooni kavandatud algus- ja lõppaeg saadetakse tagasi setWorkOrderOperationDates kaudu.
- Ressursimuudatused saadetakse tagasi changeWorkOrderOperationResource kaudu.
- Operaatorite kinnitused saadetakse tagasi operationDataEntry kaudu.
- SkyPlanneri veebihaagid edastavad ajakava muudatused kohe nende tekkimisel.
SkyPlanneri meeskond seadistab kasutuselevõtu käigus liidestuse teie Proalpha keskkonna järgi ja pakub tuge ka pärast käivitamist. See juhend on mõeldud partneritele ja arendajatele, kes soovivad töös osaleda või ise SkyPlanneri dokumenteeritud REST API abil lahendusi luua (API dokumentatsioon).
Proalpha liidesed
Proalpha ERP töötab Progress OpenEdge’i platvormil ning Release 9 viis selle üle OpenEdge 12-le. (Proalpha) Ajakava koostamisel on olulised neli liidest.
- Proalpha ERP REST API-d. Avalikus Proalpha API Portal portaalis on tee
api/web/v1all loetletud 108 OpenAPI 3.0 spetsifikatsiooni. Nende kaudu kirjutatakse andmed tagasi ning loetakse artiklite ja laoseisu andmeid. - Integration Workbench (INWB). Proalpha kirjeldab INWB-d sõnadega “is a central platform which connects different IT systems, machines, sites” (on keskne platvorm, mis ühendab eri IT-süsteeme, masinaid ja tegevuskohti) ning selle ülesannet sõnadega “converts the data into the format of the target system.” (teisendab andmed sihtsüsteemi vormingusse). (Proalpha) See võtab pAX-sõnumeid vastu
POST /api/web/v1/inwb/messagekaudu. Kasutage seda tootmistellimuste edastamiseks Proalphast välja ja Proalphasse sisse. - Proalpha Integration Platform. See n8n-il põhinev platvorm kuulutati välja aprillis 2026 ja “will be available to customers either on-premises or in the cloud.” (saab klientidele kättesaadavaks nii kohapealse kui ka pilvelahendusena). Proalpha “will rely on an API-centric reference architecture and REST interfaces.” (hakkab tuginema API-kesksele referentsarhitektuurile ja REST-liidestele). (Proalpha)
- EDI ja failieksport. INWB toetab valdkonnapõhiseid failivorminguid ning SkyPlanneri prooviperioodiks piisab failiekspordist.
Tootmise lõpp-punktid
| Proalpha API | Lõpp-punkt | Kasutus liidestuses |
|---|---|---|
| Production Workorder Operation Dates API V1 | POST /api/web/v1/pps/prod/setWorkOrderOperationDates | Iga operatsiooni kavandatud algus ja lõpp (guid, startTimePoint, endTimePoint) |
| Production Workorder Operation Resource API V1 | POST /api/web/v1/pps/prod/changeWorkOrderOperationResource | Ajakava koostamisel valitud ressurss (guid, resourceGUID) |
| Production Workorder Operation API V1 | POST /api/web/v1/pps/prod/operationDataEntry/{combined, setup, process} | Kinnitused: postingQty, scrapQty, finishOperation, employeeID, resourceTime |
| Part API | GET/POST /api/web/v1/master/part | Artiklid väljadega partNumber, partType, quantityUnitCode |
| Material API V1 | GET /api/web/v1/mawi/MRPArea/{mrpAreaGuid}/part/{partGuid}/stock | Laoseis MRP-piirkondade kaupa |
Autentimine
Proalpha avaldatud spetsifikatsioonides kasutatakse HTTP Basic autentimist. Lõpp-punktid on keskkonnapõhised kujul {schema}://{host}:{port}/api/web/v1/... ja asuvad teie Proalpha serveris või Proalpha Cloudis. Looge eraldi tehniline kasutaja, kelle õigused piirduvad vastendustabelis loetletud objektidega. Kavandage koos IT-meeskonnaga võrguühendus SkyPlanneri pilvest selle lõpp-punktini.
SkyPlanneri REST API kasutab autentimiseks API-pääsmikku (SkyPlanner Settings > API) ning on dokumenteeritud Swagger/OpenAPI vormingus. Alustamiseks piisab API-pääsmikust. Liidestamise õpetus juhendab esimeste päringute tegemist.
Sündmused ja perioodilised päringud
Proalpha API Portal ei loetle veebihaakide tellimise API-t. Väljuvad muudatused edastatakse järgmiselt:
- INWB sõnumivoog saadab uued ja muudetud tootmistellimused koos operatsioonidega
- n8n töövoog Proalpha Integration Platformil
- laoseisu perioodilised päringud Material API kaudu
SkyPlanner saadab oleku või ajakava muutumisel veebihaake, seega toimub andmete tagasikirjutamine Proalphasse sündmuspõhiselt.
Andmete vastendamine
| Proalpha objekt või API | SkyPlanneri objekt | Suund | Sagedus |
|---|---|---|---|
| Part (Part API) | Tooted ja materjalid | Proalpha → SkyPlanner | Esmane laadimine, seejärel muudatuste korral |
| Toote protsessimudel: process, activities; tootmistellimuse BOM-read | Toote struktuur, alamtooted, protsessietapid | Proalpha → SkyPlanner | Esmane laadimine, seejärel muudatuste korral |
| Tootmistellimus (Fertigungsauftrag) koos koguse ja tähtajaga | Tellimus ja tööd koos tähtaja ja prioriteediga | Proalpha → SkyPlanner | INWB või n8n edastus või iga paari minuti järel |
| Tootmistellimuse operatsioonid: targetSetupTime, targetProcessTime, resource | Protsessietapid koos seadistusaegade ja kestustega | Proalpha → SkyPlanner | Koos tootmistellimusega |
| Ressursid, ressursirühmad, alternatiivsed ressursirühmad | Töökeskused, töökeskuste rühmad, alternatiivsed töökeskused | Proalpha → SkyPlanner | Esmane laadimine |
| Ressursikalendri plokid väljadega intensity ja overloadIntensity | Vahetused ja töökeskuste efektiivsus | Proalpha → SkyPlanner | Esmane laadimine; seejärel iga päev või haldamine SkyPlanneris |
| Laoseis MRP-piirkondade kaupa | Materjalide laoseis | Proalpha → SkyPlanner | Iga tund või enne iga ajakava koostamist |
| Ostutellimused koos tarnekuupäevaga | Saabuv materjal selle tarnekuupäeval | Proalpha → SkyPlanner | Iga tund või enne iga ajakava koostamist |
| setWorkOrderOperationDates | Iga operatsiooni ajakavakohane algus ja lõpp | SkyPlanner → Proalpha | Ajakava muutumisel SkyPlanneri veebihaagi kaudu |
| changeWorkOrderOperationResource | Planeerimismootori valitud töökeskus | SkyPlanner → Proalpha | Ajakava muutumisel |
| operationDataEntry (setup, process, combined) | Mobile Confirmations kaudu registreeritud ajad ja kogused | SkyPlanner → Proalpha | Iga kinnituse või vahetuse järel |
| SkyPlanneri ajakava koostamise reeglid | Seadistusaegade maatriks, tööriistad piiratud ressurssidena, operaatorite arv | Hallatakse SkyPlanneris | Seadistatakse kasutuselevõtu käigus |
Liidestuslahendused
1. Põhiandmete esmane laadimine. Lugege artiklid Part API kaudu ning laadige ressursid, ressursirühmad ja kalendrid ühekordselt INWB või failiekspordi kaudu. Vastendage iga Proalpha ressurss läbimõeldult SkyPlanneri töökeskusega. Alternatiivsetest ressursirühmadest saavad alternatiivsed töökeskused.
2. Tellimuste sünkroonimine. INWB sõnumivoog või n8n töövoog saadab avatud tootmistellimused koos operatsioonide, sihtaegade ja ressurssidega. Laoseis saadakse Material API kaudu MRP-piirkondade kaupa ning avatud ostutellimused INWB kaudu. SkyPlanner loeb tellitud materjali kättesaadavaks ostutellimuse tarnekuupäeval ja uuendab laoseisu, kui ostutellimuse olekuks märgitakse Delivered.
3. Ajakava tagasikirjutamine. Iga operatsiooni puhul, mille mootor ajakavasse paigutas või ümber tõstis, kutsub integratsioon välja setWorkOrderOperationDates ning edastab operatsiooni guid-i, alguse ja lõpu. Kui mootor valis teise ressursi, järgneb changeWorkOrderOperationResource.
4. Tööde kinnitamine tootmises. Operaatorid registreerivad tööd SkyPlanner Mobile Confirmations või Production Timer abil. Ajakirjed hoiavad ajakava ajakohasena ja edastatakse Proalphasse operationDataEntry kaudu. Kui teie tehases kinnitatakse töid juba PDC-terminalides, kasutage topeltkannete vältimiseks üht kanalit.
5. Andmevastutuse ja konfliktide lahendamise reeglid. Pange need kirja enne kasutuselevõttu:
| Andmed | Vastutav süsteem |
|---|---|
| Artiklid, protsessimudelid, kogused, tootmistellimuse olek | Proalpha |
| Operatsioonide järjekord, algus- ja lõpuajad, ressursside määramine | SkyPlanner |
| Seadistusaegade maatriks, tööriistad, operaatorite arv | SkyPlanner |
| Vahetused ja puudumised | Üks süsteem, mis valitakse ulatuse määramisel |
| Töökinnitused ja laokanded | Proalpha, kuhu andmed jõuavad SkyPlanneri ajakirjetest või PDC kaudu |
Kui Proalpha APS või Feinplanung on aktiivne, otsustage, milline süsteem vastutab operatsioonide kuupäevade eest. Kui kaks planeerijat kirjutavad samu kuupäevi, kirjutavad nad teineteise muudatused üle. Funktsiooni Autopilot abil muudab SkyPlanner tootmise muutudes ajakava automaatselt.
Projekti tavapärased etapid
Juurutamine saab tavaliselt valmis mõne nädala jooksul pärast juurutusprotsessi algust. Enne seda saate 30-päevase tasuta prooviperioodi jooksul kasutada oma andmeid. Eksportige Proalphast avatud tootmistellimused, operatsioonid ja ressursid CSV- või Exceli faili, importige need ning kontrollige ajakava.
- Andmete vastendamise töötuba. Leppige koos oma Proalpha partneriga kokku vastendustabel, andmevastutuse reeglid, sünkroonimise sagedused ja töökinnituste kanal.
- Liideste seadistamine. Lubage REST API-d ja INWB vood, looge tehniline kasutaja ning avage võrgujuurdepääs. Esmalt testsüsteemis, seejärel tootmiskeskkonnas.
- Esmane andmete laadimine. Artiklid, ressursid, ressursirühmad ja kalendrid.
- Tootmistellimuste, laoseisu ja ostutellimuste sünkroonimine. Tootmistellimused saadetakse INWB või n8n kaudu, laoseisu päritakse perioodiliselt. Ebaõnnestumise korral tehakse korduskatsed.
- Piirangute seadistamine SkyPlanneris. Seadistusaegade maatriks, tööriistad, operaatorite arv ja alternatiivsed töökeskused.
- Ajakava tagasikirjutamine. setWorkOrderOperationDates ja changeWorkOrderOperationResource; selles etapis lisatakse ka operationDataEntry.
- Paralleelne kasutamine. Võrrelge SkyPlanneri kuupäevi praeguse plaaniga ja parandage põhiandmed.
- Kasutuselevõtt. Lülitage tagasikirjutamine sisse, kui andmed on kooskõlas.
Millega Proalpha integratsiooni puhul arvestada
- Tehnoloogilise marsruudi objekt puudub. Proalpha planeerimine põhineb toodete protsessimudelitel. SAP-i või Business Centrali projektidest üle võetud tööriistad otsivad tehnoloogilisi marsruute ja jätavad osa andmeid leidmata. Lugege tootmistellimuselt operatsioonid ja BOM-read.
- Kalendri koormustegurid. Kalendriplokid sisaldavad välju intensity ja overloadIntensity. Vastendage need SkyPlanneri vahetuste ja efektiivsusteguritega. Ärge kopeerige lihtsalt tundide arvu.
- Mõõtühikud. Kontrollige välja quantityUnitCode ning seda, kas ettenähtud seadistusaeg kehtib tellimuse või tüki kohta. Valed ühikud moonutavad kõiki kestusi.
- Kliendi serveris majutatud lõpp-punktid. REST-kiht töötab teie Proalpha serveris. Projekti algusaeg sõltub tulemüüridest, portidest ja sertifikaatidest, seega korraldage vajalikud ligipääsud varakult.
- Tarkvaraversioon. Enne vastenduse kinnitamist uurige partnerilt, milliseid REST API-sid teie Proalpha versioon pakub.
- Sisselogimist nõudev dokumentatsioon. Proalpha veebiabi on kättesaadav portaali Documentation Portal kaudu. Ärge oletage väljade nimesid, vaid kontrollige neid koos partneriga.
Kes Proalpha integratsiooni seadistab ja toetab?
- SkyPlanneri meeskond seadistab integratsiooni juurutamise käigus ja pakub tuge ka pärast kasutuselevõttu. Iga Proalpha paigaldis on modelleeritud erinevalt ning seadistamisel rakendab meeskond oma oskusteavet.
- Teie Proalpha partner saab osaleda. Partner tunneb teie protsessimudeleid, INWB vooge ja tarkvaraversiooni ning saab seadistada API-juurdepääsu. SkyPlanner pakub REST API-t, Swagger/OpenAPI dokumentatsiooni ja veebihaake.
- Teie enda arendajad saavad lahendust edasi arendada, kasutades sama REST API-t ja API-pääsmikku. SkyPlanneri meeskond aitab vajaduse korral. Toote dokumentatsioon on avalikult kättesaadav lehel SkyPlanneri dokumentatsioon.
SkyPlanneri hind algab 199 € kuus ja sisaldab 5 töökeskust. Arveldamine toimub igakuiselt. Teie protsessile ja vajadustele vastav integratsiooni hinnapakkumine esitatakse ette koos paketi hinnapakkumisega, nii et kogukulu on teada enne alustamist. Lugege Proalpha võimsuse planeerimise kohta artiklist Kas proALPHA võimaldab tootmist planeerida masinate ja töötajate tegelikku võimsust arvestades?, tutvuge ülevaatega proALPHA lehel ja teiste süsteemidega ERP-integratsioonide lehel.
Tootmisettevõtete tagasiside SkyPlannerile
2 hajasäästu igal nädalal
„SkyPlanner on viinud meie tootmise planeerimise Exceli tabelitest tootmise reaalajas optimeerimiseni.”
Kalle Kalliomäki, tarneahelaspetsialist
UTU · Elektrikilbid ja jaotusseadmed
Tootmise planeerimine säästab igal nädalal 2 tundi tööaega ja uus tööjärjekord jõuab tootmisliinile sekunditega.
+90%tootmise efektiivsus
„Tootmise efektiivsus on kasvanud 90%.”
Abdul Rucyinga, IT-juht
Laboratory & Allied · Ravimitootmine
Tootmise efektiivsus on kasvanud 90% ning kõiki töökeskusi hõlmava kolme kuu optimeeritud plaani koostamine võtab alla 30 minuti.
99,2%tarnekindlus
„SkyPlanner on muutnud kitsaskohad nähtavaks ja tootmise juhtimise selgemaks.”
Toni Tuori, tootmisjuht
Piristeel · Katuse turvatooted ja vihmaveesüsteemid
Tarnekindlus jõudis sel aastal 99,2%-ni ning ajakava koostamine säästab kuni neli tundi tööaega päevas.
Vähemmaterjalipuudusest tingitud seisakuid
„SkyPlanneri väärtus meie jaoks seisneb selles, et see on igapäevatöös toimiv tööriist, eriti tarnekuupäevade määramisel.”
Tommi Männistö, tootmise planeerimise juht
Eskomatic · Mehaaniline töötlemine allhankena
Tootmiskoormuse automaatne planeerimine võimaldab määrata täpsemad tarnekuupäevad ning materjalipuudusest tingitud tootmisseisakud on järsult vähenenud.
Korduma kippuvad küsimused
Milliseid Proalpha liideseid integratsioon kasutab?
Proalpha REST API-sid kasutatakse artiklite ja laoseisu lugemiseks ning kuupäevade, ressursside ja töökinnituste tagasikirjutamiseks. INWB sõnumivood või n8n-põhine Integration Platform edastavad tootmistellimused koos operatsioonidega. Prooviperioodil ja andmete hulgilaadimisel kasutatakse failieksporte.
Kuhu planeeritud kuupäevad Proalphas salvestatakse?
Tootmistellimuse operatsioonile: setWorkOrderOperationDates edastab algus- ja lõpuhetke. Kui mootor paigutas töö teisele masinale, uuendab changeWorkOrderOperationResource ressurssi.
Kas Proalpha toetab veebihaake?
Proalpha API Portal ei loetle veebihaakide tellimise API-t. Muudatused jõuavad SkyPlannerisse INWB sõnumivoogude, n8n töövoogude või perioodiliste päringute kaudu. SkyPlanneri enda veebihaagid muudavad tagasikirjutamise sündmuspõhiseks.
Kas operaatorite töökinnitusi saab Proalphasse saata?
Jah. Funktsioonist SkyPlanner Mobile Confirmations pärit ajakirjed edastatakse operationDataEntry kaudu koos koguse ning töötaja ja ressursi ajakuluga. Kui kasutusel on ka PDC-terminalid, kasutage üht töökinnituste kanalit.
Kas vajame Proalpha APS-i ja mida teha, kui see on juba kasutusel?
Te ei vaja seda. SkyPlanner koostab ise teie tootmistellimuste, operatsioonide ja ressursside põhjal ajakava, mis arvestab masinate ja töötajate tegelikku võimsust, ning Autopilot hoiab selle ajakohasena. Kui Proalpha APS on aktiivne, otsustage ulatuse määramisel, milline süsteem vastutab operatsioonide kuupäevade eest. SkyPlanner kirjutab seejärel ainult enda vastutusalasse kuuluvaid kuupäevi, nii et kaks plaani ei kirjuta teineteist kunagi üle.
Kas saame SkyPlannerit enne integratsiooni loomist katsetada?
Jah. 30-päevasel tasuta prooviperioodil saate kasutada kuni 20 töökeskust, eksportides oma tootmistellimused CSV- või Exceli faili. Krediitkaarti pole vaja. Alustage prooviperioodi või võtke ühendust müügimeeskonnaga, et määrata integratsiooni ulatus.
