Partekatu bidez

Erabili kode baxuko pluginak Dataverse (aurrebista)

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

Microsoft Dataverse irtenbide indartsua eskaintzen du datu-arkitektura eraginkorragoa lortzeko eta bezeroen lan-karga murrizteko kode baxuko pluginen bidez. Plugin hauek denbora errealeko lan-fluxu berrerabilgarriak dira, Dataverse barruan komando multzo zehatz bat exekutatzen dutenak, zerbitzariaren aldetik exekutatzen direnak eta gertaeren kudeatzaile pertsonalizatuek abiarazita.

Garrantzitsua da

  • Kode baxuko berehalako plugin-ak lehenesten dira eta ez dira funtzio gisa ematen. Kode baxuko berehalako pluginak funtzioekin ordezkatzen dira. Informazio gehiago: Funtzioak Microsoft Dataverse (aurrebista)
  • 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.

Tradizionalki, pluginak .NET Framework asanblada batean konpilatutako klase pertsonalizatu gisa sortzen ziren, ondoren kargatu eta erregistratu egiten ziren Dataverse. Dena den, kode baxuko pluginak sartuta, erabiltzaileek gertaeren kudeatzaile hauek sor ditzakete kodeketa gutxieneko edo beharrik gabe, eta eskuz erregistratu beharrik gabe.

Kode baxuko plugin-ak Dataverse datu-base batean gordetzen dira eta Power Apps eta Power Automaten ezin hobeto integra daitezke. Lan-fluxuaren portaera Power Fx espresio-lengoaia erabiliz definitzen da eta Dataverse enpresako datuekin eta kanpoko datu-iturriekin zuzenean konektatu daiteke Power Platform konektoreen bidez. Kode baxuko plug-inekin, egileek lan-fluxu konplexuak azkar eraiki ditzakete kodeketa gutxieneko esperientziarekin, eta, ondorioz, datu-arkitektura errazagoa eta eraginkorragoa izango da.

Zerbitzariaren aldeko logikaren abantailak

Zerbitzariaren negozio-logika definitzeak hainbat abantaila eskaintzen ditu, besteak beste:

  • Segurtasuna areagotu. Zerbitzariaren logika zerbitzarian exekutatzen denez, datu edo prozesu sentikorretarako baimenik gabeko sarbidea saihesten lagun dezake.
  • Errendimendu hobetua. Zerbitzarian exekutatuta, negozio-logikak bezeroaren eta zerbitzariaren artean transferitu behar diren datu-kopurua murriztu dezake, prozesatzeko denbora azkarragoak eraginez.
  • Koherentzia eta fidagarritasuna. Zerbitzariaren logikak bezero guztietan negozio-arauak etengabe aplikatzen direla bermatzen du, akatsak edo inkoherentziak izateko arriskua murriztuz.
  • Mantentze eta berritze errazagoak. Negozio-logika zerbitzarian zentralizatuz, errazagoa da mantentzea eta eguneratzea, aldaketak leku bakarrean egin daitezkeelako bezero anitz eguneratu behar izan beharrean.
  • Eskalagarritasuna. Zerbitzariaren logika bezeroaren logika baino errazago eskala daiteke, errendimendu hobea eta lan-karga handiagoak kudeatzeko aukera emanez.

Kode baxuko pluginak

Bi kode baxuko plug-in mota onartzen dira Dataversen:

Idatzi Abiarazlea Parametroak onartzen ditu Onartutako esparrua
Istantekoa Eskuz exekutatu Yes Globala eta mahaia
Automatizatuta Dataverse mahaiko ekitaldia No Table

Kode baxuko plug-in guztiek propietate komun hauek dituzte:

Propietatea Deskribapenak
Bistaratzeko izena Pluginaren gizakiek irakur daitekeen izena. Ezin da aldatu sortu ondoren.
Eman izena Pluginaren barne-izena. Plataformak erabiltzen du kodea eta datu-baseen eragiketetan osagaia identifikatzeko. Ezin da aldatu sortu ondoren.
Deskribapenak Pluginaren inguruko testuinguru gehigarria emateko erabiltzen da (helburua, portaera edo beste xehetasun garrantzitsu batzuk).
Soluzioa Osagaiak taldekatzeko eta beste ingurune batzuetara esportatzeko erabiltzen da. Lortu informazio gehiago irtenbideeiri buruz.
Expression Hau da ekintza edo kalkuluak egiteko erabil daitekeen funtzio pertsonalizatua, Power Fx espresio-lengoaia erabiliz definitua. Power Fx mihise-aplikazioetan erabiltzen den formula-lengoaia da, eta kode baxuko plug-inetan erabiltzeko hedatu da. Ikus Power Apps onartutako funtzioak xehetasun gehiago lortzeko .

Kode baxuko berehalako plugina erabiltzaile batek eskuz abiarazten duen kode pertsonalizatuaren logika da. Sarrera eta irteerako parametro pertsonalizatuak erabil daitezke.

Propietate bereziak:

Propietatea Deskribapenak
Scope Plugin bat taula zehatz bati lotzeko erabiltzen da. Taula (entitate gisa erakusten) edo globala izan daiteke, non taula (entitate) esparruak plug-in-a taula-erregistro zehatz baten testuinguruarekin abiarazten duela esan nahi du, eta esparru orokorrak esan nahi du eragiketa ez dagoela taula batekin erlazionatuta (lortu informazio gehiago).
Parametroak Parametroek plug-inaren eta hura exekutatzen duen testuinguruaren artean informazioa pasatzeko aukera ematen dute, egoera ezberdinetan berrerabili daitekeen negozio-logika diseinatzea erraztuz.

Sarrera-parametroak plugin-ari datuak emateko erabiltzen dira, eta funtzioak nola jokatzen duen kontrolatzeko aukera ematen dizu Power Fx formulan zehazten dituzun balio desberdinak emanez.

Irteerako parametroek funtzio edo metodo baten emaitzak berreskura ditzakezu zure programan gehiago erabiltzeko.

Onartutako datu motak:
  • Boolear
  • String
  • Float
  • Hamartarrak
  • DateTime
  • Integer

Mihise-aplikazio batetik edo Power Automate hodeiko fluxu batean integratzeari buruzko informazio gehiago: Integratu kode baxuko plug-in bat

Plugin-baimenak

Diseinu denbora

Power Platform ingurunean sistema pertsonalizatzailea edo sistema administratzailea segurtasun rola duten arduradunek ingurune horretako plug-in guztiak atzi ditzakete. Segurtasun-rol pertsonalizatuak erabil daitezke kode baxuko pluginetarako sarbidea mugatzeko.

Exekutatu denbora

Plugin bat deitzen denean, plug-inaren definizioan parte hartzen duten taulako datuetara sartzen da (formularen parte diren taulak edo taula plug-in automatizatu baten ezarpenekin lotuta badago) hura deitu duen erabiltzailearen testuinguruan.

Konexioak

Segurtasun-funtzioak erabiliz, zure erakundeko erabiltzaile-multzo jakin batera mugatu daiteke plugin-en konektoreen sarbidea. Zehaztu zein rol dituzten sortu, irakurri, eguneratu edo ezabatzeko pribilegioak.

Kode baxuko plug-in bat sortzeko aurrebaldintzak

  • Sistema-administratzaile edo sistema pertsonalizatzaileen segurtasun-rolaren kidetasuna Power Platform ingurunean.
  • Dataverse azeleragailuaren aplikaziorako sarbidea.

Eskupekoa

Ingurune berri guztiek Dataverse azeleragailua aplikazioa dute automatikoki instalatuta 2023ko urriaren 1etik aurrera. Dagoeneko Dataverse azeleragailua instalatuta bazenuen, eskuz egunera dezakezu Dataverse azeleragailua.

Eguneratu Dataverse azeleragailua

  1. Jarraitu argibideei lizentziadun aplikazioak zure ingurunean ikusteko.
  2. Dataverse Azeleragailua dagoeneko instalatuta badago eta eguneratze bat eskuragarri badago, elementuaren ondoko taulan adierazten da.
  3. Hautatu Dataverse Azeleragailua eta, ondoren, hautatu Eguneratu komando-barran.

