@arburg/als-nodes 1.1.1
> Node-RED Knotensammlung für die Integration mit dem ARBURG ALS (Automation & Logistics System).
@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.
