Vytváření nebo úpravy vlastních akcí z pracovního postupu
Toto téma se vztahuje na Dynamics 365 Customer Engagement (on-premises). Verzi Power Apps tohoto tématu naleznete na: Konfigurace vlastních akcí z pracovního postupu
Můžete povolit vlastní akci z pracovního postupu, bez nutnosti psaní kódu. Další informace: Vyvolání vlastních akcí z pracovního postupu
Můžete také vytvořit akci tak, aby ji vývojář mohl použít v kódu nebo můžete potřebovat upravit akci, která byla dříve definována. Podobně jako u pracovních postupů zvažte následující skutečnosti:
Co by měla akce dělat?
Za jakých podmínek by měla být akce provedena?
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 mají také něco, co pracovní postupy nemají – vstupní a výstupní argumenty. Další informace: Definování argumentů procesů
Vytvoření akce
Důležité
Pokud vytváříte akci, 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 akce 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.
Entita
U procesů akcí můžete vybrat entitu, 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čité entity. Tuto vlastnost nelze změnit po uložení procesu.
Typ
Pomocí této vlastnosti můžete zvolit, zda chcete vytvořit novou akci od začátku nebo začít ze stávající šablony.
Úprava akce
Před úpravou procesů je nutné je deaktivovat.
Můžete upravit akci, 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ý název
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 akcí, 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 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 Dynamics 365 Customer Engagement (on-premises).
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í, podmínek a akcí
Stejně jako u ostatních procesů určete, jaké akce mají být provedeny a kdy. Další informace: Přidání fází, podmínek a akcí
Definování argumentů procesu
Pokud vývojář používá zprávu, lze začít s některými daty, která lze předat do zprávy. Chcete-li například vytvořit nový záznam 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 akce 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. |
| Entita | Záznam pro zadanou entitu. Pokud vyberete argument Entity, zobrazí se rozevírací seznam, který umožňuje vybrat typ entity. |
| EntityCollection | Sada záznamů entity. |
| EntityReference | Objekt obsahující název, ID a typ záznamu entity, který jej jednoznačně identifikuje. Pokud vyberete argument EntityReference, zobrazí se rozevírací seznam, který umožňuje vybrat typ entity. |
| Plovoucí desetinná čárka | Čí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. |
| Řetězcové | 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 akcí
Přidání fází a kroků
Akce 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 záznamu, vůči kterému je akce spuštěna, záznamů týkajících se tohoto záznamu s relacemi typu N:1, záznamů vytvořených v předchozím kroku nebo hodnoty, které jsou součástí samotného procesu.
Viz také
Akce
Vyvolání vlastních akcí z pracovního postupu
Sledování pracovních postupů a akcí v reálném čase
Procesy pracovního postupu
Přehled toků obchodního procesu
Monitorování a správa procesů pracovního postupu
Vytvoření vlastních akcí