setNotification (Client-API-Referenz)
Zeigt eine Fehlermeldung für das Steuerelement an, um anzugeben, dass Daten ungültig sind. Wenn diese Methode verwendet wird, erscheint ein rotes „X“-Symbol neben dem Steuerelement. Bei mobilen Dynamics 365-Clients wird die Meldung angezeigt, indem Sie auf das Symbol tippen.
Anmerkung
Stellen Sie immer sicher, dass das Steuerelement, mit dem Sie setNotification verwenden, auf dem Formular sichtbar ist.
setNotification gibt keinen Fehler zurück, wenn Sie es für ein sichtbares Steuerelement verwenden, das sich jedoch in einem nicht sichtbaren Abschnitt oder einer nicht sichtbaren Registerkarte befindet. Beim Speichern eines Datensatzes zeigt setNotification oben im Formular eine Meldung als Prüfungsfehler an. Wenn das Steuerelement nicht sichtbar ist, weil es sich in einem ausgeblendeten übergeordneten Abschnitt oder einer ausgeblendeten übergeordneten Registerkarte befindet, kann der Benutzer dies nicht beheben.
Unterstützte Steuerelementtypen
Standard, Auswahlmöglichkeiten und Auswahlspaltentypen.
Syntax
formContext.getControl(arg).setNotification(message,uniqueId);
Parameter
| Name | Type | Erforderlich | Beschreibung |
|---|---|---|---|
message |
String | Ja | Die angezeigte Meldung. |
uniqueId |
String | Nein | Die zum Löschen dieser Nachricht zu verwendende ID, wenn die clearNotification-Methode angewendet wird. |
Rückgabewert
Typ: Boolesch
Beschreibung: Gibt an, ob die Methode erfolgreich war.
Anmerkungen
Das Festlegen von einer Fehlermeldung für ein Steuerelement blockiert das Speichern des Formulars.