Flower

← Alle Module · Daten & Formate

xml

Liest, ändert und prüft XML-Dateien per XPath-Pfad — ganz ohne Office. Damit lassen sich Werte und Attribute auslesen oder setzen, Elemente einfügen oder löschen, das Dokument gegen ein XSD-Schema validieren und nach JSON umwandeln.

Block-Einstellungen

Gelten für den ganzen Modul-Block (im Editor oben im Inspektor, in YAML direkt unter dem Modulnamen).

FeldTypPflichtBeschreibung
dateiText—Pfad zur .xml-Datei. Wird beim Block-Eintritt geladen; fehlt die Datei, startet ein leeres <root/>. Ohne 'datei' funktionieren nur Aktionen, die keinen Dateibezug brauchen (z. B. schreiben).
einrückungWahrheit—Standard true — beim Speichern wird das XML eingerückt und mit Zeilenumbrüchen geschrieben. Bei false wird kompakt (einzeilig) gespeichert.

Aktionen

wert-lesenlesend

Liest den Textinhalt des ersten Elements, das dem XPath entspricht.

Eingaben

FeldTypPflichtBeschreibung
xpathTextjaAbsoluter XPath wie /root/kunde/name.
standardText—Rückgabewert, falls kein Treffer gefunden wird.

Ausgaben (über ergebnis:)

wertTextinhalt des ersten Treffers oder der Standardwert.

werte-lesenlesend

Liest die Textinhalte aller Elemente, die dem XPath entsprechen, als Liste.

Eingaben

FeldTypPflichtBeschreibung
xpathTextjaAbsoluter XPath, der mehrere Treffer liefern kann (z. B. /root/x).

Ausgaben (über ergebnis:)

werteListe der Textinhalte aller Treffer.

attribut-lesenlesend

Liest den Wert eines Attributs des ersten passenden Elements.

Eingaben

FeldTypPflichtBeschreibung
xpathTextjaAbsoluter XPath zum Element.
nameTextjaName des Attributs.
standardText—Rückgabewert, falls Element oder Attribut fehlt.

Ausgaben (über ergebnis:)

wertAttributwert oder der Standardwert.

existiertlesend

Prüft, ob mindestens ein Element dem XPath entspricht.

Eingaben

FeldTypPflichtBeschreibung
xpathTextjaZu prüfender absoluter XPath.

Ausgaben (über ergebnis:)

vorhandentrue, wenn es mindestens einen Treffer gibt, sonst false.

anzahllesend

Zählt, wie viele Elemente dem XPath entsprechen.

Eingaben

FeldTypPflichtBeschreibung
xpathTextjaZu zählender absoluter XPath.

Ausgaben (über ergebnis:)

anzahlAnzahl der gefundenen Elemente.

abfragenlesend

Liefert die vollständigen Treffer-Elemente als XML-Text-Liste.

Eingaben

FeldTypPflichtBeschreibung
xpathTextjaAbsoluter XPath.

Ausgaben (über ergebnis:)

trefferListe der Treffer als serialisierter XML-Text.

text-lesenlesend

Liest den gesamten Textinhalt des Dokuments (alle Texte zusammengefügt).

Ausgaben (über ergebnis:)

textKompletter Textinhalt des Dokuments.

validierenlesend

Prüft das Dokument gegen ein XSD-Schema und meldet Validierungsfehler.

Eingaben

FeldTypPflichtBeschreibung
xsdTextjaXSD-Schema als Text.

Ausgaben (über ergebnis:)

gültigtrue, wenn keine Fehler gefunden wurden.
fehlerListe der Validierungs-Fehlermeldungen.

nach-jsonlesend

Wandelt das XML-Dokument in ein JSON-Objekt um (Attribute als @name, wiederholte Geschwister als Liste).

Ausgaben (über ergebnis:)

inhaltDas Dokument als JSON-Objekt/-Wert.

wert-setzenverändernd

Setzt den Textinhalt des ersten passenden Elements (verändert das Dokument im Speicher).

Eingaben

FeldTypPflichtBeschreibung
xpathTextjaAbsoluter XPath zum Zielelement; ohne Treffer Fehler xpath-kein-treffer.
wertText—Neuer Textinhalt des Elements.

attribut-setzenverändernd

Setzt oder ergänzt ein Attribut am ersten passenden Element.

Eingaben

FeldTypPflichtBeschreibung
xpathTextjaAbsoluter XPath zum Zielelement.
nameTextjaName des zu setzenden Attributs.
wertText—Neuer Attributwert.

element-hinzufügenverändernd

Fügt unter dem Eltern-Element ein neues Kind-Element ein (optional mit Text und Attributen).

Eingaben

FeldTypPflichtBeschreibung
eltern-xpathTextjaAbsoluter XPath zum Eltern-Element.
nameTextjaName des neuen Kind-Elements.
wertText—Optionaler Textinhalt des neuen Elements.
attributeObjekt—Optionale Map von Attributnamen auf Werte.

element-entfernenverändernd

Entfernt alle Elemente, die dem XPath entsprechen.

Eingaben

FeldTypPflichtBeschreibung
xpathTextjaAbsoluter XPath der zu entfernenden Elemente; ohne Treffer Fehler xpath-kein-treffer.

formatierenverändernd

Schreibt die Datei neu formatiert zurück (eingerückt oder kompakt).

Eingaben

FeldTypPflichtBeschreibung
kompaktWahrheit—true schreibt einzeilig/kompakt; ohne Angabe gilt die Block-Einstellung 'einrückung'.

schreibenverändernd

Ersetzt den gesamten Dokument-Inhalt durch übergebenen XML-Text (oder leert ihn).

Eingaben

FeldTypPflichtBeschreibung
inhaltText—Neuer XML-Text als Dokument-Inhalt; ohne Angabe entsteht ein leeres <root/>.

speichernverändernd

Schreibt das aktuelle Dokument in die geladene Datei zurück.

speichern-unterverändernd

Schreibt das aktuelle Dokument in eine andere Datei.

Eingaben

FeldTypPflichtBeschreibung
pfadTextjaZielpfad der neuen Datei.

Beispiele

Wert aus Konfigurationsdatei lesen

Liest den Servernamen aus einer XML-Konfiguration und nutzt einen Standardwert, falls er fehlt.

xml
wert-lesen
xpath/konfig/server/name
standardlocalhost
ergebnisservername
- xml:
    datei: "C:\\Daten\\konfig.xml"
    aktionen:
      - wert-lesen:
          xpath: /konfig/server/name
          standard: localhost
          ergebnis: servername

Neuen Kunden eintragen und speichern

Fügt unter /root/kunden ein neues Kunden-Element mit Text und id-Attribut ein und speichert die Datei.

xml
element-hinzufügen
eltern-xpath/root/kunden
namekunde
wertAnna
attribute{ id: "1" }
- xml:
    datei: "C:\\Daten\\kunden.xml"
    aktionen:
      - element-hinzufügen:
          eltern-xpath: /root/kunden
          name: kunde
          wert: Anna
          attribute:
            id: "1"
      - speichern: {}