Flower← Alle Module · Kommunikation & Netz
vcf
Liest, bearbeitet und speichert Kontakt-Dateien im vCard-Format (.vcf). Beim Block-Eintritt wird die angegebene Datei als Kontaktliste in den Speicher geladen; alle Änderungen geschehen im Speicher und werden erst beim Speichern in die Datei zurückgeschrieben.
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 .vcf-Datei. Wird beim Block-Eintritt geladen; existiert sie nicht, startet das Modul mit leerer Liste und legt sie beim Speichern an. Ohne Angabe startet eine leere Liste (für speichern/speichern-unter wird ein Pfad benötigt). |
Aktionen
lesenlesend
Liest alle Kontakte der Datei als Liste von Kontakt-Objekten.
Ausgaben (über ergebnis:)
| ergebnis | Liste aller Kontakte; jeder Kontakt als Objekt mit vorname, nachname, anzeigename, organisation, email (Liste), telefon (Liste), adresse. |
kontakt-lesenlesend
Liest einen einzelnen Kontakt anhand seines Listen-Index.
Eingaben
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| index | Zahl | ja | Position des Kontakts in der Liste (Ganzzahl ab 0). |
Ausgaben (über ergebnis:)
| vorname | Vorname des Kontakts. |
| nachname | Nachname des Kontakts. |
| anzeigename | Vollständiger Anzeigename (FN). |
| organisation | Organisation/Firma oder nichts. |
| Liste der E-Mail-Adressen. | |
| telefon | Liste der Telefonnummern. |
| adresse | Komma-getrennte Adresse oder nichts. |
kontakt-hinzufügenverändernd
Fügt der Liste einen neuen Kontakt hinzu (im Speicher; erst Speichern schreibt in die Datei).
Eingaben
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| vorname | Text | — | Vorname des Kontakts. |
| nachname | Text | — | Nachname des Kontakts. |
| organisation | Text | — | Organisation/Firma. |
| Liste | — | E-Mail-Adresse(n); einzelner Text oder Liste. | |
| telefon | Liste | — | Telefonnummer(n); einzelner Text oder Liste. |
| adresse | Text | — | Postanschrift als Text. |
kontakt-aktualisierenverändernd
Aktualisiert E-Mails, Telefone oder Organisation eines vorhandenen Kontakts.
Eingaben
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| index | Zahl | ja | Position des zu ändernden Kontakts (Ganzzahl ab 0). |
| Liste | — | Ersetzt die E-Mail-Liste, wenn angegeben. | |
| telefon | Liste | — | Ersetzt die Telefon-Liste, wenn angegeben. |
| organisation | Text | — | Setzt die Organisation neu, wenn angegeben. |
kontakt-entfernenverändernd
Entfernt einen Kontakt anhand seines Index aus der Liste.
Eingaben
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| index | Zahl | ja | Position des zu löschenden Kontakts (Ganzzahl ab 0). |
anzahllesend
Gibt die Anzahl der Kontakte in der Liste zurück.
Ausgaben (über ergebnis:)
| ergebnis | Anzahl der Kontakte als Zahl. |
speichernverändernd
Schreibt die aktuelle Kontaktliste zurück in die beim Block angegebene Datei (legt sie bei Bedarf an).
speichern-unterverändernd
Schreibt die aktuelle Kontaktliste in eine angegebene Zieldatei.
Eingaben
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| pfad | Text | ja | Zielpfad für die neue .vcf-Datei. |
Beispiele
Alle Kontakte einer vCard-Datei zählen und lesen
Lädt eine .vcf-Datei, ermittelt die Anzahl der Kontakte und liest alle aus.
- vcf:
datei: "C:\\Adressen\\team.vcf"
aktionen:
- anzahl:
ergebnis: kontaktzahl
- lesen:
ergebnis: alle_kontakteNeuen Kontakt hinzufügen und speichern
Fügt einer bestehenden vCard-Datei einen Kontakt hinzu und schreibt das Ergebnis zurück.
- vcf:
datei: "C:\\Adressen\\team.vcf"
aktionen:
- kontakt-hinzufügen:
vorname: Carla
nachname: Cee
organisation: "Cee AG"
email: carla@example.org
telefon: "+49 89 99"
- speichern: