Essas variáveis auxiliam-no a personalizar seu relatório. Você deve definir essas variáveis antes de utilizá-las.
Objetivo
| AIX | HP-UX | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X | X | X | X | X |
Esta variável controla espaços à direita e à esquerda, usados com as variáveis de relatório NLIST e VLIST. O padrão é não haver espaços à direita e à esquerda, o qual é útil na incorporação de resultados de consulta em âncoras ou ação de formulário HTML. Se essa variável estiver definida para sim, as variáveis de relatório são preenchidas por espaços, então elas se alinham adequadamente quando se produzir um relatório.
Alternativamente, você pode especificar o espaço como um separador, para essas variáveis, em uma instrução LIST, como mostrado no Exemplo 2.
Exemplos
Exemplo 1: Uma vez que ALIGN esteja definida para YES, cada coluna na lista é separada por um espaço.
%DEFINE ALIGN="YES" <P>Sua consulta está em uma destas colunas: $(NLIST)
Exemplo 2: A saída desse exemplo é a mesma do exemplo Exemplo 1, porém o separador é indicado em uma instrução LIST. Consulte "Variáveis de Lista" para mais informações.
%DEFINE %LIST " " NLIST
%REPORT{
<P>Sua consulta está em uma destas colunas: $(NLIST)
%}
Objetivo
| AIX | HP-UX | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X |
| X | X | X |
Exibe HTML aos navegadores que não reconhecem a marcação APPLET.
Exemplos
Exemplo 1:
%DEFINE DTW_APPLET_ALTTEXT = "<P>Desculpe, seu navegodor não está permitido para java."
Objetivo
| AIX | HP-UX | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X | X | X | X | X |
Esta variável especial é usada para substituir o relatório padrão que Net.Data gera para funções que não possuem bloco REPORT. Você pode substituir esse comportamento definindo DTW_DEFAULT_REPORT para "NO", o que significa que funções sem blocos REPORT não exibem quaisquer resultados no navegador. Isto é útil, por exemplo, se você receber os resultados de uma chamada de função em uma variável de tabela e desejar passá-los a para uma função diferente processar.
Exemplos
Exemplo 1:
%DEFINE DTW_DEFAULT_REPORT="NO"
Objetivo
| AIX | HP-UX | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X | X | X | X | X |
Use esta variável para exibir resultados em uma tabela HTML ao invés de exibir a tabela em um formato do tipo texto (isto é, usando as marcações TABLE ao invés das marcações PRE). SIM exibe dados da tabela usando marcações de tabela HTML. A ação padrão é exibir dados de tabela em um formato de texto.
O marcador TABLE gerado inclui uma especificação de borda e de cellpadding:
<TABLE BORDER CELLPADDING=2>
Exemplos
Exemplo 1: Este exemplo mostra uma função SQL sem um bloco REPORT. Com DTW_HTML_TABLE definido para SIM, uma tabela HTML é gerada ao invés de uma tabela de formato de texto.
%DEFINE DTW_HTML_TABLE="YES"
%FUNCTION(DTW_SQL){
SELECT NOME, ENDEREÇO FROM $(qTable)
%}
Objetivo
| AIX | HP-UX | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X | X | X | X | X |
Use essa variável para especificar o texto para o cabeçalho do arquivo. Se a variável estiver definida para SIM, ou não estiver definida, Net.Data, por padrão, imprime "Tipo de conteúdo texto/html" para o texto do cabeçalho do arquivo. Se a variável DTW_PRINT_HEADER estiver definida para NO, você pode imprimir informações do cabeçalho HTML. Você deve ter essa variável definida antes que o Net.Data processe qualquer texto enviado ao navegador, uma vez que Net.Data lê essa variável uma vez antes de produzir texto e não a observa mais. Quaisquer alterações na variável DTW_PRINT_HEADER são ignoradas depois que Net.Data enviou texto ao navegador.
Um dos mais comuns usos dessa variável é ativar macros de Net.Data para enviar cookies. Para enviar um cookies, a variável DTW_PRINT_HEADER deve ser definida para NO, e as primeiras três linhas devem ser o cabeçalho do Tipo-conteúdo, a instrução Definir-Cookie, e uma linha em branco.
Exemplos
Exemplo 1:
%DEFINE DTW_PRINT_HEADER="NO"
%HTML(cookie1) {
Content-type: text/html
Set-Cookie: UsrId=56, expires=Friday, 12-Dec-99, 12:00:00 GMT; path=/
<P>
Qualquer texto
%}
Objetivo
| AIX | HP-UX | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
|
|
|
|
| X |
|
|
|
Você deve definir DTW_SET_TOTAL_ROWS para YES para usar TOTAL_ROWS. Caso essa variável não esteja definida, o valor padrão é para definir a variável TOTAL_ROWS. Definindo DTW_SET_TOTAL_ROWS para YES afeta o desempenho, porque para se determinar as linhas totais, o ambiente da linguagem do banco de dados requer que todas as linhas sejam recuperadas.
Exemplos
Exemplo 1:
%DEFINE DTW_SET_TOTAL_ROWS="YES" <P>$(ROW_NUM) retornado. Sua consulta está limitada em $(TOTAL_ROWS) rows.
Objetivo
| AIX | HP-UX | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X | X | X | X | X |
Especifique o número máximo de linhas que um relatório exibe. O padrão é para retornar todas as linhas que a tabela contém. Definindo essa variável em 0 ou TODAS também todas as linhas serão exibidas.
Exemplos
O primeiro exemplo mostra como definir a variável em uma instrução DEFINE. O segundo exemplo mostra como usar a entrada HTML para definir a variável com um formulário HTML.
Exemplo 1: Este limita o número de linhas, que qualquer função retorna, para 20 linhas.
%DEFINE RPT_MAX_ROWS="20"
Exemplo 2: Essas linhas podem ser colocadas em um marcador FORM a fim de permitir que o usuário da aplicação defina o número de linhas que ele deseja da consulta.
Linhas máximas a retornar (0 a nenhum limite): <INPUT TYPE="text" NAME="RPT_MAX_ROWS" SIZE=3>
Objetivo
| AIX | HP-UX | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X |
| X |
| X | X |
Este variável definir o número de linha a iniciar a exibição dos resultados de uma consulta. Usando esta variável, juntamente com RPT_MAX_ROWS, você pode partir consultas com tabelas de resultados grandes em conjuntos menores, e usar um botão Próximo para navegar através da tabela de resultados.
START_ROW_NUM pode ser usado apenas para bancos de dados quando acessados através da Conexão Ao Vivo, exceto na plataforma OS/400.