Partekatu honen bidez:

Atarien web APIaren informazio orokorra

Atarien Web-APIak erabiltzailearen esperientzia aberatsagoa ahalbidetzen du Power Pages guneetan. Web-APIa erabil dezakezu Microsoft Dataverse taula guztietan eragiketa guztiak sortu, eguneratu eta ezabatzeko zure web-orrietan. Adibidez, kontu berri bat sor dezakezu, kontaktu bat eguneratu, inprimakia edo urrats anitzeko inprimakia erabili gabe atariak Web APIa erabiliz.

Garrantzitsua da

  • Zure Power Pages gunearen bertsioak 9.3.3.x edo berriagoa izan behar du eginbide honek funtziona dezan.
  • Web API atariak eraikitzen dira sortzeko aberatsa den erabiltzaile esperientzia atariko orrien barruan. Ez dago optimizatuta hirugarrenen zerbitzuetarako edo aplikazioen integraziorako. Beste Power Pages guneekin integratzeko atariak Web APIa erabiltzea ere ez da onartzen.
  • Atariak Web APIaren eragiketak datuekin lotutako tauletara mugatzen diraadibidez, kontuak, kontaktuak edo zure taula pertsonalizatuak. Taularen metadatuak edo atariaren konfigurazio taulako datuak konfiguratzeaadibidez, adx_contentsnippet, adx_entityform edo adx_entitylist bezalako atarien taulak konfiguratzeaez da onartzen atarien Web APIarekin. Zerrenda osoa lortzeko, joan onartzen ez diren konfigurazio-tauletara artikulu honetan.
  • Atarien Web-APIak zerbitzariaren aldeko cachea aprobetxatzen duenez, Web-APIrako egin beharreko deiak hasierako deiak baino azkarragoak dira. Atariko zerbitzariaren cachea garbitzeak aldi baterako errendimendua hondatzea eragiten du.
  • Atarien Web-APIaren eragiketak Power Pages lizentzia behar dute. Adibidez, erabiltzaile anonimoek egindako Web API deiak erabiltzaile anonimoaren gaitasunaren arabera zenbatzen dira. Autentifikatutako erabiltzaileek (barnekoak edo kanpokoak) egindako web API deiak ez dira orri-ikustaldietarako zenbatzen, baina autentifikatu-gaitasun lizentzia aplikagarriak behar dituzte. Informazio gehiago: Power Pages lizentzien ohiko galderak

Web API eragiketak

Web atarien APIak gaitasunen azpimultzo bat eskaintzen du Dataverse fitxategia erabiliz egin ditzakezun eragiketak Dataverse APIa. API formatua ahalik eta antzekoena mantendu dugu ikasketa kurba murrizteko.

Oharra

Web-APIaren eragiketak letra larriak eta xeheak bereizten ditu.

Web APIaren operazioak eskuragarri daude Power Pages

Oharra

Ez da onartzen ekintzak eta funtzioak deitzea atarien Web APIa erabiliz.

Orriaren ezarpenak Web API-rako

Gunearen ezarpena gaitu behar duzu atariko Web APIak atarira gaitzeko. Eremu-mailako atarien Web-APIarekin alda daitezkeen edo ezin diren taula-eremuak zehazten dituen Web-APIa ere konfigura dezakezu.

Oharra

Erabili taularen izen logikoa ezarpen hauetarako (adibidez, kontua).

Web-ezarpenaren orria Deskribapenak
Webapi/<taularen izena>/gaituta Gaitu edo desgaitzen du Web API hurrengorako <taularen izena>.
Lehenetsia:False
Balio baliodunak:True, False
Webapi/<taularen izena>/eremuak Web APIarekin alda daitezkeen atributuen komaz bereizitako zerrenda definitzen du.
Balio posibleak:
- Atributu guztiak:*
- Atributu zehatzak:attr1,attr2,attr3
Oharra: balioak izartxo bat (*) edo komaz bereizitako eremu-izen zerrenda izan behar du.
Garrantzitsua: ezarpen hau derrigorrezko gunearen ezarpena da. Ezarpen hau falta denean, "Ez dago eremu honetarako definitu entitate honetarako" errorea ikusiko duzu.
Webapi/error/innererror Innererror gaitzen edo desgaitzen du.
Lehenetsia:False
Balio baliodunak:True, False
Webapi/<taularen izena>/disableodatafilter OData iragazkia gaitu edo desgaitzen du.
Lehenetsia:False
Balio baliodunak:True, False Ikusi arazo ezagunak informazio gehiagorako. Gune-ezarpena atariko 9.4.10.74 edo geroagoko bertsioetan dago eskuragarri.

