Informatie over lijsten

Een lijst is een op gegevens gebaseerde configuratie waarmee u een webpagina toevoegt die een lijst met records weergeeft, zonder dat een ontwikkelaar het raster in de portal zichtbaar hoeft te maken. Met lijsten kunt u records beschikbaar maken voor weergave in portals.

Het raster ondersteunt sorteren en wordt gepagineerd als het aantal records groter is dan de opgegeven paginagrootte. Als de webpagina voor detailweergave is opgegeven, bevat elke record een koppeling naar de pagina en wordt de id van de record toegevoegd aan de querytekenreeks samen met de parameternaam van de ID-querytekenreeks. De lijst ondersteunt ook meerdere weergaven. Als meer dan één weergave is opgegeven, wordt een vervolgkeuzelijst weergegeven om de gebruiker toe te staan tussen de verschillende weergaven te schakelen.

De gegevens kunnen ook worden gefilterd door de huidige portalgebruiker, de bovenliggende klantaccount van de huidige portalgebruiker en de huidige portalwebsite. Als er een waarde bestaat voor beide filtervoorwaarden Portalgebruikerskenmerk en Accountkenmerk, wordt in de portal een vervolgkeuzelijst weergegeven om gebruikers toe te staan hun eigen (Mijn) gegevens of gegevens van hun bovenliggende klantaccount weer te geven.

Een lijst aan uw portal toevoegen

De lijst bevat relaties met webpagina´s en verschillende eigenschappen om de initialisatie van de lijst met records binnen de webportal te bepalen. De relatie met de webpagina maakt het dynamisch ophalen van de lijstdefinitie voor een bepaald paginaknooppunt in de website mogelijk. Als u bestaande tabelweergaven wilt weergeven of nieuwe tabelweergaven wilt maken, gaat u naar Portals > Lijsten.

De webpagina's die zijn gekoppeld aan de lijst, kunnen worden weergegeven door de koppeling Webpagina's in de Gerelateerde navigatiekoppelingen in het menu uiterst links te selecteren. Bij het maken van uw lijst bestaat de eerste stap eruit de tabel te kiezen waarvoor u een lijst in de portal wilt weergeven. U kiest vervolgens een of meer weergaven van moedelgestuurde apps om weer te geven.

Bij het maken of bewerken van een webpagina, kunt u een lijst in het opzoekveld opgeven op het webpaginaformulier. De paginasjabloon is meestal de sjabloon Pagina maar kan een van verschillende andere sjablonen zijn die voor inhoud zijn ontworpen omdat de hoofdsjablonen de noodzakelijke logica bevatten om te bepalen of een lijst moet worden weergegeven.

Lijstkenmerken en relaties

Aangepaste JavaScript toevoegen

Het tabblad Opties op het formulier bevat een tekstgebied waarin u aangepaste JavaScript kunt invoeren en als uw pagina jQuery-bibliotheek bevat, kunt u deze hier ook gebruiken. Het scriptblok wordt onder aan de webpagina toegevoegd, vlak voor het afsluitende formuliercode-element van de pagina.

De lijst verkrijgt de gegevens op asynchrone wijze en wanneer dit klaar is, wordt een loaded gebeurtenis geactiveerd waarnaar uw aangepaste JavaScript kan luisteren en iets met items in het raster kan doen. De volgende code vormt een eenvoudig voorbeeld:

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

Zoek een bepaald kenmerkveld en haal de waarde ervan op om de weergave van de waarde eventueel te wijzigen. Met de volgende code wordt elke tabelcel opgehaald die de waarde van het kenmerk accountnumber bevat. Vervang accountnumber door een kenmerk dat geschikt is voor uw tabel en weergave.

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

Lijstconfiguratie

U kunt gemakkelijk acties (Maken, Bewerken, Verwijderen enzovoort) inschakelen en configureren voor records in een lijst. Het is ook mogelijk om standaardlabels, formaten en andere kenmerken te overschrijven zodat de lijst exact op de door u gewenste wijze wordt weergegeven.

Deze instellingen zijn te vinden in de sectie Configuratie van het formulier voor lijsten. Standaard worden alleen Basisinstellingen weergegeven. Selecteer Geavanceerde instellingen om aanvullende instellingen te bekijken.

Kenmerken

Algemene actie-instellingen

In het algemeen hebben tabelacties instellingen die kunnen worden geconfigureerd. In alle gevallen is dit bedoeld om u meer mogelijkheden te bieden in termen van aanpassing, en de velden niet vereist zijn. Als de actie wordt toegevoegd, kan de actie in de portal worden gebruikt, mits de juiste bevoegdheid is verleend door tabelmachtigingen.

