Aller au contenu
Vérifié

Alerte

Un message réutilisable, titre, corps, gravité et surface d'affichage, appelé par identifiant depuis n'importe où dans le projet.

Une Alerte est une notification réutilisable : un titre, un corps, une gravité et l'endroit où elle apparaît, définis une fois et déclenchés de la même façon depuis n'importe quel Composant, workflow ou programme JavaScript avec call_alert. Elle garde cohérent un message comme « profil enregistré » ou « fichier introuvable » partout où il s'affiche, au lieu de le retaper à chaque point d'appel.

Propriétés

alertData

progFields

Paramètres facultatifs qu'un appelant substitue dans le titre ou le corps, la forme standard d'un champ virtual, référencés dans alertTitle / alertBody sous la forme @field_id.

Appeler une Alerte

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

Une alerte en ligne saute entièrement le programme réutilisable : l'action alert porte alertTitle, alertBody, alertType, alertDisplay et createLog directement sur l'étape du workflow.

Évitez xu.alert dans les aperçus de Studio

Un affichage modal, toast ou browser peut se manifester comme un alert() natif bloquant du navigateur dans une session d'aperçu en direct, ce qui fige tout le JavaScript jusqu'à sa fermeture. Pendant les tests en aperçu, signalez l'état via un champ à la place, et confirmez la vraie surface d'affichage dans une application déployée.

Exemple concret

Écrivez le message une fois

Titre, corps, gravité et surface, dans alertData.

Paramétrez-le

Ajoutez un champ virtual pour tout ce que l'appelant doit renseigner, référencez-le sous la forme @field_id dans le corps.

Déclenchez-le de n'importe où

call_alert avec l'identifiant de ce programme, depuis le xu-on:click d'un Composant, depuis le after_record d'un programme set_data, depuis une étape de Lot.

Créez un nœud Alerte sous Programmes, renseignez le titre, le corps, le type et l'affichage dans son onglet Alerte, ajoutez des paramètres dans la grille Champs si le message en a besoin.

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