Epicor Kineticin integraatio-opas hienokuormitukseen SkyPlanner APS:llä

Epicor toteaa: “All Kinetic services, including business objects, processes, reports, BAQs, and Epicor Functions, are accessible through REST endpoints.” (Kaikki Kineticin palvelut, myös liiketoimintaobjektit, prosessit, raportit, BAQ-kyselyt ja Epicor Functions, ovat käytettävissä REST-rajapintojen kautta.) Hienokuormituksen integraatio perustuu neljään Epicorin teknologiaan:

1. Kinetic REST API v2 (OData v4). Liiketoimintaobjektit ovat käytettävissä palveluina, joiden nimet ovat muotoa Erp.BO.<Name>Svc. Tavallinen polku on /api/v2/odata/{Company}/Erp.BO.{Svc}/{EntitySet}. REST v1 on yhä käytettävissä, mutta se on vanha versio, joten rakenna integraatio v2:n varaan. Tarkista oman versiosi entiteettijoukot ja metodit REST Help -ohjeesta osoitteessa /api/help/v2/.
2. Business Activity Queries (BAQ) REST-rajapinnan kautta. BAQ-kysely on käytettävissä osoitteessa /api/v2/odata/{Company}/BaqSvc/{BAQ}/Data. Tämä on käytännöllinen tapa hakea suunnittelussa tarvittavat tiedot: kysely yhdistää objektien JobHead, JobOper, JobMtl, PartWhse ja PORel tiedot yhdellä kutsulla (yhteisön esimerkki).
3. Epicor Functions (EFx). Palvelinpuolen funktioita voi kutsua osoitteessa /api/v2/efx/{Company}/{Library}/{Function}. Epicor kertoo, että ne ”can be triggered from multiple entry points, including BPMs, REST services, schedules, and application events.” (Ne voidaan käynnistää useista eri kohdista, kuten BPM:istä, REST-palveluista, ajastuksista ja sovellustapahtumista.)
4. BPM-direktiivit. Method Directives ja Data Directives käynnistyvät, kun työ tai työvaihe muuttuu. Ne voivat kutsua funktiota, joka lähettää tiedot eteenpäin.

Tiedostojen tuonti hoidetaan DMT:llä ja vienti BAQ-vienneillä. Epicor tarjoaa myös Epicor Automation Studion, jota se kuvaa näin: “a low-code app for integration-led automations” (vähäkoodinen sovellus integraatioihin perustuvaan automatisointiin). Älä käytä suoraa tietokantayhteyttä: REST, BAQ-kyselyt ja funktiot toimivat samalla tavalla sekä paikallisessa asennuksessa että Kinetic Cloudissa.

Epicor ei dokumentoi yleiskäyttöistä rajapintaa lähteville webhook-kutsuille, joten Kineticin muutokset välitetään SkyPlanneriin jommallakummalla seuraavista tavoista:

• Tapahtumapohjaisesti. JobHead– tai JobOper-objektiin liitetty BPM Data Directive kutsuu Epicor Function -funktiota, joka lähettää muuttuneen työn SkyPlannerin REST-rajapintaan.
• Ajastettu kysely. Muutospäivämäärän perusteella suodatettu BAQ-kysely ajetaan muutaman minuutin välein tai tunneittain. Sen ylläpito ja häiriöistä palautuminen on yksinkertaisempaa.

Toiseen suuntaan SkyPlanner lähettää tila- ja aikataulumuutokset webhook-kutsuilla. Väliohjelmistosi tai EFx-rajapintapiste vastaanottaa ne ja kirjoittaa tiedot Kineticiin.

1. Perustietojen alkulataus. Lue nimikkeet, resurssiryhmät, resurssit, kyvykkyydet, kalenterit ja työntekijät. Muodosta SkyPlannerin työpisteet Kineticin resursseista ja työpisteryhmät resurssiryhmistä. Sivuta suuret lukuoperaatiot parametreilla $top ja $skip tai hae tiedot massana BAQ-kyselyllä.

