HELIOS Schnittstelle: Leitfaden zur Feinplanung mit SkyPlanner APS

Helios Inuvio Server (Inuvio REST API). Asseco beschreibt ihn als separaten Bestandteil von HELIOS iNuvio, der per REST API Zugriff auf die Fachbereiche von HELIOS iNuvio bietet (Hilfe zu Helios Inuvio Server). Er wird mit iNuvio ausgeliefert. Die OpenAPI-Spezifikation ist im Rapidoc- und Redoc-Format veröffentlicht. Die API arbeitet mit HELIOS-Übersichten (Browses), die jeweils eine eigene ID und eigene Berechtigungen haben:

• GET /browses/list und GET /browses/meta listen die verfügbaren Übersichten und deren Spalten auf.
• /browses/data liest die Zeilen einer Übersicht und schreibt Zeilen, sofern die Übersicht das Anlegen, Ändern und Löschen zulässt.
• /api/v1/actions/meta und /api/v1/actions/execute/{dbName}/{browseIdent}/{actionIdent} führen externe Aktionen auf einer Übersicht aus. Derzeit sind dies externe Aktionen der Typen Procedure, Browse und Plugin.

Zu den Fertigungsübersichten für Planer gehören der Produktionsplan (výrobní plán), Fertigungsaufträge (výrobní příkazy), Teile zu Fertigungsaufträgen, Material und Halbfertigwaren für die Fertigung, Berufsgruppen, Personalressourcen, Vorlagen für Arbeitsgänge im Arbeitsplan sowie Arbeitsgangrückmeldungen. Lagerbestände, Wareneingänge, Warenabgänge und erteilte Bestellungen (vydané objednávky) sind auf demselben Weg verfügbar.

HELIOS Nephrite REST API. Die Nephrite-Roadmap sieht die Entwicklung einer REST API vor (HELIOS Nephrite-Roadmap). Bei der Anforderungsaufnahme klärt das SkyPlanner-Team mit Ihnen und Ihrem HELIOS-Partner die Nephrite-Endpunkte für Ihre Installation. Die nachfolgend beschriebenen Datenflüsse bleiben gleich.

Excel und CSV. Jede HELIOS-Übersicht lässt sich nach Microsoft Office exportieren. Das reicht für den Datenimport im Testbetrieb aus.

SkyPlanner liest HELIOS in festgelegten Intervallen aus. Aufrufe von /browses/data erfassen neue Aufträge; dabei wird nach offenen Fertigungsaufträgen und aktuellen Änderungen gefiltert. Die Häufigkeit wird je Werk festgelegt: von wenigen Minuten bei Fertigungsaufträgen bis zu einer Stunde bei Lagerbeständen.

SkyPlanner sendet Webhooks, wenn sich der Status oder der Plan ändert. Das Rückschreiben erfolgt somit ereignisgesteuert.

1. Erstimport der Stammdaten. Lesen Sie Fertigungsteile, Stücklisten, Arbeitspläne, Arbeitsplätze, Maschinen, Berufsgruppen, Personalressourcen und Kalender aus den TPV-Übersichten. Jede HELIOS-Ressource hat ein Kennzeichen für die Einbeziehung in die Kapazitätsplanung. Legen Sie deshalb je Ressource fest, was SkyPlanner einplant. Ein Arbeitsplatz mit vier Maschinen wird zu einer Arbeitsstationsgruppe oder zu vier Arbeitsstationen.

2. Aufträge synchronisieren. Lesen Sie Fertigungsaufträge mit ihren Teilen, Arbeitsgängen und Materialien sowie erteilte Bestellungen aus. SkyPlanner betrachtet bestelltes Material zum Liefertermin der Bestellung als verfügbar und aktualisiert den Lagerbestand, sobald die Bestellung als Delivered markiert ist. Planen Sie freigegebene Fertigungsaufträge ein. Planmengen im Produktionsplan bleiben in HELIOS, bis daraus Fertigungsaufträge werden.

3. Planung zurückschreiben. Wenn die Planungsengine einen Arbeitsgang einplant oder verschiebt, löst ein SkyPlanner-Webhook über /api/v1/actions/execute eine externe Aktion auf der Fertigungsauftragsübersicht aus. Dahinter steht eine HELIOS-Prozedur, die bei der Anforderungsaufnahme vereinbart wird und den geplanten Start sowie das geplante Ende des Auftragsarbeitsgangs setzt. HELIOS prüft die Änderung anhand seiner eigenen Logik.

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 HELIOS zurückgeschrieben werden. Falls ja, erfasst eine externe Aktion sie als Arbeitsgangrückmeldungen je Auftragsarbeitsgang. Falls nein, melden die Bediener weiterhin an den HELIOS-Terminals zurück und SkyPlanner liest diese Rückmeldungen aus.

5. Datenhoheit und Konfliktregeln. Halten Sie diese vor dem Produktivstart schriftlich fest:

Legen Sie genau ein System fest, das Auftragstermine schreibt. Falls die Kapazitätsplanung von HELIOS oder Nephrite APS weiterhin Termine schreibt, deaktivieren Sie dies für Aufträge, die SkyPlanner einplant. Alternativ nutzen Sie den HELIOS-Plan ausschließlich als Testplan.

• Planungskennzeichen. Nur Ressourcen, die für die Kapazitätsplanung gekennzeichnet sind, verfügen über verlässliche Kapazitätsdaten. Prüfen Sie vor dem Erstimport die Kennzeichen bei Arbeitsplätzen, Maschinen, Berufsgruppen und Fremdvergaben.
• Zeiteinheiten. Vorbereitungs-, Stück- und Abschlusszeiten können in Stunden, Minuten oder Sekunden angegeben werden. Rechnen Sie die Werte beim Import um, sonst ist jede Dauer falsch.
• Zwischenzeit. Die konstante Zwischenzeit ist eine Wartezeit zwischen Arbeitsgängen, keine Maschinenzeit. Bilden Sie sie als Wartezeit ab, nicht als Kapazitätsbedarf.
• Fremdarbeitsgänge (kooperace). Die Transportzeit fällt auf dem Hin- und Rückweg an. Bilden Sie Fremdarbeitsgänge als Schritte ab, die nur Zeit beanspruchen.
• Beschreibbare Übersichten. Alle Übersichten lassen sich lesen, aber nur einige unterstützen das Anlegen, Ändern und Löschen von Datensätzen. GET /browses/list mit dem Filter browseCreateImplemented=1 zeigt, welche das sind. Die Übersichten für Fertigungsaufträge sind schreibgeschützt. Geplante Termine werden deshalb über die vereinbarte externe Aktion zurückgeschrieben.