MAPI

Übersicht

Die Aktion MAPI übergibt eine Mail an ein Mailprogramm, das auf diesem PC installiert ist. Die Mail geht über das Konto, das dort eingerichtet ist, und landet in dessen Gesendet-Ordner. Sie können sie vor dem Senden anzeigen lassen, direkt senden oder als Entwurf speichern.

Client	Bedeutung
Default	das Standard-Mailprogramm von Windows (Standard)
Outlook	das klassische Outlook, mit allen Optionen dieser Seite
ein Name	ein bestimmtes Mailprogramm, z. B. Thunderbird, eM Client oder Team (Tobit David), so wie es in Windows registriert ist – 64- oder 32-Bit

Im Diagramm des Workflow-Editors hat die Aktion ein Formular. Senden mit listet die Mailprogramme, die auf diesem PC installiert sind, mit 32- oder 64-Bit; nach einer Neuinstallation sucht die Schaltfläche daneben erneut. Unter Anderes geben Sie einen Namen oder einen Platzhalter wie {{InitialData.Mailprogramm}} ein. Was passiert setzt Mode: Zum Prüfen öffnen, Direkt senden oder Als Entwurf speichern (nur Outlook). Im Abschnitt Mail steht die Signatur direkt unter dem Text. Alles Weitere steht unter Weitere Optionen; Parameter, die das Formular nicht kennt, bleiben unter Weitere Parameter als JSON erhalten.

Mode	Wirkung
Display	Die Mail öffnet sich im Mailprogramm. Sie prüfen sie und senden selbst. (Standard)
Send	Die Mail wird gesendet, ohne ein Fenster zu öffnen. Braucht mindestens einen Empfänger. Siehe Was „gesendet“ bedeutet.
Draft	Die Mail wird im Ordner Entwürfe gespeichert. Nur mit Client: Outlook.

Das neue Outlook

Das neue Outlook für Windows lässt sich von keinem Programm steuern. Senden Sie dann über Microsoft 365.

Über Default oder den Namen eines anderen Programms nutzt RUNOS die Windows-Schnittstelle „Simple MAPI“. Sie kennt nur reinen Text und weniger Optionen: RUNOS wandelt HTML in Text um und lässt ReplyTo, Importance, DeliveryReceipt, OutlookSignature und From weg; jede ausgelassene Option steht als Warnung im Ergebnis (bei OutlookSignature nur der Wert Always). Im Formular sind diese Optionen mit Nur Outlook markiert.

Sie haben …	Nehmen Sie
Zugangsdaten zu einem SMTP-Server	SMTP
das klassische Outlook und möchten Mails vor dem Versand prüfen	MAPI mit Client: Outlook und Mode: Display
Thunderbird, eM Client, Tobit David oder ein anderes Mailprogramm	MAPI mit Client: Default oder dem Namen des Programms
Microsoft 365 / das neue Outlook, oder kein Mailprogramm	Microsoft 365

32-Bit-Mailprogramme

RUNOS ist ein 64-Bit-Programm. Manche Mailprogramme, z. B. Tobit David (Team), gibt es nur als 32-Bit-Programm; ihre MAPI-Schnittstelle lässt sich nicht direkt in RUNOS laden. Für sie startet RUNOS einen kleinen 32-Bit-Mailhelfer, der die Mail an das Programm übergibt und dessen Antwort zurückmeldet. Sie müssen dafür nichts einstellen: RUNOS erkennt beim Senden, ob ein Programm 32- oder 64-Bit ist. Das gilt auch für Default, wenn das Standard-Mailprogramm ein 32-Bit-Programm ist.

Der Helfer ist Teil von RUNOS und wird beim ersten Gebrauch nach %LOCALAPPDATA%\RUNOS\MapiHost32\ entpackt. Vor jedem Gebrauch vergleicht RUNOS die Datei mit seiner eigenen Kopie; eine veränderte Datei wird ersetzt, nie gestartet. Blockiert eine Sicherheitssoftware oder eine AppLocker-Richtlinie Programme in diesem Ordner, meldet die Aktion das; geben Sie RUNOS.MapiHost32.exe dort frei. Mailprogramme, die nur als ARM64-Programm installiert sind, kann RUNOS nicht nutzen.

Signatur

