Partekatu honen bidez:

Arakatu eta probatu Dataverse Web API jolastokian (aurrebista)

[Gai hau aurre-argitaratutako dokumentazioa da eta aldaketak jasan ditzake.]

API playground-a aldez aurretik autentifikatutako software-probak egiteko tresna bat da, sortzaileei Microsoft Dataverse Web APIarekin azkar eta eroso elkarreragiten laguntzen diena.

API jolastokiaren hasierako pantaila

Web-aplikazio honek garatzaileei API amaierako puntu ezberdinekin probatu eta esperimentatzeko aukera ematen die, konfigurazio- edo autentifikazio-prozesu handirik behar izan gabe. Era berean, erabilgarri dauden zenbait ekintza eta dokumentaziorako estekak modu egokian aurkezten ditu azkarrago ikasteko.

Erabili tresna hau RESTful APIan posible dena arakatzeko, erabiltzaileek definitutako lan-fluxuak probatzeko eta abar.

Garrantzitsua da

  • Hau aurreikuspen-eginbidea da.
  • Aurrebista-eginbideak ez daude ekoizpenerako diseinatuta, eta funtzionalitate murriztua izan dezakete. Eginbide horiek kaleratze ofiziala baino lehen dauden erabilgarri, bezeroek atzitu eta beren oharrak eman ditzaten.

Eginbide nagusiak

  • Aurretik autentifikatuta: API jolastokia aurrez autentifikatuta dator, beraz, garatzaileak berehala has daitezke API amaierako puntuekin probatzen eta esperimentatzen.
  • Webean oinarrituta: API jolastokiarekin, garatzaileek azkar elkarreragin dezakete Dataverse Web APIarekin konfigurazio zabalik beharrik gabe, hala nola software deskargak edo Microsoft-eko kontuak ez diren konfiguratu beharrik gabe. Tresnara Dataverse azeleragailutik sar zaitezke, Microsoft aplikazioa Dataverse inguru berri guztietan eskuragarri eta edozein ingurunetan instalatu daiteke.
  • Erosoa: Dataverse Web APIan erabilgarri dauden ekintza eta gaitasun desberdinak aurkezten ditu, eta erraz ikasteko zer den eta nola inplementatu erraz.

Aurrebaldintzak

sarbidea izan behar duzu Dataverse, eta sarbidea Dataverse azeleragailu aplikazioa erreproduzitzeko. Sistema pertsonalizatzaileen segurtasun-eginkizuneko kideek sarbidea dute aplikazioa erreproduzitzeko.

Lehenengo urratsak

API jolastokiarekin hasteko, erreproduzitu Dataverse azeleragailua eta, ondoren, hautatu API jolastokia orria.

Exekutatu API jolastokia eginbide-txartela hautatuta

Egin eskaerak Dataverse Web APIra

Lurreratze-pantailan, aukeratu eskaera-mota eskaera-editorea irekitzeko Sortu goiko txarteletako edozeinetan hautatuta.

Hiru eskaera mota aurkezten dira:

Idatzi Deskribapenak
API pertsonalizatua Honen barruan sartzen dira edozein Dataverse Web API ekintza, funtzio Microsoft-en edo erabiltzaileak definitutako edozein API pertsonalizatu lan-ingurunean erregistratuta dauden .
Istanteko plugina Instant plug-in-ak erabiltzaileak definitutako edozein lan-fluxu gisa sailkatzen dira ingurunean API pertsonalizatu gisa erregistratuta erlazionatutako FxExpression batekin.
OData eskaera Eskaeraren sarreren gaineko kontrol zehatzagoa ahalbidetzen du OData eskaerak bidaltzeko.

Eskatu API pertsonalizatua edo berehalako plug-in bat

