Vai al contenuto
Verificata

Avviso

Un messaggio riutilizzabile, con titolo, corpo, gravità e superficie di visualizzazione, richiamato per id da qualsiasi punto del progetto.

Un Avviso è una notifica riutilizzabile: un titolo, un corpo, una gravità e il punto in cui compare, definiti una volta e sollevati nello stesso modo da qualsiasi Componente, workflow o programma JavaScript con call_alert. Mantiene coerente ovunque venga mostrato un messaggio come "profilo salvato" o "file non trovato", invece di riscriverlo a ogni punto di chiamata.

Proprietà

alertData

progFields

Parametri facoltativi che un chiamante sostituisce nel titolo o nel corpo, la forma standard di campo virtual, referenziati dentro alertTitle / alertBody come @field_id.

Chiamare un Avviso

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

Un avviso in linea salta del tutto il programma riutilizzabile: l'azione alert porta alertTitle, alertBody, alertType, alertDisplay e createLog direttamente nel passo del workflow.

Evita xu.alert nelle anteprime di Studio

Una visualizzazione modal, toast o browser può comparire come un alert() nativo bloccante del browser dentro una sessione di anteprima live, bloccando tutto il JavaScript finché non viene chiuso. Mentre provi in anteprima, comunica lo stato tramite un campo e conferma la superficie di visualizzazione reale in un'app distribuita.

Esempio pratico

Scrivi il messaggio una volta

Titolo, corpo, gravità e superficie, in alertData.

Rendilo parametrico

Aggiungi un campo virtual per tutto ciò che il chiamante deve compilare, referenzialo come @field_id nel corpo.

Sollevalo da qualsiasi punto

call_alert con l'id di questo programma, da un xu-on:click di un Componente, dall'after_record di un programma set_data, da un passo di un Batch.

Crea un nodo Avviso sotto Programmi, compila titolo, corpo, tipo e visualizzazione nella sua scheda Avviso, aggiungi i parametri nella griglia Campi se il messaggio ne ha bisogno.

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" } }
  ]
}