O popisima

Popis je konfiguracija temeljena na podacima koja pruža mogućnost dodavanje web-stranice koja će renderirati popis zapisa a da razvojni inženjer ne bi morao prikazivati rešetku na portalu. Uz pomoć popisa možete otkriti zapise za prikaz na portalima.

Rešetka podržava sortiranje i bit će numerirana ako je broj zapisa veći od navedene veličine stranice. Ako je navedena web-stranica za prikaz pojedinosti, svaki će zapis sadržavati vezu na stranicu, a ID zapisa će se dodati nizu upita zajedno s nazivom parametra niza upita ID-a. Popis podržava i više prikaza. Ako je navedeno više od jednog prikaza, prikazat će se padajući izbornik kako bi korisnik mogao uključivati i isključivati različite prikaze.

Podaci se mogu filtrirati i prema trenutnom korisniku portala, nadređenom računu klijenta trenutnog korisnika portala i trenutnom web-mjestu portala. Ako vrijednost postoji za oba uvjeta filtra atributa korisnika portala i atributa računa, portal će renderirati padajući popis kako bi dopustio korisniku pregledavati svoje (Moje) podatke ili podatke nadređenog računa klijenta.

Dodavanje popisa na portal

Popis sadrži odnose prema web-stranicama i različitim svojstvima kako bi se kontroliralo pokretanje popisa zapisa na portalu. Odnos s web-stranicom omogućuje dinamičko dohvaćanje definicije popisa za određeni čvor stranice na web-mjestu. Za pregledavanje postojećih prikaza tablice ili za stvaranje novih pregleda tablice, idite na Portali > Popisi.

Web-stranice pridružene popisu mogu se prikazati tako da kliknete vezu Web-stranice navedenu u navigacijskim vezama Povezano na krajnjem lijevom izborniku. Kad stvarate popis, prvi je korak odabir tablice za koju želite prikazati popis na portalu. Zatim ćete odabrati prikaz jedne ili više aplikacija usmjerenih modelu za prikazivanje.

Prilikom stvaranja ili uređivanja web-stranice možete navesti popis u polju pretraživanja na obrascu web-stranice. Predložak stranice obično će biti predložak Stranica, ali može biti i jedan od nekoliko drugih predložaka namijenjenih za sadržaj jer glavni predlošci sadrže logiku potrebnu da biste odredili treba li renderirati popis.

Atributi i odnosi popisa

Dodavanje prilagođenog Javascript koda

Kartica Mogućnosti na obrascu sadrži tekstualno područje u koje možete unijeti prilagođeni JavaScript kod, a ako stranica sadrži jQuery biblioteku, ovdje i nju možete upotrebljavati. Blok za skriptu dodat će se na dno web-stranice neposredno prije završne oznake obrasca stranice.

Popis preuzima podatke asinkrono i kada završi pokrenut će događaj loaded koje vaš prilagođeni JavaScript kod može osluškivati i učiniti nešto sa stavkama na rešetci. Sljedeći kôd je trivijalan primjer:

$(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");
});
});
}); 

Pronađite određeno polje atributa i pronađite njegovu vrijednost kako biste mogli modificirati renderiranje vrijednosti. Sljedeći kod dobiva svaku ćeliju tablice koja sadrži vrijednost atributa accountnumber. Zamijenite accountnumber atributom prikladnim za svoju tablicu i prikaz.

$(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
      });
   });
});

Konfiguracija popisa

Jednostavno možete omogućiti i konfigurirati radnje za zapise na popisu (Stvori, Uredi, Izbriši itd.). Također je moguće prebrisati zadane oznake, veličine i druge atribute kako bi se popis prikazivao točno na željeni način.

Ove se postavke mogu pronaći u odjeljku Konfiguracija u obrascu popisa. Prema zadanim postavkama, prikazuju se samo osnovne postavke. Odaberite Dodatne postavke da biste vidjeli dodatne postavke.

Atributi

Opće postavke akcija

Općenito, akcije tablice imaju postavke koje je moguće konfigurirati. U svim slučajevima, njihova je svrha pružiti vam više mogućnosti u smislu prilagođavanja, a polja nisu potrebna. Jednostavnim dodavanjem akcije omogućit ćete poduzimanje akcije na portalu, ako je odgovarajuća privilegija dodijeljena uz pomoć dozvola tablice.

