Vytvoření vlastní akce procesu

Vlastní akce procesu použijte, když chcete v systému automatizovat sérií příkazů. Pomocí vlastních akcí procesu lze rozšířit slovník, který je k dispozici vývojářům pro vyjádření obchodních procesů. Vlastní akce procesu využívají základní příkazy jako Vytvořit, Aktualizovat, Odstranit a Přiřadit poskytované systémem k vytvoření expresivnějších příkazů jako Schválit, Eskalovat, Směrovat nebo Naplánovat. Pokud se změní definice obchodního procesu, pak i uživatel, který není vývojář, může upravit vlastní akci procesu, aniž by bylo nutné měnit kód.

Poznámka

Pokud máte v úmyslu napsat modul plug-in k implementaci vaší logiky pro vlastní akci procesu namísto použití návrháře pracovního postupu, měli byste místo toho použít vlastní API. Více informací: Porovnejte vlastní akci procesu a vlastní API

Vytvoření vlastní akce procesu

Důležité

Pokud vytváříte vlastní akci procesu, která bude součástí řešení, jež bude distribuováno, vytvořte ji v kontextu řešení. Přejděte na Nastavení > Řešení a vyhledejte nespravované řešení, jehož bude tato akce součástí. V řádku nabídek vyberte Nový > Proces. To zaručuje, že předpona vlastního nastavení přidružená k názvu akce bude konzistentní s ostatními součástmi v řešení. Po vytvoření akce nelze předponu změnit.

Stejně jako pracovní postupy mají i vlastní akce procesu následující vlastnosti v dialogovém okně Vytvořit proces:

• Název procesu

  Po zadání názvu procesu bude vytvořen jedinečný název odebráním mezery nebo zvláštních znaků z názvu procesu.

• Kategorie

  Tato vlastnost určuje, že se jedná o proces akce. Tuto vlastnost nelze změnit po uložení procesu.

• Tabulka

  U procesů akcí můžete vybrat tabulku, která poskytuje kontext pro pracovní postup stejně jako jiné typy procesů, ale také máte možnost zvolit Žádná (globální). Toto použijte, pokud vaše akce nevyžaduje kontext určitou tabulku. Tuto vlastnost nelze změnit po uložení procesu.

• Typ

  Pomocí této vlastnosti můžete zvolit, zda chcete vytvořit novou vlastní akci procesu od začátku nebo začít ze stávající šablony.

Na rozdíl od pracovních postupů není třeba nastavit následující možnosti:

• Spustit při: Akce se spustí, pokud kód zavolá zprávu vygenerovanou pro akce.

• Rozsah: Akce jsou vždy spuštěny v kontextu volajícího uživatele.

• Spustit na pozadí: Akce jsou vždy pracovními postupy v reálném čase.

Akce vlastního procesu mají také něco, co pracovní postupy nemají – vstupní a výstupní argumenty.

Poznámka

Můžete povolit vlastní akci procesu z pracovního postupu, bez nutnosti psaní kódu. Další informace: Vyvolání vlastních akcí procesu z pracovního postupu

Úprava a vytvoření vlastní akce procesu

Před úpravou vlastních akcí procesů je nutné je deaktivovat.

Můžete upravit akci vlastního procesu, která byla vytvořena jako součást nespravovaného řešení nebo součást řešení nainstalovaného ve vaší organizaci. Pokud řešení představuje spravované řešení, nemusí jej být možné upravovat. Vydavatel řešení má možnost upravit spravované vlastnosti tak, aby akce nainstalovaná se spravovaným řešením nemohla být upravena.

Při uložení akce bude vytvořen jedinečný název na základě názvu procesu. Tento jedinečný název má předponu vlastního nastavení přidanou od vydavatele řešení. Toto je název zprávy, který vývojář použije v kódu.

Při úpravě akce máte k dispozici následující možnosti:

