Direkt zum Hauptinhalt

Übersicht

Was ist MesoWorkerService?

MesoWorkerService ist ein Automatisierungsdienst für Mesonic WinLine, der Hintergrundaufgaben selbstständig ausführt. Der Dienst basiert auf .NET 910 und kann sowohl als Windows-Dienst als auch als Container betrieben werden.

Module im Überblick

MesoWorkerService ist modular aufgebaut. Jedes Modul wird separat lizenziert und kann unabhängig aktiviert werden:

Modul Lizenz Beschreibung Highlights Mail-Dienst MESO-WSMAIL Automatischer E-Mail-Versand aus CRM-Workflows Hierarchische Empfängerregeln, SMTP & M365 OAuth, Mail-Vorlagen mit Platzhaltern, Anhänge aus Belegen/Archiv Belegzeilen-Workflows MESO-WSBELEG Automatische CRM-Fall-Erzeugung aus Bestelldateizeilen Flexible Filterkriterien, Duplikatserkennung, Template-basierte Beschreibungen, Anhänge aus Belegen Terminsynchronisation MESO-WSGRAPH Kalender-Termine aus CRM-Einträgen über MS Graph API Exchange/Outlook-Integration, Rücksynchronisation, Änderungserkennung, automatische Terminlöschung Offene Posten MESO-WSOP Automatischer Versand von OP-Übersichten und Mahnungen Konfigurierbare Selektionskriterien, HTML-Vorlagen, Archiv-Anhänge, aktuelles OP-Blatt aus der FIBU als PDF, Journal Überwachung (in MESO-WSMAIL) Warnung bei fehlenden E-Mail-Versendungen Grace Period, Duplikatsschutz, konfigurierbare Zeiträume

Detaillierte Beschreibungen der einzelnen Module finden Sie im Abschnitt Hauptkomponenten.

Hauptfunktionen

Der MesoWorkerService bietet vierfünf Hauptfunktionen:

1. Automatischer E-Mail-Versand

  • Versendet E-Mails automatisch basierend auf Workflow-Ereignissen in WinLine
  • Unterstützt hierarchische Empfängerregeln mit flexiblen Prioritäten
  • Ermöglicht die Verwendung mehrerer SMTP-Konten inkl. Microsoft 365 mit OAuth
  • Fügt automatisch Anhänge aus Workflows und Belegen hinzu
  • Protokolliert alle versendeten E-Mails im Mail-Journal

2. Workflow-Erzeugung aus Bestelldateizeilen

  • Erstellt automatisch CRM-Fälle aus Bestelldateizeilen (z.B. für Serviceaufträge)
  • Filtert relevante Zeilen nach konfigurierbaren Kriterien
  • Verhindert Mehrfachverarbeitung durch intelligente Protokollierung
  • Ermöglicht flexible Datumsfelder und Template-basierte Beschreibungen

3. Terminsynchronisation

  • Erstellt automatisch Kalender-Termine aus CRM-Einträgen über MS Graph API
  • Synchronisiert Termine direkt in Microsoft Exchange/Outlook-Kalender
  • Flexible Empfänger-Ermittlung über verschiedene CRM-Quellen
  • Optionale Rücksynchronisation von Terminänderungen zurück in CRM
  • Unterstützt dynamische Inhalte und Anhänge aus CRM-Einträgen

4. Offene Posten (OP-Versand)

    Versendet automatisch Offene-Posten-Übersichten und Mahnungen an Kunden Flexible Selektion nach Kontoart, Fälligkeit, Mahnstufe und individuellen Filtern HTML-Vorlagen mit Platzhaltern für Kunden- und OP-Daten Optionale Anhänge: Originalrechnungen aus dem Archiv und OP-Blatt aus der FIBU als PDF Journal-Protokollierung mit Sendeintervall zur Vermeidung von Mehrfachversand

    5. Überwachung und Warnung

    • Überwacht Workflows mit aktiven E-Mail-Regeln
    • Benachrichtigt Administratoren bei fehlenden E-Mail-Versendungen
    • Hilft bei der frühzeitigen Erkennung von Konfigurationsfehlern oder fehlenden Stammdaten

    Systemarchitektur

    ┌──────────────────────────────────────────────────────────────────────────┐
    │                          MesoWorkerService                               │
    │                    (.NET 910 Hintergrunddienst)                           │
    └──────────────────────────────────────────────────────────────────────────┘
                                        │
           ┌──────────────┬─────────────┼───────────────┬──────────────              │             │             │              │
           ▼              ▼             ▼             ▼              ┌────────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌─────────────┐
    ┌──────────────┐  ┌────────────────┐
        │ Mail-Dienst  │Dienst│ │ Workflow- │ │  Termin-  │ │  Überwachungs-Offene   │ │ Überwachung │
    │ (WSMAIL)   │ │ Erzeugung │ │  synchroni-synchr.  │ │  dienstPosten   │ │ (WSMAIL)    │
    │            │ │ (WSBELEG) │ │ sation(WSGRAPH) │ │  (WSOP)   │ │             │
    └────────────┘ └───────────┘ └───────────┘ └───────────┘ └─────────────┘
           │              │             │             │              │
           └──────────────┘  └─────────────┼─────────────┴──────────────┘
                                        │
              │               │               │
                └┌─────────────────────────┼──────────────────────────────┘
              │               │                         ▼                          ▼
    ┌───────────────────────────────┐  ┌─────────────────────┐  ┌───────────────────┐
    │ WinLine Datenbanken  │  │  MS Graph API       │  │ MesoArchivWeb     │
    │ • CWLSYSTEM          │  │  (Exchange/Outlook) │  │ (Dokumentenarchiv)│
    │ • Mandanten-DB       │  └─────────────────────┘  └───────────────────┘
    │ • FIBU (T019)        │
    └──────────────────────┘                            ┌─────────────────────┐
              ▼                │ WinLine Server      │
    ┌──────────────────────┐   │ (OP-Blatt)          │
    │ Anwendungsdatenbank  │   └─────────────────────┘
    │ (MesoWorkerDb)       │
    │ • Konfiguration      │
    │ • Mail-Journal       │
    │ • Termin-Journal     │
    │ • OP-Journal         │
    │ • Protokollierung    │
    └───────────────────────────────┘
    

    Administrationsoberflächen:

    • Blazor Web-UI (browserbasiert, Port 5000)
    • Windows Desktop-Client

    Eine detaillierte Architekturübersicht finden Sie in assets/systemarchitektur.md.