Desenvolvimento > Safe X3 WAS > Tokens > Blocos condicionados 

SEEWARNING Antes de criar o seu estabelecimento, é preferível ler a documentação :Antes de começar.


O "token" "Bloco condicionado" permite gerir uma afixação dinâmica do conteúdo das páginas HTML em função de critérios definidos por parametrização.
Por exemplo : modificar o conteúdo de um menu HTML em função do facto que o utilizador seja assinado ou não.
Para tal insere-se na página HTML o "token" "Bloco condicionado" como para o "Token" Blocos.

No momento da geração dinâmica da página o motor XTEND avalia a condição (expressão lógica) associada ao "token" :

  • Se a avaliação foi verificada : os "tokens" "filhos" do bloco ("tokens" delimitados pelo objecto e o fim do bloco" serão executados para gerir o HTML correspondente ao bloco.
  • Se a condição não foi verificada : os "tokens" "filhos" do bloco serão ignorados e o HTML não será afixado.

O princípio é o mesmo para um "token" que mascára o código HTML em vez de afixar.

O parâmetro HTML "xnot" indica que falta avaliar o inverso da condição : quer dizer mascarar o HTML em vez de o afixar :

<!--Blocos condicionados-->
<!adx="ADISPUSERLOGGEDIN">
<!--Código HTML afixado se o utilizador está assinado-->
<!adx="ADISPUSERLOGGEDIN">
<!--Blocos condicionados inverso-->
<!adx="ADISPUSERLOGGEDIN:xnot">
<!--Código HTML afixado se o utilizador não está registado-->
<!adx="ADISPUSERLOGGEDIN">

Pré-requisitos

SEEREFERTTO Consulte a docuemntação de Implementação

Gestão do ecrã

Cabeçalho

Campos

Os seguintes campos estão presentes neste separador :

Code du bloc conditionné

  • Estab. (campo FCYLIB)

Estabelecimento Web corrente.

  • Descr. (campo INTIT)

 

Fechar

 

Separador Geral

Campos

Os seguintes campos estão presentes neste separador :

Propried.

  • campo WA

 

  • Afixação bloco (campo WHNACT)

  • Assinalada, esta check box permite afixar o conteúdo do "token" bloco condicionado se a condição está verificada.

  • Senão, o conteúdo do "token" bloco condicionado está mascarado se a condição está verificada.

  • Tipos de critério (campo WHNTYP)

Tipo de critério para a condição de afixação/maquilhagem.
Os outros parãmetros são em função do tipo de critérios escolhidos :

Fórmula : a condição está verificada se a avaliação da fórmula está verdade.

Bloco vazio : a condição está verificada se o bloco está vazio.

Os "tokens" standards acima avaliam o bloco principal (AMAIN) da página :

  • ADISPMAINEMPTY : Afixa se o HTML se o bloco principal AMAIN está vazio.
  • AHIDEMAINEMPTY : Maquilha o HTML se o bloco principal AMAIN está vazio.

O token AHIDEMESSEMPTY mascara o código HTML se uma mensagem utilizador foi reenviado pelo web service.

Paginação de um bloco : Na condição está verificada se o número da página corrente do bloco é igual ao parãmetro registado :

Os "tokens" standards a seguir avaliam o bloco principal (AMAIN) da página.

  • AHIDEMAINFIRSTPAGE : Maquilha o HTML se o bloco AMAIN está sobre a 1ª página.
  • AHIDEMAINLASTPAGE : Maquilha o HTML se o bloco AMAIN está sobre a última página.

Ligação dinãmica utilizada : a condição está verificada se o código do "token" "ligação dinâmica" sobre o qual utilizador clicou para afixar a página está igual ao código registado.

Página precedente : a condição está verificada se o código da página origem que precede a página afixada é igual ao código da página registada.

Utilizador assinado : a condição está verificada se o utilizador está assinado.

Os "tokens" a seguir são entregues com o estabelecimento ASAMPLE.

  • ADISPUSERLOGGEDIN : Afixa o HTML se o utilizador está assinado.
  • AHIDEUSERLOGGEDIN : Maquilha o HTML se o utilizador está assinado.

Perfil : a condição está verificada se o utilizador está assinado e se o perfil XTEND deste utilizar está igual a um dos perfis da lista (5 máximo).

Vinheta vazia : a condição está verificada se a vinheta corrente ("Token" especial ASTAMP) está vazia.

Os "tokens" a seguir são entregues com o estabelecimento ASAMPLE.

  • ADISPSTAMPEMPTY : Afixa o HTML se a etiquita está vazia.
  • AHIDESTAMPEMPTY : Maquilha o HTML se a etiquita está vazia.

Linha selecionada : a condição está verificada se o bloco tem uma linha selecionada.

Os "tokens" standards a seguir avaliam o bloco principal (AMAIN) da página.

  • ADISPMAINSELECT : Afixa o HTML se o bloco principal AMAIN da página a uma linha selecionada.
  • AHIDEMAINSELECT : Maquilha o HTML se o bloco principal AMAIN da página a uma linha selecionada.

Página corrente : a condição está verificada se a página afixada é a página corrente quer dizer a mesma página que aquela ou o utilizador clicou.

Os "tokens" a seguir são entregues em standard :

  • ADISPSAMEPAGE : Afixa o HTML se é a mesma página que está afixada.
  • AHIDESAMEPAGE : Maquilha o HTML se é a mesma página que está afixada.

Autentificação com ou sem cookies : O "token" ADISPNOCOOKIES está reservado e afixa o HTML se o indicador foi desativado a utilização de cookies JSESSIONID para a autentificação da sessão via a ligação dinâmica ADLKSWITCHCOOKIES e a ação XTEND ASESSSWITCHCOOKIES.

<!adx="ADISPNOCOOKIES">
<input type="button" value="Autentificação com cookie" adx="ADLKSWITCHCOOKIES">   
<!adx="ADISPNOCOOKIES">
<!adx="ADISPNOCOOKIES:xnot">
<input type="button" value="Autentificação sem cookie" adx="ADLKSWITCHCOOKIES">
<!adx="ADISPNOCOOKIES">

Parâmetro HTML
Apenas o parâmetro xnot está aceite para inverter a condição.
Maquilhar ao lugar de afixar e inversamente.

Características

Código do bloco se o tipo de critérios está igual a : Bloco vazio, paginação de um bloco, linha selecionada.

  • Critério paginação (campo BLCPAG)

Este campo está registável se o tipo de critérios está a "Paginação de um bloco".

A condição está verificada se o número da página corrente do bloco é igual ao parãmetro registado :

  • Primeira página : o bloco está posicionado sobre a primeira página.

  • Última página : o bloco está posicionado sobre a última página.

  • Outra página : o bloco está posicionado sobre uma página que a primeria e última página.

Código da ligação dinâmica se o tipo de critérios é igual a "Última ligação dinâmica utilizada".

Código da página web se o tipo de critérios está igual à "Página precedente".

Perfis site Web

Códigos do perfil XTEND se o tipo de critérios está igual a "perfil":

Fechar

 

Separador Selecção

Apresentação

Fórmula

A condição foi verificada se a avaliação da fórmula é verdade.

O bloco Fórmula permite registar a expressão lógica a avaliar.

  • O operando Nº 1 é do tipo "MonBloc.MonChamp".
  • O registo do valor do operador Nº 2 é idêntico àquela dos critérios de selecção ou dos parâmetros das acções.

Fechar

 

Campos

Os seguintes campos estão presentes neste separador :

Síntese fórmula

  • campo RES50

 

Quadro Formula

  • E/Ou (campo ANDOR50)

Opérateur logique d'enchainement

  • ( (campo BRKLFTM50)

Parenthèse ouvrante

Code du bloc XTEND pour l'opérande N°1

La valeur de l'opérande N°1 est donnée par le code bloc et le code champ.

 

  • Campo (campo VFIEKEY50)

Code du camp XTEND pour l'opérande N°1.

La valeur de l'opérande N°1 est donnée par le code bloc et le code champ.

  • campo OPE50

Opérateur de comparaison

  • Origem (campo VALTYP50)

  • Constante: valor fixo registado na coluna seguinte.

  • "Token" campo : valor de um campo de um bloco cujos nomes são registados nas colunas seguintes.

  • Campo web: valor de um campo do formulário HTML cujo nome está registado na coluna seguinte.

  • Cste / Atrib. Web (campo VALEUR50)

Valeur de la constante ou nom (attribut 'Name')  du champ web

Code du bloc XTEND pour l'opérande N°2 si type 'champ xtend'.

La valeur de l'opérande N°2 est donnée par le code bloc et le code champ.

 

  • Campo (campo VFIEKEY50A)

Code du token champ pour l'opérande N°2 si type 'champ xtend'.

La valeur de l'opérande N°2 est donnée par le code bloc et le code champ.

  • ) (campo BRKRGTM50)

Parenthèse fermante

Fechar

 

Listagens

Por defeito, os seguintes listagens estão associados à função :

 PRTSCR : Impressão ecran

Mas pode ser alterado por parametrização.

Botões específicos

Este botão permite atualizar o dicionário XTEND ao formato XML

O servidor X3WEB toma em conta unicamente o dicionário sob este formato.

Existe um ficheiro xml por dicionário.

Por exemplo o ficheiro ACT.xml correspondente ao conjunto das ações web para o estabelecimento web corrente.

Este botão permite copiar um bloco condicionado.

Mensagens de erro

Não existe outra mensagem de erro, para além das mensagens genéricas.

Tabelas consideradas

SEEREFERTTO Consulte a docuemntação de Implementação