@arburg/als-nodes

Node-RED Knotensammlung für die Integration mit dem ARBURG ALS (Automation & Logistics System).

Überblick

Dieses Paket stellt eine Sammlung von Node-RED Knoten bereit, mit denen sich ARBURG Spritzgießmaschinen und Fertigungsressourcen über das ALS-System in Node-RED Flows einbinden lassen. Produktionsereignisse werden in Echtzeit über MQTT empfangen, während Abfragen und Steuerungsbefehle über die REST API gesendet werden.

Voraussetzungen

| Komponente | Version | |------------|---------| | Node.js | ≥ 16.0 | | npm | ≥ 8.0 | | Node-RED | ≥ 3.0 |

Zusätzlich wird ein erreichbares ALS-Backend mit aktivierter REST API und MQTT-Broker benötigt.

Installation

npm install @arburg/als-nodes

Knoten

Konfiguration

| Knoten | Beschreibung | |--------|-------------| | als-config-node | Zentrale Verbindungskonfiguration (Host, Port, Protokoll, Credentials, optionales CA-Zertifikat). Wird von allen anderen Knoten referenziert. |

Event-Listener (MQTT)

Diese Knoten abonnieren MQTT-Topics und geben eingehende Ereignisse als msg.payload aus.

| Knoten | Beschreibung | |--------|-------------| | als-ord-change | Auftragsänderungen – Erstellen, Ändern und Löschen von Aufträgen und Auftragsdurchläufen (NEW_ORDERS, CHG_ORDERS, DEL_ORDERS, …) | | als-production-data-change | Produktionsdaten – Stückzahlen, Leistungskennzahlen und Betriebsdaten in Echtzeit | | als-process-state-change | Prozessstatus-Änderungen von Fertigungsressourcen | | als-auth-state-change | Authentifizierungsereignisse an ALS-Terminals (An-/Abmeldung) | | als-maint-change | Wartungsereignisse – Vorwarnungen, Fälligkeiten, Bestätigungen (MAINT_PREWARN_EVENT, MAINT_DUE_EVENT, …) | | als-energy-state-change | Energieverbrauchs- und Zustandsänderungen (derzeit deaktiviert) |

Abfragen & Aktionen (REST)

| Knoten | Beschreibung | |--------|-------------| | als-get | Informationsabfrage – Liefert Details zu Produktionsübersichten, Ressourcen, Artikeln, Aufträgen, Programmen und Wartungsjobs über die REST API | | als-set-process-state | Setzt den Prozessstatus einer Fertigungsressource per REST-Aufruf (PUT /api/v1.1/resources/{id}/process-state) |

Logik & Filter

| Knoten | Beschreibung | |--------|-------------| | als-filter | Filtert Nachrichten nach Ressourcentyp (Hallen, Maschinen, Werkzeuge, Aufträge, …) und optionalem Schlüssel. Nur passende Nachrichten werden weitergeleitet. | | als-change-filter | Erkennt Wertänderungen einer bestimmten Property und leitet die Nachricht nur bei tatsächlicher Änderung weiter (Deduplizierung). |

Interaktion

| Knoten | Beschreibung | |--------|-------------| | als-form-node | Erzeugt interaktive Formulardialoge auf ALS-Terminals (Mobile Production, Monitoring, Reporting). Unterstützt Eingabefelder, Checklisten, Anhänge, Acknowledgments und konfigurierbare Buttons. Antworten werden über MQTT zurückgeliefert. |

Diagnose

| Knoten | Beschreibung | |--------|-------------| | als-token-info | Zeigt den Status und die Anzahl aktiver REST-API-Tokens an (Development only) |

Architektur

┌────────────────────────────────────────────────────────┐
│                   Node-RED                             │
│                                                        │
│  ┌──────────────┐    ┌─────────────────────────┐       │
│  │ als-config   │──▶│  AxiosFactory (REST)     │──────│──▶ ALS REST API / ALS EMS API
│  │              │    └─────────────────────────┘       │
│  └──────┬───────┘                                      │
│         │            ┌─────────────────────────┐       │
│         └──────────▶│  MqttFactory (MQTT)      │──────│──▶ ALS MQTT Broker
│                      └─────────────────────────┘       │
│                                                        │
│  Event-Knoten ◀── MQTT Topics: als/{project}/{event}  │
│  (GET)/SET-Knoten ──▶ REST: /rest/api/v1.1/...        │
└────────────────────────────────────────────────────────┘

• AxiosFactory – HTTP-Client mit Bearer-Token-Authentifizierung, automatischem Token-Refresh bei 401/403-Fehlern und optionaler TLS-Zertifikatsvalidierung.
• MqttFactory – Verbindungsmanagement für MQTT-Knoten mit automatischer Reconnect-Logik und Statusanzeige (rot/gelb/grün).

Verfügbare REST-Ressourcen

Der als-get-Knoten kann folgende Ressourcentypen abfragen:

• Produktionsübersichten – nach Halle, Gruppe, ID, Maschine oder Arbeitsplatz
• Ressourcen – Maschinen, manuelle Arbeitsplätze, Werkzeuge, Materialien
• Artikel – nach Artikelname
• Aufträge – nach Auftrags-ID, inkl. Unteraufträge
• Programme – nach Programm-ID
• Wartung – nach Job-ID

Mehrmandantenfähigkeit

Der Config-Knoten unterstützt die optionale Anbindung an mehrere ALS-Systeme gleichzeitig über unterschiedliche Projektnummern. Jeder Event-Knoten kann so konfiguriert werden, dass er Ereignisse von einem oder mehreren Systemen empfängt.

Changelog

Alle Änderungen sind im CHANGELOG.md dokumentiert.

Lizenz

Siehe LICENSE.