Seminar ioBroker – Automatisierung mit JavaScript und TypeScript

Textbasierte Skripte eignen sich für komplexe Regeln, wiederverwendbare Funktionen und Integrationslogik, die visuell nur schwer überschaubar bleibt. Das Seminar verbindet Plattform-API, moderne Sprachmittel und betriebliche Qualitätsanforderungen.

Aus kleinen, geprüften Funktionen entsteht schrittweise eine modulare Automationslösung. Besonderes Gewicht liegt auf Ereignisflut, asynchronen Operationen, sicheren Standardzuständen und nachvollziehbarer Diagnose.

Inhaltsverzeichnis

• Lernziele
• Schrittweise Seminarinhalte
• Tag 1: Plattform-API und ereignisgesteuerte Grundlagen
• Tag 2: Asynchronität, Robustheit und Integration
• Tag 3: Modularisierung, Tests und Produktivbetrieb
• Praxisübungen und Laborszenarien
• Zielgruppe und Voraussetzungen
• Didaktik und Arbeitsweise

Lernziele

• Zustände lesen, schreiben, abonnieren und mit Metadaten sicher verarbeiten.
• Ereignis- und Zeitlogik ohne Schleifen, Rennen oder unkontrollierte Mehrfachauslösung implementieren.
• Asynchrone Funktionen, Fehlerbehandlung und Zeitüberschreitungen korrekt einsetzen.
• Wiederverwendbare Module, Konfiguration und Hilfsfunktionen strukturieren.
• Skripte mit Tests, Protokollierung, Versionsführung und Freigabecheckliste betreiben.

Schrittweise Seminarinhalte

Tag 1: Plattform-API und ereignisgesteuerte Grundlagen

1. Schritt 1: Skriptanforderungen in Eingänge, Zustände, Regeln, Ausgänge und Sicherheitsbedingungen zerlegen.
2. Schritt 2: Zustandswerte, Metadaten, Datentypen, Einheiten und Bestätigungsstatus lesen und prüfen.
3. Schritt 3: Ereignisabonnements mit Filtern, Änderungsarten und klarer Entkopplung von Eingabe und Aktion erstellen.
4. Schritt 4: Zustände kontrolliert schreiben und Rückkopplungen durch Bestätigung, Sperren oder Quellenprüfung vermeiden.
5. Schritt 5: Zeitpläne, Verzögerungen und Kalenderlogik mit definiertem Start- und Neustartverhalten aufbauen.

Tag 2: Asynchronität, Robustheit und Integration

1. Schritt 1: Promises und asynchrone Funktionen für Geräteabfragen, Dateizugriffe und externe Operationen verwenden.
2. Schritt 2: Zeitüberschreitung, Wiederholung, Backoff und sichere Ersatzwerte als einheitliche Hilfsfunktionen implementieren.
3. Schritt 3: Ereignisse puffern, entprellen, priorisieren und bei Lastspitzen begrenzen.
4. Schritt 4: Konfigurationswerte und Geheimnisse von der Programmlogik trennen.
5. Schritt 5: Fehler nach Daten-, Geräte-, Netzwerk- und Logikursache klassifizieren und gezielt protokollieren.

Tag 3: Modularisierung, Tests und Produktivbetrieb

1. Schritt 1: Wiederverwendbare Funktionen, Klassen oder Module mit klaren Schnittstellen erstellen.
2. Schritt 2: Typdefinitionen und TypeScript-Prüfungen für Zustandswerte und Konfigurationsobjekte einsetzen.
3. Schritt 3: Testfälle für Normalbetrieb, Grenzwerte, Neustart, fehlende Daten und Verbindungsfehler formulieren.
4. Schritt 4: Diagnosezustände, Metriken und strukturierte Protokollausgaben für den Betrieb ergänzen.
5. Schritt 5: Deployment, Aktivierung, Rollback, Änderungsdokumentation und regelmäßige Funktionskontrolle standardisieren.

Praxisübungen und Laborszenarien

• Modulare Raumregelung mit Anwesenheit, Zeitprofil und manueller Übersteuerung.
• Asynchrone Abfrage mehrerer Datenquellen mit Zeitüberschreitung und Ersatzwert.
• Entprellte Alarmverarbeitung mit Eskalation und Quittierungszustand.
• Test- und Freigabeverfahren für ein produktionsnahes Skriptpaket.

Zielgruppe und Voraussetzungen

Zielgruppe: Entwicklung, technische Automation, fortgeschrittene Administration und Integrationsverantwortung.

Voraussetzungen: Grundkenntnisse in JavaScript; sicherer Umgang mit ioBroker-Objekten und -Zuständen. TypeScript-Vorkenntnisse sind hilfreich, aber nicht zwingend.

Didaktik und Arbeitsweise

Kurze Fachimpulse werden unmittelbar durch Demonstrationen, geführte Konfigurationsschritte, praktische Übungen und kontrollierte Fehlerfälle vertieft. Jeder Arbeitsabschnitt verwendet definierte Ausgangswerte, Prüfpunkte und Dokumentationsanforderungen, damit die erarbeiteten Abläufe reproduzierbar und betrieblich nutzbar bleiben.