Eskupekoa

Gaitu aplikazioen eguneratze automatikoakMicrosoft - Power CAT argitaratzaileari eguneraketak automatikoki jaso ditzan eskuragarri dagoenean (ez da beharrezkoa 2023ko urriaren 1etik aurrera sortutako ingurune berrietarako).

Oharra

Aurrez instalatu bazenuen aukerako Low-Code Plug-ins for Connectors soluzioa, automatikoki ezabatuko da 2023ko ekainaren 29tik aurrera eguneratzen duzunean. Gaitasunak soluzio nagusian eskuragarri egongo dira.

Sortu berehalako kode baxuko plug-in bat

  1. Erreproduzitu Dataverse azeleragailua aplikaziora.
  2. Hautatu Sortu berehalako plugina txartela. Sortu berehalako plug-in txartela
  3. Eman a Bistaratzeko izena.
  4. Aukeran, definitu parametroak:
    • Hautatu Sarrera-parametro berria edo Irteera-parametro berria, eta idatzi etiketa eta datu-mota.
    • Gehitu sarrera- eta irteera-parametro gehiago behar izanez gero.
  5. Sartu Power Fx adierazpena Adierazpena editorean.
    • Erreferentzia formulan sarrera-parametroak etiketaren izenaren arabera.
    • Irteerako parametroak kortxeteen barruan erreferentziatu behar dira, adibidez, { Out: "Return value" }.
    • Erreferentzia Dataverse taulak datuak biltzeko funtzioak erabiliz, hala nola, Filter() eta LookUp().
    • Eremua entitate gisa ezarrita badago, erabili ThisRecord plugin-exekutari lotutako taula-errenkadan zutabe-balioetara sartzeko, adibidez, ThisRecord.'Account Name'.

    Eskupekoa

    Kontuan izan adimenaren Adierazpena laukian. Azpimarratzen den gorriz baliogabea da. Squiggly horia esan nahi du zure logikaren eragina izan dezake delegazioaren mugek. Saihestu eskuordetze-arazoak delega daitezkeen funtzioak erabiliz.

  6. Aukeran, zabaldu Aukera aurreratuaksoluzioa, esparrua edo deskribapena aldatzeko.
  7. Hautatu Gorde.
  8. Probatu zure berehalako kode baxuko plugina.

Adibidea: Kalkulatu bi zenbaki osoren batura.

  • Sortu bi sarrera-parametro, X eta Y (biak zenbaki osokoak) eta irteera-parametro bat, Z (kate mota).
  • Erabili formula hau: {Z: X + Y }

Berehalako plug-in adibidea Dataverse Azeleragailua aplikazioan

Sortu kode baxuko plug-in automatizatu bat

  1. Erreproduzitu Dataverse azeleragailua aplikaziora.
  2. Hautatu Sortu plug-in automatizatua txartela. Sortu plug-in-txartel automatikoa
  3. Eman balio hauek:
    • Izena: idatzi pluginaren izen bat, adibidez, Sarrera baliozkotzea.
    • Taula: aukera ezazu plug-inarekin lotzeko taula bat, adibidez, Kontua.
    • Exekutatu plug-in-arau hau errenkada denean. Zehaztu plug-in-a deitzen duen datu-gertaera.
  4. Sartu Power Fx adierazpena Adierazpena editorean.
    • Erreferentzia Dataverse taulak datuak biltzeko funtzioak erabiliz, hala nola, Filter() eta LookUp().
    • Erabili ThisRecord pluginaren exekuzioari lotutako taula-errenkadan zutabe-balioetara sartzeko, adibidez, ThisRecord.'Account Name'.
  5. Aukeran, zabaldu Aukera aurreratuaketapa (hau exekutatu behar denean) eta soluzioa plugin-a gordetzen den aldatzeko.
  6. Hautatu Gorde.
  7. Probatu zure kode baxuko plugin automatikoa.