Općenito, možete konfigurirati odgovarajući dijaloški okvir za svaku akciju koja će se pojaviti samo ako odaberete Potrebna potvrda.

Napredne postavke općenitog dijaloškog okvira

Postavke akcije stvaranja

Omogućivanje Stvaranje akcije prikazuje gumb iznad popisa iz koje, kada se klikne, otvara dijaloški okvir s osnovnim obrascem koji korisniku omogućuje stvaranje novog zapisa ako je privilegija Stvaranje dodijeljena uz pomoć dozvola tablice.

Dijaloški okvir stvaranja obrasca dodatne postavke

Postavke akcije preuzimanja

Omogućivanje akcije preuzimanja prikazuje tipku iznad popisa koja, kada se klikne, preuzima podatke s popisa u Excel (.xlsx) datoteku.

Postavke akcije pojedinosti

Omogućivanje akcije pojedinosti omogućuje korisniku pregledavanje obrasca entiteta samo za čitanje odabranih redova na osnovnom popisu.

Dodatne postavke dijaloškog okvira pojedinosti

Postavke akcije uređivanje

Omogućavanje Akcije uređivanja omogućuje korisniku prikaz osnovnog obrasca koji se može uređivati, a čiji su podaci vezani uz zapis odabranog retka iz popisa ako je privilegija 'Pisanje' dodijeljena uz pomoć dozvola tablice.

Dodatne postavke dijaloškog okvira uređivanje obrasca

Postavke akcije brisanje

Omogućivanje Akcije brisanje omogućuje korisniku trajno brisanje zapisa u odabranom retku na popisu ako je privilegija 'Brisanje' dodijeljena uz pomoć dozvola tablice.

(Dodatne) postavke dijaloškog okvira brisanje

Postavke akcije tijeka rada

Omogućivanje Akcije tijeka rada omogućuje korisniku pokretanje tijeka rada na zahtjev u odnosu na zapis u odabranom retku s popisa. Možete dodati neograničen broj akcija tijeka rada na popis.

Osiguravanje popisa

Da biste osigurali popis, morate konfigurirati Dopuštenja tablice za tablicu za koju se prikazuju zapisi te također potvrditi okvir za postuvku Omogući dopuštenja tablice. Ako to ne učinite, vidjet ćete sljedeće upozorenje:

„Dozvole tablice trebale bi biti omogućene za ovaj zapis ili će bilo tko na internetu moći vidjeti podatke.“.

Čin zaštite popisa osigurat će da se korisnicima koji pristupe stranici prikazuju samo oni zapisi za koje su dobili dozvolu. Ovo se postiže dodatnim filtrom koji je dodan prikazima aplikacija usmjerenih modelu koji se pojavljuju na popisu. Ovaj će filtar filtrirati samo zapise koji su dostupni korisniku putem dozvole čitanje.

Nadalje, sve akcije koje su definirane za popis poštivat će odgovarajuće dozvole za tu akciju na osnovi zapisa. To jest, ako imate dozvolu za uređivanje zapisa, akcija uređivanje će biti omogućena za taj zapis. Isto se primjenjuje za brisanje, stvaranje itd. Imajte na umu da ako zapisi nisu dostupni, pojavit će se poruka koja pokazuje da će se to prikazati kada se popis učita.

Međutim, dobar dizajn web-mjesta određuje da ako korisnik ima ulogu bez dozvola tablice (to jest, nikada neće biti u situaciji u kojoj bi mogao vidjeti zapise), oni uopće ne bi trebali imati pristup stranici. Idealno stranica bi trebala biti zaštićena dozvolama pristupa web-stranici.

Ako ste osigurali popis odabirom opcije Omogući dozvole tablice i želite prikazati radnje na razini zapisa koje su primjenjive na prijavljenog korisnika, morate postaviti vrijednost postavke web-mjesta EntityList/ShowRecordLevelActions na istinito. Na primjer, postoje dva korisnika: Ivan i Mario. Preston ima potpuni pristup na razini kontakta u tablici Slučaj, dok Teddy ima globalni pristup za čitanje. Ako se stvori popis za prikazivanje svih zapisa slučaja, Preston bi vidio sve radnje (prikaz, uređivanje i brisanje) za zapise povezane s njegovim ugovorom. Na ostalim bi zapisima vidio samo radnju Prikaz. No Mario bi na svim zapisima vidio samo radnju Prikaz.

