AbrirTelaSistema

Esta função abre a tela do sistema passada como parâmetro. Se a tela for aberta corretamente, a função retornará 0. Se ocorrer algum problema e a tela não puder ser aberta, ela retornará 1.

Sintaxe: AbrirTelaSistema(Alfa NomeTela, Numero End Resultado);

Parâmetros:

Nome Tipo Descrição
NomeTela Alfa O nome da tela do sistema que deve ser aberta. Este nome pode ser obtido no campo "Janela Ativa no Momento", presente na tela que é aberta ao pressionar as teclas Shift + F3 sobre a tela do sistema cujo nome deseja-se obter.
Resultado Numérico Variável que receberá o resultado da função. Se a tela for aberta corretamente, ela receberá 0. Caso contrário, ela receberá 1.

Exemplo:

/* Abre a tela de histórico de filial */
AbrirTelaSistema("FR038HFI", vRet);

 

/* Se não conseguiu abrir a tela, mostra mensagem */
se (vRet <> 0)
  MensagemLog("Não foi Possível Abrir a Tela de Histórico de Filial!");

Utilização: Todas as regras, exceto as regras de Apuração e Integração do módulo Controle de Ponto e Refeitório.

Observações: Esta função baseia-se no menu do sistema para localização e abertura da tela. Portanto, só é possível executá-la em um ambiente onde haja o menu principal do sistema. Por isso, ela não funcionará nos sistemas Web.

A função obedece todas as permissões de usuários, somente sendo possível abrir telas que estejam (ou estariam) acessíveis para o usuário no uso normal do sistema.

Antes do uso efetivo desta função são necessários estudos e testes, pois seu uso inadequado pode trazer consequências negativas, como a não confiabilidade das informações e a perda de performance.

O uso da função somente é aconselhado para abertura de telas do sistema que sejam consideradas simples (cadastros, por exemplo).

As telas do sistema não foram originalmente criadas para serem abertas deste modo. Portanto, não há garantias do funcionamento correto das mesmas. A Senior reserva-se o direito de bloquear a abertura de determinada tela se o comportamento dela mostrar-se inadequado.

Este artigo ajudou você?