2. Tilausten synkronointi. Lähetä vapautetut ja vahvistetut työt työvaiheineen ja materiaaleineen. Hae työn puurakenne GetDatasetForTree-metodilla tai BAQ-kyselyllä, älä entiteetti kerrallaan. Jätä vahvistamattomat MRP-työt Kineticiin, kunnes ne vahvistetaan. Synkronoi avoimet ostotilausten toimituserät eräpäivineen varastosaldojen lukemisen yhteydessä. SkyPlanner käsittelee tilattua materiaalia saatavilla olevana toimituspäivänä ja päivittää varastosaldon, kun ostotilaus merkitään Delivered-tilaan. Näin aikataulutuksessa tarkistetaan sekä varastosaldot että saapuvat ostot.

3. Aikataulun kirjoittaminen takaisin Kineticiin. SkyPlannerin webhook lähettää kunkin työvaiheen suunnitellun aloituksen, lopetuksen ja työpisteen EFx-päätepisteeseen (/api/v2/efx/{Company}/{Library}/{Function}). Funktio kirjoittaa tiedot Kineticin aikataulutusmoottorin kautta. Tämä on sama liiketoimintaobjekti, jota Job Entry -aikataulutus ja aikataulutustaulut käyttävät (yhteisön esimerkki):

1. ScheduleEngine.GetNewParamsForJob muodostaa työn tietojoukon aikataulutusmoottoria varten.
2. Funktio asettaa työn numeron, kokoonpanon ja työvaiheen järjestysnumerot sekä suunnitellun aloituspäivän ja -ajan ja kutsuu sitten metodia ScheduleEngine.MoveJobItem.
3. Jos SkyPlanner on sijoittanut työvaiheen ryhmän toiselle resurssille, ScheduleEngine.ChangeResource siirtää sen kyseiselle resurssille. Pelkkä MoveJobItem säilyttää ryhmän oletusresurssin.
4. Funktio lukitsee työn aikataulun (JobHead.SchedLocked, Job Entry -näkymän Lock-valinta), jotta Global Scheduling säilyttää SkyPlannerin määrittämät päivämäärät.

Kun nämä kutsut kootaan yhteen Epicor Function -funktioon, työn tiedot kirjoitetaan atomisesti ja mukaan voi lisätä omat validoinnit. Jos toimipaikassa ei haluta käyttää mukautettua funktiota, saman kutsusarjan voi suorittaa suorina REST-kutsuina Erp.BO.ScheduleEngineSvc-palveluun. Älä koskaan kirjoita suoraan ResourceTimeUsed– tai JobOper-päivämääräkenttiin: se ohittaa moottorin, jolloin aikataulutustaulun varaukset eivät enää vastaa aikataulua.

4. Tuotannon kuittaukset. Työntekijät kirjaavat työnsä SkyPlanneriin Mobile Confirmations-, Production Timer- tai Quick Log Mode -toiminnolla. Jokainen päätetty aikakirjaus siirtyy Kineticiin työkirjaukseksi Erp.BO.LaborSvc-palvelun kautta: reaaliaikaiseen kirjaamiseen käytetään metodeja StartActivity ja EndActivityByEmp, jälkikäteen tehtäviin kirjauksiin taas Labors-entiteettijoukkoa ja Update-metodia. Jos toimipaikassasi vaaditaan hyväksyntä, sisällytä submitForApproval sekä käsittelyketjuun että käyttöoikeuksien rajaukseen.

5. Tietojen omistajuus ja ristiriitojen käsittelysäännöt. Kirjaa ne ennen tuotantokäytön aloitusta:

SkyPlannerin hienokuormittamilla töillä on aikataululukitus, joten Global Scheduling ei muuta niiden ajankohtia. Säilytä Kineticin hienokuormitus niille resursseille, joita SkyPlanner ei suunnittele.

Toteutus valmistuu tavallisesti viikkojen kuluessa käyttöönottoprojektin alkamisesta. Kinetic-projekti sisältää seuraavat vaiheet:

1. 30 päivän kokeilu töiden, työvaiheiden ja resurssien CSV- tai Excel-vientitiedoilla ennen kehitystyön aloittamista.
2. API-avain, käyttöoikeusrajaus, erillinen integraatiokäyttäjä ja integraation lukemat BAQ-kyselyt.
3. Perustietojen vastaavuuksien määritys: kyvykkyyksien, resurssiryhmien, resurssien, kalenterien ja työntekijöiden yhdistäminen SkyPlannerin työpisteisiin, ryhmiin, vuoroihin ja henkilöstöön.
4. Nimikkeiden, valmistusmenetelmien (BOM ja työvaiheet) sekä resurssien alkulataus.
5. Töiden ja ostotilausten synkronointi (PORel-eräpäivät) sekä PartWhse-varastosaldot.
6. Työvaiheiden suunniteltujen päivämäärien kirjoittaminen takaisin Kineticiin Epicor Function -funktiossa ScheduleEngineSvc-palvelun kautta (MoveJobItem, ChangeResource) sekä työn aikataulun lukitseminen.
7. Tuotannon kuittausten siirto työkirjauksiksi LaborSvc-palvelun kautta.
8. Testaus nykyisen Kinetic-aikataulun rinnalla ja sen jälkeen tuotantokäytön aloitus.

Kahta täysin samalla tavalla Kineticiä käyttävää tehdasta ei ole. Kyvykkyyksiin perustuvat reititykset, resurssiryhmien kalenterit, BAQ-kyselyjen toteutus, BPM-direktiivit ja tietojen palautukseen käytettävät versiokohtaiset metodit vaihtelevat toimipaikoittain. Niiden oikea toteutus ratkaisee, voivatko suunnittelijat luottaa aikatauluun vai joutuvatko he korjaamaan sitä.

1. SkyPlannerin tiimi määrittää integraation käyttöönoton aikana ja tukee sitä tuotantokäytön alettua. Tiimi määrittää resurssien, töiden ja ostotilausten toimituserien vastaavuudet sekä BAQ-lukutoiminnot, BPM-liipaisimet ja takaisin kirjoittavan funktion. Se yhdistää SkyPlannerin REST API:n ja webhook-kutsut Kinetic REST v2:een. Tuki jatkuu myös BAQ-kyselyjen, BPM-määritysten tai Kinetic-version muuttuessa.
2. Epicor-kumppanisi. Kumppanit, jotka jo tekevät BAQ-kyselyjä, BPM-määrityksiä ja Epicor Functions -funktioita, voivat käyttää samaa dokumentoitua SkyPlannerin REST API:a. Sen kautta luetaan ja kirjoitetaan tilauksia, tuotteita, materiaaleja, työvaiheita ja aikakirjauksia.
3. Omat kehittäjäsi. Kinetic REST -rajapinnat tunteva oma tiimi voi rakentaa integraation suoraan tai Automation Studiolla, jos se on käytössäsi. Alkuun pääsee SkyPlannerin API-avaimella (integraation toteutusohje), ja SkyPlannerin tiimi auttaa tarvittaessa. Tuotteen dokumentaatio on julkisesti saatavilla SkyPlannerin dokumentaatiosivustolla.

Sama API-rajapintoihin ja webhook-kutsuihin perustuva toteutustapa on tuotantokäytössä muiden ERP-järjestelmien kanssa, esimerkiksi UTUlla. Laboratory & Alliedin oma IT-tiimi rakensi SAP Business One -integraation pitkälti itse SkyPlannerin tuella.

Kaikki toteutustavat alkavat samoin: aloita 30 päivän maksuttomalla kokeilulla CSV-tuontien avulla, varmista aikataulun toimivuus ja rakenna integraatio vasta sitten. Hinta on alkaen 199 € kuukaudessa ja sisältää 5 työpistettä. Laskutus on kuukausittainen, ja tilauksen voi perua milloin tahansa. Integraatiosta annetaan prosessisi ja tarpeidesi mukainen tarjous etukäteen yhdessä tilauksesi kanssa, joten näet kokonaiskustannukset ennen aloitusta.