Guia de Referência do Net.Data

Instrução IF HTML

Objetivo

A instrução IF HTML executa o processamento condicional de cadeia e é utilizada na parte HTML da macro Net.Data. A instrução IF HTML pode ser utilizada no bloco HTML, no bloco REPORT e no bloco ROW. Os valores numéricos são tratados como cadeias para as comparações.

Sintaxe

                                +---------------------------+
                                V                           |
>>-%if--| lista de condição |-----+------------------------++--->
                                  +-instrução exec_sql-----+
                                  +-variável de referência-+
                                  +-chamada de função------+
                                  +-cadeia-----------------+
                                  +-instrução HTML---------+

>--| else_if spec |--%endif------------------------------------><

lista de condição

|--(--+-(--lista de condição--)-------------------+-)----------|
      +-lista de condição--&&--lista de condição--+
      +-lista de condição--||--lista de condição--+
      +-!--lista de condição----------------------+
      +-| condição |------------------------------+
      +-| termo |---------------------------------+

condição

|--termo--+-<--+-termo-----------------------------------------|
          +->--+
          +-<=-+
          +->=-+
          +-!=-+
          +-==-+

termo

|--+-variável de referência-+----------------------------------|
   +-"--cadeia--"-----------+
   +-nome da variável-------+

else_if spec

|--+--------------------------------------------------------------------+->
   |    +-----------------------------------------------------------+   |
   |    |                             +---------------------------+ |   |
   |    V                             V                           | |   |
   +--+--%elif--(--lista_condição--)----+------------------------++-+-+-+
      |                                 +-instrução exec_sql-----+    |
      |                                 +-variável de referência-+    |
      |                                 +-chamada de função------+    |
      |                                 +-cadeia-----------------+    |
      |                                 +-instrução HTML---------+    |
      |        +---------------------------+                          |
      |        V                           |                          |
      +-%else----+------------------------++--------------------------+
                 +-instrução exec_sql-----+
                 +-variável de referência-+
                 +-chamada de função------+
                 +-cadeia-----------------+
                 +-instrução HTML---------+

>--------------------------------------------------------------|

Parâmetros

%if

A palavra-chave que especifica processamento condicional de cadeias. Os valores numéricos são tratados como cadeias para as comparações.

lista de condição:

lista de condição

Compara valores e valores de variáveis. A lista pode conter condições e termos. As listas de condição podem ser conectadas através da utilização de operadores booleanos. Uma lista de condição pode ser encadeada dentro de outra lista de condição.

condição

Uma comparação entre dois termos utilizando operadores de comparação. O Net.Data compara somente cadeias; uma variável ou uma cadeia representando um valor numérico é avaliada como uma cadeia de caracteres, não como um valor numérico.

termo

Um nome de variável, cadeia ou referência de variável.

instrução exec_sql

Um elemento de linguagem do DB2WWW Release 1 aceito devido a sua compatibilidade. Consulte Apêndice A. "DB2 WWW Connection" ou a documentação do DB2 World Wide Web Release 1.

referência de variável

Retorna o valor de uma variável anteriormente definida e é especificada com $ e (). Por exemplo: se VAR = 'abc', então $(VAR) retorna o valor 'abc'. Consulte a seção Referência de Variável para obter informações sobre sintaxe.

chamada de função

Invoca um ou mais blocos %FUNCTION previamente definidos com argumentos especificados. Consulte Chamada de função (@) para obter a sintaxe e exemplos.

cadeia

Qualquer seqüência de caracteres alfabéticos e numéricos e pontuação exceto um tabulador, caractere de linha nova ou um espaço.

instrução HTML

Inclui qualquer caractere alfabético ou numérico e tags HTML a serem formatadas pelo navegador do cliente.

%elif

Uma palavra-chave que inicia o caminho de processamento alternativo e pode conter listas de condição e a maioria das instruções da macro Net.Data.

%endif

Palavra-chave que fecha o bloco %IF.

%else

Palavra-chave que executa instruções associadas caso todas as outras listas de condição não esteja satisfeitas.

Contexto

Pode ser encontrado nestes contextos:

• Bloco HTML
• Bloco REPORT
• Bloco ROW

Restrições

Pode conter estes elementos:

• instrução EXEC_SQL
• cadeias
• instruções HTML
• Chamadas de função
• Referências de variável

Exemplos

Exemplo 1:

%IF ($RETURN_CODE) == $(failure_rc))
   <P> Falha na chamada de função com código de falha $(RETURN_CODE).
%ELIF ($(RETURN_CODE) == $(warning_rc))
   <P> A chamada de função obteve sucesso com código de aviso $(RETURN_CODE).
%ELIF ($(RETURN_CODE) == $(success_rc))
   <P>A chamada de função obteve sucesso.
%ELSE
   P>A chamada de função retornou com um código de retorno desconhecido $(RETURN_CODE).
%ENDIF

Exemplo 2:

%IF (nome == "mundo!")
<H2>Olá mundo!</H2>
%ENDIF