Entwicklung > Safe X3 WAS > Tokens > Bedingte Blöcke 

SEEWARNING Es empfiehlt sich, vor Anlage einer Site folgende Dokumentation zu konsultieren:Was vor Ausführung der Funktion zu beachten ist.


Mit dem Token 'Bedingter Block' wird die dynamische Anzeige des HTML-Seiteninhalts in Abhängigkeit von den per Parametrierung definierten Kriterien verwaltet.
Beispiel: Der Inhalt eines HTML-Menüs soll abhängig davon geändert werden, ob der Benutzer angemeldet ist oder nicht.
Hierfür wird analog zum Block-Tokenin die HTML-Seite ein 'Bedingter-Block-Token' eingefügt.

Bei der dynamischen Generierung der Seite wertet die XTEND-Engine die mit dem Token verknüpfte Bedingung aus (logischer Ausdruck).

  • Wird die Auswertung geprüft, werden zur Generierung des dem Block entsprechenden HTML-Codes die 'nachgeordneten' Tokens generiert (von Beginn und Ende des Blocks begrenzte Tokens).
  • Wird die Bedingung nicht geprüft, werden die 'nachgeordneten' Tokens des Blockes ignoriert, und der HTML-Code wird nicht angezeigt.

Das Prinzip entspricht demjenigen der Tokens, mit denen HTML-Code verborgen anstatt angezeigt wird.

Der HTML-Parameter 'xnot' gibt an, dass die Umkehrung der Bedingung ausgewertet werden muss: d. h. der HTML-Code ist zu verbergen anstatt anzuzeigen:

<!--Bedingte Blöcke-->
<!adx="ADISPUSERLOGGEDIN">
<!--HTML-Code wird angezeigt, wenn der Benutzer angemeldet ist-->
<!adx="ADISPUSERLOGGEDIN">
<!--Inverser bedingter Block-->
<!adx="ADISPUSERLOGGEDIN:xnot">
<!--HTML-Code wird angezeigt, wenn der Benutzer nicht angemeldet ist-->
<!adx="ADISPUSERLOGGEDIN">

Vorbedingungen

SEEREFERTTO Siehe Dokumentation Umsetzung

Maskenverwaltung

Kopfzeile

Felder

In diesem Register befinden sich die folgenden Felder :

Code des bedingten Blocks.

  • Standort (Feld FCYLIB)

Aktuelle Website.

  • Bezeichnung (Feld INTIT)

 

Schließen

 

Register Allgemeine Angaben

Felder

In diesem Register befinden sich die folgenden Felder :

Eigenschaften

  • Feld WA

 

  • Anzeige Block (Feld WHNACT)

  • Ist die Option ausgewählt, kann der Inhalt des konditionierten Block-Tokens angezeigt werden, wenn die Bedingung geprüft wurde.

  • Andernfalls ist der Inhalt des konditionierten Tokens verborgen, wenn die Bedingung geprüft wurde.

  • Typ Kriterien (Feld WHNTYP)

Kriteriumstyp für die Bedingung Anzeigen/Verbergen.
Die anderen Parameter sind vom ausgewählten Kriterientyp abhängig.

Formel: die Bedingung wird geprüft, wenn die Formelauswertung 'wahr' ergibt.

Leerer Block: die Bedingung wird geprüft, wenn der Block leer ist.

Die Standard-Token hier unten bewerten den Hauptblock (AMAIN) der Seite:

  • ADISPMAINEMPTY: Zeigt HTML an, wenn der Hauptblock AMAIN leer ist.
  • AHIDEMAINEMPTY: Verbirgt HTML, wenn der Hauptblock AMAIN leer ist.

Der Token AHIDEMESSEMPTY verbirgt den HTML-Code, wenn eine Benutzernachricht vom Webservice zurückgesendet wurde.

Seitennummerierung eines Blocks: die Bedingung wird geprüft, wenn die Nummer der aktuellen Blockseite gleich dem erfassten Parameter ist.

Die Standard-Token hier unten bewerten den Hauptblock (AMAIN) der Seite.

  • AHIDEMAINFIRSTPAGE: Verbirgt HTML, wenn der Block AIMAN auf der ersten Seite ist.
  • AHIDEMAINLASTPAGE: Verbirgt HTML, wenn der Block AIMAN auf der letzten Seite ist.

Verwendete dynamische Verknüpfung: die Bedingung wird geprüft, wenn der Code des Tokens 'dynamische Verknüpfung', auf den der Benutzer zur Anzeige der Seite geklickt hat, gleich dem erfassten Code ist.

Vorherige Seite: die Bedingung wird geprüft, wenn der Code der Ursprungsseite, die vor der angezeigten Seite liegt, gleich dem Code der erfassten Webseite ist.

Unterzeichneter Benutzer: die Bedingung wird geprüft, wenn der Benutzer unterzeichnet ist.

Die Tokens hier unten werden mit dem Standort ASAMPLE geliefert.

  • ADISPUSERLOGGEDIN: Zeigt HTML an, wenn der Benutzer unterzeichnet ist.
  • AHIDEUSERLOGGEDIN: Verbirgt HTML, wenn der Benutzer unterzeichnet ist.

Profil: die Bedingung wird geprüft, wenn der Benutzer unterzeichnet ist und wenn das Profil XTEND dieses Benutzers gleich einem Profil der Liste ist (maximal 5).

Leeres Etikett: die Bedingung wird geprüft, wenn das aktuelle Etikett (Spezieller Token ASTAMP) leer ist.

Die Tokens hier unten werden mit dem Standort ASAMPLE geliefert.

  • ADISPSTAMPEMPTY: Zeigt HTML an, wenn das Label leer ist.
  • AHIDESTAMPEMPTY: Verbirgt HTML, wenn das Label leer ist.

Ausgewählte Zeile: die Bedingung wird geprüft, wenn der Block eine ausgewählte Zeile hat.

Die Standard-Token hier unten bewerten den Hauptblock (AMAIN) der Seite.

  • ADISPMAINSELECT: Zeigt HTML an, wenn der Hauptblock AMAIN der Seite eine ausgewählte Zeile hat.
  • AHIDEMAINSELECT: Verbirgt HTML, wenn der Hauptblock AMAIN der Seite eine ausgewählte Zeile hat.

Aktuelle Seite: die Bedingung wird geprüft, wenn die angezeigte Seite die aktuelle Seite ist, d.h. die gleiche Seite wie die, auf die der Benutzer geklickt hat.

Die Tokens hier unten werden mit dem Standard mitgeliefert:

  • ADISPSAMEPAGE: Zeigt HTML an, wenn es die gleiche Seite ist, die angezeigt wird.
  • AHIDESAMEPAGE: Verbirgt HTML, wenn es die gleiche Seite ist, die angezeigt wird.

Authentifizierung mit oder ohne Cookies: der Token ADISPNOCOOKIES ist reserviert und zeigt HTML an, wenn der Benutzer die Verwendung der Cookies JSESSIONID für die Authentifizierung der Sitzung über die dynamische Verknüpfung ADLKSWITCHCOOKIES und die Aktion XTEND ASESSSWITCHCOOKIES deaktiviert hat.

<!adx="ADISPNOCOOKIES">
<input type="button" value="Authentifizierung mit Cookie" adx="ADLKSWITCHCOOKIES">   
<!adx="ADISPNOCOOKIES">
<!adx="ADISPNOCOOKIES:xnot">
<input type="button" value="Authentifizierung ohne Cookie" adx="ADLKSWITCHCOOKIES">
<!adx="ADISPNOCOOKIES">

HTML-Parameter
Nur der Parameter xnot wird akzeptiert, um die Bedingung umzukehren.
Verbergen anstelle von Anzeigen und umgekehrt.

Eigenschaften

Blockcode, wenn der Kriterientyp: leerer Block, Seitennummerierung eines Blocks, ausgewählte Zeile ist.

  • Kriterium Seitenumbruch (Feld BLCPAG)

