Prikaz ikon po meri skupaj z vrednostmi v pogledih seznama

Skrbniki in prilagojevalci okolja storitve Power Apps lahko s programskim jezikom JavaScript v pogled dodajo grafike in ustvarijo logiko, s pomočjo katere izberejo grafike na podlagi vrednosti stolpcev. Tako lahko prilagodite poglede seznama, v katerih so prikazane ikone ter besedilne in številske vrednosti.

Ta primer prikazuje ikone po meri v pogledu za tabelo priložnosti, ki je na voljo z določenimi aplikacijami, kot je Dynamics 365 Sales. Ikone po meri lahko prikažete v pogledih z drugimi standardnimi tabelami, kot je tabela kupca ali stika, ter s tabelami po meri.

Pogled »Vse priložnosti« s stolpcem »Ocena«, v katerem so prikazane ikone in besedilna vrednost.

Ikone po meri v pogledih seznama so lahko prikazane v poenotenem vmesniku, podedovanem spletnem odjemalcu, mobilni aplikaciji in aplikaciji za Outlook.

Dodajanje grafike po meri in programskega jezika JavaScript kot spletnih virov

  1. Ustvarite nove grafične datoteke, ki so potrebne za prilagajanje. Priporočena velikost ikone je 16 x 16 slikovnih pik (večje slike bodo pomanjšane).

  2. Napišite eno ali več funkcij JavaScript, ki določajo, katere ikone je treba prikazati za določene vrednosti (ponavadi potrebujete eno funkcijo za vsak stolpec, ki ga želite prilagoditi). Vsaka funkcija mora sprejeti podatkovni predmet vrstice in kodo jezika (LCID) kot vnos in vrniti polje, ki vsebuje ime slike in besedilo opisa orodja. Primer funkcije je na voljo v razdelku Vzorčna funkcija JavaScript v nadaljevanju tega članka.

  3. Vpišite se v svoje okolje kot skrbnik in odprite raziskovalca rešitev.

  4. Odpre se pojavno okno Privzeta rešitev. Tukaj se pomaknite v razdelek Komponente > Spletni viri.

  5. Zdaj boste vsako grafiko po meri posebej prenesli kot spletni vir. Če želite ustvariti nov spletni vir, v orodni vrstici izberite gumb Novo. Odpre se drugo pojavno okno, s katerim lahko ustvarite vir. Sledite tem navodilom:

    1. Za novi vir vnesite smiselno Ime. To je ime, s katerim se boste sklicevali na posamezno grafiko iz kode JavaScript.

    2. Vrsto nastavite v grafično obliko, ki ste jo uporabljali za shranjevanje grafične datoteke (PNG, JPEG ali GIF).

    3. Izberite Izberite datoteko, da odprete okno datotečnega brskalnika. Z njim poiščite grafično datoteko in jo izberite.

    4. Po želji dodajte Prikazno ime in/ali Opis.

    5. Izberite Shrani in nato zaprite okno Spletni vir.

  6. Prejšnji korak ponovite za vse grafične datoteke, ki jih imate.

  7. Zdaj boste programski jezik JavaScript dodali kot končni spletni vir. Če želite ustvariti nov spletni vir, v orodni vrstici izberite Novo. Odpre se drugo pojavno okno, s katerim lahko ustvarite vir. Naredite nekaj od tega:

    1. Za novi vir vnesite smiselno Ime.

    2. Polje Vrsta nastavite na Skript (JScript).

    3. Izberite Urejevalnik besedila (poleg nastavitve Vrsta), da odprete okno urejevalnika besedila. Tu prilepite kodo Javascript in izberite V redu, da jo shranite.

    4. Po želji dodajte Prikazno ime in/ali Opis.

    5. Izberite Shrani in nato zaprite okno Spletni vir.

  8. Medtem ko je pojavno okno Privzeta rešitev odprto, razširite drevesni prikaz Komponente > Tabele in poiščite tabelo, ki jo želite prilagoditi.

  9. Razširite tabelo in izberite ikono Pogledi.

  10. Zdaj vidite seznam pogledov za izbrano tabelo. Izberite pogled s seznama. Nato v orodni vrstici odprite spustni seznam Več dejanj in izberite Uredi.

  11. Odpre se pojavno okno s kontrolniki za urejanje izbranega pogleda. Prikazan je vsak stolpec, ki je del pogleda. Izberite ciljni stolpec, nato pa v polju Pogosta opravila izberite Spremeni lastnosti. Odpre se pogovorno okno Spremeni lastnosti stolpca; tu izvedite naslednje nastavitve:

    • Spletni vir: določite ime spletnega vira, ki ste ga ustvarili z namenom, da omogoča funkcije Javascript (izberite Prebrskaj, da na seznamu izberete ime).

    • Ime funkcije: vnesite ime funkcije, ki ste jo napisali za spreminjanje izbranega stolpca in pogleda.

  12. Če želite zapreti pogovorno okno Spremeni lastnosti stolpca, izberite V redu.

  13. Če želite shraniti pogled, izberite Shrani in zapri.

  14. Po potrebi ponovite te korake za vsako tabelo, pogled in stolpec, kot je potrebno.

  15. Ko ste pripravljeni, izberite Objavi vse prilagoditve, da objavite spremembe. Nato zaprite okno Privzeta rešitev.