Eine Mail bekommt höchstens eine Signatur: die aus dem Feld Signatur oder die Outlook-Signatur des sendenden Kontos, nie beide. Der Text aus Body steht immer oben, die Signatur darunter.

Beim klassischen Outlook entscheidet OutlookSignature (im Formular Outlook-Signatur unter Weitere Optionen):

OutlookSignature	Signatur leer	Signatur ausgefüllt
Auto (Standard)	Text, darunter die Outlook-Signatur	Text, darunter nur Signatur; die Outlook-Signatur entfällt
Always	Text, darunter die Outlook-Signatur	Text, darunter die Outlook-Signatur; Signatur entfällt, mit Warnung
Never	nur der Text	Text, darunter Signatur

Hat das Konto in Outlook keine Standardsignatur für neue Nachrichten, bleibt es beim Text. Mit der Outlook-Signatur wird die Mail als HTML erstellt, außer BodyFormat ist Text.

Bei allen anderen Mailprogrammen (Default, Thunderbird, eM Client, Tobit David …) fügt RUNOS nur Signatur unter den Text. Ob das Programm zusätzlich eine eigene Signatur einsetzt, legt das Programm fest; RUNOS kann sie weder lesen noch entfernen. Wenn Sie Signatur nutzen, schalten Sie die Signatur im Mailprogramm ab, damit keine doppelte entsteht.

Workflows aus früheren Versionen laufen weiter: true gilt als Always, false als Never. Fehlt der Parameter, gilt Auto. Bisher brachte eine fehlende Angabe keine Outlook-Signatur; prüfen Sie solche Workflows, wenn die Mail ohne Signatur bleiben soll, und setzen Sie dann Never.

Was „gesendet“ bedeutet

RUNOS meldet Sent nur, wenn das Mailprogramm bestätigt, dass es die Mail übernommen hat. Was danach passiert, entscheidet das Mailprogramm: Es sendet sofort oder legt die Mail in seinen Postausgang, bis es online ist. Lehnt es die Mail ab oder meldet einen Fehler, schlägt die Aktion fehl und die Mail gilt nicht als gesendet.

• Klassisches Outlook: Lief Outlook vorher nicht, wartet RUNOS bis zu Timeout Sekunden, bis der Postausgang leer ist; ist die Mail dann noch dort, steht das als Warnung im Ergebnis.
• Andere Mailprogramme: Manche zeigen trotz Send ein Fenster oder fragen nach, bevor sie senden. Schließen Sie es ohne zu senden, ist der Status Cancelled. Ob ein Programm ohne Rückfrage sendet, legt das Programm fest, nicht RUNOS; probieren Sie es einmal mit einer Testmail aus.

Struktur

{
  "Type": "MAPI",
  "Name": "MailErstellen",
  "Parameters": {
    "Client": "Outlook",
    "Mode": "Display",
    "To": "{{InitialData.Empfaenger}}",
    "Subject": "Ihre Unterlagen vom %DATE%",
    "Body": "Guten Tag,\n\nanbei die gewünschten Unterlagen.",
    "Attachments": "C:\\RUNOS\\Out\\*.pdf",
    "MissingAttachments": "Error"
  }
}

Parameter	Standard	Bedeutung
Client	Default	Default, Outlook oder der Name eines Mailprogramms, siehe oben
Mode	Display	Display, Send oder Draft, siehe oben. Ein anderer Wert lässt die Aktion fehlschlagen.
Profile	–	Outlook-Profil (nur Outlook)
From	–	Nur Outlook: Konto oder freigegebenes Postfach, von dem gesendet wird
To, Cc, Bcc	–	Empfänger, getrennt durch ; oder ,. Name <a@b.de>, eine Liste oder der Pfad einer Datei mit Adressen.
ReplyTo	–	Antwortadresse (nur Outlook)
Subject	–	Betreff
Body	–	Text oder Pfad einer Text- bzw. HTML-Datei
Signatur	–	Text oder Pfad einer Text- bzw. HTML-Datei, steht unter dem Text. Ersetzt bei OutlookSignature: Auto die Outlook-Signatur, siehe Signatur.
BodyFormat	Auto	Auto, Html oder Text. Auto nimmt HTML, wenn Text oder Signatur HTML-Tags enthalten.
OutlookSignature	Auto	Auto, Always oder Never: wann die Outlook-Signatur des sendenden Kontos unter den Text kommt (nur Outlook), siehe Signatur
Attachments	–	Ein Pfad, mehrere getrennt durch ; oder Zeilenumbrüche, eine Liste oder ein Muster wie C:\Out\*.pdf
MissingAttachments	Error	Error: Fehlt ein Anhang, schlägt die Aktion fehl. Skip: ohne ihn senden, mit Warnung.
Importance	Normal	Low, Normal, High (nur Outlook)
ReadReceipt	false	Lesebestätigung anfordern
DeliveryReceipt	false	Übermittlungsbestätigung anfordern (nur Outlook)
Timeout	60	Sekunden, die RUNOS wartet, bis Outlook gesendet hat, falls Outlook vorher nicht lief

