Adăugarea de pictograme particularizate la o vizualizare listă

Acest subiect se aplică la Dynamics 365 Customer Engagement (on-premises). Pentru versiunea Power Apps a acestui subiect, a se vedea: Afișarea pictogramelor particularizate împreună cu valorile în vizualizările de listă

Administratorii și persoanele care realizează particularizări pot adăuga reprezentări grafice într-o vizualizare și stabili logica folosită pentru a selecta un element grafic pe baza valorii coloanei folosind JavaScript. Capabilitatea vă permite să particularizați lista de vizualizări ce afișează pictogramele alături de text sau valori numerice, cum ar fi în această coloană Evaluare în vizualizarea Toate oportunitățile.

Vizualizarea Toate oportunitățile cu coloana Evaluare afișând pictograme și valoare text.

Pictogramele personalizate din vizualizările listei pot fi afișate în Interfață unificată, client web clasic, aplicație mobilă și aplicație pentru Outlook.

Adăugarea elementelor grafice particularizate și JavaScript ca resurse web

  1. Creați fișiere grafice noi necesare pentru particularizare. Vă recomandăm o dimensiune de pictogramă de 16 x 16 pixeli (imaginile mai mari vor fi reduse).

  2. Scrieți una sau mai multe funcții JavaScript care stabilesc ce pictograme să se afișeze și pentru ce valori (de obicei, veți avea nevoie de o funcție pentru fiecare coloană pe care doriți să o particularizați). Fiecare funcție trebuie să accepte un obiect de date de tip rând și un cod de limbă (LCID) ca date de intrare și întoarce o matrice ce conține numele unei imagini și textul sfat ecran. Pentru un exemplu de funcție, consultați Funcție JavaScript eșantion, mai departe în acest articol.

  3. Conectați-vă la mediul dvs. ca administrator și deschideți exploratorul de soluții.

  4. Se deschide fereastra pop-up Soluție implicită. Navigați la Componente > Resurse web aici.

  5. Acum, veți încărca elementele grafice particularizate, pe rând, ca resurse web. Selectați butonul Nou din bara de instrumente pentru a crea o nouă resursă web. Se deschide o altă fereastră pop-up pentru a vă ajuta să creați resursa. Efectuați următoarele activități:

    1. Dați noii resurse un Nume semnificativ. Acesta este numele pe care îl veți utiliza pentru a vă referi la fiecare element grafic din codul JavaScript.

    2. Setați opțiunea Tip la formatul grafic pe care l-ați utilizat pentru a salva fișierul grafic (PNG, JPEG sau GIF).

    3. Selectați Alegeți fișierul pentru a deschide o fereastră de browser de fișiere. Utilizați-o pentru a găsi și selecta fișierul grafic.

    4. Dacă doriți, adăugați un Nume afișat și/sau o Descriere.

    5. Selectați Salvare și apoi închideți fereastra Resursă web.

  6. Repetați pasul anterior pentru fiecare fișier grafic pe care îl aveți.

  7. Acum, veți adăuga JavaScript ca resursă web finală. Selectați butonul Nou din bara de instrumente pentru a crea o nouă resursă web. Se deschide o altă fereastră pop-up pentru a vă ajuta să creați resursa. Efectuați următoarele activități:

    1. Dați noii resurse un Nume semnificativ.

    2. Setați Tip la Script (JScript).

    3. Selectați Editor de text (lângă setarea Tip) pentru a deschide o fereastră de editor de text. Inserați aici codul JavaScript și selectați OK pentru a-l salva.

    4. Dacă doriți, adăugați un Nume afișat și/sau o Descriere.

    5. Selectați Salvare și apoi închideți fereastra Resursă web.

  8. Cu fereastra pop-up Soluție implicită încă deschisă, extindeți arborele Componente > Entități și localizați entitatea pe care doriți să o particularizați.

  9. Extindeți entitatea și selectați pictograma Vizualizări.

  10. Veți vedea acum o listă de vizualizări pentru entitatea selectată. Selectați o vizualizare din listă. Apoi, deschideți lista verticală Mai multe acțiuni din bara de instrumente și selectați Editare.

  11. Se deschide o fereastră pop-up cu controale pentru editarea vizualizării selectate. Aceasta arată fiecare coloană care face parte din vizualizare. Selectați coloana țintă, apoi selectați Modificare proprietăți din caseta Sarcini comune. Se deschide caseta de dialog Modificare proprietăți coloană; aici, efectuați următoarele setări:

    • Resursă web: specificați numele resursei web pe care ați creat-o să includă funcțiile JavaScript (selectați Răsfoire pentru a alege dintr-o listă).

    • Nume funcție: tastați numele funcției pe care ați scris-o pentru a modifica coloana și vizualizarea selectate.

  12. Selectați OK pentru a închide caseta de dialog Modificare proprietăți coloană.

  13. Selectați Salvare și închidere pentru a salva vizualizarea.

  14. Repetați acești pași pentru fiecare entitate, vizualizare și coloană, după cum este necesar.

  15. Când sunteți gata, selectați Publicare toate particularizările pentru a publica modificările. Apoi, închideți fereastra Soluție implicită.

