Hoje vou mostrar as “novas” mensagens de alerta para se utilizar via AdvPL.
Pessoal, como sabem via AdvPL existem inúmeras funções para mostrar mensagens, como Alert, Aviso, MsgInfo, etc… Mas existem algumas funções “novas”, e no artigo de hoje irei citar exatamente essas.
Elas não são bem novas, porém são bem mais recentes que as antigas funções (MsgInfo, MsgStop, MsgAlert, etc). Pois bem, abaixo uma pequena descrição de cada uma:
- FWAlertError: Mostra uma mensagem com um círculo vermelho e um x no meio
- FWAlertExitPage: Mostra uma pergunta com 3 opções (Continuar editando, Salvar, Sair da Página)
- FWAlertHelp: Mostra uma mensagem de help e solução
- FWAlertInfo: Mensagem informativa com um círculo azul e um i no meio
- FWAlertNoYes: Mensagem que tem 2 opções (Não e Sim)
- FWAlertSuccess: Mostra uma mensagem com um círculo verde e um ícone de check
- FWAlertWarning: Mostra uma mensagem com um triângulo amarelo e uma exclamação no meio
- FWAlertYesNo: Mensagem que tem 2 opções (Sim e Não)
Abaixo um print exemplificando:
Exemplos das mensagens
E abaixo, o código fonte desenvolvido:
//Bibliotecas
#Include "TOTVS.ch"
/*/{Protheus.doc} User Function zAlert
Testes com as funções de alerta da FWAlert
@type Function
@author Atilio
@since 22/11/2020
@version version
/*/
User Function zAlert()
FWAlertError("Mensagem de erro", "Título FWAlertError")
FWAlertExitPage("Mensagem de navegação de página", "Título FWAlertExitPage")
FWAlertHelp("Mensagem do problema", "Mensagem da solução - FWAlertHelp")
FWAlertInfo("Mensagem informativa", "Título FWAlertInfo")
FWAlertNoYes("Mensagem de pergunta Não / Sim", "Título FWAlertNoYes")
FWAlertSuccess("Mensagem de sucesso", "Título FWAlertSuccess")
FWAlertWarning("Mensagem de aviso", "Título FWAlertWarning")
FWAlertYesNo("Mensagem de pergunta Sim / Não", "Título FWAlertYesNo")
Return
Update Março de 2024
Abaixo segue alguns links mais aprofundados e com exemplos em vídeo (no YouTube):
Bom pessoal, por hoje é só.
Abraços e até a próxima.
Dan, qual o difrencial das funções FwAlert?
Então Marco, além dela ser mais nova, ela é a única que tem o ícone com check verde.
Então se você quiser mostrar uma mensagem de sucesso, pode usar essa.
Tem alguma com barra de rolagem, pra quando o texto por grande, no caso de validações?
Então Marco, dessas mensagens não.
Ai no caso, você poderia usar por exemplo, a função Aviso().
Grato pelas dicas.
Opa, obrigado pelo comentário xará.
Bom dia , poderia dar exemplo de um alerta de saldo em estoque
Bom dia Marcelo, tudo joia?
Não sei se entendi muito bem a pergunta, mas montei um exemplo, onde você tem uma variável com o Saldo, e mostra um alerta com esse saldo.
Segue trecho:
nSaldo := 0 //aqui você pode acionar funções como SaldoSB2() ou CalcEst() ... ou até mesmo fazer uma query SQL na SB2 ou SB8 buscando o saldo FWAlertInfo("O saldo do produto XPTO é " + cValToChar(nSaldo), "Saldo")Parabéns pelo artigo 🙂
Qual o comportamento dessas funções quando a execução é por job ou Schedule?
Obrigado!
Opa, obrigado pelo feedback Rafael.
Então, eu não cheguei a testar elas em Job, pois quando eu utilizo algum Schedule eu costumo utilizar a VarInfo ou a zConOut (download aqui- https://terminaldeinformacao.com/2022/03/23/como-substituir-o-conout-pelo-fwlogmsg/ ) para exibir mensagens, por exemplo:
//Se tiver rodando via job / ws, irá mostrar a mensagem no console.log If IsBlind() u_zConOut("Ola Mundo") //Senão, mostra a mensagem direto na tela do Protheus Else FWAlertInfo("Ola Mundo", "Mensagem") EndIfUm grande abraço.
Dan, belo artigo!
Como faço para criar um menu em que selecionado simplesmente abra uma mensagem dessa?
Bom dia Luciano, tudo joia?
Opa, agradecemos o comentário e feedback.
Então, depende. Você diz, colocar direto no menu do Protheus? Se sim, você precisa preparar uma User Function com sua mensagem, e adicionar no menu conforme o passo a passo aqui – https://terminaldeinformacao.com/2023/05/31/como-adicionar-uma-rotina-em-um-menu-do-protheus/
Agora, se for menu dentro de uma rotina, por exemplo, adicionar no Outras Ações, ai você precisa procurar o ponto de entrada para fazer essa adição. Sendo que existe o Outras Ações de um Browse e o Outras Ações de uma EnchoiceBar (aulas 5 e 7 do curso de pontos de entrada – https://terminaldeinformacao.com/2023/09/05/curso-pontos-de-entrada/ )
Um grande abraço.
Dan, nos exemplos dados, há um de “Problema” e “Solução”. Neste caso qual seria a função FWAlert a ser utilizada?
Bom dia Wladimir, tudo joia?
Para os casos onde mostra “Problema” e “Solução”, a tela que é acionada é a função Help(), ai você pode acioná-la de duas formas, ou direto via Help() ou através da ExibeHelp:
Local cMensagem := "Não foi encontrado parametrização para executar a rotina" Local cSolucao := "Cadastre o parâmetro MV_X_PARAM" //Exibindo a mensagem com Help Help(, , "Help", , cMensagem, 1, 0, , , , , , {cSolucao}) //Exibindo a mensagem com ExibeHelp ExibeHelp("Help", cMensagem, cSolucao)Um grande abraço.
Tem algum exemplo pra pegar dados com uma função FW ?
Bom dia Victor, tudo joia?
Não sei se entendi a dúvida, você consegue dar um cenário ou contextualizar?
Fico no aguardo.
Tenha uma ótima e abençoada sexta feira.
Um grande abraço.