Izmantojiet zema koda spraudņus ( Dataverse priekšskatījums)

[Šī tēma ir pirmsizlaides dokumentācija, un tā var tikt mainīta.]

Microsoft Dataverse piedāvā jaudīgu risinājumu efektīvākas datu arhitektūras sasniegšanai un klienta puses darba slodzes samazināšanai, izmantojot zema koda spraudņus. Šie spraudņi ir atkārtoti izmantojamas reāllaika darbplūsmas, kas izpilda noteiktu komandu kopu Dataverse, darbojas servera pusē un ko aktivizē personalizēti notikumu apdarinātāji.

Tradicionāli spraudņi tika izveidoti kā pielāgotas klases, kas apkopotas .NET Framework montāžā, kas pēc tam tika augšupielādētas un reģistrētas tajā Dataverse. Tomēr, ieviešot zema koda spraudņus, lietotāji var izveidot šos notikumu apdarinātājus ar minimālu kodēšanu vai bez tās, kā arī bez manuālas reģistrācijas.

Zema koda spraudņi tiek glabāti datu bāzē, Dataverse un tos var nemanāmi integrēt Power Apps un Power Automate. Darbplūsmas darbība tiek definēta, izmantojot izteiksmju valodu, Power Fx un tā var tieši izveidot savienojumu ar Dataverse biznesa datiem un ārējiem datu avotiem, izmantojot Power Platform savienotājus. Izmantojot zema koda spraudņus, veidotāji var ātri izveidot sarežģītas darbplūsmas ar minimālām kodēšanas zināšanām, kā rezultātā datu arhitektūra ir racionālāka un efektīvāka.

Servera puses loģikas priekšrocības

Servera puses biznesa loģikas definēšana piedāvā vairākas priekšrocības, tostarp:

• Paaugstināta drošība. Tā kā servera puses loģika tiek izpildīta serverī, tā var palīdzēt novērst nesankcionētu piekļuvi sensitīviem datiem vai procesiem.
• Uzlabota veiktspēja. Izpildot serverī, biznesa loģika var samazināt datu apjomu, kas jāpārsūta starp klientu un serveri, kā rezultātā tiek ātrāks apstrādes laiks.
• Konsekvence un uzticamība. Servera puses loģika nodrošina, ka biznesa kārtulas tiek konsekventi piemērotas visiem klientiem, samazinot kļūdu vai neatbilstību risku.
• Vieglāka apkope un jauninājumi. Centralizējot biznesa loģiku serverī, to kļūst vieglāk uzturēt un atjaunināt, jo izmaiņas var veikt vienuviet, nevis atjaunināt vairākus klientus.
• Mērogojamība. Servera puses loģiku var mērogot vieglāk nekā klienta puses loģiku, nodrošinot labāku veiktspēju un lielāku darba slodžu apstrādi.

Zema koda spraudņi

Tiek atbalstīti Dataverse divu veidu zema koda spraudņi:

Visiem zema koda spraudņiem ir šādas kopīgas īpašības:

Spraudņa atļaujas

Priekšnosacījumi zema koda spraudņa izveidei

Atjauniniet akseleratoru Dataverse

1. Izpildiet norādījumus, lai skatītu licencētas programmas savā vidē.
2. Ja paātrinātājs Dataverse jau ir instalēts un atjauninājums ir pieejams, tas ir norādīts tabulā blakus vienumam.
3. Atlasiet Dataverse Paātrinātājs un pēc tam komandjoslā atlasiet Atjaunināt .

Tūlītēja zema koda spraudņa izveide

1. Atskaņojiet Dataverse lietotni Accelerator.
2. Atlasiet Izveidot tūlītējo spraudņa karti.
3. Norādiet parādāmo vārdu.
4. Pēc izvēles definējiet parametrus:
   • Atlasiet Jauns ievades parametrs vai Jauns izvades parametrs, pēc tam ievadiet etiķeti un datu tipu.
   • Ja nepieciešams, pievienojiet papildu ievades un izvades parametrus.
