Sari la conținut
Verificat

Alertă

Un mesaj reutilizabil, cu titlu, conținut, severitate și suprafață de afișare, apelat după id de oriunde din proiect.

O Alertă este o notificare reutilizabilă: un titlu, un conținut, o severitate și locul unde apare, definite o singură dată și ridicate la fel din orice componentă, workflow sau program JavaScript cu call_alert. Ține consecvent un mesaj precum „profil salvat" sau „fișier negăsit" peste tot unde este afișat, în loc să fie rescris la fiecare apel.

Proprietăți

alertData

progFields

Parametri opționali pe care apelantul îi substituie în titlu sau în conținut, structura standard de câmp virtual, referiți în alertTitle / alertBody ca @field_id.

Apelarea unei Alerte

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

O alertă inline sare complet peste programul reutilizabil: acțiunea alert poartă alertTitle, alertBody, alertType, alertDisplay și createLog direct pe pasul de workflow.

Evită xu.alert în previzualizările Studio

Un afișaj modal, toast sau browser poate apărea ca un alert() nativ de browser, care blochează totul, într-o sesiune de previzualizare live, înghețând tot JavaScript-ul până este închis. Raportează starea printr-un câmp în schimb cât timp testezi în previzualizare și confirmă suprafața reală de afișare într-o aplicație publicată.

Exemplu lucrat

Scrie mesajul o singură dată

Titlu, conținut, severitate și suprafață, pe alertData.

Parametrizează-l

Adaugă un câmp virtual pentru tot ce trebuie să completeze apelantul și referă-l ca @field_id în conținut.

Ridică-l de oriunde

call_alert cu id-ul acestui program, dintr-un xu-on:click al unei componente, din after_record al unui program set_data, dintr-un pas Batch.

Creează un nod Alertă sub Programe, completează titlul, conținutul, tipul și afișarea în fila Alertă, adaugă parametri în grila Câmpuri dacă mesajul are nevoie de ei.

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