Ako je postavka web-mjesta EntityList/ShowRecordLevelActions postavljena na false i tablica ima više dozvola, sve akcije na razini zapisa bit će vidljive. No kada korisnik pokuša izvršiti radnju za koju nije ovlašten, prikazuje se pogreška.

Dodavanje prikaza stranici pojedinosti

Postavljanjem web-stranice za pretraživanje prikaza pojedinosti na web-stranicu, pojedinosti zapisa navedene na rešetci mogu se pregledavati u načinu samo za čitanje ili uređivati, ovisno o konfiguraciji pridruženog obrasca ili stranice.

Ova stranica može biti u potpunosti prilagođeni predložak stranice, možda stvoren uz pomoć platforme Liquid. Najuobičajeniji scenarij je vjerojatno imati stranicu s pojedinostima kao web-stranicu koja sadrži osnovni obrazac ili napredni obrazac.

Važno je znati da svaki zapis naveden na rešetci ima hipervezu na stranicu s pojedinostima, a veza će sadržavati naziv parametra niza upita s ID-jem zapisa. Naziv parametra niza upita ovisi o ID-ju za naziv parametra niza upita koji je naveden na popisu. Posljednje što je potrebno imati na umu je da ciljane pojedinosti web-mjesta moraju također znati naziv parametra niza upita kako bi dobile ID zapisa za koji je potrebno izvršiti upit i učitati njegove podatke.

Upotreba osnovnog obrasca za prikaz pojedinosti

Upute za stvaranje osnovnog obrasca pogledajte na stranici osnovni obrazac.

Potrebno je pripaziti na važne postavke navedene u nastavku za osiguravanje učitavanja zapisa s popisa u osnovni obrazac.

Naziv parametra za ID zapisa u osnovnom obrascu mora odgovarati nazivu parametra niza ID upita na popisu.

Način može biti uređivanje ili samo za čitanje, ovisno o vašim potrebama.

Upotreba naprednog obrasca za prikaz pojedinosti

Potrebno je pripaziti na važne postavke navedene u nastavku za osiguravanje učitavanja zapisa s popisa u napredni obrazac.

Naziv parametra niza upita za primarni ključ u koraku naprednom obrascu mora odgovarati nazivu parametra niza ID upita na popisu.

Način može biti uređivanje ili samo za čitanje, ovisno o vašim potrebama.

Upotreba stranice s pojedinostima funkcije za stvaranje

Možete upotrijebiti prilagođenu stranicu, osnovni obrazac ili napredni obrazac na isti način da biste stvorili funkciju Stvori. Ovo je alternativa definiranju akcije stvaranja u obrascu. Možete definirati akciju stvaranja i prilagođenu stranicu za stvaranje: definiranje prilagođene akcije ima prednost.

Ako dodijelite web-stranicu pretraživanju stvaranja na popisu, a niste odredili akciju kreiranja uz pomoć konfiguracije, tipka stvaranje će se renderirati na popisu koji će povezati korisnika s prilagođenom stranicom koji ste odredili za stvaranje.

Konfiguracija filtra popisa

Dodavanje mogućnosti filtru zapisa na popisu vrlo je jednostavno: potrebno je samo omogućiti opciju filtriranja, a zatim odabrati jednu ili više vrsti filtra koje će se prikazati korisnicima. Moguće je filtrirati prema atributu u skladu s tekstom koji je korisnik poslao ili odabrati iz niza mogućnosti. S pomoću značajke Napredno traženje možete dizajnirati gotovo sve vrste filtara koje možete zamisliti.

Omogućivanje filtra popisa

U odjeljku Filtar metapodataka označite okvir Omogućeno. Ovime ćete dodat područje filtra na popis kada je prikazan. Sve dok ne definirate barem jednu vrstu filtra okvir će izgledati prazno.

Možete definirati kako će se područje filtra na popisu renderirati uz pomoć postavke usmjerenje. Zadano, vodoravno, renderira područje filtra iznad popisa. Okomito usmjerenje renderira područje filtra kao okvir lijevo od popisa.

Vrste filtriranje

Filtriranje teksta

