Om listor

En lista är en datadriven konfiguration som används för att lägga till en webbsida som återger en lista över poster utan behov av en utvecklare för att exponera rutnätet i portalen. Genom att använda listan kan du visa poster på portaler.

Rutnätet stöder sortering och har sidbrytning om antalet poster är större än sidstorleken som anges. Om du har angett webbsida för informationsvy kommer varje post att innehålla en länk till sidan och ID för posten kommer att läggas till frågesträngen tillsammans med parameternamn för frågesträng på ID. Listan stöder också flera vyer. Om du har angett mer än en vy visas en listruta så att användaren kan växla mellan att visa olika vyer.

Data kan också filtreras genom den aktuella portalanvändaren, den aktuella portalanvändarens överordnade kundkonto och den aktuella portalwebbplatsen. Om det finns ett värde för både filtervillkoret Portalanvändarattribut och filtervillkoret Kontoattribut kommer portalen att återge en listruta för att låta användaren visa "Mina" data eller hans/hennes överordnade kundkontodata.

Lägg till en lista på portalen

Listan innehåller relationer till webbsidor och olika egenskaper för att kontrollera initieringen av listan över poster på portalen. Relationen till webbsidan tillåter dynamisk hämtning av listdefinitionen för en viss sidnod på webbplatsen. Om du vill visa befintliga tabellvyer eller skapa nya tabellvyer, går du till Portaler > Listor.

De webbsidor som associeras med listan kan visas genom att välja länken Webbsidor som finns i navigeringslänken Relaterade i menyn längst till vänster. När du skapar listan är det första steget att välja den tabell du vill visa en lista för på portalen. Sedan väljer du en eller flera modellstyrda appvyer att återge.

När du skapar eller redigerar en webbsida kan du ange en lista i sökfältet på webbsidesformuläret. Sidmallen är vanligtvis mallen Sida, men kan vara en av flera andra mallar avsedda för innehåll, detta eftersom huvudmallar innehåller nödvändig logik för att avgöra om en lista ska återges.

Listattribut och relationer

Lägg till anpassat JavaScript

Fliken Inställningar i formuläret innehåller ett textområde där du kan ange anpassade JavaScript, och om sidan innehåller jQuery-bibliotek, du kan använda dem här också. Skriptblocket kommer att läggas till längst ned på webbsidan, precis före sidans avslutande formulärtaggelement.

Listan hämtar sina data asynkront, och när den är slutför utlöser den en loaded-händelse som din anpassade JavaScript kan söka efter och applicera objekt i rutnätet på. Följande kod är ett ytterst enkelt exempel:

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

Sök efter ett visst attributfält och ta reda på dess värde för att möjligen kunna ändra återgivningen av värdet. Följande kod hämtar varje cell i tabellen som innehåller värdet för den accountnumber attribut. Ersätt accountnumber med ett attribut som passar din tabell och vy.

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

Listkonfiguration

Du kan enkelt aktivera och konfigurera åtgärder (skapa, redigera, ta bort och så vidare) för poster i en lista. Det går också att åsidosätta standardetiketter, storlekar och andra attribut så att listan visas exakt som du vill.

Dessa inställningar finns i avsnittet konfiguration i listformuläret. Som standard visas endast Grundläggande inställningar. Välj Avancerade inställningar för att se ytterligare inställningar.

Attribut

Allmänna åtgärdsinställningar

Tabellåtgärder har i allmänhet inställningar som kan konfigureras. Detta görs alltid för att ge dig fler alternativ i fråga om anpassning, och fälten är inte obligatoriska. Om du helt enkelt lägger till åtgärden gör detta att åtgärden kan vidtas på portalen, förutsatt att rätt behörighet har beviljats av tabellbehörigheten.

Vanligtvis kan du konfigurera motsvarande dialogruta för varje åtgärd, som endast visas om du väljer Bekräftelse krävs.

Avancerade inställningar för allmän dialogruta

Skapa åtgärdsinställningar

Om du aktiverar en Skapa åtgärd återger detta en knapp ovanför den entitetslista som, när den väljs, öppnar en dialogruta med ett grundläggande formulär som låter en användare skapa en ny post - förutsatt att behörigheten "Skapa" har beviljats av tabellbehörigheterna.

Avancerade inställningar för dialogrutan Skapa formulär

Hämta åtgärdsinställningar

Om du aktiverar en Hämta åtgärd återges en knapp ovanför listan som, när den väljs, hämtar data från listan till en Excel-fil (.xlsx).

Inställningar för information om åtgärd

Att aktivera en Information om åtgärd låter en användare visa ett skrivskyddat grundläggande formulär från en vald rad i listan.

