Direkt zum Hauptinhalt

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:

  1. Er prüft den Dateinamen gegen das eingestellte Muster und ermittelt die Artikelnummer.
  2. 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.
  3. Er prüft, dass die Datei nicht leer ist und der Inhalt zur Endung passt (JPG, PNG, TIF, PDF).
  4. Er importiert das Bild wie beim Kommandozeilenlauf.
  5. Er verschiebt die Datei nach Erfolgreich (Bild angelegt, überschrieben oder schon vorhanden) oder nach Fehler (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).