Primer Dataverse z malo programske kode vtičnikov (predogledna različica)

[Ta tema je namenjena predizdajni dokumentaciji in se lahko spremeni.]

Cilj teh primerov vtičnikov je, da vam pomagajo začeti z integracijo v vaše aplikacije. Razumeli boste, da avtorska izkušnja vključuje Microsoft Dataverse avtorske API-je po meri, podprte z Power Fx izrazi, ki lahko sprožijo notranja ali zunanja dejanja Dataverse.

Pomembno

• To je funkcija predogleda.
• Poskusne funkcije niso za komercialno uporabo, njihovo delovanje je lahko omejeno. Te funkcije so na voljo še pred uradno izdajo, da lahko stranke predčasno dostopajo do njih in posredujejo povratne informacije.

Predpogoj

Če želite uporabiti enega od vzorčnih vtičnikov za podatkovni dogodek, mora biti v okolju nameščena aplikacija Dataverse accelerator. Več informacij: Predpogoji za ustvarjanje vtičnika z malo programske kode

Opomba

E-poštne predloge so na voljo samo za določene tabele. Več informacij: UStvarjanje predlog za e-pošto

Vrne nenegativno vrednost

Ta primer uporablja funkcijo Abs() za vrnitev nenegativne vrednosti njenega argumenta. Če je število negativno, Abs vrne pozitivni ekvivalent.

1. Predvajajte aplikacijo Dataverse Accelerator, v ukazni vrstici izberite Novo dejanje > Takojšnji vtičnik.

2. Navedite prikazno ime, na primer ime formule in opis.

3. Ustvarite Out parameter za preverjanje pričakovanega vedenja, ki je smiselno, kot je niz. Izbirno uporabite vhodne parametre za lažje testiranje, kar je smiselno s formulo.

4. V urejevalniku formul Zavijanje Out parameter v zavitih oklepajih:

   {Out: "" }
   

5. Vnesite izraz, ki preizkusi formulo:

   • Preverite, ali intellisense sprejema formulo (besedilo postane svetlo modro).
   • Implementirajte izraz, ki zagotavlja izhodne podatke za pomoč pri preverjanju rezultata, na primer.

   {Out: "Abs(-5) = 5: " & Text( Abs(-5) = 5 )  }
   

6. Izberite Naprej in nato izberite Shrani.

7. Izberite Preizkus, da preizkusite formulo. Za potrditev rezultata uporabite izhodni parameter.

Preverjanje vnosa in napake po meri

Zaznaj dvojnike

Izvedite preverjanje vnosa na strani strežnika, kot je zaznavanje podvojenih napak, ki vrže sporočilo o napaki po meri.

1. Predvajajte aplikacijo Dataverse Accelerator, v ukazni vrstici izberite Novo dejanje > Samodejni vtičnik.
2. V polje Ime vnesite Duplicate check.
3. Za Tabelo izberite Stik.
4. Za Zaženi ta vtičnik, ko je vrstica, izberite Ustvarjeno.
5. V polje Formula vnesite to formulo:

 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")
)

6. Izberite Shrani.

Preizkusite vtičnik

1. Če želite preizkusiti vtičnik, ustvarite platno s tabelo s stiki, tako da sledite tem korakom: Določite tabelo
2. Ustvarite vrstico stikov.
3. Ustvarite drug stik z enakim imenom kot v prejšnjem korak.
4. Prikaže se sporočilo, ki označuje najdene podvojene zapise. V pozivu za sporočilo o napaki izberite Prezri in shrani .

Prikaže se to sporočilo o napaki po meri: Imate dva stika z istim prvim in priimek.

Preverjanje veljavnosti podatkov

Prikažite posebne vrste napak z uporabo oštevilčenja ErrorKind .

1. Ustvarite nov samodejni vtičnik.

2. Podajte naslednje vrednosti:

   • Ime: Preverjanje vnosa
   • Opis: Preveri veljaven datum in vrže napako, če ni veljaven
   • Tabela: Sestanek
   • Zaženite ta vtičnik, ko je vrstica: posodobljena

3. Vnesite spodnjo formulo:

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

4. Pod Napredne možnosti nastavite Kdaj naj se to zažene na Pred delovanjem; želite zagnati to pravilo, preden se podatki shranijo, da preprečite neveljavne podatke.

5. Izberite Shrani.

Pojdite na funkcijo Error() če želite izvedeti več o napakah po meri.

Pošlji e-pošto na podlagi podatkovnega dogodka

Zahteve:

• Strežniška sinhronizacija je nastavljena za vaše okolje. Več informacij: Nastavite strežniško sinhronizacijo e-pošte, sestankov, stikov in opravil
• E-poštna predloga.

Primer e-poštne predloge

Tukaj je primer e-poštne predloge, ki jo lahko ustvarite za podatkovni dogodek na podlagi SenMail:

• Vrsta predloge: Globalno
• Ime: Naročilo Hvala
• Opis: S to predlogo se stranki zahvalite za naročilo.
• Zadeva: Thank you for your order <orderconfirmation-{!salesorder:Order Number; }>
• Telo: Uporabite to kodo.

   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 

