Lista Valores
| 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. |
Descrição
Janela Zoom Lista Valores
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. |
Janela Zoom Lista Valores – Regra Lista
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. Importante: No caso de ser informado mais de um valor, os possíveis valores desta regra devem ser separados por ponto e vírgula (;) |
Janela Zoom Lista Valores – Regra Faixa
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. |
Janela Zoom Lista Valores – Regra Retorno Externo
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. Importante: Podem ser utilizados caminhos que sejam reconhecidos pelo PROPATH. |
Método | Método interno do programa utilizado para a validação. Importante: É necessário definir um método que possua uma prototipação padrão. Para maiores detalhes sobre como construir um programa/método de retorno externo. Veja mais informações da descrição a Função Programa Retorno Externo. |
Importante 1:
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.
Importante 2:
O método do programa usado no “Retorno Externo” deve definir dois parâmetros de saída:
- um valor do tipo lógico (que indica se a validação ocorreu com sucesso ou não).
- e valor caracter (que permite definir uma mensagem de erro para mostrar ao usuário, quando a validação não ocorreu com sucesso).
Utilizando o recurso do retorno externo, é possível efetuar validações mais complexas, inclusive envolvendo valores de outros objetos da tela.
Import HTML Content
Visão Geral
Conteúdo das Ferramentas