In het algemeen kunt u het overeenkomende dialoogvenster voor elke actie configureren. Dit verschijnt alleen als u Bevestiging vereist selecteert.

Geavanceerde instellingen van dialoogvenster Algemeen

Actie-instellingen maken

Als Maakactie wordt ingeschakeld, wordt een knop boven de lijst weergegeven die, wanneer deze wordt geselecteerd, een dialoogvenster opent met een basisformulier waarmee de gebruiker een nieuwe record kan maken, mits de bevoegdheid Maken is verleend door tabelmachtigingen.

Geavanceerde instellingen voor dialoogvenster Formulier maken

Instellingen downloadactie

Als een Downloadactie wordt ingeschakeld, wordt een knop boven de lijst weergegeven waarmee, wanneer deze wordt geselecteerd, de gegevens uit de lijst worden gedownload naar een Excel (.xlsx) bestand.

Instellingen detailactie

Als Detailactie wordt ingeschakeld, kan een gebruiker een alleen-lezen basisformulier van een geselecteerde rij in de lijst weergeven.

Geavanceerde instellingen van het dialoogvenster Details

Instellingen bewerkactie

Als Bewerkactie wordt ingeschakeld, kan een gebruiker een bewerkbaar basisformulier weergeven dat gegevensgebonden is aan de record van de geselecteerde rij van de lijst, mits de bevoegdheid Schrijven is verleend door tabelmachtigingen.

Geavanceerde instellingen van het dialoogvenster Formulier bewerken

Instellingen verwijderactie

Als Verwijderactie wordt ingeschakeld, kan een gebruiker de record van de geselecteerde rij definitief verwijderen uit de lijst, mits de bevoegdheid Verwijderen is verleend door tabelmachtigingen.

(Geavanceerde) instellingen van het dialoogvenster Verwijderen

Instellingen werkstroomactie

Als een Werkstroomactie wordt geactiveerd, kan een gebruiker een werkstroom op aanvraag uitvoeren voor de record van de geselecteerde rij in de lijst. U kunt een willekeurig aantal werkstroomacties toevoegen aan de lijst.

Lijsten beveiligen

Om een lijst te beveiligen, moet u tabelmachtigingen configureren voor de tabel waarvoor records worden weergegeven en het selectievakje Tabelmachtigingen inschakelen inschakelen. Als u dit niet doet, ziet u de volgende waarschuwing:

Tabelmachtigingen moeten zijn ingeschakeld voor deze record of iedereen op internet kan de gegevens bekijken.

Door de lijst te beveiligen, wordt ervoor gezorgd dat voor elke gebruiker die toegang heeft tot de pagina, alleen records waaraan machtiging is verleend, worden weergegeven. Dit wordt bereikt door een extra filter dat wordt toegevoegd aan de weergaven van modelgestuurde apps die via de lijst naar boven komen. Met dit filter wordt alleen gefilterd voor records die voor de gebruiker via de machtiging Lezen toegankelijk zijn.

Daarnaast zullen acties die voor de lijst worden gedefinieerd, de overeenkomstige machtigingen voor die actie per record honoreren. Dat wil zeggen: als u over de machtiging Bewerken voor een record beschikt, wordt de bewerkactie voor die record ingeschakeld. Hetzelfde geldt voor Verwijderen, Maken enzovoort. Houd er rekening mee dat als er geen records beschikbaar zijn, een bericht hierover wordt weergegeven als de lijst wordt geladen.

Een goed websiteontwerp vereist echter dat als gebruikers geen rol hebben met machtigingen voor de tabel (dat wil zeggen dat er nooit een situatie is waarin ze records mogen zien), deze gebruikers helemaal geen toegang tot de pagina mogen krijgen. Idealiter moet de pagina worden beveiligd via toegangsmachtigingen voor webpagina´s.

Als u een lijst hebt beveiligd door Tabelmachtigingen inschakelen te selecteren en de acties op recordniveau wilt weergeven die van toepassing zijn op de aangemelde gebruiker, moet u de waarde van de EntityList/ShowRecordLevelActions-site-instelling instellen op true. Er zijn bijvoorbeeld twee gebruikers: Preston en Teddy. Preston heeft alle toegang op contactniveau voor de tabel Aanvraag, terwijl Teddy globale leestoegang heeft. Als er een lijst wordt gemaakt om alle aanvraagrecords weer te geven, ziet Preston alle acties (Weergeven, Bewerken en Verwijderen) voor de records die zijn gerelateerd aan zijn contactpersoon. Voor andere records zou hij alleen de actie Bekijken zien. Teddy zou alleen de actie Kijken zien op alle records.

