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 10 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 fü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 10 Hintergrunddienst)                           │
└──────────────────────────────────────────────────────────────────────────┘
                                    │
       ┌──────────────┬─────────────┼─────────────┬──────────────┐
       │              │             │             │              │
       ▼              ▼             ▼             ▼              ▼
┌────────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌─────────────┐
│ Mail-Dienst│ │ Workflow- │ │  Termin-  │ │  Offene   │ │ Überwachung │
│ (WSMAIL)   │ │ Erzeugung │ │  synchr.  │ │  Posten   │ │ (WSMAIL)    │
│            │ │ (WSBELEG) │ │ (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.

nach oben