IBM Books

Guia de Referência do Net.Data


Funções de Tabela

Estas funções funções simplificam o trabalho com tabelas do Net.Data e são mais eficientes do que escrever suas próprias funções utilizando REXX, C ou PERL. Todas estas funções são utilizadas no exemplo de macro tbtest.mac, que vem com o pacote de ferramentas do Net.Data.

DTW_TB_DLIST

Objetivo


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

Retorna uma lista de definições HTML a partir de uma tabela macro.

Sintaxe

Parâmetros

Tabela 40. Parâmetros DTW_TB_DLIST
Tipo de Dados Parâmetro Uso Descrição
arranjo tabela IN Símbolo especificando a variável de tabela macro para saída como uma lista de definições HTML.
inteiro termo IN O número da coluna na tabela contendo valores de nome de termo (o texto que vem após a tag <DT>). O padrão é para usar a primeira coluna.
inteiro def IN O número de coluna na tabela contendo os valores de definição de termo (o texto que vem após a tag <DD>). O padrão é usar a segunda coluna.
cadeia estilotermo IN Variável ou cadeia literal contendo uma lista dos elementos HTML para os valores do nome do termo. O padrão é não utilizar tags de estilo.
cadeia estilodef IN Variável ou cadeia literal contendo uma lista dos elementos HTML para os valores de definição do termo. O padrão é não utilizar tags de estilo.
cadeia âncora IN Especifica para quais elementos HTML uma referência de âncora é gerada. Os valores válidos são DT e DD. O padrão é não gerar referências de âncora.
inteiro anchor_u IN O número de coluna na tabela que contém as URLs para as referências de âncora. O padrão é não gerar referências de âncora.
cadeia imagem IN Especifica para quais elementos HTML uma imagem inline é gerada. Os valores válidos são DT e DD. O padrão é não gerar imagens inline.
inteiro image_u IN O número de coluna na tabela que contém as URLs para as imagens inline. O padrão é não gerar imagens inline.

Exemplos

@DTW_TB_DLIST(Minhatabela,"3","4","b i","strong","DD","2","DT","1")
@DTW_TB_DLIST(Minhatabela,"","4","b","strong","DT","2","DT","1")
@DTW_TB_DLIST(Minhatabela,"3","4","","","DT","2")
@DTW_TB_DLIST(Minhatabela,"","","i","b","DD","2","DT","1")
@DTW_TB_DLIST(Minhatabela,"","3","","","DD","2","DT","1")
@DTW_TB_DLIST(Minhatabela,"3","4","EM","B U I","DT","2","DT","1")
@DTW_TB_DLIST(Minhatabela,"","4","","","DD","2","DT","1")
@DTW_TB_DLIST(Minhatabela,"3","","I","I","DT","2","DD","1")

Exemplo 1: O HTML gerado para este primeiro exemplo tem um aspecto semelhante a este, dependendo dos dados da tabela.

<DL>
<DT>
<IMG SRC="http://www.mycompany.com/images/image1.gif" ALT=""><b><i>image1text</i></b>
<DD>
<A HREF="http://www.mycompany.com/anchor1.html"><strong>anchor1text</strong></A>
<DT>
<IMG SRC="http://www.mycompany.com/images/image2.gif" ALT=""><b><i>image2text</i></b>
<DD>
<A HREF="http://www.mycompany.com/anchor2.html"><strong>anchor2text</strong></A>
<DT>
<IMG SRC="http://www.mycompany.com/images/image3.gif" ALT=""><b><i>image3text</i></b>
<DD>
<A HREF="http://www.mycompany.com/anchor3.html"><strong>anchor3text</strong></A>
<DT>
<IMG SRC="http://www.mycompany.com/images/image4.gif" ALT=""><b><i>image4text</i></b>
<DD>
<A HREF="http://www.mycompany.com/anchor4.html"><strong>anchor4text</strong></A>
</DT>
</DL>

DTW_TB_DUMPH

Objetivo


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

Retorna o conteúdo de uma variável de tabela macro. Cada linha da tabela é exibida em uma linha diferente. A tabela inteira está entre tags <PRE></PRE>.

Sintaxe

Parâmetros

Tabela 41. Parâmetros DTW_TB_DUMPH
Tipo de Dados Parâmetro Uso Descrição
arranjo tabela IN Símbolo especificando a variável de tabela macro para saída.

Exemplos

Exemplo 1:

@DTW_TB_DUMPH(Minhatabela)

O HTML gerado por esse exemplo tem o seguinte aspecto:

<PRE>
Nome             Departamento            Posição
Jack Smith       Tecnologia Internet     Engenheiro de Software
Helen Williams   Banco de Dados          Gerente de Desenvolvimento
Alex Jones       Manutenção              Engenheiro Industrial
Tom Baker        Comercial               Repres. de Vendas
</PRE>

DTW_TB_DUMPV

Objetivo


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

Retorna o conteúdo de uma variável de tabela macro. Cada linha se encontra em uma linha diferente. A tabela inteira está entre tags <PRE></PRE>.

Sintaxe

Parâmetros

Tabela 42. Parâmetros DTW_TB_DUMPV
Tipo de Dados Parâmetro Uso Descrição
arranjo tabela IN Símbolo especificando a variável de tabela macro para saída.

Exemplos

Exemplo 1:

@DTW_TB_DUMPV(Minhatabela)
O HTML gerado por esse exemplo tem o seguinte aspecto:
<PRE>
http://www.mycompany.com/images/image1.gif
http://www.mycompany.com/anchor1.html
image1text
anchor1text
http://www.mycompany.com/images/image2.gif
http://www.mycompany.com/anchor2.html
image2text
anchor2text
http://www.mycompany.com/images/image3.gif
http://www.mycompany.com/anchor3.html
image3text
anchor3text
http://www.mycompany.com/images/image4.gif
http://www.mycompany.com/anchor4.html
image4text
anchor4text
</PRE>

DTW_TB_HTMLENCODE

Objetivo


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

Retorna a tabela macro de entrada com estes caracteres HTML codificados:
"e" comercial & &#38;
Aspas duplas " &#34;
Maior que > &#62;
Menos que < &#60;

Sintaxe

Parâmetros

Tabela 43. Parâmetros DTW_TB_HTMLENCODE
Tipo de Dados Parâmetro Uso Descrição
arranjo tabela INOUT A variável de tabela macro a ser modificada.
cadeia listacol IN Os números de coluna na tabela a serem codificados. O padrão é codificar todas as colunas.

Exemplos

Exemplo 1:

@DTW_TB_HTMLENCODE(Minhatabela, "3 4")
Os caracteres especiais nas colunas 3 e 4 da tabela especificada são substituídos por seus formatos codificados.

DTW_TB_INPUT_CHECKBOX

Objetivo


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

Retorna um ou mais tags de entrada do quadro de verificação HTML a partir de uma variável de tabela macro.

Sintaxe

Parâmetros

Tabela 44. Parâmetros DTW_TB_INPUT_CHECKBOX
Tipo de Dados Parâmetro Uso Descrição
arranjo tabela IN Variável de tabela macro a ser exibida como tags de entrada do quadro de verificação.
cadeia prompt IN O número de coluna na tabela ou uma cadeia contendo o texto a ser exibido ao lado do quadro de verificação. Este parâmetro é necessário, porém pode ter uma valor nulo (""). Quando nulo, o valor utilizado é o valor definido para colnome.
cadeia colnome IN O número de coluna na tabela ou uma cadeia contendo os nomes dos campos de entrada.
cadeia colvalor IN O número de coluna na tabela ou uma cadeia contendo os valores dos campos de entrada. O padrão é 1.
cadeia linhas IN A lista de linhas na tabela a partir da qual se gera os campos de entrada. O padrão é utilizar todas as linhas.
inteiro linhasverif IN A lista de linhas especificando quais linhas da tabela devem ser assinaladas. O padrão é não assinalar campos.

Exemplos

@DTW_TB_INPUT_CHECKBOX(Minhatabela,"","5")
@DTW_TB_INPUT_CHECKBOX(Minhatabela,"3","5")
@DTW_TB_INPUT_CHECKBOX(Minhatabela,"3","5","4")
@DTW_TB_INPUT_CHECKBOX(Minhatabela,"3","5","","2 5")
@DTW_TB_INPUT_CHECKBOX(Minhatabela,"3","4","","2 3 4","1 3 4")

O HTML gerado para o último exemplo tem o seguinte aspecto:

<INPUT TYPE="CHECKBOX" NAME="anchor2text" VALUE="1">image2text<BR>
<INPUT TYPE="CHECKBOX" NAME="anchor3text" VALUE="1" CHECKED>image3text<BR>
<INPUT TYPE="CHECKBOX" NAME="anchor4text" VALUE="1" CHECKED>image4text<BR>

DTW_TB_INPUT_RADIO

Objetivo


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

