Vytvorenie vlastnej akcie procesu

Použite vlastné akcie procesu, keď chcete automatizovať skupinu príkazov v systéme. Vlastné akcie procesu rozširujú slovník dostupný pre vývojárov, aby dokázali vyjadriť svoje obchodné procesy. Vlastná akcia procesu používa kľúčové slovesá poskytované systémom, ako je Vytvoriť, Aktualizovať, Vymazať a Priradiť na vytvorenie expresívnejších slovies, ako je Schváliť, Vystupňovať, Smerovať alebo Plánovať. Ak sa zmení definícia obchodného procesu, aj nevývojár môže upraviť vlastnú akciu procesu, a kód nebude potrebné zmeniť.

Poznámka

Ak chcete namiesto použitia návrhára pracovného postupu napísať doplnok na implementáciu logiky pre vlastnú akciu procesu, mali by ste namiesto neho použiť vlastné rozhranie API. Ďalšie informácie: Porovnanie vlastnej akcie procesu a vlastného rozhrania API

Vytvorenie vlastnej akcie procesu

Dôležité

Ak vytvárate vlastnú akciu procesu ako súčasť riešenia, ktoré sa distribuuje, vytvorte ju v kontexte riešenia. Prejdite na Nastavenia > Riešenia a nájdite nespravované riešenie, ktorého bude táto akcia súčasťou. Potom na lište ponúk označte Nový > Proces. Týmto zaistíte, že predpona prispôsobenia priradená názvu akcie bude konzistentná s inými súčasťami v riešení. Po vytvorení akcie nemožno prefix zmeniť.

Podobne, ako pri procesoch pracovného postupu, majú vlastné akcie procesu v dialógovom okne Vytvoriť proces nasledujúce vlastnosti:

  • Názov procesu

    Po zadaní názvu procesu, bude preň vytvorený jedinečný názov odstránením všetkých medzier alebo špeciálnych znakov z názvu procesu.

  • Kategória

    Táto vlastnosť informuje, že ide o proces akcie. Po uložení procesu ho nemôžete zmeniť.

  • Tabuľka

    S procesmi akcií môžete označiť tabuľku a dodať tak kontext pre pracovný postup, ako aj pri iných typoch procesov. Máte však tiež možnosť zvoliť Žiadny (globálne). Tú použite, ak vaša akcia nevyžaduje kontext špecifickej tabuľky. Po uložení procesu ho nemôžete zmeniť.

  • Typ

    Túto vlastnosť použite na výber, či chcete zostaviť novú vlastnú akciu procesu od začiatku, alebo začať s existujúcou šablónou.

Na rozdiel od procesov pracovného nemusíte nastaviť tieto možnosti:

  • Spustiť keď: Akcie sa spustia, keď kód zavolá správu, ktorá bola preň vytvorená.

  • Rozsah: Akcie sa vždy spustia v kontexte volajúceho používateľa.

  • Spustenie na pozadí: Akcie sú vždy pracovné postupy v reálnom čase.

Vlastné akcie procesu majú tiež čosi, čo procesy pracovného postupu nemajú – vstupné a výstupné argumenty.

Poznámka

Môžete povoliť vlastnú akciu procesu z pracovného postupu bez písania kódu. Ďalšie informácie: Vyvolanie vlastných akcií procesu z pracovného postupu.

Úprava vlastnej akcie procesu

Pred upravením je potrebné deaktivovať vlastné akcie procesu.

Môžete upravovať vlastnú akciu procesu vytvorenú ako súčasť nespravovaného riešenia, alebo zahrnutú v riešení nainštalovanom v organizácii. Ak je riešenie spravované, nemusí byť možné ho upraviť. Vydavateľ riešenia má možnosť upraviť spravované vlastnosti tak, aby akciu nainštalovanú so spravovaným riešením nebolo možné upraviť.

Pri uložení akcie sa vytvorí jedinečný názov podľa názvu procesu. Tento jedinečný názov má pridaný prefix prispôsobenia od vydavateľa riešenia. To je názov správy, ktorý vývojár použije v kóde.

Pri úprave akcie máte tieto možnosti:

  • Názov procesu

    Po vytvorení procesu a jedinečného názvu z názvu procesu môžete názov procesu upraviť. Možno budete chcieť použiť názvovú konvenciu, aby ste určité procesy lepšie vyhľadali.

  • Jednoznačný názov

    Pri uložení akcie sa vytvorí jedinečný názov podľa názvu procesu. Tento jedinečný názov má pridaný prefix prispôsobenia od vydavateľa riešenia. To je názov správy, ktorý vývojár použije v kóde. Tento jedinečný názov nemeňte, ak bol proces aktivovaný, a príslušný kód očakáva volanie akcie s týmto názvom.

    Dôležité

    Po aktivácii tejto akcie sa napíše kód používajúci jedinečný názov, ktorý sa nesmie zmeniť bez súčasnej zmeny kódu, ktorý naň odkazuje.

  • Povoliť vrátenie zmien

    Vo všeobecnosti procesy podporujúce transakcie vezmú celú operáciu späť (alebo vrátia zmeny), ak zlyhá ktorákoľvek časť z nich. Existuje niekoľko výnimiek z tohto. Niektoré akcie, ktoré môžu vývojári vytvoriť v kóde inicializovanom vlastnou akciou procesu, nemusia podporovať transakcie. Ak napríklad kód vykoná akciu v iných systémoch mimo rozsah transakcie. Tieto nemožno vziať späť akciou spustenou v aplikácii. Niektoré správy na platforme nepodporujú transakcie. No všetko, čo môžete robiť iba s používateľským rozhraním akcie, transakcie podporuje. Všetky akcie, ktoré sú súčasťou pracovného postupu v reálnom čase, sa považujú za transakcie, no pri akciách máte možnosť výberu.

    Mali by ste sa obrátiť na vývojára, ktorý túto správu použije, a ktorý určí, či to musí alebo nemusí byť transakcia. Vo všeobecnosti by akcia mala byť transakcia, pokiaľ akcie vykonávané podnikovým procesom nedávajú zmysel, kým sa všetky z nich úspešne nedokončia. Klasickým príkladom je presun prostriedkov medzi dvomi bankovými účtami. Ak vyberiete prostriedky z jedného účtu, je potrebné ich vložiť na druhý. Ak niektorý z týchto krokov zlyhá, musia zlyhať obidva.

    Poznámka

    Nemôžete povoliť vrátenie späť, ak sa vlastná akcia procesu vyvolá priamo z pracovného postupu. Vrátenie možno povoliť v prípade, ak akciu spustilo hlásenie webovej služby Power Apps.

  • Aktivovať ako

    Ako pri všetkých procesoch, môžete proces aktivovať ako šablónu a použiť ho ako rozšírený počiatočný bod pre procesy, ktoré sledujú podobný vzor.

  • Definícia argumentov procesu

    V tejto oblasti určíte všetky údaje, ktoré akcia na začiatku očakáva, a ktoré údaje budú z akcie posunuté von. Ďalšie informácie: Definovanie argumentov procesu

  • Pridať etapy a kroky

    Ako pri iných procesoch, môžete určiť, ktoré akcie a kedy sa majú vykonať. Ďalšie informácie: Pridanie fáz a krokov

Definícia argumentov procesu

Keď vývojár používa správy, mohol by začať s niektorými údajmi, ktoré môžu vstúpiť do správy. Ak napríklad chcete vytvoriť nový riadok prípadu, môže ísť o hodnotu názvu prípadu, ktorý sa posunie ako vstupný argument.

Po dokončení správy vývojár môže posunúť niektoré údaje, ktoré boli zmenené alebo vytvorené v správe, inej operácii v kóde. Tento údaj je výstupný argument.

Vstupné aj výstupné argumenty musia mať názov, typ a údaje o tom, či je daný argument vždy povinný. Môžete tiež poskytnúť popis.

Názov správy a údaje o všetkých argumentoch procesu predstavujú podpis pre správu. Po aktivovaní vlastnej akcie procesu a jej používaní v kóde sa tento podpis nesmie zmeniť. Zmenou podpisu dôjde k zlyhaniu každého kódu, ktorý správu používa. Jedinou výnimkou je zmena jedného z parametrov na taký, ktorý nie je vždy povinný.

