Om lister

En liste er en databaseret konfiguration, som du bruger til at tilføje en webside, der gengiver en liste over poster, uden at en udvikler behøver at vise gitteret i portalen. Når du bruger lister, kan du vise poster på portaler.

Gitteret understøtter sortering og pagineres, hvis antallet af poster er større end sidestørrelsen, der er angivet. Hvis Webside for detaljevisning er angivet, indeholder hver post et link til siden, og id'et for posten vedhæftes i forespørgselsstrengen sammen med Navn på parameter for forespørgselsstreng-id. Listen understøtter også flere visninger. Hvis der er angivet mere end én visning, gengives en rulleliste, hvor brugeren kan skifte mellem de forskellige visninger.

Dataene kan også filtreres efter den aktuelle portalbruger, den aktuelle portalbrugers overordnede firmakonto og det aktuelle portalwebsted. Hvis der findes en værdi for begge af filterbetingelserne Attribut for portalbruger og Attributten Konto, gengiver portalen en rulleliste, så brugeren kan få vist sine egne data (Mine) eller dataene på sin overordnede firmakonto.

Føje en liste til din portal

Listen indeholder relationer til websider og forskellige egenskaber til styring af initialiseringen af listen over poster i portalen. Relation til Webside giver mulighed for dynamisk at hente listedefinitionen for en given sidenode på webstedet. Få vist eksisterende tabelvisninger eller oprette nye tabelvisninger skal du gå til Portaler > Lister.

De websider, der er knyttet til listen, kan ses ved at vælge linket Websider, der er angivet i de Relateret-navigationslinks i menuen yderst til venstre. Når du opretter listen, er første trin at vælge den tabel, du vil gengive en liste på portalen for. Derefter skal du vælge en eller flere modelbaserede appvisninger, som skal gengives.

Når du opretter eller redigerer en webside, kan du angive en liste i opslagsfeltet, der findes i formularen Webside. Sideskabelonen er typisk skabelonen Side, men kan være en af flere andre skabeloner, der er udviklet til indhold, fordi de overordnede skabeloner indeholder den logik, der er nødvendig for at finde ud af, om en liste skal gengives.

Listeattributter og relationer

Tilføje brugerdefineret JavaScript

Fanen Indstillinger i formularen indeholder et tekstområde, hvor du kan angive brugerdefineret JavaScript. Hvis din side indeholder jQuery-bibliotek, kan du bruge den her også. Scriptblokken tilføjes nederst på websiden lige foran sidens afsluttende formularmærke.

Listen henter dataene asynkront, og derefter udløses hændelsen loaded, som dit brugerdefinerede JavaScript kan lytte efter, og det kan foretage sig noget med elementerne i gitteret. Følgende kode er et simpelt eksempel:

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

Find et bestemt attributfelt, og hent dets værdi for evt. at ændre gengivelsen af værdien. Følgende kode henter de enkelte celler i tabellen, der indeholder værdien af accountnumber-attributten. Erstat accountnumber med en attribut, der er relevant for din tabel og visning.

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

Konfiguration af liste

Det er nemt at aktivere og konfigurere handlinger (oprette, redigere, slette og så videre) for poster på en liste. Det er også muligt at tilsidesætte standardetiketter, -størrelser og andre attributter, så listen vises præcist, som du ønsker.

Disse indstillinger findes i sektionen Konfiguration i listeformularen. Som standard vises kun Grundlæggende indstillinger. Vælg Avancerede indstillinger for at se flere indstillinger.

Attributter

Generelle handlingsindstillinger

Generelt har tabelhandlinger indstillinger, der kan konfigureres. Dette er giver under alle omstændigheder flere muligheder for tilpasning, og felterne er ikke påkrævet. Når handlingen blot tilføjes, kan den udføres på portalen, forudsat at den relevante rettighed er tildelt af tabeltilladelser.

Som hovedregel kan du konfigurere den tilsvarende dialogboks for hver handling, som kun vises, hvis du vælger Bekræftelse påkrævet.