Erabili Power Platform konektoreak kode baxuko plug-inetan

Power Platform konektoreak kode baxuko plug-inetan erabil daitezke Dataversetik kanpoko sistemetako datuak eta funtzionalitateak erraz integratzeko, hala nola SQL Server, Salesforce eta SharePoint, kodeketa konplexurik edo garapen pertsonalizatu beharrik gabe.

Kode baxuko plug-inetan konektoreak erabiltzeko aurrebaldintzak

Konektore-ekintzak erabiltzea kode baxuko plug-inetan

Erraz erabil ditzakezu konektoreak eta konektore pertsonalizatuak kode baxuko plug-in a Power Fx formula batetik.

  1. Sortu konexio bat erabili nahi duzun konektorearekin.
  2. Gehitu konexio-erreferentzia inguruko Dataverse konexioari.
  3. Behe-kodeko plug-in Power Fx esamoldeen editorean, idatzi konexio-erreferentziaren izena (barneko izena aurrizkia eta azpimarra duena, adibidez new_connectorName, ez bistaratzeko izena).
  4. Intellisense-k erabilgarri dauden ekintzak erakusten dizkizu. Hautatu nahi duzun ekintza eta, ondoren, sartu beharrezko parametroak.

Kode baxuko plug-in batean konektore bat erabili aurretik, berrikusi konektorearen dokumentazioa sarrera- eta irteera-parametroak behar bezala pasatzen dituzula ziurtatzeko.

Informazio gehiago: adibidea

Oharra

  • Konektore-ekintza guztiak ez dira onartzen momentu honetan.
  • Ez erabili Dataverse konektorea plug-in adierazpen batetik Dataverse tauletara konektatzeko. Horren ordez, erabili berezko Power Fx funtzioak bildumekin elkarreragiteko: Iragazkia, Bilatu, Bilatu, Adabakia, Bildu eta Ezarri aldagai global gisa tratatzen diren.

Probatu kode baxuko plug-in bat

Probatu berehalako pluginak

  1. Hasierako pantailan, hautatu berehalako plug-in bat zerrendatik, eta, ondoren, hautatu Proba komando-barran. Pantaila honetara ere irits zaitezke komando-barrako berehalako plug-in editorea gorde ondoren. Hautatu Probatu kode baxuko plug-inerako

  2. Eman kode baxuko plug-inean definitutako sarrera-parametroen balioak eta, ondoren, hautatu Exekutatu. Hautatu Exekutatu kode baxuko plugina probatzeko

Behatu erantzuna.

Eskupekoa

Erabili irteera-parametroak espero diren portaera eta emaitzak balioztatzeko. Bestela, probak egitean arrakasta edo porrota besterik ez duzu ikusten.

Probatu plug-in automatikoak

Probatu plug-in automatikoak datu-gertaera deituz. Behatu plugina arrakastaz exekutatu den formulan zehaztutako espero diren aldaketak balioztatuz.

Eskupekoa

Aurrebista garaian, lotutako datu-gertaera dei dezakezu Power Apps-ko taula-editorea erabiliz:

  1. Hasi saioa Power Appsn, joan Taulak ra eta hautatu Plug-in taula.
  2. Komando-barran, hautatu Editatu.
  3. Sortu, eguneratu edo ezabatu errenkadak zuzenean ikuspegi honetatik. Bestela, ireki errenkada bat inprimaki lehenetsian errenkada bat hautatuz eta, ondoren, hautatu Editatu errenkada formularioa erabiliz komando-barran.

Integratu kode baxuko plug-in bat

