IBM Books

Guia de Referência do Net.Data

Variáveis Implícitas de Tabela

Essas variáveis são definidas por Net.Data e apenas reconhecidas em blocos REPORT e ROW, a menos que observado de outra maneira. Use essas variáveis para referenciar valores retornados de suas consultas.

N_columnName

Objetivo


AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

O nome da coluna especificada. Válido em blocos REPORT e ROW.

Exemplos

Exemplo 1: 

%REPORT{
<P>Envie e-mail para <a href="mailto:$(N_email)">$(N_name)</a>.
%}

Nn

Objetivo


AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

Contém o nome de coluna retornado por uma chamada de função ou consulta para a coluna n. Válido em blocos REPORT e ROW.

Exemplos

Exemplo 1: 

O nome da coluna 2 é $(N2).

Exemplo 2: Este exemplo mostra como você pode usar essa variável fora do bloco REPORT usando DTW_ASSIGN. Para obter mais informações, consulte DTW_ASSIGN. 

...
%ROW{
 @DTW_ASSIGN(col1, N1)
%}
 
%HTML(report){
@
Coluna 1 foi $(col1).
%}

Exemplo 3: 

%REPORT{
<H2>Direito do produto</H2>
<TABLE BORDER=1 CELLPADDING=3>
<TR><TD>$(N1)</TD><TD>$(N2)</TD><TD>$(N5)</TD>
%ROW{
<TR><TD>$(V1)</TD><TD>$(V2)</TD><TD>$(V3)</TD>
%}
</TABLE>
Encontrados $(ROW_NUM) modelos correspondendo sua descrição.
%}

NLIST

Objetivo


AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

Contém todos os nomes de coluna a partir do resultado de uma chamada de função ou consulta. O separador padrão é um nulo, o qual executa todos os nomes de coluna em conjunto, porém você pode especificar outro separador em uma instrução ou bloco DEFINE, com uma variável de lista, ou definir ALIGN="YES" para usar o caractere de espaço como um separador. Consulte ALIGN para mais informações.

Exemplos

Exemplo 1: A lista de nomes de coluna usa um espaço entre nomes de coluna com ALIGN definido em YES. 

%DEFINE ALIGN="YES"
%REPORT{
Sua consulta estava nessa colunas: $(NLIST).
%}

Exemplo 2: Este exemplo usa uma variável %LIST para alterar o separador para " | ". 

%DEFINE %LIST " | " NLIST
%REPORT{
Sua consulta estava nessa colunas: $(NLIST).
%}

NUM_COLUMNS

Objetivo


AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

O número de colunas retornado por uma chamada de função ou consulta.

Exemplos

Exemplo 1: 

%REPORT{
O resultado de sua consulta possui $(NUM_COLUMNS) colunas: $(NLIST).
%}

RETURN_CODE

Objetivo


AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

O código de retorno de uma chamada de função ou consulta. Net.Data usa esse valor para processar blocos MESSAGE. Você pode usar essa variável para determinar se uma chamada de função foi bem sucedida ou falhou. Um valor zero indica conclusão bem sucedida de uma chamada de função.

A variável RETURN_CODE pode ser encontrada nestes contextos:

Exemplos

Exemplo 1: O usuário da aplicação observa uma mensagem determinando se a função foi completada com sucesso. 

@function1()
%IF ("$(RETURN_CODE)" == "0")
A função foi completada com sucesso.
%ELSE
A função falhou com o código de retorno $(RETURN_CODE).
%ENDIF

Exemplo 2: Se uma função retornar um código de retorno diferente de 0, a mensagem padrão é exibida. 

%MESSAGE{
padrão: "<h2>Net.Data received return code: $(RETURN_CODE)</h2>" : continue
%}

ROW_NUM

Objetivo


AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

ROW_NUM é válida apenas dentro de um bloco ROW e é um contador que cresce até que a última linha seja processada. Por exemplo, caso haja 100 linhas em uma tabela, e você tem definido RPT_MAX_ROWS para 20, o valor final de ROW_NUM é 20 porque essa foi a última linha a processada.

