Oharra
Baimena behar duzu orria atzitzeko. Direktorioetan saioa has dezakezu edo haiek alda ditzakezu.
Baimena behar duzu orria atzitzeko. Direktorioak alda ditzakezu.
API pertsonalizatu bat sortzerakoan, irtenbide bat erabili behar duzu. Irtenbideak ezagutzen ez badituzu, irakurri lehenik eta behin Sortu irtenbide bat.
Zure irtenbidea argitaletxe batekin lotuta egon behar da. Argitaletxeak pertsonalizazio-aurrizki zehatz bat du lotuta. Pertsonalizazio-aurrizkia erabili behar duzu API pertsonalizatua sortzerakoan, eta aurrizki honek zure irtenbidearen argitaratzaileak erabiltzen duen 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: Sortu API pertsonalizatua pluginen erregistro-tresna erabiliz
- API pertsonalizatua sortzearekin lotutako eremu asko ezin dira aldatu sortu ondoren. API pertsonalizatuaren diseinua arretaz planifikatu beharko zenuke hasi aurretik. Geroago API pertsonalizatua sortu ondoren gauzak aldatu behar dituzula erabakitzen baduzu, baliteke lehendik dagoen erregistroa ezabatu eta API pertsonalizatua berriro sortu beharko duzula. Berrikusi hemen aldatu ezin diren zutabeei buruzko informazioa: API pertsonalizatuen taulak
Sortu API erregistro pertsonalizatua
Zure irtenbidean, hautatu Berria>Beste>API>pertsonalizatua goitibeherako behealdean.
Editatu eremuak zure API pertsonalizatuaren propietateak ezartzeko. Ondorengo eremuetarako balioak ezarri behar dituzu. Informazio gehiago nahi izanez gero, ikus API taulako zutabe pertsonalizatuak
Ezin dituzu Plugin motaren balioak ezarri plug-ina sortu aurretik. Geroago alda dezakezu.
Hautatu Gorde. Zure inprimakiak honako itxura izan beharko luke:
Sortu eskaeraren parametroak
API pertsonalizatu batek ez du parametrorik behar. Sortu behar adina parametro zure logikarako behar dituzun datuak pasatzeko.
Zure iradobidean, hautatu goitibeherako goitibeherako APIeskaera pertsonalizatuaren parametro>berria>>.
Editatu eremuak API eskaera parametro pertsonalizatuaren propietateak ezartzeko. Informazio gehiago nahi izanez gero, ikus CustomAPIRequestParameter taulako zutabeak
Hautatu Gorde. Zure formularioak honako itxura izan beharko luke:
Sortu erantzunaren propietateak
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. APIak itzultzen dituen datu guztietarako erantzunaren propietateak definitu beharko zenituzke.
Entity edo EntityCollection erantzun propietate bakarra definitzen bada, erantzuna mota horretakoa da. Hainbat propietate edo mota sinple bateko propietate bat edo gehiago badaude, APIak mota konplexu bat itzultzen du, non erantzunaren propietate bakoitza mota konplexu horretako propietate bat den.
Adibidez, zure API pertsonalizatua izen bakarra bada, sample_CustomAPIExampledefinitzen duzun erantzun propietate bakoitzeko propietateekin izeneko sample_CustomAPIExampleResponse mota konplexu bat itzultzen du.
Zure iradobidean, hautatu goitibeherako goitibeherako APIpertsonalizatuaren erantzun propietateberria>.>>
Editatu eremuak APIaren erantzun propietate pertsonalizatuaren propietateak ezartzeko. Informazio gehiago nahi izanez gero, ikus CustomAPIResponseProperty taulako zutabeak
Hautatu Gorde. Zure formularioak honako itxura izan beharko luke:
Ikusi emaitza zerbitzu-dokumentuan
Zure API pertsonalizatuaren propietatea IsPrivate ezarri ez baduzu, orain zerbitzuaren definizioa CSDL $metadata dokumentutik berreskuratu dezakezu eskaera bat GET erabiliz, baita zure arakatzailetik ere. Zure ingurunearen URLa bada, https://yourorg.crm.dynamics.comURL hau idatzi dezakezu arakatzailearen helbidearen eremuan, $metadata eskuratzeko: https://yourorg.crm.dynamics.com/api/data/v9.1/$metadata.
Bilatu emaitza API pertsonalizatuaren izena aurkitzeko. Adibidez, aurreko urratsak erabiliz definitutako APIak honako hau du:
<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
Zure API pertsonalizatua sortu ondoren, probatu dezakezu. Eragiketa nagusia definitzeko plug-in mota ezarri ez baduzu ere, orain probatu dezakezu behar bezala deitu dezakezula egiaztatzeko. Erantzunaren propietate guztiek balio lehenetsia itzultzen dute, adibidez, null. Informazio gehiago: API pertsonalizatuak deitzea.
Eguneratu API pertsonalizatuaren plugin mota
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. Hau bilaketa-propietate bat da, beraz, Plugin-in mota aurkitu besterik ez duzu egin behar, muntaketa-mota erregistratzean sortutako mota adierazten duena.
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: Sortu API pertsonalizatua pluginen erregistro-tresna erabiliz
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: Sortu API pertsonalizatua kodearekin.
Zure ALM prozesua hobeto zerbitzatuko litzateke API pertsonalizatuak sortuz irtenbide fitxategiak editatuz. Informazio gehiago: Sortu API pertsonalizatua irtenbide 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