📖 Introductie
De Notifier Helper biedt een gestandaardiseerde manier om meldingen te tonen binnen model-driven apps. Hiermee kunnen foutmeldingen en waarschuwingen consistent worden weergegeven op veld-, formulier- of popup-niveau.
👉 Zorgt voor consistente validatie feedback en voorkomt ongecontroleerde save acties.
📦 Functionaliteit
📢 Meldingen tonen
-
showAlert(message, fieldName, executionContext, title, width, height) → Toont alert dialog + optioneel field notification + blokkeert save
-
showFormNotification(message, uniqueId, executionContext) → Toont melding bovenaan formulier
-
showFieldNotification(message, fieldName, executionContext) → Toont melding op veld
🧹 Meldingen verwijderen
-
clearField(formContext, fieldName) → Verwijdert field notification
-
clearForm(formContext, uniqueId) → Verwijdert form notification
-
clearAlerts(formContext, fieldName, uniqueId) → Verwijdert beide
⚙️ Werking
De helper biedt een abstractielaag voor het tonen en beheren van notificaties binnen de Dataverse form lifecycle.
👉 De helper gebruikt:
- Popup alerts via Xrm.Navigation
- Form notificaties via UI API
- Field notificaties via controls
1. Opslaan blokkeren
-
executionContext.getEventArgs().preventDefault()
2. FormContext ophalen
-
executionContext.getFormContext()
- Fallback:
Xrm.Page (legacy)
3. Notificaties tonen
-
Xrm.Navigation.openAlertDialog()
-
formContext.ui.setFormNotification()
-
control.setNotification()
4. Identificatie via IDs
- Unieke ID's voor form notificaties
- Vaste prefix voor field notificaties
⚠️ Belangrijke aandachtspunten
-
preventDefault()
Wordt automatisch uitgevoerd bij validatiefouten
-
Field notifications
Gebruiken ID: FIELD_ERR_<fieldName>
-
Form notifications
Vereisen unieke uniqueId
-
ExecutionContext
Nodig bij events zoals OnSave en OnChange
-
Fallback naar Xrm.Page
Voor legacy ondersteuning
⚠️ Gebruik consistente uniqueId's om notificaties later correct te kunnen verwijderen.
💡 Voorbeelden
Alert tonen + save blokkeren
onited.core.Notifier.showAlert(
"Email is verplicht",
"emailaddress1",
executionContext
);
📊 Samenvatting
✅ Centrale notificatie logica
✅ Ondersteunt alert, form en field meldingen
✅ Blokkeert save bij validatiefouten
✅ Consistente afhandeling met unieke IDs