Zweck

Der DocumentBatch.Watcher steuert die Serienbrieferstellung.

Typischerweise wird dieser Filewatcher-Typ durch das Ablegen einer CSV-Datei im konfigurierten Quellverzeichnis ausgelöst.
Die enthaltenen Datensätze werden in Batches überführt und zur weiteren Verarbeitung bereitgestellt.

Konfiguration

Die Konfiguration gliedert sich in:

• Basisinformationen (für alle Filewatcher identisch)
• Typspezifische Informationen

Typspezifische Konfiguration

  **Hinweis:**  
  Mehrere Felder unterstützen die dynamische Übergabe eines Wertes  
  aus der zu verarbeitenden Datei. Die Syntax lautet: `use:Spaltenname`  
  Dabei ist `use:` eine feste Konstante und *Spaltenname* muss  
  exakt der CSV-Spaltenbezeichnung entsprechen.

Feld	Beschreibung
Batchname	Name des Batches in der Batchübersicht. Optional dynamisch über use:Spaltenname. Unterschiedliche Werte erzeugen getrennte Batches.
Encoding	Encoding der gelieferten Datei (z. B. UTF-8).
Trennzeichen	Trennzeichen der CSV-Datei.
Anführungszeichen entfernen	Entfernt optional Hochkommata um einzelne Felder.
Done-Verzeichnis	Zielverzeichnis für erfolgreich verarbeitete Dateien. Nur logische Verzeichnisse aus Communication → Ressourcen → Verzeichnisse auswählbar.
Error-Verzeichnis	Zielverzeichnis für fehlerhaft verarbeitete Dateien.
ContextUser	Zuständiger Sachbearbeiter. Optional dynamisch über use:Spaltenname. Benutzer muss unter Organisation konfiguriert sein.
CreatorUser	Absender und Eigentümer des Batches. Optional dynamisch über use:Spaltenname.
Paketgröße	Teilt die Datei in mehrere Verarbeitungspakete (Datensatzanzahl pro Batch).
Schutzstufe	Schutzstufe des Batches: 5 - Geschützt, 6 - Besonders Geschützt, 7 - VIP. Optional dynamisch über use:Spaltenname.
EntityType	Personentyp (z. B. Versicherter, Arbeitgeber). Optional dynamisch.
EntityIdentifier Column	Verweist auf die Spalte mit dem Ordnungsbegriff.
ExterneId	Externer Datensatzzähler über use:Spaltenname.
Identifier Type	Typ des Ordnungsbegriffs (z. B. PartnerId, Kvnr, Agnr, Iknr, 21c-Oid).
Templatename	Name des zu verwendenden Templates. Optional dynamisch. Unterschiedliche Werte erzeugen getrennte Batches.
Generator GruppenId	Namensgenerator zur Vergabe einer eindeutigen Auftragsgruppen-ID (Communication → Namensgenerator).
Erfolgreich verarbeitete Dateien nach dem Import löschen	Löscht Dateien nach erfolgreichem Import. Obsolet bei Nutzung von Done-/Error-Verzeichnis.
Dateien nicht speichern	Legt fest, ob die Ursprungsdatei gespeichert wird.

Ablauf

1. Datei wird im Quellverzeichnis erkannt
2. Datei wird gemäß Encoding und Trennzeichen eingelesen
3. Datensätze werden validiert
4. Gruppierung zu einem oder mehreren Batches
5. Übergabe an Template-Verarbeitung
6. Verschiebung in Done- oder Error-Verzeichnis

Besonderheiten

• Unterschiedliche Batchnamen oder Templatenamen führen zu getrennten Batches
• Schutzstufe beeinflusst Zugriffsrechte innerhalb von intracon:bk
• Dynamische Werte über use:Spaltenname ermöglichen flexible Steuerung

Empfehlungen

Empfehlung:
Done- und Error-Verzeichnis konfigurieren.

Empfehlung:
Identifier-Mapping im Datacenter nutzen, statt EntityType, Identifier Type und EntityIdentifier Column manuell zu pflegen.

Empfehlung:
Encoding korrekt konfigurieren, um Zeichenprobleme zu vermeiden.

Typische Fehlerquellen

• Falsches Encoding
• Falsches Trennzeichen
• Nicht existierendes Template
• Benutzer nicht korrekt konfiguriert
• CSV-Spaltenname stimmt nicht exakt mit use:Spaltenname überein