Introductie
Na het kiezen voor een nieuw Configuratiebestand (via het menu of met Ctrl+N) verschijnt de SoftRules® configuration dialoog. Dit scherm bevat 8 tabbladen:
Hieronder volgt een beschrijving van Configuration en Tools.
Description
Geef hier een beschrijving van het configuratiebestand.
ID
Configuratiebestanden worden uniek gemaakt middels een ID. De SoftRules® Server gebruikt dit positieve nummer om het juiste configuratiebestand te adresseren. Het nummer kan naderhand worden aangepast, maar dit kan ingrijpende gevolgen hebben wanneer de producten in dit configuratiebestand al door SoftRules® Servers en clients (!) worden gebruikt. Het verdient de voorkeur om vooraf goed na te denken over een logische nummering van uw Configuratiebestanden.
Filename
Bevat de bestandsnaam exclusief het pad naar het bestand waarin deze configuratie wordt opgeslagen. Alle bestanden worden in de Data directory opgeslagen.
Schema (XSD)
U heeft de volgende opties:
|
●
|
No Schema
|
|
|
U kiest ervoor om geen schema te gebruiken.
|
|
●
|
Local
|
|
|
U kunt een bestandsnaam van een Schema (XSD) opgeven en deze met een druk op de Load knop inlezen.
|
|
●
|
Global
|
|
|
U kunt een keuze maken uit de Element Tables in de Global Configuration.
|
Configuration version
Het versienummer van de configuratie. Iedere keer wanneer de configuratie wordt opgeslagen, wordt het nummer in het laatste vakje (build number) met 1 opgehoogd.
Library
Wanneer de Library optie op deze niveaus niet wordt ingevuld, wordt gebruik gemaakt van de Library van de parent. Hier wordt op het hoogste niveau (de Configuration) standaard Local configuration geselecteerd. Middels deze optie is een andere Library te selecteren.
Format
Landinstellingen zoals getalsnotaties en het datumformaat worden bij het aanmaken van een nieuwe Configuratie van de lokale machine gekopieerd en in de Configuratie opgeslagen. Zo wordt het mogelijk om een Configuratie die gebouwd is met Nederlandse datuminstellingen te gebruiken op een Server die op Amerikaanse notatie staat ingesteld. Het gewenste land kan in deze lijst worden geselecteerd en eventueel kunnen de instellingen nog worden aangepast.
|
Let op!
|
Deze instellingen hebben betrekking op de datum en getalsformaat waarmee de Business Rules zijn gemaakt. Als u bijvoorbeeld een datum in string formaat gaat manipuleren met de functie Day() of Month() is het van belang dat de dag en de maand op de juiste plaats in de string staan. Voor conversie van in- en output XMLdocumenten naar en van dit interne formaat kunnen Adapters worden gebruikt.
|
Het gaat hier om de volgende instellingen:
Validate when processing
Met dit vinkje aan worden de In- en Output XML gevalideerd tegen het XML Schema. Eventuele foutmeldingen worden in de SoftRules® Composer getoond in de Debugger. In de SoftRules® Server verschijnt er een foutmelding in de Eventlog als er één of meerdere meldingen uit het Validatieproces komen. Validatie is een kostbaar proces. Dat wil zeggen dat het de performance van uw Configuraties zeer nadelig beïnvloedt als dit vinkje aan staat. Om die reden is het wellicht verstandig om tijdens de bouw van Configuraties het vinkje ingeschakeld te houden en dit uit te zetten als de Configuraties in productie worden genomen.
Strict Xml
Indien dit vinkje ‘aan’ staat, zal SoftRules® een foutmelding (exception) genereren als een element in het Xml geplaatst wordt welke niet past in één van de paden uit het Xml Schema. Strict Xml staat default ‘aan’.
Unfinished transactions
Hier kunt u aangeven wat er moet gebeuren met
transacties die niet zijn afgerond op het moment dat het Product klaar is met verwerken van het XML. Er zijn de volgende opties
Expire at
Wanneer u wenst dat een Configuratie stopt met functioneren op een specifieke datum, kunt u deze datum hier invullen.
View used Elements
Met deze link kunt u er voor kiezen om alleen de in de Configuratie gebruikte elementen te zien.
View notepad Elements
Met deze link kunt u er voor kiezen om alleen de in de Configuratie gedefinieerde kladblokvariabelen te zien. Kladblokvariabelen worden vooraf gegaan door een # symbool. Deze variabelen worden niet in het XML document opgeslagen en kunnen daarom niet buiten SoftRules® worden gebruikt.
View Elements from schema
Met deze link worden alleen de elementen getoond die in het schema zijn gedefinieerd. Dus niet de kladblokvariabelen.
Elements
Een lijst met alle elementen die gevonden zijn in de XSD nadat deze middels de Load knop zijn ingelezen.
Deze lijst bevat de volgende kolommen:
|
●
|
Elementname
|
|
|
De naam van het element.
|
|
●
|
Path
|
|
|
Deze kolom bevat de tekst 'all paths' en nadat hierop wordt geklikt worden alle XML paden getoond van het element met deze ElementName. Koppelingen naar Units en TextValues worden in principe gelegd voor alle paden van een element met een bepaalde ElementName. Wanneer de paden zijn uitgeklapt kan hiervan worden afgeweken. Met de rechtermuisknop en dan 'Show all elements' keert u weer terug naar de weergave waarbij alle elementen zichtbaar zijn.
|
|
●
|
Description
|
|
|
Hier is een beschrijving van het element op te geven. Deze wordt ondermeer gebruikt in de dynamische Userinterface als default label.
|
|
●
|
Unit
|
|
|
Koppelt het element aan een Unit in de globale configuratie.
|
|
●
|
TextValues
|
|
|
Koppelt het element aan een TextValue in de globale configuratie.
|
Search
In dit veld ingevulde tekst wordt direct gebruikt om de lijst te filteren op elementen die voldoen aan deze tekst.
Load knop
Met deze knop kan het Schema (XSD) bestand (opnieuw) worden ingelezen. Wanneer er bij het inlezen meerdere XML root elementen mogelijk te zijn, wordt een extra dialoog getoond zodat hieruit een keuze gemaakt kan worden.
Versioning
Op dit tabblad is het mogelijk om meerdere versies van de producten in de configuratie te beheren. Zie hier.
Tools
Op het Tabblad Tools kunnen Descriptions en koppelingen met
Units en TextValues worden overgenomen uit een andere Configuratie of een andere Element Table. Plaats een vinkje bij 'Override' als bestaande waarden overschreven mogen worden.