Ustvarite samodejni vtičnik

1. Predvajajte aplikacijo Dataverse Accelerator in nato izberite +Nov vtičnik pod Samodejni vtičniki.
2. Vnesite te podatke:

   • Ime: Pošlji e-pošto ob ustvarjanju

   • Tabela: Izberite logično ime tabele prodajnih naročil, ki je SalesOrder. Ta dogodek temelji na tabeli prodajnih naročil.

   • Zaženite ta vtičnik z vrstico: Ustvarjeno

   • Formula: prilepite spodnjo kodo v polje Formula . Za več informacij o funkciji SendEmailFromTemplate glejte Dejanje SendEmailFromTemplate.

     XSendEmailFromTemplate(
         LookUp('Email Templates',StartsWith(title,"Order Thank You")).'Email Template',
     ThisRecord,
     LookUp(Users,'Primary Email'="sampleemail@sample.com"),[ThisRecord.Email]
     )
     

3. Izberite Napredno > Po operaciji.
4. Izberite Shrani.

Prikaže se potrditveno sporočilo Plugin uspešno shranjen .

Pošiljanje obvestil v aplikaciji na podlagi takojšnjega dejanja

Obvestila v aplikaciji izdelovalcem omogočajo, da konfigurirajo kontekstualna, uporabna obvestila za uporabnike v aplikacijah, ki temeljijo na modelu.

Ustvarite vtičnik z malo programske kode, ki pošlje obvestilo v aplikaciji

1. Predvajajte Dataverse aplikacijo pospeševalnika in nato izberite +Nov vtičnik pod Takojšnji vtičniki.
2. Vnesite naslednje podatke in izberite Naprej:
   • Ime: NotifyTechnican1
   • Opis: Ta takojšnji vtičnik obvesti uporabnika aplikacije.
3. Na strani Definicije ustvarite vhodne parametre s temi tipi podatkov:
   • ID naročila: Niz
   • Tehnični naslov: Niz
4. Formula. Prilepite naslednjo kodo v polje Formula . Za več informacij o tej funkciji pojdite na Dejanje SendAppNotification.

    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'
            )
        ]
    )
   

5. Izberite Naprej.
6. Na strani Povzetek izberite Shrani.

Prikličite takojšnje dejanje obvestila v aplikaciji

1. Izberite aplikacijo za platno in nato izberite Uredi v ukazni vrstici (ali ustvarite novo).
2. Izberite zaslon v levem podoknu za krmarjenje ali ustvarite novega.
3. V meniju Vstavi dodajte Gumb na stran z uporabo Besedilo Obvestite tehnika.
4. Izberite gumb in v vrstico s formulo fx vnesite naslednje, kjer je DataCardValue17 stolpec, ki vsebuje ID naročila in DataCardValue15 je stolpec, ki vsebuje e-poštni naslov tehnika. V tem primeru je uporabljena platno aplikacija z imenom Service Order App .

   Environment.cr8b8_Notifytechnician1({
          OrderID: DataCardValue17.Text,
      TechnicianEmail: DataCardValue15.Text 
   });
   
       Notify("The technician was notified!", NotificationType.Success, 2000);
   
   

   
5. Shranite in objavite svoje spremembe.

Ko je v aplikaciji izbrano dejanje obveščanja tehnika, se tehniku, ki je bil dodeljen servisnemu naročilu, pošlje obvestilo v aplikaciji. Dejanje na obvestilu odpre podrobnosti storitvenega naročila v stranskem podoknu.

Primer takojšnjega vtičnika s priključkom MSN Weather

Ta vtičnik vrne trenutno vreme za določeno lokacijo z uporabo konektorja MSN Weather.

Zahteve:

• Predpogoji za ustvarjanje vtičnika z malo programske kode
• Priključek MSN Weather je dovoljen v okolju

1. Ustvarite sklic na povezavo za MSN Weather, če še ni na voljo v okolju:

2. Kopiraj izrezek:

3. Dokončajte urejanje formule z intellisensom in po potrebi uporabite lastnosti konektorja odgovor:

4. Shranite.

5. Preizkusite vtičnik

Nasvet

Uporabite funkcijo With() za zajem celotnega odgovor iz enega dejanja, če želite dostopati do različnih lastnosti, ki jih odgovor morda ima. V spodnjem primeru sta vhodni parameter Location (niz) in izhodni parameter Out (niz).

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."
})

Najboljše prakse

Obravnava napak neskončne zanke v samodejnih vtičnikih z malo programske kode

Ne pišite izjave o popravku za samodejni vtičnik ob dogodku »Posodobi«, kjer se popravek izvaja na isti tabeli kot vtičnik. To vodi do neskončnih zank in napak pri izvajanju vtičnikov.

Problematičen vzorec: uporaba Patch() formule sproži novo posodobitev.

Priporočeni vzorec: Namesto tega uporabite Set() formulo, da se izognete tej težavi.

Glejte tudi

z malo programske kode vtičniki Power Fx (predogledna različica)