Zum Hauptinhalt springen

KI-GESTÜTZTE DOKUMENTATION

Was möchten Sie wissen?

E-Mail-Versand mit Node-RED

Dieses Tutorial zeigt Ihnen, wie Sie automatisierte E-Mail-Benachrichtigungen von Ihrer OV20i-Kamera mit Node-RED einrichten. Sie lernen, die Gmail-Integration zu konfigurieren und Flows zu erstellen, die Inspektionsalarme, Systemstatusaktualisierungen und Fehlermeldungen direkt an Ihre E-Mail senden.

Was Sie erstellen werden: Ein automatisiertes E-Mail-System, das OV20i-Inspektionsergebnisse, Alarme und Benachrichtigungen über Gmail SMTP an festgelegte Empfänger sendet.

Praktische Anwendung: Erhalten Sie sofortige E-Mail-Benachrichtigungen, wenn Inspektionen fehlschlagen, senden Sie tägliche Qualitätsberichte an das Management oder informieren Sie Wartungsteams über Systemprobleme – alles automatisch von Ihrem Bildverarbeitungssystem.

Voraussetzungen​

  • OV20i-Kamera mit Node-RED-Zugriff
  • Gmail-Konto zum Versenden von E-Mails
  • Grundlegendes Verständnis von Node-RED-Flows
  • Zugriff auf die Sicherheitseinstellungen des Google-Kontos

Tutorial-Überblick​

Was wir erstellen werden: Einen Node-RED-Flow, der automatisch E-Mail-Benachrichtigungen mit Inspektionsergebnissen und Systemalarmen versendet.

Erforderliche Zeit: 20–30 Minuten (einschließlich Gmail-Einrichtung)

Erlernte Fähigkeiten: Einrichtung eines Gmail-App-Passworts, SMTP-Konfiguration, automatisierte E-Mail-Benachrichtigungen

Schritt 1: Gmail-App-Passwort einrichten​

1.1 Bestätigung in zwei Schritten aktivieren​

  1. Melden Sie sich in Ihrem Google-Konto an unter accounts.google.com
  2. Klicken Sie auf „Sicherheit" im linken Navigationsmenü
  3. Suchen Sie den Bereich „Bei Google anmelden"
  4. Klicken Sie auf „Bestätigung in zwei Schritten"
  5. Folgen Sie den Anweisungen, um die Bestätigung in zwei Schritten zu aktivieren, falls noch nicht geschehen
hinweis

Die Bestätigung in zwei Schritten ist erforderlich, bevor Sie App-Passwörter erstellen können.

1.2 App-Passwort generieren​

  1. Kehren Sie zur Sicherheitsseite zurück, nachdem Sie die Bestätigung in zwei Schritten aktiviert haben
  2. Klicken Sie auf „App-Passwörter" (unter „Bei Google anmelden")
  3. Wählen Sie „E-Mail" als App-Typ
  4. Wählen Sie „Andere" als Gerätetyp
  5. Geben Sie einen Namen ein, z. B. „OV20i Node-RED Email"
  6. Klicken Sie auf „Generieren"

1.3 App-Passwort speichern​

  1. Kopieren Sie das 16-stellige Passwort, das Google anzeigt
  2. Speichern Sie es sicher – Sie benötigen es für die Node-RED-Konfiguration
  3. Hinweis: Dieses Passwort wird nur einmal angezeigt. Bei Verlust müssen Sie ein neues generieren

Checkpoint: Sie sollten ein 16-stelliges Gmail-App-Passwort für die Verwendung in Node-RED gespeichert haben.

Schritt 2: E-Mail-Nodes installieren (falls erforderlich)​

2.1 Auf E-Mail-Nodes prüfen​

  1. Öffnen Sie Node-RED auf Ihrer OV20i-Kamera
  2. Suchen Sie in der linken Palette nach einem „email"-Node im Output-Bereich
  3. Falls nicht vorhanden, müssen Sie das E-Mail-Paket installieren

2.2 E-Mail-Paket installieren (falls erforderlich)​

  1. Klicken Sie auf das Hamburger-Menü (≡) in Node-RED
  2. Wählen Sie „Manage palette"
  3. Klicken Sie auf den Tab „Install"
  4. Suchen Sie nach „node-red-node-email"
  5. Klicken Sie auf „Install" neben dem Paket

Schritt 3: Einfachen E-Mail-Flow erstellen​

3.1 Erforderliche Nodes hinzufügen​

  1. Navigieren Sie zum IO Block, um auf Node-RED zuzugreifen
  2. Ziehen Sie diese Nodes aus der Palette auf Ihren Canvas:
    • Inject-Node (zum Testen)
    • Email-Node (aus dem Output-Bereich)
  3. Verbinden Sie den Inject-Ausgang mit dem Email-Eingang

3.2 Grundlegende Flow-Struktur​

Inject → Email

