Príklad Dataverse doplnkov s nízkym kódom (ukážka)

[Táto téma je predbežnou dokumentáciou a môže sa zmeniť.]

Cieľom týchto príkladov doplnkov je pomôcť vám začať ich integráciou do vašich aplikácií. Pochopíte, že prostredie na tvorbu obsahu zahŕňa Microsoft Dataverse vlastné rozhrania API podporované Power Fx výrazmi, ktoré môžu spúšťať akcie interné alebo externé Dataverse.

Dôležité

  • Okamžité doplnky s nízkym kódom sú zbavené priority a nedodávajú sa ako funkcia. Okamžité plug-iny s nízkym kódom sú nahradené funkciami. Viac informácií: Funkcie v Microsoft Dataverse (ukážka)
  • Toto je ukážková funkcia.
  • Funkcie ukážky nie sú určené na produkčné účely a môžu mať obmedzenú funkčnosť. Tieto funkcie sú k dispozícii pred oficiálnym vydaním, aby k nim mohli zákazníci získať rýchly prístup a poskytnúť odozvu.

Predpoklady

Ak chcete použiť jeden zo vzorových doplnkov pre dátovú udalosť, musí byť v prostredí nainštalovaná aplikácia akcelerátora Dataverse . Ďalšie informácie: Predpoklady na vytvorenie doplnku s nízkym kódom

Poznámka

Šablóny e-mailov sú k dispozícii len pre určité tabuľky. Ďalšie informácie: Vytvorte si šablóny pre e-mail

Vráti nezápornú hodnotu

Tento príklad používa funkciu Abs() na vrátenie nezápornej hodnoty jej argumentu. Ak je číslo záporné, Abs vráti kladný ekvivalent.

  1. Spustite aplikáciu Dataverse Accelerator, na paneli príkazov vyberte Nová akcia>Okamžitý doplnok.

  2. Zadajte zobrazovaný názov, napríklad názov vzorca a popis.

  3. Vytvorte parameter Out na overenie očakávaného správania, ktoré má zmysel, ako napríklad reťazec. Voliteľne použite vstupné parametre na uľahčenie testovania, ktoré má so vzorcom zmysel.

  4. V editore vzorcov zabaľte parameter Out do zložených zátvoriek:

    {Out: "" }

  5. Zadajte výraz, ktorý testuje vzorec:

    • Overte, či intellisense prijíma vzorec (text sa zmení na svetlomodrý).
    • Implementujte napríklad výraz, ktorý poskytuje výstup, ktorý pomôže overiť výsledok.
    {Out: "Abs(-5) = 5: " & Text( Abs(-5) = 5 )  }

  6. Vyberte Ďalej a potom vyberte Uložiť.

  7. Výberom možnosti Test otestujete vzorec. Na overenie výsledku použite parameter výstupu.

Overenie vstupu a vlastné chyby

Zisťovanie duplikátov

Implementujte overenie vstupu na strane servera, napríklad detekciu duplicitnej chyby, ktorá vyvolá vlastnú chybovú správu.

  1. Prehrajte aplikáciu Dataverse Accelerator, na paneli príkazov vyberte Nová akcia>Automatický doplnok.
  2. Do poľa Názov zadajte Duplicitná kontrola.
  3. Pre Tabuľka vyberte Kontakt.
  4. Pre Spustiť tento doplnok, keď je riadok , vyberte Vytvorené.
  5. Do poľa Vzorec zadajte tento vzorec:
 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")
)
  1. Vyberte položku Uložiť.

Otestujte doplnok

  1. Ak chcete doplnok otestovať, vytvorte aplikáciu plátna pomocou tabuľky kontaktov podľa týchto krokov: Určite tabuľku.
  2. Vytvorte riadok kontaktov.
  3. Vytvorte ďalší kontakt s rovnakým menom ako v predchádzajúcom kroku.
  4. Zobrazí sa správa oznamujúca nájdenie duplicitných záznamov. Vo výzve na chybové hlásenie vyberte Ignorovať a uložiť .

Zobrazí sa toto vlastné chybové hlásenie: Máte dva kontakty s rovnakým menom a priezviskom.

Overovanie údajov

Zobrazte konkrétne typy chýb pomocou ErrorKind enumerácie.

  1. Vytvorte nový automatický doplnok.

  2. Zadajte nasledujúce hodnoty:

    • Názov: Overenie vstupu
    • Popis: Skontroluje platný dátum a v prípade neplatnosti vyvolá chybu
    • Tabuľka: Stretnutie
    • Spustite tento doplnok, keď je riadok: aktualizovaný

  3. Zadajte vzorec nižšie:

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

  4. V časti Rozšírené možnosti nastavte Kedy sa to má spustiť na Pred prevádzkou; chcete spustiť toto pravidlo pred uložením údajov, aby ste predišli neplatným údajom.

  5. Vyberte položku Uložiť.

Prejdite na funkciu Error() , kde sa dozviete viac o vlastných chybách.

Odoslať e-mail na základe dátovej udalosti

Požiadavky:

Príklad šablóny e-mailu

Tu je príklad e-mailovej šablóny, ktorú môžete vytvoriť pre dátovú udalosť SenMail:

  • Typ šablóny: Globálne
  • Meno: Objednávka Ďakujeme
  • Popis: Použite túto šablónu na poďakovanie zákazníkovi za to, že u vás zadal objednávku.
  • Predmet: Thank you for your order <orderconfirmation-{!salesorder:Order Number; }>
  • Telo: Použite tento kód.
   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