Retorna um ou mais tags de entrada de opção HTML a partir de uma variável de tabela macro.

Sintaxe

Parâmetros

Tabela 45. Parâmetros DTW_TB_INPUT_RADIO
Tipo de Dados Parâmetro Uso Descrição
arranjo tabela IN A variável de tabela macro a ser exibida como tags de entrada de opção.
cadeia prompt IN O número de coluna na tabela ou uma cadeia contendo o texto a ser exibido ao lado do botão de opção. Este parâmetro é necessário, porém pode ter uma valor nulo (""). Quando nulo, utiliza o valor de colvalor.
cadeia colnome IN O número de coluna na tabela ou uma cadeia contendo os nomes dos campos de entrada.
cadeia colvalor IN O número de coluna na tabela ou uma cadeia contendo os valores dos campos de entrada.
cadeia linhas IN A lista de linhas na tabela a partir da qual se gera os campos de entrada. O padrão é utilizar todas as linhas.
inteiro linhasassinal IN O número de linha na tabela para exibir o botão de opção correspondente conforme assinalado. Somente um valor é permitido.

Exemplos

@DTW_TB_INPUT_RADIO(Minhatabela,"","Opção1","5")
@DTW_TB_INPUT_RADIO(Minhatabela,"3","Opção2","3")
@DTW_TB_INPUT_RADIO(Minhatabela,"3","Opção3","4")
@DTW_TB_INPUT_RADIO(Minhatabela,"3","Opção4","4","2 3 4","4")

O HTML gerado para o último exemplo se parecerá como isso:

<INPUT TYPE="RADIO" NAME="Radio4" VALUE="anchor2text">image2text<BR>
<INPUT TYPE="RADIO" NAME="Radio4" VALUE="anchor3text">image3text<BR>
<INPUT TYPE="RADIO" NAME="Radio4" VALUE="anchor4text" CHECKED>image4text<BR>

DTW_TB_INPUT_TEXT

Objetivo


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

Retorna um ou mais tags de texto de entrada a partir de uma variável TABLE da macro Net.Data.

Sintaxe

Parâmetros

Tabela 46. Parâmetros DTW_TB_INPUT_TEXT
Tipo de Dados Parâmetro Uso Descrição
arranjo tabela IN A variável TABLE da macro a ser exibida como tags de entrada de texto.
cadeia prompt IN O número de coluna na tabela ou uma cadeia contendo o texto a ser exibido ao lado do campo de entrada. Se um valor nulo ("") for exibido, nenhum texto será exibido.
cadeia colnome IN O número de coluna na tabela ou uma cadeia contendo os nomes dos campos de entrada.
cadeia colvalor IN O número de coluna na tabela ou uma cadeia contendo os valores padrões dos campos de entrada, que são especificados para o atributo VALUE. O padrão é não gerar o valor do atributo VALUE.
inteiro tamanho IN O número de caracteres do campo de entrada, que é especificado para o atributo SIZE. O padrão é o tamanho do valor de entrada padrão mais extenso, ou 10 caso não haja uma entrada padrão.
inteiro compmax IN O comprimento máximo de uma cadeia de entrada, que é especificado para o atributo MAXLEN. O padrão é não gerar o valor do atributo MAXLENGTH.
inteiro linhas IN A lista de linhas na tabela a partir da qual se gera os campos de entrada. O padrão é utilizar todas as linhas.

Exemplos

