Egyéni ikonok megjelenítése értékek mellett a listanézetben
A Power Apps környezet rendszergazdái és a testre szabásért felelősök grafikákat adhatnak egy nézethez, és JavaScript-ben létrehozhatják a logikát, amellyel a grafikák kiválasztásra kerülnek az oszlop értékei alapján. A tulajdonság lehetővé teszi a szöveg vagy numerikus értékek mellett ikonokat megjelenítő nézetek testreszabását.
Ez a példa egyéni ikonokat jelenít meg a lehetőség táblára vonatkozóan, amely bizonyos alkalmazásokkal, például a Dynamics 365 Sales alkalmazással érhető el. Az egyéni ikonokat más szabványos táblákkal, például partner-vagy kapcsolattartó táblával, valamint egyéni táblákkal is megjelenítheti.
A listanézet egyéni ikonjai az egyesített felületen, a régebbi webes ügyfélprogramban, a mobilalkalmazásban és az Outlook alkalmazásban is megjeleníthetők.
Megjegyzés
Az egyéni ikonok nem érhetők el, ha az alkalmazás mobile offline módban van.
Egyedi képi elemek és JavaScript hozzáadása webes erőforrásokhoz
Hozza létre a testreszabáshoz szükséges új grafikai fájlokat. 16 x 16 pixel méretű ikont javaslunk (a nagyobb képeket a program átméretezi).
Írjon egy vagy több olyan JavaScript-függvényt, amely meghatározza, melyik értékhez melyik ikon jelenjen meg (általában minden testre szabni kívánt oszlophoz egy függvényre van szükség). Minden funkciónak fogadnia kell egy soradatobjektumot és egy nyelvi (LCID) kódot bemenetként, eredményként pedig egy képnevet és karakterláncszöveget tartalmazó sort kell adnia. A függvényre vonatkozó példához lásd: Példa JavaScript-függvényre részt a jelen cikkben.
Jelentkezzen be a környezetbe rendszergazdaként, és nyissa meg a megoldáskezelőt.
Megjelenik az Alapértelmezett megoldás előugró ablak. Itt navigáljon a Komponensek > Webes erőforrások menüpontba.
Most egyesével feltöltheti az egyedi képeket erőforrásként. Új webes erőforrás létrehozásához válassza az eszköztár Új gombját. Az erőforrás létrehozásához egy másik előugró ablak nyújt segítséget. Tegye a következőket:
Adjon beszédes Nevet az új erőforrásnak. Ez lesz a név, amellyel hivatkozik az egyes képekre a JavaScript-kódban.
A Típust állítsa be a grafikai fájl mentésekor használt grafikai formátumra (PNG, JPEG vagy GIF).
Válassza a Fájlválasztás lehetőséget a fájlböngésző ablak megnyitásához. Ennek segítségével keresse meg, és válassza ki a grafikai fájlt.
Igény szerint adjon hozzá egy Megjelenítendő nevet és/vagy Leírást.
Válassza a Mentés lehetőséget, majd zárja be a Webes erőforrás ablakot.
Ismételje meg az előző lépést minden grafikai fájl esetén.
Most adja hozzá a JavaScriptet az utolsó webes erőforrásként. Új webes erőforrás létrehozásához válassza az eszköztár Új gombját. Az erőforrás létrehozásához egy másik előugró ablak nyújt segítséget. Végezze el az alábbi műveleteket:
Adjon beszédes Nevet az új erőforrásnak.
A Típust állítsa a Script (JScript) lehetőségre.
Válassza a Szövegszerkesztőt (a Típus mellett), és nyissa meg a szövegszerkesztő ablakot. Másolja be ide a JavaScript-kódot, majd a mentéshez válassza az OK gombot.
Igény szerint adjon hozzá egy Megjelenítendő nevet és/vagy Leírást.
Válassza a Mentés lehetőséget, majd zárja be a Webes erőforrás ablakot.
Az Alapértelmezett megoldás előugró ablakot ne zárja be, és bontsa ki az Összetevők > Táblák fát, majd keresse meg a testreszabni kívánt táblát.
Bontsa ki a táblát és válassza ki a Nézetek ikonját.
Most láthatja a kiválasztott táblához tartozó nézetek listáját. Válasszon egy nézetet a listáról. Az eszköztár További műveletek legördülő listájáról válassza a Szerkesztés lehetőséget.
Megnyílik egy előugró ablak, amely a kiválasztott nézet szerkesztéséhez szükséges vezérlőket tartalmazza. Ez az ablak a nézet részét képező minden oszlopot megjelenít. Kattintással válassza ki a céloszlopot, majd válassza a Tulajdonságok módosítását a Gyakori feladatok panelen. Az Oszloptulajdonságainak módosítása párbeszédpanel megnyílik; itt hajtsa végre az alábbi lépéseket:
Webes erőforrás: Adja meg a Javascript-függvények (a Tallózás gombbal válassza ki a listáról) tárolására létrehozott webes erőforrás nevét.
Függvénynév: írja be annak a függvénynek a nevét, amelyet a kiválasztott oszlop és nézet módosítására írt.
Az OK gombbal zárja be az Oszloptulajdonságok módosítása párbeszédpanelt.
A nézet mentéséhez válassza a Mentés és bezárás lehetőséget.
Szükség szerint ismételje meg ezeket a lépéseket minden tábla, nézet és oszlop esetén.
Ha elkészült, a módosítások közzétételéhez válassza a Minden testreszabás közzététele lehetőséget. Ezután zárja be az Alapértelmezett megoldás ablakot.
Példa JavaScript-függvényre
Az egyedi ikonokat és eszközleírásokat megjelenítő JavaScript-függvény az alábbi argumentumokat kéri: az egész sorobjektum layoutxml formátumban és a hívó felhasználó területibeállítás-azonosítója (LCID). Az LCID-paraméter segítségével megadhatja az eszközleírás szövegét több nyelven is. A környezet által támogatott nyelvekkel kapcsolatban lásd Nyelvek engedélyezése és Nyelvi csomagok telepítése vagy frissítése. A kódban használható területibeállítás-azonosító (LCID) értékek listájáért lásd: A Microsoft által hozzárendelt területibeállítás-azonosítók.
Ha egyedi ikonokat kíván hozzárendelni egy beállításhalmaz típusú attribútumhoz, amely korlátozott számú előre definiált beállítással rendelkezik, a lokalizációs problémák elkerülése érdekében használjon egész beállításértéket címke helyett.
Megjegyzés: Ha az ikon meghatározásához az adatok beolvasása szükséges, egyesített felület támogatja a JavaScript-ígéret tárgyát képező objektum visszaküldését, amely egy logikai feloldás (a menüszalagra vonatkozó szabályokhoz hasonlóan). Ne használjon szinkron XMLHttpRequest (XHR) kérést az egyéni függvényben.
Az alábbi példakód három érték (1: forró, 2: meleg, 3: hideg) alapján létrehozott ikonokat és eszközleírásokat jelenít meg az opportunityratingcode (minősítés) attribútumban. A mintakódban az is látható, hogy hogyan kell megjeleníteni a lokalizált eszközleírás szövegét. Ahhoz, hogy ez a minta működjön, létre kell hoznia három 16 x 16 méretű képet tartalmazó képi webes erőforrást, és azokat az alábbi nevekkel kell ellátnia: new_Hot, new_Warm, és new_Cold.
Fontos
A következő példában a lehetőség tábláról van szó, amely rendelkezésre áll a Dynamics 365 Sales alkalmazással együtt.
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;
}
Egyéni ikon nézet megjelenítési viselkedése
Elsődleges oszlopok
A rácslista nézetben az elsődleges oszlopra alkalmazott egyéni ikonok lecserélik az alapértelmezett rendszerikonokat.
További oszlopok
A rácslista nézetben az olyan oszlopokra alkalmazott egyéni ikonok, amelyek nem a tábla elsődleges oszlopai másodlagos ikonként jelenik meg, az alapértelmezett rendszer által létrehozott ikon mellett.
Kártyaűrlapok
Az egyéni ikonok lecserélik az alapértelmezett, rendszer által létrehozott ikont, ha a nézet a kártyaűrlap használatára van beállítva.
Kapcsolódó információk
A modellre épülő alkalmazások nézeteinek ismertetése
Megjegyzés
Megosztja velünk a dokumentációja nyelvi preferenciáit? Rövid felmérés elvégzése. (ne feledje, hogy ez a felmérés angol nyelvű)
A felmérés elvégzése körülbelül hét percet vesz igénybe. Semmilyen személyes adatot nem gyűjtünk (adatvédelmi nyilatkozat).