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 hurrengoa izan behar du eginbide horrek funtzionatzeko.
- 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 geroago gai honetan.
- Atarien Web-APIak zerbitzariaren aldeko cachea aprobetxatzen duenez, Web-APIrako egin beharreko deiak hasierako deiak baino azkarragoak dira. Kontuan izan atariaren zerbitzariaren alboko cachea garbitzeak aldi baterako errendimenduaren degradazioa eragiten duela.
- Atarien Web-APIaren eragiketak Power Pages lizentzia behar dute. Adibidez, erabiltzaile anonimoek egindako Web API deiak erabiltzaile anonimoaren gaitasunaren arabera zenbatzen dira. Egiaztatutako erabiltzaileek (barnekoak edo kanpokoak) egindako web API deiak ez dira orrialde ikustaldietarako zenbatzen, baina aplikagarriak diren autentifikatutako erabiltzaile gaitasunaren lizentziak behar dira. 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 antzekoen mantendu dugu ikasketa-kurba murrizteko.
Oharra
Web-APIaren eragiketak letra larriak eta xeheak bereizten ditu.
Web APIaren operazioak eskuragarri daude Power Pages
- Irakurri taula bateko erregistroak
- Sortu erregistro bat taula batean
- Taula bateko erregistroak eguneratu eta ezabatu
- Taulak elkartu eta desegin
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 Baliozko balioak: True, False |
| Webapi/<taularen izena>/eremuak | Web APIarekin alda daitezkeen atributuen komaz bereizitako zerrenda definitzen du. Balio posibleak: - Atributu guztiak: * - Atributu espezifikoak: attr1,attr2,attr3 Oharra: balioak izartxoa (*) edo komak bereizitako izen-eremuko zerrenda bat izan behar du. Garrantzitsua: Hau derrigorrezko gunearen ezarpena da. Ezarpen hau falta denean, "Entitate honetarako ez da eremurik definitu" errorea ikusiko duzu. |
| Webapi/error/innererror | Innererror gaitzen edo desgaitzen du. Lehenetsia: False Baliozko balioak: True, False |
| Webapi/<taularen izena>/disableodatafilter | OData iragazkia gaitu edo desgaitzen du. Lehenetsia: False Baliozko balioak: True, False Ikusi arazo ezagunak informazio gehiago lortzeko. 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/gertakaria/gaituta | egiazkoa |
| Webapi/gertakaria/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, autentifikazioa eta baimena aplikazioaren saioak kudeatzen dituelako. Web APIko dei guztietan Site-Cross Request Forgery (CSRF) token bat sartu behar da.
EntitySetName erabiltzea
Dataverse taulak zure kodean atarien Web-APIa erabiltzeari dagokionez, EntitySetName erabili behar duzu, adibidez, kontua taula atzitzeko, kodearen sintaxiak kontuak atalaren EntitySetName-a erabiliko du, hau da, /_api/accounts().
Oharra
Erabili taularen izen logikoa gunearen ezarpenetarako (adibidez, kontua).
Taula espezifikoen EntitySetName zehatz dezakezu urrats hauei jarraituz:
Joan https://make.powerapps.com aplikaziora
Hautatu Dataverse fitxa alboko paneletik eta hautatu taula.
Hautatu ... (Komandoen aukera) eta gero aukeratu Aurreratua, Tresnak eta Kopiatu multzoaren izena taularen EntitySetName arbelean kopiatzeko.
Pribatutasun-legeak eta araudiak
Eskaeren goiburu guztiek kontaktu-identifikazioa izango dute ikuskapen-helburuak betetzeko. Erabiltzaile anonimo batentzat honela pasatuko da null.
Auditoriaren erregistroa gaituta badago, erabiltzaile batek auditoriaren gertaera guztiak ikus ditzake Office 365 auditoriaren erregistroa.
Informazio gehiago:
Gaitu eta erabili jarduera-erregistroa
Esportatu, konfiguratu eta ikusi auditoriaren 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 jasoko dute GET Web API eskaera bat deitzen badute 1etik asko edo asko eta askotaularen baimenak noiz Gurasoen, harremanetarako edo Kontuaren esparruek baldintza gehigarriak gehitzen dizkiote kontsultari.
Arazo hau konpontzeko, gomendatutako soluzioak FetchXML erabiliko du OData kontsultan.
Bestela, ezarri gunearen ezarpena Webapi/<taularen izena>/disableodatafilterTrue.
Garrantzitsua da
Gunearen ezarpena Webapi/<taularen izena>/disableodatafilter hurrengora True motelagoa izan daiteke. 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