Dieses Feld kann erfasst werden, wenn der Kriterientyp "Seitennummerierung eines Blocks" ist.

Die Bedingung wird geprüft, wenn die Nummer der aktuellen Blockseite gleich dem erfassten Parameter ist:

  • Erste Seite: der Block ist auf der ersten Seite positioniert.

  • Letzte Seite: der Block ist auf der letzten Seite positioniert.

  • Andere Seite: der Block ist auf einer anderen als der ersten und der letzten Seite positioniert.

Code der dynamischen Verknüpfung, wenn der Kriterientyp gleich der "letzten verwendeten dynamischen Verknüpfung" ist.

Code der Webseite, wenn der Kriterientyp gleich "vorherige Seite" ist.

Profile Website

XTEND-Profilcode, wenn der Kriterientyp gleich "Profil" ist.

Schließen

 

Register Auswahl

Übersicht

Formel

Die Bedingung wird geprüft, wenn die Formelauswertung 'true' ergibt.

Im Block Formel kann der auszuwertende logische Ausdruck erfasst werden.

  • Der erste Operand ist vom Typ 'MeinBlock.MeinFeld".
  • Die Erfassung des Wertes des zweiten Operanden erfolgt analog zur Erfassung der Auswahlkriterien und Aktionsparameter.

Schließen

 

Felder

In diesem Register befinden sich die folgenden Felder :

Synthese Formel

  • Feld RES50

 

Tabelle Formel

  • und/oder (Feld ANDOR50)

Logischer Verkettungsoperator

  • ( (Feld BRKLFTM50)

Öffnende Klammer

Code des XTEND-Blocks für Operand Nr.1

Der Wert des Operanden Nr.1 wird vom Blockcode und vom Feldcode vorgegeben.

 

  • Feld (Feld VFIEKEY50)

Code des XTEND-Felds für Operand Nr.1.

Der Wert des Operanden Nr.1 wird vom Blockcode und vom Feldcode vorgegeben.

  • Feld OPE50

Vergleichsoperator

  • Ursprung (Feld VALTYP50)

  • Konstante: fester Wert, der in der folgenden Spalte erfasst ist.

  • Feld Token: Wert eines Blockfeldes, dessen Namen in den folgenden Spalten erfasst sind.

  • Feld Web: Wert eines Feldes des HTML-Formulars, dessen Name in der folgenden Spalte erfasst ist.

  • Cste/Attribut Web (Feld VALEUR50)

Wer der Konstante oder Name (Attribut 'Name') des Web-Felds

Code des XTEND-Blocks für den Operand Nr.2 wenn Typ 'xtend-Feld'.

Der Wert des Operanden Nr.2 wird vom Blockcode und vom Feldcode vorgegeben.

 

  • Feld (Feld VFIEKEY50A)

Code des Feldtokens für den Operand Nr.2 wenn Typ 'xtend-Feld'.

Der Wert des Operanden Nr.2 wird vom Blockcode und vom Feldcode vorgegeben.

  • ) (Feld BRKRGTM50)

Schließende Klammer

Schließen

 

Berichte

Standardmäßig sind der Funktion folgende Reports zugeordnet :

 PRTSCR : Druck Maske

Dies kann durch geeignete Parameter geändert werden.

Spezielle Buttons

Über diese Schaltfläche kann das XTEND-Dictionary im XML-Format aktualisiert werden.

Der X3WEB-Server berücksichtigt das Dictionary nur, wenn es dieses Format aufweist.

Es ist eine xml-Datei pro Dictionary vorhanden.

So entspricht beispielsweise die Datei ACT.xml sämtlichen Web-Aktionen der aktuellen Website.

Mit diesem Button kann ein bedingter Block kopiert werden.

Fehlermeldungen

Nur generische Fehlermeldungen.

Verwendete Tabellen

SEEREFERTTO Siehe Dokumentation Umsetzung