Atarien web APIaren informazio orokorra

Oharra

2022ko urriaren 12tik aurrera, Power Pages izango da Power Apps atarien izen berria. Informazio gehiago: Microsoft Power Pages erabilgarri dago modu orokorrean (bloga)
Laster migratuko eta konbinatuko dugu Power Apps atarien dokumentazioa Power Pages dokumentazioarekin.

Atarien Web-APIak erabiltzailearen esperientzia aberatsagoa ahalbidetzen du Power Apps atarien orrietan. Web-APIa erabil dezakezu Microsoft Dataverse taula guztietan eragiketa guztiak sortu, eguneratu eta ezabatzeko zure atariko orrietatik. Adibidez, kontu berria sor dezakezu, kontaktu bat eguneratu edo aldatu dezakezu taulako baimenak produktu bat atarien Web APIa erabiliz, Portal Management aplikazioaren ordez.

Oharra

Atarien Web-APIa Power Pages-en ere erabil dezakezu. Informazio gehiago: Zer da Power Pages

Garrantzitsua

• Atariaren bertsioak 9.3.3.x edo berriagoa izan behar du funtzio honek funtziona dezan.
• Web API atariak eraikitzen dira sortzeko aberatsa den erabiltzaile esperientzia atariko orrien barruan. Ez dago optimizatuta hirugarrenen zerbitzuetarako edo aplikazioen integraziorako. Atarien Web-APIa beste Power Apps atari-guneekin batzuekin integratzeko erabiltzea ere ez da onartzen.
• Atariak Web APIaren eragiketak datuekin lotutako tauletara mugatzen dira—adibidez, kontuak, kontaktuak edo zure taula pertsonalizatuak. Taularen metadatuak edo atariaren konfigurazio taulako datuak konfiguratzea—adibidez, adx_contentsnippet, adx_entityform edo adx_entitylist bezalako atarien taulak konfiguratzea—ez 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 Apps atarien lizentzia behar dute. Adibidez, erabiltzaile anonimoek egindako Web API deiak orrialdeak ikusteko gaitasunaren arabera zenbatzen dira. Egiaztatutako erabiltzaileek (barnekoak edo kanpokoak) egindako web API deiak ez dira orrialde ikustaldietarako zenbatzen, baina aplikagarriak diren lizentziak behar dira. Informazio gehiago: Power Apps atariak lizentziatzeko 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 atarietan eskuragarri daude

• Irakurri taula bateko erregistroak
• Sortu erregistro bat taula batean
• Taula bateko erregistroak eguneratu eta ezabatu
• Taulak elkartu eta desegin

Oharra

Ez dira onartzen atarien Web-APIaren bidez egindako dei-ekintzak eta -funtzioak.

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/<table name>/gaituta	Web APIa gaitzen edo desgaitzen du <table name>. Lehenetsia: False Baliozko balioak: True, False
Webapi/<table name>/eremuak	Web APIarekin alda daitezkeen atributuen komaz bereizitako zerrenda definitzen du. Balio posibleak: - Atributu guztiak: * - Atributu espezifikoak: attr1,attr2,attr3 Ohar: Balioak izartxo bat izan behar du (*) edo komaz bereizitako eremuen izenen zerrenda. 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/<table name>/disableodatafilter	OData iragazkia gaitu edo desgaitzen du. Lehenetsia: False Baliozko balioak: True, False Informazio gehiago lortzeko, ikusi arazo ezagunak. 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:

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.

   

Datuen Babeserako Araudi Orokorra (DBAO)

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 auditoretza-egunkarien 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 errorea jasoko dute a GET We-APIaren eskaera egiten badute 1 askori edo asko askori taularen baimen maila anitz dituzten taulen kasuetan, nagusia esparrua zehaztuta dutela.

Arazo hau konpontzeko, gomendatutako soluzioak FetchXML erabiliko du OData kontsultan.

Bestela, ezarri gunearen Webapi/<table name>/disableodatafilter ezarpena True aukeran.

Garrantzitsua

Gunearen Webapi/<table name>/disableodatafilter ezarpena True gisa aldatuz gero, GET deien Web-APIaren errendimendua motelagoa izan daiteke.

Gune-ezarpena atariko 9.4.10.74 edo geroagoko bertsioetan dago eskuragarri.

Hurrengo urratsa

Kontsultatu datuak atarien Web-APIa erabiliz

Ikusi ere

Sortu HTTP eskaerak eta kudeatu erroreak
Atariak Web-APIa erabiltzen du idatzi, eguneratu eta ezabatzeko eragiketak egiteko
Tutoriala: Erabili atarien Web-APIa

Oharra

Esan diezagukezu dokumentazioa zein hizkuntzatan jaso nahi duzun? Egin inkesta labur bat. (kontuan izan inkesta hau ingelesez dagoela)

Inkestak zazpi minutu inguru iraungo du. Ez da datu pertsonalik biltzen (pribatutasun-adierazpena).