Handleiding voor de QAD Adaptive ERP koppeling voor productieplanning met SkyPlanner APS

QAD biedt externe planningssoftware drie mogelijkheden:

1. QAD QXtend Inbound (QXI). QAD omschrijft dit als “a Web services-based, SOAP-compliant, XML framework, enabling complete platform-independent access to QAD Enterprise Applications business functionality.” (Een XML-framework op basis van webservices dat aan SOAP voldoet en volledig platformonafhankelijke toegang biedt tot de bedrijfsfunctionaliteit van QAD Enterprise Applications.) Elke aanvraag is een QDoc die een QAD-programma uitvoert met dezelfde validatie als in het bijbehorende scherm. Elke aanvraag levert een antwoord-QDoc op. Beschikbare QDocs zijn onder meer maintainItemMaster, maintainRouting en maintainPurchaseOrder. Voor programma’s zonder beschikbare QDoc legt de QGen-tool van QAD de mapping van het menuprogramma vast: “QGen is used to map custom programs or QAD Enterprise Applications programs that do not have released QDoc schemas and events files.” (QGen wordt gebruikt om maatwerkprogramma’s of QAD Enterprise Applications-programma’s te mappen waarvoor geen QDoc-schema’s en eventbestanden beschikbaar zijn.) QAD gebruikt deze route zelf: “QAD Production Scheduler uses QAD QXtend to update work orders.” (QAD Production Scheduler gebruikt QAD QXtend om productieorders bij te werken.) (QXtend-handleiding)
2. QAD QXtend Outbound (QXO). QXO “exports user-configurable business objects as XML QDocs out of QAD products.” (Exporteert door de gebruiker configureerbare bedrijfsobjecten als XML QDocs uit QAD-producten.) Standaard bedrijfsobjecten zijn onder meer Item, Product Structure, Routing, Work Center, Department, Inventory Transaction en Inventory Status.
3. REST API’s voor bedrijfsdocumenten. Sinds Adaptive ERP 2022.1 geldt: “Query REST APIs are now available for business documents,” (Query REST API’s zijn nu beschikbaar voor bedrijfsdocumenten.) Ze ondersteunen filteren, sorteren, paginering en het opvragen van een deel van de gegevens. De documentatie staat in Swagger op uw eigen instantie (release-informatie).

Schrijven gebeurt via QXtend. Lezen gebeurt via QXO en de REST-query-API’s.

QXtend Outbound is het mechanisme waarmee QAD gegevenswijzigingen doorgeeft. “A change occurs to watched data in QAD Enterprise Applications. Change notifications are written out to the qxevents database.” (Bewaakte gegevens in QAD Enterprise Applications worden gewijzigd. Meldingen van die wijzigingen worden naar de qxevents-database geschreven.) QXO stelt vervolgens de QDocs samen en levert ze “to a directory location where the subscriber polls for and picks up new QDocs,” (aan een map waarin de subscriber regelmatig controleert op nieuwe QDocs en deze ophaalt), of aan een webservice die op een URL luistert.

SkyPlanner abonneert zich als webservice op de publicaties van QXO en vraagt via de REST-query-API’s op wat QXO niet dekt. Work Order behoort niet tot de standaard bedrijfsobjecten van QXO. Daarom voegt de koppeling een QXO-bedrijfsobject toe op de productieordertabellen (wo_mstr, wr_route), of vraagt deze de productieorders om de paar minuten op via de REST-query-API’s.

SkyPlanner verstuurt webhooks wanneer de status of het productieschema verandert. Het terugschrijven is dus eventgestuurd.

1. Eerste import van stamgegevens. Lees artikelen, productstructuren, bewerkingsvolgordes, werkcentra en kalenders in via QXO of de REST-query-API’s. Maak bewuste keuzes bij het mappen van werkcentra: een werkcentrum met vier machines wordt één groep werkcentra of vier afzonderlijke werkcentra. Ook lijnen voor repetitieve productie uit Production Line Maintenance kunnen als werkcentra worden ingericht.