Vytvorte automatizovaný doplnok

  1. Spustite aplikáciu Dataverse Accelerator a potom vyberte +Nový doplnok v časti Automatické doplnky.
  2. Zadajte nasledujúce informácie:

    • Meno: SendEmailUponCreate

    • Tabuľka: Vyberte názov logickej tabuľky zákaziek odberateľa, čo je Zákazka predaja. Táto udalosť je založená na tabuľke Predajné objednávky.

    • Spustite tento doplnok s riadkom je: Vytvorené

    • Vzorec: Vložte nižšie uvedený kód do poľa Vzorec . Ďalšie informácie o funkcii SendEmailFromTemplate nájdete v časti Akcia SendEmailFromTemplate.

      XSendEmailFromTemplate(
    LookUp('Email Templates',StartsWith(title,"Order Thank You")).'Email Template',
ThisRecord,
LookUp(Users,'Primary Email'="sampleemail@sample.com"),[ThisRecord.Email]
)
  3. Vyberte Rozšírené>Po operácii.
  4. Vyberte položku Uložiť.

Zobrazí sa potvrdzujúca správa Plugin bol úspešne uložený .

Odosielajte upozornenia v aplikácii na základe okamžitej akcie

Oznámenia v aplikáciách umožňujú tvorcom konfigurovať kontextové upozornenia pre používateľov v aplikáciách riadených modelom.

Vytvorte doplnok s nízkym kódom, ktorý odošle upozornenie v aplikácii

  1. Spustite aplikáciu Dataverse akcelerátor a potom vyberte +Nový doplnok v časti Okamžité doplnky.
  2. Zadajte nasledujúce informácie, vyberte Ďalej:
    • Názov: NotifyTechnican1
    • Popis: Tento okamžitý doplnok upozorní používateľa aplikácie.
  3. Na stránke Definície vytvorte vstupné parametre s týmito typmi údajov:
    • OrderID: Reťazec
    • E-mail technika: Reťazec
  4. Vzorec. Vložte nasledujúci kód do poľa Vzorec . Ďalšie informácie o tejto funkcii nájdete v časti 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'
     	)
 	]
 )
  5. Vyberte Ďalej.
  6. Na stránke Súhrn vyberte Uložiť.

Vyvolajte okamžitú akciu upozornenia v aplikácii

  1. Vyberte aplikáciu na plátne a potom vyberte Upraviť na paneli príkazov (alebo vytvorte novú).
  2. Vyberte obrazovku na ľavom navigačnom paneli alebo vytvorte novú.
  3. V ponuke Vložiť pridajte na stránku Tlačidlo pomocou TextUpozorniť technika.
  4. Vyberte tlačidlo a do panela vzorcov fx zadajte nasledovné, kde DataCardValue17 je stĺpec, ktorý obsahuje ID objednávky, a Stĺpec DataCardValue23's technics adresu. V tomto príklade je použitá aplikácia na plátne s názvom Aplikácia servisnej objednávky . 
     Environment.cr8b8_Notifytechnician1({
       OrderID: DataCardValue17.Text,
    TechnicianEmail: DataCardValue15.Text 
 });

   	Notify("The technician was notified!", NotificationType.Success, 2000);
    Pridajte tlačidlo s Power Fx vzorcom na odoslanie upozornenia technikovi
  5. Uložte a Zverejnite svoje zmeny.

Keď je v aplikácii vybratá akcia upozorniť technika, technikovi, ktorý bol priradený k servisnej zákazke, sa odošle upozornenie v aplikácii. Akcia týkajúca sa upozornenia otvorí podrobnosti servisnej objednávky na bočnom paneli.

Oznámenie odoslané technikovi, ktorý dostane v aplikácii

Ukážka okamžitého zásuvného modulu s konektorom MSN Weather

Tento doplnok vracia aktuálne počasie pre konkrétne miesto pomocou MSN Weather connector.

Požiadavky:

  1. Vytvorte referenciu pripojenia pre službu MSN Weather, ak ešte nie je dostupná v prostredí: Vytvorte odkaz na pripojenie v aplikácii z tably odkazov na pripojenie vpravo

  2. Kopírovať úryvok: Skopírujte útržok akcie z tably pripojení

  3. Dokončite úpravu vzorca pomocou intellisense a podľa potreby použite vlastnosti odozvy konektora: Dokončite definíciu doplnku v editore

  4. Uloženie

  5. Otestujte doplnok

Prepitné

Ak chcete získať prístup k rôznym vlastnostiam, ktoré odpoveď môže mať, použite funkciu With() na zachytenie celej odpovede z jednej akcie. V nižšie uvedenom príklade je vstupný parameter Location (reťazec) a výstupný parameter Out (reťazec).

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

Osvedčené postupy

Spracovanie chýb s nekonečnými slučkami v automatických doplnkoch s nízkym kódom

Nepíšte vyhlásenie o záplate na automatickom zásuvnom module pri udalosti 'Update', kde záplata prebieha na tej istej tabuľke ako zásuvný modul. To vedie k nekonečným slučkám a zlyhaniam vykonávania doplnkov.

Problematický vzor: Použitie Patch() vzorca spustí ďalšiu aktualizáciu.

Odporúčaný vzor: Namiesto toho použite vzorec Set() , aby ste sa vyhli tomuto problému.

Pozrite si tiež

Doplnky s nízkym kódom Power Fx (ukážka)

  • Last updated on