addNotification (referință API client)

Afișează o eroare sau o notificare de recomandare pentru un control și vă permite să specificați acțiuni de executat pe baza notificării. Atunci când specificați un tip de eroare de notificare, apare o pictogramă roșie "X" lângă control. Atunci când specificați un tip de notificare de recomandare, apare o pictogramă "i" lângă control. Pe clienții mobili Dynamics 365, atingerea pictogramei va afișa mesajul și vă permite să efectuați acțiunea configurată făcând clic pe butonul Se aplică sau dezactivând mesajul.

Tipuri de control acceptate

Tot

Sintaxă

formContext.getControl(arg).addNotification(notification);

Parametri

Nume	Tip	Obligatoriu	Descriere
notification	Obiect	Da	Notificarea de adăugat. Vedeți notification parametrul

notification parametru

Parametrul notification acceptă un obiect cu următoarele proprietăți

Nume	Tip	Obligatoriu	Descriere
actions	Matrice de obiecte	Nu	Vedeți actions proprietatea
messages	Matrice de șiruri	Da	Mesajul de afișat în notificare. În versiunea curentă, se va afișa numai primul mesaj specificat în această matrice. Șirul pe care îl specificați aici apare ca text aldin în notificare și este utilizat de obicei pentru titlul sau subiectul notificării. Ar trebui să limitați mesajul la 50 de caractere pentru o experiență optimă de utilizator.
notificationLevel	Șir	Da	Definește tipul de notificare. Valori valide sunt ERROR sau RECOMMENDATION.
uniqueId	Șir	Da	ID-ul de utilizat pentru a goli această notificare atunci când utilizați metoda clearNotification.

actions proprietate

Proprietatea actions conține o matrice de obiecte cu următoarele proprietăți:

Nume	Tip	Obligatoriu	Descriere
message	Șir	Nu	Mesajul de corp al notificării care va fi afișat utilizatorului. Limitați mesajul la 100 de caractere pentru o experiență optimă de utilizator.
actions	Matrice de funcții	Nu	Acțiunile corespunzătoare pentru mesaj.

Valoarea returnată

Tip: Boolean

Descriere: indică dacă metoda a reușit.

Remarci

În clientul web, metoda addNotification afișează o notificare cu mesajele pe care le-ați specificat și două butoane standard: Se aplică și Se respinge. Dacă faceți clic pe Se aplică , se execută acțiunea pe care o definiți; dacă faceți clic pe Îndepărtare , mesajul de notificare se închide.

În interfața unificată:

• Nu există niciun buton Îndepărtare .
• Butonul Aplicare apare doar atunci când nivelul de notificare este setat la RECOMANDARE, nu LA ERROR.

Exemplu

Următorul cod eșantion afișează o notificare în coloana Nume cont a formularului de cont pentru a seta Simbolul Ticker dacă coloana Nume cont conține "Microsoft", iar simbolul ticker nu este setat deja la "MSFT". Dacă faceți clic pe Se aplică în notificare, coloana Simbol Ticker va fi setată la "MSFT".

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");
}

Astfel, notificarea apare în aplicațiile bazate pe modele:

Articole asociate

clearNotification
setNotification