Als de EntityList/ShowRecordLevelActions-site-instelling is ingesteld op false en de tabel meerdere machtigingen heeft, zijn alle acties op recordniveau zichtbaar. Maar wanneer een gebruiker een actie probeert uit te voeren waartoe hij geen toestemming heeft, wordt een fout weergegeven.

Een weergavedetailpagina toevoegen

Door het opzoekveld Webpagina voor detailweergave in te stellen op een webpagina, kunnen de details van een record de in het raster wordt weergegeven, worden weergegeven als alleen-lezen of bewerkt. Dit is afhankelijk van de configuratie van het bijbehorende formulier of de bijbehorende pagina.

Deze pagina kan een volledig aangepaste paginasjabloon zijn die mogelijk is gemaakt met Liquid. Het vaakst voorkomende scenario is waarschijnlijk dat de detailpagina een webpagina is die een basisformulier of geavanceerd formulier bevat.

Belangrijk is dat u er rekening mee houdt dat elke record die in het raster wordt weergegeven, een hyperlink heeft naar de detailpagina, en dat de koppeling een benoemde querytekenreeksparameter bevat met de id van de record. De naam van de parameter Querytekenreeks is afhankelijk van de parameternaam van de querytekenreeks-id die in de lijst is opgegeven. Tot slot moet u er rekening mee houden dat de beoogde detailwebpagina ook op de hoogte moet zijn van de naam van deze parameter Querytekenreeks om de id van de record op te halen die nodig is om een query uit te voeren en de bijbehorende gegevens te laden.

Een basisformulier gebruiken om details weer te geven

Als u een basisformulier wilt maken, raadpleegt u de instructies op de pagina Basisformulier.

Hierna volgen de belangrijke instellingen waarmee u rekening dient te houden om ervoor te zorgen dat de record van de lijst in het basisformulier wordt geladen.

De naam van de parameter voor record-id op het basisformulier moet overeenkomen met de parameternaam van de querytekenreeks-id in de lijst.

De modus kan Bewerken of Alleen-lezen zijn, afhankelijk van uw behoeften.

Een geavanceerd formulier gebruiken om details weer te geven

Hierna volgen de belangrijke instellingen waarmee u rekening dient te houden om ervoor te zorgen dat de record van de lijst in het geavanceerde formulier wordt geladen.

De parameternaam van de primaire sleutel van de querytekenreeks in de geavanceerd-formulierstap moet overeenkomen met de parameternaam van de querytekenreeks-id in de lijst.

De modus kan Bewerken of Alleen-lezen zijn, afhankelijk van uw behoeften.

Een detailpagina gebruiken voor de functie Maken

U kunt een aangepaste pagina, basisformulier of geavanceerd formulier op dezelfde manier voor de functie Maken gebruiken. Dit is een alternatief voor het definiëren van een maakactie op het formulier. U kunt niet zowel een maakactie als een aangepaste pagina voor Maken definiëren: het definiëren van een aangepaste actie heeft voorrang.

Als u een webpagina toewijst aan Opzoekveld maken in de lijst en geen maakactie opgeeft met behulp van Configuratie, wordt een knop Maken weergegeven in de lijst. Met deze knop wordt de gebruiker aan de aangepaste pagina gekoppeld die u hebt toegewezen voor Maken.

Configuratie lijstfilter

Het toevoegen van de mogelijkheid om records in een lijst te filteren is gemakkelijk: schakel alleen de filteroptie in en kies vervolgens een of meer filtertypen die u aan gebruikers wilt weergeven. Het is mogelijk om te filteren op een kenmerk dat overeenkomt met bepaalde tekst die door de gebruiker is opgegeven, of om een selectie te maken uit een reeks opties. U kunt zelfs vrijwel elk soort filter ontwerpen dat u kunt bedenken, met behulp van Geavanceerd zoeken.

Het lijstfilter inschakelen

Schakel in de sectie Metagegevensfilter het selectievakje Ingeschakeld in. Hiermee wordt het filtergebied toegevoegd aan de lijst wanneer deze wordt weergegeven. Totdat u ten minste één filtertype hebt gedefinieerd, wordt het vak leeg weergegeven.