5. Ievadiet Power Fx izteiksmi izteiksmju redaktorā.
   • Atsauces uz ievades parametriem formulā pēc etiķetes nosaukuma.
   • Izejas parametriem jābūt norādītiem cirtainu iekavu iekšpusē, piemēram { Out: "Return value" }.
   • Atsauces Dataverse tabulas, kurās izmantotas datu apkopošanas funkcijas, piemēram , Filtrs() un Uzmeklēšana().
   • Ja tvērums ir iestatīts uz entītija, izmantojiet ThisRecord , lai piekļūtu kolonnu vērtībām tabulas rindā, kas saistīta ar spraudņa izpildi, piemēram ThisRecord.'Account Name'.

   Padoms

   Ņemiet vērā intellisense lodziņā Izteiksme . Pasvītrots sarkans nav derīgs. Viļņaini dzeltens nozīmē, ka jūsu loģiku var ietekmēt deleģēšanas ierobežojumi. Izvairieties no deleģēšanas problēmām, izmantojot deleģējamas funkcijas.

6. Pēc izvēles izvērsiet sadaļu Papildu opcijas , lai modificētu risinājumu, darbības jomu vai aprakstu.
7. Atlasiet vienumu Saglabāt.
8. Pārbaudiet savu tūlītējo zema koda spraudni.

Piemērs: aprēķiniet divu veselu skaitļu summu.

• Izveidojiet divus ievades parametrus un X ( Y abus tipa veselus skaitļus) un vienu izvades parametru, Z (ierakstiet virkni).
• Izmantojiet šādu formulu: {Z: X + Y }

Automatizēta zema koda spraudņa izveide

1. Atskaņojiet Dataverse lietotni Accelerator.
2. Atlasiet opciju Izveidot automatizētu spraudņa karti.
3. Norādiet šādas vērtības:
   • Nosaukums: ievadiet spraudņa nosaukumu, piemēram , Ievades validācija.
   • Tabula: izvēlieties tabulu, ar kuru saistīt spraudni, piemēram, Konts.
   • Palaidiet šo spraudņa kārtulu, kad rinda ir. Norādiet datu notikumu, kas izsauc spraudni.
4. Ievadiet Power Fx izteiksmi izteiksmju redaktorā.
   • Atsauces Dataverse tabulas, kurās izmantotas datu apkopošanas funkcijas, piemēram , Filtrs() un Uzmeklēšana().
   • Izmantojiet ThisRecord , lai piekļūtu kolonnu vērtībām tabulas rindā, kas saistīta ar spraudņa izpildi, piemēram ThisRecord.'Account Name'.
5. Pēc izvēles izvērsiet sadaļu Papildu opcijas , lai modificētu posmu (kad tam vajadzētu darboties) un risinājumu , kurā spraudnis ir saglabāts.
6. Atlasiet vienumu Saglabāt.
7. Pārbaudiet savu automatizēto zema koda spraudni.

Savienotāju izmantošana Power Platform zema koda spraudņos

Power Platform savienotājus var izmantot zema koda spraudņos, lai viegli integrētu datus un funkcionalitāti no sistēmām ārpusē Dataverse, piemēram, SQL Server, Salesforce, un SharePoint bez nepieciešamības veikt sarežģītu kodēšanu vai pielāgotu izstrādi.

Priekšnosacījumi savienotāju izmantošanai zema koda spraudņos

Savienotāja darbību izmantošana zema koda spraudņos

Varat viegli izmantot savienotājus un pielāgotus savienotājus , izmantojot zema koda spraudņa Power Fx formulu.

1. Izveidojiet savienojumu ar savienotāju, kuru vēlaties izmantot.
2. Pievienojiet savienojuma atsauci savienojumam Dataverse vidē.
3. Zema koda spraudņa Power Fx izteiksmju redaktorā ierakstiet savienojuma atsauces nosaukumu (iekšējais nosaukums ar prefiksu un pasvītrojumu, piemēram new_connectorName, nevis parādāmais vārds).
4. Intellisense parāda pieejamās darbības. Atlasiet vajadzīgo darbību un pēc tam ievadiet nepieciešamos parametrus.

Pirms savienotāja izmantošanas zema koda spraudnī pārskatiet savienotāja dokumentāciju , lai pārliecinātos, vai ievades un izvades parametri tiek nodoti pareizi.

Papildinformācija: piemērs

Zema koda spraudņa testēšana

Tūlītējo spraudņu testēšana

1. Sākuma ekrānā sarakstā atlasiet tūlītējo spraudni un pēc tam komandjoslā atlasiet Pārbaudīt . Šim ekrānam varat piekļūt arī no tūlītējā spraudņa redaktora komandjoslā pēc tam, kad tas ir saglabāts.