2. Productieorders synchroniseren. Lees vast geplande en vrijgegeven productieorders in, inclusief hun bewerkingsvolgordes en componenten, plus openstaande inkooporders. SkyPlanner beschouwt besteld materiaal als beschikbaar op de leverdatum van de inkooporder en werkt de voorraad bij zodra de inkooporder de status Delivered krijgt.

Plan productieorders in, geen geplande MRP-orders. Geplande orders moeten in QAD eerst worden omgezet in vast geplande of vrijgegeven productieorders.

3. Planningsdatums terugschrijven. Wanneer de planningsengine een order inplant of verplaatst, activeert een SkyPlanner-webhook een QXtend Inbound QDoc voor Work Order Maintenance (16.1). Deze stelt de vrijgavedatum in op de datum van de eerste ingeplande bewerking en de einddatum op die van de laatste. QXtend voert het programma uit met de eigen validatie van QAD en geeft een antwoord-QDoc terug die door de koppeling wordt gecontroleerd.

De volgorde van bewerkingen op elke machine blijft in SkyPlanner en wordt via Mobile Confirmations aan operators doorgegeven. Zo loopt de koppeling niet vast op de blokkering van de bewerkingsvolgorde die QAD bij vrijgegeven orders toepast.

4. Terugmeldingen uit de productie. Operators registreren hun werk met SkyPlanner Mobile Confirmations of de Production Timer. Die tijdregistraties houden het productieschema actueel. U kiest of de werkelijke tijden naar QAD worden teruggeboekt. Zo ja, dan gaan instel- en bewerkingstijden per bewerking naar Labor Feedback by Work Order en gereedgemelde aantallen naar Work Order Receipt. Zo nee, dan worden arbeidsuren zoals voorheen in QAD ingevoerd.

5. Gegevenseigenaarschap en conflictregels. Leg deze vóór de livegang vast:

Kies één systeem dat de datums van productieorders schrijft. SkyPlanner heeft geen QAD-planningsmodule nodig. Voor de orders die SkyPlanner inplant, neemt het daarom het schrijven van de datums over van de planningstools of andere planningssoftware.

• CRP opnieuw uitvoeren. CRP plant alle openstaande bewerkingen van de geselecteerde productieorders opnieuw in. QAD behoudt handmatig ingestelde datums alleen als “you also adjusted the work order release and due date to match,” (u ook de vrijgave- en einddatum van de productieorder daarop hebt aangepast). Dat zijn precies de datums die SkyPlanner schrijft. Voer CRP uit na het terugschrijven, of sluit de orders uit die SkyPlanner plant.
• Vrijgegeven bewerkingsvolgordes liggen vast. “Once the work order status is Exploded, Allocated, or Released, no more changes can be made to the routing.” (Zodra de productieorder de status Exploded, Allocated of Released heeft, kan de bewerkingsvolgorde niet meer worden gewijzigd.) Lees de bewerkingsvolgorde uit bij vrijgave en wijzig deze alleen bij geplande of vast geplande orders.
• Tijdseenheden in de bewerkingsvolgorde. Instel- en bewerkingstijd tellen mee als belasting, terwijl “queue, wait, and move times are excluded from load calculations.” (wachtrijtijd, wachttijd en verplaatstijd niet meetellen in de belastingsberekening). Modelleer wachtrijtijd, wachttijd en verplaatstijd in SkyPlanner als stappen die alleen tijd kosten. Controleer ook of de bewerkingstijd per stuk of per order geldt.
• Verwerkingscapaciteit van QXtend. QAD waarschuwt: “UI API adapter performance may be unacceptable when processing high volumes of data or real-time transactions.” (De prestaties van de UI API adapter kunnen onaanvaardbaar zijn bij de verwerking van grote hoeveelheden gegevens of realtime transacties.) Verstuur alleen gewijzigde orders, doe dit in batches en gebruik native QDocs waar die beschikbaar zijn.
• Domeinen en vestigingen. QAD-installaties met meerdere domeinen houden werkcentra en productieorders per domein en vestiging bij. Koppel elke vestiging binnen de scope aan een eigen groep werkcentra.
• Combinatie van repetitieve en discrete productie. Lijnen met Advanced Repetitive werken met repetitieve planningen, niet met productieorders. Bepaal tijdens de scopebepaling welke lijnen SkyPlanner plant.