Exemplos

Exemplo 1: 

%REPORT{
<TABLE BORDER=1>
<TR><TD> Número de Linhas </TD> <TD> Cliente </TD>
%ROW{
<TR><TD> $(ROW_NUM) </TD> <TD> $(V_custname) </TD>
%}
</TABLE>
%}

TOTAL_ROWS

Objetivo


AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT




X


O número total de linhas que uma consulta retorna, independente do valor de RPT_MAX_ROWS. Por exemplo, se RPT_MAX_ROWS está definido para exibir um máximo de 20 linhas, porém, ao invés disso, a consulta retorna 100 linhas, essa variável é definida para 100 após processamento de ROW. Você deve definir DTW_SET_TOTAL_ROWS para YES a fim de usar essa variável. Consulte DTW_SET_TOTAL_ROWS para mais informações.

Exemplos 

%DEFINE DTW_SET_TOTAL_ROWS="YES"
 
%REPORT{
<H2>Diretório do E-mail</H2>
<UL>
%ROW{
<LI>Name: <a href="mailto:$(V1)">$(V2)</a><BR>
Localização: $(V3)
%}
</UL>
Nomes exibidos: $(ROW_NUM)<BR>
Nomes encontrados: $(TOTAL_ROWS)
%}

V_columnName

Objetivo


AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

O valor para o nome de coluna especificado para a linha atual é apenas válido no bloco ROW. A variável não existe para nomes de coluna indefinidos. Uma consulta contendo dois nomes de coluna com o mesmo nome, apresenta resultados inesperados. Considere o uso de uma condição AS em seu SQL para renomear nomes de colunas duplicados.

Exemplos 

Você selecionou $(V_destcity).

Vn

Objetivo


AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

Contém valores de campo para cada linha retornada por uma chamada de função ou consulta SQL para campos 1 até n. Essa variável é reconhecida apenas em um bloco ROW. Para usá-la fora do bloco, consulte DTW_ASSIGN.

Exemplos

Exemplo 1: Este bloco REPORT exibe uma tabela HTML. A segunda coluna mostra o endereço de e-mail. Você pode enviar à pessoa uma mensagem, dando um clique no link. 

%REPORT{
<H2>E-mail directory</H2>
<TABLE BORDER=1 CELLPADDING=3>
<TR><TD>Name</TD><TD>E-mail address</TD><TD>Location</TD>
%ROW{
<TR><TD>$(V1)</TD>
<TD><a href="mailto:$(V2)">$(V2)</a></TD>
<TD>$(V3)</TD>
%}
</TABLE>
Encontrados $(ROW_NUM) modelos correspondendo sua descrição.
%}

VLIST

Objetivo


AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

Contem todos os valores de campo para a linha atual sendo processada em um bloco ROW e é apenas válida em um bloco ROW. O separador padrão é um nulo, o qual executa todos os valores em conjunto, porém você pode especificar outro separador em uma instrução ou bloco DEFINE, com uma variável de lista, ou definir ALIGN="YES" para usar o caractere de espaço como um separador. Consulte ALIGN para mais informações.

Os valores de campo para cada linha de uma tabela retornada por uma chamada de função ou consulta. O separador padrão é um espaço, porém pode-se especificar outro separador na instrução ou bloco DEFINE com uma variável de lista.

Exemplos

Exemplo 1: 

%DEFINE ALIGN="YES"
 
%REPORT{
Aqui estão os resultados de sua consulta:
<OL>
%ROW{
<LI>$(VLIST)
%}
</OL>
%}

Exemplo 2: Este exemplo usa uma variável LIST para alterar o separador para <P>. 

%DEFINE %LIST "<P>" VLIST
 
%REPORT{
Aqui estão os resultados de sua consulta:
%ROW{
<HR>$(VLIST)
%}
%}

[ Início da Página | Página Anterior | Próxima Página | Tabela de Conteúdos | Índice ]