Leitfaden zur QAD Adaptive ERP Schnittstelle für die Feinplanung mit SkyPlanner APS

QAD bietet drei Wege, um ein externes Feinplanungssystem anzubinden:

1. QAD QXtend Inbound (QXI). QAD beschreibt es als „a Web services-based, SOAP-compliant, XML framework, enabling complete platform-independent access to QAD Enterprise Applications business functionality.“ (Ein Webservice-basiertes, SOAP-konformes XML-Framework, das vollständig plattformunabhängigen Zugriff auf die Geschäftsfunktionen von QAD Enterprise Applications ermöglicht.) Jede Anfrage ist ein QDoc, das ein QAD-Programm mit denselben Prüfungen wie in dessen Bildschirmmaske ausführt. Jede Anfrage liefert ein Antwort-QDoc zurück. Zu den freigegebenen QDocs gehören maintainItemMaster, maintainRouting und maintainPurchaseOrder. Für Programme ohne freigegebenes QDoc bildet das QAD-Werkzeug QGen das Menüprogramm ab: „QGen is used to map custom programs or QAD Enterprise Applications programs that do not have released QDoc schemas and events files.“ (QGen bildet kundenspezifische Programme oder Programme von QAD Enterprise Applications ab, für die keine freigegebenen QDoc-Schemas und Ereignisdateien vorliegen.) QAD nutzt diesen Weg selbst: „QAD Production Scheduler uses QAD QXtend to update work orders.“ (QAD Production Scheduler nutzt QAD QXtend, um Fertigungsaufträge zu aktualisieren.) (QXtend-Leitfaden)
2. QAD QXtend Outbound (QXO). QXO „exports user-configurable business objects as XML QDocs out of QAD products.“ (Exportiert vom Benutzer konfigurierbare Geschäftsobjekte als XML-QDocs aus QAD-Produkten.) Zu den Standardgeschäftsobjekten gehören Item, Product Structure, Routing, Work Center, Department, Inventory Transaction und Inventory Status.
3. REST APIs für Geschäftsbelege. Seit Adaptive ERP 2022.1 gilt: „Query REST APIs are now available for business documents,“ (Für Geschäftsbelege stehen jetzt REST-Abfrage-APIs zur Verfügung.) Sie unterstützen Filtern, Sortieren, seitenweise Abfragen und die Auswahl von Teildaten. Die Dokumentation finden Sie in Swagger auf Ihrer Instanz (Versionshinweise).

Schreibzugriffe laufen über QXtend. Lesezugriffe erfolgen über QXO und die REST-Abfrage-APIs.

QXtend Outbound ist der QAD-Mechanismus zur Übertragung von Datenänderungen. „A change occurs to watched data in QAD Enterprise Applications. Change notifications are written out to the qxevents database.“ (Überwachte Daten in QAD Enterprise Applications ändern sich. Änderungsmeldungen werden in die Datenbank qxevents geschrieben.) QXO erstellt anschließend die QDocs und übermittelt sie „to a directory location where the subscriber polls for and picks up new QDocs,“ (an ein Verzeichnis, das der Subscriber regelmäßig auf neue QDocs prüft, um sie abzuholen) oder an einen Webservice, der unter einer URL erreichbar ist.

SkyPlanner empfängt die von QXO veröffentlichten Daten als abonnierender Webservice. Alles, was QXO nicht abdeckt, fragt SkyPlanner regelmäßig über die REST-Abfrage-APIs ab. Work Order gehört nicht zu den Standardgeschäftsobjekten von QXO. Deshalb ergänzt die Integration entweder ein QXO-Geschäftsobjekt auf Basis der Fertigungsauftragstabellen (wo_mstr, wr_route) oder fragt Fertigungsaufträge alle paar Minuten über die REST-Abfrage-APIs ab.

SkyPlanner sendet Webhooks, sobald sich der Status oder der Plan ändert. Das Zurückschreiben erfolgt damit ereignisgesteuert.

1. Erstimport der Stammdaten. Lesen Sie Artikel, Produktstrukturen, Arbeitspläne, Arbeitsstationen und Kalender über QXO oder die REST-Abfrage-APIs ein. Legen Sie die Zuordnung der Arbeitsstationen bewusst fest: Eine QAD-Arbeitsstation mit vier Maschinen wird zu einer Arbeitsstationsgruppe oder zu vier Arbeitsstationen. Auch Serienfertigungslinien aus Production Line Maintenance lassen sich als Arbeitsstationen abbilden.

2. Fertigungsaufträge synchronisieren. Lesen Sie fest geplante und freigegebene Fertigungsaufträge mit ihren Arbeitsplänen und Komponenten sowie offene Bestellungen ein. SkyPlanner betrachtet bestelltes Material zum Liefertermin der Bestellung als verfügbar und aktualisiert den Bestand, sobald die Bestellung als Delivered markiert ist.

