Guia de Referência do Net.Data

Bloco ou Instrução DEFINE

Objetivo

O bloco ou instrução DEFINE define nomes de variáveis. Os nomes de variáveis devem começar com uma letra ou sublinhado (_) e podem conter qualquer caractere alfanumérico ou sublinhado. Em todos os nomes de variável deve se considerar maiúsculas e minúsculas exceto N_columnName e V_columnName (Consulte a seção "Variáveis Implícitas de Tabela" para maiores informações sobre estas duas exceções.).

Sintaxe

>>-%define---+-| entrada define |--------------------+---------><
             +-{--+---------------------------+--%}--+
                  |  +---------------------+  |
                  |  V                     |  |
                  +---+-------------------++--+
                      +-entrada define----+
                      +-instrução include-+

entrada define

                               +---------------------------+
                               V                           |
|--+-nome da variável--=--+-"----+------------------------++--"---++>
   |                      |      +-cadeia-----------------+       ||
   |                      |      +-variável de referência-+       ||
   |                      |      +-chamada de função------+       ||
   |                      |    +---------------------------+      ||
   |                      |    V                           |      ||
   |                      +-{----+------------------------++--%}--+|
   |                      |      +-cadeia-----------------+       ||
   |                      |      +-variável de referência-+       ||
   |                      |      +-chamada de função------+       ||
   |                      |      +-(nova_linha)-----------+       ||
   |                      +-instrução exec------------------------+|
   |                      +-instrução table-----------------------+|
   |                      +-instrução envvar----------------------+|
   |                      +-| variável condicional |--------------+|
   +-instrução list------------------------------------------------+

>--------------------------------------------------------------|

variável condicional

|--nome da variável--?------------------------------------------>

        +---------------------------+
        V                           |
>--+-"----+------------------------++--"---+-------------------->
   |      +-cadeia-----------------+       |
   |      +-variável de referência-+       |
   |      +-chamada de função------+       |
   |    +---------------------------+      |
   |    V                           |      |
   +-{----+------------------------++--%}--+
          +-cadeia-----------------+
          +-variável de referência-+
          +-chamada de função------+

>--+---------------------------------------------+-------------|
   |         +---------------------------+       |
   |         V                           |       |
   +-:--+-"----+------------------------++--"---++
        |      +-cadeia-----------------+       |
        |      +-variável de referência-+       |
        |      +-chamada de função------+       |
        |    +---------------------------+      |
        |    V                           |      |
        +-{----+------------------------++--%}--+
               +-cadeia-----------------+
               +-variável de referência-+
               +-chamada de função------+

Parâmetros

%define

Palavra-chave que define variáveis.

entrada define:

nome da variável

Um ou mais nomes, cada nome adicional encadeado por um ponto (.). Consulte a seção Nome da Variável para obter informações sobre sintaxe.

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.

instrução exec

A instrução EXEC. O nome de um programa externo que é executado quando uma variável é referenciada ou uma função é chamada. Consulte Bloco ou Instrução EXEC para obter a sintaxe e exemplos.

instrução table

A instrução TABLE. Define um conjunto de dados relacionados contendo um arranjo de registros idênticos, ou linhas e um arranjo de nomes de coluna descrevendo os campos em cada linha. Consulte Instrução TABLE para obter a sintaxe e exemplos.

instrução envvar

A instrução ENVVAR. Refere-se a variáveis de ambiente. Consulte Instrução ENVVAR para obter a sintaxe e exemplos.

variável condicional

Define o valor de uma variável com base no valor de outra variável ou cadeia.

instrução list

A instrução LIST. Define variáveis que são utilizadas para gerar uma lista definida de valores. Consulte Instrução LIST para obter a sintaxe e exemplos.

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.

Contexto

Deve estar em um bloco de macro IF ou fora de todos os outros blocos na parte da declaração da macro Net.Data.

Restrições

Pode conter os seguintes elementos:

• Variáveis condicionais
• Instrução LIST
• Instrução TABLE
• Referências de variável
• Instrução INCLUDE
• Instrução EXEC
• Chamadas de função
• Instrução ENVVAR

Exemplos

Exemplo 1: Definições de variável simples.

%DEFINE var1 = "pedidos"
%DEFINE var2 = "$(var1).html"

Exemplo 2: Inclui aspas em uma cadeia usando duas aspas consecutivamente. Duas aspas sozinhas são iguais a uma cadeia nula.

%DEFINE hi = "diga ""olá"""
%DEFINE empty = ""

Exemplo 3: Um bloco DEFINE permite a definição de diversas variáveis com uma instrução DEFINE.

%DEFINE{  DATABASE = "testdb"
          home = "http://www.software.ibm.com"
          SHOWSQL = "YES"
          PI = "3.14150"
%}

Exemplo 4: Este exemplo de um bloco de definição permite que se defina uma variável atravessando diversas linhas.

%DEFINE texto = {Esta definição de variável
            atravessa duas linhas
%}