Loenditest

Loend on andmepõhine konfiguratsioon, mida kasutate veebilehe lisamiseks, mis kuvab kirjete loendi ilma, et arendaja peaks portaali ruudustiku lisama. Loendite abil saate avada kirjeid portaalides kuvamiseks.

Ruudustik toetab sortimist ja jaotatakse mitmele lehele, kui kirjete arv on suurem kui määratud lehekülje suurus. Kui määäratud on vaade Üksikasjade veebileht, sisaldab iga kirje linki lehele ja kirje ID lisatakse koos ID päringustringi parameetriga päringustringile. Loend toetab ka mitut vaadet. Kui on määratud rohkem kui üks vaade, koostatakse ripploend, et kasutaja saaks erinevate vaadete vahel liikuda.

Andmeid saab filtreerida ka portaali praegune kasutaja, portaali praeguse kasutaja peamise kliendi konto ja praegune portaali veebisait. Kui väärtus on olemas mõlema filtreerimistingimuse, Portaali kasutaja atribuut ja Ettevõtte atribuut, jaoks, koostab portaal ripploendi, et lubada kasutajal vaadata oma (Minu) andmeid või tema peamise kliendi konto andmeid.

Loendi lisamine portaali

Loend sisaldab seoseid veebilehtedega ja mitmesuguseid omadusi juhtimaks kirjete loendi käivitamist portaalis. Seos veebilehega võimaldab kõnealuse lehe sõlme vormi määratluse dünaamilist toomist veebisaidil. Olemasolevate tabeli vaadete kuvamiseks või uute tabeli vaadete loomiseks minge jaotisse Portaalid > Loendid.

Loendiga seostatud veebilehti saab vaadata, valides lingi Veebilehed vasakpoolses menüüs navigeerimislinkide Seotud all. Loendi loomisel tuleb kõigepealt valida tabel, mille jaoks soovite portaalis loendi koostada. Seejärel saate valida koostamiseks ühe või mitu mudelipõhise rakenduse vaadet.

Veebilehe loomisel või redigeerimisel saate loendi määrata veebilehe vormi otsinguväljal. Lehe mall on tavaliselt mall Leht, kuid see võib olla ka üks mitmest muust sisu jaoks väljatöötatud mallist, kuna peamallid sisaldavad loendi koostamise vajalikkuse väljaselgitamiseks vajalikku loogikat.

Loendi atribuudid ja seosed

Kohandatud JavaScripti lisamine

Vormi vahekaart Suvandid sisaldab tekstiala, kuhu saate sisestada kohandatud atribuudi JavaScript, ja kui teie leht sisaldab jQuery teeki, saate ka seda siin kasutada. Skriptiplokk lisatakse veebilehe alaossa vahetult lehte sulgeva vormisildi ette.

Loend saab andmed asünkroonselt ja kui on see lõpule jõudnud, käivitab see loaded sündmuse, mida teie kohandatud JavaScript saab kuulata ja ruudustiku kirjetega midagi teha. Lihtsaks näiteks on järgmine kood.

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

Leidke konkreetne atribuudiväli ja tooge selle väärtus, et väärtuse renderdust võimaluse korral muuta. Järgmine kood toob iga tabelilahtri, mis sisaldab atribuudi accountnumber väärtust. Asendage accountnumber oma tabeli ja vaate asjakohase atribuudiga.

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

Loendi konfiguratsioon

Saate hõlpsasti lubada ja konfigureerida toiminguid loendis olevate kirjete puhul (Loomine, Redigeerimine, Kustutamine jne). Samuti on võimalik tühistada vaikesilte, suurusi ja muid atribuute, et loend kuvataks täpselt nii, nagu soovite.

Need sätted leiate loendi vormi jaotises Konfiguratsioon. Vaikimisi kuvatakse ainult Põhisätted. Valige Täpsemad sätted, et kuvada täpsemad sätted.

Atribuudid

Üldised toimingusätted

Üldjuhul on tabeli toimingutel sätted, mida saab konfigureerida. Igal juhul on selle otstarve anda teile kohandamise mõttes rohkem valikuid ja need väljad pole nõutavad. Toimingu lihtsalt lisamine võimaldab toimingut portaalis teha, kui tabeli õigustega on antud asjakohane õigus.

