O ponto de entrada AfterLogin executa ações após o login e abertura dos dicionários SXs no Protheus, recebendo o usuário em PARAMIXB[1] e PARAMIXB[2]. Como é chamado antes da interface gráfica carregar completamente, recomenda-se evitar telas e mensagens, priorizando logs, validações e atualizações internas.
Dúvida
Qual é a função ou ponto de entrada utilizado para realizar uma ação após o login no Protheus?
Ambiente
Cross Segmento - TOTVS Backoffice (Linha Protheus) - ADVPL - A partir da versão 12.1.27.
Solução
Para realizar uma customização ou executar uma ação logo após o login e a abertura dos dicionários de dados (SXs) no Protheus, deve ser utilizado o Ponto de Entrada AfterLogin.
Parâmetros Recebidos: A rotina recebe automaticamente o vetor PARAMIXB contendo os dados do usuário conectado:
PARAMIXB[1] (Caractere): ID do usuário logado.
PARAMIXB[2] (Caractere): Nome do usuário logado.
Importante
Este ponto de entrada é chamado antes do carregamento total da interface gráfica do sistema. A utilização de funções que fazem uso de interface visual (como telas, dialogs ou mensagens interativas) pode levar a cenários de erro, posicionamentos incorretos e não conformidades. Recomenda-se evitar o uso de interfaces ou telas dentro deste ponto de entrada, priorizando processamentos internos como gravações de logs, validações de regras ou atualizações de dados.
Exemplo de código:
#Include "protheus.ch"
User Function AfterLogin()
Local cId := ParamIXB[1]
Local cNome := ParamIXB[2]
// Exemplo didático de exibição de mensagem
ApMsgAlert("Usuário " + cId + " - " + Alltrim(cNome) + " efetuou login às " + Time())
Return
Observações:
Visando adequar o licenciamento do Protheus para se equiparar às demais linhas de produto da TOTVS, a partir da release 12.1.27 a interface SIGAADV pode se comportar como a interface SIGAMDI.
Saiba mais
AfterLogin
Dicas de desenvolvimento e como utilizar as plataformas TOTVS
Mudanca de comportamento da interface SIGAADV
0 Comentários