Planen Sie Fertigungsaufträge ein, keine MRP-Planaufträge. Planaufträge werden zunächst in QAD in fest geplante oder freigegebene Fertigungsaufträge umgewandelt.

3. Planungsergebnisse zurückschreiben. Wenn die Planungsengine einen Auftrag einplant oder verschiebt, löst ein SkyPlanner-Webhook ein QXtend Inbound QDoc für Work Order Maintenance (16.1) aus. Es setzt den Freigabetermin auf den Termin des ersten eingeplanten Arbeitsgangs und den Fälligkeitstermin auf den des letzten. QXtend führt das Programm mit den QAD-eigenen Prüfungen aus und liefert ein Antwort-QDoc zurück, das die Integration prüft.

Die Reihenfolge der Arbeitsgänge auf jeder Maschine bleibt in SkyPlanner und wird den Bedienern über Mobile Confirmations bereitgestellt. So greift die Integration nicht in Arbeitspläne ein, die QAD bei freigegebenen Aufträgen gegen Änderungen sperrt.

4. Rückmeldungen aus der Fertigung. Bediener erfassen ihre Arbeit mit SkyPlanner Mobile Confirmations oder dem Production Timer. Diese Zeiterfassungen halten den Plan aktuell. Sie entscheiden, ob Istzeiten an QAD zurückgemeldet werden. Falls ja, gehen Rüst- und Laufzeiten je Arbeitsgang an Labor Feedback by Work Order und fertiggestellte Mengen an Work Order Receipt. Falls nein, werden die Arbeitszeiten wie bisher in QAD erfasst.

5. Datenhoheit und Konfliktregeln. Halten Sie diese vor dem Go-live schriftlich fest:

Legen Sie genau ein System fest, das die Termine der Fertigungsaufträge schreibt. SkyPlanner benötigt kein QAD-Feinplanungsmodul. Für die von SkyPlanner eingeplanten Aufträge übernimmt es daher das Schreiben der Termine anstelle der Planungsworkbenches oder anderer Feinplanungssysteme.

• Erneute CRP-Läufe. CRP plant alle offenen Arbeitsgänge der ausgewählten Fertigungsaufträge neu. QAD behält manuelle Termine nur unter folgender Bedingung bei: „you also adjusted the work order release and due date to match,“ (Sie haben auch den Freigabe- und Fälligkeitstermin des Fertigungsauftrags entsprechend angepasst). Genau diese Termine schreibt SkyPlanner zurück. Führen Sie CRP nach dem Zurückschreiben aus oder schließen Sie die von SkyPlanner geplanten Aufträge aus.
• Freigegebene Arbeitspläne sind gesperrt. „Once the work order status is Exploded, Allocated, or Released, no more changes can be made to the routing.“ (Sobald der Fertigungsauftrag den Status Exploded, Allocated oder Released hat, lässt sich der Arbeitsplan nicht mehr ändern.) Lesen Sie den Arbeitsplan bei der Freigabe aus und ändern Sie Arbeitspläne nur bei geplanten oder fest geplanten Aufträgen.
• Zeiteinheiten im Arbeitsplan. Rüst- und Bearbeitungszeiten belasten die Kapazität. Dagegen gilt: „queue, wait, and move times are excluded from load calculations.“ (Liege-, Warte- und Transportzeiten werden bei der Auslastungsberechnung nicht berücksichtigt.) Bilden Sie diese in SkyPlanner als reine Zeitschritte ab und prüfen Sie, ob die Bearbeitungszeit pro Stück oder pro Auftrag angegeben ist.
• Datendurchsatz mit QXtend. QAD warnt: „UI API adapter performance may be unacceptable when processing high volumes of data or real-time transactions.“ (Bei großen Datenmengen oder Echtzeittransaktionen kann die Leistung des UI API-Adapters unzureichend sein.) Senden Sie nur geänderte Aufträge in Stapeln und verwenden Sie native QDocs, sofern diese verfügbar sind.
• Domänen und Standorte. QAD-Installationen mit mehreren Domänen verwalten Arbeitsstationen und Fertigungsaufträge je Domäne und Standort. Ordnen Sie jedem Standort, der in die Integration einbezogen wird, eine eigene Gruppe von Arbeitsstationen zu.
• Serien- und diskrete Fertigung im Mischbetrieb. Linien in Advanced Repetitive arbeiten mit Serienfertigungsplänen, nicht mit Fertigungsaufträgen. Legen Sie bei der Anforderungsaufnahme fest, welche Linien SkyPlanner plant.