Hoppa till innehållet
Verifierad

Larm

Ett återanvändbart meddelande med titel, brödtext, allvarlighetsgrad och visningsyta, som anropas med id var som helst i projektet.

Ett larm är en återanvändbar avisering: en titel, en brödtext, en allvarlighetsgrad och var det visas, definierad en gång och utlöst på samma sätt från vilken komponent, arbetsflöde eller JavaScript-program som helst med call_alert. Det håller ett meddelande som "profilen sparad" eller "filen hittades inte" konsekvent överallt där det visas, i stället för att skrivas om vid varje anropsställe.

Egenskaper

alertData

progFields

Valfria parametrar som en anropare sätter in i titeln eller brödtexten, den vanliga virtual-fältformen, refererade i alertTitle / alertBody som @field_id.

Att anropa ett larm

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

Ett inbäddat larm hoppar över det återanvändbara programmet helt, åtgärden alert bär alertTitle, alertBody, alertType, alertDisplay och createLog direkt på arbetsflödessteget.

Undvik xu.alert i Studio-förhandsvisningar

En visning som modal, toast eller browser kan dyka upp som en inbyggd blockerande webbläsar-alert() i en live-förhandsgranskningssession, vilket fryser all JavaScript tills den stängs. Rapportera status via ett fält i stället medan du testar i förhandsgranskning, och bekräfta den riktiga visningsytan i en distribuerad app.

Genomgånget exempel

Skriv meddelandet en gång

Titel, brödtext, allvarlighetsgrad och yta, på alertData.

Gör det parametriserat

Lägg till ett virtual-fält för allt som anroparen ska fylla i, och referera till det som @field_id i brödtexten.

Utlös det var som helst

call_alert med det här programmets id, från en komponents xu-on:click, från ett set_data-programs after_record, från ett Batch-steg.

Skapa en Larm-nod under Program, fyll i titel, brödtext, typ och visning på dess flik Larm och lägg till parametrar i rutnätet Fält om meddelandet behöver dem.

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