Eskaera mota hauek lan-ingurunean eskuragarri dauden dei-pluginak errazteko diseinatuta daude.

  1. Hautatu aukera bat goitibeherako zerrenda nagusitik, uneko ingurunean eskuragarri dauden pluginak aurkezten dituena. API pertsonalizatuak goitibeherako zerrendan ageri dira

  2. Parametroak erabilgarri badaude, agertzen den Kontsulta-parametroak taulan bistaratuko dira. Eman behar diren parametroen balioak. API pertsonalizatuen parametroak automatikoki bistaratzen dira

    Oharra

    Parametro bakoitzaren ezkerrean dauden kontrol-laukiek eskaeran sartuta dauden adierazten dute. Beharrezko parametroek kontrol-laukiak desgaitu dituzte, eta aukerako parametroek editagarriak dituzte.

  3. Hautatu Bidali.

  4. Begiratu erantzuna pantailaren beheko atalean. Parametroak zerrendatuta daude erregistratuta egonez gero

Oharra

Interfazeak ingurunean eskuragarri dauden plug-in guztien zerrenda erosoa eskaintzen du. Hautatzen denean, datu motekin lotutako parametroak aurkezten dira. Atzean OData dei bat egiten ari da oraindik, baina interfazeak deiaren eraikuntza errazten du.

Egin OData eskaera

OData eskaerek aukera gehiago ematen dituzte eskaera-parametroetarako.

  1. Hautatu HTTP eskaera-metodoa goitibeherako lehen zerrendan.

  2. Idatzi amaiera-puntuaren Url. Sartu eskaeraren URLa ondoren bakarrik [OrgUrl]/api/data/v9.2/

  3. Gehitu kontsulta-parametroak bi metodo hauetako bat erabiliz:

    1. URLan.

      1. URLan galdera ikurraren (?) karakterearen ondoren, idatzi kontsulta-parametroaren gakoa. Gakoa URLan idatzi da galdera-ikurren ondoren

      2. Idatzi berdin (=) karaktere bat teklaren ondoren.

      3. Idatzi balioa. Url-ean idatzitako balioa berdin ikurraren ondoren

      Gakoek eta balioek parametroen taula automatikoki beteko dute interfazean.

    2. Gehitu eskuz kontsulta-parametroak + Gehitu parametroa hautatuta. Honek parametro-errenkada huts bat gehitzen dio taulari, balioak idatz ditzakezun. URLa dinamikoki eguneratzen da balioak sartzen diren heinean.

  4. Aukeran, eman gorputz bat (GET izan ezik eskaera-metodo guztiak erabiltzen badituzu) Gorputza fitxa hautatuz, eta idatzi gorputzaren balioa editorearen kontrolean.

  5. Hautatu Bidali.

  6. Begiratu erantzuna beheko atalean.

Ikusi erantzuna

Eskaera bidali ondoren, erantzuna pantailaren beheko erdian bistaratzen da.

OData erantzuna

Erantzunaren egoerak eskaeraren neurri azkarrak eskaintzen ditu:

  • Egoera-mezua
  • Iraupena (milisegundotan)
  • Tamaina (kilobytetan)

Erantzunaren gorputza erantzunaren egoeraren azpian bistaratzen da. Hautatu kopia ikonoa erantzunaren gorputza arbelean kopiatzeko.

-i buruz maiz egiten diren galderak

Zein pribilegio behar dira API jolastokiko tresnara sartzeko?

Tresna erabiltzeko Dataverse azeleragailuaren aplikaziorako sarbidea izan behar duzu.

API jolastokiko tresna Dataverse Web APIra soilik konektatzen al da?

Bai, API jolastokiko tresna Dataverse Web APIra soilik konektatzen da. Interfaze honetan ez dago beste zerbitzurik konektatzeko erabilgarri.

Nola autentifikatzen da API jolastokia tresna Dataverse Web APIan?

Tresnak Dataverse azeleragailuaren aplikaziora erreproduzitzeko beharrezkoa den saioa hasitako erabiltzailearen autentifikazio-tokena erabiltzen du.

API jolastokiaren funtzioa ingurune guztietan eskuragarri al dago?

Eginbidea Dataverse azeleragailuaren bidez ematen da eta aplikazioa instalatuta duten ingurune guztietan dago eskuragarri. Aplikazioa automatikoki instalatzen da ingurune berri guztietan, baina ingurune zaharretan ere instala daiteke instalatzeko argibideak jarraituz.

Ikusi ere

Lortu aurrebista-eginbideak goiz Dataverse azeleragailuarekin (aurrebista)