×
Menu
Index

Userinterfaces

 

Introduction

In SoftRules® we have the possibility to define userinterface logic in your Configurations. A UserInterface consists of Questions, Labels, Buttons and Groups that can consist of Questions, Labels, Buttons and Groups by themselves.
 
A Question in SoftRules® points to an element that's defined in the schemafile of the Configuration. If a Question is coupled to an Assignment, we speak of a bound Question, otherwise the Question is unbound. In this last case the Elementname can consist of a wildcard and the elementpath can be chosen later on, from the paths belonging to this Element as declared in the schema. This way you can build a UserInterface that can be used in several places in the XML document which can be embedded in other UserInterfaces.
 
Tip!
When starting the Debugger from within a UserInterface, it opens directly on the User Interface tab with a view to the corresponding UserInterface.
 

ID

Automatically generated ranking number that can be used to call the UserInterface from the client application. This number can not be changed.
 

TextID

Alternative way to point to a UserInterface from the client application. The TextID can be chosen freely.
 

Description

A description of the UserInterface.
 

Parameters

Parameters are needed when unbound Questions are used in the UserInterface. When creating an Unbound Question, this Question is coupled to one of the available parameters. Whenever a UserInterface with a parameterlist is included in another UserInterface, the parameters need to be filled with two values.
 
1. Value, and
2. Path
 
Wildcards in the Question's Elementname will be replaced with Value and also the given Path is assigned to the Element. This way SoftRules® can bind the Question at runtime.
 

Timers

UserInterfaces can also start fully automatically using Timers. In fact an Input XML document will be made, using the UserInterface's Questions with their Default values. This Input XML Document will be send to the Configuration at intervals set in the Timer list. This can be used to build Configurations that handle Calendars or Workflows.
 

Timer list

After clicking on Edit the Timer list is shown.
Using the Add timer button, a Timer can be added to the list.

Description

Description of the Timer.
 

Start

The Start time.
 

Repeat every

Enter the Repeat value in Minutes, Hours and Days.
 

Enabled

The timer can be enabled or disabled.
 

OnCreate

Select a Function that should be executed when the UserInterface is created. A UserInterface will be created at runtime when a client sends a request. Using this functionality the list with Elements that can be coupled with Questions will change. See here.
 

OnChange

Select a Function to be executed when the UserInterface changes. A UserInterface changes when the client sends an update  request.
 

Versions

When multiple Versions of this UserInterface are available, another Version can be selected. Which UserInterface will be used at runtime depends on the Conditions at Configuration level.
 

New version

After clicking New version the above dialogue appears. You can select one of the Version declared at Configuration level. With the Edit button you can view or eventually modify this Version. Using Copy previous version all items from the previous version will be copied to the new Version. This way you want have to begin from scratch.
 

Delete version

Using the Delete version button you can remove an instance of a Version. You can't remove the Base Version.