Več o seznamih

Seznam je konfiguracija, ki temelji na podatkih, in omogoča dodajanje spletne strani, ki upodobi seznam zapisov, pri čemer razvijalcu ni treba izpostaviti mreže na portalu. Z uporabo seznamov lahko zapise izpostavite za prikaz na portalih.

Mreža podpira razvrščanje in je oštevilčena, če je število zapisov večje od določene velikosti strani. Če je določena spletna stran za pogled podrobnosti, bo vsak zapis vseboval povezavo do strani, ID zapisa pa bo dodan nizu poizvedbe skupaj z imenom parametra niza poizvedbe ID-ja. Seznam podpira tudi več pogledov. Če je določen več kot en pogled, bo spustni seznam uporabniku omogočal preklapljanje med različnimi pogledi.

Podatke lahko filtrira tudi trenutni uporabnik portala, račun nadrejene stranke trenutnega uporabnika portala in trenutno spletno mesto portala. Če obstaja vrednost za oba pogoja filtriranja: Atribut uporabnika portala in Atribut računa, bo portal upodobil spustni seznam, da uporabniku omogoči ogled lastnih podatkov (»Moje«) ali podatkov računa nadrejene stranke.

Dodajanje seznama vašemu portalu

Seznam vsebuje odnose s spletnimi stranmi in različne lastnosti za nadzor nad inicializacijo seznama zapisov na portalu. Odnos do spletne strani omogoča dinamično pridobivanje definicije seznama za podano vozlišče strani znotraj spletnega mesta. Za ogled obstoječih pogledov tabele ali za ustvarjanje novih pogledov tabele se pomaknite na Portali > Seznami.

Spletne strani, povezane s seznamom, si lahko ogledate s klikom povezave Spletne strani, ki je prikazana v povezavah za krmarjenje Sorodno v meniju na skrajni levi. Pri ustvarjanju seznama morate najprej izbrati tabelo, za katero želite upodobiti seznam na portalu. Nato izberite enega ali več pogledov aplikacij, ki temeljijo na modelu, za upodobitev.

Ko ustvarjate ali urejate spletno stran, lahko seznam določite v polju za iskanje, ki je na voljo na obrazcu spletne strani. Predloga strani bo običajno predloga »Stran«, vendar je lahko tudi ena od več drugih predlog, izdelanih za vsebino, saj glavne predloge vsebujejo potrebno logiko, s katero se določi, ali je treba upodobiti seznam.

Seznam atributov in odnosov

Dodajanje kode Javascript po meri

Zavihek z možnostmi na obrazcu vsebuje besedilno območje, v katerega lahko vnesete kodo JavaScript po meri; uporabite lahko tudi knjižnico jQuery, če jo vaša stran vsebuje. Blok skripta bo dodan na dnu spletne strani, tik pred zaključno oznako obrazca strani.

Seznam podatke pridobiva asinhrono in ko s tem konča, sproži dogodek loaded (naloženo), ki ga lahko vaša koda JavaScript po meri spremlja in ustrezno obdela elemente v mreži. Koda v nadaljevanju je običajen primer:

$(document).ready(function (){
$(".entitylist.entity-grid").on("loaded", function () {
$(this).children(".view-grid").find("tr").each(function (){
// do something with each row
$(this).css("background-color", "yellow");
});
});
}); 

Poiščite določeno polje atributa in pridobite njegovo vrednost, da bi morda spremenili upodobitev vrednosti. Naslednjo kodo dobi vsaka celica tabele, ki vsebuje vrednost atributa accountnumber (številka računa). Zamenjajte atribut accountnumber s primernim atributom za svojo tabelo in pogled.

$(document).ready(function (){
   $(".entitylist.entity-grid").on("loaded", function () {
      $(this).children(".view-grid").find("td[data-attribute='accountnumber']").each(function (i, e){
         var value = $(this).data(value);
         // now that you have the value you can do something to the value
      });
   });
});

Seznam konfiguracij

Zlahka lahko omogočite in konfigurirate dejanja (ustvarjanje, urejanje, brisanje itd.) za zapise na seznamu. Prav tako je mogoče preglasiti privzete oznake, velikosti in druge atribute, tako da je seznam prikazan točno tako, kot želite.

Te nastavitve so v razdelku za konfiguracijo na obrazcu seznama. Prikazane so samo privzete Osnovne nastavitve. Izberite Napredne nastavitve, če želite videti dodatne nastavitve.

Atributi

Splošne nastavitve dejanj

