Guia de Referência do Net.Data

Bloco REPORT

Objetivo

O bloco REPORT formata a saída de uma chamada de função. Ele pode possuir um nome de tabela como um parâmetro. Caso um nome de tabela seja especificado, o relatório é gerado usando os dados na tabela especificada. Caso contrário, o relatório é gerado com a utilização da primeira tabela de saída encontrada na lista de parâmetros de função ou caso não exista nenhuma tabela na lista de parâmetros, os dados da tabela padrão são utilizados.

Sintaxe

>>-%report---+-------------+------------------------------------>
             +-(--Nome--)--+

      +---------------------------+                +---------------------------+
      V                           |                V                           |
>--{----+------------------------++--+-----------+---+------------------------++--%}--><
        +-cadeia-----------------+   +-Bloco row-+   +-cadeia-----------------+
        +-bloco if HTML----------+                   +-bloco if HTML----------+
        +-variável de referência-+                   +-variável de referência-+
        +-chamada de função------+                   +-chamada de função------+
        +-Instruções HTML--------+                   +-Instruções HTML--------+
        +-instrução include------+                   +-instrução include------+
        +-instrução include_url--+                   +-instrução include_url--+

Parâmetros

%report

Palavra-chave para especificação de instruções de formatação para a saída de uma chamada de função. Informações de cabeçalho e rodapé podem ser utilizadas para o relatório.

nome

Uma cadeia alfabética ou numérica começando com um caractere alfabético ou sublinhado e contendo qualquer combinação de caracteres alfabéticos, numéricos ou sublinhado.

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.

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. O bloco REPORT não pode conter chamadas de função que sejam chamadas de função SQL, exceto na plataforma OS/400.

bloco if HTML

O bloco IF HTML utilizado na parte HTML da macro Net.Data. Executa processamento de cadeia condicional. Os valores numéricos são tratados como cadeias para as comparações. Consulte Instrução IF HTML para obter a sintaxe e exemplos.

instruções HTML

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

instrução include

A instrução INCLUDE lê e incorpora um arquivo dentro da macro Net.Data. Consulte Instrução INCLUDE para obter a sintaxe e exemplos.

instrução include_url

A instrução INCLUDE_URL. Lê e incorpora outro arquivo dentro da macro Net.Data onde a instrução está especificada. O arquivo especificado pode existir em um servidor local ou remoto. Consulte Instrução INCLUDE_URL para obter a sintaxe e exemplos.

bloco row

O bloco ROW. Exibe dados formatados HTML uma vez para cada linha de dados retornados de uma chamada de função. Consulte Bloco ROW para obter a sintaxe e exemplos.

Contexto

Pode ser encontrado nestes contextos:

• Instrução ou bloco SQL
• Instrução ou bloco FUNCTION

Restrições

Pode conter estes elementos:

• Bloco IF HTML
• Instruções INCLUDE
• Instruções INCLUDE_URL
• Blocos ROW
• Chamadas de função

  Exceção: Funções SQL não podem ser chamadas de dentro das funções SQL.

• Instruções HTML
• Cadeias
• Referências de variável

Exemplos

Exemplo 1: Uma tabela HTML de 2 colunas mostra uma lista de nomes e localizações. A seleção de um nome na tabela chamará o bloco HTML de detalhes da macro Net.Data name.mac e enviará a ele os dois valores como parte da URL. Neste exemplo, os valores podem ser utilizados em name.mac para ver detalhes adicionais sobre o nome.

%REPORT{
<H2>Resultados da Consulta</H2>
<P>Selecione um nome para obter detalhes.
<TABLE BORDER=1>
<TR><TD>Nome</TD><TD>Local</TD>
%ROW{
<TR>
<TD>
<a href="/cgi-bin/db2www/name.mac/details?name=$(V1)&location=$(V2)">$(V1)</a></TD>
<TD>$(V2)</TD>
%}
</TABLE>
%}