Så använder du regelfiler och regelmotor

Varför använda regelfiler och regelmotor?

Syftet med att använda Skatteverkets regelfiler och regelmotor är att separera den juridiska logiken från applikationslogiken. Det finns ett antal fördelar med detta, till exempel

• Enklare teknisk förvaltning och testning. Skatteverket sköter uppdateringarna av regler, så att du slipper uppdatera koden i din applikation varje gång en lagändring sker.
• Ökad skalbarhet. Samma juridiska logik kan återanvändas i flera applikationer.
• Ökad transparens. Det blir enklare för dig som utvecklare att förstå juridiken och implementera den som villkor (regler).
• Enklare att underhålla. Genom att reglerna kan visas upp i ett gränssnitt snarare än direkt i koden, blir de även enklare att granska och uppdatera för jurister och andra domänexperter.

Ingen färdig tjänst

Regelfilerna och regelmotorn är ingen färdig tjänst och kan inte användas av en slutkund. Våra illustrationer visar hur regelmotorn och regelfilerna hänger ihop och hur de kan passa in i din applikation.

Bild 1. Logik för rättsliga regler

Facts och regler matas in i regelmotorn, som genererar utdata i form av en textsträng. Utdatan skulle till exempel kunna vara "Skattefri ersättning kan betalas ut med 25 kronor per mil." Detta är endast ett lager logik som du som utvecklare kan använda i din applikation.

Bild 2. Din applikation

Din applikation samverkar med regelmotorn och regelfilerna enligt illustrationen nedan. Tänk att det till exempel är en räknesnurra som ska visa ersättning för antal mil. I applikationen finns möjlighet att lämna ytterligare indata, till exempel "10 mil" och "100 dagar". Slutanvändaren kan då få utdata i stil med att "Ersättningen blir 25 000 kronor". Hur denna in- och utdata lämnas respektive presenteras är separerat från den juridiska logiken.

Så kan du använda regelfilerna

En regelfil innehåller en uppsättning regler. Regelfiler är grupperade i regelområden, som till exempel "Reseräkning". Varje regelfil får också ett mer preciserande namn, till exempel "Logikostnader".

Skatteverkets regelfiler innehåller generiska data, men i kundens miljö kan du som utvecklare lägga till värden och funktioner som är specifika för din applikation.

Teknisk genomgång i fyra punkter:

Här är några saker du kan vara uppmärksam på när du ska börja använda filerna:

1. Facts i kundens miljö kan skilja sig från hur värdena ser ut i Skatteverkets regelfiler. Det löser du genom mappning. Mappning är beskrivet i en av exempelfilerna i mappen JsonREexempel.zip som du hittar på dataresursen Rättsliga regelfilers sida på Utvecklarportalen, under rubriken Exempelfiler - teknisk guide.
   
2. I regelfilerna finns villkor för en regel samlade i en array med nyckeln all. Det är en följd av strukturen i regelmotorn Json-rules-engine som möjliggör kapsling.
3. I dagsläget använder Skatteverket inte kapslade (nested) regler. Det beror på att vi vill hålla de tekniska reglerna så enkla som möjligt för att de ska kunna skapas och läsas av människor.
4. Den datatyp som används är alltid String. Operator är alltid equal till följd av att datatyp alltid är String. I framtiden kan även andra datatyper komma att användas.

• Rättsliga regelfiler Länk till annan webbplats, öppnas i nytt fönster.
• Exempelfiler, teknisk guide (zip-fil) Länk till annan webbplats, öppnas i nytt fönster.

Så fungerar regelmotorn

Regelmotorns funktion är att ta facts och matcha (evaluera) dem mot reglerna. När dina facts matchar reglerna triggas ett success event och du får då tillgång till den information som finns lagrad i regelns event-objekt. Utdatan du får från regelmotorn är alltid en textsträng. Den innehåller vanligtvis en juridisk förklaring och källhänvisningar, men kan även innehålla till exempel värden för belopp.

Hur du väljer att använda och visa tillgänglig information är upp till dig som skapar tjänsten. Numeriska värden kan du använda till beräkningar. Vill du visa en text eller ett belopp i en applikation som visas på en slutanvändares skärm kan du göra det. Du kan också skicka vidare informationen till något annat system. Att visa källhänvisningar kan vara onödigt i en tjänst där slutanvändaren inte är jurist. Men för jurister kan källhänvisningarna i stället vara det viktigaste att visa.

Kodexempel

På vår Utvecklarportal, på API-sidan för Rättsliga regler under fliken Exempel, hittar du ett enkelt kodexempel.

• Rättsliga regler Länk till annan webbplats, öppnas i nytt fönster.