U kunt definiëren hoe het filtergebied in de lijst wordt weergegeven met de instelling Stand. Met de standaardwaarde, Horizontaal, wordt het filtergebied boven de lijst weergegeven. Met de verticale afdrukstand wordt het filtergebied als een vak links van de lijst weergegeven.

Filtertypen

Tekstfilter

Met het tekstfilter wordt een tekstvak toegevoegd aan het filtergebied van de lijst, dat is gekoppeld aan een kenmerk van het tabeltype van de lijst. Wanneer een gebruiker het filter toepast, worden in de lijst alleen de records weergegeven waarvan het geselecteerde kenmerk de waarde bevat.

Als u een tekstfilter wilt toevoegen, selecteert u +Tekstfilter.

Het tekstfilter gebruikt de volgende kenmerken:

Kenmerkfilterset

Met de kenmerkfilterset wordt een reeks opties toegevoegd waarop de lijst moet worden gefilterd, gebonden aan één kenmerk van het geselecteerde tabeltype van de lijst. Wanneer een gebruiker het filter toepast, worden in de lijst alleen de records weergegeven die exact overeenkomen met ten minste één van de geselecteerde opties.

Het kenmerkfilterset gebruikt de volgende kenmerken:

Opties van kenmerkfilterset

Een kenmerkfilterset kan gewoonlijk een willekeurig aantal opties hebben, met uitzondering van de kenmerken Picklist en Boolean. Een kenmerkfilterset van het type Boolean kan slechts een of twee opties hebben—één true en één false. Een kenmerkfilterset van het type Picklist kan maximaal één optie hebben voor elke mogelijke waarde in de selectielijst.

Opties hebben de volgende kenmerken:

Opzoekset

Met de opzoekset wordt een reeks opties toegevoegd waarop de lijst moet worden gefilterd, gebonden aan een tabel die is gerelateerd aan het geselecteerde tabeltype van de lijst. Wanneer een gebruiker het filter toepast, worden in de lijst alleen de records weergegeven die exact overeenkomen met ten minste één van de geselecteerde gerelateerde opties.

In de opzoekset worden de volgende kenmerken gebruikt:

Opzoeksetopties

Een opzoekset kan doorgaans een willekeurig aantal opties hebben, waarbij de enige beperking het aantal gerelateerde records van het geselecteerde gerelateerde type is.

Opties hebben de volgende kenmerken:

Bereikfilterset

Met de bereikfilterset wordt een reeks opties, elk met een of twee voorwaarden, toegevoegd aan het filtergebied. Wanneer een gebruiker het filter toepast, worden in de lijst alleen de records weergegeven die exact overeenkomen met alle voorwaarden in ten minste één van de geselecteerde opties.

In de bereikfilterset worden de volgende kenmerken gebruikt:

Opties van bereikfilterset

Een bereikfilterset kan een willekeurig aantal opties hebben. Met elke optie wordt een filtervoorwaarde gemaakt met of een of twee subvoorwaarden. Aan deze beide voorwaarden moet worden voldaan. Anders is de voorwaarde niet geldig.

Opties hebben de volgende kenmerken:

Dynamische selectielijstset

Met de dynamische selectielijstset wordt een reeks opties toegevoegd waarop moet worden gefilterd, waarmee alle waarden van een opgegeven selectielijstveld worden vertegenwoordigd. Dit is anders dan het selecteren van een selectielijst in de kenmerkfilterset. In de kenmerkfilterset moet u een set opties opgeven die beschikbaar worden gesteld aan de gebruiker om op te filteren. In de dynamische selectielijstset moet u alleen het selectielijstveld opgeven en de volledige set opties worden automatisch opgegeven. Als u meer controle nodig hebt, raden we u aan de kenmerkfilterset te gebruiken.

.

De dynamische selectielijstset gebruikt de volgende opties:

Dynamische opzoekset

Met de dynamische opzoekset wordt een dynamische reeks opties toegevoegd waarop de lijst moet worden gefilterd, gebonden aan een tabel die is gerelateerd aan het geselecteerde tabeltype van de lijst. Wanneer een gebruiker het filter toepast, worden in de lijst alleen de records weergegeven die exact overeenkomen met ten minste één van de geselecteerde gerelateerde opties.

Dit is anders dan een opzoekset. In de opzoekset moet u handmatig de gerelateerde tabellen opgeven waarop moet worden gefilterd. In de dynamische opzoekset moet u alleen de relatie opgeven waarop moet worden gefilterd, en een lijst met opties die zijn gegenereerd op basis van de opgegeven weergave van gerelateerde tabellen.