@DTW_TB_INPUT_TEXT(Minhatabela,"","5")
@DTW_TB_INPUT_TEXT(Minhatabela,"","5","4")
@DTW_TB_INPUT_TEXT(Minhatabela,"Enter
title:","5","4")
@DTW_TB_INPUT_TEXT(Minhatabela,"3","5","4")
@DTW_TB_INPUT_TEXT(Minhatabela,"3","5","4","30")
@DTW_TB_INPUT_TEXT(Minhatabela,"3","5","4","35","40")
@DTW_TB_INPUT_TEXT(Minhatabela,"3","3","4","35","40","1
2 3")

O HTML gerado para o último exemplo se parecerá como isso:

<P>image1text
<INPUT TYPE="TEXT" NAME="image1text" VALUE="anchor1text" SIZE="35" MAXLENGTH="40">
<P>image2text
<INPUT TYPE="TEXT" NAME="image2text" VALUE="anchor2text" SIZE="35" MAXLENGTH="40">
<P>image3text
<INPUT TYPE="TEXT" NAME="image3text" VALUE="anchor3text" SIZE="35" MAXLENGTH="40">

DTW_TB_LIST

Objetivo


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

Retorna uma lista HTML.

Sintaxe

Parâmetros

Tabela 47. Parâmetros DTW_TB_LIST
Tipo de Dados Parâmetro Uso Descrição
arranjo tabela IN Símbolo especificando a variável de tabela macro para saída como uma lista HTML.
cadeia tipolista IN O tipo de lista a ser gerado. Os valores aceitáveis são:

  • DIR

  • MENU

  • OL

  • UL
inteiro itemlista IN O número de coluna na tabela contendo os valores da lista (o texto que vem após a tag <LI>). O padrão é usar a primeira coluna.
cadeia estiloitem IN Variável ou cadeia literal contendo uma lista dos elementos HTML para os valores do nome do termo. O padrão é não utilizar tags de estilo.
inteiro anchor_u IN O número de coluna na tabela que contém as URLs para as referências de âncora. Se este valor não for especificado, nenhuma referência de âncora será gerada.
inteiro image_u IN O número de coluna na tabela que contém as URLs para as imagens inline. Se este valor não for especificado, nenhuma imagem inline será gerada.

Exemplos

@DTW_TB_LIST(Minhatabela,"MENU")
@DTW_TB_LIST(Minhatabela,"MENU","3")
@DTW_TB_LIST(Minhatabela,"UL","3","","2")
@DTW_TB_LIST(Minhatabela,"UL","4","B","2","1")
@DTW_TB_LIST(Minhatabela,"DIR","3","b i")
@DTW_TB_LIST(Minhatabela,"OL","4","TT", "U","2","1")

O HTML gerado para o último exemplo se parecerá como isso:

<TT><U>
<OL>
<LI><A HREF="http://www.mycompany.com/anchor1.html">
<IMG SRC="http://www.mycompany.com/images/image1.gif" ALT="">anchor1text</A>
<LI><A HREF="http://www.mycompany.com/anchor2.html">
<IMG SRC="http://www.mycompany.com/images/image2.gif" ALT="">anchor2text</A>
<LI><A HREF="http://www.mycompany.com/anchor3.html">
<IMG SRC="http://www.mycompany.com/images/image3.gif" ALT="">anchor3text</A>
<LI><A HREF="http://www.mycompany.com/anchor4.html">
<IMG SRC="http://www.mycompany.com/images/image4.gif" ALT="">anchor4txt</A>
</OL>
</U></TT>

DTW_TB_SELECT

Objetivo


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

Retorna um menu SELECT HTML.

Sintaxe

Parâmetros

Tabela 48. Parâmetros DTW_TB_SELECT
Tipo de Dados Parâmetro Uso Descrição
arranjo tabela IN A variável de tabela macro a ser exibida como campo SELECT.
cadeia nome IN O valor do atributo NAME do campo SELECT.
inteiro colopção IN O número de coluna na tabela com valores a serem utilizados nos tags OPTION do campo SELECT. O padrão é usar a primeira coluna.
inteiro tamanho IN O número de linhas na tabela a ser utilizado para tags OPTION no campo SELECT. O padrão é usar todas as linhas.
cadeia múltiplo IN Especifica se seleções múltiplas são permitidas. O padrão é N, que não permite seleções múltiplas.
cadeia linhasselec IN As linhas da tabela a serem utilizadas no campo select. O padrão é usar todas as linhas.
cadeia linhas IN A lista de linhas da tabela cujas tags OPTION estão assinaladas. Para especificar mais de uma linha, o parâmetro múltiplo deve estar definido como Y. O padrão é selecionar o primeiro item.

Exemplos

@DTW_TB_SELECT(Minhatabela,"URL0")
@DTW_TB_SELECT(Minhatabela,"URL1","3")
@DTW_TB_SELECT(Minhatabela,"URL1","3","9")
@DTW_TB_SELECT(Minhatabela,"URL3","3","","y")
@DTW_TB_SELECT(Minhatabela,"URL4","2","3","y","2
4")
@DTW_TB_SELECT(Minhatabela,"URL5","3","","y","","2 5")
@DTW_TB_SELECT(Minhatabela,"URL6","3","","y","1
2 4","1 4")

O HTML gerado para o último exemplo se parecerá como isso:

<SELECT NAME="URL6" SIZE="3" MULTIPLE>
<OPTION SELECTED>image1text
<OPTION>image2text
<OPTION>image4text
</SELECT>

DTW_TB_TABLE

Objetivo


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

Retorna uma tabela HTML de uma variável de tabela macro.

Sintaxe

Parâmetros

Tabela 49. Parâmetros DTW_TB_TABLE
Tipo de Dados Parâmetro Uso Descrição
arranjo tabela IN Uma variável de tabela macro para sair como uma tabela HTML.
cadeia opções IN Os atributos de tabela dentro da tag TABLE. O padrão é não utilizar nenhum atributo. Os valores válidos são:

  • BORDER

  • CELLSPACING

  • WIDTH
cadeia listacol IN Os números de coluna na tabela a serem utilizados na tabela HTML. O padrão é utilizar todas as colunas.
cadeia estilocel IN Uma lista de elementos de estilo HTML, tais como B e I, para serem colocados ao redor do texto em cada tag TD. O padrão é não utilizar tags de estilo.
inteiro anchor_u IN O número de coluna na tabela contendo URLs utilizadas para criar referências âncoras. Também é necessário especificar a coluna na listacol. O padrão é não gerar tags de referências âncora.
inteiro image_u IN O número de coluna na tabela contendo URLs utilizadas para criar imagens inline. Também é necessário especificar a coluna na listacol. O padrão é não gerar tags de imagem.
inteiro url_text IN O número de coluna na tabela contendo texto para exibição para referências âncora ou imagens inline. O padrão é utilizar a própria URL.
cadeia url_style IN Uma lista de elementos de estilo HTML para o texto especificado em url_text. O padrão é não gerar tags de estilo.

Exemplos

@DTW_TB_TABLE(Minhatabela,"BORDER","4 2 1","i","2","1","4","b")
@DTW_TB_TABLE(Minhatabela)
@DTW_TB_TABLE(Minhatabela,"BORDER")
@DTW_TB_TABLE(Minhatabela,"","3
4")
@DTW_TB_TABLE(Minhatabela,"BORDER","2 3 4","em")

O HTML gerado para o primeiro exemplo parece como isso:

<TABLE BORDER>
<TR>
<TH>TITLE
<TH>ANCHORURL
<TH>IMAGEURL
<TR>
<TD><i>anchor1text</i>
<TD><A HREF="http://www.mycompany.com/anchor1.html"><b>anchor1text</b></A>
<TD><IMG SRC="http://www.mycompany.com/images/image1.gif" ALT=""><b>anchor1text</b>
<TR>
<TD><i>anchor2text</i>
<TD><A HREF="http://www.mycompany.com/anchor2.html"><b>anchor2text</b></A>
<TD><IMG SRC="http://www.mycompany.com/images/image2.gif" ALT=""><b>anchor2text</b>
<TR>
<TD><i>anchor3text</i>
<TD><A HREF="http://www.mycompany.com/anchor3.html"><b>anchor3text</b></A>
<TD><IMG SRC="http://www.mycompany.com/images/image3.gif" ALT=""><b>anchor3text</b>
</TABLE>

DTW_TB_TEXTAREA

Objetivo


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

Retorna tags TEXTAREA HTML de uma variável de tabela macro.

Sintaxe

Parâmetros

Tabela 50. Parâmetros DTW_TB_TEXTAREA
Tipo de Dados Parâmetro Uso Descrição
arranjo tabela IN Uma variável de tabela macro para ser exibida como uma tag TEXTAREA
cadeia nome IN O nome da área de texto.
inteiro númlinhas IN O número de linhas a serem exibidas. O padrão é o número de linhas na tabela.
inteiro númcol IN O número de colunas a serem exibidas. O padrão é o comprimento da linha mais extensa na tabela.
inteiro colvalor IN O número de colunas na tabela cujos valores são exibidos na área de texto. O padrão é a primeira coluna.
cadeia linhas IN Uma lista de linhas na tabela utilizada para gerar o tag TEXTAREA. O padrão é utilizar todas as linhas.

Exemplos

@DTW_TB_TEXTAREA(Minhatabela,"áreatexto1")
@DTW_TB_TEXTAREA(Minhatabela,"áreatexto2","3")
@DTW_TB_TEXTAREA(Minhatabela,"áreatexto3","3","40")
@DTW_TB_TEXTAREA(Minhatabela,"áreatexto4","2","80","3")
@DTW_TB_TEXTAREA(Minhatabela,"áreatexto5","3","70","4","1 3 4")

O HTML gerado para o último exemplo se parecerá como isso:

<TEXTAREA NAME="textarea5" ROWS="3" COLS="70">
anchor1text
anchor3text
anchor4text
<TEXTAREA>


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