Vytváření pravidel pomocí nástroje Microsoft Rules Composer (Preview)
Platí pro: Azure Logic Apps (Standard)
Důležité
Tato funkce je ve verzi Preview a podléhá dodatečným podmínkám použití pro microsoft Azure Preview.
Pravidla řídí obchodní logiku pro fungování obchodních procesů. Microsoft Rules Composer vám pomůže vytvořit tato pravidla pro použití s projektem Azure Logic Apps Rules Engine a poskytuje vizuální nástroj pro vytváření a správu verzí sad pravidel a slovníků.
Tento průvodce postupy poskytuje přehled o tom, jak pravidla fungují a jak vytvořit pravidlo pomocí nástroje Microsoft Rules Composer.
Požadavky
Stáhněte a nainstalujte nástroj Microsoft Rules Composer.
Pokud máte existující sadu pravidel, na které chcete pracovat, potřebujete soubor XML obsahující tuto sadu pravidel. V opačném případě vám tento průvodce ukáže, jak vytvořit novou sadu pravidel, kterou uložíte jako soubor XML.
Důležité
Pokud váš existující soubor XML závisí na všech sestaveních .NET, nebo pokud sestavení, která používáte k přidání faktů, mají další závislosti, nezapomeňte všechny tyto soubory zachovat ve stejné složce a v adresáři v místním adresáři nástroje Microsoft Rules Composer.
Co je pravidlo?
Pravidlo je deklarativní příkaz, který obsahuje podmínku a akce, ve kterých je podmínka vyhodnocena. Pokud je výsledek pravdivý, modul pravidel provede jednu nebo více akcí. Následující formát definuje syntaxi pravidel v modulu pravidel Azure Logic Apps:
IF <condition> THEN <action>
Následující ukázkové pravidlo určuje, zda provést transakci a použije obchodní logiku porovnáním dvou peněžních hodnot s daty nebo fakty, které používají formu částky transakce a slevy:
POKUD je zakoupená částka větší než množství, pak zákazníkovi poskytněte další slevu.
Podmínka: Logický výraz true-or-false, který obsahuje jeden nebo více predikátů, které jsou použity na fakta. Predikát je klauzule, která obsahuje sloveso a uvádí něco o předmětu. V našem příkladu je predikát větší, než platí pro zakoupenou částku faktu. Tato podmínka se vždy vyhodnotí jako true nebo false. Predikáty můžete kombinovat s logickými operátory AND, OR a NE k vytvoření potenciálně dlouhého logického výrazu, ale vždy se vyhodnotí jako pravda nebo nepravda.
Akce: Akce je funkčním důsledkem vyhodnocení podmínky. Pokud je splněna podmínka pravidla, spustí se odpovídající akce nebo akce. V našem příkladu je další sleva akce, která se stane pouze v případě, že podmínka je pravdivá, což je zakoupená částka KDYŽ je větší než 1 000 USD. Akce jsou reprezentovány ve stroji pravidel Azure Logic Apps voláním metod, nastavením vlastností objektů nebo prováděním operací nastavení v dokumentech XML.
Fakt: Fakt je samostatná část informací o světě, na kterém pravidla fungují. V našem příkladu jsou množství a množství fakty. Fakta můžou pocházet z mnoha zdrojů, jako jsou systémy událostí, objekty v hybridních aplikacích atd., a musí být součástí modulu pravidel v Azure Logic Apps pomocí některého z následujících prvků:
- Objekty .NET, jako jsou metody, vlastnosti a pole.
- Dokumenty XML, jako jsou prvky, atributy a pododdíly dokumentu.
Slovník: Popisný název faktů používaných v podmínkách a akcích. Další informace najdete v tématu Vytváření a správa slovníků.
Následující diagram a oddíly popisují, jak se podmínky, akce a fakta vejdou dohromady:
Microsoft Rules Composer
Nástroj Microsoft Rules Composer můžete použít k vytváření, úpravě, verzi a ukládání pravidel. Případně můžete tyto úlohy provádět programově. Nástroj Rules Composer obsahuje následující prvky uživatelského rozhraní:
| Okno | Popis |
|---|---|
| Průzkumník sady pravidel | Vytvořte sady pravidel, které obsahují jedno nebo více pravidel. |
| Editor podmínek | Vytvořte podmínku pravidla. |
| Editor akcí | Sestavte akce, které se spustí, když se podmínka vyhodnotí jako true. |
| Průzkumník faktů | Vyhledejte fakta XML a .NET a přetáhněte je do editoru podmínek nebo editoru akcí. |
Vytvoření a správa sady pravidel
Sada pravidel je sada pravidel, která seskupíte na základě domény, ohraničeného kontextu nebo libovolné obchodní hranice. Ke správě sad pravidel a pravidel v úložišti pravidel použijte Průzkumníka sady pravidel. Můžete vytvářet, upravovat, testovat nebo odstraňovat sady pravidel a jejich pravidla.
V nástroji Microsoft Rules Composer otevřete nabídku Úložiště pravidel a vyberte Načíst.
Vyhledejte a vyberte soubor XML obsahující úložiště pravidel, které chcete otevřít.
V okně Průzkumníka sady pravidel otevřete místní nabídku RuleSets a vyberte Přidat novou sadu pravidel.
Nástroj Microsoft Rules Composer vytvoří novou prázdnou sadu pravidel s verzí sady pravidel číslo 1.0 jako výchozí.
Uložte sadu pravidel. V nabídce Úložiště pravidel vyberte Uložit, čímž se vytvoří soubor XML pro sadu pravidel.
Následující tabulka popisuje další příkazy Průzkumníka sady pravidel, které můžete použít pro práci se sadami pravidel:
| Úloha | Příkaz |
|---|---|
| Vytvořte novou sadu pravidel. | Přidat novou sadu pravidel |
| Vytvořte novou prázdnou verzi vybrané sady pravidel. Pravidla můžete zkopírovat z jiných verzí a vložit je do nové verze. | Přidat novou verzi |
| Zkopírujte vybranou verzi sady pravidel do schránky. | Kopírování |
| Vložte verzi sady pravidel a její obsah do vybrané sady pravidel. | Pasta |
| Odstraní vybranou verzi sady pravidel. | Odstranění |
| Odstraní vybranou sadu pravidel a všechny její verze. | Odstranění na úrovni nadřazené sady pravidel |
| Znovu načtěte vybranou verzi sady pravidel a její pravidla s možností zahodit všechny aktuální změny v této verzi a obnovit obsah z úložiště pravidel. | Dobít |
| Uložte všechny změny provedené ve vybrané verzi a jejích pravidlech. | Uložit |
| Před použitím projektu stroje pravidel otestujte vybranou verzi sady pravidel. | Testovací sada pravidel |
Následující tabulka popisuje vlastnosti sady pravidel:
| Vlastnost | Hodnota |
|---|---|
| Název | Název sady pravidel. Poznámka: Tuto hodnotu můžete změnit pouze aktualizací vlastnosti Název sady pravidel, nikoli verzí sady pravidel. |
| Aktuální verze | Verze sady pravidel aktuálně vybraná v Průzkumníku sady pravidel. |
| Fact Retriever | Fakt retriever, který se má použít k poskytování faktů pro verzi sady pravidel. Nástroj Microsoft Rules Composer podporuje sestavení schopností a použití nástroje pro načítání faktů k poskytování faktů. Další informace najdete v následující dokumentaci: - Provádění pokročilých úloh u sad pravidel - Vytváření tvůrců faktů a retrieverů |
| Maximální hloubka smyčky provádění | Maximální hloubka algoritmu přesměrování řetězení před vyvolání výjimky smyčky provádění. Výchozí počet smyček je 65 536. |
| Doba trvání překladu | Maximální doba překladu pravidel před vyvolání výjimky vypršení časového limitu překladu. Výchozí doba trvání je 60 000 milisekund. |
| Překladatel | Překladatel, který se má použít k překladu pravidel. Nástroj Microsoft Rules Composer aktuálně podporuje pouze výchozí integrovaný překladač, ale podporuje také rozšiřitelnost pro přidání dalších překladatelů. |
| Popis verze | Popis aktuální verze |
Další informace o práci se sadami pravidel naleznete v tématu Provádění pokročilých úloh u sad pravidel.
Vytvoření a správa pravidla
V nástroji Microsoft Rules Composer v nabídce Úložiště pravidel vyberte Načíst.
Vyhledejte a vyberte soubor XML obsahující úložiště pravidel, na které chcete pracovat.
V okně Průzkumníka sady pravidel vyhledejte verzi sady pravidel, do které chcete přidat pravidlo.
Otevřete místní nabídku pro verzi sady pravidel a vyberte Přidat nové pravidlo.
Otevře se editor pravidel, abyste mohli přidat podmínky a akce.
Následující seznam popisuje způsoby, jak můžete změnit pravidlo:
Vytvořte novou verzi sady pravidel.
Přímo upravte existující verzi sady pravidel. Můžete změnit jednotlivá pravidla, přidat nová pravidla nebo odstranit existující pravidla.
Následující tabulka popisuje všechny klávesové zkratky Průzkumníka pravidel, které můžete použít pro práci s pravidly:
| Úloha | Příkaz Zástupce |
|---|---|
| Ve vybrané verzi sady pravidel vytvořte nové pravidlo. | Přidat nové pravidlo |
| Zkopírujte vybrané pravidlo do schránky. | Kopírování |
| Zkopírujte vybrané pravidlo do schránky a odstraňte pravidlo. | Řezat |
| Vložte pravidlo do vybrané verze sady pravidel. | Pasta |
| Odstraní vybrané pravidlo. | Odstranění |
Následující tabulka popisuje vlastnosti pravidla:
| Vlastnost | Hodnota |
|---|---|
| Název | Název pravidla. |
| Aktivní | Určuje, jestli je pravidlo povolené nebo zakázané. |
| Priorita | Priorita pravidla v sadě pravidel. Čím vyšší je index, tím vyšší je priorita pravidla. Nejprve se spustí akce pro pravidlo s vyšší prioritou. Výchozí hodnota je 0 a představuje střední prioritu. Hodnotu můžete nastavit jako kladnou nebo zápornou. Další informace naleznete v tématu Optimalizace stroje pravidel. |
Zakázání nebo povolení pravidla
Pravidlo můžete nastavit na neaktivní, aby se pravidlo nespustí při spuštění sady pravidel, nebo můžete znovu aktivovat pravidlo, které bylo deaktivováno.
V Průzkumníku sady pravidel vyberte pravidlo.
V okně Vlastnosti nastavte vlastnost Active na některou z následujících hodnot:
- False: Zakázáno
- True: Povoleno
Nastavení priority pravidla
Prioritu pravidla můžete nastavit tak, aby se akce spouštěly před nebo po akcích jiného pravidla s jinou prioritou. Priority jsou relativní, takže všechny akce v pravidle s konkrétním spuštěním priority v pořadí před všemi akcemi v pravidle s hodnotou nižší priority.
V Průzkumníku sady pravidel vyberte pravidlo.
V okně Vlastnosti nastavte prioritu na celočíselnou hodnotu, kterou chcete použít.
Vytvoření nebo úprava podmínky
Pokud chcete vytvořit, upravit nebo zobrazit podmínku, která aktivuje pravidlo, použijte editor podmínek, který je součástí editoru pravidel. Pokud chcete vytvořit podmínku, můžete provést následující úlohy:
Pokud existuje, přidejte předdefinované predikáty nebo predikáty definované uživatelem.
Definujte argumenty v predikátech přetažením položek z okna Průzkumníka faktů.
Zadáním odkazu na argument zadejte vložené hodnoty argumentu.
Přesun predikátů a logických operátorů v rámci podmínky
Poznámka:
Pořadí, ve kterém se predikáty a logické operátory zobrazují, nezjišťují jejich pořadí vyhodnocení.
Odstraňte predikáty a logické operátory z podmínky.
Přidání predikátu do podmínky
V Průzkumníku sady pravidel vyberte pravidlo.
V okně KDYŽ, což je editor podmínek, otevřete místní nabídku Podmínky a zvolte jednu z následujících možností:
Vyberte logický operátor. Z místní nabídky operátoru přidejte predikáty nebo vnořené logické operátory, které chcete vyhodnotit.
Další informace o nastavení logických operátorů najdete v tématu Přidání aritmetických a logických operátorů do pravidel.
V místní nabídce predikátů vyberte předdefinovaný predikát nebo predikát definovaný uživatelem, pokud nějaké máte.
Následující tabulky popisují dostupné výrazy predikátu, které můžete vybrat z místních nabídek predikátů :
Předdefinovaný predikát Popis Po Dočasný predikát, který odpovídá na otázku: "Je čas1 chronologicky po čase2?" Před Časový predikát, který odpovídá na otázku: "Je čas1 chronologicky před časem 2?" Mezi Dočasný predikát, který odpovídá na otázku: "Je čas1 chronologicky mezi časem2 a časem3?" Equal Relační operátor rovnosti. Existuje Predikát existence, který odpovídá na otázku, "Existuje zadaný element XML nebo atribut?" GreaterThan Relační operátor větší než. GreaterThanEqual Relační operátor větší nebo roven operátoru. LessThan Relační operátor menší než. LessThanEqual Relační operátor menší nebo roven operátoru. Utkání Určete, zda regulární výraz existuje v zadaném vstupním řetězci. NotEqual Relační operátor nerovnosti. Rozsah Určete, zda hodnota existuje v rozsahu.
Zadání argumentu pro predikát v podmínce
Postupujte podle těchto kroků, které jsou stejné pro funkci v akci.
Přesunutí logického operátoru nebo predikátu v podmínce
V editoru podmínek proveďte jeden z následujících kroků:
Přetáhněte logický operátor nebo predikát na jiný logický operátor nebo na uzel Podmínky .
Otevřete místní nabídku logického operátoru nebo predikátu a výběrem možnosti Přesunout nahoru nebo Dolů přesuňte položku o jednu pozici nebo úroveň.
Vytvoření nebo úprava akce
Pokud chcete vytvořit, upravit nebo zobrazit akci, která se spustí při splnění podmínky, použijte editor akcí, který je součástí editoru pravidel. Pokud chcete vytvořit akci, můžete provést následující úlohy:
- Pokud existuje, přidejte předdefinované nebo uživatelem definované funkce.
- Definujte argumenty ve funkcích přetažením položek z okna Průzkumníka faktů.
- Zadáním odkazu na argument zadejte vložené hodnoty argumentu.
- Přesunutí funkcí v rámci akce
Přidání funkce
V Průzkumníku sady pravidel vyberte pravidlo.
V okně PAK, což je editor akcí, otevřete místní nabídku Akce a vyberte integrovanou funkci pro přidání akce a argumentu.
Následující tabulka popisuje dostupné funkce, které můžete vybrat z místní nabídky Akce :
Function Popis Assert Přidejte nový fakt do pracovní paměti instance stroje pravidel. Jasný Obnovte pracovní paměť a program instance stroje pravidel. Další informace o pracovní paměti a programu programu naleznete v tématu Optimalizace stroje pravidel. Zastavit se Ukončete zpracování pravidel. Odvolat Odeberte fakt z pracovní paměti instance stroje pravidel. RetractByType Odeberte fakt se zadaným typem z pracovní paměti instance stroje pravidel. Aktualizace Aktualizujte fakt v pracovní paměti instance stroje pravidel.
Další informace najdete v tématu Optimalizace pravidel pomocí řídicích funkcí.
Zadání argumentu pro funkci v akci
Postupujte podle těchto kroků, které jsou stejné pro predikát v podmínce.
Přesunutí funkce v akci
Akce v pravidle se provádějí na základě zadaného pořadí s výjimkou funkcí ovládacích prvků modulu pravidel, které provádějí následující další akce.
- V editoru akcí otevřete místní nabídku akce a výběrem možnosti Přesunout nahoru nebo Dolů přesuňte akci o jednu pozici nebo úroveň.
Zadání argumentu pro predikát v podmínce nebo funkci v akci
V editoru podmínek nebo editoru akcí odpovídajícím způsobem proveďte jeden z následujících kroků:
V predikátu nebo funkci vyberte výchozí argument a zadejte požadovanou hodnotu nebo ji vyberte ze seznamu, pokud je to možné.
V okně Průzkumníka faktů vyberte kartu s termínem, který chcete použít jako argument, a přetáhněte tento termín do argumentu v predikátu nebo funkci v příslušném editoru.
Termín musí mít typ, který predikát nebo funkce očekává. Jinak dojde k chybě.
Pokud chcete nahradit argument hodnotou prázdného řetězce, otevřete místní nabídku argumentu a vyberte Nastavit na prázdný řetězec.
Pokud chcete nahradit argument definicí konstanty null, otevřete místní nabídku argumentu a vyberte Nastavit na hodnotu null.
Poznámka:
Tato možnost se nemusí zobrazit, pokud typ argumentu není typ, který můžete nastavit na hodnotu null.
Pokud chcete k argumentu přidat aritmetický nebo logický operátor, přečtěte si téma Přidání aritmetických a logických operátorů do pravidel.
Vyhledání zdroje položek v podmínce nebo akci
V editoru podmínek nebo akcí odpovídajícím způsobem proveďte jeden z následujících kroků:
Pokud chcete najít definici slovníku v Průzkumníku faktů, který jste použili k vytvoření predikátu v podmínce, funkci v akci nebo argumentu, otevřete místní nabídku pro predikát, funkci nebo argument a vyberte Přejít na slovník.
Chcete-li v Průzkumníku faktů vyhledat člena nebo element XML .NET, který jste použili k vytvoření predikátu v podmínce, funkci v akci nebo argumentu, otevřete místní nabídku pro predikát, funkci nebo argument a vyberte Přejít ke zdrojové faktu.
Odstranění predikátu, logického operátoru nebo akce
V editoru podmínek proveďte jeden z následujících kroků:
Vyberte položku a stiskněte klávesu Delete.
Vyberte položku, například predikát, logický operátor nebo akci, a vyberte Odstranit <typ> položky.
Pokud chcete odstranit argument plus všechny vnořené argumenty a obnovit výchozí definici, otevřete místní nabídku argumentu a vyberte Obnovit argument.
Přidání faktů do pravidel
Můžete zadat odkazy na zdroje dat, které můžete uložit do úložiště pravidel pro následné použití jako fakta v pravidlech a slovních zásobách. Můžete určit sestavení .NET, která mají třídy a členy třídy nebo schémata XSD, která mají elementy a atributy dokumentu XML.
Pokud chcete procházet data, která jste už přidali z sestavení .NET, schématu XSD nebo jako definice slovníku, v okně Průzkumník faktů vyberte kartu Slovníky, kartu Schémata XML nebo kartu Třídy .NET na základě toho, kde požadovaná data existují.
Přetáhněte data z odpovídající karty do požadovaného umístění v editoru podmínek nebo uvnitř akce v editoru akcí.
Přidání sestavení .NET jako zdroje dat pro fakta .NET
V okně Průzkumník faktů vyberte kartu Třídy .NET.
Otevřete místní nabídku pro uzel sestavení .NET a vyberte Procházet.
Vyhledejte a otevřete sestavení .NET, které chcete použít.
V části Sestavení .NET se vybrané sestavení zobrazí společně s jeho třídami a členy, například:
Důležité
Pokud aktualizujete sestavení .NET v místním adresáři, nástroj Microsoft Rules Composer automaticky neaktualizuje sestavení .NET. Postup aktualizace odkazů na aktualizované sestavení naleznete v tématu Aktualizace odkazů na sestavení .NET.
Aktualizace odkazů na sestavení .NET
Pokud přidáte nové sestavení .NET s jiným názvem nebo verzí, musíte aktualizovat sadu pravidel tak, aby odkazovat na nové sestavení. Pro tuto úlohu musíte v nástroji Microsoft Rules Composer vytvořit novou verzi sady pravidel a aktualizovat odkazy na nové sestavení, včetně tříd, metod atd. Pokud chcete načíst aktualizované sestavení, nezapomeňte restartovat nástroj Microsoft Rules Composer.
Pokud vaše aktualizované sestavení .NET používá stejný název, číslo verze atd., stačí přidat nové sestavení pouze do projektu funkce stroje pravidel Azure Logic Apps.
Odebrání sestavení .NET jako zdroje dat
V okně Průzkumník faktů vyberte kartu Třídy .NET.
V části Sestavení .NET otevřete místní nabídku sestavení a vyberte Odebrat.
Přidání schématu XML jako zdroje dat pro fakta XML
V okně Průzkumník fakta vyberte kartu Schémata XML.
Otevřete místní nabídku pro uzel Schémata a vyberte Procházet.
V poli Soubory schématu vyhledejte a vyberte soubor schématu XML (.xsd) a vyberte Otevřít.
V části Schémata se schéma XML zobrazí spolu s jeho elementy XML, například:
Vazby pro elementy XML používané v argumentech
V rozhraní Business Rules Framework je TypedXmlDocument třída Microsoft . Knihovna tříd kompatibilní s rozhraním NET, která představuje typ dokumentu XML a je jednou z tříd, které implementují rozhraní ITypedFact . Tyto třídy se označují jako fakta typu.
Když jako argument v pravidle použijete uzel z dokumentu XML, vytvoří se dva výrazy XPath: vazba selektoru a vazba pole na základě uzlu, který se rozhodnete použít:
Pokud uzel obsahuje podřízené uzly, vytvoří se pro uzel vazba selektoru označovaná také jako vazba XmlDocument , ale nevytvořila se žádná vazba pole.
Pokud uzel nemá podřízené uzly, vytvoří se vazba selektoru označovaná také jako vazba XmlDocument pro nadřazený uzel uzlu. Vazba pole, označovaná také jako vazba XmlDocumentMember , se vytvoří pro samotný uzel. Tato vazba pole je relativní vzhledem k vazbě selektoru.
Před přetažením uzlu XML do argumentu pravidla můžete změnit výchozí výrazy XPath pro uzly XML a nové informace o vazbě se umístí do sady pravidel.
Poznámka:
Při opětovném načtení schématu v nástroji Microsoft Rules Composer je nutné znovu zadat všechny úpravy provedené ve výrazech XPath v nástroji Microsoft Rules Composer.
Předpokládejme například, že máte následující schéma XML:
Pokud v argumentu použijete uzel Příjem , vytvoří se pouze vazba selektoru, protože uzel má podřízené uzly.
V okně Vlastnosti vlastnost XPath Selector uzlu obsahuje následující výchozí výraz XPath:
/*[local-name()='Root' and namespace-uri()='http://LoansProcessor.Case']/*[local-name()='Income' and namespace-uri()='']Pokud v argumentu použijete uzel Název , vytvoří se vazba selektoru i vazba pole.
V okně Vlastnosti se informace o vazbě uzlu zobrazí takto:
Vlastnost Hodnota Pole XPath *[local-name()='Name' and namespace-uri()='']Výběr XPathu /*[local-name()='Root' and namespace-uri()='http://LoansProcessor.Case']