Na splošno imajo dejanja tabel nastavitve, ki jih je mogoče konfigurirati. V vseh primerih imate tako več možnosti, kar zadeva prilagajanje, polja pa niso obvezna. Preprosto dodajte dejanje in to bo omogočilo izvajanje dejanja na portalu, če je bila ustrezna pravica dodeljena v dovoljenjih za tabele.

Na splošno lahko konfigurirate ustrezno pogovorno okno za vsako dejanje, okno pa bo prikazano le, če izberete Zahtevana potrditev.

Napredne nastavitve splošnega pogovornega okna

Nastavitve dejanja ustvarjanja

Omogočanje možnosti Dejanje ustvarjanja upodobi gumb nad seznamom entitet, ki ob kliku prikaže pogovorno okno z osnovnim obrazcem, ki uporabniku omogoči, da ustvari nov zapis, če je pravica »Ustvarjanje« dodeljena z dovoljenji za tabele.

Napredne nastavitve pogovornega okna »Ustvarjanje obrazca«

Nastavitve dejanja prenosa

Omogočanje možnosti Dejanje prenosa upodobi gumb nad seznamom, ki ob kliku začne prenos podatkov s seznama v datoteko Excel (.xlsx).

Nastavitve dejanja podrobnosti

Omogočanje možnosti Dejanje podrobnosti omogoči uporabniku, da prikaže osnovni obrazec samo za branje za izbrano vrstico na seznamu.

Podrobne nastavitve pogovornega okna za podrobnosti

Nastavitve dejanja urejanja

Omogočanje možnosti Dejanje urejanja omogoči uporabniku, da prikaže osnovni obrazec, ki ga je mogoče urediti in je vezan na podatke, ki so omejeni na zapis izbrane vrstice s seznama entitet, če je bila pravica »Pisanje« dodeljena v dovoljenjih za tabele.

Napredne nastavitve pogovornega okna urejanja obrazca

Nastavitve dejanja brisanja

Omogočanje možnosti Dejanje brisanja omogoči uporabniku, da trajno izbriše zapis izbrane vrstice s seznama entitet, če je bila pravica »Brisanje« dodeljena v dovoljenjih za tabele.

(Napredne) nastavitve pogovornega okna brisanja

Nastavitve dejanja poteka dela

Omogočanje možnosti Dejanje poteka dela omogoči uporabniku, da v zapisu izbrane vrstice s seznama zažene potek dela na zahtevo. Seznamu lahko dodate poljubno število dejanj poteka dela.

Zaščita seznamov

Če želite zaščititi seznam, morate konfigurirati dovoljenja za tabele, in sicer za tisto tabelo, za katero so prikazani zapisi, poleg tega pa morate izbrati potrditveno polje za nastavitev Omogočanje dovoljenj za tabelo. Če tega ne storite, se bo prikazalo naslednje opozorilo:

»Za ta zapis morajo biti omogočena dovoljenja za tabelo, sicer si lahko vsak v internetu ogleda podatke.«

Dejanje zaščite seznama bo zagotovilo, da bodo za vsakega uporabnika, ki dostopa do strani, prikazani samo zapisi, za katere so jim bila podeljena dovoljenja. To se doseže z dodajanjem dodatnega filtra v poglede aplikacij, ki temeljijo na modelu, ki so prikazani prek seznama. Ta filter bo filtriral samo zapise, ki so uporabniku dostopni prek dovoljenja Branje.

Poleg tega bodo vsa dejanja, ki so opredeljena za seznam, spoštovala pripadajoča dovoljenja za zadevno dejanje na podlagi posameznega zapisa. Če imate dovoljenje »Urejanje« za zapis, bo za ta zapis omogočeno dejanje urejanja. Enako velja za brisanje, ustvarjanje itd. Upoštevajte, da bo v primeru, da ni na voljo noben zapis, prikazano ustrezno sporočilo, ko se seznam naloži.

Vendar pa dobro oblikovanje spletnega mesta zahteva, da v primeru, ko uporabnik nima vloge, ki ima poljubna dovoljenja za to tabelo (tj. nikoli ne more priti do tega, da bi videli poljubne zapise), sploh ne bi smel dostopati do strani. V najboljšem primeru bi morala biti stran zaščitena z uporabo dovoljenj za dostop do spletne strani.

