Oversigt over Web-API til portaler
Web-API'en til portaler gør det muligt at skabe en bedre brugeroplevelse på siderne på Power Apps-portaler. Du kan bruge web-API'en til at oprette, læse, opdatere og slette handlinger på tværs af alle Microsoft Dataverse-tabeller fra dine portalsider. Du kan for eksempel oprette et nyt firma, opdatere en kontakt eller ændre tabeltilladelserne for et produkt ved hjælp af portalweb-API'en i stedet for appen Portaladministration.
Vigtigt
- Din portalversion skal være 9.3.3.x eller nyere, for at denne funktion kan fungere.
- Web-API'en til portaler er bygget for at skabe en bedre brugeroplevelse på portalsider. Den er ikke optimeret til tredjepartstjenester eller programintegration.
- Web-API-handlinger på portaler er begrænset til tabeller, der er relateret til data – for eksempel konti, kontakter eller dine brugerdefinerede tabeller. Konfiguration af tabelmetadata eller data om portalkonfigurationstabeller – for eksempel konfiguration af portaltabeller som adx_contentsnippet, adx_entityform eller adx_entitylist – understøttes ikke med web-API'en til portaler. Hvis du vil have en komplet liste, skal du gå til ikke-understøttede konfigurationstabeller senere i dette emne.
- Portalerne web-API har fordel af cachelagring på serversiden, så efterfølgende kald til web-API'en er hurtigere end de første opkald. Bemærk, at rydning af portalserverens cache medfører midlertidig forringelse af ydeevnen.
- Portalhandlinger til web-API'er kræver en Power Apps portallicens. Web-API-kald, der er foretaget af anonyme brugere, tælles f.eks. med i sidevisningskapaciteten. Web-API-kald, der er foretaget af godkendte brugere (interne eller eksterne), tælles ikke med i sidevisninger, men kræver relevante licenser. Flere oplysninger: Ofte stillede spørgsmål om licenser til Power Apps-portaler
Web-API-handlinger
Web-API'en til portaler tilbyder et undersæt af funktioner til Dataverse-handlinger, som du kan udføre ved hjælp af Dataverse-API'en. Vi har gjort API-formatet så ens som muligt for at reducere indlæringskurven.
Web-API-handlinger, der er tilgængelige i portaler
- Læse poster fra en tabel
- Oprette en post i en tabel
- Opdatere og slette poster i en tabel
- Tilknytte og fjerne tilknytning af tabeller
Indstillinger for websted for web-API
Du skal aktivere webstedsindstillingen for at aktivere web-API'en til din portal. Du kan også konfigurere den web-API på feltniveau, der bestemmer de tabelfelter, der kan eller ikke kan ændres med portalweb-API'en.
| Navn på indstilling for websted | Beskrivelse |
|---|---|
| Webapi/<table name>/enabled | Aktiverer eller deaktiverer web-API'en til <table name>. Standard: False Gyldige værdier: True, False |
| Webapi/<table name>/fields | Definerer den kommaseparerede liste over attributter, der kan redigeres med web-API'en. Mulige værdier: - Alle attributter: * - Specifikke attributter: attr1,attr2,attr3 Bemærk: Værdien skal enten være en stjerne (*_) eller en kommasepareret liste over feltnavne. _ Vigtigt: Dette er en obligatorisk webstedsindstilling. Når denne indstilling mangler, vises fejlmeddelelsen "Der er ikke defineret felter for dette objekt". |
| Webapi/error/innererror | Aktiverer eller deaktiverer InnerError. Standard: False Gyldige værdier: True, False |
Bemærk
Indstillinger for websted skal angives til Aktiv, for at ændringerne kan træde i kraft.
Hvis du for eksempel vil have vist web-API'en for sagstabellen, hvor godkendte brugere har tilladelse til at udføre oprettelses-, opdaterings- og slettehandlinger for dette objekt, vises indstillingerne for webstedet i følgende tabel.
| Navn på indstilling for websted | Værdi af indstilling for websted |
|---|---|
| Webapi/incident/enabled | sand |
| Webapi/incident/fields | attr1,attr2,attr3 |
Sikkerhed med web-API'en til portaler
Du kan konfigurere postbaseret sikkerhed for individuelle poster på portaler ved hjælp af tabeltilladelser. Portalerne Web API giver adgang til tabelposter (objekt) og følger de tabeltilladelser, der gives til brugere via de tilknyttede webroller.
Godkendelse af portalers Web-API-forespørgsler
Du behøver ikke at inkludere en godkendelseskode, da godkendelse og godkendelse administreres af programsessionen. Alle web-API-kald skal inkludere et CSRF-token (forfalskning af anmodning på tværs af websteder).
Overholde den generelle databeskyttelsesforordning (GDPR)
Alle anmodnings-overskrifter har kontakt-id, der er overført til overvågningsformål. Hvis det gælder for en anonym bruger, overføres dette som null.
Hvis overvågningsloggen er aktiveret, kan en bruger se alle overvågningshændelserne i Office 365-overvågningsloggen.
Flere oplysninger:
Aktivere og bruge logføring af aktiviteter
Eksportere, konfigurere og vise poster i overvågningsloggen
Ikke-understøttede konfigurationstabeller
Web-API'en til portaler kan ikke bruges til følgende konfigurationstabeller:
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
Næste trin
Forespørgsel efter data ved hjælp af portaler Web API
Se også
Sammensætte HTTP-anmodninger, og håndtere fejl Portalhandlingerne skrive, opdatere og slette bruger web-API Selvstudium: Bruge Web API-portal