Oharra

Gunearen ezarpenak ezarrita egon behar da Aktiboak aldaketak indarrean egon daitezen.

Adibidez, autentifikatutako erabiltzaileek entitate honetan sortu, eguneratu eta ezabatzeko eragiketak egiteko baimena duten Kasu taulako Web APIa erakusteko, gunearen ezarpenak hurrengo taulan agertzen dira.

Web-ezarpenaren orria Gunearen ezarpen balioa
Webapi/intzidentzia/gaituta egiazkoa
Webapi/intzidentzia/eremuak attr1, attr2, attr3

Segurtasuna atarien Web APIarekin

Erregistroan oinarritutako segurtasuna atarietako erregistro bakoitzerako konfigura dezakezu erabiliz taulako baimenak. Atarien Web-APIek taulen (entitatea) erregistroak atzitzen dituzte eta erabiltzaileei emandako taulen baimenei jarraitzen diete lotutako web-funtzioaren bidez.

Zutabeen baimenak konfigura ditzakezu taula baten banakako zutabeen pribilegioak atarien Web-APIa erabiltzen duzun bitartean gehiago zehazteko.

Atariaren autentifikazioa Web API eskaerak

Ez duzu autentifikazio-koderik sartu behar, aplikazioaren saioak autentifikazioa eta baimena kudeatzen dituelako. Web APIko dei guztietan Site-Cross Request Forgery (CSRF) token bat sartu behar da.

EntitySetName erabiltzea

Zure kodean atarietako Web APIa erabiliz Dataverse taulak aipatzen dituzunean, EntitySetName erabili behar duzu, adibidez, era sartzeko. kontua taulan, kodearen sintaxiak EntitySetName erabiltzen du kontuetatik; /_api/accounts().

Oharra

Erabili taularen izen logikoa gunearen ezarpenetarako (adibidez, kontua).

Taula espezifikoen EntitySetName zehatz dezakezu urrats hauei jarraituz:

  1. Joan https://make.powerapps.com aplikaziora

  2. Hautatu Dataverse fitxa alboko paneletik eta hautatu taula.

  3. Hautatu ... (Komandoen aukera) eta gero aukeratu Aurreratua, Tresnak eta Kopiatu multzoaren izena taularen EntitySetName arbelean kopiatzeko.

    Nola kokatu Dataverse taula baten EntitySetName-a.

Pribatutasun-legeak eta araudiak

Eskaera-goiburu guztiek ikuskapen-helburuetarako emandako kontaktuaren ID bat erabiltzen dute. Erabiltzaile anonimo batentzat, balio hau null gisa pasatzen da.

Auditoriaren erregistroa gaituta badago, erabiltzaile batek auditoriaren gertaera guztiak ikus ditzake Office 365 auditoriaren erregistroa.

Office 365 ikuskaritza erregistroaren pantaila-argazkia.

Informazio gehiago:
Gaitu eta erabili jardueren erregistroa
Esportatu, konfiguratu eta ikusi auditoria-erregistroen erregistroak

Onartu gabeko konfigurazio-taulak

Ezin da atarien Web-APIa erabili konfigurazio-taula hauen kasuan:

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

Ohiko konfigurazio-arazoak

Erabiltzaileek CDS errore bat jasotzen dute GET Web API eskaera bat deitzen badute 1 eta asko edo asko eta askotaularen baimenak noiz Gurasoen, **harremanetarako, edo Kontuaren esparruek baldintza gehiago gehitzen dizkiote kontsultari.

Arazo hau konpontzeko, gomendatutako irtenbidea OData kontsultan FetchXML erabiltzea da.

Bestela, ezarri gunearen ezarpena Webapi/<taularen izena>/disableodatafilterTrue.

Garrantzitsua da

Gunearen ezarpena Webapi/<taularen izena>/disableodatafilter ara True motelagoa izatea eragin dezake. Web API GET deien errendimendua.

Gune-ezarpena atariko 9.4.10.74 edo geroagoko bertsioetan dago eskuragarri.

Hurrengo urratsa

Kontsultatu datuak atarien Web APIa erabiliz