Integrasjoner / ERP / QAD Adaptive ERP
Integrasjonsguide for QAD Adaptive ERP: produksjonsplanlegging med SkyPlanner APS
Denne integrasjonsguiden for QAD Adaptive ERP viser partnere og IT-team hvordan de kobler QAD Adaptive ERP til SkyPlanner APS. Det gjelder også eldre installasjoner av QAD Enterprise Edition og MFG/PRO. SkyPlanner integreres med QAD Adaptive ERP i begge retninger via QADs egne grensesnitt:
- Produksjonsordrer med operasjoner, artikler, produktstrukturer, produksjonsruter, arbeidssentre, produksjonskalendere, lagerbeholdning og innkjøpsordrer overføres til SkyPlanner.
- Planlagte frigivelses- og forfallsdatoer sendes tilbake til Work Order Maintenance (16.1).
- Operatørenes timeregistreringer føres tilbake som Labor Feedback by Work Order (16.20.1), og ferdigproduserte mengder som Work Order Receipt (16.11).
- SkyPlanners webhooks sender planendringer fortløpende.
SkyPlanner-teamet tilpasser integrasjonen til QAD-oppsettet ditt under oppstarten og følger den opp etter produksjonssetting. Denne guiden er for partnere og utviklere som vil delta i arbeidet eller selv bygge videre på SkyPlanners dokumenterte REST API (API-referanse).
QADs integrasjonsgrensesnitt
QAD gir et eksternt planleggingssystem tre muligheter:
- QAD QXtend Inbound (QXI). QAD beskriver det slik: «a Web services-based, SOAP-compliant, XML framework, enabling complete platform-independent access to QAD Enterprise Applications business functionality.» (Et XML-rammeverk basert på webtjenester og i samsvar med SOAP, som gir fullstendig plattformuavhengig tilgang til forretningsfunksjonene i QAD Enterprise Applications.) Hver forespørsel er en QDoc som kjører et QAD-program med samme validering som i skjermbildet. Hver forespørsel gir en QDoc som svar. Tilgjengelige QDocs omfatter
maintainItemMaster,maintainRoutingogmaintainPurchaseOrder. For programmer uten en tilgjengelig QDoc brukes QADs QGen-verktøy til å kartlegge menyprogrammet: «QGen is used to map custom programs or QAD Enterprise Applications programs that do not have released QDoc schemas and events files.» (QGen brukes til å kartlegge egendefinerte programmer eller programmer i QAD Enterprise Applications som ikke har tilgjengelige QDoc-skjemaer og hendelsesfiler.) QAD bruker selv denne løsningen: «QAD Production Scheduler uses QAD QXtend to update work orders.» (QAD Production Scheduler bruker QAD QXtend til å oppdatere produksjonsordrer.) (QXtend-guide) - QAD QXtend Outbound (QXO). QXO «exports user-configurable business objects as XML QDocs out of QAD products.» (Eksporterer brukerkonfigurerbare forretningsobjekter som XML QDocs fra QAD-produkter.) Standardobjektene omfatter Item, Product Structure, Routing, Work Center, Department, Inventory Transaction og Inventory Status.
- REST API-er for forretningsdokumenter. Fra og med Adaptive ERP 2022.1 gjelder følgende: «Query REST APIs are now available for business documents,» (REST API-er for spørringer er nå tilgjengelige for forretningsdokumenter), med filtrering, sortering, paginering og delvise datauttrekk. Dokumentasjonen finnes i Swagger på din instans (versjonsmerknader).
QXtend håndterer skriving. QXO og REST API-ene for spørringer håndterer lesing.
Autentisering og lisensiering
- QXtend Inbound. Når Require Authentication er aktivert på mottakeren, inneholder hver QDoc en Session ID eller et QAD-brukernavn og passord. QXI kontrollerer brukerens menytilgang før programmet kjøres.
- Integrasjonsbruker. Opprett en egen QAD-bruker med tilgang til kun de menyprogrammene integrasjonen kaller: Work Order Maintenance, Labor Feedback by Work Order, Work Order Receipt og programmene for grunndata.
- QXtend-lisens. QXtend lisensieres etter agenter og mottakere. QADs guide angir at webtjenestetrafikk til og fra en ekstern applikasjon ikke er gratis. Avklar derfor QXtend-lisensen før prosjektstart.
På SkyPlanner-siden autentiseres REST API med et API-token i Authorization-Token-headeren (SkyPlanner Settings > API). API-et er dokumentert i Swagger/OpenAPI. Integrasjonsveiledningen viser de første kallene trinn for trinn.
Hendelser og endringsdata
QXtend Outbound er QADs mekanisme for endringsdata. «A change occurs to watched data in QAD Enterprise Applications. Change notifications are written out to the qxevents database.» (Når overvåkede data endres i QAD Enterprise Applications, skrives endringsvarsler til databasen qxevents.) QXO bygger deretter QDocs og leverer dem «to a directory location where the subscriber polls for and picks up new QDocs,» (til en katalog der abonnenten regelmessig ser etter og henter nye QDocs), eller til en webtjeneste som lytter på en URL.
SkyPlanner abonnerer som en webtjeneste på det QXO publiserer, og spør REST API-ene regelmessig etter data som QXO ikke dekker. Work Order er ikke et av standardobjektene i QXO. Integrasjonen legger derfor enten til et QXO-objekt for produksjonsordretabellene (wo_mstr, wr_route) eller henter produksjonsordrer via REST API-ene med noen minutters mellomrom.
SkyPlanner sender webhooks når status eller planen endres. Tilbakeskrivingen er dermed hendelsesstyrt.
Datakoblinger
| QAD-objekt (program, grensesnitt) | Objekt i SkyPlanner | Retning | Hyppighet |
|---|---|---|---|
| Artikler (Item Master Maintenance 1.4.1; QXO Item) | Produkter og materialer | QAD → SkyPlanner | Førstegangsinnlasting, deretter ved endringer via QXO |
| Produktstrukturer (13.5; QXO Product Structure) | Produktstruktur, delprodukter, materialer per produkt | QAD → SkyPlanner | Førstegangsinnlasting, deretter ved endringer via QXO |
| Produksjonsruter (14.13.1; QXO Routing): kø, omstilling, kjøring, venting, transport | Prosesstrinn med varighet, klargjørings- og nedriggingstid | QAD → SkyPlanner | Førstegangsinnlasting, deretter ved endringer via QXO |
| Arbeidssentre (14.5) og avdelinger (14.1; QXO Work Center, Department) | Arbeidsstasjoner, grupper av arbeidsstasjoner, effektivitetsverdier | QAD → SkyPlanner | Ved første innlasting, sjelden deretter |
| Kalendere for produksjonen og arbeidssentrene | Skift og fridager | QAD → SkyPlanner | Daglig, eller administrer skiftene i SkyPlanner |
| Produksjonsordrer (16.1) med produksjonsrute (16.13.13) og komponenter | Ordrer og jobber med leveringsfrister og materialbehov | QAD → SkyPlanner | Tilpasset QXO-objekt eller REST-spørringer med noen minutters mellomrom |
| Lagerbeholdning (QXO Inventory Status, Inventory Transaction) | Lagersaldoer | QAD → SkyPlanner | Ved endringer eller hver time |
| Innkjøpsordrer med leveringsdatoer | Innkjøpsordrer, innkommende materialer etter leveringsdato | QAD → SkyPlanner | Polling hver time eller når planleggingen kjøres |
| Frigivelses- og forfallsdatoer for produksjonsordrer (Work Order Maintenance 16.1, QXtend Inbound QDoc) | Planlagt start og slutt per ordre | SkyPlanner → QAD | Ved endring av planen, via en webhook fra SkyPlanner |
| Labor Feedback by Work Order (16.20.1): omstillings- og kjøretid per operasjon | Tidsregistreringer og operatørbekreftelser | SkyPlanner → QAD | Per bekreftelse eller per skift, hvis valgt |
| Work Order Receipt (16.11) | Ferdigproduserte mengder | SkyPlanner → QAD | Per bekreftelse, hvis valgt |
| Finnes ikke i QAD | Omstillingsmatrise, verktøy som ressurser med begrenset kapasitet, alternative maskiner og medarbeidere | Vedlikeholdes i SkyPlanner | Settes opp under innføringen |
Integrasjonsmønstre
1. Førstegangsinnlasting av grunndata. Les inn artikler, produktstrukturer, produksjonsruter, arbeidssentre og kalendere via QXO eller REST API-ene for spørringer. Velg bevisst hvordan arbeidssentrene skal representeres: Et arbeidssenter med fire maskiner blir én arbeidsstasjonsgruppe eller fire arbeidsstasjoner. Linjer for repetitiv produksjon fra Production Line Maintenance kan også bli arbeidsstasjoner.
2. Synkronisering av produksjonsordrer. Les inn fast planlagte og frigitte produksjonsordrer med produksjonsruter og komponenter, samt åpne innkjøpsordrer. SkyPlanner regner bestilt materiale som tilgjengelig på innkjøpsordrens leveringsdato og oppdaterer lagerbeholdningen når innkjøpsordren får statusen Delivered.
Planlegg produksjonsordrer, ikke planlagte ordrer fra MRP. Planlagte ordrer må først bli fast planlagte eller frigitte produksjonsordrer i QAD.
3. Tilbakeskriving av planen. Når planleggingsmotoren plasserer eller flytter en ordre, utløser en webhook fra SkyPlanner en QXtend Inbound QDoc mot Work Order Maintenance (16.1). Den setter frigivelsesdatoen til datoen for den første planlagte operasjonen og forfallsdatoen til datoen for den siste. QXtend kjører programmet med QADs egen validering og returnerer en QDoc som integrasjonen kontrollerer.
Operasjonsrekkefølgen på hver maskin beholdes i SkyPlanner og formidles til operatørene via Mobile Confirmations. Dermed berøres ikke integrasjonen av at QAD låser produksjonsruten på frigitte ordrer.
4. Tilbakemeldinger fra produksjonen. Operatørene registrerer arbeidet med SkyPlanner Mobile Confirmations eller Production Timer, og timeregistreringene holder planen oppdatert. Du velger om faktiske tider skal føres tilbake til QAD. Hvis ja, sendes omstillings- og kjøretid per operasjon til Labor Feedback by Work Order, og ferdigproduserte mengder til Work Order Receipt. Hvis nei, registreres arbeidstiden i QAD som før.
5. Regler for dataeierskap og konflikter. Dokumenter dem før produksjonssetting:
| Data | Eier |
|---|---|
| Artikler, produktstrukturer, produksjonsruter, antall, produksjonsordrestatus | QAD |
| Operasjonsrekkefølge, start- og sluttider, maskintildeling | SkyPlanner |
| Frigivelses- og forfallsdatoer for produksjonsordrer | SkyPlanner skriver, QAD lagrer |
| Omstillingstidsmatrise, krav til verktøy og operatører, alternative ressurser | SkyPlanner |
| Skift og arbeidsfrie dager | Ett system, valgt under avklaringen |
| Arbeidstid, komponentuttak og varemottak | QAD, med registrering der eller overføring fra timeregistreringer i SkyPlanner |
Velg ett system som skriver datoene for produksjonsordrene. SkyPlanner trenger ingen planleggingsmodul i QAD og erstatter derfor planleggingsverktøyene eller andre planleggingssystemer som kilde til datoer for ordrene det planlegger.
Vanlige trinn i prosjektet
Implementeringen fullføres normalt i løpet av noen uker etter at oppstartsarbeidet begynner. Før det kan du validere planen i den gratis prøveperioden på 30 dager med arbeidssentre, produksjonsruter og åpne produksjonsordrer eksportert fra QAD som CSV eller Excel.
- Datakobling. Fastsett koblingstabellen, reglene for dataeierskap, hvilke lokasjoner og domener som inngår, synkroniseringsfrekvenser og om arbeidstid skal føres tilbake.
- QAD-tilgang. Opprett integrasjonsbrukeren, avklar QXtend-lisensen og sett opp QXtend-mottakeren og QXO-abonnenten. Test først i et testdomene.
- QDoc-oppsett. Bruk tilgjengelige QDocs der de finnes, og generer QDocs med QGen for Work Order Maintenance, Labor Feedback by Work Order og Work Order Receipt der det er nødvendig.
- Førstegangsinnlasting. Artikler, produktstrukturer, produksjonsruter, arbeidssentre og kalendere.
- Synkronisering av produksjons- og innkjøpsordrer. QXO-hendelser eller regelmessige REST-spørringer med filtre, paginering og nye forsøk ved feil.
- Oppsett av begrensninger i SkyPlanner. Omstillingstidsmatrise, verktøy, antall operatører per jobb og alternative maskiner eller personell.
- Tilbakeskriving av planen og parallell testing. Skriv datoer tilbake via SkyPlanner-webhooks, kjør parallelt med dagens plan, sammenlign datoer og rett opp grunndata.
- Produksjonssetting. Aktiver tilbakeskriving når dataene stemmer overens.
Dette må du ta høyde for ved en integrasjon med QAD Adaptive ERP
- Nye CRP-kjøringer. CRP planlegger alle åpne operasjoner på de valgte produksjonsordrene på nytt. QAD beholder manuelle datoer bare når «you also adjusted the work order release and due date to match,» (du også har justert produksjonsordrens frigivelses- og forfallsdato slik at de samsvarer), og det er nettopp disse datoene SkyPlanner skriver tilbake. Kjør CRP etter tilbakeskrivingen, eller utelat ordrene som SkyPlanner planlegger.
- Frigitte produksjonsruter er låst. «Once the work order status is Exploded, Allocated, or Released, no more changes can be made to the routing.» (Når produksjonsordren har status Exploded, Allocated eller Released, kan produksjonsruten ikke lenger endres.) Les inn produksjonsruten ved frigivelse, og endre bare produksjonsruter på planlagte eller fast planlagte ordrer.
- Tidsenheter i produksjonsruten. Omstillingstid og kjøretid gir kapasitetsbelastning, mens «queue, wait, and move times are excluded from load calculations.» (kø-, vente- og transporttid holdes utenfor belastningsberegningene.) Legg inn kø, venting og transport som trinn som bare tar tid, i SkyPlanner, og kontroller om kjøretiden gjelder per enhet eller per ordre.
- Gjennomstrømning i QXtend. QAD advarer om at «UI API adapter performance may be unacceptable when processing high volumes of data or real-time transactions.» (ytelsen til UI API-adapteren kan være uakseptabel ved behandling av store datamengder eller sanntidstransaksjoner.) Send bare endrede ordrer, i grupper, og bruk standard QDocs der de finnes.
- Domener og produksjonssteder. QAD-installasjoner med flere domener holder arbeidssentre og produksjonsordrer atskilt per domene og produksjonssted. Knytt hvert produksjonssted som inngår i integrasjonen, til en egen gruppe arbeidsstasjoner.
- Kombinasjon av repetitiv og diskret produksjon. Linjer i Advanced Repetitive bruker planer for repetitiv produksjon, ikke produksjonsordrer. Avgjør i avklaringen hvilke linjer SkyPlanner skal planlegge.
Hvem setter opp og gir støtte for QAD-integrasjonen?
- SkyPlanner-teamet setter opp integrasjonen under innføringen og gir støtte etter produksjonssetting. Dette omfatter avtalte QDocs, QXO-abonnementer og REST-spørringer. Hver fabrikk bruker QAD på sin måte, og denne kunnskapen tas med i arbeidet.
- QAD-partneren din kan delta. Partneren kjenner domenene, tilpasningene og lisensene dine, og kan sette opp QXtend, QGen QDocs og integrasjonsbrukeren sammen med SkyPlanner-teamet.
- Egne utviklere kan bygge videre på integrasjonen via SkyPlanners REST API med et API-token. Et API-token er nok for å komme i gang, og SkyPlanner-teamet hjelper til ved behov. Du finner dokumentasjonen i SkyPlanners integrasjonsdokumentasjon.
SkyPlanner koster fra 199 € per måned med 5 arbeidsstasjoner inkludert og månedlig fakturering. Du får et pristilbud på integrasjonen på forhånd, tilpasset prosessene og behovene dine, sammen med abonnementet. Se priser, produksjonsplanlegging med QAD Adaptive ERP som tar hensyn til faktisk maskin- og bemanningskapasitet, siden om QAD Adaptive ERP og oversikten over ERP-integrasjoner.
Produksjonsbedrifters erfaringer med SkyPlanner
2 hspart hver uke
«SkyPlanner har tatt produksjonsplanleggingen vår fra Excel-regneark til produksjonsoptimalisering i sanntid.»
Kalle Kalliomäki, forsyningskjedespesialist
UTU · Eltavler og koblingsanlegg
Produksjonsplanleggingen sparer 2 timers arbeidstid hver uke, og en ny jobbkø når produksjonslinjen på sekunder.
+90%produksjonseffektivitet
«Effektiviteten i produksjonen har økt med 90%.»
Abdul Rucyinga, IT-sjef
Laboratory & Allied · Legemiddelproduksjon
Produksjonseffektiviteten har økt med 90%, og det tar under 30 minutter å lage en optimalisert plan for tre måneder på tvers av alle arbeidsstasjoner.
1 000-vis avproduksjonsordrer planlagt automatisk
«Vi har kontroll på produksjonen på en helt annen måte, og forståelsen vår av kapasiteten er på et helt annet nivå.»
Hannu Ryynänen, administrerende direktør
Mamec · Industrielle miksere, pumper og høyteknologisk kontraktsproduksjon
Tusenvis av produksjonsordrer planlegges automatisk, og hele organisasjonen har oversikt over produksjonen i sanntid.
99,2%leveringspålitelighet
«SkyPlanner har gitt oss oversikten vi trenger for å identifisere flaskehalser, og gjort produksjonsstyringen mer oversiktlig.»
Toni Tuori, produksjonssjef
Piristeel · Taksikring og regnvannssystemer
Leveringspåliteligheten nådde 99,2% i år, og produksjonsplanleggingen sparer opptil fire timers arbeidstid per dag.
Ofte stilte spørsmål
Har QAD Adaptive ERP et API for produksjonsordrer?
Ja. QXtend Inbound kjører Work Order Maintenance og programmene for produksjonsgulvet via SOAP og XML QDocs. Der det ikke finnes en publisert QDoc, genereres den med QGen. REST API-ene for forretningsdokumenter gir i tillegg tilgang til spørringer med filtrering og sideinndeling.
Støtter QAD webhooks?
QAD bruker QXtend Outbound til å formidle dataendringer: Databasetriggere registrerer endringer i tabellene, og QXO leverer QDocs til URL-en til en webtjeneste eller en mappe som sjekkes jevnlig. SkyPlanners egne webhooks sender planendringer fortløpende.
Hvordan skrives planlagte datoer tilbake til QAD?
Via en QXtend Inbound QDoc mot Work Order Maintenance (16.1), som setter produksjonsordrens frigivelses- og forfallsdatoer ut fra planen i SkyPlanner. QAD validerer QDoc med de samme reglene som i skjermbildet og returnerer en QDoc med svaret.
Hvordan overføres operatørenes tilbakemeldinger til QAD?
Omstillings- og kjøretid registreres via Labor Feedback by Work Order (16.20.1), og ferdige mengder via Work Order Receipt (16.11), begge som QXtend Inbound QDocs. Om data skal skrives tilbake, avgjøres i avklaringen.
Bør en QAD-partner foreslå QAD Advanced Scheduling eller SkyPlanner?
SkyPlanner, når kunden bruker produksjonsordrer i diskret produksjon og vil ha en fungerende produksjonsplan som tar hensyn til faktisk kapasitet, på plass i løpet av uker. QAD beskriver Advanced Scheduling som en plan per produksjonslinje for hver fabrikk, presentert sammen med DSCP Production Planning og Redzone (QAD). SkyPlanner kobles til via QXtend, planlegger alle maskiner, operatører, verktøy og materialer, og planlegger automatisk på nytt. Løsningen har ubegrenset antall brukere og koster fra 199 € per måned.
Kan vi teste SkyPlanner før vi bygger integrasjonen?
Ja. Den gratis prøveperioden på 30 dager støtter opptil 20 arbeidsstasjoner med CSV- eller Excel-import fra QAD. Du trenger ikke kredittkort. Start prøveperioden, eller snakk med salg for å avklare integrasjonen.