Indstillinger (avancerede) for dialogboksen Generelt

Opret handlingsindstillinger

Aktivering af Handlingen Opret gengiver en knap over listen. Når knappen vælges, åbnes en dialogboks med en basisformular, som brugeren kan bruge til at oprette en ny post, forudsat at rettigheden Opret er tildelt i tabeltilladelser.

Avancerede indstillinger for dialogboksen Opret formular

Indstillinger for handlingen Hent

Aktivering af Handlingen Hent gengiver en knap over listen. Når brugeren vælger den, hentes data fra listen til en Excel-fil (.xlsx).

Indstillinger for handlingen Detaljer

Aktivering af Handlingen Detaljer gør det muligt for brugeren at få vist en skrivebeskyttet basisformular for en markeret række på listen.

Avancerede indstillinger for dialogboksen Detaljeformular

Indstillinger for handlingen Rediger

Aktivering af Handlingen Rediger giver en bruger tilladelse til at få vist en redigerbar basisformular, der er databundet til posten i den markerede række fra listen, forudsat at rettigheden Skriv er tildelt i tabeltilladelser.

Avancerede indstillinger for dialogboksen Rediger formular

Indstillinger for handlingen Slet

Aktivering af Handlingen Slet gør det muligt for en bruger at slette posten i den valgte række permanent fra listen, forudsat at rettigheden Slet er tildelt i tabeltilladelser.

Indstillinger (avancerede) for dialogboksen Slet

Indstillinger for arbejdsproceshandling

Aktivering af en Arbejdsproceshandling giver en bruger tilladelse til at køre en anmodet arbejdsproces på posten i den valgte række fra listen. Du kan tilføje et vilkårligt antal arbejdsproceshandlinger til listen.

Sikring af lister

Hvis du vil sikre en liste, skal du konfigurere tabeltilladelser for den tabel, som poster vises for, og markere afkrydsningsfeltet for indstillingen Aktivér tabeltilladelser. Hvis du ikke gør det, får du vist følgende advarsel:

"Tabeltilladelser skal aktiveres for denne post, ellers kan alle på internettet få vist dataene."

Handlingen til sikring af en liste sikrer, at alle brugere, som åbner siden, kun kan se de poster, de har fået tilladelse til. Det gøres ved hjælp af et ekstra filter, der føjes til de modelbaserede appvisninger, der vises via listen. Dette filter filtrerer kun for poster, der er tilgængelige for brugeren, via Læse-tilladelse.

Desuden skal handlinger, der er defineret for listen, respektere de tilsvarende tilladelser for denne handling på basis af den enkelte post. Det vil sige, at hvis du har Rediger-tilladelse for en post, så aktiveres handlingen Rediger for den pågældende post. Det samme gælder for sletning, oprettelse osv. Bemærk, at hvis der ikke findes nogen tilgængelige poster, vises der en meddelelse om det, når listen indlæses.

Imidlertid kræver et godt webstedsdesign, at hvis en bruger har en rolle, der ikke indeholder nogen tilladelser for tabellen (dvs. at der aldrig vil være den situation, hvor de skal se poster), skal brugeren ikke have adgang til siden overhovedet. Siden bør ideelt set være beskyttet ved hjælp af adgangstilladelser til websider.

Hvis du har sikret en liste ved at vælge Aktivér tabeltilladelser og vil have vist de handlinger på postniveau, der gælder for den bruger, der er logget på, skal du angive værdien for værdien for webstedet EntityList/ShowRecordLevelActions til true. Der er f.eks. to brugere: Preston og Teddy. Preston har fuld adgang på kontaktniveau i sagstabellen, mens Teddy har global læseadgang. Hvis der oprettes en liste, som viser alle sagsposterne, kan Preston se alle handlinger (Vis, Rediger og Slet) på de poster, der vedrører hans kontaktperson. I andre poster vil han kun kunne se handlingen Vis. Teddy vil på den anden side kun kunne se handlingen Vis i alle poster.

