Skapa och hantera vokabulärer som ska användas med regeluppsättningar med hjälp av Microsoft Rules Composer (förhandsversion)
Gäller för: Azure Logic Apps (Standard)
Viktigt!
Den här funktionen är i förhandsversion och omfattas av kompletterande användningsvillkor för Förhandsversioner av Microsoft Azure.
Ett ordförråd är en samling ordförrådsdefinitioner som använder egna namn för fakta som används i regelvillkor och åtgärder. Ordförrådsdefinitioner gör regler i regeluppsättningen enklare att läsa, förstå och dela av flera personer i en specifik affärsdomän. Till exempel kan verktygsutvecklare som ansvarar för att integrera regelredigering i nya eller befintliga program använda vokabulärer. Vokabulärer överbryggar klyftan mellan affärssemantik och implementering.
Den här guiden visar hur du skapar och definierar vokabulärer som placeras i det delade regelarkivet med hjälp av Microsoft Rules Composer. Du kan välja de datakällor som ska användas, skapa ett nytt ordförråd och lägga till ordförrådsdefinitioner. Du kan spara en version av ditt ordförråd i regelarkivet.
Förutsättningar
Ladda ned och installera Microsoft Rules Composer.
XML-filen som innehåller regelarkivet där du vill lägga till ett ordförråd.
Hur gör ett ordförråd regler lättare att läsa och förstå?
De termer som du använder för att definiera regelvillkor och åtgärder uttrycks ofta med hjälp av domän- eller branschspecifik nomenklatur. Till exempel skriver en e-postanvändare regler med termer som "meddelanden som tagits emot från" och "meddelanden som tagits emot efter". En försäkringsföretagsanalytiker skriver regler med termer som "riskfaktorer" och "täckningsbelopp".
Som ett annat exempel kan en variabel för godkännandestatus peka på ett visst värde i ett XML-schema. I stället för att infoga den här komplexa representationen i en regel kan du i stället skapa en ordförrådsdefinition som är associerad med variabelvärdet och använda "Status" som eget namn. Du kan sedan använda "Status" i valfritt antal regler. Teknikartefakter, till exempel XML-objekt och XML-dokument, som implementerar regelvillkor och regelåtgärder ligger under den här domänspecifika terminologin. Regelmotorn kan dock hämta motsvarande data från tabellen som lagrar dessa data.
Regelvillkor och åtgärder baseras på datakällor som kan ha detaljerad, svårläst bindningsinformation, som talar om för användaren lite eller ingenting om vad bindningarna refererar till. Regelmotorn ger dig möjlighet att skapa ordförråd som förenklar regelutvecklingen genom att erbjuda intuitiv, domänspecifik terminologi som du kan associera med regelvillkor och åtgärder.
Skapa ett ordförråd
Öppna Microsoft Rules Composer. På menyn Regelarkiv väljer du Läs in.
Leta upp och välj den XML-fil som innehåller det regelarkiv som du vill arbeta med.
I fönstret Faktautforskaren väljer du fliken Vokabulärer .
Leta reda på mappen Vokabulärer på fliken Vokabulärer.
Öppna mappens snabbmeny och välj Lägg till nytt ordförråd.
Microsoft Rules Composer skapar ett nytt tomt ordförråd med en ordförrådsversion med 1.0 som standardversion.
Innan du kan använda ett ordförråd måste vokabulären ha en versionsstämpel. Det här kravet garanterar att ordförrådsdefinitionerna inte ändras och bevarar referensintegriteten, vilket innebär att alla regeluppsättningar som använder den specifika versionen inte oväntat misslyckas på grund av ändringar i det underliggande ordförrådet.
I följande tabell beskrivs andra genvägskommandon som du kan använda för att arbeta med vokabulärer:
| Genvägskommando | Uppgift |
|---|---|
| Lägg till ny version | Skapa en ny tom ordförrådsversion från det valda ordförrådet. Du kan kopiera ordförrådsdefinitioner från andra ordförrådsversioner och klistra in dem i den nya versionen. |
| Klistra in ordförrådsversion | I det valda ordförrådet klistrar du in de tidigare kopierade ordförrådsdefinitionerna från en annan ordförrådsversion som en ny version. |
| Ta bort | Ta bort den valda vokabulären och alla dess versioner. |
I följande tabell beskrivs andra genvägskommandon som du kan använda för att arbeta med ordförrådsversioner:
| Genvägskommando | Uppgift |
|---|---|
| Lägg till ny definition | Starta guiden Ordförrådsdefinition för att skapa en ny definition i den valda ordförrådsversionen. |
| Spara | Spara ändringarna i den valda ordförrådsversionen och dess definitioner. |
| Reload | Läs in den valda ordförrådsversionen och dess definitioner igen, inklusive alternativet att ignorera eventuella aktuella ändringar som gjorts i den versionen och återställa innehållet från regelarkivet. |
I följande tabell beskrivs andra genvägskommandon som du kan använda för att arbeta med ordförrådsversioner:
| Genvägskommando | Uppgift |
|---|---|
| Modify (Ändra) | Starta guiden Ordförrådsdefinition för att ändra den valda definitionen. |
| Gå till källfakta | För den valda ordförrådsdefinitionen går du till motsvarande källfakta i ett .NET-sammansättnings- eller XML-schema. |
| Genvägskommando | Uppgift |
|---|---|
| Välj rotnod | Från ett XML-schema som innehåller flera rotnoder väljer du en rotnod som ska läsas in. |
Följande avsnitt innehåller mer information om dessa uppgifter.
Kopiera en ordförrådsversion
När du vill göra ändringar i ett ordförråd skapar du en ny ordförrådsversion som återspeglar ändringarna. Du kan skapa en kopia från en befintlig vokabulärversion men med ett annat versionsnummer.
I fönstret Faktautforskaren öppnar du snabbmenyn för ordförrådsversionen och väljer Kopiera.
Öppna snabbmenyn för vokabulären och välj Klistra in regelUppsättningsversion.
Microsoft Rules Composer skapar en ny ordförrådsversion med samma definitioner som den kopierade versionen men med ett annat tal.
Viktigt!
När du skapar en ny ordförrådsversion refererar reglerna som skapats med en tidigare ordförrådsversion fortfarande till den tidigare versionen. Se till att du uppdaterar referenserna mellan dessa regler och den nya ordförrådsversionen.
Skapa en tom ordförrådsversion
När du har lagt till definitioner i en vokabulärversion kan du skapa en ny tom ordförrådsversion med ett annat nummer och spara den versionen så att du kan arbeta med den senare.
I fönstret Faktautforskaren väljer du fliken Vokabulärer .
På fliken Vokabulärer letar du reda på vokabulären som du vill skapa en ny version från.
Öppna snabbmenyn för vokabulären och välj Lägg till ny version.
Microsoft Rules Composer skapar en ny tom ordförrådsversion med ett annat tal.
Öppna snabbmenyn för den nya ordförrådsversionen och välj Spara.
Nu kan du kopiera ordförrådsdefinitioner från andra ordförrådsversioner och klistra in dem i den nya versionen.
Byt namn på ett ordförråd
Innan du kan byta namn på ett ordförråd eller en regeluppsättning måste du spara allt, vilket innebär alla versioner av ordförrådsdefinitionerna.
I fönstret Faktautforskaren väljer du fliken Vokabulärer .
På fliken Vokabulärer går du till mappen Vokabulärer och letar upp det ordförråd som du vill byta namn på.
Välj vokabulären och redigera namnet i fönstret Egenskaper .
Skapa en ordförrådsdefinition
Du kan skapa en ordförrådsdefinition som ett konstant värde, ett värdeintervall, en uppsättning värden eller element från en .NET-sammansättning eller ett XML-dokument. Om du vill skapa en ordförrådsdefinition kan du använda guiden Ordförrådsdefinition.
Du kan också skapa en ny vokabulärdefinition genom att välja ett faktum från fliken .NET-klasser eller XML-scheman , till exempel eller en medlem i en .NET-klass, och dra fakta till fliken Vokabulärer .
– till exempel en XML-nod,
Om du väljer en offentlig variabel är alternativen Hämta och Ange fortfarande tillgängliga, precis som i XML-definitionsguiden.
Lägga till ett konstant värde som en ordförrådsdefinition
På fliken Vokabulärer i mappen Vokabulärer .
Öppna snabbmenyn för den ordförrådsversion som du vill använda i mappen Vokabulärer.
I snabbmenyn för ordförrådsversionen väljer du Lägg till ny definition.
Du kan också dra objekt från fliken .NET-klasser och fliken XML-scheman .
Guiden Ordförrådsdefinition startas för att hjälpa dig att skapa definitionen.
I guiden väljer du Konstant värde, Värdeintervall eller Värdeuppsättning och väljer sedan Nästa.
Tillhandahåll följande information:
Property beskrivning Definitionsnamn Definitionens namn. Beskrivning Definitionens beskrivning. Definitionstyp För den här uppgiften väljer du Konstant värde. När du är klar väljer du Nästa.
Tillhandahåll följande information:
Property beskrivning Definitionstyp Välj en systemdatatyp för definitionen. Visningsnamn Ange ett namn som inte överskrider 512 tecken. Värde Ange ett värde för konstanten. När du är klar väljer du Slutför.
Lägga till ett värdeintervall som en ordförrådsdefinition
På fliken Vokabulärer i mappen Vokabulärer .
Öppna snabbmenyn för den ordförrådsversion som du vill använda i mappen Vokabulärer.
I snabbmenyn för ordförrådsversionen väljer du Lägg till ny definition.
Du kan också dra objekt från fliken .NET-klasser och fliken XML-scheman .
Guiden Ordförrådsdefinition startas för att hjälpa dig att skapa definitionen.
I guiden väljer du Konstant värde, Värdeintervall eller Värdeuppsättning och väljer sedan Nästa.
Tillhandahåll följande information:
Property beskrivning Definitionsnamn Definitionens namn. Beskrivning Definitionens beskrivning. Definitionstyp För den här uppgiften väljer du Värdeintervall. När du är klar väljer du Nästa.
I listan Definitionstyp väljer du en systemdatatyp för definitionen.
Under Steg 1 – Ange visningsnamnet/värdet för Intervall låg och Intervall hög i tabellen väljer du Intervall Låg och sedan Redigera.
I rutan Parameterdefinition som öppnas är endast alternativet Använd konstant värde tillgängligt.
Ange ett konstant värde för att ange det lägre intervallet och välj OK.
Upprepa föregående steg för Range High, som måste överskrida värdet För lågt intervall.
Under Steg 2 – Ange visningsformatsträngen för intervallet anger du strängsträngen visningsformat i strängegenskapen Visningsformat . Om du vill återgå till standardsträngen för visningsformat väljer du Standard.
Kommentar
Kontrollera att formatsträngen innehåller parameterindex med hjälp av klammerparenteser, till exempel använda
{0}och{1}för att fungera som platshållare för parametrarna med högt och lågt intervall.I följande exempel visas en exempelordförrådsdefinition för ett värdeintervall:
När du är klar väljer du Slutför.
Lägga till en uppsättning värden som en ordförrådsdefinition
På fliken Vokabulärer i mappen Vokabulärer .
Öppna snabbmenyn för den ordförrådsversion som du vill använda i mappen Vokabulärer.
I snabbmenyn för ordförrådsversionen väljer du Lägg till ny definition.
Du kan också dra objekt från fliken .NET-klasser och fliken XML-scheman .
Guiden Ordförrådsdefinition startas för att hjälpa dig att skapa definitionen.
I guiden väljer du Konstant värde, Värdeintervall eller Värdeuppsättning och väljer sedan Nästa.
Tillhandahåll följande information:
Property beskrivning Definitionsnamn Definitionens namn. Beskrivning Definitionens beskrivning. Definitionstyp För den här uppgiften väljer du Uppsättning värden. När du är klar väljer du Nästa.
Tillhandahåll följande information:
Property beskrivning Definitionstyp Välj en systemdatatyp för definitionen. Visningsnamn Ange ett namn som inte överskrider 512 tecken. Under Definiera värden är endast alternativet Använd konstant värde tillgängligt.
Om du vill lägga till en medlem i uppsättningen anger du ett konstant värde och väljer Lägg till.
Upprepa föregående steg för så många värden som du vill inkludera i din uppsättning.
I följande exempel visas flera värden i uppsättningen:
Om du vill flytta ett värde inom den relativa ordningen för uppsättningen väljer du värdet i rutan Värden och väljer sedan Upp eller Ned.
Om du vill ta bort en medlem från uppsättningen väljer du värdet i rutan Värden och väljer Ta bort.
När du har slutfört din uppsättning väljer du Slutför.
Lägga till en .NET-klass eller klassmedlem som en ordförrådsdefinition
Innan du börjar måste du placera dina .NET-sammansättningar i en katalog som är lokal för Microsoft Rules Composer. Om du uppdaterar .NET-sammansättningen måste du uppdatera regeluppsättningsversionens referenser till den sammansättningen. Mer information finns i Uppdatera .NET-sammansättningsreferenser.
På fliken Vokabulärer i mappen Vokabulärer .
Öppna snabbmenyn för den ordförrådsversion som du vill använda i mappen Vokabulärer.
I snabbmenyn för ordförrådsversionen väljer du Lägg till ny definition.
Du kan också dra en .NET-klass eller klassmedlem från fliken .NET-klasser.
Guiden Ordförrådsdefinition startas för att hjälpa dig att skapa definitionen.
I guiden väljer du .NET-klass eller klassmedlem och sedan Nästa.
Tillhandahåll följande information:
Property beskrivning Definitionsnamn Definitionens namn. Beskrivning Definitionens beskrivning. I avsnittet Klassmedlemsinformation väljer du Bläddra.
Leta upp och välj den sammansättning som du vill använda och välj sedan Öppna.
Expandera sammansättningsnoden i rutan Välj bindning .
Välj en klass eller expandera en klass och välj en klassmedlem och välj sedan OK.
Välj något av följande steg:
Om du väljer en klass för Visningsnamn anger du ett namn som inte överskrider 512 tecken och väljer Slutför.
Nu är du klar med det här avsnittet.
Om du väljer en klassmedlem som har parametrar väljer du Nästa.
Sidan Ange visningsnamn – .NET-klass eller klassmedlemsdefinition visas så att du kan ange ett värde och visa formatsträngen för varje parameter.
Under Steg 1 – Ange visningsnamnet/värdet för varje parameter går du till rutan Parametrar , väljer en parameter och väljer sedan Redigera.
För Parametervärde är endast alternativet Använd konstant värde tillgängligt, så ange ett konstant värde.
Under Steg 2 – Ange strängen för visningsformat anger du strängen visningsformat i strängegenskapen Visningsformat . Om du vill återgå till standardsträngen för visningsformat väljer du Standard.
Kommentar
Kontrollera att formatsträngen innehåller parameterindex med hjälp av klammerparenteser, till exempel använda
{0}och{1}för att fungera som platshållare för parametrarna.Upprepa föregående steg för varje parameter i din klassmedlem.
I följande exempel visas flera parametrar i klassmedlemmen:
Skapa en ordförrådsdefinition från en .NET-sammansättning
Du kan skapa ordförrådsdefinitioner från klasser eller klassmedlemmar i en .NET-sammansättning för att definiera predikat, argument och åtgärder. Innan du börjar måste du placera dina .NET-sammansättningar i en katalog som är lokal för Microsoft Rules Composer. Om du uppdaterar .NET-sammansättningen måste du uppdatera regeluppsättningsversionens referenser till den sammansättningen. Mer information finns i Uppdatera .NET-sammansättningsreferenser.
I fönstret Faktautforskaren väljer du fliken .NET-klasser .
Dra en klass- eller klassmedlem under .NET-sammansättningar till en befintlig ordförrådsdefinition, som visas på fliken Vokabulärer .
Skapa en ordförrådsdefinition från ett XML-dokumentelement eller -attribut
Du kan skapa ordförrådsdefinitioner från XML-element och attribut genom att bläddra igenom XSD-scheman och dra objekt till villkorsredigeraren eller åtgärdsredigeraren för att definiera predikater, argument och åtgärder.
På fliken Vokabulärer i mappen Vokabulärer .
Öppna snabbmenyn för den ordförrådsversion som du vill använda i mappen Vokabulärer.
I snabbmenyn för ordförrådsversionen väljer du Lägg till ny definition.
Guiden Ordförrådsdefinition startas för att hjälpa dig att skapa definitionen.
I guiden väljer du XML-dokumentelement eller -attribut och sedan Nästa.
Tillhandahåll följande information:
Property beskrivning Definitionsnamn Definitionens namn. Beskrivning Definitionens beskrivning. I avsnittet XML-dokumentinformation väljer du Bläddra.
Leta upp och välj en schemafil (.xsd) och välj ett dokumentelement eller attribut.
I listan Typ väljer du en typ som är kompatibel med typen för det valda elementet eller attributet från schemat.
Kommentar
Motorn validerar inte det definierade elementets existens och dokumenttypen. Om du hävdar ett XML-dokument som inte har elementet får du ett fel vid körning. Om du hävdar ett XML-dokument med en okänd dokumenttyp ignorerar motorn bara dokumentet.
Om motorn inte kan utföra en giltig gjutning mellan den angivna typen och typen för det valda dokumentelementet eller attributet får du ett fel vid körning.
I avsnittet Välj åtgärd väljer du den åtgärdstyp som anger om du planerar att hämta elementets eller attributets värde eller ange värdet.
Om du väljer att ange värdet väljer du Nästa och anger visningsformatet.
Sidan Ange visningsnamn – XML-dokumentelement eller attribut visas så att du kan ange ett värde och visa formatsträngen som ska användas.
Under Steg 1 – Ange visningsnamnet/värdet för varje parameter går du till rutan Parametrar , väljer en parameter och väljer sedan Redigera.
För Parametervärde är endast alternativet Använd konstant värde tillgängligt, så ange ett konstant värde.
Under Steg 2 – Ange strängen för visningsformat anger du strängen visningsformat i strängegenskapen Visningsformat . Om du vill återgå till standardsträngen för visningsformat väljer du Standard.
Kommentar
Kontrollera att formatsträngen innehåller parameterindex med hjälp av klammerparenteser, till exempel använda
{0}och{1}för att fungera som platshållare för parametrarna.
När du är klar väljer du Slutför.
I följande exempel visas information om en ordförrådsdefinition baserat på ett XML-dokumentelement eller -attribut:
När du skapar ordförrådsdefinitioner för XML-noder har XPath-uttrycken för bindningarna liknande standardvärden, baserat på de regler som beskrevs tidigare. Du kan dock redigera dessa värden i guiden Ordförrådsdefinition. Ändringar av uttrycken placeras i ordförrådsdefinitionen och återspeglas i alla regelargument som du skapar från vokabulärdefinitionerna.