Filtriranje teksta dodaje tekstualni okvir području filtra popisa koji je povezan s atributom vrste tablice za popis. Kada korisnik primijeni filtriranje, popis prikazuje samo zapise čiji odabrani atributi sadrže vrijednosti.

Za dodavanje filtriranja tekst kliknite + Filtriranje teksta:

Filtriranje teksta upotrebljava atribute navedene u nastavku:

Skup filtara atributa

Postavljanje filtriranja atributa dodaje niz mogućnosti za filtriranje popisa povezanih s jednim atributom odabranoj vrsti tablice popisa. Kada korisnik primijeni filtriranje, popis prikazuje samo zapise koji u potpunosti odgovaraju barem jednoj od odabranih mogućnosti.

Postavljanje filtriranja atributa upotrebljava atribute navedene u nastavku:

Postavljanje filtriranja mogućnosti

Postavljanje filtriranja atributa uglavnom može imati brojne mogućnosti, s iznimkom popisa za odabir i Booleovih atributa. Postavljanje filtriranja Booleovih atributa može imati jednu ili dvije mogućnosti—jednu istinitu mogućnost, a drugu neistinitu. Postavljanje filtriranja popisa za odabir atributa može imati najviše jednu mogućnost za svaku moguću vrijednost na popisu za odabir.

Mogućnosti imaju atribute navedene u nastavku:

Skup za pretraživanje

Skup pretraživanja dodaje niz mogućnosti za filtriranje popisa povezanih s povezanom tablicom u odabranoj vrsti tablice popisa. Kada korisnik primijeni filtriranje, popis prikazuje samo zapise koji u potpunosti odgovaraju barem jednom od odabranih povezanih zapisa.

Skup pretraživanja upotrebljava atribute navedene u nastavku:

Skup pretraživanja mogućnosti

Skup pretraživanja obično može imati brojne mogućnosti, a jedino je ograničenje broj zapisa povezanih s odabranom vrstom.

Mogućnosti imaju atribute navedene u nastavku:

Skup filtara raspona

Postavljanje filtriranja raspona dodaje niz mogućnosti, svaka od kojih ima dva uvjeta, području filtriranja. Kada korisnik primijeni filtriranje, popis prikazuje samo zapise koji u potpunosti odgovaraju svim uvjetima na barem jednoj od odabranih mogućnosti.

Postavljanje filtriranja raspona upotrebljava atribute navedene u nastavku:

Postavljanje mogućnosti filtriranja raspona

Postavljanje filtriranja raspona može imati različite mogućnosti. Svaka mogućnost postavit će uvjet filtriranja s jednim ili dva poduvjeta, oba od kojih moraju biti ispunjena da bi uvjet bio istinit.

Mogućnosti imaju atribute navedene u nastavku:

Skup dinamičkog popisa za odabir

Dinamično postavljanje popisa za odabir dodaje niz mogućnosti za filtriranje koje predstavljaju sve vrijednosti navedene u polju popisa za odabir. Ovo se razlikuje od odabira popisa za odabir u postavljanju atributa filtriranja. U postavljanju atributa filtriranja, morate navesti skup mogućnosti koje će biti dostupne korisniku za filtriranje; u dinamičnom postavljanju popisa za odabir za filtriranje, samo morate navesti polje popisa za odabir i čitav skup mogućnosti biti će ponuđen automatski. Ako Vam je potrebna veća kontrola, preporučujemo upotrebu postavljanje atributa filtriranja.

Dinamično postavljanje popisa za odabir upotrebljava mogućnosti navedene u nastavku:

Skup dinamičkog pretraživanja

Skup dinamičnog pretraživanja dodaje dinamički niz mogućnosti za filtriranje popisa povezanih s povezanom tablicom u odabranoj vrsti tablice popisa. Kada korisnik primijeni filtriranje, popis prikazuje samo zapise koji u potpunosti odgovaraju barem jednom od odabranih povezanih zapisa.

Razlikuje se od skupa pretraživanja. U skupu pretraživanja morali ste ručno navesti povezane tablice za filtriranje. U dinamičnom skupu pretraživanja samo morate navesti odnose koje ćete filtrirati, a popis mogućnosti će se izraditi na temelju određenog pregleda povezanih tablica.

Dinamični skup pretraživanja upotrebljava mogućnosti navedene u nastavku:

Filtar FetchXML

Raspon filtriranja može stvori jednostavan okvir filtriranja poput filtriranja teksta ili postaviti mogućnosti poput drugih vrsti filtriranja. Omogućava vam ručno stvaranje gotovo bilo koje vrste filtriranja za popis uz pomoć platforme FetchXML.

Filtar FetchXM upotrebljava samo jedan atribut:

Prikaz karte popisa

Uz pomoć popisa moguće je omogućiti i konfigurirati prikaz karte podataka uz pomoć servisa Bing s funkcionalnosti pretraživanja za pronalazak lokacija blizu adrese. Ispunjavanjem zapisa vrijednostima geografske širine i dužine i određivanjem potrebnih mogućnosti konfiguracije navedenih u ovom odjeljku, vaši zapisi se mogu renderirati kao točke na karti. Svaki zapis koji ne sadrži vrijednosti geografske širine i dužine bit će isključen iz pretrage. Početno učitavanje stranice prikazat će sve zapise s početnom vrijednosti polja vrijednost udaljenosti (u miljama ili kilometrima ovisno o odabranim jedinicama udaljenosti) iz koordinata zadane središnje geografske širine i dužine. Navedeni se prikaz ignorira kada se koristi prikaz karte, a upit udaljenosti primjenjuje se na skup podataka za povratak na rezultate koje je moguće prikazati na karti.

Prikaz kalendara popisa

Upotreba kalendara popisa omogućuje renderiranje popisa kao kalendara sa svakim pojedinim zapisom konfiguriranim kao zasebnim događajem.

Kako bi se zapisi prikazivali uz pomoć kalendara ti zapisi moraju barem imati polje s datumom. Kako bi događaji imali točna vremena početka i završetka, potrebna su odgovarajuća polja itd. Pod pretpostavkom da su polja konfigurirana, prikaz kalendara pojavit će se na portalu.

Popis feeda OData

Ako je to omogućeno, tablica se može objaviti na sažetku sadržaja OData. Protokol OData je protokol na razini aplikacije za interakciju s podacima putem web-servisa RESTful. Podatke iz ovog sažetka sadržaja moguće je pregledavati u web-pregledniku, može im pristupiti klijentska web-aplikacija ili se mogu uvesti u Excel.

Unaprijeđeni prikaz filtriranja za popise

Možete upotrebljavati dozvole tablice ako želite zaštititi zapise, ali ako jednostavno želite osigurati filtriranje kao dio skupa opcija filtriranja koji je važan trenutnom korisniku portala. Ova značajka podržava filtriranje trenutnog korisnika, nadređenog računa korisnika i/ili web-mjesta na bilo kojoj dubini. Jednostavno izradite filtar prikaza koji će se upariti sa svakim pojedinim zapisom kontakta, a njegovu će vrijednost kod zamijeniti stvarnom vrijednošću u vrijeme izvođenja—nije potrebno dodjeljivati vrijednosti poljima u odjeljku Uvjeti filtriranja.

• Kontrola će pronaći sve elemente uvjeta gdje je uitype = "contact" i postaviti vrijednost na stvarnu vrijednost trenutačnog ID-a kontakta korisnika portala.
• Kontrola će pronaći sve elemente uvjeta gdje je uitype = "account" i postaviti vrijednost na stvarnu vrijednost trenutačnog ID-a nadređenog računa korisnika portala.
• Kontrola će pronaći sve elemente uvjeta gdje je uitype = "adx_website" i postaviti vrijednost na stvarnu vrijednost trenutačnog ID-a web-mjesta korisnika portala.

Primjer kriterija filtriranja prikaza

Slika u nastavku prikazuje proizvoljni kontakt dodijeljen uvjetu filtra. To je skraćeni, „lažni” kontakt, ali to može biti bilo koji zapis kontakta. ID ovog zapisa zamijenit će se stvarnom vrijednošću ID-a korisnika koji pregledava stranicu. Ako korisnik nije prijavljen, neće biti pronađenih zapisa. To pruža veću fleksibilnost u filtriranju podataka na temelju korisnika i web mjesta ovisno o kontekstu.

Pogledajte

• Microsoft Learn: prikaz više zapisa Dataverse pomoću popisa
• Konfiguriranje portala
• Preusmjeravanje na novi URL na portalu