Zum Inhalt springen
Geprüft

Alert

Eine wiederverwendbare Meldung, Titel, Text, Schweregrad und Anzeigefläche, von überall im Projekt per ID aufgerufen.

Ein Alert ist eine wiederverwendbare Benachrichtigung: ein Titel, ein Text, ein Schweregrad und der Ort, an dem sie erscheint, einmal definiert und von jeder Komponente, jedem Workflow oder JavaScript-Programm auf dieselbe Weise mit call_alert ausgelöst. Er hält eine Meldung wie "Profil gespeichert" oder "Datei nicht gefunden" überall, wo sie angezeigt wird, einheitlich, statt sie an jeder Aufrufstelle neu zu tippen.

Eigenschaften

alertData

progFields

Optionale Parameter, die ein Aufrufer in Titel oder Text einsetzt, die übliche Form eines virtual-Felds, in alertTitle / alertBody als @field_id referenziert.

Einen Alert aufrufen

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

Ein Inline-Alert überspringt das wiederverwendbare Programm vollständig, die Aktion alert trägt alertTitle, alertBody, alertType, alertDisplay und createLog direkt im Workflow-Schritt.

xu.alert in Studio-Vorschauen vermeiden

Eine Anzeige als modal, toast oder browser kann in einer Live-Vorschau-Sitzung als nativer, blockierender Browser-alert() erscheinen und alles JavaScript einfrieren, bis er geschlossen wird. Melde den Status beim Testen in der Vorschau stattdessen über ein Feld und bestätige die echte Anzeigefläche in einer bereitgestellten App.

Praxisbeispiel

Die Meldung einmal schreiben

Titel, Text, Schweregrad und Fläche, in alertData.

Parametrisieren

Füge ein virtual-Feld für alles hinzu, was der Aufrufer ausfüllen soll, und referenziere es im Text als @field_id.

Von überall auslösen

call_alert mit der ID dieses Programms, aus dem xu-on:click einer Komponente, aus dem after_record eines set_data-Programms, aus einem Batch-Schritt.

Lege unter Programme einen Alert-Knoten an, trage Titel, Text, Typ und Anzeige auf seinem Tab Alert ein und füge im Raster Felder Parameter hinzu, falls die Meldung sie braucht.

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