Udalosť OnSave pre formuláre (referenčné informácie o rozhraní API klienta) v modelom riadených aplikáciách

Udalosť formulára OnSave v modelom riadených aplikáciách umožňuje spustiť logiku, overiť údaje alebo zrušiť uloženie pred uložením záznamu. Táto OnSave udalosť sa vyskytne v nasledujúcich prípadoch:

  • Používateľ vyberie tlačidlo Uložiť alebo Obnoviť na paneli príkazov, a to aj v prípade, že sa nezmenili údaje na uloženie.
  • Kód spustí metódu formContext.data.entity.save , a to aj v prípade, že sa nezmenili údaje na uloženie.
  • Používateľ odíde z formulára a vo formulári sa nachádzajú neuložené údaje.
  • Možnosť Automatické ukladanie je povolená 30 sekúnd po zmene údajov a vo formulári sa nachádzajú neuložené údaje.
  • Kód spustí metódu formContext.data.save a vo formulári sú neuložené údaje.
  • Kód spustí metódu formContext.data.refresh , ktorá odovzdá hodnotu true ako prvý parameter a vo formulári sa nachádzajú neuložené údaje.

Poznámka

Záznamy OnSaveo aktiviteudalosti pre stretnutie, opakované stretnutie alebo službu zrušia operáciu ukladania a pomocou Book správy uloží zmenu namiesto Create alebo Update. Z dôvodu tohto správania OnSave a PostSave obsluhy udalostí pre tieto tabuľky nefungujú.

Ak chcete zistiť, na ktoré tlačidlo sa použilo kliknutie na uloženie, použite metódu getSaveMode .

Akciu uloženia môžete zrušiť pomocou metódy preventDefault v rámci objektu argumentov udalosti. Metóda preventDefault je prístupná pomocou metódy getEventArgs , ktorá je súčasťou kontextu spustenia. Kontext spustenia sa automaticky odovzdá obsluhe udalostí formulára.

Podpora asynchrónnej obsluhy udalostí

Udalosť OnSave má možnosť počkať, kým obslužné programy udalostí vrátia sľuby, aby sa vyriešili pred uložením, čo umožňuje OnSave , aby udalosť bola asynchrónna ("asynchrónna").

Udalosť OnSave sa stane asynchrónnou, keď obsluha OnSave udalosti vráti sľub. Uloženie záznamu sa uskutoční po vyriešení každého sľubu vráteného obslužným programom. Pre všetky sľuby, ktoré sa vrátia, existuje 10-sekundový limit pre každý sľub, potom, čo platforma považuje sľuby za načasované. Tento časový limit sa použije na sľub. Ak máme napríklad vrátených päť sľubov, celkový čas čakania je 50 sekúnd.

Ak bude sľub zamietnutý alebo uplynul, operácia ukladania sa bude správať podobne ako aktuálne chyby skriptu. Ak sa vyskytne chyba skriptu alebo zamietnutý sľub alebo obslužný program, použite metódu preventDefault v rámci objektu argumentov udalosti v tomto konkrétnom obslužným programom, ak chcete zabrániť tomu, aby udalosť uloženia nastala.

Operáciu ukladania môžete tiež zrušiť bez ohľadu na chybu v obslužný program alebo nie pomocou metódy preventDefault v rámci objektu argumentov udalosti. Ak sa zavolá táto metóda, udalosť Async OnSave počká, kým sa všetky sľuby urovná, ale uloženie nenastane. Volanie tejto metódy znamená, že logika v rámci .then() funkcie & .catch() sa spustí.

Udalosť OnSave čaká na jeden sľub vrátený pre každú obsluhu. Ak sa vyžadujú viaceré sľuby, odporúča sa zabaliť všetky sľuby v metóde Promise.all() a vrátiť jeden výsledný sľub. Pre viaceré obslužné programy, ktoré vrátia sľub, odporúčame vytvoriť jeden obslužný program, ktorý vyvolá všetky udalosti a vráti jeden sľub, ktorý zabalí všetky požadované sľuby. Touto praxou je minimalizovať časy čakania spôsobené časovým limitom.

Príklad: Kedy použiť asynchrónne obslužné programy OnSave

Zvážte vytvorenie úlohy služby pracovnej objednávky, v ktorej potrebujete overiť, či má vybratá položka zákazníka rovnaké konto uvedené v pracovnej objednávke. Načítanie konta v službe Work Order aj Customer Asset je asynchrónne procesy a pred overením je potrebné dokončovať oba.

V tomto scenári, keďže existuje viacero asynchrónnych procesov a oba volania vrátia jeden prísľub, zabaľte obe metódy do Promise.all() metódy .

Poznámka

Metódu preventDefault môžete použiť iba synchrónne.

Napríklad:

 function myHandler() {
    return Promise.all([getWorkOrderPromise, getCustomerAssetPromise]).then((values) => {
        var workOrder = values[0];
        var customerAsset = values[1];
        // Perform validation
        if (isValid(workOrder, customerAsset)) {
            return Promise.resolve();
        }
        return Promise.reject(new Error("Validation failed for the work order and customer asset"));
   });
 }

Povolenie asynchrónnych obslužných programu OnSave pomocou nastavenia aplikácie

Ak chcete použiť asynchrónne obslužné programy, zapnite funkciu prostredníctvom nastavenia aplikácie:

  1. Prejdite do systému https://make.powerapps.com.

  2. Skontrolujte, či ste vybrali správne prostredie.

  3. Na ľavej navigačnej table vyberte položku Aplikácie.

  4. Vyberte aplikáciu, vyberte položku ... (tri bodky) a potom vyberte položku Upraviť.

  5. Na paneli príkazov vyberte položku Nastavenia .

  6. Keď sa otvorí dialógové okno, vyberte položku Funkcie.

  7. Zapnite asynchrónne zapnutie obslužného programu ukladania.

  8. Vyberte položku Uložiť.

    Snímka obrazovky s nastavením funkcie asynchrónneho obslužného programu, ktorá je zapnutá v dialógovom okne Nastavenia aplikácie.

Zakázanie časového limitu asynchrónneho obslužného programu OnSave

Keď použijete asynchrónny OnSave obslužný program, formulár čaká, kým sa splnia sľub, ktorý vráti obslužný program. Aby sa zabezpečilo, že ukladanie formulára sa dokončí včas, obslužný program zobrazí výnimku časového limitu po 10 sekundách, aby ste vedeli vyladiť asynchrónny OnSave obslužný program, aby ste zlepšili výkon.

Existujú scenáre, v ktorých je potrebné pozastavenie obslužného OnSave programu na dlhšie ako 10 sekúnd. Príkladom je otvorenie dialógového okna a čakanie na zadanie používateľa, než bude pokračovať v ukladaní. Ak chcete zabezpečiť, aby asynchrónne operácie čakali, kým sa vyrieši sľub, použite metódu disableAsyncTimeout .

Poznámka

Pred akýmkoľvek príkazom čakania alebo asynchrónnymi volaniami musíte zavolať disableAsyncTimeout .

Napríklad:

async function myHandler(context) {  
     context.getEventArgs().disableAsyncTimeout();
     // The 10000ms time out will not be disabled if the above line does not come before all async awaits
     await Xrm.Navigation.openConfirmDialog({ text: "Are you sure you want to save?" });
 }

Keď zavoláte disableAsyncTimeout, časový limit pre tento obslužný program sa nepoužije. Naďalej čaká na splnenie sľubu tohto obslužným programom.

Tento vzor môže ovplyvniť výkon uloženia formulára.

Udalosť OnSave pre mriežky
Udalosti (odkaz na rozhranie API klienta)
Udalosti vo formulároch a mriežkach v aplikáciách riadených modelom