Konfigurace vlastního procesu z pracovního postupu

Můžete povolit vlastní proces z pracovního postupuv reálném čase bez nutnosti psaní kódu. Další informace: Vyvolání vlastních akcí z pracovního postupu

Můžete také vytvořit akci vlastního procesu 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 procesů pracovních postupů v reálném čase 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 procesů pracovních postupů v reálném čase není třeba nastavit následující možnosti:

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

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

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

Akce vlastního procesu mají také něco, co pracovní postupy v reálném čase nemají – vstupní a výstupní argumenty. Další informace: Definování argumentů procesů

Vytvoření vlastní akce procesu

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.

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

Stejně jako procesy pracovních postupů v reálném čase 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 tabulku, která poskytuje kontext pro pracovní postup v reálném čase 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.

Úprava akce

Před úpravou 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ý název

    Při uložení akce vlastního procesu 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 výjimky: Akce, které mohou vývojáři provádět v kódu iniciovaném akcí vlastního 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 akci vlastního procesu aktivuje zpráva webových služeb Power Apps.
    • Pokud definovaná akce nezmění data, ale pouze načte data, existují určité situace, kdy lze výkon zlepšit deaktivací Povolit vrácení zpět.
  • 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ý řá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 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.
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 tableReference, 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ů

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, přejděte na 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

Používání akcí
Vyvolání vlastních akcí z pracovního postupu
Sledování pracovních postupů a akcí v reálném čase

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ů).