Token

Was ist ein XTEND-Token?

Ein XTEND-Token ist ein Textelement, das in eine HTML-Seite eingefügt wird, um deren Inhalt dynamisch zu gestalten.

Das Token kann auf zwei verschiedene Arten in die Seite eingefügt werden:

• entweder als Attribut eines HTML-Tags
    <td adx="monChamp"></td>
• oder als Trennzeichen für einen Teil der HTML-Seite
    <!adx="monBlocConditionné">...Html...<!adx="monBlocConditionné">

Jedem Token sind im XTEND-Dictionary Parameterdaten zugeordnet, mit denen das Tokenverhalten gesteuert werden kann.

Beispiel:

• Ein in ein <td>-Tag eingefügtes <field>-Token ersetzt den Zelleninhalt durch den Feldwert, dessen Format durch die Parameterdaten festgelegt ist
• Mit einem Token vom Typ bedingter Block wird der abgetrennte Teil der HTML-Seite gemäß einer in den Parameterdaten definierten Regel maskiert oder verborgen

Beispiel:

<!adx="ADISPUSERLOGGEDIN">
<!--Dieser Block wird angezeigt, wenn der Benutzer verbunden ist-->
 <!--AUSERCODE ist ein Token vom Typ 'field' -->
 Sie sind mit folgendem Benutzercode verbunden <b adx="AUSERCODE"></b><br>
 <!--ADLKLOGOUT ist ein Token vom Typ 'dynamischer Link'-->
 Um die Verbindung zu unterbrechen, klicken Sie auf <a adx="ADLKLOGOUT">hier</a>              
<!adx="ADISPUSERLOGGEDIN">        

Tokensyntax

Grundlagen

adx="myElement"

Es wird nicht zwischen Groß- und Kleinbuchstaben unterschieden:

ADX="myelement", Adx="MYELEMENT", aDx="MyElEmEnT" etc.

Es dürfen keine Leerzeichen eingefügt werden:

adx ="aaa", adx= "aaa", adx=" aaa " sind unzulässig

Ursprungsausdruck

adx="B1.MyField"

B1 wird als Referenzblock

bezeichnet

Mit dieser Syntax kann der Ursprung einer Information ausgedrückt werden.

Hierfür wird als Trennzeichen der Punkt verwendet.

Im Beispiel stammt MyField aus dem Block B1. Diese Syntax ist in der Dokumentation der<field>-Token

genauer beschrieben.

adx="B1(i).MyField"

Mit diesem Ausdruck kann das Feld MyField der i-ten Blockzeile (i beginnt bei 1) adressiert werden.

adx="B1.MyTokenLink". Mit diesem Ausdruck wird das Token MyTokenLink mit den Daten des Referenzblocks B1 als Parameter angestoßen. MyTokenLink kann sich z. B. auf eine Seitenumbruchsaktion beziehen.

HTML-Parameter hinzufügen

adx="myElement:param1=val1&param2=val2&param3"

HTLM-Parameter werden in die HTML-Seite eingefügt und verändern das Standardverhalten des Tokens.

Es können Parameter hinzugefügt werden:

• indem diese vom Element per Doppelpunkt getrennt werden
• indem diese untereinander per "&" getrennt werden
• indem als Parametername der Parameterwert erfasst wird

Diese Syntax ist in der Dokumentation der <field>-Token genauer beschrieben.

Beispiele:

Änderung des Formats eines Datums:

<span adx="ATODAY:xformat=Dz:DD[ ]MMMMMMMMMM[ ]YYYY"></span>

Anzeige von Bezeichnungen:

 Wenn das Feld LIBMENULOCAL vom Typ 'Lokales Menü' mit der Option Bezeichnung definiert wird, kann mit nachstehendem Code die Bezeichnung dem Text Nr. 1 des Lokalen Menüs zugeordnet werden.

<span adx="LIBMENULOCAL:xcaption=1"></span>

Verwendung in einem <select>-Tag

Codebeispiel:

• Aufruf des dynamischen Links MyLink im Ereignis onChange
• Belegung der Optionen mit dem Inhalt des Feldes MyMenuLocal
• Automatische Auswahl der Option, die dem Wert von MyField entspricht

<select name="MYNAME" adx="MyField:xonchange=MyLink&xfill=MyMenuLocal">...</select>

<field>-Token Lokales Menü oder mit Werteliste

Durch Hinzufügen von _DESCR zum Token-Code kann die dem Tokenwert zugeordnete Beschreibung (Bezeichnung) selektiert werden.

<!-- Bezeichnung anzeigen-->
<b adx="MyMenuLocal_descr"></b>
<!-- Wert (Index) anzeigen -->
<b adx="MyMenuLocal"></b>

Tokentypen

Nachstehender Liste sind die in XTEND enthaltenen Tokentypen zu entnehmen:

<field>-Token
Steht für die Werte der Datenfelder

<link>-Token
Stößt eine Benutzeraktion als Verzweigung und / oder eine Webaktion und / oder eine Selektion an

<block>-Token
Führt einen 'Datenzugriff' (Abfrage) mit Iteration über die gelesenen Entitäten (Datensätze) durch

Bedingtes <block>-Token
Verwaltet die Anzeige von HTML-Blöcken gemäß den definierten Regeln

Sondertoken
Spezielle Token, deren Verhalten nicht parametrierbar ist

<page>-Token
Für Verzweigungen auf die Seite ohne Anlage eines Tokens vom Typ 'dynamischer Link' kann in ein <a adx="MyPage"></a> -Tag ein Seitencode eingefügt werden.