Hvis indstillingen for webstedet EntityList/ShowRecordLevelActions er angivet til falsk, og tabellen har flere tilladelser, er alle handlinger på postniveau synlige. Men når en bruger forsøger at udføre en handling, som han ikke er godkendt til, vises der en fejlmeddelelse.

Tilføjelse af en side til visning af detaljer

Hvis websiden for detaljeret opslagsvisning indstilles til en webside, kan detaljer om en post, der er angivet i gitteret, vises som skrivebeskyttede eller redigerede, afhængigt af konfigurationen af den tilknyttede formular eller side.

Denne side kan en fuldstændigt tilpasset sideskabelon, måske er oprettet med Liquid. Det mest almindelige scenario er nok, at detaljevisningssiden er en webside, der indeholder enten en basisformular eller en avanceret formular.

Det er vigtigt at være opmærksom på, at hver enkelt post, der er angivet i gitteret, indeholder et link til siden med detaljer, og at linket indeholder en navngivet forespørgselsstrengparameter med id'et for posten. Navnet på forespørgselsstrengparameteren afhænger af navnet på den id-forespørgselsstrengparameter, der er angivet på listen. Til sidst skal du lægge mærke til, at den webside med detaljer, der er målet, også skal være opmærksom på navnet på denne forespørgselsstrengparameter for at kunne hente id'et for den post, der skal forespørges på, og indlæse dens data.

Brug af en basisformular til at få vist oplysninger

Hvis du vil oprette en basisformular, skal du se i de instruktioner, der findes på siden med basisformularer.

Her følger nogle vigtige indstillinger, som du skal være opmærksom på for at sikre, at posten fra listen indlæses i basisformularen.

Navn på parameter for post-id i basisformularen skal svare til Navn på parameter for forespørgselsstreng-id på listen.

Tilstanden kan være enten Rediger eller Skrivebeskyttet afhængigt af dine behov.

Brug af avanceret formular til at få vist oplysninger

Her følger nogle vigtige indstillinger, som du skal være opmærksom på for at sikre, at posten fra listen indlæses i den avancerede formular.

Navn på forespørgselsstrengparameter for primær nøgle i Avanceret formulartrin skal svare til Navn på parameter for forespørgselsstreng-id på listen.

Tilstanden kan være enten Rediger eller Skrivebeskyttet afhængigt af dine behov.

Brug af en side med detaljer til oprettelsesfunktionen

Du kan bruge en brugerdefineret side, basis formular eller avanceret formular på samme måde til oprettelsesfunktionen. Dette er et alternativ til at definere en oprettelseshandling i formularen. Du kan ikke definere både en oprettelseshandling og en brugerdefineret side for Opret: definition af en brugerdefineret handling har førsteprioritet.

Hvis du tildeler en webside til Opret opslag på listen, og du ikke angiver en oprettelseshandling ved hjælp af konfiguration, gengives knappen Opret på listen. Denne knap knytter brugeren til den brugerdefinerede side, du har angivet for Opret.

Konfiguration af listefilter

Det er nemt at tilføje muligheden for at filtrere posterne på en liste – du skal blot aktivere filtreringsindstillingen og derefter vælge en eller flere filtertyper, der skal vises for brugerne. Det er muligt at filtrere efter en attribut, der svarer til tekst, der er angivet af brugeren, eller at vælge fra en række indstillinger. Du kan endda designe stort set alle ønskede filtertyper ved hjælp af Avanceret søgning.

Aktivere listefilteret

Marker afkrydsningsfeltet Aktiveret i sektionen Metadatafilter. Derved tilføjes filtreringsområdet på listen, når den vises. Feltet er tomt, indtil du har defineret mindst én filtertype.

Du kan definere, hvordan filtreringsområdet på listen skal gengives, ved hjælp af indstillingen Retning. Standard, Vandret, gengiver filtreringsområdet over listen. Lodret gengiver filtreringsområdet som et felt til venstre for listen.

