Der Job DataService-Listen-Updater importiert den Inhalt einer definierten CSV-Datei in die Datenbank.

Der Import lädt Key/Value-Strukturen in eine Tabelle, auf die anschließend beispielsweise innerhalb der Konfiguration unter
Documents → Verbundene Systeme zugegriffen werden kann.

Typische Einsatzszenarien:

• Pflege von Dropdown-Werten
• Verwaltung von fachlichen Listen
• Aufbau hierarchischer Auswahlstrukturen (z. B. Aktenpläne)

Technische Einordnung

Der Job liest eine CSV-Datei aus einem konfigurierten Verzeichnis ein und überträgt die enthaltenen Datensätze in die Datenbank.

Wichtiges Importverhalten

• Alle Einträge zu einem in der CSV enthaltenen ListName werden vollständig ersetzt.
• Es erfolgt keine Ergänzung, sondern ein vollständiger Neuaufbau.
• Nicht enthaltene ListName-Bereiche bleiben unverändert.

Das Verfahren stellt sicher, dass Listen vollständig konsistent ersetzt werden.

Typspezifische Konfiguration

Datenbank & Format

Feld	Beschreibung
Datenbank	Datenbank, in die importiert wird. Standardmäßig ist die intracon-Datenbank zu verwenden. Die Datenbank muss zuvor unter Communication → Ressourcen konfiguriert sein.
Kultur	Definiert das Format für Währungen, Dezimalzahlen und Datumswerte beim Parsen der CSV-Datei.
Kodierung	Zeichencodierung der CSV-Datei (z. B. UTF-8).
Überschreiben wenn notwendig	Wird nicht mehr genutzt. Der Import ersetzt grundsätzlich alle Einträge je ListName.

---

Dateiverarbeitung

Feld	Beschreibung
Quellverzeichnis	Verzeichnis, aus dem die zu verarbeitenden Dateien gelesen werden. Muss unter Communication → Ressourcen konfiguriert sein.
Suchmuster	Definiert das Dateimuster für zu verarbeitende Dateien.
Ausschlussmuster	Definiert Dateimuster, die nicht verarbeitet werden sollen.
Unterverzeichnisse durchsuchen	Steuert, ob auch Unterordner durchsucht werden.
Nur neue Dateien prüfen	Verarbeitet nur Dateien, deren Dateiname bisher noch nicht verarbeitet wurde.

Dateibehandlung nach Import

Feld	Beschreibung
Löschen nach Import	Löscht die Datei nach erfolgreichem Import.
Schnelles Löschen	Reduziert die Wartezeit vor dem Löschen von 500 ms auf 10 ms.
Exklusiven Dateizugriff sicherstellen	Stellt sicher, dass die Datei während der Verarbeitung exklusiv gesperrt ist.
Done-Verzeichnis	Zielverzeichnis bei erfolgreicher Verarbeitung.
Error-Verzeichnis	Zielverzeichnis bei fehlerhafter Verarbeitung.

Datenaufbau für den Listenimport

Die CSV-Datei muss folgende Struktur besitzen:

Feldname	Feld-Art	Beschreibung
ListName	Alphanumerisch	Fachlicher Gruppenname der Liste. Alle zusammengehörigen Einträge verwenden denselben ListName.
Key	Alphanumerisch	Eindeutiger technischer Schlüssel. Muss innerhalb der Liste eindeutig sein.
ParentKey	Alphanumerisch	Optionaler Verweis auf einen bestehenden Key zur Abbildung hierarchischer Strukturen.
Value	Alphanumerisch	Anzeigewert für den Mitarbeiter (z. B. Dropdown-Text).
OrderBy	Integer	Reihenfolge der Anzeige innerhalb eines ListName.

Grundstruktur der CSV-Datei

ListName;Key;ParentKey;Value;OrderBy

Beispiel 1: Stichworte für die Kontakthistorie

ListName	Key	ParentKey	Value	OrderBy
khstichwort	2		Kundenbarometer positiv	1
khstichwort	3		Kundenbarometer neutral	2
khstichwort	4		Kundenbarometer negativ	3
khstichwort	8		Aufgabe zum Geschäftsfall	4

Alle Einträge verwenden denselben ListName.
Da kein ParentKey gesetzt ist, handelt es sich um eine flache, nicht-hierarchische Liste.

Beispiel 2: Aufgabendefinitionen für die Wiedervorlage

ListName	Key	ParentKey	Value	OrderBy
wvaufgabe	Aufgabendefinition21c1		Aufgabenansicht1 Sachbearbeiter	1
wvaufgabe	Aufgabendefinition21c2		Aufgabenansicht2 Sachbearbeiter	2
wvaufgabe	Aufgabendefinition21c3		Aufgabenansicht3 Sachbearbeiter	3

Auch hier handelt es sich um eine flache Liste mit eindeutigem Key je Eintrag.

Beispiel 3: Hierarchischer Aktenplan (E-Akte)

Variante 1 – Originalstruktur (CSV-konform)

ListName	Key	ParentKey	Value	OrderBy
AktenplanLevel1	Ordnerschlüssel1		Aktenordner	1
AktenplanLevel1	Ordnerschlüssel2		Aktenordner	2
AktenplanLevel2	Prozessschlüssel1	Ordnerschlüssel1	Prozessansicht	1
AktenplanLevel2	Prozessschlüssel2	Ordnerschlüssel1	Prozessansicht	2
AktenplanLevel2	Prozessschlüssel3	Ordnerschlüssel2	Prozessansicht	1
AktenplanLevel2	Prozessschlüssel4	Ordnerschlüssel2	Prozessansicht	2
AktenplanLevel3	Unterprozessschlüssel1	Prozessschlüssel1	Unterprozess	1
AktenplanLevel3	Unterprozessschlüssel2	Prozessschlüssel1	Unterprozess	2

Variante 2 – Erweiterte Darstellung mit Hierarchie-Ebene

Ebene	ListName	Key	ParentKey	Value	OrderBy
1	AktenplanLevel1	Ordnerschlüssel1		Aktenordner	1
1	AktenplanLevel1	Ordnerschlüssel2		Aktenordner	2
2	AktenplanLevel2	Prozessschlüssel1	Ordnerschlüssel1	Prozessansicht	1
2	AktenplanLevel2	Prozessschlüssel2	Ordnerschlüssel1	Prozessansicht	2
2	AktenplanLevel2	Prozessschlüssel3	Ordnerschlüssel2	Prozessansicht	1
2	AktenplanLevel2	Prozessschlüssel4	Ordnerschlüssel2	Prozessansicht	2
3	AktenplanLevel3	Unterprozessschlüssel1	Prozessschlüssel1	Unterprozess	1
3	AktenplanLevel3	Unterprozessschlüssel2	Prozessschlüssel1	Unterprozess	2

Hierarchie-Logik

• Key definiert den Eintrag selbst
• ParentKey verweist auf einen vorhandenen Key der übergeordneten Ebene
• Jede Ebene besitzt einen eigenen ListName