Vytváranie a úprava vlastných akcií z pracovného postupu

Táto téma sa vzťahuje na Dynamics 365 Customer Engagement (on-premises). Informácie o verzii Power Apps v rámci tejto témy nájdete v článku: Nakonfigurujte vlastné akcie z pracovného toku

Môžete povoliť vlastnú akciu z pracovného postupu bez písania kódu. Ďalšie informácie: Vyvolajte vlastné akcie z pracovného toku.

Môžete tiež vytvoriť akciu, aby ju vývojár mohol použiť v kóde, alebo možno budete potrebovať upraviť akciu, ktorá bola predtým definovaná. Podobne ako pri procesoch pracovného postupu zvážte toto:

• Čo by mala táto akcia robiť?

• Za akých podmienok by sa mala akcia vykonať?

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

• Spustiť keď: Akcie sa začnú, keď kód zavolá správu, ktorá je pre nich vygenerovaná.

• Rozsah: Akcie sa vždy spúšťajú v kontexte volajúceho používateľa.

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

Akcie má tiež, čosi čo procesy pracovného postupu nemajú – vstupné a výstupné argumenty. Ďalšie informácie: Definujte argumenty procesu

Vytvorenie akcie

Dôležité

Ak vytvárate akciu 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 súčasťou bude táto akcia. Potom na paneli s ponukami vyberte Nový>Spracovať. 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 procesy pracovného toku, aj akcie majú 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ť.

Entita
Pri procesoch akcií môžete vybrať entitu, ktorá poskytne kontext pre pracovný tok, rovnako ako iné typy procesov, ale máte tiež možnosť vybrať možnosť Žiadne (globálne). Tú použite, ak vaša akcia nevyžaduje kontext špecifickej entity. Po uložení procesu ho nemôžete zmeniť.

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

Upravenie akcie

Pred upravením je potrebné proces vypnúť.

Môžete editovať akciu 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.

Jedineč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 späť
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 akciou, 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, ak sa vlastná akcia vyvolá priamo z pracovného postupu. Vrátenie možno povoliť v prípade, ak akciu spustilo hlásenie webovej služby Dynamics 365 Customer Engagement (on-premises).

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.

Definujte procesné argumenty
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: Definujte argumenty procesu

Pridajte fázy, podmienky a akcie
Ako pri iných procesoch, môžete určiť, ktoré akcie a kedy sa majú vykonať. Viac informácií: Pridajte fázy, podmienky a akcie

Definícia argumentov procesu

Keď vývojár použije správu, môže začať s niektorými údajmi, ktoré môžu vstúpiť do správy. Ak napríklad chcete vytvoriť nový záznam 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í akcie 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	A true alebo false hodnota.
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á.
Entita	Záznam pre zadanú entitu. Ak zvolíte položku Entita, povolí sa rozbaľovací zoznam, z ktorého môžete vybrať typ entity.
EntityCollection	Kolekcia záznamov entity.
EntityReference	Objekt, ktorý obsahuje názov, ID a typ záznamu entity, ktorý ho jedinečne identifikuje. Ak zvolíte položku EntityReference, povolí sa rozbaľovací zoznam, z ktorého môžete vybrať typ entity.
Pohyblivé	Čí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 argumentov EntityCollection nie je možné nastaviť v používateľskom rozhraní pre podmienky alebo akcie. Tieto sa poskytujú na použitie vývojármi vo vlastnom kóde. Viac informácií: Vytvorte si vlastné akcie

Pridať etapy a kroky

Akcie 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ť pre pracovné toky a akcie v reálnom čase, nájdete v časti Fázy a kroky pracovného toku.

Okrem krokov, ktoré možno použiť pre pracovné postupy v reálnom čase, majú akcie aj Hodnotu priradenia krok. 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 zo záznamov, voči ktorým je akcia spustená, záznamy súvisiace s týmto záznamom so vzťahom many-to-one, záznamy vytvorené v predchádzajúcom kroku alebo hodnoty, ktoré sú súčasťou samotného procesu.

Pozrite tiež:

Akcie
Vyvolajte vlastné akcie z pracovného toku
Monitorovanie pracovných tokov a akcií v reálnom čase
Pracovné procesy
Prehľad tokov obchodných procesov
Monitorujte a spravujte procesy pracovného toku
Vytvorte si vlastné akcie