Oversikt over nett-API for portaler
Obs!
Fra og med 12. oktober 2022 er Power Apps-portaler Power Pages. Mer informasjon: Microsoft Power Pages er nå tilgjengelig (blogg)
Vi overfører og slår snart sammen Power Apps-portaldokumentasjonen med Power Pages-dokumentasjonen.
Nett-API-en for portaler gir en omfattende brukeropplevelse på Power Apps-portalsidene. Du kan bruke nett-API-en til å utføre operasjoner for å opprette, lese, oppdatere og slette operasjoner på tvers av Microsoft Dataverse-tabeller fra portalsidene. Du kan for eksempel opprette en ny forretningsforbindelse, oppdatere en kontakt eller endre tabelltillatelsene for et produkt ved å bruke portalenes nett-API i stedet for Portalbehandling-appen.
Obs!
Du kan også bruke nett-API for portaler i Power Pages. Mer informasjon: Hva er Power Pages
Viktig
- Portalversjonen må være 9.3.3.x eller senere for at denne funksjonen skal fungere.
- Portal-Web-API-en er bygd for å opprette en rikere brukeropplevelse på portalsider. Den er ikke optimalisert for tredjepartstjenester eller programintegrering. Det er heller ikke støtte for bruk av web-API-en for Power Apps-portaler til å integrere med andre portalområder.
- Operasjoner for web-API for portaler er begrenset til tabeller som er relatert til data, for eksempel forretningsforbindelser, kontakter eller egendefinerte tabeller. Konfigurasjon av tabellmetadata eller portalkonfigurasjonstabelldata, for eksempel konfigurasjon av portaltabeller, for eksempel adx_contentsnippet, adx_entityform eller adx_entitylist, støttes ikke med web-API-en for portalene. Hvis du vil ha en fullstendig liste, kan du gå til konfigurasjonstabeller som ikke støttes senere i dette emnet.
- 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. Legg merke til at tømming av hurtigbufferen på portalserversiden vil midlertidig forårsake redusert ytelse.
- Web-API-operasjoner for portaler krever en Power Apps-portallisens. Web-API-kall som utføres av anonyme brukere, telles for eksempel med i forhold til sidevisningskapasitet. Web-API-kall som utføres av godkjente brukere (interne eller eksterne), telles ikke med i sidevisninger, men krever gjeldende lisenser. Mer informasjon: Vanlige spørsmål om Power Apps-lisensiering for portaler
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. Vi har behold API-formatet så likt som mulig, for å redusere læringskurven.
Obs!
Det skiller mellom små og store bokstaver i operasjoner for web-API.
Nett-API-operasjoner som er tilgjengelige i portaler
- Lese poster fra en tabell
- Opprette en oppføring i en tabell
- Oppdater og slett oppføringer i en tabell
- Tilknytt og fjern tilknytning av tabeller
Obs!
Kalle opp handlinger og funksjoner ved hjelp av web-API-en for portaler støttes ikke.
Nettstedsinnstillinger for Web-API-en
Du må aktivere nettstedsinnstillingen for å aktivere portal-Web-API-en. Du kan også konfigurere web-APIen på feltnivå som bestemmer tabellfeltene som kan eller ikke kan endres med web-API-et for portaler.
Obs!
Bruk det logiske tabellnavnet for disse innstillingene (for eksempel forretningsforbindelse).
Navn på nettstedinnstilling | Bekrivelse |
---|---|
Webapi/<table name>/enabled | Aktiverer eller deaktiverer Web-API-en for <table name>. Standard: False Gyldige verdier: True , False |
Webapi/<table name>/fields | Definerer den kommadelte listen over attributter som kan endres med Web-API-en. Mulige verdier: - Alle attributter: * - Spesifikke attributter: attr1,attr2,attr3 Obs! Verdien må enten være en stjerne (*) eller en kommadelt liste over feltnavn. Viktig! Dette er en obligatorisk nettstedsinnstilling. Når denne innstillingen mangler, vises feilmeldingen «Ingen felt er definert for denne enheten». |
Webapi/error/innererror | Aktiverer eller deaktiverer InnerError. Standard: False Gyldige verdier: True , False |
Webapi/<table name>/disableodatafilter | Aktiverer eller deaktiverer OData-filteret. Standard: False Gyldige verdier: True , False se Kjente problemer for mer informasjon. Områdeinnstillingen er tilgjengelig i portalversjonen av 9.4.10.74 eller senere. |
Obs!
Områdeinnstillinger må være satt til aktive for at endringer skal tre i kraft.
Hvis du for eksempel vil vise web-API-en for sakstabellen der godkjente brukere har tillatelse til å utføre operasjoner for oppretting, oppdatering og sletting for denne enheten, vises områdeinnstillingene i tabellen nedenfor.
Navn på nettstedsinnstilling | Nettstedinnstilling-verdi |
---|---|
Webapi/incident/enabled | sann |
Webapi/incident/fields | attr1, attr2, attr3 |
Sikkerhet med portal-Web-API-en
Du kan konfigurere oppføringsbasert sikkerhet for enkeltoppføringer i portaler ved å bruke 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 å inkludere en godkjenningskode fordi godkjenning og autorisasjon administreres av programøkten. Alle Web-API-kall må inneholde et forfalskning av forespørsler på tvers av nettsteder-token (CSRF).
Bruk av EntitySetName
Når du refererer til Dataverse-tabeller ved hjelp av web-API-en for portalene i koden, må du for eksempel bruke EntitySetName for å få tilgang til tabellen over forretningsforbindelser. Kodesyntaksen bruker EntitySetName for forretningsforbindelser; /_api/accounts()
.
Obs!
Bruk det logiske tabellnavnet for disse stedsinnstillingene (for eksempel forretningsforbindelse).
Du kan bestemme EntitySetName for bestemte tabeller ved å følge disse trinnene:
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 i tabellen til utklippstavlen.
EUs personvernforordning (GDPR)
Alle forespørselshoder har en kontakt-ID som sendes for revisjonsformål. For en anonym bruker blir dette sendt som null
.
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
-web-API-forespørsel for tabeller som har flere nivåer fra 1 til mange eller mange til mange tabelltillatelser med overordnet-området definert.
Hvis du vil løse dette problemet, er den anbefalte løsningen å bruke FetchXML i OData-spørringen.
Du kan også angi områdeinnstillingen Webapi/<table name>/disableodatafilter til True
.
Viktig
Endring av områdeinnstillingen Webapi/<table name>/disableodatafilter til True
kan føre til lavere ytelse for web-API GET
-kall.
Områdeinnstillingen er tilgjengelig i portalversjonen av 9.4.10.74 eller senere.
Neste trinn
Spørre etter data ved hjelp av web-API for portaler
Se også
Opprett HTTP-forespørsler og håndter feil
Portaler skriver, oppdatere og sletter operasjoner ved hjelp av Web-API
Opplæring: Bruke nett-API-en for portal
Obs!
Kan du fortelle oss om språkinnstillingene for dokumentasjonen? Ta en kort undersøkelse. (vær oppmerksom på at denne undersøkelsen er på engelsk)
Undersøkelsen tar rundt sju minutter. Det blir ikke samlet inn noen personopplysninger (personvernerklæring).