Zweck des Flows: Einfacher E-Mail-Versand zum Testen und für grundlegende Benachrichtigungen.

image.png

Schritt 4: E-Mail-Inhalt konfigurieren​

4.1 Inject-Node einrichten​

  1. Doppelklicken Sie auf den Inject-Node, um die Eigenschaften zu öffnen
  2. Payload festlegen:
    • Payload-Typ: "string"
    • Payload-Wert: Ihr E-Mail-Text (z. B. "Inspection alert from OV20i")
  3. E-Mail-Betreff hinzufügen:

    • Klicken Sie auf "+ add", um eine Eigenschaft hinzuzufügen

    • Eigenschaftsname: "topic"

    • Eigenschaftswert: Ihr E-Mail-Betreff (z. B. "OV20i Inspection Alert")

      image.png

4.2 Beispiel für eine Grundkonfiguration​

Payload (E-Mail-Text):

Inspection completed at Station 1
Status: Alert triggered
Time: Check timestamp for details

Topic (E-Mail-Betreff):

OV20i Inspection Alert - Station 1

4.3 Inject-Konfiguration speichern​

  1. Geben Sie dem Node einen Namen wie "Email Trigger"
  2. Klicken Sie auf "Done", um die Konfiguration zu speichern

Schritt 5: E-Mail-SMTP-Einstellungen konfigurieren​

5.1 E-Mail-Node einrichten​

  1. Doppelklicken Sie auf den E-Mail-Node, um die Eigenschaften zu öffnen
  2. Grundeinstellungen konfigurieren:
    • Name: "Send Alert Email" (oder ein aussagekräftiger Name)
    • To: E-Mail-Adresse des Empfängers (z. B. quality@company.com)

5.2 Gmail-SMTP konfigurieren​

  1. Server: smtp.gmail.com
  2. Port: 465
  3. Aktivieren Sie "Use secure connection"
  4. Auth type: Basic
  5. Userid: Ihre vollständige Gmail-Adresse (z. B. alerts@company.com)
  6. Password: Das 16-stellige App-Passwort aus Schritt 1

5.3 Sicherheitseinstellungen​

  1. Aktivieren Sie "Check server certificate is valid"
  2. Überprüfen Sie alle Einstellungen auf Richtigkeit
  3. Klicken Sie auf "Done", um die Konfiguration des E-Mail-Nodes zu speichern

Checkpoint: Ihr E-Mail-Node sollte keine Fehleranzeigen aufweisen und die Empfängeradresse anzeigen.

image.png

Schritt 6: E-Mail-Flow testen​

6.1 Bereitstellen und Testen​

  1. Klicken Sie auf die Schaltfläche "Deploy" in der oberen rechten Ecke
  2. Warten Sie auf die Meldung "Successfully deployed"
  3. Klicken Sie auf die Schaltfläche des Inject-Nodes (graues Quadrat auf der linken Seite)

6.2 E-Mail-Zustellung überprüfen​

  1. Prüfen Sie den E-Mail-Eingang des Empfängers auf die Testnachricht
  2. Prüfen Sie den Spam-Ordner, falls die E-Mail nicht im Posteingang erscheint
  3. Achten Sie auf Fehlermeldungen im Node-RED Debug-Panel

6.3 Fehlerbehebung bei Bedarf​

Häufige Probleme:

  • Falsches App-Passwort: Gmail-App-Passwort neu generieren
  • SMTP-Einstellungen: Server und Port auf Richtigkeit prüfen
  • Firewall: Stellen Sie sicher, dass ausgehender SMTP-Verkehr zulässig ist

Schritt 7: Integration mit Inspektionsergebnissen​

7.1 Mit dem Inspektions-Flow verbinden​

So senden Sie E-Mails basierend auf Inspektionsergebnissen:

  1. Suchen Sie Ihren Haupt-Inspektions-Flow (beginnt mit "All Block Outputs")
  2. Fügen Sie Ihren E-Mail-Flow als Abzweig von der Inspektionsverarbeitung hinzu
  3. Verbinden Sie ihn nach der Inspektionslogik, jedoch parallel zu den Endergebnissen

7.2 Beispiel für einen Integrations-Flow​

All Block Outputs → [Inspection Logic] → Final Pass/Fail
                                      ↓
                              Format Email → Send Email

image.png

7.3 Dynamische E-Mail-Inhalte​

Ersetzen Sie den Inject-Node durch einen Function-Node für dynamische Inhalte:

// Dynamic email based on inspection results
const result = msg.payload.result ? "PASSED" : "FAILED";
const timestamp = new Date().toLocaleString();
const station = global.get("station_name") || "Unknown Station";

// Set email subject
msg.topic = `Inspection ${result} - ${station}`;

// Set email body
msg.payload = `Inspection Report:
Status: ${result}
Station: ${station}
Time: ${timestamp}
Image: ${msg.payload.image_url || "No image available"}

Please review and take appropriate action.`;

return msg;