Môžete zmeniť poradie argumentov ich zoradením alebo posúvaním nahor či nadol, pretože argumenty sú identifikované názvom, nie poradím. Zmenou popisu teda neporušíte kód používajúci správu.

Typy argumentov procesu akcie

Nasledujúca tabuľka popisuje typy argumentov procesu akcie.

Typ Popis
Boolean Hodnota true alebo false.
DateTime Hodnota, ktorá uchováva informácie o dátume a čase.
Desatinné číslo Číselná desatinná hodnota. Používa sa, keď je presnosť veľmi dôležitá.
Tabuľka Riadok pre zadanú tabuľku. Ak označíte tabuľku, povolí sa rozbaľovací zoznam, z ktorého môžete vybrať typ tabuľky.
entityCollection Súbor riadkov tabuľky.
entityReference Objekt, ktorý obsahuje názov, ID a typ záznamu riadka tabuľky, ktorý ho jedinečne identifikuje. Ak zvolíte položku entityReference, povolí sa rozbaľovací zoznam, z ktorého môžete vybrať typ tabuľky.
Float Číselná desatinná hodnota. Používa sa, ak údaje pochádzajú z merania, ktoré nie je absolútne presné.
Integer Celé číslo.
Peniaze Hodnota uchovávajúca údaje o finančnej sume.
Picklist Hodnota predstavujúca možnosť pre atribút OptionSet.
String Textová hodnota.

Poznámka

Hodnoty argumentu entityCollection nemožno nastaviť v používateľskom rozhraní pre podmienky ani akcie. Tieto sa poskytujú na použitie vývojármi vo vlastnom kóde. Ďalšie informácie: Vytváranie vlastných správ

Pridať etapy a kroky

Vlastné akcie procesu sú typ procesu veľmi podobný pracovným postupom v reálnom čase. Všetky kroky, ktoré možno použiť v pracovných postupoch reálneho času, možno použiť v akciách. Informácie o krokoch, ktoré možno použiť v pracovných postupoch reálneho času aj v akciách, nájdete v téme Etapy a kroky pracovného postupu.

Okrem krokov, ktoré môžu byť použité pre kroky pracovného postupu v reálnom čase, akcie majú aj krok priradiť hodnotu. V akciách ich možno použiť iba na nastavenie výstupných argumentov. Pomocou asistenta formulára môžete výstupným argumentom priradiť špecifické hodnoty, alebo skôr hodnoty z riadkov, voči ktorým je akcia spustená, riadky súvisiace s týmto záznamom so vzťahom many-to-one, riadky vytvorené v predchádzajúcom kroku alebo hodnoty, ktoré sú súčasťou samotného procesu.

Spravované vlastnosti

Vlastné akcie procesu majú dve relevantné spravované vlastnosti

Je prispôsobiteľné

Spravovaná vlastnosť Je prispôsobiteľné určuje, či nie niekto, kto si nainštaluje spravované riešenie obsahujúce vlastnú akciu procesu, ho môže upraviť alebo vymazať. Ak chcete, aby bola vlastná akcia procesu upravená alebo odstránená, ak je zahrnutá v spravovanom riešení, mali by ste túto vlastnosť nastaviť na hodnotu pravda.

Je krok vlastného spracovania povolený pre iných vydavateľov

Spravovaná vlastnosť Je krok vlastného spracovania povolený pre iných vydavateľov určuje, či môžu vývojári doplnkov tretích strán zaregistrovať kroky doplnkov v správe vytvorenej vlastnou akciou procesu. Ak je to pravda, spustia sa doplnky zaregistrované kýmkoľvek v tejto správe a môžu upravovať správanie akcie vlastného procesu. Ak je hodnota nepravda, budú sa spúšťať iba kroky doplnkov zaregistrované v rámci riešenia z toho istého vydavateľ riešenia.

Ďalšie kroky

Vyvolanie vlastných akcií procesu z pracovného postupu

Poznámka

Môžete nás informovať o svojich voľbách jazyka pre dokumentáciu? Absolvujte krátky prieskum. (upozorňujeme, že tento prieskum je v angličtine)

Prieskum bude trvať približne sedem minút. Nezhromažďujú sa žiadne osobné údaje (vyhlásenie o používaní osobných údajov).