Sortu API pertsonalizatua Power Apps-en

Artikulu honek azaltzen du nola sortu API pertsonalizatu bat Power Apps for Microsoft Dataverse-n soluzio bat erabiliz. Jarraitu pauso hauek eskaera eta erantzun propietateak definitzeko, API pertsonalizatua probatu eta plug-in mota esleitzeko. Irtenbideekin ez bazaude ohituta, lehenik eta behin Sortu soluzio bat irakurri.

Zure irtenbidea argitaletxe batekin lotuta egon behar da. Argitaletxeak pertsonalizazio-aurrizki zehatz bat du lotuta. API pertsonalizatu bat sortzerakoan pertsonalizazio aurrizkia erabili behar duzu, eta aurrizki hori zure soluzioaren argitaletxeak erabiltzen duen aurrizki bera izan behar du. Ondorengo argibideek balioa sample erabiltzen dute pertsonalizazio-aurrizki gisa, argitaratzailearentzat ezarrita dagoelako.

Garrantzitsua da

  • Orain esperientzia hobea API pertsonalizatua sortzeko. Diseinatzaile bat erabil dezakezu Plug-in erregistratzeko tresnaren barruan. Informazio gehiago nahi izanez gero, ikusi plugin erregistro tresna erabiliz API pertsonalizatu bat sortu.
  • API pertsonalizatuak sortzearekin lotutako eremu asko ezin dituzu aldatu sortu ondoren. API pertsonalizatuaren diseinua arretaz planifikatu hasi aurretik. Geroago eremu hauek aldatu behar dituzula erabakitzen baduzu, agian dagoen erregistroa ezabatu eta API pertsonalizatua berriro sortu beharko duzu. Informazio gehiago nahi izanez gero, ikusi CustomAPI taulak.

Sortu API erregistro pertsonalizatua

  1. Zure irtenbidean, hautatu Berria>Beste>API>pertsonalizatua goitibeherako behealdean.

  2. Editatu eremuak zure API pertsonalizatuaren propietateak ezartzeko. Ezarri honako eremu hauetarako balioak. Informazio gehiago nahi izanez gero, ikusi API taulen zutabe pertsonalizatuak.

    Ezin dituzu Plugin motaren balioak ezarri plug-ina sortu aurretik. Balio hori geroago alda dezakezu.

  3. Hautatu Gorde. Zure inprimakiak honako irudiaren antzekoa izan beharko luke: Gordetako API pertsonalizatuaren pantaila-argazkia, bere propietate konfiguratuekin.

Sortu eskaera parametroak

API pertsonalizatu batek ez du parametrorik behar. Sortu behar adina parametro zure logikarako behar dituzun datuak pasatzeko.

  1. Zure iradobidean, hautatu goitibeherako goitibeherako APIeskaera pertsonalizatuaren parametro>>>.

  2. Editatu eremuak zure API eskaera parametro pertsonalizatuaren propietateak ezartzeko. Informazio gehiago nahi izanez gero, ikusi CustomAPIRequestParameter Table Columns.

  3. Hautatu Gorde. Zure itxura honako irudiaren antzekoa izan beharko litzateke:

    API eskaera parametro pertsonalizatu baten adibide baten pantaila-argazkia.

Erantzun propietateak sortu

Ekintza bat ordezkatzen duen API pertsonalizatu batek ez du erantzun propietaterik behar. Funtzio batek gutxienez bat izan behar du. Eragiketak arrakasta izanez gero, erantzun arrakastatsua itzultzen du. Huts egiten badu, errore bat itzultzen du. Erantzun propietateak definitu zure APIak itzultzen dituen datu guztientzat.

Entitate edo EntitateBilduma erantzun propietate bakarra definitzen baduzu, erantzuna mota horretako bat da. Propietate anitz definitzen badituzu, edo mota sinple bateko propietate bat edo gehiago, APIak konplexu mota bat itzultzen du, non erantzun propietate bakoitza mota konplexu horren propietatea den.

Adibidez, zure API pertsonalizatuaren izen bakarra bada sample_CustomAPIExample, erantzun propietate bakoitzerako propietateekin izendatutako mota sample_CustomAPIExampleResponse konplexu bat itzultzen du.

  1. Zure iradobidean, hautatu goitibeherako goitibeherako APIpertsonalizatuaren erantzun propietate>.>>

  2. Editatu eremuak zure API erantzun pertsonalizatuaren propietateak ezartzeko. Informazio gehiago nahi izanez gero, ikusi CustomAPIResponseProperty Table Columns.

  3. Hautatu Gorde. Zure itxura honako irudiaren antzekoa izan beharko litzateke:

    API pertsonalizatu baten erantzun propietate inprimaki baten pantaila-argazkia.

Ikusi emaitza zerbitzu-dokumentuan

Zure API pertsonalizatuaren propietatea ezartzen ez IsPrivate baduzu, CSDL $metadata dokumentutik zerbitzuaren definizioa eskaera bat GET erabiliz berreskuratu dezakezu, baita zure nabigatzailetik ere. Zure ingurunearen URLa bada https://yourorg.crm.dynamics.com, URL hau idatzi dezakezu zure nabigatzailearen helbide eremuan $metadata: https://yourorg.crm.dynamics.com/api/data/v9.1/$metadata.

Bilatu emaitza API pertsonalizatuaren izena aurkitzeko. Adibidez, aurreko urratsak erabiliz definitutako APIa honela:

<ComplexType Name="sample_CustomAPIExampleResponse">
    <Property Name="StringProperty" Type="Edm.String" Unicode="false" />
</ComplexType>
<Action Name="sample_CustomAPIExample">
    <Parameter Name="StringParameter" Type="Edm.String" Nullable="false" Unicode="false" />
    <ReturnType Type="mscrm.sample_CustomAPIExampleResponse" Nullable="false" />
</Action>

Probatu zure API pertsonalizatua

API pertsonalizatua sortu ondoren, saiatu zaitezke. Plug-in mota ezarri ez baduzu ere, orain probatu dezakezu ondo deitu dezakezun egiaztatzeko. Erantzunaren propietate guztiek balio lehenetsia itzultzen dute, adibidez, null. Informazio gehiago nahi izanez gero, ikusi API pertsonalizatuak deitzea.

Eguneratu API plugin mota pertsonalizatua

API pertsonalizatu baterako plug-in bat nola idatzi jakiteko, ikus API pertsonalizatuarentzat plug-in bat idatzi.

Muntaia erregistratu ondoren, sortu duzun API pertsonalizatuaren Plugin mota balioa ezarri behar duzu. Balio hau bilaketa propietatea da, beraz, bilaketa erregistratu zenuenean, sortutako mota adierazten duen Plug-in mota aurkitu behar duzu.

API plugin mota pertsonalizatua ezartzeko erabiltzen den bilaketaren pantaila-argazkia.

Plugin Mota ezarri ondoren, zure API pertsonalizatua probatu dezakezu emaitza zuzenak itzultzen direla egiaztatzeko.

API pertsonalizatuak sortzeko beste modu batzuk

Pluginak erregistratzeko tresnak API diseinatzaile pertsonalizatua eskaintzen du. Informazio gehiago nahi izanez gero, ikusi plugin erregistro tresna erabiliz API pertsonalizatu bat sortu.

Baliteke diseinatzailetik kanpo API pertsonalizatuak sortzea ahalbidetzen duen bezero-aplikazio bat sortzeko eskakizunak izatea. API pertsonalizatuen datuak tauletan gordetzen direnez, kodea erabiliz sor ditzakezu. Informazio gehiago nahi izanez gero, ikusi API pertsonalizatu bat kodearekin sortu.

Zure ALM prozesua hobeto zerbitzatuko litzateke API pertsonalizatuak sortuz irtenbide fitxategiak editatuz. Informazio gehiago nahi izanez gero, ikusi API pertsonalizatu bat soluzio fitxategiekin.

Ikus baita ere

Sortu eta erabili API pertsonalizatuak
Sortu API pertsonalizatua pluginen erregistro-tresna erabiliz
Sortu API pertsonalizatua kodearekin
Sortu API pertsonalizatua irtenbide-fitxategiekin
Sortu zeure mezuak