Filtertyper

Tekstfilter

Tekstfilteret føjer et tekstfelt til listens filtreringsområde, der er knyttet til en attribut for listens tabeltype. Når en bruger anvender filteret, vises kun de poster, hvis valgte attribut indeholder værdien, på listen.

Hvis du vil tilføje et tekstfilter, skal du vælg + Tekstfilter.

Tekstfilteret bruger følgende attributter:

Attributfilterindstilling

Attributfilterindstillingen tilføjer en række indstillinger, som listen kan filtreres efter, og som er knyttet til en enkelt attribut for listens valgte tabeltype. Når en bruger anvender filteret, viser listen kun de poster, der svarer nøjagtigt til mindst én af de valgte indstillinger.

Attributfilterindstillingen bruger følgende attributter:

Indstillinger for attributfilterindstilling

En attributfilterindstilling kan normalt have et vilkårligt antal indstillinger, med undtagelse af valgliste og booleske attributter. En boolesk attributfilterindstilling kan kun have en eller to indstillinger – én true og én false. Attributfilterindstillingen Valgliste kan have mindst én indstilling for hver af de mulige værdier på valglisten.

Indstillinger har følgende attributter:

Opslagsindstilling

Opslagsindstillingen tilføjer en række indstillinger, som listen kan filtreres efter, og som er knyttet til en relateret tabel for listens valgte tabeltype. Når en bruger anvender filteret, viser listen kun de poster, der svarer nøjagtigt til mindst én af de valgte relaterede poster.

Opslagsindstillingen bruger følgende attributter:

Indstillinger for opslagsindstilling

En Opslagsindstilling kan typisk have en række indstillinger, hvor den eneste begrænsning er antallet af relaterede poster af den valgte relaterede type.

Indstillinger har følgende attributter:

Indstilling af intervalfilter

Indstilling af intervalfilter føjer en række indstillinger, som hver har en eller to betingelser, til området Filter. Når en bruger anvender filteret, viser listen kun de poster, der svarer nøjagtigt til alle betingelser for mindst én af de valgte indstillinger.

Indstilling af intervalfilter bruger følgende attributter:

Indstillinger for intervalfilter

Indstilling af intervalfilter kan have et vilkårligt antal indstillinger. Hver indstilling giver en filterbetingelse med en eller to underordnede betingelser, som begge skal være opfyldt, for at betingelsen er sand.

Indstillinger har følgende attributter:

Indstilling af dynamisk valgliste

Indstilling af dynamisk valgliste tilføjer en række indstillinger, der kan filteres efter, som repræsenterer alle værdier for en bestemt valgliste. Dette er ikke det samme som at vælge en valgliste i Attributfilterindstilling. I Attributfilterindstilling skal du angive et sæt indstillinger, der skal gøres tilgængelige for den bruger, der skal filtreres efter. I Indstilling af dynamisk valgliste skal du kun angive valglistefeltet, så vises hele sættet af indstillinger automatisk. Hvis du har brug for mere kontrol, anbefales det, at du bruger Attributfilterindstilling.

Indstilling af dynamisk valgliste bruger følgende indstillinger:

Indstilling af dynamisk opslag

Opslagsindstillingen Dynamisk tilføjer en række dynamiske indstillinger, som listen kan filtreres efter, og som er knyttet til en relateret tabel for listens valgte tabeltype. Når en bruger anvender filteret, viser listen kun de poster, der svarer nøjagtigt til mindst én af de valgte relaterede poster.

Dette adskiller sig fra en opslagsindstilling. I Opslagsindstilling skal du manuelt angive de relaterede tabeller, der skal filtreres efter. I Indstilling af dynamisk opslag skal du blot angive den relation, der skal filtreres på, så oprettes der en liste over indstillinger baseret på den angivne visning for tilknyttede tabeller.

Indstilling af dynamisk opslag bruger følgende indstillinger:

FetchXML-filter

Intervalfilteret kan oprette enten et simpelt tekstfeltfilter som f.eks. tekstfilteret eller et sæt indstillinger på samme måde som andre filtertyper. Det gør det muligt for dig manuelt at oprette stort set alle filtertyper for listen ved hjælp af FetchXML.

FetchXML-filteret bruger kun én attribut:

Kortvisning for liste

Med lister er det muligt at aktivere og konfigurere en kortvisning over data, der styres af Bing-kort, med søgefunktioner, der kan finde steder i nærheden af en adresse. Ved at udfylde dine poster med koordinatværdier for breddegrad og længdegrad og angive de nødvendige konfigurationsindstillinger, der er anført i denne sektion, kan posterne gengives som tavlenåle på et kort. Poster, der ikke har en værdi for breddegrad eller længdegrad, udelades under søgningen. Den første indlæsning af siden viser alle poster for den oprindelige værdi i feltet Afstandsværdier (i mil eller kilometer afhængigt af de angivne afstandsenheder) fra koordinaterne Standardcenterbreddegrad og Standardcenterlængdegrad. Den visning, der er angivet, ignoreres, når kortvisning bruges, og der anvendes en afstandsforespørgsel på datasættet for at få returneret de resultater, der kan vises på kortet.

Kalendervisning for liste

Brug Kalendervisning for liste til at gengive en liste som en kalender, hvor hver enkelt post er konfigureret, så den fungerer som en enkelt hændelse.

Når poster skal vises ved hjælp af en kalender, skal posterne som minimum have et datofelt. Når hændelser skal have nøjagtige start- og sluttidspunkter, skal de relevante felter være til stede og så videre. Forudsat at disse felter er konfigureret, åbnes en kalendervisning for liste på portalen.

OData-feeds for liste

Hvis en tabel er aktiveret, kan den publiceres til et OData-feed. OData-protokollen er en protokol på programniveau til interaktion med data ved hjælp af RESTful-webtjenester. Data fra dette feed kan vises i en webbrowser, forbruges af et webprogram på klientsiden eller importeres til Excel.

Udvidet visningsfilter for lister

Du kan bruge Tabeltilladelser, hvis du vil sikre poster, men hvis du blot vil angive et filter som en del af det sæt filterindstillinger, den aktuelle portalbruger har brug for, kan du bruge funktionen Liste. Denne funktion understøtter filtrering for den aktuelle bruger, brugerens overordnede firma eller websted på ethvert niveau. Du skal blot oprette visningsfilteret, så det svarer til en enkelt kontaktpost, så erstatter koden dens værdi med den faktiske værdi under kørslen. Der er ingen grund til at tildele værdier til felter i sektionen Filterbetingelser.

• Kontrolelementet finder alle betingelseselementer, hvor uitype="contact", og indstiller værdien til den faktiske værdi for den aktuelle portalbrugers kontakt-id.
• Kontrolelementet finder alle betingelseselementer, hvor uitype="account", og indstiller værdien til den faktiske værdi for den aktuelle portalbrugers overordnede konto-id.
• Kontrolelementet finder alle betingelseselementer, hvor uitype="adx_website", og indstiller værdien til den faktiske værdi for det aktuelle website-id.

Eksempel på visning af filterkriterier

I følgende billede vises en vilkårlig kontakt, der er tildelt en filterbetingelse. Denne kontakt er en 'dummy'-kontakt, men det kan være en hvilken som helst kontaktpersonpost. Dette post-id erstattes med den faktiske værdi af id'et for den bruger, der ser på siden. Hvis brugeren ikke er logget på, vil der ikke blive returneret nogen poster. Det giver større fleksibilitet i filtrering af dataene baseret på brugerens og webstedets kontekst.

Se også

• Microsoft Learn: Få vist flere Dataverse-poster ved hjælp af lister
• Konfigurer en portal
• Omdirigere til en ny URL-adresse på en portal