Üldjuhul saate konfigureerida iga toimingu vastavat dialoogiboksi, mis kuvatakse ainult siis, kui teete valiku Kinnitus on nõutav.

Dialoogiboksi Üldine täpsemad sätted

Loomistoimingu sätted

Valiku Loomistoiming lubamine kuvab loendi kohal nupu, mille valimisel avaneb dialoogiboks tavavormiga, mis võimaldab kasutajal luua uue kirje, kui tabeli iõigustega on antud loomisõigus.

Dialoogiboksi Vormi loomine täpsemad sätted

Allalaadimistoimingu sätted

Valiku Allalaadimistoiming lubamisel kuvatakse loendi kohal nupp, mille valimisel laaditakse loendi andmed Exceli (.xlsx) failina alla.

Üksikasjade toimingu sätted

Suvandi Üksikasjade toiming lubamine võimaldab kasutajal vaadata loendis valitud rea kirjutuskaitstud tavavormi.

Dialoogiboksi Üksikasjad täpsemad sätted

Redigeerimistoimingu sätted

Suvandi Redigeerimistoiming lubamine võimaldab kasutajal kuvada redigeeritava tavavormi, mis on andmete kaudu seotud loendi valitud rea kirjega, kui tabeli õigustega on antud kirjutusõigus.

Dialoogiboksi Vormi redigeerimine täpsemad sätted

Kustutamistoimingu sätted

Suvandi Kustutamistoiming lubamine võimaldab kasutajal püsivalt kustutada loendist valitud rea kirje, kui tabeli õigustega on antud kustutusõigus.

Dialoogiboksi Kustutamine täpsemad sätted

Töövootoimingu sätted

Suvandi Töövootoiming lubamine võimaldab kasutajal käivitada loendi valitud rea kirje suhtes nõudmisel töövoo. Võite loendi metaandmetesse sisestada ükskõik kui palju töövootoiminguid.

Loendite turbamine

Loendi turvamiseks peate konfigureerima tabeliõigused tabeli jaoks, mille jaoks kirjeid kuvatakse, ja valima ruudul sätte Luba tabeliõigused. Kui te seda ei tee, kuvatakse järgmine hoiatus:

"Tabeliõigused peavad olema selle kirje puhul lubatud või andmeid saab vaadata ükskõik kes internetist.".

Loendi turvaliseks muutmine tagab, et igale kasutajale, kes lehele juurde pääseb, kuvatakse ainult need kirjed, millele on talle õigus antud. Selleks lisatakse mudelipõhise rakenduse vaadetele, mis tuuakse loendi kaudu esile, lisafilter. See filter filtreerib õiguse Lugemine kaudu ainult need kirjed, millele kasutaja juurde pääseb.

Peale selle järgivad kõik loendi jaoks määratletud toimingud vastava toimingu õigusi iga kirje puhul eraldi. See tähendab, et kui teil on kirje redigeerimise õigus, lubatakse kõnealuse kirje redigeerimistoiming. Sama kehtib kustutamise, loomise jne kohta. Pange tähele, et kui ühtki kirjet pole saadaval, kuvatakse loendi laadimisel asjakohane teade.

Siiski nõuab hea veebisaidi kujundus, et kui kasutajal pole rolli, millel oleks tabelile mõni õigus (st tekiks olukord, kus ta ei näe ühtki kirjet), ei tohiks tal lehele üldse juurdepääsu olla. Parimal juhul tuleks lehte kaitsta veebilehe juurdepääsu õigustega.

Kui olete loendi turvanud, valides Luba tabeliõigused ja soovite kuvada kirjetaseme toimingud, mis kehtivad logitud kasutajale, peate määrama sätte EntityList/ShowRecordLevelActions saidi väärtuseks tõene. Näiteks on kaks kasutajat: Preston ja Teddy. Prestonil on juhtumi tabelis kogu juurdepääs kontakttasemel, Teddy-l on aga ülemaailmne lugemisõigus. Kui kõigi juhtumikirjete kuvamiseks luuakse loend, näeks Preston tema kontaktiga seotud kirjetes kõiki toiminguid (Kuva, Muuda ja Kustuta). Muude kirjete puhul näeks ta vaid Kuvamise toimingut. Teddy näeks aga kõikide kirjete puhul vaid Kuvamise toimingut.

