Bemærk
Adgang til denne side kræver godkendelse. Du kan prøve at logge på eller ændre mapper.
Adgang til denne side kræver godkendelse. Du kan prøve at ændre mapper.
Web-API-portaler gør det muligt at få en mere omfattende brugeroplevelse på Power Pages-steder. Du kan bruge web-API-portaler til at oprette, læse, opdatere og slette handlinger på tværs af alle Microsoft Dataverse-tabeller fra dine websider. Du kan f.eks. oprette en ny konto eller opdatere en kontakt uden at bruge en formular eller en formular med flere trin ved hjælp af portalens web-API.
Web-API'en bruger /_api ruten (f.eks. ) og følger et RESTful-mønster, https://yoursite.powerappsportals.com/_api/accountsder ligner Dataverse Web-API'en.
Vigtigt
- Web-API'en til portaler er bygget for at skabe en bedre brugeroplevelse på portalsider. Den er ikke optimeret til tredjepartstjenester eller programintegration. Brug af web-API'en til portaler til at integrere med andre Power Pages websteder understøttes ikke.
- 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 portalkonfigurationstabeldata – f.eks. konfiguration af portaltabeller, f.eks. adx_contentsnippet, adx_entityform eller adx_entitylist – understøttes ikke ved hjælp af portalernes web-API. Du kan se en komplet liste i konfigurationstabeller, der ikke understøttes senere i denne artikel.
- Portalerne web-API har fordel af cachelagring på serversiden, så efterfølgende kald til web-API'en er hurtigere end de første opkald. Rydning af portalserverens cache medfører midlertidig forringelse af ydeevnen.
- Web-API-portalhandlinger kræver en Power Pages-licens. Web-API-kald foretaget af anonyme brugere tæller f.eks. med i den anonyme brugerkapacitet. Web-API-kald foretaget af godkendte brugere (interne eller eksterne) tæller ikke med i sidevisninger, men kræver relevante godkendte licenser til brugerkapacitet. Du kan få flere oplysninger under Ofte stillede spørgsmål om Power Pages licenser.
- Kald af handlinger og funktioner ved hjælp af web-API'en til portaler understøttes ikke.
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. API-formatet er så ens som muligt for at reducere læringskurven.
Bemærk
Web API-operationer skelner mellem store og små bogstaver.
Web-API-handlinger, der er tilgængelige i Power Pages
- Læs poster fra en tabel
- Opret en post i en tabel
- Opdatere og slette poster i en tabel
- Tilknytte og fjerne tilknytning af tabeller
Indstillinger for websted for web-API
Vigtigt
Understøttelse af jokertegnværdien (*) i webstedsindstillingen Webapi/<table-name>/fields frarådes.
Erstat * med en kommasepareret liste over de kolonner, der kræves af webstedet. Power Pages web-API-anmodninger for tabeller, der er konfigureret med * fejl, indtil du konfigurerer eksplicitte kolonnenavne.
Hvis du vil aktivere portalens web-API for din portal, skal du aktivere indstillingen for webstedet. Du kan også konfigurere web-API'en på feltniveau, der bestemmer de tabelfelter, som brugerne kan eller ikke kan ændre ved hjælp af web-API'en til portaler.
Bemærk
Brug det logiske tabelnavn til disse indstillinger (f.eks . konto).
| Navn på indstilling for websted | Description |
|---|---|
| Webapi/<tabelnavn>/aktiveret | Aktiverer eller deaktiverer web-API til <tabelnavn>. Standard: False Gyldige værdier: True, False |
| Webapi/<tabelnavn>/felter | Definerer den kommaseparerede liste over attributter, som brugerne kan ændre ved hjælp af web-API'en. Mulige værdier: - 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 indstilling for webstedet. 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 |
| Webapi/<tabelnavn>/disableodatafilter | Aktiverer eller deaktiverer OData-filter. Standard: False Gyldige værdier: True, False Se kendte problemer for at finde flere oplysninger. Indstillingen for websted er tilgængelig i portalversion 9.4.10.74 eller nyere. |
Hvis du f.eks. vil vise web-API'en for tabellen Sag, hvor godkendte brugere kan oprette, opdatere og slette poster for dette objekt, skal du bruge de webstedsindstillinger, der vises i følgende tabel.
| Navn på indstilling for websted | Værdi for webstedsindstilling |
|---|---|
| Webapi/incident/enabled | true |
| 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.
Du kan konfigurere kolonnetilladelser for yderligere at definere rettigheder til individuelle kolonner i en tabel, mens du bruger portalweb-API'en.
Godkendelse af portalers Web-API-forespørgsler
Du behøver ikke at inkludere en godkendelseskode, da godkendelse og autorisation administreres af programsessionen. Alle Web-API-kald skal inkludere et CSRF-token (forfalskning af anmodning på tværs af websteder).
Brug af EntitySetName
Når du refererer til Dataverse-tabeller ved hjælp af portalens web-API i din kode, skal du bruge EntitySetName. Hvis du f.eks. vil have adgang til kontotabellen , bruger kodesyntaksen EntitySetName for konti. /_api/accounts().
Bemærk
Brug tabellens logiske navn for websteds-indstillinger (f.eks. firma).
Følg disse trin for at bestemme EntitySetName for bestemte tabeller:
Gå til https://make.powerapps.com
Vælg fanen Dataverse i sidepanelet, og vælg tabellen.
Vælg indstillingen ... (Kommandoer), og vælg derefter Avanceret, Værktøjer og Kopiér sætnavn for at kopiere tabellen EntitySetName til Udklipsholder.
Lovgivning og regler om beskyttelse af personlige oplysninger
Alle anmodningsheadere bruger et kontakt-id til overvågningsformål. For en anonym bruger er nullværdien .
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
Kendte problemer
Brugere får en CDS-fejl, hvis de aktiverer en GET Web API-anmodning for tabeller, der har flere niveauer på 1 til mange eller mange til mangetabeltilladelser, når Parental, ** Contact eller Account føjer flere betingelser til forespørgslen.
Du kan løse problemet ved at bruge FetchXML i OData-forespørgslen.
Du kan også angive webstedsindstillingen Webapi/<tabelnavn>/disableodatafilter til True.
Vigtigt
Hvis du ændrer webstedsindstillingen Webapi/<tabelnavn>/disableodatafilter til True, kan det medføre langsommere ydeevne for Web API-kald GET.
Indstillingen for websted er tilgængelig i portalversion 9.4.10.74 eller nyere.
Næste trin
Forespørgsel efter data ved hjælp af portaler Web API