Overzicht van Web-API voor portals
Notitie
Met ingang van 12 oktober 2022 wordt Power Apps-portals hernoemd tot Power Pages. Meer informatie: Microsoft Power Pages is nu algemeen beschikbaar (blog)
We zullen binnenkort de documentatie voor Power Apps-portals migreren en samenvoegen met Power Pages-documentatie.
De web-API voor portals zorgt voor een rijkere gebruikerservaring binnen pagina's van Power Apps-portals. U kunt de web-API voor portals gebruiken om voor alle Microsoft Dataverse-tabellen van uw portalpagina's bewerkingen voor maken, lezen, bijwerken en verwijderen uit te voeren. U kunt bijvoorbeeld een nieuw account aanmaken, een contactpersoon bijwerken of de tabelmachtigingen wijzigen voor een product door de web-API voor portals te gebruiken in plaats van de app voor portalbeheer.
Notitie
U kunt de web-API voor portals ook gebruiken in Power Pages. Meer informatie: Wat is Power Pages
Belangrijk
- Uw portalversie moet 9.3.3.x of hoger zijn om deze functie te laten werken.
- De web-API voor portals is gebouwd om een rijkere gebruikerservaring binnen portalpagina's te maken. Het is niet geoptimaliseerd voor services van derden of integratie van toepassingen. Het gebruik van de web-API-portals om te integreren met andere Power Apps-portalsites wordt ook niet ondersteund.
- Bewerkingen van de web-API voor portals zijn beperkt tot tabellen die zijn gerelateerd aan gegevens, bijvoorbeeld accounts, contacten of uw aangepaste tabellen. Configureren van tabelmetagegevens of portalconfiguratietabelgegevens (bijvoorbeeld het configureren van portaltabellen zoals adx_contentsnippet, adx_entityform of adx_entitylist) wordt niet ondersteund met de web-API voor portals. Ga voor een volledige lijst naar niet-ondersteunde configuratietabellen verderop in dit onderwerp.
- De web API voor portals profiteert van het opslaan in cache op de server, dus volgende aanroepen naar de web API zijn sneller dan de eerste aanroepen. Houd er rekening mee dat het wissen van de servercache van de portal tijdelijke prestatieverlies veroorzaakt.
- Voor bewerkingen met de web API voor portals is een licentie voor Power Apps-portals vereist. Web API-aanroepen van anonieme gebruikers worden bijvoorbeeld meegeteld voor de paginaweergavecapaciteit. Web API-aanroepen door geverifieerde gebruikers (intern of extern) tellen niet mee voor paginaweergaven, maar vereisen toepasselijke licenties. Meer informatie: Veelgestelde vragen over licenties voor Power Apps-portals
Web-API-bewerkingen
De web-API voor portals biedt een subset van mogelijkheden voor Dataverse-bewerkingen die u kunt uitvoeren met de Dataverse-API. We hebben de API-indeling zo veel mogelijk gelijk gehouden om de leercurve te verminderen.
Notitie
Web-API-bewerkingen zijn hoofdlettergevoelig.
Web-API-bewerkingen die beschikbaar zijn in portals
- Records van een tabel lezen
- Een record in een tabel maken
- Records in een tabel bijwerken en verwijderen
- Tabellen koppelen en loskoppelen
Site-instellingen voor de web-API
U moet de site-instelling inschakelen om de web-API voor portals voor uw portal in te schakelen. U kunt de web-API op veldniveau configureren die bepaalt welke tabelvelden wel of niet kunnen worden gewijzigd met de web-API voor portals.
Notitie
Gebruik de tabel logische naam voor deze instellingen (bijvoorbeeld account).
| Naam van site-instelling | Omschrijving |
|---|---|
| Webapi/<table name>/enabled | Schakelt de web-API in of uit voor <table name>. Standaard: False Geldige waarden: True, False |
| Webapi/<table name>/fields | Definieert de door komma's gescheiden lijst met kenmerken die kunnen worden gewijzigd met de web-API. Mogelijke waarden: - Alle kenmerken: * - Specifieke kenmerken: attr1,attr2,attr3 Opmerking: de waarde moet een asterisk (*) of een door komma's gescheiden lijst met veldnamen zijn. Belangrijk: dit is een verplichte site-instelling. Als deze instelling ontbreekt, ziet u de fout 'Geen velden gedefinieerd voor deze entiteit'. |
| Webapi/error/innererror | Hiermee wordt InnerError in- of uitgeschakeld. Standaard: False Geldige waarden: True, False |
| Webapi/<table name>/disableodatafilter | Hiermee wordt het OData-filter in- of uitgeschakeld. Standaard: False Geldige waarden: True, False Zie Bekende problemen voor meer informatie. De site-instelling is beschikbaar in de portalversie 9.4.10.74 of later. |
Notitie
Wijzigingen worden alleen van kracht als Site-instellingen is ingesteld op Actief.
Als u bijvoorbeeld de web-API voor de tabel Aanvraag wilt weergeven, waar geverifieerde gebruikers maak-, bijwerk- en verwijderbewerkingen op deze entiteit mogen uitvoeren, worden de site-instellingen weergegeven in de volgende tabel.
| Naam van site-instelling | Waarde Site-instelling |
|---|---|
| Webapi/incident/enabled | true |
| Webapi/incident/fields | attr1, attr2, attr3 |
Beveiliging met de web-API voor portals
U kunt op records gebaseerde beveiliging configureren voor individuele records in portals met tabelmachtigingen. De web-API voor portals heeft toegang tot tabelrecords en volgt de tabelmachtigingen die aan gebruikers zijn gegeven via de toegewezen webrol.
U kunt kolommachtigingen configureren om bevoegdheden voor afzonderlijke kolommen binnen een tabel verder te definiëren tijdens het gebruik van de web-API voor portals.
Aanvragen voor web-API voor portals verifiëren
U hoeft geen verificatiecode op te nemen, omdat de verificatie en autorisatie worden beheerd door de toepassingssessie. Alle web-API-aanroepen moeten een CSRF-token (Cross-Site Request Forgery) bevatten.
EntitySetName gebruiken
Bij verwijzing naar Dataverse-tabellen met behulp van de Web-API van de portal in uw code, moet u de EntitySetName gebruiken. Om toegang te krijgen tot de account-tabel, gebruikt de codesyntaxis bijvoorbeeld de EntitySetName accounts ; /_api/accounts().
Notitie
Gebruik de tabel logische naam voor site-instellingen (bijvoorbeeld account).
U kunt de EntitySetName van specifieke tabellen bepalen door deze stappen te volgen:
Ga naar https://make.powerapps.com
Selecteer het tabblad Dataverse in het zijpaneel en selecteer de tabel.
Selecteer ... (optie Meer opdrachten) en kies vervolgens Geavanceerd, Hulpmiddelen en Setnaam kopiëren om de EntitySetName te kopiëren van de tabel naar uw klembord.
Algemene Verordening Gegevensbescherming (AVG)
Alle aanvraagheaders hebben een contact-id die is doorgegeven voor controledoeleinden. Voor een anonieme gebruiker wordt dit doorgegeven als null.
Als auditregistratie is ingeschakeld, kan een gebruiker alle auditgebeurtenissen zien in het Office 365-auditlogboek.
Meer informatie:
Logboekregistratie van activiteiten inschakelen en gebruiken
Auditlogboekrecords exporteren, configureren en weergeven
Niet-ondersteunde configuratietabellen
De web-API kan niet worden gebruikt voor de volgende configuratietabellen:
adx_contentaccesslevel
adx_contentsnippet
adx_entityform
adx_entityformmetadata
adx_entitylist
adx_entitypermission
adx_entitypermission_webrole
adx_externalidentity
adx_pagealert
adx_pagenotification
adx_pagetag
adx_pagetag_webpage
adx_pagetemplate
adx_portallanguage
adx_publishingstate
adx_publishingstatetransitionrule
adx_publishingstatetransitionrule_webrole
adx_redirect
adx_setting
adx_shortcut
adx_sitemarker
adx_sitesetting
adx_urlhistory
adx_webfile
adx_webfilelog
adx_webform
adx_webformmetadata
adx_webformsession
adx_webformstep
adx_weblink
adx_weblinkset
adx_webnotificationentity
adx_webnotificationurl
adx_webpage
adx_webpage_tag
adx_webpageaccesscontrolrule
adx_webpageaccesscontrolrule_webrole
adx_webpagehistory
adx_webpagelog
adx_webrole_systemuser
adx_website
adx_website_list
adx_website_sponsor
adx_websiteaccess
adx_websiteaccess_webrole
adx_websitebinding
adx_websitelanguage
adx_webtemplate
Bekende problemen
Gebruikers krijgen een CDS-foutmelding als ze de Web API-aanvraag GET aanroepen voor tabellen met meerdere niveaus van een-op-veel of veel-op-veel tabelrechten waarvoor het bovenliggende bereik is gedefinieerd.
De aanbevolen oplossing voor dit probleem is om FetchXML te gebruiken in de OData-query.
U kunt ook de site-instelling Webapi/<table name>/disableodatafilter instellen op True.
Belangrijk
Als u de site-instelling Webapi/<table name>/disableodatafilter instelt op True, kan dit leiden tot tragere prestaties voor de Web API-aanvraag GET.
De site-instelling is beschikbaar in de portalversie 9.4.10.74 of later.
Volgende stap
Query voor gegevens uitvoeren met de web-API voor portals
Zie ook
HTTP-aanvragen samenstellen en fouten verwerken
Bewerkingen voor schrijven, bewerken en verwijderen van portals met de web-API
Zelfstudie: Web-API voor portals gebruiken
Notitie
Laat ons uw taalvoorkeuren voor documentatie weten! Beantwoord een korte enquête. (houd er rekening mee dat deze in het Engels is)
De enquête duurt ongeveer zeven minuten. Er worden geen persoonlijke gegevens verzameld (privacyverklaring).