Über Ausdrücke können mehrere Quelldatenfelder (oder Ausdrücke) zu einem String kombiniert werden. Dadurch braucht z.B. für eine Anschrift nicht jedes Anschriftenfeld einzeln definiert zu werden, sondern nur der Gesamtbereich, in dem die Anschrift erscheinen soll.
Ein Ausdruck kann dann die Einzelfelder der Anschrift zu einem String kombinieren. Dabei können auch konstante Zeichen, wie Zeilenschaltungen und Leerzeichen hinzugefügt werden.
In die Bearbeitung der Ausdrücke gelangen Sie über das Hauptmenü "Bearbeiten" - "Ausdrücke bearbeiten".
Über die Auswahlmaske können Sie den Ausdruck auswählen, den Sie bearbeiten möchten. Über "Neu" kann ein neuer Ausdruck angelegt werden.
Um einen Ausdruck zu löschen, markieren Sie diesen, und wählen dann "Löschen":
Über die Auswahlknöpfe "Alle", "Ohne Detail" und "Mit Detail" lässt sich die Liste der angezeigten Ausdrücke einschränken. Wählen Sie "Ohne Detail", wenn Sie nur Ausdrücke sehen wollen, die sich auf Kopf- oder Fußinformationen beziehen. Wählen Sie "Mit Detail" wenn Sie nur Ausdrücke sehen möchten, die sich auf "Detaildatensätze" beziehen.
Geben Sie unter "Name" den Namen des Ausdrucks ein. Legen Sie mit "Bezug auf Detaildatensätze" fest, ob sich Ihr Ausdruck auf Detaildatensätze bezieht oder nicht.
Unter "Prüfausdruck" können Sie eine XML-Datenquelle, einen anderen Ausdruck oder einen Standardausdruck angeben, dessen Inhalt darüber entscheidet, ob Ihr neuer Ausdruck überhaupt aufbereitet wird, oder nicht. Ergibt der Prüfausdruck eine leere Zeichenkette wird auch Ihr Ausdruck eine leere Zeichenkette liefern. Benutzen Sie den Auswahlknopf (hinter dem Prüfausdruck) um einen möglichen Inhalt auszuwählen.
Im Normalfall wird der Prüfausdruck leer bleiben.
In dem nachfolgenden, mehrzeiligen Textfeld können Sie nun Ihren Ausdruck formulieren. Gehen Sie dabei wie folgt vor:
Setzen Sie den Cursor an die gewünschte Position innerhalb Ihres Ausdrucks. Geben Sie nun eine beliebige Zeichenfolge ein, oder betätigen Sie die Schaltfläche "Datenwert". Über Datenwert gelangen Sie in den XML-Viewer, über den Sie ein Quelldatenfeld, einen bereits vorformulierten Ausdruck oder einen Standardausdruck auswählen können. Nach Betätigen von "Auswählen" im XML-Viewer wird der gewählt Ausdruck an der Cursorposition eingefügt.
Über die Formatierungsfelder können Sie eine Formatierung der Ausgabe des Ausdrucks erreichen.
Über "Test" können Sie den Ausdruck einmal Testweise bewerten und anzeigen lassen.
Manuelle Eingabe von Ausdrücken
Die Syntax innerhalb der Ausdrücke sieht vor, das alles was nicht in ${ ... } eingeschlossen ist, als simpler, konstanter Text verwendet wird.
Über ${name} wird der Inhalt des Ausdrucks "name" eingefügt.
Über ${xml:XPATH:INDEX} wird der angegebene XPATH-Ausdruck aufgelöst, und die Dateninhalte der gefundenen XML-Nodes eingefügt. Ist der XPATH Ausdruck nicht eindeutig, werden auf Grund des angegebenen INDEX Nodes ausgewählt. (Siehe Formularfeldeigenschaften-Datenquellenindex)
Die Formulierung von XPATH Ausdrücken entnehmen Sie bitte der einschlägigen XML Dokumentation. Weitere Informationen dazu finden Sie auch unter http://www.w3.org/TR/xpath
Bei der Verwendung von XPath-Ausdrücken kann zusätzlich eine Formatierungsvorschrift für die Aufbereitung des Ausdrucks angegeben werden!
Die Syntax hierfür lautet dann: ${xml:XPATH:INDEX:Formatangabe:Formatlänge:Formatnachkommastellen}
Die Möglichkeiten der Aufbereitung entnehmen Sie bitte der Tabelle der möglichen Formatierungen.
Über ${script:Scriptaufruf} kann der Rückgabewert in eine Laufzeitscriptfunktion eingefügt werden. Beispiel: ${script:Script.Main.Funktion}
Über ${sum:Gruppenname.Summenname} kann auf einen Summenwert zurückgegriffen werden. Summen werden durch Eintrag des Attributs "Summenname" in den Feldeigenschaften eines Datenfeldes gebildet.
Über ${env:name} können Umgebungsvariable aufgelöst werden.
Zur Definition von Prüfausdrücken, Ausdrücken oder Fixtexten können folgende Standardausdrücke verwendet werden:
${NOW1} | Liefert das aktuelle Datum im Datumsformat 1 |
${NOW2} | Liefert das aktuelle Datum im Datumsformat 2 |
${PAGENO} | Liefert die aktuelle Seitennummer. |
${NEXTPAGENO} | Liefert die Folgeseitennummer (für Überträge). |
${PREVPAGENO} | Liefert die vorherige Seitennummer (für Überträge). |
Zugriff auf Kopfdaten aus Detailausdrücken
Beginnt ein XPath-Ausdrücke mit der Zeichenfolge "//" werden Daten aus den Kopfsegmenten geliefert. Beginnt er nicht mit "//" werden Daten aus dem aktuellen Positionssegment geliefert.
Einstellen des verwendeten Fonts
Für das Bearbeitungsfeld eines Ausdrucks kann eingestellt werden, welcher FONT für die Anzeige des Ausdrucks verwendet wird.
Legen Sie dazu einen Font mit dem Namen "ExprFont" in dem aktuellen Formular an, und legen sie dort die Eigenschaften des gewünschten Fonts fest.