De dynamische opzoekset gebruikt de volgende opties:

FetchXML-filter

Met het bereikfilter kan een eenvoudig tekstvakfilter worden gemaakt, zoals het tekstfilter, of een set opties, zoals de andere filtertypen. Hiermee kunt u vrijwel elk soort filter voor de lijst handmatig maken met behulp van FetchXML.

Het FetchXML-filter gebruikt slechts één kenmerk:

Kaartweergave van lijst

Met lijsten is het mogelijk om een kaartweergave van de gegevens in te schakelen en te configureren, mogelijk gemaakt door Bing-kaarten met zoekfunctionaliteit om te zoeken naar locaties in de buurt van een adres. Door uw records met coördinaatwaarden voor lengte- en breedtegraad in te vullen en de noodzakelijke configuratieopties op te geven die in deze sectie worden weergegeven, kunnen uw records worden weergegeven als punaises op een kaart. Elke record die geen lengte- of breedtegraadwaarde heeft, wordt van de zoekopdracht uitgesloten. Wanneer de pagina voor de eerste keer wordt geladen, worden alle records weergegeven binnen de initiële waarde van het veld Afstandswaarden (in mijlen of kilometers, afhankelijk van de opgegeven afstandseenheden) op basis van de coördinaten voor Standaardlengtegraad van midden en Standaardbreedtegraad van midden. De opgegeven weergave wordt genegeerd wanneer kaartweergave wordt gebruikt, en er wordt een afstandsquery toegepast op de gegevensset om de toewijsbare resultaten te retourneren.

Agendaweergave lijst

Gebruik de agendaweergave van de lijst om een lijst als een agenda weer te geven, waarbij elke afzonderlijk record wordt geconfigureerd om als één gebeurtenis te fungeren.

Voor weergave van records met een agenda moeten deze records minimaal een datumveld hebben. Gebeurtenissen kunnen alleen exacte begin- en eindtijden hebben als de juiste velden zijn ingesteld, enzovoort. Ervan uitgaande dat deze velden worden geconfigureerd, wordt een agendaweergave van de lijst in de portal weergegeven.

OData-feeds van lijst

Indien ingeschakeld, kan een tabel naar een OData-feed worden gepubliceerd. Het OData-protocol is een protocol op toepassingsniveau voor interactie met gegevens via RESTful-webservices. Gegevens van deze feed kunnen worden weergegeven in een webbrowser, die wordt gebruikt door een clientwebtoepassing, of geïmporteerd naar Excel.

Geavanceerde-weergavefilter voor lijsten

U kunt tabelmachtigingen gebruiken als u records wilt beveiligen, maar als u simpelweg een filter wilt opgeven als onderdeel van de set met filteropties die relevant is voor de huidige portalgebruiker, kunt u de functie voor lijsten gebruiken. Deze functie ondersteunt het filteren van de huidige gebruiker, de bovenliggende account van de gebruiker of de website op elk gewenst niveau. Maak simpelweg het weergavefilter zodat dit overeenkomt met een enkele contactpersoonrecord, waarbij de code deze waarde vervangt door de werkelijke waarde tijdens de uitvoering—. Het is niet nodig waarden toe te wijzen aan velden in de sectie Filtervoorwaarden.

• Het besturingselement vindt alle voorwaarde-elementen waarbij uitype="contact" en stelt de waarde in op de werkelijke waarde van de contact-id van de huidige portalgebruiker.
• Het besturingselement vindt alle voorwaarde-elementen waarbij uitype="account" en stelt de waarde in op de werkelijke waarde van de bovenliggende account-id van de huidige portalgebruiker.
• Het besturingselement vindt alle voorwaarde-elementen waarbij uitype="adx_website" en stelt de waarde in op de werkelijke waarde van de huidige website-id.

Voorbeeldweergave Filtercriteria

De volgende afbeelding toont een willekeurig contactpersoon die is toegewezen aan een filtervoorwaarde. Deze contactpersoon is toevallig een 'dummy' stubcontactpersoon, maar dit kan elke contactpersoonrecord zijn. De id van deze record wordt vervangen door de werkelijke waarde van de id van de gebruiker die de pagina bekijkt. Als de gebruiker niet is ingelogd, worden er geen records geretourneerd. Dit biedt meer flexibiliteit bij het filteren van de gegevens op basis van de gebruiker- en websitecontext.

Zie ook

• Microsoft Learn: meerdere Dataverse-records weergeven met behulp van lijsten
• Een portal configureren
• Omleiden naar een nieuwe URL in een portal