Oversikt over nett-API for portaler
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 forretningsforbindelse, oppdatere en kontakt, uten å bruke et skjema eller flertrinnsskjema ved hjelp av portalenes web-API.
Viktig
- Power Pages-nettstedsversjonen 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 å bruke nett-API-en for portaler til integrering med andre Power Pages-nettsteder.
- 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 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 som utføres av anonyme brukere, telles for eksempel med i forhold til den anonyme brukerkapasiteten. Web-API-kall som utføres av godkjente brukere (interne eller eksterne), telles ikke med i sidevisninger, men krever aktuelle godkjente brukerkapasitetslisenser. Mer informasjon: Vanlige spørsmål om lisensiering for Power Pages
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 beholdt API-formatet så likt som mulig, for å redusere læringskurven.
Merk
Det skiller mellom små og store bokstaver i operasjoner for web-API.
Nett-API-operasjoner som er tilgjengelige i Power Pages
- 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
Merk
Kall av handlinger og funksjoner ved hjelp av nett-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.
Merk
Bruk det logiske tabellnavnet for disse innstillingene (for eksempel forretningsforbindelse).
| 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 den kommadelte listen over attributter som kan endres med Web-API-en. Mulige verdier: - Alle attributter: * - Spesifikke attributter: attr1,attr2,attr3 Merk: Verdien må enten være en stjerne (*) eller en kommadelt liste over feltnavn. 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 |
| Webapi/<tabellnavn>/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. |
Merk
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 å ta med en godkjenningskode, fordi programøkten administrerer godkjenning og autorisasjon. 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 som bruker nett-API-en for portaler i koden, må du bruke EntitySetName, for eksempel for å få tilgang til kontotabellen, og kodesyntaksen bruker EntitySetName for kontoer; /_api/accounts().
Notat
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.
Personvernlover og -forskrifter
Alle forespørselshoder bruker en kontakt-ID som ble sendt for sporing av endringer. For en anonym bruker blir denne verdien 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-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, er den anbefalte løsningen å bruke FetchXML i OData-spørringen.
Du kan også angi områdeinnstillingen Webapi/<table name>/disableodatafilter til True.
Viktig
Hvis du endrer nettstedsinnstillingen Webapi/<tabellnavn>/disableodatafilter til True, kan dette føre til tregere ytelse for GET-kall i nett-API-en.
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