Flower

← Alle Module · Hilfsmittel

text

Das Modul "text" bearbeitet und untersucht Text-Werte ohne Datei-Bezug: Es baut Texte aus Vorlagen mit Platzhaltern, formatiert Werte, ersetzt, teilt, verbindet, prüft und durchsucht Zeichenketten. Damit lassen sich z. B. Betreffzeilen, Dateinamen oder Nachrichten dynamisch zusammenbauen.

Aktionen

bauenlesend

Ersetzt {platzhalter} in einer Vorlage durch die passenden Werte und gibt den fertigen Text zurück.

Eingaben

FeldTypPflichtBeschreibung
vorlageTextjaText mit Platzhaltern in geschweiften Klammern, z. B. "Hallo {name}".
werteObjekt—Zuordnung von Platzhalter-Namen zu Werten, die eingesetzt werden.

Ausgaben (über ergebnis:)

ergebnisDie Vorlage mit eingesetzten Werten.

formatierenlesend

Formatiert einen Wert (Zahl oder Datum) nach einer Format-Vorlage in DACH-Kultur.

Eingaben

FeldTypPflichtBeschreibung
wertObjektjaDer zu formatierende Wert, z. B. eine Zahl oder ein Datum.
vorlageTextjaFormat-Vorlage, z. B. "C2" für Währung oder "dd.MM.yyyy".

Ausgaben (über ergebnis:)

ergebnisDer formatierte Text, z. B. "1.234,56 €".

ersetzenlesend

Ersetzt in einem Text alle Vorkommen eines Suchbegriffs durch einen Ersatztext, wahlweise per Regex.

Eingaben

FeldTypPflichtBeschreibung
textTextjaDer Ausgangstext.
sucheTextjaZu suchender Text oder Regex-Muster.
ersatzTextjaText, der eingesetzt wird.
regexWahrheit—Wenn ja, wird "suche" als regulaerer Ausdruck behandelt (Default nein).
groß-klein-egalWahrheit—Wenn ja, wird Groß-/Kleinschreibung ignoriert (Default nein).

Ausgaben (über ergebnis:)

ergebnisDer Text mit allen Ersetzungen.

aufteilenlesend

Zerlegt einen Text an einem Trennzeichen in eine Liste von Teilstrings.

Eingaben

FeldTypPflichtBeschreibung
textTextjaDer zu zerlegende Text.
trennerText—Trennzeichen (Default Leerzeichen).
regexWahrheit—Wenn ja, gilt "trenner" als Regex (Default nein).
leere-überspringenWahrheit—Wenn ja, werden leere Teilstrings entfernt (Default ja).

Ausgaben (über ergebnis:)

ergebnisListe der Teilstrings.

zusammenfügenlesend

Verbindet eine Liste von Werten mit einem Trennzeichen zu einem einzigen Text.

Eingaben

FeldTypPflichtBeschreibung
texteListejaListe der zu verbindenden Werte.
trennerText—Trennzeichen zwischen den Elementen (Default ", ").

Ausgaben (über ergebnis:)

ergebnisDer verbundene Text.

großlesend

Wandelt den gesamten Text in Großbuchstaben um.

Eingaben

FeldTypPflichtBeschreibung
textTextjaDer umzuwandelnde Text.

Ausgaben (über ergebnis:)

ergebnisDer Text in Großbuchstaben.

kleinlesend

Wandelt den gesamten Text in Kleinbuchstaben um.

Eingaben

FeldTypPflichtBeschreibung
textTextjaDer umzuwandelnde Text.

Ausgaben (über ergebnis:)

ergebnisDer Text in Kleinbuchstaben.

trimlesend

Entfernt Leerzeichen am Anfang und/oder Ende eines Textes.

Eingaben

FeldTypPflichtBeschreibung
textTextjaDer zu beschneidende Text.
woText—"links", "rechts" oder "beide" (Default "beide").

Ausgaben (über ergebnis:)

ergebnisDer beschnittene Text.

enthältlesend

Prüft, ob ein Text einen bestimmten Suchbegriff enthält.

Eingaben

FeldTypPflichtBeschreibung
textTextjaDer zu durchsuchende Text.
sucheTextjaDer gesuchte Teiltext.
groß-klein-egalWahrheit—Wenn ja, wird Groß-/Kleinschreibung ignoriert (Default nein).

Ausgaben (über ergebnis:)

ergebnisWahr, wenn der Suchbegriff vorkommt, sonst falsch.

extrahierelesend

Extrahiert per Regex-Muster einen Treffer (oder alle Treffer) aus einem Text.

Eingaben

FeldTypPflichtBeschreibung
textTextjaDer Ausgangstext.
musterTextjaRegulaerer Ausdruck, nach dem gesucht wird.
gruppeZahl—Nummer der Capture-Gruppe (Default 0 = ganzer Treffer).
alleWahrheit—Wenn ja, wird eine Liste aller Treffer zurueckgegeben (Default nein).

Ausgaben (über ergebnis:)

ergebnisDer gefundene Teiltext bzw. die Liste aller Treffer.

kürzenlesend

Kürzt einen Text auf eine maximale Länge und hängt eine Endung an, wenn gekürzt wurde.

Eingaben

FeldTypPflichtBeschreibung
textTextjaDer zu kuerzende Text.
maximumZahljaMaximale Zeichenzahl des Ergebnisses.
endungText—Anhang bei Kuerzung (Default "…").

Ausgaben (über ergebnis:)

ergebnisDer gekuerzte Text.

zeile-findenlesend

Sucht in einer Liste von Zeilen die erste, die einen Teiltext enthält oder auf ein Regex-Muster passt.

Eingaben

FeldTypPflichtBeschreibung
zeilenListejaListe der zu durchsuchenden Zeilen.
enthältText—Teiltext, den die Zeile enthalten muss.
passt-aufText—Regex-Muster, auf das die Zeile passen muss.
start-beiZahl—Zeilen-Index, ab dem gesucht wird (Default 0).

Ausgaben (über ergebnis:)

ergebnisZeilen-Index des Treffers (-1, wenn nichts gefunden).
ergebnis-zeileText der gefundenen Zeile.

Beispiele

Betreffzeile aus Vorlage bauen

Aus einer Vorlage mit Platzhaltern wird eine fertige Betreffzeile fuer eine Mail erzeugt.

text
bauen
vorlageRechnung {nummer} für {kunde}
werte.nummer2026-042
werte.kundeMustermann GmbH
ergebnisbetreff
- text:
    aktionen:
      - bauen:
          vorlage: "Rechnung {nummer} für {kunde}"
          werte:
            nummer: "2026-042"
            kunde: "Mustermann GmbH"
          ergebnis: betreff

Dateiname normalisieren und kürzen

Ein Roh-Text wird kleingeschrieben, Leerzeichen durch Bindestriche ersetzt und auf eine Maximallaenge gekuerzt.

text
klein
textQuartalsbericht Q2 Vertrieb
ergebnisklein_name
text
ersetzen
textklein_name
suche
ersatz-
ergebnisslug
text
kürzen
textslug
maximum20
ergebnisdateiname
- text:
    aktionen:
      - klein:
          text: "Quartalsbericht Q2 Vertrieb"
          ergebnis: klein_name
      - ersetzen:
          text: klein_name
          suche: " "
          ersatz: "-"
          ergebnis: slug
      - kürzen:
          text: slug
          maximum: 20
          ergebnis: dateiname