2. Norādiet vērtības visiem ievades parametriem, kas ir definēti zema koda spraudnī, un pēc tam atlasiet Palaist.

Ievērojiet atbildi.

Automātisko spraudņu testēšana

Pārbaudiet automātiskos spraudņus, izsaucot datu notikumu. Pārbaudiet, vai spraudnis darbojās veiksmīgi, validējot paredzamās izmaiņas, kas tika definētas formulā.

Zema koda spraudņa integrēšana

Tūlītējā spraudņa izsaukšana no audekla programmas vai pielāgotas lapas

1. Dataverse Programmā Accelerator :
   1. Sarakstā atlasiet tūlītējo spraudni.
   2. Komandjoslā atlasiet Kopēt koda fragmentu .
   3. Ielīmējiet un saglabājiet kopēto formulu teksta redaktorā vai piezīmjblokā (kur varat viegli atsaukties).
2. In Power Apps:
   1. Izveidojiet vai rediģējiet audekla programmu (vai pielāgotu lapu) Power Apps studijā.
   2. Kreisajā navigācijas rūtī cilnē Datu avoti atlasiet + Jauns datu avots un savienotājā meklējiet opciju Vide Dataverse .
   3. Ievietojiet audeklā šādus komponentus:
   • Pievienojiet ievades vadīklas, kas atbilst katra parametra datu tipam, piemēram , teksta ievade tekstam vai skaitļiem, pārslēgšana būla vērtībai.
   • Ja spraudņa tvērums ir saistīts ar tabulu, pievienojiet kombinēto lodziņu, kas ir saistīts ar to pašu tabulu, lai varētu izvēlēties ievadi.
   • Pievienojiet pogu , lai izsauktu spraudni.
3. Ielīmējiet nokopēto spraudņa formulu pogas rekvizītā OnSelect .
4. Kartējiet katru ievades parametru Value , lai atsauktos uz atbilstošajām ievades vadīklām:
   • Ja formula būtu Environment.new_CalculateSum({ X: Value, Y: Value });, to varētu pārrakstīt kā: Environment.new_CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text });
   • Ja formula bija saistīta, aizstājiet Environment to ar tabulas parādāmo nosaukumu, lai piekļūtu spraudnim.
5. Ja zema koda spraudnim ir definēts izvades parametrs:
   1. Tveriet atbildi a Set() vai UpdateContext() formulā: Set( ActionResult, Environments.CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text }) );. Parādīt mainīgo etiķetē. Vai arī izmantojiet formulu, Notify() lai paziņojumā parādītu datus.
6. Atskaņojiet programmu un komandjoslā atlasiet komandu, lai palaistu zema koda spraudni.

Uzziniet vairāk par to, kā izsaukt Dataverse darbības tieši no Power Fx audekla programmām.

Tūlītēja spraudņa izsaukšana no mākoņa Power Automate plūsmas

1. Mākoņa plūsmā pievienojiet jaunu darbību no savienotāja Microsoft Dataverse .
2. Atlasiet darbību ar nosaukumu Nesaistītas darbības veikšana vai Saistītas darbības veikšana.
3. Atlasiet spraudni (tam ir unikāls nosaukums ar prefiksu).
4. Norādiet vērtības visiem ievades parametriem (ja tādi ir).

Tūlītējā spraudņa izsaukšana no Dataverse tīmekļa API

Izpildiet darbības, kas norādītas sadaļā Nesaistīta darbība vai Funkcija, kas saistīta ar tabulu sadaļām tīmekļa API dokumentācijā Pielāgotu API izsaukšana (atkarībā no spraudņa atbilstošā tvēruma).

Palīdzības saņemšana saistībā ar zema koda spraudņiem

Ja, izveidojot vai palaižot zema koda spraudni, rodas problēmas, skatiet šos padomus par bieži sastopamām problēmām, kas var rasties: Microsoft Dataverse padomi par zema koda spraudņiem un zināmās problēmas

Sazināšanās ar palīdzības + atbalsta dienestu

Ja rodas problēmas ar paātrinātāja Dataverse risinājuma instalēšanu vai zema koda spraudņiem, uz kuriem Microsoft Dataverse neattiecas padomi par zema koda spraudņiem, un zināmās problēmas, piemēram, saņemtās nedokumentētās kļūdas, izmantojiet palīdzības + atbalsta pieredzi un iekļaujiet tālāk norādīto informāciju.

