Since 3.5

Introduktion

Den här funktionaliteten tillåter systemadministratören att definiera utökade valideringsregler för inmatad data eller valda objekt i redigera objektsformuläret.

Validering görs både på klientsidan för omedelbar feedback, samt på serversidan. Validering på server sätts alltid, oavsett typ av indata (manual, import, via API).

Regler kan gälla ett enkelt fält, eller fält-par som kan definieras igenom att specificera mästare och beroende fält, där värden tillåts i beroende-fältet valideras baserat på val i mäster-fältet.

Administration och användning

Start

Fält-valideringsregler kan kan läggas till vid vilken tidpunkt som helst i Administrationspanelen. "Öppna fält-validerare"  för att börja:

Ett par få saker att minnas innan man börjar:

• Det finns ingen speciell validering av reglerna, de måste definieras med försiktighet.

• Redigera ett existerande objekt som inte möter det nya satta kriteriet är inte möjligt.

• Sätta kriterier på fält som inte är tillgängliga för specifika användare som kan redigera objekt, kan hindra de användarna från att redigera ett objekt alls.

• En regel definierad för en föräldraklass som dokument kommer också appliceras till underklasser. I administrationspanelen, visas en sådan regel endast där den var definierad (på en föräldraklass)

Definiera en ny fält-validerade

1. Välj en klass som du vill lägga till fält-validerare. 

2. Bestäm om du vill lägga till mäster/slav fält-validerare eller enkelfälts-validerare

   1. För mäster/slav-validering, lämna "beroendefält" ikryssad. 

   2. För enkelfälts validering, bocka ur det här valet.

3. Välj fält, kriterier och det önskade värdet

4. Välj lägg till ett kriterie
   
   
   

När det här är gjort kan du se din nya validering i Existerande kriterier-listan.

Redigera Validerare

Kriterier kan ej redigeras. för att redigera ett kriterie, använd "Ta bort" knappen och lägg till det borttagna kriteriet med rätt värde igen. 

Överlappande kriterier

Det här är en situation när två eller fler kriterier matchar ett valt fält och värde.

I ett sådant fall, kollar ett system av kriterierna tills ett första misslyckande kriterie är funnet.

Det gäller också mäster/slav behov - en första matchande regel kommer att användas.

Det är rekommenderat att undvika överlappande kriterier som i det här exemplet:

Open

Exemplet ovan skulle läsas:

• Då fältet funktion innehåller värde "Personal" eller "Service", så måste Areaklass-fältet vara LOA eller BOA

• Då fältet funktion innehåller värde "Personal",  så måste Areaklass-fältet vara BIA

I det här fallet, när funktionsfältet har värdet "Personal", kommer endast en av dessa regler appliceras i en slumpmässig ordning. Som ett resultat krävs antingen eller värdet LOA/BOA, eller BIA i det andra fallet. Medans systemadministratören intentioner kan ha vart en situation där för värdet "Personal" är LOA, BOA, eller BIA tillåtet, medans för "Service", är det endast LOA och BOA. Detta är inte fallet och kriterierna kommer inte att slås samman till ett set automatiskt.

För att uppnå beskriven validering, rekommenderas en konfiguration som set ut såhär:

Open

Validerar exempel.

Beroende (mäster/slav) ordlistefält

Beroende-fält skapas när man väljer "Beroende-fält" konfiguration. Varje gång ett mäster-fält har ett indikerat värde kommer en regel att aktiveras.

Utöver detta kommer ett system att filtrera ut ej-tillåtna värden automatiskt.

Ett resultat synligt för en användare som redigerar ett Utrymmes-objekt skulle se ut såhär:

Datumvalidering

Det här exemplet visar hur man sätter en gräns på tillåtet datum på ett specifikt fält. Här, har vi valt ett revisions datum efter 1905-02-25 och efter 2019-02-25.

De här kriterierna kollas också individuellt, så endast en validering kommer att göras åt gången. Om "efter" valideringen går igenom så kommer "före" valideringen att utföras (ordningen kan variera).

Textvalidering

En textvalidering kan utföras igenom att använda antingen enkel eller mäster/slav-fält som visas nedan.

I detta exempel, utförs endast valideringen om revisionsdatumet är innan angivet datum. I det fallet krävs att ett dokumentnummerfält startas med en "HIST-" sträng, till exempel, "HIST-234525" kommer att vara ett giltigt nummer.

Nummervalidering

En numerisk fält-validerare  kan användas för att skapa kriterier som nedan. I det här fallet har vi satt ett krav på att Utrymmesobjekt AREA BRA fält skall ligga i spannet mellan 0-1000. 

Ett resultat synligt för användaren som redigerar detta fält ser ut såhär:

Fältregelsundantag

Det finns några handlingar som kanske inte gäller förda regler.

Import

Ett nytt import val har nu lagts till för att importera dialog som heter "Verkställ fältregler".

Om den är kryssad, då kommer validerarna att appliceras under import. Objekt från paket som inte kan appliceras till fältreglerna kommer inte att läggas till och ett felmeddelande läggs till i objektsrapporten. Om den är urbockad så kommer ingen validering att göras.

Anpassade plugins - smarta fält

Administratören kan bestämma ifall fält regler borde gälla eller inte när anpassade fält plugins körs.

I "Custom Fields\Fields availability" fliken, kommer nu den nya kolumnen "Verkställ fältregler" som nu tillåter att aktivera och stänga av regler medans plugins körs.

Uppdatera area

Den här funktionen designades bara för att kopiera area från motsvarande plats till objektets metadata (area fält), att ha fältvalidering verkar inte behövas då det skulle blockera area uppdateringar utan att mäta fältreglerna.