addNotification (Client-API-Referenz)
Zeigt eine Fehler- oder Empfehlungs- Benachrichtigung für ein Steuerelement an und Sie können Aktionen angeben, die basierend auf der Benachrichtung ausgeführt werden sollen. Wenn Sie einen Fehlertyp für eine Benachrichtigung angeben, wird ein rotes „X“-Symbol neben dem Steuerelement angezeigt. Wenn Sie einen Empfehlungstyp für eine Benachrichtigung angeben, wird ein „i“-Symbol neben dem Steuerelement angezeigt. Auf mobilen Dynamics 365-Clients wird die Benachrichtung angezeigt, wenn Sie auf die Schaltfläche tippen, und Sie können die konfigurierten Aktionen ausführen, indem Sie auf die Schaltfläche Übernehmen klicken oder die Meldung schließen.
Unterstützte Steuerelementtypen
Alle
Syntax
formContext.getControl(arg).addNotification(notification);
Parameter
| Name | Type | Erforderlich | Beschreibung |
|---|---|---|---|
notification |
Object | Ja | Die Benachrichtigung zum Hinzufügen. Siehe notification-Parameter |
notification-Parameter
Der notification-Parameter akzeptiert ein Objekt mit den folgenden Eigenschaften
| Name | Type | Erforderlich | Beschreibung |
|---|---|---|---|
actions |
Array von Objekten | Nein | Siehe actions-Eigenschaft |
messages |
Array aus Zeichenfolgen | Ja | Die Meldung, die die Benachrichtigung anzeigt. In der aktuellen Version wird nur die erste Nachricht, die in diesem Array angegeben wird, angezeigt. Eine angegebene Zeichenfolge wird als fetter Text in der Benachrichtung angezeigt und wird in der Regel für Titel oder Betreff verwendet. Sie sollten Ihre Mitteilung auf 50 Zeichen beschränken, um eine optimale Benutzerfreundlichkeit zu gewährleisten. |
notificationLevel |
String | Ja | Definiert den Typ der Benachrichtigung. Gültige Werte sind ERROR oder RECOMMENDATION. |
uniqueId |
String | Ja | Die zum Löschen dieser Nachricht zu verwendende ID, wenn die clearNotification-Methode angewendet wird. |
actions-Eigenschaften
Die actions-Eigenschaften enthalten ein Array von Objekten mit den folgenden Eigenschaften:
| Name | Type | Erforderlich | Beschreibung |
|---|---|---|---|
message |
String | Nein | Der Benachrichtigungstext, der dem Benutzer angezeigt wird. Beschränken Sie Ihre Nachricht auf 100 Zeichen für eine optimale Benutzerfreundlichkeit. |
actions |
Array von Funktionen | Nein | Die entsprechenden Aktionen für die Nachricht. |
Rückgabewert
Typ: Boolesch
Beschreibung: Gibt an, ob die Methode erfolgreich war.
Anmerkungen
Im Webclient zeigt die addNotification-Methode eine Benachrichtigung mit den Nachrichten, die Sie angegeben haben, an und zwei Standardschaltflächen: Übernehmen und Schließen. Wenn Sie auf Übernehmen klicken, wird die Aktion ausgeführt, die von Ihnen definiert wurde; klicken Sie auf Verwerfen wird die Benachrichtigung geschlossen.
In der einheitlichen Oberfläche:
- Es gibt keine Schließen-Schaltfläche.
- Die Anwenden-Schaltfläche wird nur angezeigt, wenn die Benachrichtigungsstufe auf EMPFEHLUNG eingestellt ist. Sie wird nicht bei FEHLER angezeigt.
Beispiel
Der folgende Beispielcode zeigt eine Benachrichtigung auf der Spalte Kontobezeichnung des Kontoformulars zum Festlegen vom Ticker-Symbol, wenn die Spalte Kontobezeichnung Microsoft enthält und das Tickersymbol noch nicht auf MSFT festgelegt ist. Klicken Sie auf Anwenden in der Benachrichtigung und die Spalte Ticker-Symbol wird auf MSFT festgelegt.
function addTickerSymbolRecommendation(executionContext) {
var formContext = executionContext.getFormContext();
var myControl = formContext.getControl('name');
var accountName = formContext.data.entity.attributes.get('name');
var tickerSymbol = formContext.data.entity.attributes.get('tickersymbol');
if (accountName.getValue() == 'Microsoft' && tickerSymbol.getValue() != 'MSFT') {
var actionCollection = {
message: 'Set the Ticker Symbol to MSFT?',
actions: null
};
actionCollection.actions = [function () {
tickerSymbol.setValue('MSFT');
myControl.clearNotification('my_unique_id');
}];
myControl.addNotification({
messages: ['Set Ticker Symbol'],
notificationLevel: 'RECOMMENDATION',
uniqueId: 'my_unique_id',
actions: [actionCollection]
});
}
else
console.log("Notification not set");
}
So wird die Benachrichtigung in modellgesteuerten Apps angezeigt:
