Vähese koodiga lisandmoodulite näide Dataverse (eelvaade)

[See teema on väljalaske-eelne dokumentatsioon ja seda võidakse muuta.]

Nende näidislisandmoodulite eesmärk on aidata teil alustada, integreerides need oma rakendustesse. Saate aru, et autorluskogemus hõlmab avaldistega toetatud Microsoft Dataverse kohandatud API-de loomist Power Fx , mis võivad käivitada sisemisi või väliseid toiminguid Dataverse.

Oluline

Kohesed vähese koodiga lisandmoodulid on prioriteetideta ja neid ei pakuta funktsioonina. Kohesed vähese koodiga pistikprogrammid asendatakse funktsioonidega. Lisateave: Funktsioonid ( Microsoft Dataverse eelvaade)
See on eelvaate funktsioon.
Eelvaatefunktsioonid ei ole mõeldud kasutamiseks tootmises ja nende funktsioonid võivad olla piiratud. Need funktsioonid on saadaval enne ametlikku väljastamist, et kliendid saaksid sellele varakult juurdepääsu ja võiksid tagasisidet anda.

Eeltingimus

Andmesündmuse Dataverse jaoks ühe näidislisandmooduli kasutamiseks peab kiirendirakendus olema keskkonda installitud. Lisateave: Vähese koodiga lisandmooduli loomise eeltingimused

Märkus.

Meilimallid on saadaval ainult teatud tabelite jaoks. Lisateave: Meilimallide loomine

Mittenegatiivse väärtuse tagastamine

Selles näites kasutatakse funktsiooni Abs(), et tagastada oma argumendi mittenegatiivne väärtus. Kui arv on negatiivne, Abs tagastab positiivse ekvivalendi.

Kiirendi rakenduse esitamine Dataverse ja käsuribal valige Uus toiming>Kiirplugin.
Sisestage kuvatav nimi (nt valemi nimi ja kirjeldus).
Looge Out parameeter eeldatava käitumise valideerimiseks, mis on mõistlik (nt string) Testimise hõlbustamiseks saate testimise hõlbustamiseks kasutada sisendparameetreid, mis on valemi puhul mõistlik.
Mähkige Out valemiredaktoris parameeter lokkis sulgudesse:
```
{Out: "" }
```
Sisestage valemit testiv avaldis.
- Kontrollige, kas IntelliSense aktsepteerib valemit (tekst muutub helesiniseks).
- Rakendage näiteks avaldis, mis annab väljundi, mis aitab tulemust valideerida.
```
{Out: "Abs(-5) = 5: " & Text( Abs(-5) = 5 )  }
```
Valige Edasi ja seejärel valige Salvesta.
Valemi testimiseks valige Testi. Kasutage tulemuse kinnitamiseks väljundparameetrit.

Sisendi valideerimine ja kohandatud tõrked

Dubleeri tuvastamine

Rakendage serveripoolset sisendi valideerimist, näiteks duplikaattõrke tuvastamist, mis annab kohandatud tõrketeate.

Kiirendi rakenduse esitamine Dataverse ja käsuribal suvand Uus toiming>Automatiseeritud lisandmoodul.
Sisestage väljale Nimi tekst Duplikaatkontroll.
Tabeli jaoks valige Kontakt.
Suvandi Käivita see lisandmoodul, kui rida on olemas jaoks valige Loodud.
Sisestage väljale Valem järgmine valem.

 If( !IsBlank(LookUp([@Contacts],'Last Name'=ThisRecord.'Last Name' && 'First Name'=ThisRecord.'First Name')),
    Error("You have existing contacts with the same first name and last name")
)

Valige käsk Salvesta.

Testige pistikprogrammi

Lisandmooduli testimiseks looge kontaktide tabeli abil lõuendirakendus, järgides siin toodud juhiseid: Tabeli määramine.
Kontaktirea loomine.
Looge teine kontakt, millel on sama nimi nagu eelmises etapis.
Kuvatakse teade, mis näitab leitud duplikaatkirjeid. Valige Ignoreeri ja salvesta tõrketeate viibal.

Kuvatakse see kohandatud tõrketeade: Teil on kaks sama ees- ja perekonnanimega kontakti.

Andmete valideerimine

Kuvage teatud tüüpi tõrked, kasutades loendit ErrorKind .

Looge uus automaatne pistikprogramm.
Esitage järgmised väärtused.
- Nimi: sisendi valideerimine
- Kirjeldus: Kontrollib kehtivat kuupäeva ja kuvab veateate, kui see on kehtetu
- Tabel: Kohtumine
- Käivitage see pistikprogramm, kui rida on: Värskendatud

Sisestage allolev valem:

If(ThisRecord.'Due Date' < Now(), 
 Error({ Kind: ErrorKind.Validation , Message: "The due date cannot be in the past" })
);

Määrake jaotises Täpsemad suvandid sätteks Millal peaks see käivituma väärtuseks Operatsioonieelne; kehtetute andmete vältimiseks soovite selle reegli käivitada enne andmete salvestamist.
Valige käsk Salvesta.

Kohandatud tõrgete kohta lisateabe saamiseks avage funktsioon Error().

Meilisõnumi saatmine andmesündmuse alusel

Eeltingimused:

Serveripoolne sünkroonimine on teie keskkonna jaoks seadistatud. Lisateave: Meilisõnumite, kohtumiste, kontaktide ja tööülesannete serveripoolse sünkroonimise häälestamine
Meili mall.

Meilimalli näide

Siin on meilimalli näide, mille saate luua SenMaili-põhise andmesündmuse jaoks.

Malli tüüp: Globaalne
Nimi: Telli Aitäh
Kirjeldus: kasutage seda malli, et tänada klienti teile tellimuse esitamise eest.
Teema:Thank you for your order <orderconfirmation-{!salesorder:Order Number; }>
Keha: kasutage seda koodi.

   Hello {!Sales Order:First Name;},
   Order Type: {! Sales Order: Order Type;},
   Location Type: {! Sales Order: Location Type;},
   Address1: {! Sales Order: Address 1;},
   Address2: {! Sales Order: Address 2;},
   Preferred Service Start Date 1: {! Sales Order: Preferred Service Start Date;},
   Next Step- We take upto 48 hrs to schedule an in-person and will notify you as soon as we have a In-person Technician allocated at your site. For any questions, please contact us at 1-800-CON-SOLAR
   Yours Sincerely, 
   Contoso Sales

Automaatse lisandmooduli loomine

Esitage Dataverse kiirendirakendus ja seejärel valige jaotises Automatiseeritud lisandmoodulid + Uus lisandmoodul.
Sisestage järgmine teave.
- Nimi: SendEmailUponCreate
- Tabel: valige müügitellimuste loogilise tabeli nimi, mis on SalesOrder. See sündmus põhineb tabelil Müügitellimused.
- Käivitage see pistikprogramm reaga on: Loodud
- Valem: kleepige allolev kood kasti Valem . Lisateavet leiate funktsioonist SendEmailFromTemplate toimingule SendEmailFromTemplate.
```
XSendEmailFromTemplate(
    LookUp('Email Templates',StartsWith(title,"Order Thank You")).'Email Template',
ThisRecord,
LookUp(Users,'Primary Email'="sampleemail@sample.com"),[ThisRecord.Email]
)
```
Valige Täpsem>Operatsioonijärgne.
Valige käsk Salvesta.

Ilmub kinnitusteade Plugin edukalt salvestatud .

Rakendusesiseste märguannete saatmine kiirtoimingu põhjal

Rakendusesisesed teatised võimaldavad tegijatel konfigureerida mudelipõhiste rakenduste kasutajatele kontekstipõhiseid, rakendatavaid teatisi.

Rakendusesisese teatise saatva vähese koodiga lisandmooduli loomine

Esitage Dataverse kiirendirakendus ja seejärel valige jaotises Kiirpluginad +Uus pistikprogramm.
Sisestage järgmine teave, valige Edasi:
- Nimi: NotifyTechnican1
- Kirjeldus: See kiirpistikprogramm teavitab rakenduse kasutajat.
Looge lehel Definitsioonid sisendparameetrid järgmiste andmetüüpidega.
- Tellimuse ID: string
- TechnicianEmail: string

Valem. Kleepige järgmine kood väljale Valem. Selle funktsiooni kohta lisateabe saamiseks minge jaotisse SendAppNotification Action.

 XSendAppNotification(
 	"New service",
 	LookUp(Users,'Primary Email'=TechnicianEmail),
 	"You have a new solar panel installation scheduled on "& LookUp('Scheduling Results','OrderId'=OrderID).'ServiceDate'&" in "& LookUp('Service Orders','Order Number'=OrderID).City &". Contact the coordinator with any questions.",
 [
 	XCreateSidePaneActionForEntity(
     		"View order",
 		OrderID,
 		"Sales Order",
 		"cr8b8_serviceorder1",
 		LookUp('Service Orders','Order Number'=OrderID).'Service Order'
     	)
 	]
 )

Tehke valik Edasi.
Valige lehel Kokkuvõte nupp Salvesta.

Rakendusesisese märguande kiirtoimingu käivitamine

Valige lõuendirakendus ja seejärel valige käsuribal Redigeeri (või looge uus).
Valige vasakpoolsel navigeerimispaanil ekraan või looge uus.
Lisage menüüs Lisa lehele nupp, kasutades tekstiteatetehnikut.
Valige nupp ja sisestage fx-valemiribale järgmine , kus DataCardValue17 on veerg, mis sisaldab tellimuse ID-d, ja DataCardValue15 on veerg, mis sisaldab tehniku meiliaadressi. Selles näites kasutatakse lõuendirakendust nimega Teenusetellimuse rakendus.
```
 Environment.cr8b8_Notifytechnician1({
       OrderID: DataCardValue17.Text,
    TechnicianEmail: DataCardValue15.Text 
 });

   	Notify("The technician was notified!", NotificationType.Success, 2000);
```
Salvestage ja avaldage oma muudatused.

Kui rakenduses on valitud tehniku teavitamise toiming, saadetakse hooldustellimusele määratud tehnikule rakendusesisene teatis. Teatise toiming avab hooldustellimuse üksikasjad külgpaanil.

Teavitus saadetakse tehnikule, kes võtab rakenduses vastu

MSN Weatheri konnektoriga kiirlisandmooduli näidis

See pistikprogramm tagastab MSN Weather konnektori abilkonkreetse asukoha praeguse ilma.

Eeltingimused:

Vähese koodiga lisandmooduli loomise eeltingimused
MSN Weather konnektor on keskkonnas lubatud

Looge MSN Weatheri ühenduse viide, kui see pole keskkonnas veel saadaval.
Kopeeri katkend:
Lõpetage valemi redigeerimine Intellisense’i abil ja kasutage konnektori vastuse atribuute vastavalt vajadusele.
Salvesta
Testige pistikprogrammi

Jootraha

Kasutage funktsiooni With(), et jäädvustada kogu vastus ühest toimingust, kui soovite juurdepääsu vastuse erinevatele atribuutidele. Allolevas näites on sisendparameeter Location (string) ja väljundparameeter Out (string).

With({ /* Capture current weather response from connector */
c: new_MsnWeather.CurrentWeather( Location, "Imperial" ).responses.weather.current
},{	/* Return concatenated weather details */
Out: "Current temp: " & c.temp & " degrees. Feels like " & c.feels & " degrees. Wind speed is " & c.windSpd & " mph."
})

Head tavad

Lõpmatute tsüklite tõrgete käsitlemine automatiseeritud vähese koodiga pistikprogrammides

Ärge kirjutage plaastri avaldust automaatsele pistikprogrammile sündmuse "Update" korral, kui plaaster toimub pistikprogrammiga samas tabelis. See toob kaasa lõpmatud tsüklid ja pistikprogrammide täitmise tõrked.

Probleemne muster: valemi kasutamine Patch() käivitab uue värskenduse.

Soovitatav muster: selle probleemi vältimiseks kasutage Set() selle asemel valemit.

Vaata ka

Vähese koodiga lisandmoodulid Power Fx (eelvaade)

Tagasiside

Kas sellest lehest oli abi?

Last updated on 2025-03-24