• Název procesu

  Po vytvoření procesu a vygenerování jedinečného názvu z názvu procesu můžete upravit název procesu. Můžete chtít použít konvenci pojmenování, aby bylo usnadněno vyhledávání konkrétních procesů.

• Jedinečné jméno

  Při uložení akce bude vytvořen jedinečný název na základě názvu procesu. Tento jedinečný název má předponu vlastního nastavení přidanou od vydavatele řešení. Toto je název zprávy, který vývojář použije v kódu. Neměňte tento jedinečný název, pokud byl proces aktivován a kód očekává volání akce pomocí tohoto názvu.

  Důležité

  Jakmile je akce aktivována a kód je napsán tak, aby používal jedinečný název, nesmí být jedinečný název změněn bez změny kódy, na který odkazuje.

• Povolit vrácení zpět

  Procesy, které podporují transakce, obvykle „zruší“ (nebo vrátí) celou operaci, pokud kterákoli jejich část selže. Existují však některé výjimky: Některé akce, které mohou vývojáři provádět v kódu iniciovaném vlastní akcí procesu, nemusí podporovat transakce. Například pokud kód provádí akce v jiných systémech, které jsou mimo rámec transakce. Nelze je vrátit zpět pomocí akce spuštěné v aplikaci. Některé zprávy v platformě nepodporují transakce. Ale vše, co lze provádět pouze pomocí uživatelského rozhraní akce, bude podporovat transakce. Všechny akce, které jsou součástí pracovního postupu v reálném čase, jsou zohledněny v transakci, ale u akcí máte možnost to odmítnout.

  Měli byste požádat o radu vývojáře, který bude používat tuto zprávu, zda musí být obsažena v transakci či nikoliv. Obecně by akce měla být v transakci, jestliže akce prováděné obchodním procesem nedávají smysl, pokud nejsou všechny z nich úspěšně dokončeny. Klasickým příkladem je převod prostředků mezi dvěma bankovními účty. Pokud vyberete prostředky z jednoho účtu, musíte je vložit na jiný účet. Pokud některá z akcí selže, musí selhat obě akce.

  Poznámka

  Vrácení zpět nelze povolit, pokud se vlastní akce procesu vyvolává přímo z pracovního postupu. Vrácení zpět můžete povolit, pokud se akce spouští pomocí zprávy webové služby aplikace Power Apps.

• Aktivovat jako

  Stejně jako u všech procesů můžete aktivovat proces jako šablonu a použít ji jako rozšířený výchozí bod pro procesy, které mají podobný vzor.

• Definování argumentů procesu

  V této oblasti zadáte jakákoli data, u kterých akce očekává, že se spustí, a také data, která budou předána mimo akci. Další informace: Definování argumentů procesů

• Přidání fází a kroků

  Stejně jako u ostatních procesů určete, jaké akce mají být provedeny a kdy. Další informace: Přidání fází a kroků

Definování argumentů procesu

Pokud vývojáři používají zprávy, lze začít s některými daty, která lze předat do zprávy. Chcete-li například vytvořit nový řádek případu, můžete mít hodnotu názvu případu, která se předá jako vstupní argument.

Po dokončení zprávy může vývojář potřebovat předat některá data, která byla změněna nebo vygenerována zprávou, do jiné operace v kódu. Tato data jsou výstupní argument.

Vstupní i výstupní argumenty musí mít název, typ a některé informace o tom, zda je argument vždy vyžadován. Můžete také zadat popis.

Název zprávy a informace o všech argumentech procesu představují podpis zprávy. Po aktivaci vlastní akce procesu a jejím použití v kódu se nesmí podpis změnit. Pokud se změna tohoto podpisu změní, jakýkoli kód, který zprávu používá, selže. Jedinou výjimkou může být změna jednoho z parametrů tak, že to není vždy nutné.

Pořadí argumentů můžete změnit jejich seřazením nebo přesunutím nahoru nebo dolů, protože argumenty jsou rozpoznávány podle názvu a nikoliv podle pořadí. Změna popisu také nezpůsobí přerušení kódu pomocí zprávy.

