Flower← Alle Module · Kommunikation & Netz
imap
Greift direkt auf ein E-Mail-Postfach per IMAP zu: Nachrichten auflisten und lesen, als gelesen/ungelesen markieren, Anhänge speichern, Mails verschieben oder löschen sowie Postfach-Ordner verwalten. Praktisch, um eingehende E-Mails automatisch zu sortieren, abzulegen oder weiterzuverarbeiten.
Block-Einstellungen
Gelten für den ganzen Modul-Block (im Editor oben im Inspektor, in YAML direkt unter dem Modulnamen).
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| server | Text | — | Adresse des IMAP-Servers (Standard: localhost). |
| port | Zahl | — | Server-Port (Standard: 993). |
| ssl | Wahrheit | — | Verschlüsselte Verbindung per TLS verwenden (Standard: ja). |
| nutzer | Text | — | Anmeldename / E-Mail-Adresse für das Postfach. |
| passwort-cred | Objekt | — | Verweis auf das hinterlegte Passwort (Credential-Block mit Schlüssel), statt das Passwort im Klartext anzugeben. |
| ordner | Text | — | Postfach-Ordner, auf dem die Aktionen arbeiten (Standard: INBOX). |
Aktionen
listelesend
Listet die Mails des konfigurierten Ordners auf, optional nur ungelesene und auf eine Höchstzahl begrenzt.
Eingaben
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| ungelesen-only | Wahrheit | — | Nur ungelesene Mails einbeziehen (Standard: nein). |
| max | Zahl | — | Maximale Anzahl zurückgegebener Mails (Standard: 50). |
Ausgaben (über ergebnis:)
| mails | Liste der gefundenen Mails, je mit mail-id, von, an, cc, bcc, betreff, text, inhalt-html, datum und anhang-namen. |
lesenlesend
Liest eine einzelne Mail anhand ihrer UID vollständig aus.
Eingaben
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| id | Zahl | ja | UID der zu lesenden Mail. |
Ausgaben (über ergebnis:)
| Die Mail mit allen Feldern (von, an, betreff, text, inhalt-html, datum, anhang-namen …) oder leer, wenn nicht gefunden. |
als-gelesen-markierenverändernd
Setzt das Gelesen-Kennzeichen einer Mail.
Eingaben
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| id | Zahl | ja | UID der zu markierenden Mail. |
als-ungelesen-markierenverändernd
Entfernt das Gelesen-Kennzeichen einer Mail.
Eingaben
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| id | Zahl | ja | UID der zu markierenden Mail. |
anhänge-speichernverändernd
Speichert die Anhänge einer Mail in einen Zielordner auf dem Dateisystem, optional gefiltert per Namensmuster.
Eingaben
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| id | Zahl | ja | UID der Mail, deren Anhänge gespeichert werden. |
| ziel-ordner | Text | ja | Ordner, in den die Anhänge geschrieben werden (wird bei Bedarf angelegt). |
| filter | Liste | — | Optionale Glob-Muster (z.B. *.pdf); nur passende Anhänge werden gespeichert. |
Ausgaben (über ergebnis:)
| dateien | Liste der geschriebenen Datei-Pfade. |
ordner-listenlesend
Listet alle Ordner des Postfachs auf.
Ausgaben (über ergebnis:)
| ordner | Liste aller Ordnernamen im Postfach. |
ordner-anlegenverändernd
Legt einen neuen Ordner im Postfach an.
Eingaben
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| name | Text | ja | Name des anzulegenden Ordners. |
ordner-löschenverändernd
Löscht einen Ordner im Postfach.
Eingaben
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| name | Text | ja | Name des zu löschenden Ordners. |
verschiebenverändernd
Verschiebt eine Mail aus dem aktuellen Ordner in einen Zielordner.
Eingaben
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| id | Zahl | ja | UID der zu verschiebenden Mail. |
| ziel-ordner | Text | ja | Zielordner im Postfach. |
loeschenverändernd
Löscht eine Mail; standardmäßig in den Papierkorb, mit endgültig=ja unwiderruflich.
Eingaben
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| id | Zahl | ja | UID der zu löschenden Mail. |
| endgültig | Wahrheit | — | Bei ja sofort und unwiderruflich löschen statt in den Papierkorb (Standard: nein). |
Beispiele
Ungelesene Mails auflisten
Holt die neuesten ungelesenen Mails aus dem Posteingang, begrenzt auf 20 Stück.
- imap:
server: "imap.firma.de"
nutzer: "buero@firma.de"
passwort-cred:
schlüssel: "IMAP_PASSWORT"
ordner: "INBOX"
aktionen:
- liste:
ungelesen-only: ja
max: 20
ergebnis: neue_mailsAnhänge ablegen und Mail archivieren
Speichert die PDF-Anhänge einer Mail in einen Netzlaufwerk-Ordner und verschiebt die Mail danach ins Archiv.
- imap:
server: "imap.firma.de"
nutzer: "buero@firma.de"
passwort-cred:
schlüssel: "IMAP_PASSWORT"
ordner: "INBOX"
aktionen:
- anhänge-speichern:
id: 4827
ziel-ordner: "R:\\Rechnungen\\Eingang"
filter:
- "*.pdf"
ergebnis: gespeicherte_dateien
- verschieben:
id: 4827
ziel-ordner: "Archiv"