Nicht jede Dokumentvorlage besteht ausschließlich aus festem Text oder der Ausgabe von Variablen.

Häufig sollen Inhalte abhängig von bestimmten Bedingungen ausgegeben, unterschiedliche Dokumentbestandteile ausgewählt oder verschiedene Verarbeitungswege eingeschlagen werden.

Hierzu stellt die XML-Sprache von intracon:bk verschiedene Steuerelemente zur Verfügung.

Typische Anwendungsfälle sind beispielsweise:

• Ausgabe unterschiedlicher Texte abhängig vom Dokumentinhalt
• Prüfung, ob Daten vorhanden sind
• Vergleich von Zahlen, Texten oder Datumswerten
• Auswahl eines Verarbeitungszweiges anhand eines Status oder Kennzeichens
• Kombination mehrerer Bedingungen
• Verschachtelung komplexer Entscheidungsstrukturen

Bedingte Verarbeitung

Bedingungen werden während der Dokumenterzeugung ausgewertet.

Abhängig vom Ergebnis wird entschieden,

• ob ein XML-Bereich verarbeitet wird,
• welcher Dokumentinhalt ausgegeben wird oder
• welcher Verarbeitungszweig ausgeführt werden soll.

Dadurch kann eine Dokumentvorlage flexibel auf unterschiedliche Auftragsdaten reagieren.

Verfügbare XML-Elemente

Derzeit werden im Bereich Bedingungen und Schleifen folgende XML-Elemente beschrieben:

XML-Element	Zweck
If	Führt Inhalte abhängig von einer oder mehreren Bedingungen aus.
Case	Wählt anhand des Wertes einer Variablen einen von mehreren Verarbeitungszweigen aus.

Weitere XML-Elemente werden in zukünftigen Versionen dieser Dokumentation ergänzt.

If oder Case?

Die beiden XML-Elemente verfolgen unterschiedliche Ziele.

Verwenden Sie If, wenn eine oder mehrere Bedingungen geprüft werden sollen.

Typische Beispiele:

• Existiert eine Variable?
• Ist ein Betrag größer als 100?
• Sind zwei Werte identisch?
• Sind mehrere Bedingungen gleichzeitig erfüllt?

Verwenden Sie Case, wenn abhängig vom Wert einer Variablen zwischen mehreren Möglichkeiten unterschieden werden soll.

Typische Beispiele:

• Dokumentstatus
• Bearbeitungsstatus
• Kennzeichen
• Dokumenttyp

Empfehlung

Mehrere verschachtelte <If>-Elemente, die ausschließlich unterschiedliche Werte derselben Variablen prüfen, lassen sich häufig übersichtlicher durch ein <Case> ersetzen.

Zusammenspiel mit anderen XML-Elementen

Bedingungen werden häufig gemeinsam mit anderen XML-Elementen verwendet.

Besonders häufig sind Kombinationen mit:

• <Variable> zur Prüfung von Variablenwerten
• <Math> zur Auswertung berechneter Ergebnisse
• <Setter> zur Zwischenspeicherung von Werten
• <Reference> zur Auswahl unterschiedlicher Dokumentbausteine

Diese Kombinationen ermöglichen den Aufbau leistungsfähiger und zugleich gut strukturierter Dokumentvorlagen.

Developer-Tipp

Beginnen Sie komplexe Dokumentvorlagen möglichst mit einfachen Bedingungen und erweitern Sie diese schrittweise.

Mehrere kleine, gut nachvollziehbare Bedingungen sind in der Regel leichter verständlich und wartbar als wenige, stark verschachtelte Konstruktionen.