Deitu berehalako plug-in bat mihise-aplikazio edo orri pertsonalizatu batetik

  1. Dataverse Azeleragailua aplikazioan:
    1. Hautatu berehalako plugina zerrendan.
    2. Hautatu Kopiatu kode zatia komando-barran. Deitu kode baxuko plugin-instantzia bat
    3. Itsatsi eta gorde kopiatutako formula testu-editore edo koaderno batean (erraz aipa zaitezkeen nonbait).
  2. Power Apps atalean:
    1. Sortu edo editatu mihise-aplikazio bat (edo orri pertsonalizatua) Power Apps estudioan.
    2. Ezkerreko nabigazioan, Datu-iturriak fitxan, hautatu + Datu-iturburu berria eta bilatu Ingurumena aukera Dataverse konektorean.
    3. Txertatu osagai hauek mihisean:
    • Gehitu parametro bakoitzaren datu-motarekin bat datozen sarrera-kontrolak, esate baterako, Testuaren sarrera testua edo zenbakietarako, aktibatu boolerako.
    • Plugin-esparrua taula bati lotuta badago, gehitu taula berdinarekin erlazionatutako konbinazio-koadroa, sarrera aukera dezazun.
    • Gehitu botoi bat pluginera deitzeko.
  3. Itsatsi kopiatu duzun plug-in-formula botoiaren OnSelect propietatean.
  4. Mapeatu sarrera-parametro bakoitza Value dagozkion sarrera-kontrolei erreferentzia egiteko:
    • Formula Environment.new_CalculateSum({ X: Value, Y: Value }); balitz, honela berridatzi liteke: Environment.new_CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text });
    • Formula lotua bazegoen, ordezkatu Environment taularen bistaratzeko izenarekin plug-inera sartzeko.
  5. Irteerako parametro bat definitzen bada kode baxuko plug-inerako:
    1. Hartu erantzuna Set() edo UpdateContext() formula batean: Set( ActionResult, Environments.CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text }) );. Erakutsi aldagaia etiketa batean. Bestela, erabili Notify() formula jakinarazpen batean datuak bistaratzeko.
  6. Erreproduzitu aplikazioa eta hautatu komandoa komando-barran kode baxuko plugina exekutatzeko.

Lortu informazio gehiago nola dei dezakezun Dataverse ekintzak zuzenean Power Fx mihise-aplikazioetan.

Deitu berehalako plug-in bat Power Automate hodeiko fluxu batetik

  1. Hodeiko fluxu batean, gehitu ekintza berri bat Microsoft Dataverse konektoretik.
  2. Hautatu Egin lotu gabeko ekintza bat edo Egin lotu ekintza bat izeneko ekintza.
  3. Hautatu zure plugina (izena bakarra du aurrizki batekin).
  4. Eman sarrerako parametro guztien balioak (halakorik badago).

Deitu berehalako plug-in bat Dataverse Web APItik

Jarraitu Lotu gabeko ekintza edo Taulari ataletara loturiko funtzioa Web APIaren dokumentazioko API pertsonalizatuak deitzea (pluginaren esparru egokiaren arabera).

Kode baxuko plug-inekin laguntza eskuratzen

Kode baxuko plugina sortzeko edo exekutatzeko arazoak aurkitzen badituzu, joan gerta daitezkeen arazo arruntetarako aholku hauetara: Microsoft Dataverse kode baxuko pluginen aholkuak eta arazo ezagunak

Laguntza eta laguntzarekin harremanetan jartzen

Dataverse Azeleragailuaren konponbidearen instalazioarekin edo kode baxuko plug-inekin Microsoft Dataverse kode baxuko pluginen aholkuetan eta arazo ezagunetann azaltzen ez diren arazoetarako (adibidez, jasotako dokumenturik gabeko akatsak), erabili Laguntza + laguntza-esperientzia eta sartu informazio hau:

  • Arazo mota: Dataverse Web APIa eta SDK
  • Arazoaren azpimota- Azeleragailuaren kit Dataverse

Sor ditzakezun kode baxuko pluginen adibidea

Kode baxuko plug-in bat sortzeko adibide batzuk ikusteko, joan Adibidea Dataverse kode baxuko plugin-ak (aurrebista)

