Platzhalter für Dateinamen

Beim Ablegen einer Scan-Datei am Zielspeicherort setzt Docuflair den konfigurierten Dateinamen aus Platzhaltern zusammen. Ein Muster wie Scan %w %t wird dabei zu Scan Wednesday 14.05.pdf. Diese Seite listet alle verfügbaren Platzhalter für Dateinamen, Ordnernamen und Speicherpfade — gruppiert nach Ersteller, Dokument, Datum und Zeit, Nummerierung sowie JavaScript-Ausdrücken.

Wo Sie Platzhalter eingeben

• Scan-Kontakte: Feld Dateiname im Scan-Ziel eines Kontakts
• Flow-Workflows: Ordner- und Dateinamen einer Ausgabe
• Speicherorte: der Basispfad eines Ziels (siehe Speicherpfad des Zielorts)

Ersetzungsreihenfolge

Die Platzhalter werden in fester Reihenfolge ersetzt. Das ist relevant, wenn eine Wortersetzung auf das Ergebnis eines anderen Platzhalters wirken soll:

1. Ticket- und JavaScript-Platzhalter — Ersteller, Dokument, Nummerierung und {…}-Ausdrücke
2. Wortersetzungen aus der Verwaltung (Scan-Management → Wortersetzungen)
3. Datums- und Zeitplatzhalter
4. Bereinigung — unzulässige Zeichen für Dateinamen entfernen, Leerzeichen vor der Dateiendung abschneiden

Wortersetzungen greifen also nach den Ticket-Platzhaltern, aber vor den Datumsplatzhaltern.

Groß- und Kleinschreibung ist relevant

%t und %T haben unterschiedliche Bedeutung — ebenso %o/%O, %w/%W und %g/%G. Achten Sie beim Übernehmen von Mustern auf die exakte Schreibweise.

Ersteller

Platzhalter	Beschreibung
%u	Anmeldename des Erstellers
%U	Vollständiger Name (Active Directory)
%F	Erster Teil des vollständigen Namens (Vorname)
%L	Letzter Teil des vollständigen Namens (Nachname)
%e	E-Mail-Adresse des Erstellers

Dokument und Quelle

Platzhalter	Beschreibung
%o	Originaler Dateiname der Quelle
%o!	Originaler Dateiname ohne Dateiendung
%O	Originaler Dateiname inklusive Pfad
%O!	Originaler Dateiname inklusive Pfad, ohne Dateiendung
%r	Relativer Quellordner aus rekursiver Suche (z. B. Hotfolder oder E-Mail-Import)
%b	Kodierter Inhalt des erkannten Barcodes
%p	Seitenanzahl des Dokuments

Datum und Zeit

Alle Werte beziehen sich auf den Zeitpunkt der Ausgabe — mit Ausnahme von %T, das die Erstellungszeit des Scans laut Ticket einsetzt.

Platzhalter	Beschreibung
%d	Datum als TT.MM.JJJJ
%t	Uhrzeit als HH.mm
%T	Erstellungszeit des Scans als HH.mm (aus dem Ticket, nicht die Ausgabezeit)
%DD	Tag, zweistellig
%MM	Monat, zweistellig
%YY	Jahr, zweistellig
%YYYY	Jahr, vierstellig
%hh	Stunde
%mm	Minute
%ss	Sekunde
%ff / %fff / %ffff	Sekundenbruchteile mit 2, 3 oder 4 Stellen
%w	Wochentag auf Englisch
%W	Wochentag auf Deutsch
%X	Unix-Zeitstempel in Sekunden
$date	Datum als JJJJMMTT
$time	Uhrzeit als HHmmss

Nummerierung und eindeutige Werte

Platzhalter	Beschreibung
%g	Fortlaufende fünfstellige Nummer ab 00000; das System sucht die erste freie Nummer am Zielort
%3g	Wie %g, dreistellig
%G	Wie %g, ohne führende Nullen
%q	Zufällige fünfstellige Zeichenfolge
%S	Fortlaufende Seriennummer des Tickets, siebenstellig
%0S bis %7S	Seriennummer mit 0 (ohne Auffüllung) bis 7 Stellen — %4S ergibt also eine vierstellige Nummer

JavaScript-Ausdrücke

Syntax	Beschreibung
{ausdruck}	Wird in einer JavaScript-Umgebung mit den Metadaten des Scans ausgewertet (z. B. Formularfelder, Workflow-Variablen); das Ergebnis wird eingesetzt. {$…}-Metadaten-Platzhalter und die Sonderform {$all} werden dabei übersprungen.

In Flow-Workflows setzt {variablenname} den Wert einer Variablen ein, die zuvor in der Erkennung befüllt wurde.

Speicherpfad des Zielorts

Platzhalter	Beschreibung
%u	Im Basispfad eines Speicherorts (lokales Dateisystem, Netzwerkfreigabe) wird %u durch den Anmeldenamen des Erstellers ersetzt — etwa für Home-Verzeichnisse

Beispiele

Muster	Ergebnis
Scan %w %t	Scan Wednesday 14.05.pdf
%u_%YYYY-%MM-%DD_%g	mmuster_2026-09-03_00000.pdf (beim nächsten Scan 00001)
%o!_%T	Rechnung_14.05.pdf (bei Quelle Rechnung.pdf)
Beleg %b	Beleg 4711.pdf (Barcodeinhalt 4711)

Einschränkungen

• %g braucht eine Existenzprüfung per Dateiname. Der Platzhalter funktioniert nur bei Speicherorten, die das erlauben. Bei DocuWare ist jeder Upload ein neues Dokument — dort greift die Nummerierung nicht.
• %SD, %ST, %SA und die %D00-Formen gelten nicht für Dateinamen. Sie sind ausschließlich für Tastaturtexte in der Geräteoberfläche vorgesehen.
• Der Hilfetext im Ausgabeeditor ist unvollständig. Dort dokumentiert sind %d %t %T %DD %MM %YY %YYYY %hh %mm %ss %w %W %u %e %o %o! %r %b %g %q. Ebenfalls funktionsfähig, aber dort nicht aufgeführt: %U %F %L %O %O! %p %X %ff/%fff/%ffff %3g %G, die %S-Varianten sowie $date und $time.