Alle Werte dürfen Platzhalter enthalten, auch Ja/Nein-Werte ("true", "ja", "1"). Die früheren Parameter DisplayBeforeSend, HighImportance und IsHtml funktionieren weiter.

Ergebnis

"Response": {
  "Results": [
    {
      "Client": "Team",
      "Program": "Team",
      "Mode": "Send",
      "Status": "Sent",
      "To": "kunde@example.com",
      "Cc": "", "Bcc": "",
      "Subject": "Ihre Unterlagen vom 2026-10-08",
      "Attachments": [ "C:\\RUNOS\\Out\\angebot.pdf" ],
      "Message": "Team confirmed the mail and sends it (it may wait in its outbox until it is online)."
    }
  ],
  "SuccessCount": 1,
  "ErrorCount": 0
}

Status ist Sent (vom Mailprogramm übernommen), Displayed, Saved (Entwurf), Cancelled (geöffnet oder nachgefragt und ohne Senden geschlossen) oder Error. Program ist das Mailprogramm, das die Mail übernommen hat (bei Default das Standard-Mailprogramm; fehlt bei Client: Outlook). Message beschreibt das Ergebnis, gefolgt von allen Warnungen.

Fehlermeldungen

Meldung	Was tun
Mode "…" is not valid. Use one of: Display, Send, Draft.	Mode auf einen dieser Werte setzen, im Formular über Was passiert.
Mail program "…" is not installed for MAPI on this PC. Installed: …	Einen der genannten Namen als Client nehmen, oder das Programm installieren.
No default mail program is set in Windows.	In Windows ein Standard-Mailprogramm einstellen, oder unter Client ein Programm wählen.
The MAPI component of … is missing oder … or a file it needs is missing	Das Mailprogramm reparieren oder neu installieren.
… the 32-bit mail helper, which could not be started	RUNOS.MapiHost32.exe in %LOCALAPPDATA%\RUNOS\MapiHost32\ in der Sicherheitssoftware bzw. AppLocker freigeben.
…: logon to the mail program failed (is an account set up?) (MAPI error 3). The mail was not sent.	Im Mailprogramm ein Konto einrichten bzw. sich anmelden. Andere MAPI-Fehler nennen ebenso den Grund.
OutlookSignature "…" is not valid. Use one of: Auto, Always, Never.	OutlookSignature auf einen dieser Werte setzen, im Formular über Outlook-Signatur.
Mode "Draft" works only with Client "Outlook".	Client: Outlook nehmen, oder Display bzw. Send.

Beispiel

Jedes PDF aus dem Ordner C:\RUNOS\Angebote als Entwurf im klassischen Outlook ablegen, aus dem gemeinsamen Postfach vertrieb@example.com. Da Signatur fehlt, kommt die Outlook-Signatur unter den Text:

{
  "Name": "Angebote als Entwurf",
  "Autostart": true,
  "Trigger": { "Type": "File", "Name": "Angebote", "Parameters": { "Pool": "C:\\RUNOS\\Angebote", "Filter": "*.pdf" } },
  "Actions": [
    {
      "Type": "MAPI",
      "Name": "Entwurf",
      "Parameters": {
        "Client": "Outlook",
        "Mode": "Draft",
        "From": "vertrieb@example.com",
        "To": "{{InitialData.Kunde}}",
        "Subject": "Ihr Angebot {{FileName}}",
        "Body": "C:\\RUNOS\\Vorlagen\\angebot.html",
        "Attachments": "{{FilePath}}",
        "Importance": "High"
      }
    }
  ]
}

Der Empfänger kommt per Skriptblock aus dem PDF: #RUNOS InitialData.Kunde=kunde@example.com #RUNOS.