Konfiguration
Die Konfiguration erfolgt über die Datei appsettings.json. Änderungen an der Konfiguration werden zur Laufzeit automatisch übernommen (Hot-Reload via IOptionsMonitor).
Beim Start werden die Pflichtparameter validiert. Fehlende oder ungültige Werte führen zu einem sofortigen Abbruch mit Fehlermeldung.
{
"License": {
"LicenseNr": "",
"CustomerNr": ""
},
"Company": "500M",
"ConnectionString": "XpoProvider=MSSqlServer;data source=WS01;integrated security=SSPI;initial catalog=CWLSYSTEM;TrustServerCertificate=True;",
"ImportPath": "C:\\Archivimport",
"FileFilter": "*.pdf",
"Belege": {
"Folder": "Belege",
"Regex": "^(?<nummer>[^-]+-[^.]+)\\.[^.]+$",
"KeywordMapping": "1=Kontonummer,43=Auftragsnummer,49=DatumLieferschein:dd-MM-yyyy",
"FileFilter": "*.pdf;*.tif"
},
"Artikel": {
"Folder": "Artikel",
"Regex": "^Artikel_(?<nummer>.+)\\.[^.]+$",
"KeywordMapping": "41=Artikelnummer"
},
"Personenkonten": {
"Folder": "Personenkonten",
"Regex": "^Konto_(?<nummer>.+)\\.[^.]+$",
"KeywordMapping": "1=Kontonummer"
},
"MandantenVerzeichnisse": false,
"EnableBelegKeyFallback": true,
"Watch": true,
"SuccessFolder": "Erfolgreich",
"ErrorFolder": "Fehler",
"Split": {
"Enabled": false,
"SplitPath": "C:\\Archivimport-Split",
"Strategie": "Barcode",
"Barcode": {
"Symbologien": ["CODE_39"],
"IdentifierRegex": "",
"Vorverarbeitung": {
"Aktiv": true,
"WeichzeichnerSigma": 2.0,
"Schwellwert": 150
},
"RenderDpi": 300
},
"Ocr": {
"Regex": "Lieferschein\\s*Nr\\.?\\s*(?<nummer>[0-9]+-[0-9]+)",
"Sprache": "german",
"RenderDpi": 300
}
}
}
Lizenz
| Parameter | Beschreibung |
|---|---|
License:LicenseNr |
Lizenznummer |
License:CustomerNr |
Kundennummer |
Die Lizenzprüfung erfolgt beim Start gegen https://license.css-edv-support.de (Produkt: MESO-ARCHIVEIMP). Ohne gültige Lizenz startet der Service im Demomodus (siehe unten).
In Container-Umgebungen können die Werte alternativ über Umgebungsvariablen gesetzt werden:
LICENSE_LICENSE_NRLICENSE_CUSTOMER_NR
Demomodus
Wenn keine gültige Lizenz vorhanden ist (fehlende Konfiguration, ungültige Daten oder Server nicht erreichbar), startet der Service automatisch im Demomodus. In diesem Modus:
- Dateien werden erkannt, Identifier extrahiert und Objekte zugeordnet
- Schlagworte werden ermittelt (aus Mapping und Schlagwortdateien)
- Die Ergebnisse werden als
[DEMO]-Warnung geloggt - Die Archivierung wird übersprungen - es werden keine Dokumente im MESONIC-Archiv abgelegt
- Dateien werden nicht in Erfolgs-/Fehlerverzeichnisse verschoben
Pflichtparameter
| Parameter | Beschreibung | Beispiel |
|---|---|---|
Company |
MESONIC-Mandantennummer (entfällt bei MandantenVerzeichnisse: true) |
"500M" |
ConnectionString |
XPO-ConnectionString zur MESONIC-Systemdatenbank | "XpoProvider=MSSqlServer;data source=WS01;..." |
ImportPath |
Pfad zum Importverzeichnis | "C:\\Archivimport" |
Optionale Parameter
| Parameter | Standard | Beschreibung |
|---|---|---|
FileFilter |
"*.pdf" |
Erlaubte Dateitypen als Wildcard-Muster. Mehrere Muster werden mit Semikolon getrennt (siehe FileFilter der Belege-Sektion in der Beispielkonfiguration oben) |
MandantenVerzeichnisse |
false |
Erste Verzeichnisebene als Mandantennummer interpretieren (siehe Mandantenverzeichnisse). Company wird dann aus den Verzeichnisnamen ermittelt |
Watch |
false |
Dauerüberwachung des Importverzeichnisses aktivieren |
EnableBelegKeyFallback |
false |
Bei Belegkey-Format auch über LadeBeleg suchen, wenn die direkte Suche fehlschlägt |
SuccessFolder |
"Erfolgreich" |
Name des Unterverzeichnisses für erfolgreich importierte Dateien |
ErrorFolder |
"Fehler" |
Name des Unterverzeichnisses für fehlgeschlagene Importe |
WorkFolder |
"InArbeit" |
Name des Arbeitsverzeichnisses, in das Dateien vor der Verarbeitung verschoben werden (verhindert Doppelverarbeitung bei Dateisperren) |
TestSentry |
false |
Löst eine Test-Exception aus, um die Sentry-Integration zu prüfen |
SuccessFolder, ErrorFolder und WorkFolder müssen gesetzt, frei von Pfadtrennzeichen und paarweise
verschieden sein; der Dienst prüft das beim Start und verweigert sonst den Start.
Split-Konfiguration (PDF-Zerlegung)
Alle Parameter unterhalb von Split:. Wird nur ausgewertet, wenn Split:Enabled auf true gesetzt ist.
| Parameter | Standard | Beschreibung |
|---|---|---|
Split:Enabled |
false |
Aktiviert die PDF-Split-Vorschaltstufe |
Split:SplitPath |
— | Pflicht wenn aktiviert. Wurzelverzeichnis der Sammel-PDFs. Muss existieren und sich von ImportPath unterscheiden |
Split:Zielpfad |
— | Optional. Wurzel für die Einzel-PDFs; leer = ImportPath (Einzeldokumente werden importiert). Gesetzt werden sie nur zerlegt und dort abgelegt, z.B. für einen Eingangsordner des MESO WebArchiv (siehe Nur zerlegen, nicht importieren). Muss existieren, darf weder gleich SplitPath sein noch darin liegen und umgekehrt |
Split:Strategie |
"Barcode" |
Trennstrategie: Barcode, Ocr oder BarcodeMitTextRueckfall (siehe Trennstrategien) |
Split:Segmentierung |
"JederTreffer" |
Wann ein Identifier ein neues Dokument beginnt: JederTreffer (jede Seite mit Identifier) oder Wechsel (nur bei abweichendem Identifier). BarcodeMitTextRueckfall erfordert Wechsel; der Dienst verweigert sonst den Start (siehe Segmentierung) |
Split:Barcode:Symbologien |
[] (Standardauswahl) |
ZXing-Barcode-Format-Namen, z.B. ["CODE_39"]. Leer = Standardauswahl der Bibliothek ohne prüfsummenfreie 1D-Formate (siehe Barcode-Erkennung); der Dienst warnt dann beim Start |
Split:Barcode:IdentifierRegex |
— | Optionales Muster für gültige Identifier; Barcodes ohne Treffer werden verworfen |
Split:Barcode:Vorverarbeitung:Aktiv |
true |
Zweite Erkennungsstufe auf dem vorverarbeiteten Bild |
Split:Barcode:Vorverarbeitung:WeichzeichnerSigma |
2.0 |
Sigma des Gauß-Weichzeichners in Pixeln (> 0) |
Split:Barcode:Vorverarbeitung:Schwellwert |
150 |
Graustufe 0..255, unterhalb derer ein Pixel schwarz wird |
Split:Barcode:RenderDpi |
300 |
Render-Auflösung für die Barcode-Erkennung (mindestens 72; 400 für schwierige Scans). Bei BarcodeMitTextRueckfall gilt sie auch für den Text-Rückfall (die Seite wird nur einmal gerendert) |
Split:Ocr:Regex |
— | Pflicht bei Strategie Ocr und BarcodeMitTextRueckfall. Regex zum Erkennen des Dokumentstarts; Identifier aus benannter Gruppe (nummer, belegkey, belegnummer) oder Gruppe 1 |
Split:Ocr:Startmerkmal |
— | Optionale Regex. Ein Texttreffer zählt nur als Dokumentstart, wenn die Seite zusätzlich dieses Muster enthält (ein von der Lesereihenfolge unabhängiges Muster steht im POD-Beispiel unter Segmentierung); sonst gilt die Seite als Folgeseite. Der Dienst prüft die Regex beim Start |
Split:Ocr:Sprache |
"german" |
PaddleOCR-Modellsprache ("german" → LatinV5, "english" → EnglishV5) |
Split:Ocr:Rotationserkennung |
false |
Schaltet die Rotationserkennung der OCR ein. Standardmäßig aus, weil sie waagerechten Text echter Scans in Zeichensalat zerlegte; nur für senkrechten Text einschalten. Wird wie Sprache beim ersten OCR-Aufruf gelesen; Änderungen danach wirken erst nach Neustart |
Split:Ocr:RenderDpi |
300 |
Render-Auflösung für OCR (mindestens 72); gilt nur für Strategie Ocr; bei BarcodeMitTextRueckfall gilt Split:Barcode:RenderDpi |
Objekttyp-Konfiguration (Belege, Artikel, Personenkonten)
Jeder Objekttyp wird als eigene Sektion konfiguriert:
| Parameter | Beschreibung |
|---|---|
Folder |
Name des Erkennungsverzeichnisses (Unterverzeichnis von ImportPath), das diesem Objekttyp zugeordnet ist. Dieses Verzeichnis enthält Formular-Unterverzeichnisse |
Regex |
RegEx-Muster zur Extraktion der Objektnummer aus dem Dateinamen. Wenn leer, wird der Dateiname ohne Erweiterung als Nummer verwendet. Unterstützte benannte Gruppen: nummer, belegkey, belegnummer |
KeywordMapping |
Zuordnung von Schlagwortnummern zu Properties der MesoXPO-Klasse. Format: SchlagwortNr=PropertyName, kommagetrennt. Optional mit Datumsformat: 49=DatumLieferschein:dd-MM-yyyy |
FileFilter |
Optional: Überschreibt den globalen FileFilter für diesen Objekttyp, z.B. um zusätzlich TIFF-Dateien zu akzeptieren. Gleiche Syntax wie der globale FileFilter |
Keine Kommentare vorhanden
Keine Kommentare vorhanden