sc_ajax_message("Mensagem", "Título", "Parâmetro", "Parâmetros_Redir", "String_toast");

Esta macro permite que a aplicação exiba mensagens customizáveis, com seu uso restrito aos eventos do formulário/controle quando se faz uso no eventos AJAX.

Esta macro só é valida em aplicações com suporte a AJAX.

Parâmetros Descrição
Mensagem Texto que será exibido no corpo da mensagem. Este parametro é de preenchimento obrigatório.
Título Texto que será exibido no título da mensagem. Se não preenchido o título da mensagem não será exibido.
String de parâmetros da mensagem

Parâmetro de formatação da mensagem.
Ex.: modal=Y&button=Y&button_label=Ok&redir=form_employees.php&redir_target=_blank

Os detalhes deste parâmetro estão detalhados na tabela2.
String de parâmetros do Redirecionamento

Nesta propriedade podem ser definidos os valores para a aplicação de redirecionamento.Esta propriedade funciona apenas se a propriedade redir for informada. Os parametros devem ser informados no seguinte formato: parametro=valor;parametro=valor.

Ex.: customer_id=ALFKI;customer_name=ALBERT FRANCINET
String de parâmetros do toast

Parâmetro de formatação da mensagem utilizando Toast.

- toast: Y ou N
 
- toast_pos: 'top', 'top-start', 'top-end', 'center', 'center-start', 'center-end', 'bottom', 'bottom-start', 'bottom-end'
 
- type: 'warning', 'error', 'success', 'info', 'question'

 

Tabela2: String de Parâmetros da mensagem

Propriedade Descrição Valores Exemplo
modal Flag para exibição da mensagem em modal Y ou N modal=Y
timeout Tempo em segundos para esconder mensagem. Se não informado mensagem será exibida indefinidamente. Esta propriedade só funciona se a propriedade button não estiver habilitada. Segundos timeout=5
button Exibe botão dentro da mensagem. O seu funcionamento padrão é fechar a mensagem. Caso seja habilitado o redirecionamento, após fechar a mensagem a aplicação será redirecionada. Y ou N button=Y
button_label Label do botão. Esta opção só funciona caso a propriedade button habilidata String button=Y&button_label=OK
top Valor para posicionamento da mensagem em pixels Apenas numeros top=300
left Valor para posicionamento da mensagem em pixels Apenas numeros left=200
width Valor para largura da mensagem em pixels Apenas numeros width=320
height Valor da altura da mensagem em pixels Apenas numeros height=30
redir Nome da aplicações ou URL para redirecionamento. Esta propriedade funciona apenas caso a propriedade button esteja habilitada. String button=Y&redir=form_employees.php
redir_target Target para url de redicionamento. Esta propriedade funciona apenas quando a propriedade redir está habilitada. String redir=form_employees.php&redir_target=_blank
show_close Flag para exibição do botão de fechar mensagem localizado na barra de titulo. Esta propriedade quando ativa força a exibição da barra de titulo mesmo que o parametro titulo esteja vazio. Y ou N show_close=Y
body_icon Flag para exibição do icone do corpo da mensagem. Mesmo quando esta propriedade está ativa a exibição do icone depende da configuração do Tema (Esquema de exibição) usado na aplicação. Y ou N body_icon=N

 

Exemplo 01

sc_ajax_message ("Message", "Title", "timeout=0");

 

Exemplo 02: Utilizando o Toast

sc_ajax_message ("Cliente", "Title", "toast=Y&toasto_pos=center-start&type=success");

 

Obs

Para a exibição da mensagem utilizando o Toast é necessário que esta opção esteja habilitada na interface da aplicação.