Schritt 8: Vollständiges Flow-Beispiel​

8.1 Fertigen Flow importieren​

Sie können diesen vollständigen Flow als JSON importieren:

[
  {
    "id": "email_node_1",
    "type": "e-mail",
    "name": "Send Inspection Alert",
    "server": "smtp.gmail.com",
    "port": "465",
    "secure": true,
    "authtype": "BASIC",
    "to": "quality@company.com"
  },
  {
    "id": "format_email",
    "type": "function",
    "name": "Format Email Content",
    "func": "const result = msg.payload.result ? 'PASSED' : 'FAILED';\nmsg.topic = `Inspection ${result}`;\nmsg.payload = `Status: ${result}\\nTime: ${new Date()}`;\nreturn msg;"
  }
]

8.2 An Ihre Anforderungen anpassen​

  1. Aktualisieren Sie die E-Mail-Adressen für Ihre Organisation
  2. Passen Sie den E-Mail-Inhalt an Ihre spezifischen Anforderungen an
  3. Justieren Sie das Timing und die Auslösebedingungen
  4. Testen Sie gründlich, bevor Sie in Produktion gehen

Fehlerbehebung​

Häufige Probleme​

ProblemSymptomeLösung
Authentifizierung fehlgeschlagen„Login failed"-FehlerPrüfen Sie, ob das App-Passwort korrekt ist und die 2-Schritt-Verifizierung aktiviert ist
Verbindungs-TimeoutKeine E-Mail gesendet, Timeout-FehlerFirewall-Einstellungen prüfen, SMTP-Server und Port verifizieren
E-Mails im SpamE-Mails zugestellt, aber im Spam-OrdnerAbsender zur Safe-Liste hinzufügen, E-Mail-Inhalt verbessern
Flow wird nicht ausgelöstKeine Debug-AusgabeFlow-Verbindungen und Auslösebedingungen prüfen

Debugging Ihres E-Mail-Flows​

  1. Debug-Nodes hinzufügen nach jedem Schritt zur Datenverfolgung
  2. Node-RED-Logs prüfen auf detaillierte Fehlermeldungen
  3. SMTP-Einstellungen testen bei Bedarf mit externen E-Mail-Clients
  4. Netzwerkverbindung verifizieren von der Kamera zu den Gmail-Servern

Erfolg! Ihre E-Mail-Integration ist abgeschlossen​

Ihre OV20i-Kamera kann nun:

✅ Automatisierte E-Mail-Benachrichtigungen senden für Inspektionsergebnisse

✅ Reichhaltige, formatierte Nachrichten zustellen mit Inspektionsdetails

✅ Mehrere Empfänger unterstützen und Eskalations-Workflows ermöglichen

✅ Geplante Berichte und Zusammenfassungen bereitstellen

✅ Bedingte Nachrichten verarbeiten basierend auf Inspektionsergebnissen

Best Practices​

E-Mail-Verwaltung​

  • Verwenden Sie aussagekräftige Betreffzeilen mit klaren Statusangaben
  • Halten Sie Nachrichten knapp, aber informativ
  • Fügen Sie Zeitstempel und Stationskennungen ein
  • Liefern Sie umsetzbare Informationen in Benachrichtigungen

Sicherheit und Zuverlässigkeit​

  • Schützen Sie App-Passwörter – sicher speichern und regelmäßig rotieren
  • Verwenden Sie dedizierte E-Mail-Konten für Systembenachrichtigungen
  • Testen Sie die E-Mail-Zustellung regelmäßig, um die Zuverlässigkeit sicherzustellen
  • Überwachen Sie auf Zustellfehler und halten Sie Backup-Benachrichtigungsmethoden bereit

Performance-Überlegungen​

  • E-Mail-Häufigkeit begrenzen, um Spam-Erkennung zu vermeiden
  • Geeignete Empfängerlisten verwenden für unterschiedliche Alarmtypen
  • Rate Limiting implementieren für Systeme mit hohem Aufkommen
  • E-Mail-Größe berücksichtigen, insbesondere bei großen Anhängen

Nächste Schritte​

Nach der Einrichtung von E-Mail-Benachrichtigungen:

  1. E-Mail-Vorlagen erstellen für verschiedene Alarmtypen
  2. Verteilerlisten einrichten für verschiedene Stakeholder
  3. Eskalations-Workflows implementieren für kritische Probleme
  4. Geplante Berichte erstellen für das Management
  5. Mit anderen Benachrichtigungssystemen integrieren (SMS, Teams usw.)
Manuelle Einrichtung überspringen

Der Integration Builder kann vollständige E-Mail-Benachrichtigungs-Flows aus einer Beschreibung in einfachem Englisch generieren. Beschreiben Sie, was Sie möchten (z. B. „send an email with the inspection image when a defect is found") und erhalten Sie in Sekunden einen produktionsreifen Node-RED-Flow.

🔗 Siehe auch​