Kui saidi EntityList/ShowRecordLevelActions sätted on seatud väärtusele väär ja tabelil on mitu õigust, on kõik kirjetaseme toimingud nähtavad. Kuid kui kasutaja proovib sooritada toimingut, milleks tal puudub õigus, siis kuvatakse tõrge.

Üksikasjade kuvamise lehe lisamine

Seades üksikasjade vaate veebilehe otsinguvalikuks Veebileht, saab ruudustikus loetletud kirje üksikasjad kuvada kirjutuskaitstuna või redigeeritavana olenevalt seostatud vormi või lehe konfiguratsioonist.

See leht võib olla täielikult kohandatud lehemall, loodud näiteks Liquidiga. Levinuim stsenaarium on ilmselt see, kui üksikasjade leht on veebileht, mis sisaldab kas tava- ja täpsema vormi.

Oluline on arvesse võtta, et igal ruudustikus loetletud kirjel on hüperlink üksikasjade lehele ja see link sisaldab kirje ID-ga nimelist päringustringi parameetrit. Päringustringi parameetri nimi sõltub loendis määratud ID päringustringi parameetri nimest. Viimane meelespidamist vajav asi on see, et üksikasjade sihtveebileht peab olema samuti teadlik selle päringustringi parameetrist, et tuua selle kirje ID, mille kohta ta päringut peab tegema, ja laadida selle andmed.

Tavavormi kasutamine üksikasjade kuvamiseks

Tavavormi loomiseks vaadake tavavormi lehel olevaid juhiseid.

Järgmiseks on toodud olulised sätted, mida tuleb arvesse võtta, et tagada loendist kirje laadimine tavavormi.

Kirje ID parameetri nimi tavavormil peab ühtima loendis oleva ID päringustringi parameetri nimega.

Režiim saab olla olenevalt teie vajadustest kas Redigeerimine või Kirjutuskaitstud.

Täpsema vormi kasutamine üksikasjade kuvamiseks

Järgmiseks on toodud olulised sätted, mida tuleb arvesse võtta, et tagada loendist kirje laadimine täpsema vormi.

Primaarvõtme päringustringi parameetri nimi täpsema vormi etapis peab ühtima loendis oleva ID päringustringi parameetri nimega.

Režiim saab olla olenevalt teie vajadustest kas Redigeerimine või Kirjutuskaitstud.

Loomisfunktsiooni üksikasjade lehe kasutamine

Saate loomisfunktsiooniks kasutada kohandatud lehte, tava- või täpsema vormi samal moel. See on alternatiiv vormil loomisttoimingu määratlemiseks. Korraga ei saa määratleda nii loomistoimingut kui ka loomise kohandatud lehte: kohandatud toimingu määratlemisel on eesõigus.

Kui määrate loendis otsingu loomisele veebilehe, kuid ei määra konfiguratsiooni kaudu loomistoimingut, kuvatakse loendis loomisnupp, mis viib kasutaja kohandatud lehele, mille olete loomise jaoks määranud.

Loendi filtri konfiguratsioon

Loendis kirjete filtreerimisvõimaluse lisamine on lihtne – lubage lihtsalt filtreerimissuvand ja seejärel valige kasutajatele kuvamiseks üks või mitu filtreerimistüüpi. Võimalik on filtreerida kasutaja sisestatud tekstile vastava atribuudi järgi või teha suvandite seast sobiv valik. Saate isegi kujundada peaaegu ükskõik millist tüüpi filtrit, kui kasutate täpsemat otsingut.

Loendi filtreerimise lubamine

Märkige jaotises Metaandmete filtreerimine ruut Lubatud. See lisab loendisse selle kuvamisel filtreerimisala. Enne, kui olete määratlenud vähemalt ühe filtritüübi, kuvatakse kast tühjana.

Saate määratleda, kuidas loendi filtreerimisala kuvatakse, kasutades suvandit Suund. Vaikesäte Horisontaalne kuvab filtreerimisala loendi kohal. Vertikaalne suund kuvab filtreerimisala loendist vasakul oleva kastina.

Filtrite tüübid

Tekstifilter

