Datei schreiben

Einen Wert aus dem Speicher in eine Datei auf dem Server des AI Kit schreiben.

Um Dateien auf WebDAV/Nextcloud abzulegen, sie in Word, Excel oder CSV umzuwandeln oder Dateien zu kopieren und zu verschieben, verwenden Sie Datei ablegen. Zum Anhängen an Protokoll- oder Textdateien bleibt „Datei schreiben“ die richtige Wahl.

Funktionsweise

Der Schritt nimmt einen Wert aus dem Speicher und schreibt ihn in einen von Ihnen angegebenen Dateipfad. Er kann die Datei überschreiben oder den Inhalt anhängen. Nützlich für Berichte, Exporte, Protokolldateien oder eine einfache Datenhaltung zwischen Läufen.

Die Datei wird aus Sicht des AI-Kit-Servers geschrieben – bei einer selbst betriebenen Installation ist das Ihr eigener Server, einschließlich der dort eingehängten Netzlaufwerke. Verwenden Sie einen absoluten Pfad wie /mnt/share/exports/sales.xlsx; fehlende Ordner werden angelegt.

Dateien, die ein früherer Schritt als Datei erzeugt hat – zum Beispiel eine Excel-Arbeitsmappe –, werden unverändert geschrieben. Text wird in der gewählten Zeichenkodierung geschrieben, strukturierte Daten als formatiertes JSON.

Einstellungen

Feld	Was es steuert	Erforderlich	Hinweise
Dateipfad	Absoluter Pfad der zu schreibenden Datei auf dem Server.	erforderlich	Der AI-Kit-Dienst braucht Schreibrechte für den Ordner.
Zeichenkodierung	Zeichenkodierung für Textdateien.	optional	Standard: UTF-8.
Inhalt	Die zu schreibenden Daten aus dem Speicher.	erforderlich	Aus dem Speicher übernommen. Text, JSON und Binärdaten sind möglich.
Anhängen	Wenn eingeschaltet, wird der Inhalt ans Dateiende angehängt, statt die Datei zu überschreiben.	optional	Standardmäßig ausgeschaltet.
Dateiinfo (Ausgabe)	Speicherschlüssel, der Name, Typ, Größe und Pfad der geschriebenen Datei erhält.	optional	Nützlich für spätere Schritte, die auf die Datei verweisen.

📷 SCREENSHOT: Der Schritt „Datei schreiben“ mit dem Feld für den Dateipfad, der Auswahl der Zeichenkodierung und dem Schalter „Anhängen“.

Beispielszenario

Täglicher Export. Ein per Cron gestarteter Workflow fragt in einer Datenbank die Daten von gestern ab, formatiert sie mit einer KI-Aktion oder einem eigenen Schritt als CSV und schreibt die CSV-Datei auf dem Server nach /exports/sales-{{ date }}.csv. Ein separater Prozess holt die Dateien ab.

Empfehlungen

• ✅ Wählen Sie ein eigenes Verzeichnis für Ausgaben des AI Kit. Das hält das Aufräumen einfach.
• ✅ Verwenden Sie Anhängen für Protokolldateien, wenn der Workflow mehrmals am Tag läuft.
• ✅ Nehmen Sie Datum oder Job-ID in den Dateinamen auf, wenn der Workflow mehr als einmal am Tag läuft. Sonst überschreibt jeder Lauf den vorherigen (außer Sie verwenden Anhängen).
• ⚠️ Beim Anhängen werden keine Zeilenumbrüche ergänzt. Soll jeder Lauf eine eigene Zeile erzeugen, setzen Sie \n an den Anfang des Inhalts oder bauen Sie die Zeile in einem vorherigen Schritt zusammen.
• ❌ Schreiben Sie nicht in systemkritische Pfade. Bleiben Sie in einem Verzeichnis, das dem AI Kit gehört.
• ❌ Schreiben Sie keine Geheimnisse auf die Festplatte. Verwenden Sie stattdessen im Workflow Verweise auf verschlüsselt gespeicherte Felder.

Nächste Schritte

• Auf eingehende Dateien reagieren: Dateisystem-Überwachung.
• Dateien mit Typumwandlung oder auf WebDAV ablegen: Datei ablegen.