Tokeny

Czym jest token XTEND?

Token XTEND jest elementem tekstowym dodawanym do strony HTML tak, aby jej zawartość stała się dynamiczna.

Token może zostać umieszczony na stronie na dwa sposoby:

• jako atrybut znacznika HTML
  <td adx='monChamp'></td>
• lub jako separator części HTML
  <!adx='monBlocConditionné'>...Html...<!adx='monBlocConditionné'>

Każdy token jest powiązany z rekordem ustawień w słowniku XTEND, służącym do kontroli jego zachowania.

Na przykład:

• Token typu pole, wstawiony w znaczniku <td> zastępuje zawartość komórki wartością pola, którego format jest podany w rekordzie ustawień.
• token typu „sekcja warunkowa” maskuje lub ukrywa część HTML, którą ogranicza, w zależności od reguły określonej w rekordzie ustawień

Na przykład:

<!adx='ADISPUSERLOGGEDIN'>
<!--Ta sekcja jest wyświetlana, gdy użytkownik jest podłączony”-->
<!--AUSERCODE jest tokenem typu „Pole”-->
Zalogowałeś się przy użyciu kodu użytkownika<b adx='AUSERCODE'></b><br>
<!--ADLKLOGOUT jest tokenem typu „łącze dynamiczne”-->
Aby się wylogować, kliknij<a adx='ADLKLOGOUT'>here</a>
<!adx='ADISPUSERLOGGEDIN'>

Składnia tokena

Składnia wspólna

adx='myElement'

Możliwe jest stosowanie zarówno małych jak i wielkich liter:

ADX='myelement', Adx='MYELEMENT', aDx='MyElEmEnT',…

Nie można wstawiać znaków pustych:

adx ='aaa', adx= 'aaa', adx=' aaa ' są zabronione

Wyrażanie pochodzenia

adx='B1.MyField'

B1 jest nazwą sekcji odniesienia

Składnia ta służy wyrażaniu pochodzenia informacji.

Kropka służy jako separator.

W podanym przykładzie, MyField są danymi pochodzącymi z sekcji B1.

Szczegółowy opis tej składni znajduje się w dokumentacji Pola tokenu .

adx='B1(i).MyField'

Wyrażenie to umożliwia dostęp do takiego pola MyField lub takiego wiersza w sekcji (rozpoczynającej się od 1)

adx='B1.MyTokenLink'

Wyrażenie to służy do uruchamiania tokena MyTokenLink poprzez ujęcie danych sekcji odniesienia B1 jako ustawień czynności. MyTokenLink może oznaczać, na przykład, czynność podziału na strony.

Dodawanie ustawień HTML

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

Ustawienia HTML są dodawane do strony HTML i służą do modyfikacji standardowego zachowania tokena.

Możliwe jest dodanie ustawień w następujący sposób:

• poprzez oddzielenie ustawień od kodu elementu poprzez znak „:”
• poprzez oddzielenie ich od siebie znakiem &
• poprzez wprowadzenie nazwy ustawienia = wartości ustawienia

Szczegółowy opis tej składni znajduje się w dokumentacji Pola Tokenu.

Przykłady:

Modyfikacja formatu daty:

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

Wyświetlenie opisu:

Podczas definiowania pola LIBMENULOCAL typu „lokalne menu” z użyciem opcji „opis”, poniższy kod umożliwia wyświetlenie tekstu nr 1 z lokalnego menu.

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

Użycie w tagu <select>:

Poniższy kod ilustruje, w jaki sposób:

• wywołać łącze dynamiczne MyLink w przypadku Zmiany
• uzupełnić opcje zawartością pola MyMenuLocal
• automatycznie wybrać opcję odpowiadającą wartości pola MyField

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

Pole tokenu menu lokalnego lub token z listą wartości

Dodanie do tokena _DESCR umożliwia wybór opisu powiązanego z wartością tokena.

<!-- Wyświetla opis-->
<b adx='MyMenuLocal_descr'></b>
<!-- Wyświetla wartość (indeks)-->
<b adx='MyMenuLocal'></b>

Rodzaje tokenów

Poniżej lista różnych rodzajów tokenów udostępnionych przez XTEND:

Pole tokenu
Oznacza wartość pól danych

Token łącza
Uruchamia czynność użytkownika, taką jak na przykład tunel i/lub czynność sieciową i/lub wybór

Token sekcji
Umożliwia „dostęp do danych” (zapytanie) z iteracją na jednostkach czynności (rekordach).

Warunkowy token sekcji
Zarządza wyświetlaniem sekcji kodu HTML zgodnie z predefiniowanymi zasadami

Token specjalny
Specyficzny token, którego zachowanie nie może zostać ustawione

Token strony
Kod strony może zostać umieszczony w znaczniku <a adx='MyPage'></a> w celu przekierowania do strony bez konieczności tworzenia tokena łącza dynamicznego.