Naar de inhoud springen
Geverifieerd

Waarschuwing

Een herbruikbaar bericht, met titel, tekst, ernst en weergaveplek, van overal in het project aan te roepen met zijn id.

Een Waarschuwing is een herbruikbare melding: een titel, een tekst, een ernst en de plek waar hij verschijnt, eenmaal gedefinieerd en op dezelfde manier opgeroepen vanuit elke Component, workflow of elk JavaScript-programma met call_alert. Hij houdt een bericht als "profiel opgeslagen" of "bestand niet gevonden" overal consistent waar het getoond wordt, in plaats van het bij elke aanroep opnieuw te typen.

Eigenschappen

alertData

progFields

Optionele parameters die een aanroeper in de titel of tekst invult, de standaard virtual-veldvorm, waarnaar binnen alertTitle / alertBody verwezen wordt als @field_id.

Een Waarschuwing aanroepen

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

Een inline waarschuwing slaat het herbruikbare programma helemaal over: de actie alert draagt alertTitle, alertBody, alertType, alertDisplay en createLog rechtstreeks op de workflowstap.

Vermijd xu.alert in Studio-voorbeelden

Een weergave modal, toast of browser kan in een live-voorbeeldsessie verschijnen als een native, blokkerende browser-alert(), waardoor alle JavaScript stilstaat totdat hij wordt gesloten. Meld de status tijdens het testen in het voorbeeld liever via een veld, en bevestig de echte weergaveplek in een gedeployde app.

Uitgewerkt voorbeeld

Schrijf het bericht één keer

Titel, tekst, ernst en plek, op alertData.

Maak het parametriseerbaar

Voeg een virtual-veld toe voor alles wat de aanroeper moet invullen, en verwijs ernaar als @field_id in de tekst.

Roep hem overal op

call_alert met de id van dit programma, vanuit de xu-on:click van een Component, vanuit de after_record van een set_data-programma, vanuit een Batch-stap.

Maak een Waarschuwing-knooppunt onder Programma's, vul titel, tekst, type en weergave in op het tabblad Waarschuwing, en voeg parameters toe in het raster Velden als het bericht ze nodig heeft.

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