Dodajanje ikon po meri pogledu seznama
Ta tema velja za Dynamics 365 Customer Engagement (on-premises). Če vas zanima različica te teme za Power Apps, glejte: Prikaz ikon po meri poleg vrednosti v pogledih seznama
Skrbniki in prilagojevalci lahko s programskim jezikom JavaScript v pogled dodajo grafike in ustvarijo logiko, s pomočjo katere izberejo grafike na podlagi vrednosti stolpcev. Z zmogljivostjo lahko prilagodite poglede seznama, ki prikazujejo ikone poleg besedilnih ali številskih vrednosti, na primer v tem stolpcu Ocena v pogledu Vse priložnosti .
Ikone po meri v pogledih seznama so lahko prikazane v poenotenem vmesniku, klasičnem spletnem odjemalcu, mobilni aplikaciji in aplikaciji za Outlook.
Dodajanje grafike po meri in programskega jezika JavaScript kot spletnih virov
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).
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. Za primer funkcije glejte Vzorčna funkcija JavaScript v nadaljevanju tega tema.
Vpišite se v svoje okolje kot skrbnik in odprite raziskovalca rešitev.
Odpre se pojavno okno Privzeta rešitev . Pomaknite se do spletnih virov>komponent tukaj.
Zdaj boste vsako grafiko po meri posebej prenesli kot spletni vir. Izberite gumb Novo v orodni vrstici, da ustvarite nov spletni vir. Odpre se drugo pojavno okno, s katerim lahko ustvarite vir. Naredite nekaj od tega:
Dajte novemu viru pomenljivo ime. To je ime, s katerim se boste sklicevali na posamezno grafiko iz kode JavaScript.
Vrsto nastavite na grafično obliko, ki ste jo uporabili za shranjevanje grafične datoteke (PNG, JPEG ali GIF).
Izberite Izberi datoteko , da odprete okno brskalnika datotek. Z njim poiščite grafično datoteko in jo izberite.
Če želite, dodajte prikazno ime in/ali opis .
Izberite Shrani in zaprite okno spletnega vira .
Prejšnji korak ponovite za vse grafične datoteke, ki jih imate.
Zdaj boste programski jezik JavaScript dodali kot končni spletni vir. V orodni vrstici izberite Novo , da ustvarite nov spletni vir. Odpre se drugo pojavno okno, s katerim lahko ustvarite vir. Naredite nekaj od tega:
Dajte novemu viru pomenljivo ime.
Vrsto nastavite na Skript (JScript).
Izberite Urejevalnik besedila (poleg nastavitve Vrsta ), da odprete okno urejevalnika besedila. Prilepite kodo Javascript tukaj in izberite V redu , da jo shranite.
Če želite, dodajte prikazno ime in/ali opis .
Izberite Shrani in zaprite okno spletnega vira .
Ko je pojavno okno Privzeta rešitev še vedno odprto, razširite drevo entitet>komponent in poiščite entiteto, ki jo želite prilagoditi.
Razširite svojo entiteto in izberite njeno ikono Pogledi .
Zdaj vidite seznam pogledov za izbrano entiteto. Izberite pogled s seznama. Nato odprite spustni seznam Več dejanj v orodni vrstici in izberite Uredi.
Odpre se pojavno okno s kontrolniki za urejanje izbranega pogleda. Prikazan je vsak stolpec, ki je del pogleda. Izberite ciljni stolpec in nato izberite Spremeni lastnosti v polju Pogosta opravila . Odpre se pogovorno okno Spremeni lastnosti stolpca; tukaj naredite naslednje:
Spletni vir: določite ime spletnega vira, ki ste ga ustvarili za shranjevanje funkcij Javascript (izberite Prebrskaj , da izberete s seznama).
Ime funkcije: Vnesite ime funkcije, ki ste jo napisali, da spremenite izbrani stolpec in pogled.
Izberite V redu , da zaprete pogovorno okno Spremeni lastnosti stolpca.
Izberite Shrani in zapri, da shranite pogled.
Po potrebi ponovite te korake za vsako entiteto, pogled in stolpec, kot je potrebno.
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 za Dynamics 365 for Customer Engagement. Če si želite ogledati seznam vrednosti LCID (locale ID), ki jih lahko uporabite v kodi, glejte Microsoftovi ID-ji območnih nastavitev.
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 za določitev ikone potrebno pridobiti podatke, poenoteni vmesnik podpira vrnitev predmeta obljube JavaScript, ki se razreši z logično vrednostjo (podobno kot pravila 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.
"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;
}