Overzicht van Web-API voor portals
Met de web-API voor portals kunt u binnen een rijkere gebruikerservaring Power Apps-portalpagina's bouwen. 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.
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.
- 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.
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.
| Naam van site-instelling | Beschrijving |
|---|---|
| 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 |
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.
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.
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
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