Če ste zaščitili seznam z izbiro Omogoči dovoljenja za tabele in želite prikazati dejanja na ravni zapisov, ki veljajo za prijavljenega uporabnika, morate nastaviti vrednost nastavitve mesta EntityList/ShowRecordLevelActions na true. Obstajata na primer dva uporabnika: Preston in Teddy. Preston ima na ravni stika popoln dostop v tabeli primera, medtem ko ima Teddy globalni dostop za branje. Če se ustvari seznam, ki prikazuje vse zapise primerov, bo Preston videl vsa dejanja (ogled, urejanje in brisanje) na zapisih, ki so povezani z njegovim stikom. V drugih zapisih vidi samo dejanje Prikaži. Nasprotno pa Teddy vidi samo dejanje Prikaži v vseh zapisih.

Če je nastavitev mesta EntityList/ShowRecordLevelActions nastavljena na false in ima tabela več dovoljenj, bodo vidna vsa dejanja na ravni zapisa. Toda ko uporabnik poskusi izvesti dejanje, za katerega ni pooblaščen, se prikaže napaka.

Dodajanje strani ogleda podrobnosti

Z nastavitvijo iskanja spletne strani za pogled podrobnosti na spletni strani je mogoče podrobnosti zapisa, navedenega v mreži, prikazati kot samo za branje ali kot urejeno, odvisno od konfiguracije povezanega obrazca ali strani.

Ta stran je lahko predloga strani, oblikovana popolnoma po meri, morda ustvarjena z jezikom Liquid. Najbolj pogost primer je verjetno, da je stran podrobnosti spletna stran, ki bodisi vsebuje osnovni ali napredni obrazec.

Pomembno se je zavedati, da ima vsak zapis, naveden v mreži, hiperpovezavo do strani podrobnosti in da bo povezava vsebovala imenovani parameter niza poizvedbe z ID-jem zapisa. Ime parametra niza poizvedbe je odvisno od imena parametra niza poizvedbe ID-ja, navedenega na seznamu. Zadnja stvar, ki jo je potrebno omeniti, je, da mora biti ciljana spletna stran podrobnosti obveščena o imenu tega parametra niza poizvedb, da bi pridobila ID zapisa, ki ga potrebuje za poizvedbo in nalaganje njenih podatkov.

Uporaba osnovnega obrazca za prikaz podrobnosti

Za ustvarjanje osnovnega obrazca si oglejte navodila, ki so na strani osnovnega obrazca.

V nadaljevanju so pomembne nastavitve, na katere je treba biti pozoren, da se zagotovi, da se zapis z osnovnega seznama naloži na spletni obrazec.

Ime parametra ID-ja zapisa na osnovnem obrazcu se mora ujemati z imenom parametra ID-ja, navedenim na seznamu.

Način je lahko »Urejanje« ali »Samo za branje«, odvisno od vaših potreb.

Uporaba naprednega obrazca za prikaz podrobnosti

V nadaljevanju so pomembne nastavitve, na katere je treba biti pozoren, da se zagotovi, da se zapis z osnovnega seznama naloži na napredni obrazec.

Ime parametra niza poizvedb primarnega ključa na koraku naprednega obrazca se mora ujemati z imenom parametra niza poizvedbe ID-ja, navedenim na seznamu.

Način je lahko »Urejanje« ali »Samo za branje«, odvisno od vaših potreb.

Uporaba strani podrobnosti za funkcijo ustvarjanja

Stran po meri, osnovni ali napredni obrazec lahko za funkcijo ustvarjanja uporabite na enak način. To je alternativa opredelitvi dejanja ustvarjanja na obrazcu. Dejanja ustvarjanja in strani po meri ni mogoče skupaj opredeliti za ustvarjanje: opredelitev dejanja po meri ima prednost.

Če dodelite spletno stran iskanju ustvarjanja na seznamu in ne navedete dejanja ustvarjanja z uporabo konfiguracije, potem bo gumb za ustvarjanje upodobljen na seznamu; ta gumb bo uporabnika preusmeril na stran po meri, ki ste jo namenili za ustvarjanje.

Konfiguracija filtra seznama

Dodajanje zmožnosti filtriranja zapisov na seznamu je preprosto: enostavno omogočite možnost filtriranja in nato izberite eno ali več vrst filtriranja za prikaz uporabnikom. Mogoče je filtrirati po atributu, ki se ujema z besedilom, ki ga je vnesel uporabnik, ali izbirati iz niza možnosti. Oblikujete lahko celo poljubno vrsto filtra, ki si jo lahko zamislite, z uporabo naprednega iskanja.

Omogočenje filtra seznama

