sc_ajax_message("Mensaje", "Título", "Parámetros", "Parameters_Redir", "String_toast");
Ver un vídeo tutorial

La macro sc_ajax_message() permite mostrar mensajes personalizados durante la ejecución de aplicaciones que utilicen eventos Ajax.

A través de esta macro, es posible presentar alertas, confirmaciones o notificaciones utilizando ventanas modales, notificaciones estilo toast y opciones de redirección automática.

Su uso es exclusivo para eventos Ajax.

Parámetros

Parámetro Obligatorio Acepta Vacío Descripción y ejemplo
message Sí No

Texto del mensaje que será mostrado. Puede contener HTML.
Ejemplo:

  • "¡Operación realizada con éxito!"
  • "Error al guardar los datos"
title No Sí

Título de la ventana del mensaje. Si no se proporciona, se mostrará sin título.
Ejemplo:

  • "Atención"
  • "Información"
configString No Sí

Define el comportamiento y estilo del mensaje. Debe pasarse como una cadena con múltiples opciones separadas por &.
Ver detalles en Tabla 2: Cadena de Configuración

Ejemplo:

  • "toast=Y&timeout=3&type=success&toast_pos=top-end"
  • "modal=Y&button=Y&button_label=OK"
redirectParams No Sí

Define los valores que serán enviados a la aplicación especificada en redir, en el formato campo1=valor1;campo2=valor2.

Ejemplo:
"client_id=123;client_name=JOHN"


Aunque no son obligatorios, los parámetros deben pasarse en el orden correcto. Si se omite un parámetro intermedio, debe mantenerse con valor vacío.

 

Tabla 2: Cadena de Configuración

Propiedad Descripción Valores Ejemplo Restricciones / Notas
modal Define si el mensaje se mostrará dentro de un modal.

Y - El mensaje se abrirá en un modal

N - El mensaje se mostrará sin modal. Esta propiedad puede ser omitida.
  • "modal=Y"
  • "modal=Y&width=50"

Solo en aplicaciones con SweetAlert desactivado.
timeout Define cuánto tiempo se mostrará el mensaje en segundos. Solo funciona con mensajes sin botón de confirmación. Acepta solo números
  • "timeout=5"
  • "toast=Y&timeout=5"
  • "button=N&timeout=5"

No compatible con botón de confirmación

  • En aplicaciones con SweetAlert desactivado, requiere button=N o ser omitido.
  • En aplicaciones con SweetAlert activado, requiere toast=Y o ser omitido.
button Controla la visualización del botón de confirmación dentro del mensaje. Su comportamiento es confirmar la acción y cerrar el mensaje.

Y - Se mostrará el botón de confirmación.

N - El mensaje se mostrará sin botón. Se respetará el timeout. Omitir la propiedad tiene el mismo efecto.
  • "button=Y"
  • "button=Y&button_label=Confirmar"

Solo en aplicaciones con SweetAlert desactivado.
button_label Define el texto que se muestra en el botón Texto del botón
  • "button=Y&button_label=Cerrar"
  • "button=Y&button_label=OK"

Requiere botón de confirmación

  • Solo en aplicaciones con SweetAlert desactivado
  • Requiere button=Y.
top

Establece la posición vertical del mensaje usando la propiedad CSS top.

Si se omite, la posición se calcula automáticamente.

 Acepta solo números
  • "top=650"
  • "top=650&timeout=5"

Solo en aplicaciones con SweetAlert desactivado y requiere modal=N o estar omitido.
left

Establece la posición horizontal del mensaje usando la propiedad CSS left.

Si se omite, la posición se calcula automáticamente.

 Acepta solo números
  • "left=650"
  • "top=50&left=650&timeout=5"

Solo en aplicaciones con SweetAlert desactivado y requiere modal=N o estar omitido.
width Establece el ancho de la caja de mensaje en píxeles Acepta solo números
  • "width=650"
  • "width=650&timeout=5"

Solo en aplicaciones con SweetAlert desactivado
height Establece la altura de la caja de mensaje en píxeles Acepta solo números
  • "height=350"
  • "modal=Y&height=350&width=650"

Solo en aplicaciones con SweetAlert desactivado
redir

URL o nombre de la aplicación para redirección. Este atributo solo funciona si la propiedad button está habilitada.

 Cadena con el nombre de la aplicación o URL.
  • "redir=form_comparison"
  • "button=Y&redir=form_comparison"
  • "redir=https://scriptcase.com.br/&target=_blank"

Requiere botón de confirmación:

  • Aplicación con SweetAlert desactivado requiere button=Y o estar omitido.
  • Aplicación con SweetAlert activado requiere toast=N o estar omitido.
redir_target Define cómo se abrirá el enlace especificado en el parámetro redir.

_blank - Abre en una nueva ventana o pestaña.

_self - Abre en el mismo marco donde se hizo clic (comportamiento por defecto).

_parent - Abre en el marco padre.

_top - Abre ocupando todo el cuerpo de la ventana (rompe todos los frames).
  • "redir=https://scriptcase.com.br/&target=_blank"
  • "redir=form_comparison&target=_parent"
 Solo si redir está definido.
show_close Muestra un botón para cerrar en la barra de título. Esta propiedad, cuando está activa, fuerza la visualización de la barra de título incluso si el parámetro title está vacío.

Y - El botón de cerrar se muestra

N - El botón de cerrar no se muestra

 "show_close=Y" Solo en aplicaciones con SweetAlert desactivado
body_icon Muestra u oculta el ícono del mensaje. Incluso cuando esta propiedad está activa, la visualización del ícono depende de la configuración del tema de la aplicación.

Y - El ícono del mensaje será mostrado.

N - El ícono del mensaje no será mostrado.

 "body_icon=N" Solo en aplicaciones con SweetAlert desactivado
toast Muestra el mensaje como notificación tipo toast

Y - Usa notificación toast

N - Usa mensaje SweetAlert

 "toast=Y" Solo en aplicaciones con SweetAlert activado
toast_pos Define la posición del toast en la pantalla
  • top
  • top-start
  • top-end
  • center
  • center-start
  • center-end
  • bottom
  • bottom-start
  • bottom-end

"toast_pos=center&toast=Y&timeout=5"

"toast_pos=top&toast=N&type=warning"

 Solo en aplicaciones con SweetAlert activado y requiere toast=Y o estar omitido.
type Define el ícono que se mostrará en el mensaje
  • warning
  • error
  • success
  • info
  • question

"toast=Y&timeout=5&type=success"

"toast=N&type=warning"

 Solo en aplicaciones con SweetAlert activado

Ejemplo

1. Mensaje sin SweetAlert utilizando Modal

sc_ajax_message("¡Datos guardados con éxito!", "Confirmación", "modal=Y&button=Y&button_label=OK&show_close=Y");

2. Mensaje sin SweetAlert

sc_ajax_message("¡Atención! Por favor complete todos los campos.", "Advertencia", "button=Y");

3. Mensaje tipo Toast

sc_ajax_message("¡Producto añadido al carrito!", "", "toast=Y&type=success&toast_pos=top-end&timeout=3");

4. Mensaje utilizando SweetAlert

sc_ajax_message("¡Error al procesar la solicitud!", "Error", "type=error&button=Y");

Para mostrar el mensaje utilizando Toast, la opción "Usar SweetAlert" debe estar habilitada en la interfaz de la aplicación.