Konfigurace akcí

 

Publikováno: listopad 2016

Platí pro: Dynamics CRM 2015

Můžete povolit vlastní akce z pracovního postupu nebo dialogu, bez nutnosti psaní kódu.Další informace:Vyvolání vlastní akce z pracovního postupu nebo dialogu.

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 provést akce?

• 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 má také něco, co pracovní postupy nemají – vstupní a výstupní argumenty.Další informace:Definování argumentů procesu

V tomto tématu

Vytvoření akce

Úprava akce

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. Tím se přesvědčíte, ž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.

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.

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.

• 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. Ty nelze vrátit zpět pomocí akce spuštěné v aplikaci Microsoft Dynamics 365. Některé zprávy v platformě Dynamics 365 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

  Možnost vrácení zpět není podporována, pokud se vlastní akce vyvolává přímo z pracovního postupu nebo dialogu. Vrácení zpět můžete povolit, pokud se akce spouští pomocí zprávy webové služby aplikace Dynamics 365.

• 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ů procesu

• 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í a kroků

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 a použít. Například chcete-li vytvořit nový záznam případu, můžete mít hodnotu názvu případu, která bude předána jako argument. To by byl 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 musí být definována jako 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. Změna tohoto podpisu způsobí, že 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é.

Změna pořadí argumentů jejich seřazením nebo přesunutím nahoru nebo dolů neznamená žádný rozdíl, protože argumenty jsou rozpoznávány podle názvu a nikoliv podle pořadí. Změna popisu 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
Boolean	Hodnota true nebo false.
DateTime	Hodnota, která ukládá informace o datu a času.
Decimal	Číselná hodnota s desetinnými místy. Používá se, pokud je vyžadována vysoká přesnost.
Entity	Záznam Dynamics 365 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.
Float	Číselná hodnota s desetinnými místy. Použije se, pokud data pocházejí z měření, které není zcela přesné.
Integer	Celé číslo.
Money	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:Vytvoř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 v reálném čase i akce, 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, který se podobá kroku používanému k nastavení proměnných nebo vstupních argumentů v dialogových oknech. 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í akce z pracovního postupu nebo dialogu
Sledování pracovních postupů a akcí v reálném čase
Vytváření a úprava procesů
Procesy pracovního postupu
Dialogy
Toky obchodního procesu
Sledování a správa procesů
Vytvoření vlastních akcí

© 2016 Microsoft Corporation. Všechna práva vyhrazena. Autorská práva