Vzorčna funkcija JavaScript

Funkcija JavaScript za prikazovanje ikon in opisov orodja po meri pričakuje naslednji dve trditvi: celoten predmet vrstice, naveden v postavitvi layoutxml, in lokalni ID kličočega uporabnika (LCID). Parameter LCID omogoča, da besedilo opisa orodja določite v več jezikih. Če želite več informacij o jezikih, ki jih podpira okolje, glejte Omogočanje jezikov in Namestitev ali nadgradnja jezikovnih paketov. Če želite seznam lokalnih vrednosti ID-jev (LCID), ki jih lahko uporabite v kodi, glejte Lokalni ID-ji, ki jih je dodelil Microsoft.

Ob predpostavki, da boste za atribut z naborom možnosti, ki ima omejen nabor vnaprej določenih možnosti, dodajali ikone po meri, poskrbite, da namesto oznake uporabite celoštevilsko vrednost možnosti in se na ta način izognete težavam pri lokalizaciji.

Opomba: če je treba za določitev ikone pridobiti podatke, poenoteni vmesnik podpira vrnitev predmeta JavaScript Promise, ki se razreši na logično vrednost (podobno kot pri pravilih traku). V funkcionalnosti po meri ne uporabljajte sinhrone zahteve XMLHttpRequest (XHR).

Naslednja vzorčna koda prikazuje ikone in opise orodij, ki temeljijo na eni od treh vrednosti (1: »Visoka«, 2: »Srednja«, 3: »Nizka«) v atributu »opportunityratingcode« (»Ocena«). Vzorčna koda prikazuje tudi, kako prikazati lokalizirano besedilo opisa orodja. Če želite, da ta vzorec deluje, morate ustvariti tri spletne vire slike s slikami velikosti 16 x 16 slikovnih pik in jih poimenovati s temi imeni: new_Hot, new_Warm in new_Cold.

Pomembno

V tem vzorcu je zahtevana tabela priložnosti, ki je na voljo v aplikaciji Dynamics 365 Sales.

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

Delovanje prikaza pogleda ikon po meri

Primarni stolpci

V pogledu mrežnega seznama ikone po meri, uporabljene v primarnem stolpcu tabele, nadomestijo privzeto sistemsko ustvarjeno ikono.

Primarni stolpec nadomesti privzeto ikono v pogledu ikone po meri.

Drugi stolpci

V pogledu mrežnega seznama so ikone po meri, uporabljene v stolpcu, ki ni primarni stolpec tabele, prikazane kot sekundarna ikona poleg privzeto sistemsko ustvarjene ikone.

Ni pogled ikone po meri primarnega stolpca tabele.

Obrazci kartice

Ikone po meri nadomestijo privzeto ikono, ki jo ustvari sistem, ko je pogled konfiguriran za uporabo obrazca kartice.

Pogled ikone po meri pogleda kartice.

Glejte tudi

Razumevanje pogledov aplikacij, ki temeljijo na modelu

Opomba

Ali nam lahko poveste, kateri je vaš prednostni jezik za dokumentacijo? Izpolnite kratko anketo. (upoštevajte, da je v angleščini)

Z anketo boste porabili približno sedem minut. Ne zbiramo nobenih osebnih podatkov (izjava o zasebnosti).