Tekstifilter lisab olemiloendi filtreerimisalale tekstilahtri, mis seotakse loendi tabeli tüübi atribuudiga. Kui kasutaja rakendab filtrit, kuvatakse loendis ainult need kirjed, mille valitud atribuut sisaldab väärtust.

Tekstifiltri lisamiseks valige +Tekstifilter.

Tekstifilter kasutab järgmisi atribuute.

Atribuudi filtrikomplekt

Atribuudifiltrite komplekt lisab valiku suvandeid, mille järgi loendit filtreerida ja mis on seotud loendi valitud tabeli tüübi ühe atribuudiga. Kui kasutaja rakendab filtrit, kuvatakse loendis ainult need kirjed, mis vastavad täpselt vähemalt ühele valitud suvandile.

Atribuudifiltrite komplekt kasutab järgmisi atribuute.

Atribuudifiltrite komplekti suvandid

Atribuudifiltrite komplektil võib tavalisel olla ükskõik kui palju suvandeid peale atribuutide Märkeloend ja Loogika. Loogika atribuudifiltrite komplektil saab olla ainult üks või kaks suvandit – üks tõene ja üks väär. Märkeloendi atribuudifiltrite komplektil saab märkeloendi iga võimaliku väärtuse kohta olla ainult üks suvand.

Suvanditel on järgmised atribuudid.

Otsingu määramine

Otsingukomplekt lisab valiku suvandeid, mille järgi loendit filtreerida ja mis on seotud loendi valitud tabeli tüübi seotud tabeliga. Kui kasutaja rakendab filtrit, kuvatakse loendis ainult need kirjed, mis vastavad täpselt vähemalt ühele valitud seotud kirjele.

Otsingukomplekt kasutab järgmisi atribuute.

Otsingukomplekti suvandid

Otsingukomplektil võib tavalisel olla ükskõik mitu suvandit, ainus piirang on valitud seotud tüübi seotud kirjete arv.

Suvanditel on järgmised atribuudid.

Vahemikufiltri määramine

Vahemikufiltrite komplekt lisab filtreerimisalale valiku suvandeid, millest igaühel on üks või kaks tingimust. Kui kasutaja rakendab filtrit, kuvatakse loendis ainult need kirjed, mis vastavad täpselt vähemalt ühe valitud suvandi kõigile tingimustele.

Vahemikufiltrite komplekt kasutab järgmisi atribuute.

Vahemikufiltrite komplekti suvandid

Vahemikufiltrite komplektil võib olla ükskõik kui palju suvandeid. Iga suvand annab filtreerimistingimuse kas ühe või kahe alamtingimusega, millest mõlemad peavad vastama tõesele tingimusele.

Suvanditel on järgmised atribuudid.

Dünaamilise märkeloendi määramine

Dünaamilise märkeloendi komplekt lisab valiku suvandeid, mille alusel filtreerida ja mis kujutavad kõiki määratud märkeloendi välja väärtusi. See erineb märkeloendi valimisest atribuudifiltrite komplektis. Atribuudifiltrite komplektis peate määrama kasutajale kättesaadavaks tehtava komplekti suvanditest, mille alusel filtreerida. Dünaamilise märkeloendi komplektis peate määrama ainult märkeloendi välja ja kogu suvandite valik esitatakse automaatselt. Kui vajate suuremat kontrolli, soovitame kasutada atribuudifiltrite komplekti.

Dünaamilise märkeloendi komplekt kasutab järgmisi suvandeid.

Dünaamilise otsingu määramine

Dünaamilise otsingukomplekt lisab valiku dünaamilisi suvandeid, mille järgi loendit filtreerida ja mis on seotud loendi valitud tabeli tüübi seotud tabeliga. Kui kasutaja rakendab filtrit, kuvatakse loendis ainult need kirjed, mis vastavad täpselt vähemalt ühele valitud seotud kirjele.

See erineb otsingukomplektist. Otsingukomplektis peate käsitsi määrama seotud tabelid, mille alusel filtreerida. Dünaamilises otsingukomplektis peate määrama ainult suhte, mille alusel filtreerida, ja seonduvate tabelite määratud vaate põhjal luuakse valikute loend.

Dünaamilise otsingu komplekt kasutab järgmisi suvandeid.

FetchXML-i filter