Avancerade inställningar för dialogrutan Detaljer

Inställningar för Redigera åtgärd

Om du aktiverar en Redigera åtgärd kan en användare visa ett redigerbart grundläggande formulär som är databundet till posten för listans valda rad, förutsatt att "Skriv"-behörigheten har beviljats av tabellbehörigheten.

Avancerade inställningar för dialogrutan Redigera formulär

Inställningar för Radera åtgärd

Om du aktiverar en Ta bort åtgärd kan en användare permanent radera posten för den valda raden i listan förutsatt att behörigheten "Ta bort" har beviljats av tabellbehörigheterna.

Inställningar (avancerade) för dialogrutan Radera

Inställningar för arbetsflödesåtgärd

Om du aktiverar en Arbetsflödesåtgärd kan en användare köra ett arbetsflöde på begäran mot posten för den valda raden i listan. Du kan lägga till valfritt antal arbetsflödesåtgärder i listan.

Skydda listor

Om du vill skydda en lista måste du konfigurera tabellbehörigheter för den tabell för vilken poster visas, samt dessutom markera kryssrutan för inställningar Aktivera tabellbehörigheter. Om det inte gör det visas följande varning:

Tabellbehörigheter måste aktiveras för den här posten, annars kan vem som helst på Internet visa data.

Om du säkrar en lista säkerställer detta att alla användare som öppnar sidan endast får se poster för vilka de har behörighet. Detta kan göras genom att ett filter läggs till i modellstyrda appvyer som exponeras via listan. Det här filtret filtrerar endast för poster som är tillgängliga för användaren via behörigheten Läs.

Dessutom kommer alla åtgärder som definierats för listan att respektera motsvarande behörigheter för den åtgärden, på post-för-post-basis. Om du alltså har behörigheten Redigera för en post kommer åtgärden Redigera att aktiveras för den posten. Detsamma gäller för Ta bort, Skapa o.s.v. Observera att om det finns inga poster, så kommer ett meddelande om detta att visas när listan läses in.

Däremot kräver en bra webbplatsdesign att om en användare inte har en roll med några behörigheter för tabellen (det vill säga, det kan aldrig uppstå en situation där de bör se några poster), så bör de inte ha åtkomst till sidan alls. I idealfallet bör sidan skyddas med åtkomstbehörigheter för webbsida.

Om du har säkrat en lista genom att välja Aktivera tabellbehörigheter och vill visa de åtgärder på postnivå som är tillämpliga på den inloggade användaren, måste du ställa in värdet för webbplatsinställningen EntityList/ShowRecordLevelActions som true. Det finns till exempel två användare: Preston och Teddy. Preston har all åtkomst via ärendetabellen, medan Teddy har global läsbehörighet. Om en lista skapas för att visa alla ärendeposter ser Preston alla åtgärder (Visa, Redigera och Ta bort) på de poster som är relaterade till hans kontakt I andra poster visas endast åtgärden Visa. Teddy skulle å andra sidan endast visa åtgärden Visa för alla poster.

Om webbplatsinställningen EntityList/ShowRecordLevelActions anges till falskt och tabellen har flera behörigheter visas alla åtgärder på postnivån. Men när en användare försöker utföra en åtgärd som han inte är behörig att visa, visas ett felmeddelande.

Lägga till en sida för informationsvisning

Genom att ställa in sökningen för en webbsida för informationsvy till en webbsida kan informationen i en rutnätspost visas skrivskyddad eller redigerad, beroende på konfigurationen för associerat formulär eller associerad sida.

Den här sidan kan vara en helt anpassad sidmall, som kanske har skapats med Liquid. Det vanligaste scenariot är troligen att informationssidan är en webbsida som antingen innehåller ett grundläggande formulär eller avancerade formulär.

Det viktiga att tänka på är att samtliga poster i rutnätet har en hyperlänk till informationssidan, och att länken innehåller en namngiven frågesträngsparameter med postens ID. Namnet på parametern Frågesträng beror på det parameternamn för ID-frågesträng som anges på listan. Det sista att komma ihåg är att den riktade informationswebbsidan också måste vara medveten om namnet på den här frågeparametern för att få ID för den post som sidan ska tillfråga och hämta data för.

Använda ett grundläggande formulär för att visa information

Om du vill skapa ett grundläggande formulär, se då anvisningarna på sidan grundläggande formulär.

Här följer några viktiga inställningar att känna till för att säkerställa att posten från listan läses in i grundläggande formuläret.

Parameternamnet för post-ID det grundläggande formuläret måste matcha namnet på fråge-ID på listans frågesträngsparameter.

