Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
De web-API voor portals zorgt voor een rijkere gebruikerservaring binnen Power Pages-sites. U kunt de web-API gebruiken om voor alle Microsoft Dataverse-tabellen van uw webpagina's bewerkingen voor maken, lezen, bijwerken en verwijderen uit te voeren. U kunt bijvoorbeeld een nieuw account maken of een contactpersoon bijwerken zonder een formulier of multistepformulier te gebruiken met behulp van de web-API van portals.
De web-API maakt gebruik van de /_api route (bijvoorbeeld https://yoursite.powerappsportals.com/_api/accounts) en volgt een RESTful-patroon dat vergelijkbaar is met de Dataverse-web-API.
Belangrijk
- 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 voor portals om te integreren met andere Power Pages sites wordt niet ondersteund.
- Bewerkingen van de web-API voor portals zijn beperkt tot tabellen die zijn gerelateerd aan gegevens, bijvoorbeeld accounts, contactpersonen of uw aangepaste tabellen. Het configureren van tabelmetagegevens of portalconfiguratietabelgegevens, bijvoorbeeld het configureren van portaltabellen zoals adx_contentsnippet, adx_entityform of adx_entitylist, wordt niet ondersteund met behulp van de web-API voor portals. Zie voor een volledige lijst niet-ondersteunde configuratietabellen verderop in dit artikel.
- 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. Het wissen van de server-side-cache van het portaal veroorzaakt tijdelijk prestatieverlies.
- Voor bewerkingen met de web-API voor portals is een Power Pages-licentie vereist. Web-API-aanroepen van anonieme gebruikers tellen bijvoorbeeld mee voor de capaciteit van anonieme gebruikers. Web-API-aanroepen van geverifieerde gebruikers (intern of extern) tellen niet mee voor paginaweergaven, maar vereisen toepasselijke geverifieerde gebruikerscapaciteitslicenties. Zie Power Pages veelgestelde vragen over licenties voor meer informatie.
- Het aanroepen van acties en functies met behulp van de web-API voor portals wordt niet ondersteund.
Web-API-bewerkingen
De web-API voor portals biedt een subset van mogelijkheden voor Dataverse-bewerkingen die u kunt uitvoeren met de Dataverse-API. De API-indeling is zo vergelijkbaar mogelijk om de leercurve te verminderen.
Notitie
Web-API-bewerkingen zijn hoofdlettergevoelig.
Web-API-bewerkingen beschikbaar in Power Pages
- 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
Belangrijk
Ondersteuning voor de jokertekenwaarde (*) in de Webapi/<table-name>/fields site-instelling is afgeschaft.
Vervang door * een door komma's gescheiden lijst met de kolommen die door uw site zijn vereist. Power Pages web-API-aanvragen voor tabellen die met * fail zijn geconfigureerd, totdat u expliciete kolomnamen configureert.
Als u de web-API van portals voor uw portal wilt inschakelen, schakelt u de site-instelling in. U kunt ook de web-API op veldniveau configureren waarmee de tabelvelden worden bepaald die gebruikers wel of niet kunnen wijzigen met behulp van de web-API portals.
Notitie
Gebruik de logische tabelnaam voor deze instellingen (bijvoorbeeld account).
| Naam van site-instelling | Omschrijving |
|---|---|
| Webapi/<tabelnaam>/ingeschakeld | Schakelt de web-API in of uit voor <tabelnaam>. Standaard: False Geldige waarden: True, False |
| Webapi/<tabelnaam>/fields | Hiermee definieert u de door komma's gescheiden lijst met kenmerken die gebruikers kunnen wijzigen met behulp van de web-API. Mogelijke waarden: - Specifieke kenmerken: attr1,attr2,attr3 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 |
Als u bijvoorbeeld de web-API beschikbaar wilt maken voor de casetabel waarin geverifieerde gebruikers records voor deze entiteit kunnen maken, bijwerken en verwijderen, gebruikt u de site-instellingen die worden weergegeven in de volgende tabel.
| Naam van site-instelling | Waarde Site-instelling |
|---|---|
| Webapi/incident/enabled | waar |
| Webapi/incident/fields | attr1, attr2, attr3 |
Beveiliging met de web-API voor portals
U kunt beveiliging op basis van records configureren voor afzonderlijke records in portals met behulp van 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 verificatie en autorisatie worden beheerd door de toepassingssessie. Alle web-API-aanroepen moeten een CSRF-token (Cross-Site Request Forgery) bevatten.
EntitySetName gebruiken
Wanneer u verwijst naar Dataverse-tabellen met behulp van de web-API voor portals in uw code, gebruikt u de EntitySetName. Voor toegang tot de accounttabel gebruikt de codesyntaxis bijvoorbeeld de EntitySetName van accounts; /_api/accounts().
Notitie
Gebruik de tabel logische naam voor site-instellingen (bijvoorbeeld account).
Volg deze stappen om de EntitySetName van specifieke tabellen te bepalen:
Ga naar https://make.powerapps.com
Selecteer het tabblad Dataverse in het zijpaneel en selecteer de tabel.
Selecteer de optie ... (opdrachtopties) en kies vervolgens Geavanceerd, Extra en De naam van de set kopiëren om de EntitySetName van de tabel naar het klembord te kopiëren.
Privacywet- en regelgeving
Alle aanvraagheaders gebruiken een contact-id voor controledoeleinden. Voor een anonieme gebruiker is nullde waarde .
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 Portals 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-fout als ze een GET Web-API-aanvraag uitvoeren voor tabellen met meerdere niveaus van 1-op-veel- of veel-op-veeltabelmachtigingen wanneer de bereiken Parental, **Contact, of Account extra voorwaarden aan de query toevoegen.
Gebruik FetchXML in de OData-query om dit probleem op te lossen.
Volgende stap
Gegevens opvragen met de Portal-Web-API