Flower← Alle Module · Kommunikation & Netz
ics
Liest und bearbeitet iCalendar-Dateien (.ics) als reine Termin-Dateien: Einzeltermine anlegen, ändern, löschen, nach Zeitraum filtern und wieder speichern. Praktisch, um Kalender-Einträge automatisiert zu erzeugen oder zu pflegen, ohne dass ein Kalender-Programm geöffnet sein muss.
Block-Einstellungen
Gelten für den ganzen Modul-Block (im Editor oben im Inspektor, in YAML direkt unter dem Modulnamen).
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| datei | Text | — | Pfad zur .ics-Datei. Beim Block-Eintritt wird sie geladen; existiert sie nicht, startet das Modul mit leerer Terminliste. Wird die Datei weggelassen, kann nur im Speicher gearbeitet werden und 'speichern' ist nicht möglich (nur 'speichern-unter'). |
Aktionen
lesenlesend
Gibt alle Termine der Datei als Liste zurück.
Ausgaben (über ergebnis:)
| termine | Liste aller Termine; jeder Termin als Objekt mit uid, titel, beginn, ende, ganztags, ort, beschreibung, organisator und teilnehmer. |
termin-lesenlesend
Liest einen einzelnen Termin anhand seiner UID.
Eingaben
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| uid | Text | ja | Eindeutige Kennung (UID) des gesuchten Termins. |
Ausgaben (über ergebnis:)
| termin | Der gefundene Termin als Objekt (uid, titel, beginn, ende, ganztags, ort, beschreibung, organisator, teilnehmer). Fehler 'termin-nicht-gefunden', wenn die UID nicht existiert. |
termin-hinzufügenverändernd
Legt einen neuen Termin im Speicher an und vergibt automatisch eine neue UID.
Eingaben
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| titel | Text | ja | Bezeichnung/Betreff des Termins. |
| beginn | Datum | ja | Startzeitpunkt. Akzeptiert Datum-Werte oder ISO-Text (z.B. 2026-06-01T09:00:00 oder 20260601T090000). |
| ende | Datum | — | Endzeitpunkt. Fehlt er, wird automatisch eine Stunde nach Beginn gesetzt. |
| ganztags | Wahrheit | — | true für einen Ganztags-Termin (ohne Uhrzeit). Standard: false. |
| ort | Text | — | Ort/Raum des Termins. |
| beschreibung | Text | — | Freitext-Beschreibung/Notiz zum Termin. |
| teilnehmer | Liste | — | Liste von E-Mail-Adressen der Teilnehmer. |
Ausgaben (über ergebnis:)
| uid | Die automatisch erzeugte UID des neuen Termins. |
termin-aktualisierenverändernd
Ändert einzelne Felder eines bestehenden Termins; nur angegebene Felder werden überschrieben.
Eingaben
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| uid | Text | ja | UID des zu ändernden Termins. |
| titel | Text | — | Neuer Titel (nur wenn nicht leer übergeben). |
| beginn | Datum | — | Neuer Startzeitpunkt. |
| ende | Datum | — | Neuer Endzeitpunkt. |
| ort | Text | — | Neuer Ort. |
| beschreibung | Text | — | Neue Beschreibung. |
Ausgaben (über ergebnis:)
| ergebnis | Keine eigene Ausgabe. Fehler 'termin-nicht-gefunden', wenn die UID nicht existiert. |
termin-entfernenverändernd
Löscht einen Termin anhand seiner UID aus der Liste.
Eingaben
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| uid | Text | ja | UID des zu löschenden Termins. |
Ausgaben (über ergebnis:)
| ergebnis | Keine eigene Ausgabe. Fehler 'termin-nicht-gefunden', wenn die UID nicht existiert. |
im-zeitraumlesend
Gibt alle Termine zurück, die sich mit dem angegebenen Zeitfenster überschneiden.
Eingaben
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| von | Datum | ja | Beginn des Zeitfensters. |
| bis | Datum | ja | Ende des Zeitfensters. |
Ausgaben (über ergebnis:)
| termine | Liste der überlappenden Termine (Termin-Beginn vor 'bis' und Termin-Ende nach 'von'). |
anzahllesend
Liefert die Anzahl der Termine in der Datei.
Ausgaben (über ergebnis:)
| anzahl | Zahl der enthaltenen Termine. |
speichernverändernd
Schreibt den aktuellen Stand zurück in die beim Block angegebene Datei (legt sie bei Bedarf an).
Ausgaben (über ergebnis:)
| ergebnis | Keine eigene Ausgabe. Fehler, wenn beim Block kein 'datei:' gesetzt wurde. |
speichern-unterverändernd
Schreibt den aktuellen Stand als neue .ics-Datei unter einem angegebenen Pfad.
Eingaben
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| pfad | Text | ja | Zielpfad für die neue .ics-Datei. |
Ausgaben (über ergebnis:)
| ergebnis | Keine eigene Ausgabe; die Datei wird unter 'pfad' geschrieben. |
Beispiele
Termin anlegen und speichern
Öffnet eine Kalenderdatei, fügt einen Workshop-Termin mit Ort und Teilnehmern hinzu und speichert die Datei zurück.
- ics:
datei: "C:\\Kalender\\team.ics"
aktionen:
- termin-hinzufügen:
titel: "Workshop"
beginn: "2026-07-01T09:00:00"
ende: "2026-07-01T17:00:00"
ort: "Berlin"
teilnehmer:
- anna@firma.de
- bob@firma.de
ergebnis: neue_uid
- speichern: {}Termine eines Tages auflisten
Liest aus einer Kalenderdatei alle Termine, die sich mit einem bestimmten Tag überschneiden.
- ics:
datei: "C:\\Kalender\\team.ics"
aktionen:
- im-zeitraum:
von: "2026-05-20T00:00:00"
bis: "2026-05-20T23:59:59"
ergebnis: heutige_termine