Läget kan vara antingen Redigera eller Skrivskyddat, beroende på dina behov.

Använda ett avancerat formulär för att visa information

Här följer några viktiga inställningar att känna till för att säkerställa att posten från listan läses in i avancerade formuläret.

Namnet för primär nyckel på avancerade formulärstegets frågesträngsparameter måste matcha namnet på fråge-ID på listans frågesträngsparameter.

Läget kan vara antingen Redigera eller Skrivskyddat, beroende på dina behov.

Använda en informationssida för funktionen Skapa

Du kan använda en anpassad sida, ett grundläggande formulär eller ett avancerat formulär på samma sätt för funktionen Skapa. Det här är ett alternativ till att definiera en Skapa-åtgärd för formuläret. Du kan inte definiera både en Skapa-åtgärd och en anpassad sida för Skapa: definiera en anpassad åtgärd i första hand.

Om du tilldelar en webbsida för Skapa uppslag på listan och inte anger en Skapa-åtgärd med hjälp av Konfiguration, kan en Skapa-knapp återges i listan; knappen länkar användaren till den anpassade sida som du har angett för Skapa.

Lista filterkonfiguration

Det är enkelt att lägga till möjligheten att filtrera poster på en lista: Bara aktivera alternativet för filtrering och välj sedan en eller flera filtertyper som ska visas för användarna. Du kan filtrera efter ett attribut som matchar text som användaren tillhandahåller eller att välja ett antal olika alternativ. Du kan även utforma praktiskt taget alla slags filter ed hjälp av den avancerade sökningen.

Aktivera listfilter

I avsnittet Metadatafilter markera kryssrutan Aktiverad. Detta kommer att lägga till filterområdet i listan när denna visas. Rutan visas tom tills du har definierat minst en filtertyp.

Du kan definiera hur filterområdet på listan kommer att återges med hjälp av inställningen Orientering. Standarden, Horisontellt, återger filterområdet ovanför listan. Vertikal orientering återger filterområdet som en ruta till vänster om listan.

Filtertyper

Textfilter

Textfiltret lägger till en textruta i området Filterområde för lista som är knutet till ett attribut för listans tabelltyp. När en användare använder filtret, visar listan endast de poster vars valda attribut innehåller värdet.

Om du vill lägga till ett textfilter, välj +Textfilter.

Textfiltret använder följande attribut:

Inställning av attributfilter

Inställningen för attributfilter tillför ett antal alternativ att filtrera listan efter, kopplade till ett enda attribut i listans valda tabelltyp. När en användare använder filtret visar listan endast de poster som exakt matchar minst ett av de valda alternativen.

Filterinställningarna för attribut använder följande attribut:

Alternativ för inställning av attributfilter

En inställning för attributfilter kan vanligtvis ha ett stort antal alternativ, med undantag för attribut för plocklista och booleska attribut. En filterinställning för booleskt attribut kan ha endast ett eller två alternativ — ett sant alternativ och ett falskt. En filterinställning för attributet Plocklista kan ha högst ett alternativ för varje möjligt värde i plocklistan.

För alternativ finns följande attribut:

Inställning av uppslag

Inställningen för sökning tillför ett antal alternativ att filtrera listan efter, kopplade till en relaterad tabell till listans valda tabelltyp. När en användare använder filtret visar listan endast de poster som exakt matchar minst ett av de valda relaterade posterna.

Inställningen för sökning använder följande attribut:

Alternativ för inställning av uppslag

En sökningsinställning kan vanligtvis ha valfritt antal alternativ. De enda begränsningen är antalet relaterade poster av den valda, relaterade typen.

För alternativ finns följande attribut:

Inställning av intervallfilter

Filterinställningen för intervall tillför ett antal alternativ, vart och ett med ett eller två villkor, till filterområdet. När en användare använder filtret visar listan endast de poster som exakt matchar alla villkor på minst ett av de valda alternativen.

Filterinställningarna för Intervall använder följande attribut:

Inställningsalternativ för intervallfilter

Inställningarna för spannfilter kan ha ett stort antal antal alternativ. Varje alternativ ger ett filtervillkor med ett eller två undervillkor, som båda måste uppfyllas för villkoret ska gälla.

För alternativ finns följande attribut:

Inställning av dynamisk plocklista