Exemplu de funcție JavaScript

Funcția JavaScript pentru afișarea pictogramelor și a sfaturilor ecran particularizate așteaptă următoarele două argumente: întregul obiect de rând specificat în layoutxml și ID-ul de setări regionale (LCID) al utilizatorului apelant. Parametrul LCID vă permite să specificați textul sfatului ecran în mai multe limbi. Pentru mai multe informații despre limbile acceptate de mediu, consultați Activarea limbilor și Instalarea sau upgrade-ul pachetelor lingvistice pentru Dynamics 365 for Customer Engagement. Pentru o listă a valorilor ID-urilor de setări regionale (LCID) pe care le puteți utiliza în cod, consultați ID-urile de setări regionale atribuite de Microsoft.

Presupunând că veți adăuga pictograme particularizate pentru un tip de atribut cu set de opțiuni, care include un set limitat de opțiuni predefinite, vă recomandăm să utilizați valoarea întreagă a opțiunilor în locul etichetei pentru a evita problemele de localizare.

Notă: Dacă este necesar să preluați date pentru a determina pictograma, Interfața unificată acceptă returnarea unui obiect JavaScript Promise care se rezolvă într-un boolean (similar cu regulile panglicii). Nu utilizați o XMLHttpRequest sincronă (XHR) în funcția dvs. personalizată.

Următorul exemplu de cod afișează pictograme și sfaturi ecran bazate pe una dintre cele trei valori (1: Fierbinte, 2: Cald, 3: Rece) din atributul opportunityratingcode (Evaluare). Exemplul de cod arată, de asemenea, cum să afișați textul sfatului ecran localizat. Pentru ca acest eșantion să funcționeze, trebuie să creați trei resurse web de imagini cu imagini 16x16 cu următoarele nume: new_Hot, new_Warm și new_Cold.

"use strict";

function displayIconTooltip(rowData, userLCID) {      
    var str = JSON.parse(rowData);  
    var coldata = str.opportunityratingcode_Value;  
    var imgName = "";  
    var tooltip = "";  
    switch (parseInt(coldata,10)) { 
        case 1:  
            imgName = "new_Hot";  
            switch (userLCID) {  
                case 1036:  
                    tooltip = "French: Opportunity is Hot";  
                    break;  
                default:  
                    tooltip = "Opportunity is Hot";  
                    break;  
            }  
            break;  
        case 2:  
            imgName = "new_Warm";  
            switch (userLCID) {  
                case 1036:  
                    tooltip = "French: Opportunity is Warm";  
                    break;  
                default:  
                    tooltip = "Opportunity is Warm";  
                    break;  
            }  
            break;  
        case 3:  
            imgName = "new_Cold";  
            switch (userLCID) {  
                case 1036:  
                    tooltip = "French: Opportunity is Cold";  
                    break;  
                default:  
                    tooltip = "Opportunity is Cold";  
                    break;  
            }  
            break;  
        default:  
            imgName = "";  
            tooltip = "";  
            break;  
    }  
    var resultarray = [imgName, tooltip];  
    return resultarray;  
}  

Consultați și

Creați sau editați vizualizări

Hinweis

Ne puteți spune care preferințele dvs. lingvistice pentru documentație? Răspundeți la un chestionar scurt. (rețineți că acest chestionar este în limba engleză)

Chestionarul va dura aproximativ șapte minute. Nu sunt colectate date personale (angajament de respectare a confidențialității).