Murriztapenak

  • Inguruneko hizkuntza-objektua irakurri behar da lehendik dauden mihise-aplikazioetan plugin berrietara sartzeko. Lehendik dagoen mihise-aplikazio batean ingurune-taularen datu-iturburua gehitu ondoren sortutako edozein pluginetarako, Power Fx ingurumen hizkuntza-objektua kendu eta irakurri behar duzu. Ondoren, plug-inen zerrenda eguneratua ikusiko duzu ekintza gisa.

  • Intellisense-k gehigarri automatikoetan idazkera esplizitua behar du formulako taularen bat aipatu nahi baduzu. Erabili hurrengo desanbiguazio sintaxia, hala nola [@Accounts], kortxete eta @ sinboloa erabiliz (ez Accounts).

  • Habiaratutako euskarria. Plugin-ek Power Fx esamoldeetatik soilik dei ditzakete Microsoft-ek argitaratutako lehenen ekintzetara.

  • Zenbait Collect eszenatoki Patch behar dute. Badaude egoera batzuk non Collect() k ez duen funtzionatzen. Konponbidea Patch() beheko zutabearen adibidean agertzen den bezala erabiltzea da. Plugin automatizatu bat sortzen ari bazara, jarri @ Power Fx formulan aipatzen den taula bakoitzari.

    Patch(Faxes,
    Collect(Faxes, { Subject : "Sub1" } ),
    { Regarding : First(Accounts) }
)

  • Kode baxuko plugin-ak konektoreekin elkarreragiten dutenean eta DLP erabiltzen denean, administratzaileak DLP erabiliz konexioak sortzea blokeatu dezake. Hala ere, Dataverse ingurunean dauden konexio-erreferentziek funtzionatzen jarraitzen dute. Administratzaileak edozein konektorerekin kode baxuko plug-in-interakzio guztiak blokeatu behar baditu, erakundearen ezarpena desgaitu dezake Allowconnectorsonpowerfxactions. Ezarpen hau lehenespenez gaituta dago eta ohiko SDK metodoen bidez desgaitu daiteke (WebAPI, SDK, PowerShell eta abar). Hau desgaitu dezakezu kode baxuko berehalako plug-in bat erabiliz, honela:

    Patch(Organizations, First(Organizations), { 'Enable connectors on power fx actions.': 'Enable connectors on power fx actions. (Organizations)'.No })

  • Konektoreak erabiltzen dituzten plugin-ek eremu zehatzetako emaitzak soilik atera ditzakete. Hori dela eta, konektorearen erantzunetik irteerako balio espezifikoak mapatu behar dituzu.

Konektore pertsonalizatuen muga duten kode baxuko pluginak

Konektore pertsonalizatuekin kode baxuko pluginak badituzu, lehenik eta behin konektore pertsonalizatuak inportatu behar dira, konexio erreferentziak edo fluxuak baino lehen.

Zure inguruneak ez badu konektore pertsonalizatua soluzio batean, inportatu konektore pertsonalizatua soilik barne hartzen duen soluzio bereizia. Inportatu hau benetako soluzioa inportatu aurretik. Lehenik eta behin egin behar duzu Azure-k konektore pertsonalizatua erregistratu behar duelako beste soluzio-osagaiak inportatu aurretik.

Konektore eta fluxu pertsonalizatuak dituen irtenbide bat inportatzen baduzu, Azure ezin izango da konektore pertsonalizatua erregistratu zure konexio-erreferentziak edo fluxuak erregistratzen dituen bitartean. Aurretik bereizitako soluzio batean inportatu ez zen konektore pertsonalizaturako konexio-erreferentziei ere aplikatzen zaie. Azure-k ez badu zure konektore pertsonalizatua erregistratu, inportazioak huts egingo du edo ezin duzu inportazioa hasi.

Informazio gehiago: Sortu konektore pertsonalizatuak soluzioetan: muga ezagunak

Ikusi ere

Kode baxuko pluginak Power Fx (aurrebista)

Erabili aurrez eraikitako gonbita Dataverse kode baxuko plug-in batean Power Apps

Sortu kode baxuko plug-in automatizatu bat Power Apps (bideoa) honekin

Sortu berehalako kode baxuko plug-in bat Power Apps rekin (bideoa)

  • Last updated on