| Objetivo | Permitir a informação de uma lista de valores possíveis para um objeto, criando uma validação para o mesmo. |
| Programa | SO0701L |
| Pré-Requisito | É pré-requisito para a execução dessa função: |
| Visão Geral | Por intermédio dessa função pode-se informar valores possíveis para um objeto, por intermédio de regras de lista, faixa ou retorno externo. |
Esta tela é responsável por definir uma lista de valores possíveis para validar o objeto. Ela é executada pelo botão zoom da propriedade “Lista Valores”.
Nas tabelas a seguir estão descritos os elementos desta janela:
Nome Botão | Descrição |
Cria Nova Regra | Cria uma nova regra para o objeto. |
Salva Regra | Salva a regra alterada. Pode ser utilizado para modificar uma regra, conforme a regra selecionada no browse. |
| Elimina Regra | Elimina a regra selecionada. |
| Confirma | Confirma a lista de valores do objeto. |
| Cancela | Cancela a alteração/criação da lista de valores do objeto. |
| Sobe Nível Regra | Sobe o nível da regra fazendo com que ela seja executada com maior prioridade, possivelmente alterando o resultado final da validação da lista de valores. |
| Desce Nível Regra | Desce o nível da regra fazendo com que ela seja executada com menor prioridade, possivelmente alterando o resultado final da validação da lista de valores. |
Campo | Descrição |
Tipo de Regra | Uma regra pode ser de três tipos: Lista – Lista de Valores possíveis. Faixa – Valor inicial ou Final. Retorno Externo – Utilizado para regras mais complexas, definidas pelo Usuário Administrador através de um programa / método informado. |
Conector | Tipo de conector lógico utilizado para a regra (em relação ao item anterior). Pode ser AND e OR. AND – indica que a validação anterior e a corrente devem estar OK. OR – indica que ou a validação anterior ou a validação corrente, devem estar OK. |
| Tipo | Mostra a forma que o valor do objeto é comparado ao valor da regra em tempo de execução. Pode ser = (igual) ou <> (diferente) |
| Opção | Informa se a regra é uma “Faixa”, “Lista” ou um “Retorno Externo” |
| Lista (browse) | Mostra o valor informado para a regra, conforme Tipo de Regra informado. |
A opção “Lista” permite criar uma regra com uma lista de possíveis valores, como, por exemplo, 1, 2 ou 3.
Na tabela a seguir estão descritos os elementos desta janela:
Campo | Descrição | |
Lista | Campo utilizado para ser(em) informado(s) o(s) valor(es) que o objeto precisa ter para ser validado.
|
A opção “Faixa” permite criar uma regra com uma faixa de possíveis valores, como, por exemplo de “teste” até “ZZZZZ”.
Na tabela a seguir estão descritos os elementos desta janela. Basicamente o funcionamento da tela é o mesmo de quando a opção “Lista” está selecionada. Apenas o campo “Lista” é substituído pelos seguintes itens::
Campo | Descrição |
De | Usado para informar o valor inicial da faixa. |
| Até | Usado para informar o valor final da faixa. |
A opção “Retorno Externo” permite que seja criada uma regra baseada no retorno lógico de um programa externo.
Nas tabelas a seguir estão descritos os elementos desta janela. Basicamente o funcionamento da janela é o mesmo de quando a opção “Lista” está selecionada. Apenas o campo “Lista” é substituído pelos seguintes itens:
Campo | Descrição | |
Programa | Caminho completo e nome do arquivo do programa.
| |
Método | Método interno do programa utilizado para a validação.
|
A tela de pesquisa pode ser diferente da figura apresentada, dependendo da versão do sistema operacional. A tela “Zoom Lista de Valores” cria as regras para que os objetos que tem essa propriedade usada possam ser validados ao ser pressionado um botão do tipo “validador” ou então quando o usuário no ambiente de aplicação tentar criar, modificar ou excluir um registro. |
O método do programa usado no “Retorno Externo” deve definir dois parâmetros de saída:
|
Utilizando o recurso do retorno externo, é possível efetuar validações mais complexas, inclusive envolvendo valores de outros objetos da tela. |