Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

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

...

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.

Informações
titleImpotante:

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.
Informações
titleImpotante:

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.

...

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.

Informações
titleImpotante:

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.

...

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.

...

Informações
titleImportante:

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

...