V razdelku Filter metapodatkov izberite potrditveno polje Omogočeno. S tem dodate območje filtra na seznam, ko je prikazan. Dokler ne opredelite najmanj ene vrste filtra, bo polje prikazano prazno.

Z uporabo nastavitev usmeritve lahko opredelite, kako bo upodobljeno območje filtra na seznamu. Privzeto je nastavljena vodoravna usmeritev, ki upodobi območje filtra nad seznamom. Navpična usmeritev upodobi območje filtra kot polje levo od seznama.

Vrste filtrov

Filter besedila

Filter besedila doda polje z besedilom na območje filtra seznama, ki je vezano na atribut vrste seznama tabele. Ko uporabnik uporabi filter, seznam prikaže samo tiste zapise, katerih izbrani atribut vsebuje vrednost.

Če želite dodati filter besedila, izberite +Filter besedila.

Filter besedila uporablja naslednje atribute:

Nabor atributov filtrov

Nabor atributov filtrov doda serijo možnosti za filtriranje seznama, povezano z enotnim atributom izbrane vrste tabele seznama. Ko uporabnik uporabi filter, seznam prikaže samo tiste zapise, ki se natančno ujemajo z najmanj eno od izbranih možnosti.

Nabor atributov filtrov uporablja naslednje atribute:

Možnosti nabora atributov filtrov

Nabor atributov filtrov ima lahko običajno poljubno število možnosti, kar ne velja za atribute »Picklist« in »Boolean«. Nabor atributov filtrov »Boolean« ima lahko samo eno ali dve možnosti – eno možnost »true« in eno možnost »false«. Nabor atributov filtrov »Picklist« ima lahko največ eno možnost za vsako možno vrednost na seznamu aktualnih podatkov.

Možnosti imajo naslednje atribute:

Nabor možnosti iskanja

Nabor možnosti iskanja doda niz možnosti za filtriranje seznama, povezanega s sorodno tabelo izbrane vrste tabele seznama. Ko uporabnik uporabi filter, seznam prikaže samo tiste zapise, ki se natančno ujemajo z najmanj enim od izbranih sorodnih zapisov.

Nabor možnosti iskanja uporablja naslednje atribute:

Možnosti nabora iskanja

Nabor možnosti iskanja lahko običajno ima poljubno število možnosti, pri čemer je edina omejitev število sorodnih zapisov izbrane sorodne vrste.

Možnosti imajo naslednje atribute:

Nabor filtrov obsega

Nabor filtrov obsega doda serijo možnosti, vsako z enim ali dvema pogojema, na območje filtra. Ko uporabnik uporabi filter, seznam prikaže samo tiste zapise, ki se natančno ujemajo z vsemi pogoji pri najmanj eni od izbranih možnosti.

Nabor filtrov obsega uporablja naslednje atribute:

Možnosti nabora filtrov obsega

Nabor filtrov obsega lahko ima poljubno število možnosti. Vsaka možnost bo proizvedla pogoj filtra z enim ali dvema podpogojema, pri čemer morata biti oba izpolnjena, da je izpolnjen pogoj.

Možnosti imajo naslednje atribute:

Dinamični nabor seznamov aktualnih podatkov

Dinamični nabor seznamov aktualnih podatkov doda serijo možnosti za filtriranje, ki predstavlja vse vrednosti določenega polja seznama aktualnih podatkov. To se razlikuje od izbire seznama aktualnih podatkov v naboru atributov filtrov. V naboru atributov filtrov morate navesti nabor možnosti, ki bo dan na razpolago uporabniku za filtriranje; v dinamičnem naboru seznamov aktualnih podatkov pa morate navesti samo polje seznama aktualnih podatkov in celoten nabor možnosti se zagotovi samodejno. Če potrebujete večji nadzor, priporočamo uporabo nabora atributov filtrov.

Dinamični nabor seznamov aktualnih podatkov uporablja naslednje možnosti:

Dinamični nabor možnosti iskanja

Dinamični nabor možnosti iskanja doda dinamični niz možnosti za filtriranje seznama, povezanega s sorodno tabelo izbrane vrste tabele seznama. Ko uporabnik uporabi filter, seznam prikaže samo tiste zapise, ki se natančno ujemajo z najmanj enim od izbranih sorodnih zapisov.

To se razlikuje od nabora možnosti iskanja. V naboru možnosti iskanja morate ročno določiti povezane tabele, po katerih filtrirate. V dinamičnem naboru možnosti iskanja morate navesti samo odnos, po katerem filtrirate, in seznam možnosti se ustvari na podlagi navedenega pogleda sorodnih tabel.

