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.
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>
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>
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>
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 | & | & |
| Aspas duplas | " | " |
| Maior que | > | > |
| Menos que | < | < |
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.
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>
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>
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">
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:
|
| 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>
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>
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:
|
| 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>
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>