Vahemikufilter saab luua kas lihtsa tekstilahtrilise filtri, nt Tekstifilter, või suvandite komplekti, näiteks muud filtritüübid. See võimaldab teil luua loendi jaoks praktiliselt iga tüüpi filtreid, kasutades FetchXML-i.

FetchXML-i filter kasutab ainult üht atribuuti.

Loendi kaardivaade

Loenditega on võimalik lubada ja konfigureerida andmete kaardivaade, mida toetavad otsingufunktsiooniga Bingi kaardid, et leida teatud aadressi lähedal olevaid asukohti. Asustades kirjed laius- ja pikkuskoordinaatide väärtustega ja määrates selles jaotises loetletud vajalikud konfiguratsioonisuvandid, saate oma kirjete asukoha visuaalselt kaardile kanda. Otsingust jäetakse välja kõik kirjed, millel puudub laius- või pikkuskraadi väärtus. Lehe esmasel laadimisel kuvatakse kõik kirjed, mis jäävad koordinaatide Keskpunkti laiuskraadi vaikeväärtus ja Keskpunkti pikkuskraadi vaikeväärtus suhtes välja Kaugusväärtused algse väärtuse piiresse (miilides või kilomeetrites olenevalt määratud kaugusühikutest). Kaardivaate kasutamisel eiratakse määratud vaadet ning andmekogumile rakendatakse kauguspäringut, et tagastada kaardistatavad tulemused.

Loendi kalendrivaade

Loendi kalendrivaade võimaldab kuvada loendi kalendrina, milles iga üksik kirje on konfigureeritud toimima eraldi sündmusena.

Kirjete kuvamiseks kalendri abil peab neil kirjetel olema vähemalt kuupäevaväli. Selleks et sündmustel oleks täpne algus- ja lõppaeg, peavad olema määratud vastavad väljad jne. Kui need väljad on konfigureeritud, kuvatakse portaalis loendi kalendrivaade.

Loendi OData kanalid

Kui see on lubatud, saab tabeli avaldada OData kanalis. OData protokoll on rakendusetasemel protokoll andmetega suhtlemiseks RESTfuli veebiteenuste kaudu. Selle kanali andmeid saab vaadata veebibrauseris, neid saab tarbida kliendipoolne veebirakendus või neid saab importida Excelisse.

Loendite täiustatud vaatefilter

Kui soovite turvalisi kirjeid, saate kasutada tabeli õigusi. Kui aga soovite lihtsalt võimaldada osana filtrisuvandite komplektist filtri, mis on asjakohane praegusele portaali kasutajale, saate kasutada loendi funktsiooni. See funktsioon toetab praeguse kasutaja, kasutaja peamise konto või veebisaidi filtreerimist ükskõik kui sügavalt. Koostage lihtsalt vaatefilter, mis vastab ükskõik millisele üksikule kontaktikirjele, ja kood asendab selle väärtuse käitusajal tegeliku väärtusega – pole mingit vajadust määrata väljadele väärtusi jaotises Filtreerimistingimused.

• Juhtelement leiab kõik tingimuse elemendid, kus uitype=„kontakt” ja määrab väärtuseks praeguse portaali kasutaja kontakti ID tegeliku väärtuse.
• Juhtelement leiab kõik tingimuse elemendid, kus uitype=„konto” ja määrab väärtuseks praeguse portaali kasutaja peamise konto ID tegeliku väärtuse.
• Juhtelement leiab kõik tingimuse elemendid, kus uitype=„adx_website” ja määrab väärtuseks praeguse portaali kasutaja veebisaidi ID tegeliku väärtuse.

Näiteks vaate filtreerimiskriteeriumid

Järgnev pilt näitab filtri tingimusele määratud juhuslikku kontakti, see kontakt on juhtumisi fiktiivne, kuid see võib olla mis tahes kontaktikirje. Selle kirje ID asendatakse seda lehte vaatava kasutaja ID tegeliku väärtusega. Kui kasutaja pole sisse logitud, siis kirjeid ei tagastata. See võimaldab suuremat paindlikkust andmete filtreerimisel vastavalt kasutaja ja veebisaidi kontekstile.

Vt ka

• Microsoft Learn: mitme Dataverse kirje kuvamine loendite abil
• Portaali konfigureerimine
• Uuele URL‑ile ümbersuunamine portaalis