Verzeichnisüberwachung als Dienst
Statt Läufe von Hand zu starten, kann das Programm als Windows-Dienst ein Eingangsverzeichnis überwachen. Jede Bilddatei, die dort abgelegt wird, wird sofort in die Grafiktabelle übernommen und der Artikel umgestellt. Die Artikelnummer liest der Dienst aus dem Dateinamen.
So arbeitet der Dienst je Datei:
- Er prüft den Dateinamen gegen das eingestellte Muster und ermittelt die Artikelnummer.
- Er verschiebt die Datei in den Unterordner
InArbeit. Ist die Datei noch in Benutzung (Kopiervorgang läuft), wartet er kurz und versucht es erneut; klappt es nicht, bleibt die Datei liegen und wird beim nächsten Nachscan wieder aufgegriffen. - Er prüft, dass die Datei nicht leer ist und der Inhalt zur Endung passt (JPG, PNG, TIF, PDF).
- Er importiert das Bild wie beim Kommandozeilenlauf.
- Er verschiebt die Datei nach
Erfolgreich(Bild angelegt, überschrieben oder schon vorhanden) oder nachFehler(Artikel unbekannt, Datei passt nicht zum Muster, Inhalt ungültig, Datenbankfehler). Existiert dort bereits eine Datei gleichen Namens, bekommt die neue einen Zeitstempel.
Die drei Unterordner legt der Dienst selbst an. Eine Datei aus Fehler verarbeiten Sie erneut, indem Sie sie zurück in das Eingangsverzeichnis legen. Nach einem Neustart holt der Dienst liegengebliebene Dateien aus InArbeit zurück in den Eingang.
Konfiguration
Alles steht in appsettings.json im Abschnitt Dienst. Beispiel mit zwei Verzeichnissen:
"Dienst": {
"Protokollordner": "D:\\ArtikelGrafik\\Protokolle",
"NachscanMinuten": 5,
"Ueberwachungen": [
{
"Verzeichnis": "\\\\server\\bilder\\eingang",
"Mandant": "500M",
"Muster": "IMG{Artikelnummer}.jpg",
"Mesoyear": null,
"Ueberschreiben": false,
"Trocken": false
},
{
"Verzeichnis": "D:\\Bilder\\Eingang-PNG",
"Mandant": "500M",
"Muster": "{Artikelnummer}_*.png",
"Mesoyear": 1512,
"Ueberschreiben": true,
"Trocken": false
}
]
}
| Einstellung | Bedeutung |
|---|---|
Protokollordner |
Ordner für die Tagesprotokolle. Leer lassen (null) für den Unterordner Protokolle neben dem Programm |
NachscanMinuten |
Alle so viele Minuten sieht der Dienst zusätzlich in jedes Verzeichnis, um verpasste oder vorher gesperrte Dateien nachzuholen. 0 schaltet ihn ab; Dateien, die beim ersten Versuch noch gesperrt waren, werden dann erst nach einem Neustart des Dienstes erneut versucht. Höchstens 10080 (7 Tage) |
Verzeichnis |
Das Eingangsverzeichnis. Nur Dateien direkt in diesem Ordner werden verarbeitet, keine Unterordner |
Mandant |
4-stelliges Mandantenkürzel |
Muster |
Wie die Artikelnummer im Dateinamen steht, siehe unten |
Mesoyear |
Nur dieses Wirtschaftsjahr (MESOYEAR, siehe Wirtschaftsjahr wählen); null = alle |
Ueberschreiben |
true: vorhandene Bilder ersetzen (wie --force); false: unverändert lassen |
Trocken |
true: nichts schreiben und nichts verschieben, nur protokollieren |
In den Pfaden müssen Backslashes verdoppelt werden (\\), weil die Datei im JSON-Format ist.
Muster für den Dateinamen
Schreiben Sie den Dateinamen so, wie er aussieht, und setzen Sie {Artikelnummer} an die Stelle der Artikelnummer. Groß- und Kleinschreibung spielt keine Rolle.
| Muster | Passt auf | Artikelnummer |
|---|---|---|
IMG{Artikelnummer}.jpg |
IMG10002.jpg, img10002.JPG |
10002 |
{Artikelnummer}.jpg |
A-100.jpg |
A-100 |
{Artikelnummer}_*.png |
10002_front.png, 10002_v2_gross.png |
10002 |
{Artikelnummer}-?.jpg |
10002-a.jpg (genau ein Zeichen nach dem Strich) |
10002 |
* steht für beliebig viele Zeichen, ? für genau ein Zeichen; alles andere muss genau so im Dateinamen stehen. Dateien, die nicht passen (z.B. Thumbs.db oder ein Foto ohne Artikelnummer), wandern nach Fehler.
Für Sonderfälle können Sie einen regulären Ausdruck angeben, der die Gruppe Artikelnummer enthält, z.B. nur Ziffern: ^IMG(?<Artikelnummer>\d+)\.jpg$. Ein Muster gilt als regulärer Ausdruck, sobald es (?<Artikelnummer> enthält. Achten Sie dann selbst auf ^ und $ am Anfang und Ende.
Ausprobieren und Probelauf
Starten Sie den Dienst zunächst in einer Eingabeaufforderung:
ArtikelGrafikImporter --dienst
Sie sehen dieselben Meldungen wie später im Protokoll. Legen Sie eine Bilddatei in das Eingangsverzeichnis und beobachten Sie die Ergebniszeile. Mit "Trocken": true in der Konfiguration wird nichts geschrieben und nichts verschoben; so prüfen Sie Muster und Artikelnummern gefahrlos. Strg+C beendet. Fehler in der Konfiguration (Verzeichnis fehlt, Mandant falsch, Muster ohne {Artikelnummer}) werden beim Start aufgelistet, der Dienst startet dann nicht.
Als Windows-Dienst einrichten
In einer Eingabeaufforderung als Administrator (Pfad anpassen):
sc.exe create ArtikelGrafikImporter binPath= "C:\Tools\ArtikelGrafikImporter\ArtikelGrafikImporter.exe --dienst" start= auto DisplayName= "MESO ArtikelGrafik-Importer"
sc.exe failure ArtikelGrafikImporter reset= 86400 actions= restart/60000/restart/60000/restart/60000
sc.exe start ArtikelGrafikImporter
Läuft der Dienst unter einem Domänenkonto, legen Sie die Ereignisquelle einmalig als Administrator an (sonst können Startfehler nicht ins Windows-Ereignisprotokoll geschrieben werden):
New-EventLog -LogName Application -Source ArtikelGrafikImporter
Die zweite Zeile sorgt dafür, dass der Dienst nach einem Fehler (z.B. SQL Server beim Hochfahren noch nicht erreichbar) nach einer Minute automatisch neu startet. Beenden und entfernen: sc.exe stop ArtikelGrafikImporter, dann sc.exe delete ArtikelGrafikImporter.
Das Konto, unter dem der Dienst läuft (in der Diensteverwaltung unter Anmelden), braucht Lese- und Schreibrecht auf jedes Eingangsverzeichnis, Schreibrecht auf den Protokollordner, Zugriff auf den SQL Server und Internetzugang zum Lizenzserver. Bei UNC-Pfaden ist das lokale Systemkonto meist ungeeignet; verwenden Sie ein Domänenkonto.
Nach jeder Änderung an appsettings.json den Dienst neu starten.
Protokoll des Dienstes
Der Dienst schreibt je Kalendertag eine Datei artikelgrafik-dienst-JJJJMMTT.log in den Protokollordner. Am Anfang steht ein Kopf mit Version, Verbindung (ohne Passwort), Lizenz und allen Überwachungen; danach je Datei eine Ergebniszeile im bekannten Format, dazu Meldungen zu Start, Nachscan (nur wenn er etwas gefunden hat), Überwachungsfehlern und Stopp. Startet der Dienst nicht, steht die Ursache dort und im Windows-Ereignisprotokoll (Anwendung, Quelle ArtikelGrafikImporter).
Keine Kommentare vorhanden
Keine Kommentare vorhanden