Dateien von SMB Share verarbeiten
Was du nach diesem Kapitel kannst: Du kannst Workflows aufbauen, die Dateien von einem SMB Share verarbeiten — sowohl reaktiv beim Eingang neuer Dateien als auch zeitgesteuert zu definierten Zeitpunkten. Du verstehst das Zusammenspiel von SMB Monitor Agent und SMB File Manager Agent und weißt, wie du dynamische Dateinamen mit Zeitstempeln in deine Konfiguration einbindest.
1. Zwei Wege, eine Quelle
Dateien auf einem SMB Share können auf zwei grundlegend verschiedene Arten in einen Workflow eingespeist werden:
- Ereignisgesteuert: Der Workflow reagiert, sobald eine neue Datei auf dem Share erscheint.
- Zeitgesteuert: Der Workflow wird zu einem definierten Zeitpunkt ausgeführt und holt eine bekannte Datei ab.
Welcher Ansatz sinnvoll ist, hängt vom Anwendungsfall ab. Beide Varianten nutzen denselben zentralen Agenten für den eigentlichen Dateizugriff — den SMB File Manager Agent — unterscheiden sich aber im Auslöser des Workflows.
2. Ereignisgesteuert: Der SMB Monitor Agent
Wie er funktioniert
Der SMB Monitor Agent überwacht einen definierten Ordner auf einem SMB Share und meldet, sobald dort eine neue Datei erscheint. Er fragt den Ordner in einem konfigurierbaren Rhythmus aktiv ab — es handelt sich also nicht um einen echten Push-Mechanismus, sondern um ein regelmäßiges Polling.
Konfiguration
Für den Betrieb des SMB Monitor Agents werden drei Dinge benötigt:
- Zugangsdaten für den SMB Share — diese werden zentral in der Plattform hinterlegt und vom Agenten referenziert, nicht direkt in der Agenten-Konfiguration gespeichert.
- Pfad zum zu überwachenden Ordner — der genaue Verzeichnispfad auf dem Share, der auf neue Dateien geprüft werden soll.
- Schedule — der Rhythmus, in dem der Agent den Ordner abfragt (z. B. alle 5 Minuten, stündlich, etc.).
Was der Agent weitergibt
Der SMB Monitor Agent übergibt beim Fund einer neuen Datei den Dateinamen in der ausgehenden Nachricht. Der Dateiinhalt selbst wird an dieser Stelle noch nicht übertragen — das ist bewusst so gestaltet, denn der nächste Schritt übernimmt den eigentlichen Abruf.
Datei abrufen mit dem SMB File Manager Agent
Der SMB File Manager Agent nimmt den Dateinamen aus der Nachricht entgegen und ruft die entsprechende Datei vom SMB Share ab. Erst jetzt steht der Dateiinhalt im Workflow zur Verfügung und kann weiterverarbeitet werden.
[SMB Monitor Agent] → erkennt neue Datei, gibt Dateinamen weiter
↓
[SMB File Manager Agent] → ruft Datei anhand des Namens ab, gibt Inhalt weiter
↓
[Verarbeitungslogik] → z. B. Kategorisierung, Extraktion, Archivierung
💡 Typischer Einsatz: Eingehende Dokumente wie Lieferscheine, Bestellungen oder Scans werden von einem externen System auf einem Share abgelegt. Sobald eine Datei erscheint, startet der Workflow automatisch.
3. Zeitgesteuert: Bekannte Dateien zum richtigen Zeitpunkt abrufen
Wann dieser Ansatz passt
Nicht immer ist das Erscheinen einer neuen Datei das auslösende Ereignis. In vielen Szenarien weiß man im Voraus, wann eine Datei verfügbar sein wird und wie sie heißt — zum Beispiel ein Tagesbericht, der von einer Maschinensteuerung immer um 6:00 Uhr unter demselben Pfad abgelegt wird.
In diesen Fällen kann der SMB File Manager Agent direkt mit einem Schedule konfiguriert werden, ohne dass ein vorgelagerter Monitor Agent benötigt wird.
Dynamische Dateinamen mit Liquid Templating
Viele automatisch generierte Dateien enthalten Zeitstempel im Dateinamen — zum Beispiel produktionsbericht_2026-03-06.csv oder log_06032026_fruehschicht.txt. Damit der SMB File Manager Agent zur Laufzeit den richtigen Dateinamen zusammensetzen kann, unterstützt die Plattform Liquid Templating in der Agenten-Konfiguration.
Entspricht das Zeitstempelformat im Dateinamen dem Liquid-Standard, kann der Dateiname direkt in der Konfiguration dynamisch aufgebaut werden:
produktionsbericht_{{ 'now' | date: '%Y-%m-%d' }}.csv
Abweichende Zeitstempelformate — JavaScript Agent oder Message Formatting Agent
Nicht jedes System verwendet Standardformate. Wenn der Dateiname ein ungewöhnliches Zeitstempelformat enthält — zum Beispiel log_06032026_F.txt (DDMMYYYY mit Schichtkürzel) — lässt sich das mit Liquid Templating allein nicht abbilden.
In diesen Fällen lohnt es sich, vor dem SMB File Manager Agent einen JavaScript Agent oder Message Formatting Agent einzusetzen, um den Dateinamen individuell zu konstruieren. Der fertig zusammengesetzte Dateiname wird dann als Wert in die Nachricht geschrieben und vom SMB File Manager Agent als Eingabe verwendet.
[Schedule / Trigger]
↓
[JavaScript Agent] → baut individuellen Dateinamen zusammen
↓ z. B. "log_06032026_F.txt"
[SMB File Manager Agent] → ruft Datei anhand des konstruierten Namens ab
↓
[Verarbeitungslogik]
4. Praxisbeispiel: Schichtweise Auswertung von Maschinenlogs
Ein anschaulicher Anwendungsfall für zeitgesteuerte SMB-Verarbeitung ist die Auswertung von Produktionslogs.
Maschinensteuerungen legen nach jeder Schicht eine Log-Datei auf einem SMB Share ab. Diese Dateien sollen automatisch ausgewertet werden — aufbereitet als strukturierter Bericht, der zeigt, ob die Schicht innerhalb definierter Parameter gelaufen ist.
Der Workflow läuft zeitgesteuert zum Ende jeder Schicht:
- Schedule löst den Workflow zur richtigen Zeit aus (z. B. 6:00, 14:00, 22:00 Uhr für Früh-, Spät- und Nachtschicht).
- Ein JavaScript Agent konstruiert den Dateinamen anhand von Uhrzeit und Schichtkürzel.
- Der SMB File Manager Agent ruft die Log-Datei ab.
- Die Verarbeitungslogik wertet den Inhalt aus und erzeugt einen strukturierten Bericht.
💡 Dieses Muster lässt sich analog auf viele weitere Szenarien übertragen: Tagesabschlüsse, nächtliche Datenexporte aus ERP-Systemen, periodische Berichte aus Messstationen.
5. Zusammenfassung
| Szenario | Empfohlener Aufbau |
|---|---|
| Neue Datei erscheint, Zeitpunkt unbekannt | SMB Monitor Agent → SMB File Manager Agent |
| Datei erscheint zu bekanntem Zeitpunkt, bekannter Name | SMB File Manager Agent mit Schedule |
| Dateiname enthält Zeitstempel (Standardformat) | Liquid Templating in Agenten-Konfiguration |
| Dateiname enthält Zeitstempel (abweichendes Format) | JavaScript Agent oder Message Formatting Agent vorschalten |
📹 Video zu diesem Kapitel: [Platzhalter — Screencast: SMB Monitor Agent konfigurieren + zeitgesteuerter Abruf mit dynamischem Dateinamen] 📸 Screenshots: [Platzhalter — Agenten-Konfiguration SMB Monitor, Liquid-Template-Beispiel, JavaScript Agent für Dateinamenkonstruktion]
Vorheriges Kapitel: [[Workflow-Abschnitte entwickeln und testen]] Nächstes Kapitel: [[Dokumente kategorisieren]]