Vytváření a správa slovníků pro použití se sadami 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.
Slovní zásoba je kolekce definic slovníků, které používají popisné názvy faktů používaných v podmínkách a akcích pravidel. Definice slovníku usnadňují čtení, pochopení a sdílení pravidel v sadě pravidel více lidí v konkrétní obchodní doméně. Vývojáři nástrojů, kteří například zodpovídají za integraci vytváření pravidel do nových nebo existujících aplikací, můžou využívat slovníky. Slovníky překlenou mezeru mezi obchodní sémantikou a implementací.
Tato příručka ukazuje, jak vytvořit a definovat slovníky, které jsou umístěny v úložišti sdílených pravidel pomocí nástroje Microsoft Rules Composer. Můžete vybrat zdroje dat, které chcete použít, vytvořit nový slovník a přidat definice slovníku. Do úložiště pravidel můžete uložit verzi slovníku.
Požadavky
Stáhněte a nainstalujte nástroj Microsoft Rules Composer.
Soubor XML, který obsahuje úložiště pravidel, do kterého chcete přidat slovník.
Jak slovník usnadňuje čtení a pochopení pravidel?
Termíny, které použijete k definování podmínek a akcí pravidel, se často vyjadřují pomocí terminologie specifické pro danou doménu nebo odvětví. Uživatel e-mailu například zapisuje pravidla pomocí výrazů, jako jsou zprávy přijaté od a zprávy přijaté po. Pojišťovací analytik píše pravidla pomocí termínů, jako jsou "rizikové faktory" a "částka pokrytí".
Jako další příklad může proměnná pro stav schválení ukazovat na určitou hodnotu ve schématu XML. Místo vložení této složité reprezentace do pravidla můžete místo toho vytvořit definici slovníku, která je přidružená k této hodnotě proměnné, a jako popisný název použít "Status". Stav pak můžete použít v libovolném počtu pravidel. Technologické artefakty, jako jsou objekty XML a dokumenty XML, které implementují podmínky pravidla a akce pravidel, leží v této terminologii specifické pro doménu. Modul pravidel však může načíst odpovídající data z tabulky, která tato data ukládá.
Podmínky a akce pravidel jsou založeny na zdrojích dat, které můžou obsahovat podrobné, obtížně čitelné informace o vazbě, které uživateli říkají málo nebo nic o tom, na jaké vazby odkazují. Modul pravidel umožňuje vytvářet slovníky, které zjednodušují vývoj pravidel tím, že nabízí intuitivní terminologii specifickou pro doménu, kterou můžete přidružit k podmínkám a akcím pravidel.
Vytvoření slovníku
Otevřete nástroj 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ík fakta vyberte kartu Slovníky.
Na kartě Slovníky najděte složku Slovníky.
Otevřete místní nabídku složky a vyberte Přidat nový slovník.
Nástroj Microsoft Rules Composer vytvoří novou prázdnou slovní zásobu se slovníkem číslovaným 1.0 jako výchozí verzí.
Než budete moct použít slovní zásobu, musí mít slovník razítko verze. Tento požadavek zaručuje, že definice slovníku se nezmění a zachová referenční integritu, což znamená, že všechny sady pravidel, které používají danou konkrétní verzi, neočekávaně selžou kvůli změnám v podkladové slovní zásobě.
Následující tabulka popisuje další klávesové zkratky, které můžete použít k práci se slovníky:
| Příkaz Zástupce | Úloha |
|---|---|
| Přidat novou verzi | Vytvořte novou prázdnou verzi slovníku z vybraného slovníku. Definice slovníku můžete kopírovat z jiných verzí slovníku a vložit je do nové verze. |
| Vložit verzi slovníku | Ve vybrané slovní zásobě vložte dříve zkopírované definice slovníku z jiné verze slovníku jako novou verzi. |
| Odstranění | Odstraní vybranou slovní zásobu a všechny její verze. |
Následující tabulka popisuje další klávesové zkratky, které můžete použít k práci s verzemi slovníku:
| Příkaz Zástupce | Úloha |
|---|---|
| Přidat novou definici | Spusťte Průvodce definicí slovníku a vytvořte novou definici ve vybrané verzi slovníku. |
| Uložit | Uložte změny provedené ve vybrané verzi slovníku a jeho definicích. |
| Dobít | Znovu načtěte vybranou verzi slovníku a její definice, včetně možnosti zahodit všechny aktuální změny provedené v této verzi a obnovit obsah z úložiště pravidel. |
Následující tabulka popisuje další klávesové zkratky, které můžete použít k práci s verzemi slovníku:
| Příkaz Zástupce | Úloha |
|---|---|
| Upravit | Spusťte Průvodce definicí slovníku a změňte vybranou definici. |
| Přejít ke zdrojovému faktu | Pro vybranou definici slovníku přejděte k odpovídajícímu zdrojovému faktu v sestavení .NET nebo schématu XML. |
| Příkaz Zástupce | Úloha |
|---|---|
| Výběr kořenového uzlu | Ze schématu XML, které obsahuje více kořenových uzlů, vyberte kořenový uzel, který se má načíst. |
Další informace o těchto úkolech najdete v následujících částech.
Kopírování verze slovníku
Pokud chcete ve slovníku dělat změny, vytvořte novou verzi slovníku, která bude odrážet změny. Kopii můžete vytvořit z existující verze slovníku, ale s jiným číslem verze.
V okně Průzkumníka faktů otevřete místní nabídku verze slovníku a vyberte Kopírovat.
Otevřete místní nabídku slovníku a vyberte Vložit verzi sady pravidel.
Microsoft Rules Composer vytvoří novou verzi slovníku se stejnými definicemi jako zkopírovaná verze, ale s jiným číslem.
Důležité
Když vytvoříte novou verzi slovníku, pravidla vytvořená pomocí předchozí verze slovníku stále odkazují na předchozí verzi. Nezapomeňte aktualizovat odkazy mezi těmito pravidly a novou verzí slovníku.
Vytvoření prázdné verze slovníku
Po přidání definic do verze slovníku můžete vytvořit novou prázdnou verzi slovníku s jiným číslem a uložit ji, abyste mohli pracovat později.
V okně Průzkumník fakta vyberte kartu Slovníky.
Na kartě Slovníky najděte slovník, ze kterého chcete vytvořit novou verzi.
Otevřete místní nabídku slovníku a vyberte Přidat novou verzi.
Nástroj Microsoft Rules Composer vytvoří novou prázdnou verzi slovníku s jiným číslem.
Otevřete místní nabídku nové verze slovníku a vyberte Uložit.
Definice slovníku teď můžete kopírovat z jiných verzí slovníku a vložit je do nové verze.
Přejmenování slovníku
Než budete moct přejmenovat slovník nebo sadu pravidel, musíte uložit všechno, což znamená všechny verze definic slovníku.
V okně Průzkumník fakta vyberte kartu Slovníky.
Na kartě Slovníky ve složce Slovníky najděte slovník, který chcete přejmenovat.
Vyberte slovník a v okně Vlastnosti upravte název.
Vytvoření definice slovníku
Definici slovníku můžete vytvořit jako konstantní hodnotu, rozsah hodnot, sadu hodnot nebo prvky ze sestavení .NET nebo dokumentu XML. K vytvoření definice slovníku můžete použít Průvodce definicí slovníku.
Alternativně můžete vytvořit novou definici slovníku tak, že vyberete fakt na kartě Třídy .NET nebo na kartě Schémata XML, například nebo člen třídy .NET – přetáhnete fakt na kartu Slovníky .
– například uzel XML,
Pokud vyberete veřejnou proměnnou, jsou možnosti Get a Set stále dostupné, stejně jako v průvodci definicí XML.
Přidání konstantní hodnoty jako definice slovníku
Na kartě Slovníky ve složce Slovníky.
Ve složce Slovníky otevřete místní nabídku pro požadovanou verzi slovníku.
V místní nabídce verze slovníku vyberte Přidat novou definici.
Položky můžete také přetáhnout na kartě Třídy .NET a na kartě Schémata XML.
Spustí se Průvodce definicí slovníku, který vám pomůže vytvořit definici.
V průvodci vyberte konstantní hodnotu, rozsah hodnot nebo sadu hodnot a pak vyberte Další.
Zadejte následující údaje:
Vlastnost Popis Název definice Název definice. Popis Popis definice. Typ definice Pro tento úkol vyberte konstantní hodnotu. Až budete připraveni, vyberte Další.
Zadejte následující údaje:
Vlastnost Popis Typ definice Vyberte datový typ systému pro definici. Zobrazované jméno Zadejte název, který nepřekračuje 512 znaků. Hodnota Zadejte hodnotu konstanty. Až budete hotovi, vyberte Dokončit.
Přidání rozsahu hodnot jako definice slovníku
Na kartě Slovníky ve složce Slovníky.
Ve složce Slovníky otevřete místní nabídku pro požadovanou verzi slovníku.
V místní nabídce verze slovníku vyberte Přidat novou definici.
Položky můžete také přetáhnout na kartě Třídy .NET a na kartě Schémata XML.
Spustí se Průvodce definicí slovníku, který vám pomůže vytvořit definici.
V průvodci vyberte konstantní hodnotu, rozsah hodnot nebo sadu hodnot a pak vyberte Další.
Zadejte následující údaje:
Vlastnost Popis Název definice Název definice. Popis Popis definice. Typ definice Pro tento úkol vyberte Rozsah hodnot. Až budete připraveni, vyberte Další.
V seznamu Typ definice vyberte pro definici systémový datový typ.
V části Krok 1 – Zadejte zobrazovaný název/hodnotu pro oblast s nízkou a vysokou hodnotou, v tabulce vyberte Rozsah nízký a pak vyberte Upravit.
V okně Definice parametru, které se otevře, je k dispozici pouze možnost Použít konstantní hodnotu.
Zadejte konstantní hodnotu, která určuje nižší rozsah, a vyberte OK.
Zopakujte předchozí kroky pro Oblast s vysokou hodnotou, která musí překročit hodnotu Range Low .
V kroku 2 – Zadejte řetězec formátu zobrazení pro oblast, ve vlastnosti Zobrazit formát řetězce zadejte řetězec formátu zobrazení. Pokud se chcete vrátit k výchozímu řetězci formátu zobrazení, vyberte Výchozí.
Poznámka:
Ujistěte se, že formátovací řetězec obsahuje indexy parametrů používající složené závorky, například použití
{0}a{1}použití jako zástupné symboly pro parametry vysokého a nízkého rozsahu.Následující příklad ukazuje ukázkovou definici slovníku pro rozsah hodnot:
Až budete připraveni, vyberte Dokončit.
Přidání sady hodnot jako definice slovníku
Na kartě Slovníky ve složce Slovníky.
Ve složce Slovníky otevřete místní nabídku pro požadovanou verzi slovníku.
V místní nabídce verze slovníku vyberte Přidat novou definici.
Položky můžete také přetáhnout na kartě Třídy .NET a na kartě Schémata XML.
Spustí se Průvodce definicí slovníku, který vám pomůže vytvořit definici.
V průvodci vyberte konstantní hodnotu, rozsah hodnot nebo sadu hodnot a pak vyberte Další.
Zadejte následující údaje:
Vlastnost Popis Název definice Název definice. Popis Popis definice. Typ definice Pro tento úkol vyberte Sadu hodnot. Až budete připraveni, vyberte Další.
Zadejte následující údaje:
Vlastnost Popis Typ definice Vyberte datový typ systému pro definici. Zobrazované jméno Zadejte název, který nepřekračuje 512 znaků. V části Definovat hodnoty je k dispozici pouze možnost Použít konstantní hodnotu .
Pokud chcete přidat člena do sady, zadejte konstantní hodnotu a vyberte Přidat.
Opakujte předchozí krok pro tolik hodnot, kolik chcete zahrnout do sady.
Následující příklad ukazuje více hodnot v sadě:
Pokud chcete přesunout hodnotu v relativním pořadí sady, vyberte ji v poli Hodnoty a pak vyberte Nahoru nebo Dolů.
Pokud chcete ze sady odebrat člena, vyberte v poli Hodnoty hodnotu a vyberte Odebrat.
Po dokončení sady vyberte Dokončit.
Přidání třídy nebo člena třídy .NET jako definice slovníku
Než začnete, nezapomeňte sestavení .NET umístit do místního adresáře do nástroje Microsoft Rules Composer. Pokud aktualizujete sestavení .NET, nezapomeňte aktualizovat odkazy sady pravidel na toto sestavení. Další informace naleznete v tématu Aktualizace odkazů na sestavení .NET.
Na kartě Slovníky ve složce Slovníky.
Ve složce Slovníky otevřete místní nabídku pro požadovanou verzi slovníku.
V místní nabídce verze slovníku vyberte Přidat novou definici.
Třídu nebo člen třídy .NET můžete také přetáhnout z karty Třídy .NET.
Spustí se Průvodce definicí slovníku, který vám pomůže vytvořit definici.
V průvodci vyberte třídu nebo člen třídy .NET a pak vyberte Další.
Zadejte následující údaje:
Vlastnost Popis Název definice Název definice. Popis Popis definice. V části Informace o členu třídy vyberte Procházet.
Vyhledejte a vyberte požadované sestavení a pak vyberte Otevřít.
V poli Vybrat vazbu rozbalte uzel sestavení.
Vyberte třídu nebo rozbalte třídu a vyberte člena třídy a pak vyberte OK.
Zvolte jeden z následujících kroků:
Pokud jako zobrazovaný název vyberete třídu, zadejte název, který nepřesahuje 512 znaků, a vyberte Dokončit.
Teď jste s touto částí hotovi.
Pokud vyberete člena třídy s parametry, vyberte Další.
Zobrazí se stránka Zadat zobrazovaný název – třída .NET nebo definice člena třídy, abyste pro každý parametr zadali hodnotu a formátovací řetězec.
V kroku 1 – Zadejte zobrazovaný název/hodnotu pro každý parametr, v poli Parametry vyberte parametr a pak vyberte Upravit.
Pro hodnotu parametru je k dispozici pouze možnost Použít konstantní hodnotu, takže zadejte konstantní hodnotu.
V kroku 2 – Zadejte řetězec formátu zobrazení ve vlastnosti Řetězec formátu zobrazení zadejte řetězec formátu zobrazení. Pokud se chcete vrátit k výchozímu řetězci formátu zobrazení, vyberte Výchozí.
Poznámka:
Ujistěte se, že formátovací řetězec obsahuje indexy parametrů pomocí složených závorek, například použití
{0}a{1}sloužit jako zástupné symboly parametrů.Opakujte předchozí kroky pro každý parametr ve vašem členu třídy.
Následující příklad ukazuje více parametrů v členu třídy:
Vytvoření definice slovníku ze sestavení .NET
Definice slovníku můžete vytvořit z tříd nebo členů třídy v sestavení .NET a definovat predikáty, argumenty a akce. Než začnete, nezapomeňte sestavení .NET umístit do místního adresáře do nástroje Microsoft Rules Composer. Pokud aktualizujete sestavení .NET, nezapomeňte aktualizovat odkazy sady pravidel na toto sestavení. Další informace naleznete v tématu Aktualizace odkazů na sestavení .NET.
V okně Průzkumník faktů vyberte kartu Třídy .NET.
Z části Sestavení .NET přetáhněte třídu nebo člen třídy do existující definice slovníku, která se zobrazí na kartě Slovníky .
Vytvoření definice slovníku z elementu nebo atributu dokumentu XML
Definice slovníku můžete vytvořit z elementů a atributů XML procházením schémat XSD a přetažením položek do editoru podmínek nebo editoru akcí definovat predikáty, argumenty a akce.
Na kartě Slovníky ve složce Slovníky.
Ve složce Slovníky otevřete místní nabídku pro požadovanou verzi slovníku.
V místní nabídce verze slovníku vyberte Přidat novou definici.
Spustí se Průvodce definicí slovníku, který vám pomůže vytvořit definici.
V průvodci vyberte element dokumentu XML nebo atribut a pak vyberte Další.
Zadejte následující údaje:
Vlastnost Popis Název definice Název definice. Popis Popis definice. V části s informacemi o dokumentu XML vyberte Procházet.
Vyhledejte a vyberte soubor schématu (.xsd) a vyberte prvek dokumentu nebo atribut.
V seznamu Typ vyberte typ, který je kompatibilní s typem vybraného prvku nebo atributu ze schématu.
Poznámka:
Modul neověřuje existenci definovaného prvku a typ dokumentu. Pokud vyhlásíte dokument XML, který nemá element, dojde k chybě za běhu. Pokud vytvrdíte dokument XML s neznámým typem dokumentu, modul dokument jednoduše ignoruje.
Pokud modul nemůže provést platné přetypování mezi zadaným typem a typem vybraného prvku dokumentu nebo atributu, zobrazí se chyba za běhu.
V části Vybrat operaci vyberte typ operace, který označuje, zda chcete získat hodnotu elementu nebo atributu nebo nastavit hodnotu.
Pokud jste se rozhodli nastavit hodnotu, vyberte Další a zadejte formát zobrazení.
Zobrazí se stránka Zadat zobrazovaný název – element dokumentu XML nebo atribut , abyste zadali hodnotu a formátovací řetězec, který se má použít.
V kroku 1 – Zadejte zobrazovaný název/hodnotu pro každý parametr, v poli Parametry vyberte parametr a pak vyberte Upravit.
Pro hodnotu parametru je k dispozici pouze možnost Použít konstantní hodnotu, takže zadejte konstantní hodnotu.
V kroku 2 – Zadejte řetězec formátu zobrazení ve vlastnosti Řetězec formátu zobrazení zadejte řetězec formátu zobrazení. Pokud se chcete vrátit k výchozímu řetězci formátu zobrazení, vyberte Výchozí.
Poznámka:
Ujistěte se, že formátovací řetězec obsahuje indexy parametrů pomocí složených závorek, například použití
{0}a{1}sloužit jako zástupné symboly parametrů.
Až budete hotovi, vyberte Dokončit.
Následující příklad ukazuje podrobnosti definice slovníku na základě elementu dokumentu XML nebo atributu:
Při vytváření definic slovníku pro uzly XML mají výrazy XPath pro vazby podobné výchozí hodnoty na základě pravidel popsaných výše. Tyto hodnoty však můžete upravit v Průvodci definicí slovníku. Změny výrazů se vloží do definice slovníku a promítnou se do všech argumentů pravidel, které vytvoříte z definic slovníku.
