Saltar al contenido
Verificada

Alerta

Un mensaje reutilizable, título, cuerpo, gravedad y superficie de visualización, al que se llama por id desde cualquier parte del proyecto.

Una Alerta es una notificación reutilizable: un título, un cuerpo, una gravedad y el lugar donde aparece, definida una vez y lanzada del mismo modo desde cualquier Componente, flujo de trabajo o programa JavaScript con call_alert. Mantiene un mensaje como "perfil guardado" o "archivo no encontrado" coherente en todos los sitios donde se muestra, en lugar de reescribirlo en cada punto de llamada.

Propiedades

alertData

progFields

Parámetros opcionales que quien llama sustituye en el título o en el cuerpo, la forma estándar de campo virtual, referenciados dentro de alertTitle / alertBody como @field_id.

Llamar a una Alerta

json
{
  "id": "1", "data": {
    "action": "call_alert",
    "name": { "prog": "5b1_alr_…", "properties": {}, "parameters": { "file_name": { "fx": "@document_name" } } },
    "enabled": true
  }, "props": {}
}

Una alerta en línea se salta por completo el programa reutilizable, la acción alert lleva alertTitle, alertBody, alertType, alertDisplay y createLog directamente en el paso del flujo de trabajo.

Evita xu.alert en las vistas previas de Studio

Una visualización modal, toast o browser puede aparecer como un alert() nativo bloqueante del navegador dentro de una sesión de vista previa en vivo, congelando todo el JavaScript hasta que se descarta. Informa del estado mediante un campo mientras pruebas en la vista previa, y confirma la superficie de visualización real en una app desplegada.

Ejemplo práctico

Escribe el mensaje una vez

Título, cuerpo, gravedad y superficie, en alertData.

Parametrízalo

Añade un campo virtual para lo que quien llama deba rellenar, y haz referencia a él como @field_id dentro del cuerpo.

Lánzalo desde cualquier lugar

call_alert con el id de este programa, desde el xu-on:click de un Componente, desde el after_record de un programa set_data, desde un paso de Batch.

Crea un nodo Alerta en Programas, rellena el título, el cuerpo, el tipo y la visualización en su pestaña Alerta y añade parámetros en la cuadrícula de Campos si el mensaje los necesita.

xml
<meta lang="json5">
{
  id: "student_saved",
  menuTitle: "Student Profile Saved"
}
</meta>

<alert lang="json5">
{
  alertDisplay: "toast",
  alertType: "success",
  alertTitle: "Profile saved",
  alertBody: "The student profile was saved through the DBS-backed student table.",
  createLog: false
}
</alert>
json
{
  "properties": { "menuType": "alert", "menuName": "File Not Found" },
  "alertData": {
    "alertType": "error", "alertDisplay": "modal",
    "alertTitle": "File not found", "alertBody": "The file \"@file_name\" could not be located."
  },
  "progFields": [
    { "id": "b2c3d4e5-…", "data": { "field_id": "file_name", "type": "virtual" }, "props": { "fieldType": "string" } }
  ]
}