Nabor dinamičnega iskanja uporablja naslednje možnosti:

Filter FetchXML

Filter obsega lahko ustvari preprost filter polja z besedilom, kot je filter besedila, ali nabor možnosti, kot so druge vrste filtrov. Omogoča vam ročno ustvarjanje skorajda vseh vrst filtrov za seznam z uporabo možnosti FetchXML.

Filter FetchXML uporablja samo en atribut:

Pogled zemljevida seznama

S seznami je mogoče omogočiti in konfigurirati pogled zemljevida za podatke, ki ga poganjajo zemljevidi Bing, s funkcijo iskanja za iskanje lokacij v bližini naslova. Z dopolnjevanjem zapisov z vrednostmi koordinat zemljepisne širine in dolžine ter navedbo potrebnih možnosti konfiguracije, navedenih v tem razdelku, se lahko vaši zapisi upodobijo kot žebljički na zemljevidu. Vsak zapis, ki nima vrednosti zemljepisne širine ali dolžine, bo izključen iz iskanja. Začetna obremenitev strani bo prikazovala vse zapise v prvotni vrednosti polja vrednosti razdalje (v miljah ali km, odvisno od določenih enot razdalje) iz koordinat privzete širine središča in privzete dolžine središča. Naveden pogled se prezre, ko se uporabi pogled zemljevida, in poizvedba razdalje se uporabi za nabor podatkov, da vrne rezultate, ki jih je mogoče preslikati.

Pogled koledarja seznama

Uporabite pogled koledarja seznama za upodobitev seznama v obliki koledarja, pri čemer bo vsak posamezni zapis konfiguriran tako, da bo deloval kot posamezni dogodek.

Za prikaz zapisov z uporabo koledarja, morajo ti zapisi vključevati najmanj polje datuma. Da bi dogodki imeli natančne čase začetka in konca, morajo biti umeščena primerna polja itd. Če so ta polja konfigurirana, bo pogled koledarja seznama prikazan na portalu.

Viri OData seznama

Če je omogočeno, je lahko tabela objavljena na viru OData. Protokol OData je protokol na ravni aplikacij za interakcijo s podatki prek spletnih storitev RESTful. Podatke iz tega vira lahko prikažete v spletnem brskalniku, dovedete v spletno aplikacijo na strani odjemalca ali uvozite v Excel.

Izboljšan filter pogleda za sezname

Če želite zaščititi zapise, lahko uporabite dovoljenja za tabelo, vendar če želite preprosto omogočiti filter kot del nabora možnosti filtra, ki ga trenutni uporabnik portala lahko uporabi, lahko uporabite funkcijo seznama. Ta funkcija podpira filtriranje trenutnega uporabnika, uporabnikovega nadrejenega računa ali spletne spletnega mesta na kateri koli globini. Preprosto ustvarite filter pogleda, da zagotovite ujemanje poljubnega posameznega zapisa stika in koda bo zamenjala njegovo vrednost z dejansko vrednostjo med izvajanjem – v razdelek pogojev filtra poljem ni treba dodeljevati vrednosti.

• Kontrolnik bo poiskal vse elemente pogoja, kjer velja uitype="contact" in nastavil vrednost na dejansko vrednost trenutnega ID-ja stika uporabnika portala.
• Kontrolnik bo poiskal vse elemente pogoja, kjer velja uitype="account" in nastavil vrednost na dejansko vrednost trenutnega ID-ja nadrejenega računa uporabnika portala.
• Kontrolnik bo poiskal vse elemente pogoja, kjer velja uitype="adx_website" in nastavil vrednost na dejansko vrednost trenutnega ID-ja spletnega mesta.

Primer meril filtra pogleda

Naslednja slika prikazuje arbitraren stik, dodeljen pogoju filtra; ta stik je slepi »lažni« stik, toda gre lahko za poljuben stik. ID tega zapisa bo nadomeščen z dejansko vrednostjo ID-ja uporabnika, ki si ogleduje stran. Če uporabnik ni prijavljen, potem ne bo vrnjenih stikov. To zagotavlja večjo prilagodljivost pri filtriranju podatkov na podlagi uporabnika in spletnega mesta glede na kontekst.

Glejte tudi

• Microsoft Learn: Prikaži več Dataverse zapisov s seznami
• Konfiguriranje portala
• Preusmeritev na novi URL na portalu