Condição

Objetivo

Permitir a criação de condições, por intermédio de regras, para um botão ficar desabilitado ou escondido em eventos pré-determinados.

ProgramaSO0701J
Pré-Requisito

É pré-requisito para a execução dessa função:
Função Propriedades dos Objetos (SO0701)

Visão Geral

Por intermédio dessa função é possível criar condições para um determinado botão ficar desabilitado ou escondido. A condição é definida por intermédio de regras que podem ser do tipo lista, faixa ou retorno externo.

Descrição

Janela Zoom Condição

Esta janela é executada quando um determinado botão tem a propriedade “Invisível” ou “Desabilitado” com o valor “Condição”, e é pressionado o botão “zoom” na propriedade “Condição” na paleta de propriedades. Nessa tela é possível criar verificações de vários objetos para determinar, por intermédio de seus valores, se o botão deve ou não ficar desabilitado ou invisível em determinados momentos (dependendo da validação).

Nas tabelas a seguir estão descritos os elementos desta janela:

Nome Botão

Descrição

Cria Nova Regra

Cria uma nova regra para a condição.

Salva Regra

Salva a regra alterada, conforme a regra selecionada no browse.

Elimina RegraElimina a regra selecionada
ConfirmaConfirma a condição do botão.
Cópia

Pode ser utilizado quando um determinado botão possuir a mesma condição que outro botão.

Sobe Nível RegraSobe o nível da regra fazendo com que ela seja executada com maior prioridade, possivelmente alterando o resultado final da validação da condição.
Desce Nível RegraDesce o nível da regra fazendo com que ela seja executada com menor prioridade, possivelmente alterando o resultado final da validação da condição.

Campo

Descrição

Objetos Tela


Permite selecionar qualquer objeto da tela que possa ser validado para criar uma  regra para a condição.

Impotante:

O objeto selecionado fica com a cor azul , enquanto selecionado na lista, para facilitar sua identificação.

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
Apresenta a forma que o valor do objeto será comparado ao valor da regra em tempo de execução. Pode ser = (igual) ou <> (diferente).
Objeto
Apresenta em qual objeto a regra será aplicada.
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.

Impotante:

Para a propriedade condição, deve ser informada uma regra, que se for validada com sucesso, DESABILITA ou ESCONDE o botão previamente selecionado. Dessa forma, se for necessário o botão ficar habilitado/visível quando o objeto cod-estab for igual a 100, deve ser criada a seguinte regra:

Objeto cod-estab  .:. LISTA <> 100

Janela Zoom Condição - Opção Lista

A opção “Lista” permite criar uma regra com uma lista de possíveis valores, como, por exemplo de 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 desabilitado ou escondido.

Impotante:

O objeto selecionado fica com a cor azul , enquanto selecionado na lista, para facilitar sua identificação.

Janela Zoom Condição - Opção Faixa

A opção “Faixa” permite criar uma regra com uma faixa de possíveis valores, como, por exemplo de 1 a 50.

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

De

Usado para informar o valor inicial da faixaCampo utilizado para ser(em) informado(s) o(s) valor(es) que o objeto precisa ter para ser desabilitado ou escondido.

AtéUsado para informar o valor final da faixa.

Janela Zoom Condição - Opção Retorno Externo

A opção “Retorno Externo” permite que seja criada uma regra baseada no retorno lógico de um programa externo.

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 na descrição da Função Programa Retorno Externo.

Nome Botão

Descrição

Pesquisa

Abre uma janela padrão Windows para selecionar o programa responsável pelo retorno externo.

Importante:

A janela de pesquisa acima pode ser diferente da figura dependendo da versão do sistema operacional.

A janela “Zoom Condição” cria as regras para um botão para que seu estado (desabilitado ou invisível) dependendo das regras criadas para vários objetos da tela.

Importante:

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).

Dica 1 - utilizando o recurso do retorno externo, é possível efetuar validações mais complexas, inclusive envolvendo valores de outros objetos da tela.

Dica 2 - eventualmente pode ser construído um método de retorno externo para lista de valores e para condição que tenham o mesmo objetivo ou a mesma codificação. Mas como a lista de valores deve retornar YES para OK e a propriedade condição tem que retornar YES para desabilitar, na condição pode ser criada uma regra utilizando o mesmo método de validação, apenas com o tipo diferente (<>). Dessa forma, se o retorno externo for NO, o objeto é desabilitado ou escondido.

Dica 3 - é recomendado que, para programas do EMS2 e HR, a propriedade “Condição” seja utilizada em conjunto com a propriedade “Invisível” (devido à arquitetura interna). Para os programas do EMS5, a propriedade “Condição” pode ser utilizada em conjunto com a propriedade “Invisível” ou “Desabilitado”.

Janela Condições Existentes

Esta janela é executada pelo botão “Cópia” da janela “Zoom Condição”. Nela é possível selecionar qual botão da tela (que tenha a propriedade “Condição” utilizada) deve ser utilizado como base para efetuar a cópia das regras da propriedade “Condição”.

Nas tabelas a seguir estão descritos os elementos desta janela:

Nome Botão

Descrição

Confirma

Confirma a seleção do botão do qual se deseja fazer a cópia

Cancela

Cancela a cópia

Campo

Descrição

Objetos

Permite selecionar qualquer botão da tela que tenha a propriedade “Condição” utilizada para que a mesma seja copiada.

#trackbackRdf ($trackbackUtils.getContentIdentifier($page) $page.title $trackbackUtils.getPingUrl($page))