Merk
Tilgang til denne siden krever autorisasjon. Du kan prøve å logge på eller endre kataloger.
Tilgang til denne siden krever autorisasjon. Du kan prøve å endre kataloger.
Nett-API-en for portaler gir en omfattende brukeropplevelse på Power Pages-nettsteder. Du kan bruke nett-API-en til å utføre operasjoner for å opprette, lese, oppdatere og slette operasjoner på tvers av Microsoft Dataverse-tabeller fra nettstedssidene. Du kan for eksempel opprette en ny konto eller oppdatere en kontakt uten å bruke et skjema eller et skjema med flere trinn ved hjelp av nett-API-en for portaler.
Web-API-en bruker /_api ruten (for eksempel https://yoursite.powerappsportals.com/_api/accounts) og følger et RESTful-mønster som ligner på Dataverse Web API-en.
Viktig
- Portal-Web-API-en er bygd for å opprette en rikere brukeropplevelse på portalsider. Den er ikke optimalisert for tredjepartstjenester eller programintegrering. Bruk av nett-API-en for portaler til å integrere med andre Power Pages områder støttes ikke.
- Operasjoner for web-API for portaler er begrenset til tabeller som er relatert til data, for eksempel forretningsforbindelser, kontakter eller egendefinerte tabeller. Konfigurering av tabellmetadata eller portalkonfigurasjonstabelldata – for eksempel konfigurasjon av portaltabeller som adx_contentsnippet, adx_entityform eller adx_entitylist – støttes ikke ved hjelp av nett-API-en for portalene. Hvis du vil ha en fullstendig liste, kan du se konfigurasjonstabeller som ikke støttes senere i denne artikkelen.
- Web-APIen for portaler drar nytte av hurtigbufring på serversiden, slik at etterfølgende kall til web-APIen går raskere enn de første kallene. Tømming av hurtigbufferen på portalserversiden vil midlertidig forårsake redusert ytelse.
- Web-API-operasjoner for portaler krever en Power Pages-lisens. Web-API-kall utført av anonyme brukere teller for eksempel mot den anonyme brukerkapasiteten. Web-API-kall utført av godkjente brukere (interne eller eksterne) teller ikke mot sidevisninger, men krever gjeldende godkjente brukerkapasitetslisenser. Hvis du vil ha mer informasjon, kan du se Power Pages vanlige spørsmål om lisensiering.
- Kallhandlinger og funksjoner ved hjelp av nett-API-en for portaler støttes ikke.
Nett-API-operasjoner
Portal-Web-API-en har et delsett av funksjoner for Dataverse-operasjoner som du kan utføre ved hjelp av Dataverse-API-en. API-formatet er så likt som mulig for å redusere læringskurven.
Merk
Web API-operasjoner skiller mellom store og små bokstaver.
Nett-API-operasjoner som er tilgjengelige i Power Pages
- Les rader fra en tabell
- Opprette en oppføring i en tabell
- Oppdater og slett oppføringer i en tabell
- Tilknytt og fjern tilknytning av tabeller
Nettstedsinnstillinger for Web-API-en
Viktig
Støtte for jokertegnverdien (*) i Webapi/<table-name>/fields områdeinnstillingen er avskrevet.
Erstatt * med en kommadelt liste over kolonnene som kreves av nettstedet. Power Pages web-API-forespørsler for tabeller som er konfigurert med * mislykkes, til du konfigurerer eksplisitte kolonnenavn.
Hvis du vil aktivere nett-API-en for portalen for portalen, aktiverer du områdeinnstillingen. Du kan også konfigurere web-API-en på feltnivå som bestemmer tabellfeltene som brukere kan eller ikke kan endre ved hjelp av nett-API-en for portaler.
Merk
Bruk tabell logisk navn for disse innstillingene (for eksempel konto).
| Navn på nettstedinnstilling | Bekrivelse |
|---|---|
| Webapi/<tabellnavn>/enabled | Aktiverer eller deaktiverer Web-API-en for <tabellnavn>. Standard: False Gyldige verdier: True, False |
| Webapi/<tabellnavn>/fields | Definerer kommadelt liste over attributter som brukere kan endre ved hjelp av web-API-en. Mulige verdier: - Spesifikke attributter: attr1,attr2,attr3 Viktig: Denne innstillingen er en obligatorisk nettstedsinnstilling. Når denne innstillingen mangler, vises feilmeldingen «Ingen felter er definert for denne enheten». |
| Webapi/error/innererror | Aktiverer eller deaktiverer InnerError. Standard: False Gyldige verdier: True, False |
Hvis du for eksempel vil vise web-API-en for Sak-tabellen der godkjente brukere kan opprette, oppdatere og slette poster for denne enheten, bruker du nettstedsinnstillingene som vises i tabellen nedenfor.
| Navn på nettstedinnstilling | Verdi for nettstedsinnstilling |
|---|---|
| Webapi/incident/enabled | sann |
| Webapi/incident/fields | attr1, attr2, attr3 |
Sikkerhet med portal-Web-API-en
Du kan konfigurere postbasert sikkerhet for individuelle poster i portaler ved hjelp av tabelltillatelser. Web-API for portaler får tilgang til tabellposter (enhetsposter) og følger tabelltillatelsene som gis til brukere via den tilknyttede webrollen.
Du kan konfigurere kolonnetillatelser for ytterligere å definere rettigheter for enkeltkolonner i en tabell når du bruker web-API-en for portaler.
Nett-API-forespørsler for godkjenning av portaler
Du trenger ikke å ta med en godkjenningskode, fordi programøkten administrerer godkjenning og autorisasjon. Alle Web API-kall må inkludere et Cross-Site Request Forgery-token (CSRF).
Bruk av EntitySetName
Når du refererer til Dataverse-tabeller ved hjelp av nett-API-en for portaler i koden, bruker du EntitySetName. Hvis du vil ha tilgang til kontotabellen , bruker for eksempel kodesyntaksen EntitySetName for kontoer. /_api/accounts().
Merk
Bruk det logiske tabellnavnet for disse stedsinnstillingene (for eksempel forretningsforbindelse).
Følg disse trinnene for å fastslå EntitySetName for bestemte tabeller:
Gå til https://make.powerapps.com
Velg Dataverse-fanen fra sidepanelet, og velg tabellen.
Velg ... (Kommandoer-alternativet), og velg deretter Avansert, Verktøy og Kopier settnavn for å kopiere EntitySetName for tabellen til utklippstavlen.
Personvernlover og -forskrifter
Alle forespørselshoder bruker en kontakt-ID til overvåkingsformål. For en anonym bruker er nullverdien .
Hvis sporing av endringer er aktivert, kan en bruker se alle hendelser for sporing av endringer i Office 365-loggen for sporing av endringer.
Mer informasjon:
Aktivere og bruke aktivitetslogging
Eksportere, konfigurere og vise revisjonsloggoppføringer
Konfigurasjonstabeller som ikke støttes
Web-API-en for portaler kan ikke brukes for konfigurasjonstabellene nedenfor:
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
Kjente problemer
Brukere får en CDS-feil hvis de starter en GET-forespørsel for nett-API for tabeller med flere nivåer av 1 til mange eller mange til mangetabelltillatelser når omfangene Overordnet, **Kontakt eller Forretningsforbindelse legger til flere betingelser i spørringen.
Hvis du vil løse dette problemet, bruker du FetchXML i OData-spørringen.
Neste trinn
Spørre etter data ved hjelp av web-API for portaler