• Problēmas tipa tīmekļa Dataverse API un SDK
• Problēmu apakštips- Akseleratora komplekts Dataverse

Zema koda spraudņu piemērs, ko varat izveidot

Dažus piemērus, kā izveidot zema koda spraudni, skatiet rakstā Zema koda spraudņu piemērs Dataverse (priekšskatījums)

Ierobežojumi

• Vides valodas objekts ir jālasa, lai piekļūtu jauniem spraudņiem esošajās audekla programmās. Visiem spraudņiem, kas izveidoti pēc vides tabulas datu avota pievienošanas esošai audekla programmai, ir jānoņem un jāizlasa Power Fx vides valodas objekts. Tad jūs redzat atjaunināto spraudņu sarakstu kā darbības.

• Intellisense pieprasa skaidru apzīmējumu automatizētajos spraudņos, ja vēlaties atsaukties uz jebkuru tabulu formulā. Izmantojiet šādu neskaidrības sintaksi, piemēram [@Accounts], izmantojot kvadrātiekavas un @ simbolu (not Accounts).

• Ligzdots atbalsts. Spraudņi var izsaukt tikai pirmās puses darbības, ko Microsoft publicējusi no Power Fx izteiksmēm.

• Daži Collect scenāriji prasa Patch. Ir daži scenāriji, kuros Collect() tas nedarbojas. Risinājums ir izmantot Patch() , kā parādīts tālāk redzamajā aizpildīšanas piemērā attiecībā uz kolonnu. Ja veidojat automatizētu spraudni, pievienojiet @ katrai tabulai, uz Power Fx kuru ir atsauce formulā.

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

• Kad zema koda spraudņi mijiedarbojas ar savienotājiem un tiek izmantots DLP, administrators var bloķēt savienojumu izveidi, izmantojot DLP. Tomēr esošās savienojumu atsauces Dataverse vidē turpina darboties. Gadījumā, ja administratoram ir jābloķē visas zema koda spraudņu mijiedarbības ar jebkuriem savienotājiem, viņi var atspējot organizācijas iestatījumu Allowconnectorsonpowerfxactions. Šis iestatījums ir iespējots pēc noklusējuma, un to var atspējot, izmantojot parastās SDK metodes (WebAPI, SDK, PowerShell utt.). To var atspējot, izmantojot zema koda tūlītējo spraudni, kā norādīts tālāk.

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

• Spraudņi, kas izmanto savienotājus, var izvadīt rezultātus tikai no noteiktiem laukiem. Sakarā ar to jums ir jākartē konkrētas primitīvas vērtības no savienotāja atbildes uz izejas vērtībām.

Zema koda spraudņi, kuriem ir pielāgoti savienotāju ierobežojumi

Ja jums ir zema koda spraudņi ar pielāgotiem savienotājiem, pirms savienojuma atsaucēm vai plūsmām vispirms ir jāimportē pielāgotie savienotāji.

Ja jūsu vidē nav pielāgotā savienotāja risinājumā, importējiet atsevišķu risinājumu, kas ietver tikai pielāgoto savienotāju. Veiciet šo importēšanu pirms faktiskā risinājuma importēšanas. Tas ir jādara vispirms, jo Azure ir jāreģistrē pielāgotais savienotājs, pirms var importēt citus risinājuma komponentus.

Ja importējat risinājumu, kas satur pielāgotus savienotājus un plūsmas, Azure nevar reģistrēt pielāgoto savienotāju, kamēr tas reģistrē jūsu savienojumu atsauces vai plūsmas. Tas attiecas arī uz tā pielāgotā savienotāja savienojuma atsaucēm, kas iepriekš netika importēts atsevišķā risinājumā. Ja Azure nav reģistrējis jūsu pielāgoto savienotāju, importēšana neizdodas vai jūs nevarat sākt importēšanu.

PapildinformācijaPielāgotu savienotāju izveide risinājumos: zināmie ierobežojumi

Skatiet arī:

Zema koda spraudņi Power Fx (priekšskatījums)

Iepriekš iebūvētas uzvednes Dataverse izmantošana zema koda spraudnī Power Apps

Izveidojiet automatizētu zema koda spraudni ar Power Apps (video)

Izveidojiet tūlītēju zema koda spraudni ar Power Apps (video)