Zum Inhalt springen

String Template Shaper

Der String Template Shaper kombiniert mehrere Felder und optionale Konstanten zu einem neuen String-Wert und schreibt diesen in ein neu erzeugtes Feld.

Die Komponente verarbeitet eine Template-Definition, in der Feldreferenzen und statische Inhalte kombiniert werden.

Die Verarbeitung erfolgt:

  • feldübergreifend
  • templatebasiert
  • stringgenerierend
  • konfigurationsgesteuert

Technischer Ablauf

  1. Über Quelle wird das DataItem definiert.
  2. Über Elementname wird der technische Name des neu zu erzeugenden Feldes festgelegt.
  3. Über Template wird die String-Struktur definiert.
  4. Platzhalter innerhalb geschweifter Klammern werden mit Feldwerten aus der Quelle ersetzt.
  5. Der generierte String wird in das neue Feld geschrieben.

Template-Syntax

Innerhalb des Template gelten folgende Regeln:

  • Inhalte in {} verweisen auf einen Feldname aus der Quelle
  • Texte außerhalb der {} werden als Konstante interpretiert
  • Mehrere Platzhalter können kombiniert werden

Beispiel

{documentId}-{templateName}.pdf

Bedeutung:

  • documentId wird aus dem DataItem gelesen
  • templateName wird aus dem DataItem gelesen
  • - und .pdf sind konstante Bestandteile

Konfigurationsparameter

Feld Beschreibung
Quelle Bestimmt das DataItem, auf dessen Daten die Komponente ihre Operationen ausführt.
Elementname Technischer Feldname des neu zu erzeugenden Feldes.
Template Template-Definition zur Generierung des String-Wertes. Feldreferenzen werden in {} angegeben.

Technische Hinweise

  • Alle referenzierten Felder im Template müssen im Objekt vorhanden sein
  • Nicht vorhandene Felder führen zu leeren oder fehlerhaften Ergebnissen
  • Der neue Elementname darf nicht mit bestehenden Feldern kollidieren
  • Der erzeugte Wert ist vom Typ String
  • Sonderzeichen im Template werden unverändert übernommen

Technische Kernobjekte

Element Beschreibung
String Template Shaper Komponente zur templatebasierten String-Erzeugung
Quelle Referenziertes DataItem
Elementname Ziel-Feld für den generierten String
Template Strukturdefinition des Zielstrings
Feldname Platzhalter innerhalb {}
DataItem Prozessdatenobjekt innerhalb intracon
Zuletzt aktualisiert am