Inställningen för dynamisk plocklista tillför ett antal alternativ att filtrera efter som representerar alla värden i ett visst plocklistefält. Detta skiljer sig från att välja en plocklista i inställningarna för attributfilter. I inställningarna för attributfilter måste du ange en uppsättning alternativ som ska göras tillgängliga för användaren att filtrera efter; i inställningarna för den dynamiska plocklistan behöver du endast ange plocklistefältet, så kommer samtliga inställningar att tillhandahållas automatiskt. Om du behöver bättre kontroll rekommenderar vi att du använder inställningarna för attributfilter.

Inställningarna för dynamisk plocklista använder följande alternativ:

Dynamisk inställning av uppslag

Inställningen Dynamisk sökning tillför ett antal dynamiska alternativ att filtrera listan efter, kopplade till en relaterad tabell till listans valda tabelltyp. När en användare använder filtret visar listan endast de poster som exakt matchar minst ett av de valda relaterade posterna.

Detta skiljer sig från sökningsinställningarna. För inställning av uppslag måste du manuellt ange relaterade tabeller att filtrera efter. I inställningarna för dynamisk sökning behöver du bara ange relationen som ska filtreras, så kommer en lista med alternativ att skapas baserat på den angivna vyn för relaterade tabellerna.

Inställningarna för dynamiska uppslag använder följande alternativ:

FetchXML-filter

Spannfiltret kan antingen skapa ett enkelt textrutefilter som exempelvis textfiltret, eller också en uppsättning alternativ som de andra filtertyperna. Därigenom kan du manuellt skapa praktiskt taget alla typer av filter för listan med FetchXML.

FetchXML-filtret använder endast ett attribut:

Kartvy för lista

Med listan kan du aktivera och konfigurera en kartvy av de data som drivs av Bing-kartor med sökfunktion för att hitta platser nära en adress. Genom att fylla i dina poster med latitud- och longitudkoordinatvärden och ange nödvändiga konfigurationsalternativ som anges i det här avsnittet kan dina poster återges som knappnålar på en karta. Alla poster som inte har ett värde för latitud och longitud utesluts från sökningen. Den inledande inläsningen av sidan visar alla poster i det första värdet i fältet för avståndsvärden (i miles eller km, beroende på vilken avståndsenhet som har angetts) från koordinaterna för Standardcentrering Latitud och Standardcentrering longitud. Vyn som angetts ignoreras när kartvyn används, och en avståndsfråga tillämpas på datauppsättningen för att returnera kartresultaten.

Kalendervy för lista

Använd vyn Lista kalender för att återge en lista som en kalender, där varje enskild post konfigureras att fungera som en enskild händelse.

För att visa posterna i en kalender måste posterna innehålla minst ett datumfält. För att händelser ska få exakta start- och sluttider måste rätt fält vara på plats och så vidare. Förutsatt att dessa fält är konfigurerade kommer en listkalendervy att visas på portalen.

OData-flöde för lista

Efter aktivering kan en tabell publiceras till ett OData-flöde. OData-protokollet är ett protokoll på programnivå för att interagera med data via RESTful-webbtjänster. Data från detta flöde kan visas i en webbläsare, förbrukas av ett webbprogram på klientsidan eller importeras till Excel.

Förbättrat vyfilter för listor

Du kan använda tabellbehörigheter om du vill skydda poster, men om du bara vill tillhandahålla ett filter som en del av den filteruppsättning som är relevant för den aktuella portalanvändaren kan du använda funktionen listan. Den här funktionen stöder filtrering av den aktuella användaren, användarens överordnat konto eller webbplats på varje djup. Skapa bara filtret för att matcha varje enskild kontaktpost och koden ersätter värdet med det faktiska värdet vid körning —du behöver inte tilldela värden till fält i avsnittet Filtervillkor.

• I kontrollen hittas alla villkorselement där uitype="contact" och värdet för det faktiska värdet för den aktuella portalanvändarens kontakt-ID anges.
• I kontrollen hittas alla villkorselement där uitype="account" och värdet för det faktiska värdet för den aktuella portalanvändarens överordnade konto-ID anges.
• I kontrollen hittas alla villkorselement där uitype="adx_website" och värdet för det faktiska värdet för den aktuella portalanvändarens webbplats-ID anges.

Exempel på filtervillkor för vy

Följande bild illustrerar en kontakt som tilldelats ett filtervillkor, den här kontakten verkar vara en stub "dummy"-kontakt, men kan vara en kontaktpost. ID för den här posten kommer att ersättas med det faktiska värdet för ID:t för den användare som visar sidan. Om användaren inte är inloggad returneras inga poster. Detta ger större flexibilitet vid filtrering av data utifrån användare och webbplatser i kontext.

Se även

• Microsoft Learn: Visa flera Dataverse-poster med hjälp av listor
• Konfigurera en portal
• Omdirigera till en ny URL på en portal