Os tokens
Que é que é um token XTEND
Um token XTEND é um elemento de texto que se acrescenta uma página HTML para tornar o conteúdo dinâmico.
O token pode ser inseridos na página de duas maneiras diferentes :
- seja como um atributo de um tag HTML
<td adx="monChamp"></td> - seja como delimitador de uma parte do HTML
<!adx="monBlocConditionné">...Html...<!adx="monBlocConditionné">
A cada token está associado uma ficha de parametrizaação no diconário XTEND que permite controlar o seu comportamento
Por exemplo :
- um token de tipo campo inserido num tag <td> vai substituir o conteúdo da célula pelo valor do campo cujo formato é dado pela ficha de parametrização.
- um token de tipo "bloco condicionado" vai mascarar ou esconder a parte HTML que delimita em função de uma regra definida na ficha de parametrização.
Exemplo:
<!adx="ADISPUSERLOGGEDIN">
<!--Este bloco está afixado se o utilizador está conectado"-->
<!--AUSERCODE é um token de tipo "campo"-->
Você está conectado com o código utilizador <b adx="AUSERCODE"></b><br>
<!--ADLKLOGOUT é um token de tipo 'ligação dinâmica"-->
Para se desconectar clique <a adx="ADLKLOGOUT">ici</a>
<!adx="ADISPUSERLOGGEDIN">
Sintaxes dos tokens
Sintaxe de base
adx="myElement"
Você pode utilizar indeferentemente as minúsculas e as maiúsculas :
ADX="myelement", Adx="MYELEMENT", aDx="MyElEmEnT",…
Você não deve inserir espaços :
adx ="aaa", adx= "aaa", adx=" aaa " são interditos
Expressão de uma proveniência
adx="B1.MyField"
B1 chamada bloco de referência
Esta sintaxe permite exprimir a proveniência de uma informação.
Para tal, ela utiliza o ponto como separador.
No exemplo, MyField é um dados que provém do Bloco B1.
Esta sintaxe está descrita mais precisamente na documentação dos Tokens campos.
adx="B1(i).MyField"
Esta expressão permite de adereçar o campo MyField da í-ésima linha do bloco (i começa a 1)
adx="B1.MyTokenLink"
Esta expressão permite desencadear o token MyTokenLink em passando como parâmetro da ação os dados do bloco de referência B1. MyTokenLink pode designar por exemplo uma ação de paginação.
Acréscimo de parãmetros HTML
adx="myElement:param1=val1¶m2=val2¶m3"
Os parâmetros HTML são acrescentados na página HTML e vêm modificar o comportamento standard do token.
Você pode acrescentar os parâmetros:
- em os separando do código do elemento pelo caracter dois-pontos
- em os separando entre eles pelo caracter &
- em registando Nome do parãmetro = valor do parâmetro
Esta sintaxe está descrita mais precisamente na documentação dos Tokens campos.
Exemplos:
Modificação do formato de uma data:
<span adx="ATODAY:xformat=Dz:DD[ ]MMMMMMMMMM[ ]YYYY"></span>
Afixação de literais:
Se definimos o campo LIBMENULOCAL de tipo "menu local" com opção literal o código a seguir permite afixar o ou ao texto Nº1 do menu local.
<span adx="LIBMENULOCAL:xcaption=1"></span>
Utilização num tag <select> :
O código a seguir mostra como:
- Cahmar a ligação dinâmica MyLink sobre evento onChange
- preencher as opções com o conteúdo do campo MyMenuLocal
- selecionar automaticamente a opção que corresponde ao valor de MyField
<select name="MYNAME" adx="MyField:xonchange=MyLink&xfill=MyMenuLocal">...</select>
Tokens campo menu local ou com a lista de valor
O acréscimo de _DESCR ao código do token permite selecionar a descrição (literal) associado ao valor do token
<!-- Afixa o literal-->
<b adx="MyMenuLocal_descr"></b>
<!-- Afixa o valor (indice)-->
<b adx="MyMenuLocal"></b>
Os tipos de token
Eis a lista dos diferentes tipos de tokens que estão propostos por XTEND
Token campo
Representam os valores dos seus campos de dados
Token ligação
Desencadeia uma ação utilizador como um desligar e/ou uma ação web e/ou uma seleção
Token bloco
Efetua um "acesso aos dados" (pedido) com iteração sobre as entidades (registos) lidos '
Token bloco conditciona
Gere a afixação de blocos de código HTML em função de regras pré-definidas
Token especial
Tokens particulares cujo comportamente não está parametrizável.
Token página
Um código página pode ser inserido num tag <a adx="MyPage"></a> para efectuar um desligamento versus a página sem ter criado um token ligação dinâmica.