Typy argumentů procesu akce

Následující tabulka popisuje typy argumentů procesu akce.

Typ	Popis
Logická hodnota	Hodnota true nebo false.
Datum a čas	Hodnota, která ukládá informace o datu a času.
Desetinné číslo	Číselná hodnota s desetinnými místy. Používá se, pokud je vyžadována vysoká přesnost.
Tabulka	Řádek pro zadanou tabulku. Pokud vyberete tabulku, zobrazí se rozevírací seznam, který umožňuje vybrat typ tabulky.
entityCollection	Kolekce řádků tabulky.
entityReference	Objekt obsahující název, ID a typ řádku tabulky, který jej jednoznačně identifikuje. Pokud vyberete argument entityReference, zobrazí se rozevírací seznam, který umožňuje vybrat typ tabulky.
Float	Číselná hodnota s desetinnými místy. Použije se, pokud data pocházejí z měření, které není zcela přesné.
Celé číslo	Celé číslo.
Peněžní částka	Hodnota, která ukládá data o peněžní částce.
Picklist	Hodnota, která představuje možnost pro atribut OptionSet.
String	Textová hodnota.

Poznámka

Hodnoty argumentu entityCollection nelze nastavit v uživatelském rozhraní pro podmínky nebo akce. Ty jsou k dispozici pro použití vývojáři ve vlastním kódu. Další informace: Vytváření vlastních zpráv

Přidání fází a kroků

Vlastní akce procesu jsou typem procesu, který je velmi podobný pracovním postupům v reálném čase. Všechny kroky, které lze použít v rámci pracovních postupů v reálném čase, lze použít v akcích. Informace o krocích, které lze použít pro pracovní postupy i akce v reálném čase, naleznete v tématu Fáze a kroky pracovního postupu.

Kromě kroků, které lze použít pro pracovní postupy v reálném čase, mají akce také krok Přiřadit hodnotu. U akcí je lze použít pouze k nastavení výstupních argumentů. Pomocí asistenta formulářů můžete nastavit výstupní argumenty na určité hodnoty nebo spíše na hodnoty ze řádku, vůči kterému je akce spuštěna, řádků týkajících se tohoto řádku s relacemi typu N:1, řádků vytvořených v předchozím kroku nebo hodnoty, které jsou součástí samotného procesu.

Spravované vlastnosti

Akce vlastního procesu mají dvě relevantní spravované vlastnosti

Přizpůsobitelné

Spravovaná vlastnost Je přizpůsobitelný řídí, zda ji může upravovat nebo mazat někdo, kdo si nainstaluje spravované řešení obsahující akci vlastního procesu. Pokud si přejete, aby byla akce vlastního procesu upravena nebo odstraněna, když je zahrnuta v spravované řešení, měli byste tuto vlastnost nastavit na true.

Je krok vlastního zpracování povolený pro jiné vydavatele

Spravovaná vlastnost Je krok vlastního zpracování povolen pro ostatní vydavatele řídí, zda vývojáři modulů plug-in třetích stran mohou registrovat kroky modulu plug-in ve zprávě vytvořené akcí vlastního procesu. Pokud je to pravda, spustí se doplňky zaregistrované kýmkoli v této zprávě a mohou upravit chování akce vlastního procesu. Pokud je false, budou spuštěny pouze kroky modulů plug-in registrované v řešení ze stejného vydavatel řešení.

Další kroky

Vyvolání vlastních akcí procesu z pracovního postupu

Poznámka

Můžete nám sdělit, jaké máte jazykové preference pro dokumentaci? Zúčastněte se krátkého průzkumu. (upozorňujeme, že tento průzkum je v angličtině)

Průzkum bude trvat asi sedm minut. Nejsou shromažďovány žádné osobní údaje (prohlášení o zásadách ochrany osobních údajů).