Flower← Alle Module · Kommunikation & Netz
pop3
Ruft E-Mails von einem POP3-Postfach ab — listet Nachrichten auf, liest einzelne Mails, speichert Anhänge und kann Mails vom Server löschen. Ideal, um eingehende Mails (z.B. von einem Sammelpostfach) automatisiert 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 POP3-Servers (z.B. pop3.example.com). Standard: localhost. |
| port | Zahl | — | Port des POP3-Servers. Standard: 995 (POP3 über SSL). |
| ssl | Wahrheit | — | Ob die Verbindung per TLS/SSL verschlüsselt wird. Standard: ja (true). |
| nutzer | Text | — | Benutzername/Mail-Adresse für die Anmeldung. Wird für jede Aktion benötigt, die wirklich auf den Server zugreift. |
| passwort-cred | Objekt | — | Credential-Referenz für das Passwort (Felder quelle und schlüssel; aktuell wird quelle env aus einer Umgebungsvariable aufgelöst). |
Aktionen
listelesend
Listet die Mails im Postfach (bis zu max Stück) mit Absender, Betreff, Datum, Text und Anhangsnamen.
Eingaben
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| max | Zahl | — | Maximale Anzahl abzurufender Mails. Standard: 50. |
Ausgaben (über ergebnis:)
| mails | Liste von Mail-Objekten, jeweils mit id, von, an, betreff, datum, text und anhang-namen. Im Simulationsmodus leer (kein Netzwerkzugriff). |
lesenlesend
Liest eine einzelne Mail anhand ihrer laufenden Nummer (id) und liefert deren Inhalt.
Eingaben
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| id | Zahl | ja | Nullbasierter Index der Mail im Postfach. |
Ausgaben (über ergebnis:)
| Mail-Objekt mit von, an, betreff, datum, text und anhang-namen; zusätzlich liegen diese Felder auch direkt in den Ausgaben. Nichts, wenn die id nicht existiert oder im Simulationsmodus. |
abrufenlesend
Alias für lesen — liest eine einzelne Mail anhand ihrer id.
Eingaben
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| id | Zahl | ja | Nullbasierter Index der Mail im Postfach. |
Ausgaben (über ergebnis:)
| Mail-Objekt wie bei lesen; Nichts, wenn die id nicht existiert oder im Simulationsmodus. |
anhänge-speichernverändernd
Speichert die Datei-Anhänge einer Mail in einen Zielordner, optional gefiltert nach Dateinamen-Mustern.
Eingaben
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| id | Zahl | ja | Nullbasierter Index 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. Auch ein einzelner Text ist erlaubt. Ohne Filter werden alle Anhänge gespeichert. |
Ausgaben (über ergebnis:)
| dateien | Liste der geschriebenen Dateipfade. Im Simulationsmodus leer (Dateien werden über das Overlay-Dateisystem geschrieben, kein Netzwerk). |
vom-server-löschenverändernd
Löscht eine Mail anhand ihrer id endgültig vom POP3-Server.
Eingaben
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| id | Zahl | ja | Nullbasierter Index der zu löschenden Mail. |
Ausgaben (über ergebnis:)
| ergebnis | Keine Ausgabefelder. Im Simulationsmodus wird statt zu löschen nur eine Vorschau angezeigt. |
loeschenverändernd
Alias (ASCII-Kurzform) für vom-server-löschen — löscht eine Mail vom Server.
Eingaben
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| id | Zahl | ja | Nullbasierter Index der zu löschenden Mail. |
Ausgaben (über ergebnis:)
| ergebnis | Keine Ausgabefelder. Im Simulationsmodus nur Vorschau. |
Beispiele
Anhänge aus erster Mail speichern
Verbindet sich mit dem POP3-Postfach, liest die erste Mail und legt deren PDF-Anhänge in einem Ordner ab.
- pop3:
server: pop3.example.com
port: 995
ssl: ja
nutzer: rechnungen@firma.de
passwort-cred:
quelle: env
schlüssel: POP3_PW
aktionen:
- anhänge-speichern:
id: 0
ziel-ordner: "C:\\Eingang\\Anhaenge"
filter:
- "*.pdf"
ergebnis: gespeicherte_dateienPostfach auflisten und erste Mail löschen
Listet bis zu 20 Mails auf und löscht anschließend die erste Nachricht vom Server.
- pop3:
server: pop3.example.com
nutzer: sammel@firma.de
passwort-cred:
quelle: env
schlüssel: POP3_PW
aktionen:
- liste:
max: 20
ergebnis: postfach
- vom-server-löschen:
id: 0