von Thorsten Doherr 25.06.2002

Bestes Druckergebnis mit IE 5.0 und 1.905 cm Rand auf allen Seiten (Style-Sheets mit Seitenumbruch).

Inhalt

Einleitung

Angiff der Riesenameisen
Was ist Formicula?
Die Motivation

Funktionsweise

Formicula ist ein Servlet
Kommunikation mit dem Anwender
Datenbankanbindung

Installation

Testumgebung
Web-Server

Syntax

Allgemein
Die Formularstruktur
Eigenschaften, Variablen und Daten
Substitutionen
Datenfelder als Vektoren
Diagram der Formularstruktur

Objekte

Form
Entry
Group
Frame
Table
Layout
Row
Content
Text
Dummy
Blank
Summary
Refresh
SingleVarContent
Input
Password
Radio
Area
Combo
Submit
MultiVarContent
Image
Likert
Check
Matrix
Evaluator
Utilize
BaseEvaluator
Eval
Not
True
False
Catch
Loop
FunctionEvaluator
NavigationEvaluator
Jump
Skip
Back
UtilityEvaluator
Clear
Copy
Level
Gather
Scatter
Filter
Dir
Sort
VisibilityEvaluator
Hide
Show
SystemEvaluator
Reset
Exit
Transfer
Log
Exec
MessageEvaluator
Error
Valid
DataEvaluator
Connect
Disconnect
Select
Update
Delete
Insert
SQL
Next
Commit
Rollback
Touch
Meta
Catalog
IOEvaluator
Open
Close
Read
Write
Operator
app
at
build
def
gen
ins
join
len
lex
lexcnt
match
padl
padr
rat
replace
set
UnaryOperator
ceil
clean
date
empty
errcnt
floor
free
full
isdate
isbool
isint
isnum
istime
lower
msgcnt
off
on
rand
remove
round
todate
tohtml
topath
totime
trim
trunc
upper
used
NumericOperator
add
div
isfix
left
max
min
moveind
mul
right
setind
sub
substr
tofix
ValueOperator
getind
size
CompareOperator
DynamicCompareOperator
eq, ne, lt, le, gt, ge
rec
NumericCompareOperator
eqnum, nenum, ltnum
lenum, gtnum, genum
StringCompareOperator
eqstr, nestr, ltstr
lestr, gtstr, gestr

Anhang

Systemfelder
Farben
Links

Einleitung

Angriff der Riesenameisen

Was ist Formicula?

Die Motivation

Funktionsweise

Formicula ist ein Servlet

Kommunikation mit dem Anwender

Datenbankanbindung

Installation

Testumgebung

Web-Server

Syntax

Allgemein

Frame bsp1
{   backColor = green;              // lokale Variable
    [foreColor] = blue;             // globale Variable
    [gelb] = yellow;                // globale Variable
    [macro12] =                     // Definition eines globalen Macros
    'Text bsp12
     {   foreColor = black;         // globale Variable wird ausgeblendet
         text = "denn so.";         // schwarzer Text auf weissem Hintergrund
     }';
    subHtml;                        // entspricht: subHtml = true;
    Text bsp11
    {   text = "Hallo, wie gehts";  // blauer Text auf gruenen Hintergrund
    }
    [macro12]                       // Substitution des globalen Macros
    Text bsp13
    {   backColor = [gelb];         // globaler Variableninhalt wird verwendet
        text = "Der \"Hintergrund\""; // Escapesequenz: Anfuehrungszeichen
        text = ist, [gelb];         /* Inhaltsliste mit Substitution */
    }
}

Die Formularstruktur

Die Formularstruktur besteht aus hierarchisch gegliederten Objekten. Auf der höchsten Ebene steht das Formular selbst. Dieses Objekt trägt den Namen Form. In Form werden globale Einstellung definiert, wie z.B. einen Verweis auf eine HTML-Seite, die das Formular enthält. Ausserdem ist es ein sogenannter Container für Objekte der Klasse Group. Eine Group der höchsten Ebene stellt eine Formularseite dar. Sie bestimmt das umgebende Layout der eigentlichen Formularinhalte. Eine Group kann wiederum Objekte der Klasse Entry beinhalten. Da Group selbst von dieser Basisklasse abstammt, kann eine Group andere Group-Objekte enthalten. Von der Klasse Entry wird auch die Klasse Content abgeleitet. Diese definiert die Grundstruktur für alle Formularinhalte wie Texte oder Eingabefelder. Die Content-Objekte haben neben der darstellenden Funktion noch die Aufgabe die sogennanten Evaluatoren zu beherbergen. Sie stellen das Grundgerüst für die Funktionalität des Formulars dar. Ein Evaluator wertet immer irgendeine Bedingung aus und führt bei Erfüllung eine spezielle Aktion durch. Evaluatoren sind Container für andere Evaluatoren und für Objekte der Klasse Operator. Letztere sind für das Handling der Daten zuständig. Dazu gehören Vergleichsoperatoren, mathematische Operatoren, String- und Systemfunktionen.

Die Klassen der Formularstruktur sind die Schlüsselwörter der Scope-Syntax. Die Typen der Scopes entsprechen den Klassennamen und ihre Position in der Scope-Hierarchie muss den Vorgaben der Formularstruktur entsprechen. Nicht für alle Klassen der Formularstruktur lassen sich Objekte instanzieren. Die sogennanten abstrakten Klassen (im Diagramm kursiv dargestellt) definieren allgemeine Eigenschaften, die sie an die von ihnen abgeleitete Klassen vererben. So verhalten sich alle Evaluatoren aus der Sicht eines Content-Objektes gleich, obwohl sie ganz unterschiedliche Funktionen erfüllen. Abstrakte Klassen können nicht instanziert werden, da einige Bestandteile nur als Vorgabe für Unterklassen aber nicht als Implementierung vorliegen. Nur die instanzierbaren Klassen bilden die Schlüsselwörter der Formicula-Syntax.

Eigenschaften, Variablen und Daten

Substitutionen

Datenfelder als Vektoren

Diagram der Formularstruktur

Entry
Content... Evaluator	Group... Entry

...Content

SingleVarContent

MultiVarContent

Blank

Dummy

Refresh

Text

Summary

Area

Combo

Input

Password

Radio

Image

Likert

Check

Matrix

...Group
Table	Frame	Layout	Row

Evaluator Operator Evaluator
FunctionEvaluator...	BaseEvaluator						Utilize
	Eval	Not	True	False	Catch	Loop

...FunctionEvaluator
Utility...	Data...	System...	IO...	Navigation...	Visibility...	Message...

...UtilityEvaluator
Clear	Copy	Level	Gather	Scatter	Filter	Dir	Sort

...DataEvaluator
Connect	Disconnect	Select	Update	Delete	SQL	Next	Commit	Rollback	Touch	Meta	Catalog

...SystemEvaluator
Reset	Exit	Transfer	Log	Exec

...IOEvaluator				...NavigationEvaluator			...VisibilityEvaluator		...MessageEvaluator
Open	Close	Read	Write	Jump	Skip	Back	Hide	Show	Error	Valid

Operator

CompareOperator...

NumericOperator

UnaryOperator

at

def

...

set

add

div

...

sub

ceil

date

...

used

...CompareOperator
DynamicCompareOperator				NumericCompareOperator				StringCompareOperator
eq	le	...	ne	eqnum	lenum	...	nenum	eqstr	lestr	...	nestr

Objekte

string

Strings sind Zeichenketten. Sie können ohne Anführungzeichen definiert werden, wenn keine Syntaxsymbole oder Leerzeichen darin vorkommen. Manche dieser Zeichenketten werden innerhalb von Html-Tags verwendet. Bei diesen Strings werden alle Html-Sonderzeichen (z.B.: "<", ">" oder Anführungszeichen) mit Html-Zeichenbeschreibungen maskiert, wodurch sie ihre Wirkung verlieren. Z.B. werden alle Datenfeldinhalte in einem Formularelement maskiert, damit der Inhalt nicht fäschlicherweise für ein Html-Steuerbefehl (Tag) gehalten werden kann.

html

Eigenschaften vom Typ html lassen ihren Inhalt direkt als Html-Code in das Formular einfliessen. Im Gegensatz zu Strings werden Html-Tags nicht maskiert und können vom Browser interpretiert werden.

boolean

Eigenschaften vom Typ boolean sind entweder true oder false.

integer

Der Typ integer definiert natürliche Zahlen.

float

Der Typ float definiert reale Zahlen.

stringlist, htmllist booleanlist, integerlist, floatlist

Listen können mehrere Ausprägungen vom gleichen Typ haben. Der Typ steht vor dem Wort "list". Die meisten Listen sind Stringlisten.

Form

Eigenschaften:

string servlet = /servlet/Formicula

Definiert den Pfad und Namen des Servlets welches die Anfragen an dieses Formular verwaltet. Diese Eigenschaft muss nur dann geändert werden, wenn der verwendete Web-Server von der Norm abweichende Pfadangaben für Servlets benötigt.

string name = Formicula

Diese Eigenschaft definiert den Namen des Formulars innerhalb des HTML- Dokuments als Referenz für Formicula-Objekte die JavaScript verwenden.

string method = post

Spezifiziert die Methode mit der die Formulardaten an das Servlet gesendet werden. Folgende Methoden werden unterstützt:
post: Daten sind nicht sichtbar (Standardeinstellung).
get: Daten werden an die URL angehängt und sind dadurch im Browser zu sehen.

stringlist parameter

Definiert eine Liste von Datenfeldnamen, die als Startparameter einglesen werden. Die Parameter werden an die Internet-Adresse (URL) des Formicula-Aufrufes angehängt. Die Parameterübergabe beginnt mit einem Fragezeichen (?) gefolgt von der ersten Parameterdefinition. Jede Definition besteht aus einem Namen, einem Gleichheitszeichen (=) und einem oder mehreren Werten. Die Trennung der folgenden Parameter erfolgt durch das Kaufmanns-Und (&). Hat ein Parameter mehrere Werte sind diese ebenfalls durch ein Kaufmanns-Und unterteilt. Da die Parameter Bestandteil der URL sind, können bestimmte Zeichen zu Missinterpretationen führen. Deshalb sieht die Standardverschlüsselung folgende Ersetzungen vor: Leerzeichen durch ein Pluszeichen (+) und nicht-alphanumerischen Zeichen durch ein Prozentzeichen (%) gefolgt vom ASCII-Code in zweistelliger Hexadezimalform.

string page

Gibt den Filenamen einer Rahmenseite an. Diese benötigt an der Stelle an der das Formular integriert werden soll das Tag "<Formicula>" (ohne abschliessendes Tag). Die Definition einer Rahmenseite hat Vorrang vor den Definitionen von intro bzw. outro.

htmllist intro

Mit dieser Eigenschaft kann ein HTML-Block definiert werden, der vor dem eigentlichen Formular steht. Bei Angabe der Eigenschaft page wird intro ignoriert.

htmllist outro

Mit dieser Eigenschaft kann ein HTML-Block definiert werden, der nach dem eigentlichen Formular steht. Bei Angabe der Eigenschaft page wird outro ignoriert.

string pageColor

Spezifiziert die Hintergrundfarbe der Formularseiten.

string textColor

Spezifiziert die Textfarbe der Formularseiten.

string linkColor

Spezifiziert die Textfarbe von Links.

string visitiedLinkColor

Spezifiziert die Textfarbe von bereits besuchten Links.

string activeLinkColor

Spezifiziert die Textfarbe von aktivierten Links.

string title = Formicula

Dieser Text erscheint in dem Titelbereich des Browserfensters.

boolean navigationLock = false

Gibt an ob die Navigation über den Browser akzeptiert (Standard) oder ignoriert werden soll. Die meisten Browser stellen Funktionen zum Navigieren in der History der besuchten Seiten zur Verfügung. Diese Seiten werden nicht vom Server sondern direkt aus dem Cache des Browsers geladen und können veraltet sein. Ist navigationLock deaktiviert, werden Daten, die in derartige Formularseiten eingetragen wurden, an Formicula gesendet und die entsprechende Group aktiviert. Ist diese Eigenschaft true werden diese Daten ignoriert und die aktuelle Formularseite erneut angezeigt.

integer maxInactiveInterval = 1800

Definiert die Zeit die zwischen zwei Anfragen eines Anwenders verstreichen darf. Die Angabe erfolgt in Sekunden. Nach dieser Zeitspanne wird die Session dieses Anwenders beendet. Diese Eigenschaft kann auf 0 gesetzt werden, wenn das Skript nur den Aufbau einer passiven, dynamischen Seite beschreibt.

boolean openStartpage = false

Diese Eigenschaft wirkt sich nur aus, wenn die Session bereits abgelaufen bzw. explizit beendet wurde und der Anwender Daten in die erste Formularseite eingegeben und diese abgeschickt hat. Ist die Eigenschaft true wird eine neue Session generiert und die Daten übernommen. Standarmässig wird die Session ohne die Übernahme der Daten generiert, da sonst unter Umständen Daten eingelesen werden, die nach einer Skriptänderung nicht mehr vorgesehen sind.

Entry

Eigenschaften:

integer padding = 2

Das padding einer Tabelle bestimmt den Abstand zwischen dem Zellenrand und dem Zelleninhalt in Pixeln.

integer spacing = 2

Das spacing einer Tabelle bestimmt den Abstand zwischen den Zellen in Pixeln.

integer border = 0

Ist der border grösser als null, wird ein plastischer Rand um die Tabelle und die Zellen gezogen. Die Breite des Randes entpricht dem border in Pixeln. Das spacing definiert dann den Abstand zwischen den Rändern der Zellen.

string width = 100%

Diese Eigenschaft definiert die Breite einer Tabelle. Bei einer Prozentangabe handelt es sich um eine relative Angabe zu dem Browserfenster. Absolutangaben definieren die Breite in Pixeln. Wenn die Eigenschaft explizit auf einen Leerstring gesetzt wird, wird die Breite über den tatsächlichen Platzbedarf bestimmt.

string align = left

Diese Eigenschaft definiert die horizontale Ausrichtung der Tabellenelemente. Folgende Werte werden unterstützt: left, center, right.

string valign = center

Diese Eigenschaft definiert die vertikale Ausrichtung der Tabellenelemente. Folgende Werte werden unterstützt: top, center, bottom.

string backColor

Die backColor ist die Farbe des Zellenhintergrundes.

string borderColor

Die borderColor bestimmt die Farbe der Zellenzwischenräume (Rahmen), welche mit spacing definiert werden können. Wenn keine borderColor definiert wurde, erhält der Rahmen die Farbe des Hintergrundes auf dem die Tabelle dargestellt wird.

Group[Entry] -> Entry

Frame -> Group[Entry] -> Entry

Eigenschaften:

integer height = 0

Gibt die minimale Höhe des Frame in Pixeln an. Erfordert der Inhalt des Frame mehr Platz in vertikaler Ausrichtung wird diese Angabe ignoriert.

Beispiel:

maxInactiveInterval = 0;
[padding] = 4;
[backColor] = orange;
[borderColor] = black;
Frame
{   padding=4;
    spacing=8;
    borderColor=orange;
    backColor=khaki;
    align=center;
    valign=bottom;
    height=100;
    Text
    {   align=right;
        border=2;
        width=50%;
        text = "Das ist das erste Entry-Objekt.";
    }
    Text
	{   text = "Das ist das zweite Entry-Objekt.";
	}
}

Zu Beginn dieses Skriptes wird die Seite als passiv deklariert, da die Form-Eigenschaft maxInactiveInterval auf 0 steht. Die Session wird nach dem Aufbau der Seite gelöscht. Danach werden globale Präferenzen für Abstände und Farben gesetzt. Diese werden in der Definition des Frame-Objektes lokal überblendet. Die beiden Content-Objekte der Klasse Text übernehmen jedoch diese Einstellungen. Deutlich ist der 8 Pixel breite, orangene Rahmen zu erkennen, welcher durch das spacing hervorgerufen wurde. Der Frame hat einen khakifarbenen Hintergrund. Seine minimale Höhe height beträgt 100 Pixel. Da der Inhalt weniger benötigt und mit valign am unteren Rand des Frame ausgerichtet ist, ergibt sich ein grösserer Abstand zum oberen Rand. Die beiden Text-Objekte haben schwarze Rahmen aufgrund ihrer spacing-Eigenschaft. Das obere Text-Objekt ist bezüglich des Frame zentriert. Der Inhalt des Text-Objektes ist linksbündig ausgerichtet. Zudem hat es einen plastischen Rand durch die border-Eigenschaft erhalten. Das globale padding sorgt dafür, dass der Text in den Text-Objekten etwas Platz zum Rand aufweist. Zwischen den beiden Text-Objekten ist kein Abstand, da sich das padding des Frame nur auf den äussersten Rand bezieht.

Table -> Group[Entry] -> Entry

Beispiel:

[padding] = 4;
[spacing] = 0;
[backColor] = khaki;
Table
{   padding=0;
    spacing=4;
    borderColor=orange;
    backColor=khaki;
    Text { text = "Das ist das erste Entry-Objekt."; }
    Text { text = "Das ist das zweite Entry-Objekt."; }
}

Die beiden Text-Objekte haben ein einheitliches Layout. Sie verzichten auf die Darstellung von Rahmen, da dies das umschliessende Table-Objekt übernimmt.

Layout -> Group[Entry] -> Entry

Beispiel:

[padding] = 4;
[spacing] = 0;
[backColor] = khaki;
Table
{   padding=0;
    spacing=4;
    borderColor=orange;
    backColor=khaki;
    Layout
    {   Text
        {   text = "Das ist das erste Entry-Objekt.";
        }
        Text
        {   text = "Das ist das zweite Entry-Objekt.";
        }
    }
    Text
    {   text = "Das ist das dritte Entry-Objekt.";
    }
}

Das erste und zweite Text-Objekt wurden durch ein Layout zusammengefasst. Für die Table ist das Layout der erste und das dritte Text-Objekt der zweite Eintrag.

Row -> Group[Entry] -> Entry

Eigenschaften:

integer height = 0

Gibt die minimale Höhe der Row in Pixeln an.

Beispiel:

maxInactiveInterval = 0;
[padding] = 4;
[spacing] = 0;
[backColor] = khaki;
Row
{   padding = 0;
    spacing = 4;
    borderColor = orange;
    Layout
    {   width = 75%;
        Text
        {   text = "Das ist das erste Entry-Objekt.";
        }
        Text
        {   text = "Das ist das zweite Entry-Objekt.";
        }
        Row
        {   padding=0;
            Text
            {   text = "Das ist das dritte Entry-Objekt.";
            }
            Text
            {   align = right;
                text = "Das ist das vierte Entry-Objekt.";
            }
        }
    }
    Text
    {   align = center;
        text = "Das ist das fünfte Entry-Objekt.";
    }
}

In diesem Beispiel werden verschiedene Anwendungsmöglichkeiten des Row-Objektes demonstriert. Zum einen als Hauptlayout für das Formular und zum anderen als Trick, um bestimmte Anordungen zu erzielen ohne dass die Anwendung von Row offensichtlich ist. Bei der Angabe von relativen Breiten kann eine Angabe entfallen.

Content[Evaluator] -> Entry

Eigenschaften:

integer height = 0

Gibt die minimale Höhe des Objektes in Pixeln an. Erfordern der Inhalt mehr Platz in vertikaler Ausrichtung wird diese Angabe ignoriert.

string foreColor

Die foreColor gibt die Farbe des Textes an.

stringlist font

Definiert den Font der für den Text verwendet werden soll. Da manche Fonts unter Umständen dem Browser unbekannt sind, können alternative Fonts in der Liste definert werden. Gängige Fonts sind zum Beispiel: Arial, Times, Times New Roman, Helvetica, Sans Serif, Serif, Courier, Courier New, Impact

integer fontSize = 0

Gibt die relative Grösse des Textes in Bezug auf die vom Browser vorgegebene Standardgrösse an. Positive Angaben vergrössern den Text, negative Angaben verkleinern den Text.

integer msgBorder = 0

Ist der border grösser als null, wird ein plastischer Rand um die Nachricht gezogen. Die Breite dieses Randes wird in Pixeln gemessen.

integer msgPadding = 2

Gibt den Abstand des Nachrichtenrahmens zu dem Nachrichteninhalt in Pixeln an.

integer msgSpacing = 0

Gibt die Breite des normalen Randes in Pixeln an. Zusammen mit msgBorder kann damit das Aussehen des Nachrichtenrahmens gestaltet werden.

stringlist msgFont

Definiert den Font für den Nachrichtentext. Da manche Fonts unter Umständen dem Browser unbekannt sind, können alternative Fonts in der Liste definiert werden (siehe font).

integer msgFontSize = 0

Gibt die relative Grösse des Nachrichtentextes in Bezug auf die vom Browser vorgegebene Standardgrösse an.

string msgBackColor

Gibt die Farbe des Hintergrundes der Nachricht an.

string msgForeColor

Gibt die Farbe des Nachrichtentextes an.

string msgBorderColor

Die msgBorderColor bestimmt die Farbe des Nachrichtenrahmens, welcher mit msgSpacing definiert wird.

integer msgHeight = 0

Gibt die minimale Höhe in Pixeln an. Erfordert der Inhalt der Nachricht mehr Platz in vertikaler Ausrichtung wird diese Angabe ignoriert.

string msgAlign = left

Diese Eigenschaft definiert die horizontale Ausrichtung des Nachrichteninhalts. Folgende Werte werden unterstützt: left, center, right.

string msgValign = center

Diese Eigenschaft definiert die vertikale Ausrichtung des Nachrichteninhalts, wenn durch msgHeight überschüssiger Raum entsteht. Folgende Werte werden unterstützt: top, center, bottom.

boolean msgHidden = false

Alle Nachrichten des Content-Objektes werden unterdrückt, wenn diese Eigenschaft auf true steht. Sie können mit dem Summary-Objekt zusammengefasst dargestellt werden.

Text -> Content[Evaluator] -> Entry

Eigenschaften:

{htmllist} text

Gibt den Text an der dargestellt werden soll. Alle Html-Tags werden interpretiert. Die Art der Substitutionen kann bestimmt werden.

boolean subHtml = false

Ohne Angabe einer Substitutionsregel werden alle Html-Sonderzeichen in der Substitution maskiert. Sie werden als normale Zeichen dargestellt und nicht als Tags ausgeführt. Wenn diese Eigenschaft true ist, werden alle Substitutionen unverändert übernommen. Dies ist sinnvoll wenn z.B. Texte aus einer Datenbank angezeigt werden sollen, die absichtlich Html-Tags für das Layout enthalten.

boolean subFix = false

Normalerweise werden mehrfache Leerzeichen in Folge von den Browsern ignoriert. Die Ausnahme bildet das sogenannte feste Leerzeichen welches mit der Html-Zeichenbeschreibung "&nbsp;" erzeugt werden kann. Mit subFix werden alle Leerzeichen in der Substitution durch feste Leerzeichen ersetzt.

Beispiel:

maxInactiveInterval = 0;
[padding] = 4;
[spacing] = 0;
[backColor] = khaki;
Table
{   padding=0;
    spacing=4;
    borderColor=orange;
    Text
    {   text = "Substitution (normal): {sub}";
        Utilize { exp = sub, set, "<small>    TEST</small>"; }
    }
    Text
    {   text = "Substitution (subHtml): {sub}";
        subHtml;
    }
    Text
    {   text = "Substitution (subFix): {sub}";
        subFix;
    }
    Text
    {   text = "Substitution (subHtml, subFix): {sub}";
        subFix;
        subHtml;
    }
}

Bei dem Scope Utilize handelt es sich um einen speziellen Evaluator, der vor der Generierung des Html-Codes für eine Seite aufgerufen wird. In Utilize wird das Datenfeld sub definiert, das in den vier Text-Objekten substituiert wird.

Dummy -> Content[Evaluator] -> Entry

Beispiel:

maxInactiveInterval = 0;
[padding] = 4;
[spacing] = 0;
[msgAlign] = center;
[backColor] = khaki;
Table
{   padding = 0;
    spacing = 4;
    borderColor = orange;
    Text
    {   text = "2 + 2 = 5";
        Utilize
        {   Error { msg = "Falsch!"; }
        }
    }
    Layout
    {   Text
        {   text = "2 + 2 = 5";
        }
        Dummy
        {   Utilize
            {   Error { msg = "Falsch!"; }
            }
        }
    }
}

Die erste Zeile zeigt die Integration einer Nachricht in den Html-Code eines Content-Objektes. Die Nachricht befindet sich noch innerhalb des Rahmens, der über die Eigenschaften (spacing, padding) des Content-Objektes definiert wird. Die Nachricht in der zweiten Zeile ist an ein Dummy-Objekt gekoppelt. Da dieses keine Eigenschaften hat (oder besser gesagt "verwendet"), wird die Nachricht als eigenständiges Objekt in das Layout-Objekt übernommen.

Blank -> Content[Evaluator] -> Entry

Summary -> Content[Evaluator] -> Entry

Eigenschaften:

string spread = 10%

Das spread gibt die relative bzw. absolute Breite eines Inhaltselementes an, an der sich die anderen Elemente ausrichten. Es entspricht einer internen width-Angabe. Diese Eigenschaft deutet darauf hin, dass der Inhalt selbst eine Tabelle ist. Im Falle des Summary-Objektes handelt es sich um die Breite des Links.

boolean right = false

Definiert ob der Link rechts oder links von der Nachricht plaziert wird.

Beispiel:

maxInactiveInterval = 0;
[padding] = 4;
[spacing] = 0;
[backColor] = khaki;
[msgHidden];
Layout
{   Summary
    {   backColor = orange;
        msgSpacing = 2;
        padding = 2;
        right;
    }
    Table
    {   padding = 0;
        spacing = 4;
        borderColor = orange;
        Text
        {   text = "Frage 1: 2 + 2 = 5";
            Utilize
            {   Error { msg = "Fehler in Frage 1!"; }
            }
        }
        Text
        {   text = "Frage 2: 5 + 2 = 9";
            Utilize
            {   Error { msg = "Fehler in Frage 2!"; }
            }
        }
    }
}

Die beiden Fehlernachrichten der Text-Objekte werden nicht lokal angezeigt weil die Eigenschaft msgHidden global gesetzt wurde. Sie werden im Summary-Objekt aufgelistet. Durch einen Klick auf die Nachrichtennummer kann das dazugehörige Text-Objekt direkt angesprungen werden.

Refresh -> Content[Evaluator] -> Entry

Eigenschaften:

{html} label

Der label definiert die Aufschrift auf der Refresh-Taste.

SingleVarContent -> Content[Evaluator] -> Entry

Eigenschaften:

string var

Die Eigenschaft var verweist auf den Namen des Datenfeldes. Das Datenfeld muss nicht existieren und kann einem beliebigen Alias angehören. Diese Eigenschaft ist eine Pflichtangabe.

Input -> SingleVarContent -> Content[Evaluator] -> Entry

Eigenschaften:

{html} label

Definiert einen Text der links vom Eingabebereich erscheint. In der Regel beschreibt er den einzugebenden Inhalt.

{html} unit

Definiert einen Text der rechts vom Eingabebereich erscheint. In der Regel beschreibt er die Einheit des einzugebenden Inhalts.

int length = 80

Gibt die maximale Länge des Zeichenpuffers an. Soviele Zeichen können eingegeben werden. Danach wird der Cursor blockiert.

int col

Gibt die Breite des Eingabebereiches in Zeichen an.

Beispiel:

maxInactiveInterval = 0;
[padding] = 0;
[spacing] = 0;
[backColor] = khaki;
Table
{   padding = 4;
    spacing = 4;
    borderColor = orange;
    Input
    {   var = obst;
        label = "Was ist ihr Lieblingsobst:";
        col = 40;
        length = 40;
    }
    Input
    {   var = obst;
        label = "Wieviel essen sie davon am Tag:";
        unit = "Kilo";
        col = 20;
        length = 10;
    }
}

Password -> SingleVarContent -> Content[Evaluator] -> Entry

Eigenschaften:

{html} label

Definiert einen Text der links vom Eingabebereich erscheint. In der Regel beschreibt er den einzugebenden Inhalt.

{html} unit

Definiert einen Text der rechts vom Eingabebereich erscheint. In der Regel beschreibt er die Einheit des einzugebenden Inhalts.

int length = 80

Gibt die maximale Länge des Zeichenpuffers an. Soviele Zeichen können eingegeben werden. Danach wird der Cursor blockiert.

int col

Gibt die Breite des Eingabebereiches in Zeichen an.

Beispiel:

maxInactiveInterval = 0;
[padding] = 4;
[spacing] = 0;
[backColor] = khaki;
Table
{   borderColor = orange;
    spacing = 4;
    padding = 0;
    Text
    {   text = "Geben Sie bitte Login und Password an.";
        backColor = orange;
        align = center;
    }
    Frame
    {   padding = 0;
        align = center;
        Row
        {   width = "";
            [height] = 32;
            Layout
            {   [align] = left;
                Text
                {   text = "Login:";
                }
                Text
                {   text = "Password:";
                }
            }
            Layout
            {   [align] = right;
                Input
                {   var = login;
                    length = 8;
                    col = 20;
                }
                Password
                {   var = password;
                    length = 8;
                    col = 20;
                }
            }
        }
    }
}

Damit die Eingabefelder in dieser Form plaziert werden konnten, befinden sie sich in einem übergeordneten Frame-Objekt, das die Zentrierung vornimmt. Die Text-Objekte sind linksbündig, die Eingabefelder rechtsbündig in dem Row-Objekt angeordnet. Das Row-Objekt hat eine leere width-Eigenschaft, damit die einzelnen Spalten nicht breiter als nötig werden. Nur so kann das ganze Objekt im Frame zentriert werden. Bei einer Breite von 100% wäre eine Zentrierung sinnlos. Damit die Texte auf gleicher Höhe mit den dazugehörigen Eingabefeldern stehen, erhielten alle Row-Elemente eine fixe Höhe von 32 Pixel.

Radio -> SingleVarContent -> Content[Evaluator] -> Entry

Eigenschaften:

{htmllist} label

Definiert die Texte der Optionen, die angewählt werden können. Die Anzahl der Optionen wird über diese Eigenschaft festgelegt.

boolean vertical = false

Ist diese Eigenschaft true, werden die Optionen vertikal statt horizontal angeordnet.

boolean left = false

Ist diese Eigenschaft true, werden die Optionen links von den Markierungskästchen angeordnet.

boolean wide = false

Diese Eigenschaft wirkt sich nur bei einer vertikalen Anordnung aus (siehe vertical). Ist sie gesetzt haben die Optionen immer den grösst möglichen Abstand zu den Markierungskästchen. Dadurch entsteht immer eine blockartige Ausrichtung. Die Breite des Blockes ist von der Eigenschaft spread abhängig.

string spread

Diese Eigenschaft gibt die absolute (Pixelangabe) bzw. relative (Prozentangabe) Breite des gesamten Radio-Objektes an. Wenn diese Angabe fehlt oder leer ist wird die Breite dynamisch angepasst. Durch Verwendung von spread können mehrere Radio-Objekte einheitlich ausgerichtet werden.

int depth = 0

Mit depth kann die minimale Höhe einer Zeile des Radio-Objektes definiert werden. Bei horizontaler Ausrichtung gibt es nur eine Zeile.

int margin = 2

Die Eigenschaft margin entspricht dem padding der einzelnen Elemente des Radio-Objektes. Je grösser dieser Wert ist desto grösser sind die Abstände zwischen den Elementen (Optionen, Kästchen), und um so aufgelockerter ist das Erscheinungsbild.

Beispiel:

maxInactiveInterval = 0;
[padding] = 0;
[spacing] = 0;
[backColor] = khaki;
Table
{   padding = 4;
    spacing = 4;
    borderColor = orange;
    Layout
    {   Text
        {   text = "Was ist Ihr Lieblingsobst?";
        }
        Radio
        {   var = obst;
            label = "Äpfel", "Bananen", "Kirschen", "Erdbeeren";
        }
    }
    Layout
    {   Text
        {   text = "Was ist Ihr Lieblingsobst?";
        }
        Radio
        {   var = obst;
            spread = "100%";
            left;
            label = "Äpfel", "Bananen", "Kirschen", "Erdbeeren";
        }
    }
    Layout
    {   Text
        {   text = "Was ist Ihr Lieblingsobst?";
        }
        Radio
        {   var = obst;
            vertical;
            margin = 0;
            wide;
            spread = "50%";
            label = "Äpfel", "Bananen", "Kirschen", "Erdbeeren";
        }
    }
}

Area -> SingleVarContent -> Content[Evaluator] -> Entry

Eigenschaften:

int row = 4

Mit row wird die Anzahl der Zeilen des Texteingabebereiches definiert.

int col = 80

Mit col wird die Breite des Texteingabebereiches in Zeichen definiert.

Beispiel:

maxInactiveInterval = 0;
[padding] = 4;
[spacing] = 0;
[backColor] = khaki;
method = get;
Table
{   borderColor = orange;
    spacing = 4;
    padding = 0;
    width = "";
    Text
    {   text = "Schreiben Sie doch mal ein Gedicht:";
        backColor = orange;
    }
    Area
    {   var = gedicht;
        col = 60;
        row = 16;
    }
}

Das Table-Objekt hat eine leere Breitenangabe width. Dadurch ist das Formular nur so breit wie erforderlich. Der Eingabebereich verfügt über automatischen Zeilenumbruch. Wie bei Textverarbeitungsprogrammen wird durch die Enter-Taste ein Absatz generiert.

Combo -> SingleVarContent -> Content[Evaluator] -> Entry

Eigenschaften:

{htmllist} label

Die Eigenschaft label definiert die Optionen. Innerhalb eines Eintrages der Liste werden die einzelnen Optionen durch Kommas getrennt. So können die Optionen mittels Substitution dynamisch generiert werden. Kommas können durch "&#44;" maskiert werden, wenn sie Bestandteil einer Option sind.

string item

Die Eigenschaft item verweist auf den Namen eines Datenfeldes bzw. Datenvektors. Der Eintrag des Datenfeldes bzw. die Einträge des Vektors werden an die Optionen, die mit label definiert wurden, angehängt.

int row = 1

Mit row wird die Höhe des Auswahlbereiches in Zeilen definiert. Ist dieser Wert 1, so klappt der Auswahlbereich nur bei Bedarf aus.

boolean multiple = false

Normalerweise kann immer nur eine Option markiert sein. Ist multiple gesetzt, können mehrere Optionen mit der Maus markiert werden. Dazu muss die Kontroll-Taste gleichzeitig gedrückt werden. Mit der Umschalt-Taste und Mausklicks können ganze Bereiche markiert werden.

boolean numeric = false

Normalerweise werden die markierten Optionstexte im Datenfeld var gespeichert. Steht die Eigenschaft numeric auf true, werden die Positionsnummern der Optionen verwendet.

Beispiel:

maxInactiveInterval = 0;
[padding] = 4;
[spacing] = 0;
[backColor] = khaki;
Table
{   borderColor = orange;
    spacing = 4;
    padding = 0;
    Text
    {   text = "Wählen Sie bitte ihre Lieblingsfrüchte:";
        backColor = orange;
        Utilize
        {   exp = zitrus, set, "Orange,Zitrone,Limone";
        }
    }
    Combo
    {   var = frucht1;
        row = 4;
        multiple;
        label = "Banane","{zitrus}","Kirsche","Kiwi,Pflaume";
    }
    Combo
    {   var = frucht2;
        row = 1;
        numeric;
        label = "Banane","{zitrus}","Kirsche","Kiwi,Pflaume";
        Utilize
        {   exp = frucht2, gen, 3;
        }
    }
    Combo
    {   var = frucht3;
        row = 1;
        numeric;
        multiple;
        label = "Banane","{zitrus}","Kirsche","Kiwi,Pflaume";
    }
}

Das Combo-Objekt kann zwei Darstellungsformen in Abhängigkeit von den Eigenschaften row und multiple annehmen. Wenn die multiple-Eigenschaft gesetzt ist, verwendet der Browser eine Roll-Liste für die Darstellung des Combo-Objektes. Ein Popup-Menü wird verwendet, wenn die row-Eigenschaft den Wert 1 hat. Das letzte Combo-Objekt im Beispiel zeigt eine einzeilige Roll-Liste. Die Substitutionen in diesem Beispiel sind nicht sehr sinnvoll, da der Inhalt des Datenfeldes "zitrus" nicht dynamisch erzeugt wird. Durch die Verwendung von Evaluator-Objekten können Datenfelder für die Substitution dynamisch generiert werden, wodurch Combo-Objekte ein breites Einsatzspektrum erhalten.

Submit -> SingleVarContent -> Content[Evaluator] -> Entry

Eigenschaften:

{htmllist} label

Definiert die Anzahl der Submit-Tasten und die entsprechenden Aufschriften.

boolean link = false

Wenn diese Eigenschaft true ist, werden die Submit-Tasten als Internet-Links dargestellt.

boolean numeric = false

Wenn diese Eigenschaft true ist, wird dem dazugehörigen Datenfeld die Nummer der Taste entsprechend der Position in label zugewiesen.

boolean vertical = false

Die Anordnung der Submit-Tasten erfolgt in vertikaler Ausrichtung, wenn diese Eigenschaft true ist. Standardmässig werden sie horizontal angeordnet.

Beispiel:

maxInactiveInterval = 0;
[padding] = 4;
[spacing] = 0;
[backColor] = khaki;
Table
{   borderColor = orange;
    spacing = 4;
    padding = 0;
    Text
    {   text = "Geben Sie bitte Login und Password an.";
        backColor = orange;
        align = center;
    }
    Frame
    {   padding = 0;
        align = center;
        Row
        {   width = "";
            [height] = 32;
            Layout
            {   [align] = left;
                Text { text = "Login:"; }
                Text { text = "Password:"; }
            }
            Layout
            {   [align] = right;
                [length] = 8;
                [col] = 20;
                Input
                {   var = login;
                }
                Password
                {   var = password;
                }
            }
        }
    }
    Submit
    {   var = ok;
        label = "        OK        ","Abbrechen";
        align = right;
        backColor = orange;
    }
}

In den bisherigen Beispielen fand keine Kommunikation mit dem Server statt, da sie keine Submit-Objekte verwendeten. Dieses Formular kann seine Daten zum Server senden. Ohne Evaluator-Objekte passiert auf der Server-Seite jedoch nichts mit diesen Daten.

MultiVarContent -> Content[Evaluator] -> Entry

Eigenschaften:

stringlist var

Die Eigenschaft var verweist auf die Namen der Datenfelder. Die Datenfelder müssen nicht existieren und können beliebigen Aliasnamen angehören. Im Normalfall können beliebig viele Datenfelder referenziert werden. Das Layout des Objektes richtet sich an der Anzahl der Felder aus. Da Formicula sehr modular aufgebaut ist und demzufolge leicht erweitert werden kann, ist es durchaus denkbar, dass Objekte hinzukommen, die eine vorgegebene Anzahl von Feldern benötigen. Diese Eigenschaft ist eine Pflichtangabe.

Image -> MultiVarContent -> Content[Evaluator] -> Entry

Eigenschaften:

{stringlist} source

Definiert die Pfade zu den Bildern. Diese sollten im "gif"-Format vorliegen.

boolean vertical = false

Die Bilder werden vertikal statt horizontal angeordnet, wenn diese Eigenschaft true ist.

Beispiel:

maxInactiveInterval = 0;
[padding] = 4;
[spacing] = 0;
[backColor] = khaki;
Table
{   borderColor = orange;
    spacing = 4;
    padding = 0;
    Text
    {   text = "Geben Sie bitte Login und Password an.";
        backColor = orange;
        align = center;
    }
    Frame
    {   padding = 0;
        align = center;
        Row
        {   width = "";
            [height] = 32;
            Layout
            {   [align] = left;
                Text
                {   text = "Login:";
                }
                Text
                {   text = "Password:";
                }
            }
            Layout
            {   [align] = right;
                Input
                {   var = login;
                    length = 8;
                    col = 20;
                }
                Password
                {   var = password;
                    length = 8;
                    col = 20;
                }
            }
        }
    }
    Image
    {   var = img.ok, img.cancel;
        source = "../../../execute.gif";
        source = "return.gif";
        backColor = orange;
        align = right;
        padding = 0;
    }
}

Die beiden Bilder werden über die source-Eigenschaften referenziert. Der Pfad der ersten Bildquelle ist relativ. Die zweite Quelle wurde absolut adressiert. Durch klicken auf das erste Bild, erhält der Server die beiden Datenfelder "img.ok.x" und "img.ok.y" mit den Koordinaten des "Klicks". Die Datenfelder von Image-Objekten sollten immer einen Alias (in diesem Fall "img") haben, da sonst die Datenfeldnamen selbst zu Aliasnamen werden (z.B. wäre "ok" der Alias des Datenfeldes "ok.x"). Sie könnten dann ungewollt mit "echten" Aliasnamen kollidieren. Die Felder "img.ok" und "img.cancel" werden durch dieses Objekt nicht generiert.

Likert -> MultiVarContent -> Content[Evaluator] -> Entry

Eigenschaften:

{htmllist} label

Definiert die Anzahl und die Beschreibungen der Skalenpunkte. Es sind auch leere label erlaubt.

{htmllist} info

Mit info werden die einzelnen zur Bewertung ausstehenden Elemente beschrieben.

{html} intro

Dieser Text erscheint als Überschrift über den info-Definitionen.

string evenBackColor

Definiert die Hintergrundfarbe der geraden Elemente.

string oddBackColor

Definiert die Hintergrundfarbe der ungeraden Elemente.

string evenForeColor

Definiert die Textfarbe der geraden Elemente.

string oddForeColor

Definiert die Textfarbe der ungeraden Elemente.

boolean random = false

Ist diese Option true, werden die Elemente zufällig angeordnet. Dadurch können Verzerrungen in den erhobenen Daten vermieden werden, die bei langen Likert-Tafeln auftreten. Elemente die am Ende der Likert-Tafel stehen, werden in der Regel nicht so aufmerksam ausgefüllt wie Elemente am Anfang. Durch die zufällige Anordnung wird die Auswirkung dieses Effektes auf die gesamte Tafel verteilt.

string spread = 50%

Mit dem spread wird die relative bzw. absolute Breite des Skalenbereiches definiert.

int depth = 0

Definiert die minimale Höhe eines Elements in Pixeln.

int margin = 2

Gibt das interne Padding der Likert-Tafel an.

Beispiel:

maxInactiveInterval = 0;
[padding] = 4;
[spacing] = 0;
[backColor] = khaki;
Table
{   borderColor = orange;
    spacing = 4;
    padding = 0;
    Likert
    {   var = banane, kirsche, kiwi, pflaume, zitrone, orange, andere;
        label = gut,,schlecht;
		label = "<i>nie probiert</i>";
        info = Banane, Kirsche, Kiwi, Pflaume, Zitrone, Orange;
		info = "Andere Fr&uuml;chte";
        intro = "Wie schmecken Ihnen folgende Fr&uuml;chte...";
        spread = 300;
        oddBackColor = orange;
    }
}

Ein Objekt der Likert-Klasse könnte theoretisch mit einer Kombination diverser Group-, Text- und Radio-Objekte gebildet werden. Praktisch ist das jedoch sehr umständlich und das Likert-Objekt bietet zusätzlich den Vorteil der random-Eigenschaft.

Check -> MultiVarContent -> Content[Evaluator] -> Entry

Eigenschaften:

{htmllist} label

Definiert die Texte der Optionen, die markiert werden können.

boolean vertical = false

Ist diese Eigenschaft true, werden die Optionen vertikal statt horizontal angeordnet.

boolean left = false

Ist diese Eigenschaft true, werden die Optionen links von den Markierungskästchen angeordnet.

boolean wide = false

Diese Eigenschaft wirkt sich nur bei einer vertikalen Anordnung aus (siehe vertical). Ist sie gesetzt haben die Optionen immer den größt möglichen Abstand zu den Markierungskästchen. Dadurch entsteht immer eine blockartige Ausrichtung. Die Breite des Blockes ist von der Eigenschaft spread abhängig.

string spread

Diese Eigenschaft gibt die absolute (Pixelangabe) bzw. relative (Prozentangabe) Breite des gesamten Check-Objektes an. Wenn diese Angabe fehlt oder leer ist wird die Breite dynamisch angepasst. Durch Verwendung von spread können mehrere Check-Objekte einheitlich ausgerichtet werden.

int depth = 0

Mit depth kann die minimale Höhe einer Zeile des Check-Objektes definiert werden. Bei horizontaler Ausrichtung gibt es nur eine Zeile.

int margin = 2

Die Eigenschaft margin entspricht dem padding der einzelnen Elemente des Check-Objektes. Je grösser dieser Wert ist desto grösser sind die Abstände zwischen den Elementen (Optionen, Kästchen), und um so aufgelockerter ist das Erscheinungsbild.

Beispiel:

maxInactiveInterval = 0;
[padding] = 0;
[spacing] = 0;
[backColor] = khaki;
Table
{   padding = 4;
    spacing = 4;
    borderColor = orange;
    Layout
    {   Text
        { text = "Was kommt in den Obstsalat?";
        }
        Check
        {   var = aepfel, bananen, kirschen, erdbeeren;
            label = "Äpfel", "Bananen", "Kirschen", "Erdbeeren";
        }
    }
    Layout
    {   Text
        { text = "Was kommt in den Obstsalat?";
        }
        Check
        {   var = aepfel, bananen, kirschen, erdbeeren;
            spread = "100%";
            left;
            label = "Äpfel", "Bananen", "Kirschen", "Erdbeeren";
        }
    }
    Layout
    {   Text { text = "Was kommt in den Obstsalat?"; }
        Check
        {   var = aepfel, bananen, kirschen, erdbeeren;
            vertical;
            margin = 0;
            wide;
            spread = "50%";
            label = "Äpfel", "Bananen", "Kirschen", "Erdbeeren";
        }
    }
}

Matrix -> MultiVarContent -> Content[Evaluator] -> Entry

Eigenschaften:

{htmllist} label

Definiert die Anzahl und die Beschreibungen der Spalten. Es sind auch leere label erlaubt.

{htmllist} info

Mit info werden die Zeilen beschrieben.

{html} intro

Dieser Text erscheint als Überschrift über den info-Definitionen.

string evenBackColor

Definiert die Hintergrundfarbe der geraden Zeilen.

string oddBackColor

Definiert die Hintergrundfarbe der ungeraden Zeilen.

string evenForeColor

Definiert die Textfarbe der geraden Zeilen.

string oddForeColor

Definiert die Textfarbe der ungeraden Zeilen.

boolean random = false

Ist diese Option true, werden die Zeilen zufällig angeordnet. Dadurch können Verzerrungen in den erhobenen Daten vermieden werden, die bei langen Matrizen auftreten. Zeilen die am Ende der Matrix stehen, werden in der Regel nicht so aufmerksam ausgefüllt wie Zeilen am Anfang. Durch die zufällige Anordnung wird die Auswirkung dieses Effektes auf die gesamte Matrix verteilt.

string spread = 50%

Mit dem spread wird die relative bzw. absolute Breite des Spaltenbereiches definiert.

int depth = 0

Definiert die minimale Höhe einer Zeile in Pixeln.

int margin = 2

Gibt das interne Padding der Matrix an.

Beispiel:

maxInactiveInterval = 0;
[padding] = 4;
[spacing] = 0;
[backColor] = khaki;
Table
{   borderColor = orange;
    spacing = 4;
    padding = 0;
    Matrix
    {   var = banane1, banane2, banane3;
		var = kirsche1, kirsche2, kirsche3;
		var = kiwi1, kiwi2, kiwi3;
		var = pflaume1, pflaume2, pflaume3;
		var = zitrone1, zitrone2, zitrone3;
		var = andere1, andere2, andere3;
        label = "gewürfelt", "in Scheiben", gepresst;
        info = Banane, Kirsche, Kiwi, Pflaume, Zitrone, "Andere Früchte";
        intro = "Wie kommt was in den Obstsalat?";
        spread = 50%;
        oddBackColor = orange;
    }
}

Evaluator[Evaluator, Operator]

Eigenschaften:

stringlist exp

Die Operator-Objekte werden nicht über die herkömmliche Scope-Struktur definiert. Alle Elemente der Stringliste von exp werden speziell geparst. Jeder Eintrag entspricht entweder einem Datenfeldnamen, dem Namen einer Operator-Klasse oder einer Konstanten. Die grundlegende Struktur hat folgenden Aufbau:
Datenfeldname, Operator-Klassenname, Parameter1,...,Parametern
Die Anzahl der Parameter ist abhängig von der Operator-Klasse. Ein Parameter ist entweder der Name eines Datenfeldes oder eine Konstante. Manipuliert wird immer das Datenfeld links vom Operator. Die exp-Eigenschaft kann beliebig viele Operatoren enthalten.

boolean and = true

Diese Eigenschaft legt den boolschen Modus fest. Es kann immer nur ein Modus vorgegeben werden. Sobald ein Container-Objekt (Evaluator, Operator) den Wert false zurück gibt, wird die Auswertung mit dem Resultat false beendet. Der Evaluator ist true, wenn alle Objekte true sind.

boolean or = false

Diese Eigenschaft legt den boolschen Modus fest. Es kann immer nur ein Modus vorgegeben werden. Sobald ein Container-Objekt (Evaluator, Operator) den Wert true zurück gibt, wird die Auswertung mit dem Resultat true beendet. Der Evaluator ist false, wenn alle Objekte false sind.

boolean all = false

Diese Eigenschaft legt den boolschen Modus fest. Es kann immer nur ein Modus vorgegeben werden. Alle Container-Objekte (Evaluator, Operator) werden unabhängig von ihrem Resultat ausgewertet. Der Evaluator ist nur dann true, wenn alle Objekte true sind.

boolean any = false

Diese Eigenschaft legt den boolschen Modus fest. Es kann immer nur ein Modus vorgegeben werden. Alle Container-Objekte (Evaluator, Operator) werden unabhängig von ihrem Resultat ausgewertet. Der Evaluator ist true, wenn mindestens ein Objekt true ist.

Utilize -> Evaluator[Evaluator, Operator]

BaseEvaluator -> Evaluator[Evaluator, Operator]

Eval -> BaseEvaluator -> Evaluator[Evaluator, Operator]

Beispiel:

maxInactiveInterval = 0;
Frame
{   border = 1;
    Text
    {   text = "A = 3<br>B = 4<br>C = 1<br>(A < 5) and (B = 7 or C = 1) = {x}";
        Utilize
        {   Eval { exp = a, set, 3, b, set, 4, c, set, 1, x, set, "false"; }
            Eval
            {   Eval
                {   exp = a, lt, 5;
                }
                Eval
                {   or;
                    exp = b, eq, 7;
                    exp = c, eq, 1;
                }
            }
            Eval { exp = x, set, "true"; }
        }
    }
}

In diesem Beispiel wird ein einfacher Ausdruck ausgewertet. Das Resultat wird über das Feld "x" in dem Text substituiert. Die Auswertung befindet sich in einem Utilize-Evaluator, damit "x" vor der Generierung der Seite definiert ist. Im ersten Eval erfolgt die Initialisierung der Datenfelder. Der set-Operator ist immer true. Das zweite Eval-Objekt wertet den Ausdruck aus. Jede Klammer wird durch ein Eval-Objekt repräsentiert. Die Operatoren lt und eq stehen für "lesser than" bzw. "equal". Der letzte Evaluator wird nur dann ausgewertet, wenn das vorherige Evaluator-Objekt true ist.

Not -> BaseEvaluator -> Evaluator[Evaluator, Operator]

Beispiel:

maxInactiveInterval = 0;
Frame
{   border = 1;
    Text
    {   text = "A = 3<br>B = 4<br>C = 1<br>(A < 5) and not(B != 7 or C > 1) = {x}";
        Utilize
        {   Eval
            {   exp = a, set, 3, b, set, 4, c, set, 1, x, set, "false";
            }
            Eval
            {   and;
                Eval
                {   exp = a, lt, 5;
                }
                Not
                {   Eval
                    {   or;
                        exp = b, ne, 7;
                        exp = c, eq, 1;
                    }
                }
            }
            Eval
            {   exp = x, set, "true";
            }
        }
    }
}

True -> BaseEvaluator -> Evaluator[Evaluator, Operator]

False -> BaseEvaluator -> Evaluator[Evaluator, Operator]

Catch -> BaseEvaluator -> Evaluator[Evaluator, Operator]

Loop -> BaseEvaluator -> Evaluator[Evaluator, Operator]

Beispiel:

maxInactiveInterval = 0;
Frame
{   border = 1;
    Text
    {   text = "Countdown: {count}";
        Utilize
        {   Eval
            {   exp = count, set, "10";
                exp = i, set, 10;
            }
            Loop
            {   exp = i, sub, 1;
                exp = i, ge, 1;
                exp = count, join, "...", count, join, i;
            }
            Eval
            {   exp = count, join, "...IGNITION";
            }
        }
    }
}

In diesem Beispiel wird ein Countdown mittels Loop-Evaluator abgezählt. Das Datenfeld "i" wird solange dekrementiert bis es kleiner als 1 ist. Dann ist die Loop-Auswertung false. Der nachfolgende Evaluator wird trotzdem ausgeführt, weil Loop immer true zurück gibt. Der join Operator verknüpft Zeichenketten. Der sub-Operator führt eine Subtraktion aus.

FunctionEvaluator -> Evaluator[Evaluator, Operator]

NavigationEvaluator -> FunctionEvaluator -> Evaluator[Evaluator, Operator]

Jump -> NavigationEvaluator -> FunctionEvaluator -> Evaluator[Evaluator, Operator]

Eigenschaften:

{string} jump

Gibt den Namen der Zielseite (Group) an, die nach der Auswertung dargestellt werden soll. Bei der Angabe des Namens muss Gross- und Kleinschreibung beachtet werden.

Beispiel:

Frame
{   Submit
    {   var = go;
        label = "Seite1", "Seite2", "Ende";
        Eval
        {   or;
            Jump
            {   exp = go, eq, "Seite1";
                jump = Seite1;
            }
            Jump
            {   exp = go, eq, "Seite2";
                jump = Seite2;
            }
            Jump
            {   jump = Ende;
            }
        }
// Alternative:  Jump { jump = "{go}"; }
    }
}
Frame Seite1
{   Text
    {   text = "Das ist Seite 1";
        Utilize { Exit {} }
    }
}
Frame Seite2
{   Text
    {   text = "Das ist Seite 2";
        Utilize { Exit {} }
    }
}
Frame Ende
{   Text
    {   text = "Das ist das Ende";
        Utilize { Exit {} }
    }
}

Skip -> NavigationEvaluator -> FunctionEvaluator -> Evaluator[Evaluator, Operator]

Eigenschaften:

int skip = 0

Gibt die relative Position der Zielseite in Bezug auf die aktuelle Seite an. Die Angabe kann auch negativ sein.

Beispiel:

Frame
{   Submit
    {   var = go;
        label = "Seite1", "Seite2", "Ende";
        Eval
        {   or;
            Skip
            {   exp = go, eq, "Seite1";
                skip = 1;
            }
            Skip
            {   exp = go, eq, "Seite2";
                skip = 2;
            }
            Skip
            {   skip = 3;
            }
        }
    }
}
Frame
{   Text
    {   text = "Das ist Seite 1";
        Utilize
        {   Exit {}
        }
    }
}
Frame
{   Text
    {   text = "Das ist Seite 2";
        Utilize
        {   Exit {}
        }
    }
}
Frame
{   Text
    {   text = "Das ist das Ende";
        Utilize
        {   Exit {}
        }
    }
}

Back -> NavigationEvaluator -> FunctionEvaluator -> Evaluator[Evaluator, Operator]

Beispiel:

Frame
{   Submit
    {   var = go;
        label = "Seite1", "Ende";
        Eval
        {   or;
            Skip
            {   exp = go, eq, "Seite1";
                skip = 1;
            }
            Skip { skip = 2; }
        }
    }
}
Frame
{   Text { text = "Das ist Seite 1"; }
    Submit
    {   var = go;
        label = "Weiter","Back";
        Eval
        {   or;
            Back
            {   exp = go, eq, "Back";
            }
            Skip { skip = 1; }
        }
    }
}
Frame
{   Text { text = "Das ist das Ende"; }
    Submit
    {   var = go;
        label = "Back";
        Back {}
    }
}

UtilityEvaluator -> FunctionEvaluator -> Evaluator[Evaluator, Operator]

Eigenschaften:

string alias

Gibt den Aliasnamen der Datenfeldgruppe an auf die sich der UtilityEvaluator bezieht. Wenn die Angabe fehlt oder leer ist, wird der Standardalias verwendet, dem alle Datenfelder ohne spezifischen Alias zugeordnet sind.

Clear -> UtilityEvaluator -> FunctionEvaluator -> Evaluator[Evaluator, Operator]

Eigenschaften:

boolean drop = false

Ist diese Eigenschaft false werden nur die Inhalte der Aliasgruppe gelöscht. Vektoren werden zu einfachen Datenfeldern. Ist diese Eigenschaft true wird die komplette Aliasgruppe aus dem Speicher entfernt. Diese Eigenschaft eignet sich vor allem für temporäre Aliasgruppen.

Copy -> UtilityEvaluator -> FunctionEvaluator -> Evaluator[Evaluator, Operator]

Eigenschaften:

string to

Gibt den Alias-Namen der Datenfeldgruppe an, die als Ziel dient. Wenn die Angabe fehlt oder leer ist, sind die Zielfelder keinem Alias zugeordnet.

boolean append = false

Wenn diese Eigenschaft true ist, werden die Zielfelder zu Vektoren. Die Quellfelder werden als neue Elemente an die Zielfelder angehängt.

boolean full = false

Wenn ein Quellfeld ein Vektor ist wird standardmässig nur das aktuelle Element kopiert. Ist diese Eigenschaft true, werden die kompletten Vektoren kopiert. Eine Kombination mit append ist möglich.

{string} filter = *

Mit filter wird ein Selektionskriterium definiert. Ein "*" steht für beliebig viele Zeichen, während ein "?" genau ein Zeichen repräsentiert. Alle anderen Zeichen im Filter müssen übereinstimmen. So lässt der Filter "*?Fil?er*" z.B. die Begriffe "XFilter", "Der Filzer filzt" durch, verweigert aber den Begriffen "Filter", "Der Filtser Hannes" oder "XFiler" den Durchgang.
Der Copy-Filter wirkt sich auf die zu kopierenden Feldnamen des in from definierten Alias aus. Gross- und Kleinschreibung wird ignoriert.

Level -> UtilityEvaluator -> FunctionEvaluator -> Evaluator[Evaluator, Operator]

Eigenschaften:

{string} name

Mit name wird das Datenfeld spezifiziert, nach dessen Index alle anderen Datenfelder der Aliasgruppe synchronisiert werden. Aliasangaben werden ignoriert.

Gather -> UtilityEvaluator -> FunctionEvaluator -> Evaluator[Evaluator, Operator]

Eigenschaften:

string value

Mit value wird ein Datenfeld spezifiziert, welches alle Inhalte der Aliasgruppe alias als Vektor aufnimmt. Wenn nur die Namen der Gruppe von Interesse sind, kann diese Angabe entfallen.

string name

Mit name wird ein Datenfeld spezifiziert, welches alle Datenfeldnamen der Aliasgruppe alias als Vektor aufnimmt. Wenn nur die Inhalte der Gruppe von Interesse sind, kann diese Angabe entfallen.

Beispiel:

maxInactiveInterval = 0;
Layout
{	border = 0;
	Text
    {   text = "Formicula-Systemfelder:<br>\n{system}";
        subHtml;
        Utilize
        {   Gather
            {   alias = formicula;
                name = sysname;
                value = sysvalue;
            }
            Eval
            {   exp = system, set, "";
            }
            Loop
            {   exp = system, build, "{system}{sysname} = {sysvalue}<br>\n";
                exp = sysname, moveind, 1;
                exp = sysvalue, moveind, 1;
            }
            Exit {}
        }
    }
}

Die hier aufgelisteten Systemfelder sind dem Alias "formicula" zugeordnet. Die Namen und Inhalte werden mit dem Gather-Evaluator in die Datenfelder "sysname" und "sysvalue" als Vektoren übertragen. Die Vektoren werden in einem Loop-Evaluator Element für Element abgearbeitet. Der Operator moveind verschiebt den internen Index eines Vektors entsprechend der Parameterangabe. Er gibt false zurück, wenn eine Verletzung der Indexgrenzen stattfinden würde, womit auch die Schleife beendet wird. Der build-Operator erlaubt die Angabe von Zeichenketten mit Substitutionen. Mit jedem Schritt wird das Datenfeld "system" um eine Zeile erweitert. Aufgrund des Substitutionsmodus in Text wird das Html-Tag "<br>" im Datenfeld "system" nicht maskiert. Die Escape-Sequenz "\n" (Zeilenwechsel) hat keine Auswirkung auf die Darstellung der Seite. Sie dient nur der etwas schöneren Aufbereitung des generierten Html-Codes.

Scatter -> UtilityEvaluator -> FunctionEvaluator -> Evaluator[Evaluator, Operator]

Eigenschaften:

string name

Mit name wird ein Vektor spezifiziert, der Datenfeldnamen enthält. Diese werden entsprechend der Angabe bei alias zu echten Datenfeldern.

string value

Mit value wird ein Vektor spezifiziert, der die Inhalte zu den generierten Datenfeldern enthält. Wenn die Angabe fehlt oder leer ist oder die Vektorgrösse kleiner als die von name ist, werden die restlichen Felder mit dem Leerwert initialisiert.

Beispiel:

maxInactiveInterval = 0;
Frame
{   border = 1;
    Text
    {   text = "Sie sind Client {sys.client}. Ihre ID lautet {sys.sessionid}.";
        subHtml;
        Utilize
        {   Gather
            {   alias = formicula;
                name = sysname;
                value = sysvalue;
            }
            Scatter
            {   alias = sys;
                name = sysname;
                value = sysvalue;
            }
        }
    }
}

Aus den Systemfeldern der Aliasgruppe "formicula" werden zuerst mit Gather Vektoren generiert. Der Scatter-Evaluator setzt diese in Datenfelder der Aliasgruppe "sys" um.

Filter -> UtilityEvaluator -> FunctionEvaluator -> Evaluator[Evaluator, Operator]

Eigenschaften:

Mit name wird der Vektor spezifiziert, der gefiltert wird. Aliasangaben im Namen werden ignoriert.

boolean single = false

Ist diese Eigenschaft true wirkt sich die Filteroperation nur auf den in name spezifizierten Vektor aus.

boolean exact = false

Ist diese Eigenschaft true, wird Gross- und Kleinschreibung beachtet. Standardmässig findet keine Unterscheidung statt.

boolean inverse = false

Ist diese Eigenschaft true, wirkt sich der Filter umgekehrt aus. Alle Elemente, die nicht zum Filter passen, bleiben erhalten. Der Filter definiert ein Ausschlusskriterium.

{string} filter = *

Mit filter wird ein Selektionskriterium definiert. Ein "*" steht für beliebig viele Zeichen, während ein "?" genau ein Zeichen repräsentiert. Alle anderen Zeichen im Filter müssen übereinstimmen. So lässt der Filter "*?Fil?er*" z.B. die Begriffe "XFilter", "Der Filzer filzt" durch, verweigert aber den Begriffen "Filter", "Der Filtser Hannes" oder "XFiler" den Durchgang.

Beispiel:

maxInactiveInterval = 0;
Layout
{   border = 0;
    Text
    {   text = "Formicula-ID-Systemfelder:<br>\n{system}";
        subHtml;
        Utilize
        {   Gather
            {   alias = formicula;
                name = x.sysname;
                value = x.sysvalue;
            }
            Filter
            {   alias = x;
                name= sysname;
                filter = "*id";
            }
            Eval
            {   exp = system, set, "";
            }
            Loop
            {   exp = system, build, "{system}{x.sysname} = {x.sysvalue}";
                exp = system, join, "<br>\n";
                exp = x.sysname, moveind, 1;
                exp = x.sysvalue, moveind, 1;
            }
        }
    }
}

Dieses Beispiel ist eine Erweiterung des Beispiels für den Gather-Evaluator. Der Filter lässt nur die Elemente des "sysname" Datenvektors mit der Endung "id" durch. Da die korrespondierenden Elemente in "sysvalue" ebenfalls gefiltert werden sind beide Vektoren synchron.

Dir -> UtilityEvaluator -> FunctionEvaluator -> Evaluator[Evaluator, Operator]

Eigenschaften:

{string} path = .

Diese Eigenschaft spezifiziert das Verzeichnis. Standardmässig wird das Arbeitsverzeichnis des Servers verwendet. Für die Pfadangaben können auch "/" (Slash) statt "\" (Backslash) verwendet werden. Da letztere auch Escapesequenzen einleiten müssen sie durch "\\" (doppeltes Backslash) maskiert werden.

{string} filter = *

Mit filter wird ein Selektionskriterium definiert. Ein "*" steht für beliebig viele Zeichen, während ein "?" genau ein Zeichen repräsentiert. Alle anderen Zeichen im Filter müssen übereinstimmen. So lässt der Filter "*?Fil?er*" z.B. die Begriffe "XFilter", "Der Filzer filzt" durch, verweigert aber den Begriffen "Filter", "Der Filtser Hannes" oder "XFiler" den Durchgang. Gross- und Kleinschreibung wird nicht beachtet. Dieser Filter wirkt sich auf die Datei- und Verzeichnisnamen aus. Wenn kein Name den Filter passiert, wird eine leere Inhaltsliste erzeugt. Bezieht sich der Filter auf eine spezifische Datei (das heisst es sind keine Filtersymbole vorhanden) werden die Informationen zu dieser Datei direkt geladen. Dadurch können die Attribute von einzelnen Dateien oder Verzeichnissen schneller ermittelt werden.

boolean sort = false

Ist diese Eigenschaft true werden die Angaben nach dem Dateinamen sortiert.

Beispiel:

Frame
{   border=1;
    Text hihi
    {   text = "<b>{path}<b><br>\n{str}";
        subHtml;
        Utilize
        {   Eval
            {   exp = str, set, "<table width=100%>\n<tr>\n";
                exp = str, join, "<th align=left>name</th>\n";
                exp = str, join, "<th align=right>size</th>\n";
                exp = str, join, "<th align=right>date</th>\n";
                exp = str, join, "<th width=10%>dir</th>\n";
                exp = str, join, "<th width=10%>hidden</th>\n";
                exp = str, join, "<th width=10%>readonly</th>";
                exp = str, join, "\n</tr>\n";
                exp = path, set, "ant", path, topath;
            }
            Dir
            {   alias = d;
                path = "{path}";
                sort;
            }
            Loop
            {   Level
                {   alias = d;
                    name = name;
                    exp = str, build, "{str}<td>{d.name}</td>\n";
                    exp = str, build, "{str}<td align=right>{d.size}</td>\n";
                    exp = str, build, "{str}<td align=right>{d.date}</td>\n";
                    exp = str, build, "{str}<td align=center>{d.dir}</td>\n";
                    exp = str, build, "{str}<td align=center>{d.hidden}</td>\n";
                    exp = str, build, "{str}<td align=center>{d.readonly}</td>";
                    exp = str, join, "\n</tr>\n", d.name, moveind, 1;
                }
            }
            Eval { exp = str, join, "</table>"; }
            Exit {}
        }
    }
}

Der topath-Operator wandelt die relative Verzeichnisangabe "ant" in die absolute Angabe "c:\formicula\ant" um. Das Inhaltsverzeichnis wird im Alias "d" gespeichert. Die Datenvektoren "name", "size", "date", "dir", "hidden" und "readonly" dieses Alias enthalten die Informationen zu den einzelnen Dateien und Unterverzeichnissen. Diese Informationen werden in Form einer dynamisch generierten Html-Tabelle präsentiert.

Sort -> UtilityEvaluator -> FunctionEvaluator -> Evaluator[Evaluator, Operator]

Eigenschaften:

{string} name

Mit name wird der Vektor spezifiziert, der die Sortierung vorgibt. Aliasangaben werden ignoriert.

boolean single = false

Ist diese Eigenschaft true wirkt sich die Sortierung nur auf den in name spezifizierten Vektor aus.

boolean down = false

Ist diese Eigenschaft true wird absteigend sortiert. Die Standardsortierung ist aufsteigend.

boolean exact = false

Ist diese Eigenschaft true wird Gross- und Kleinschreibung beachtet. Standardmässig findet keine Unterscheidung statt.

boolean numeric = false

Ist diese Eigenschaft true wird der Inhalt des Vektors numerisch interpretiert und entsprechend sortiert. Standardmässig findet eine alphanumerische Sortierung statt.

Beispiel:

Frame
{   border=1;
    Text hihi
    {   text = "<b>{path}<b><br>\n{str}";
        subHtml;
        Utilize
        {   Eval
            {   exp = str, set, "<table width=100%>\n<tr>\n";
                exp = str, join, "<th align=left>name</th>\n";
                exp = str, join, "<th align=right>size</th>\n";
                exp = str, join, "<th align=right>date</th>\n";
                exp = str, join, "<th width=10%>dir</th>\n";
                exp = str, join, "<th width=10%>hidden</th>\n";
                exp = str, join, "<th width=10%>readonly</th>\n</tr>\n";
                exp = path, set, "ant", path, topath;
            }
            Dir
            {   alias = d;
                path = "{path}";
            }
            Sort
            {   alias = d;
                name = size;
                numeric;
                down;
            }
            Loop
            {   Level
                {   alias = d;
                    name = name;
                    exp = str, build, "{str}<td>{d.name}</td>\n";
                    exp = str, build, "{str}<td align=right>{d.size}</td>\n";
                    exp = str, build, "{str}<td align=right>{d.date}</td>\n";
                    exp = str, build, "{str}<td align=center>{d.dir}</td>\n";
                    exp = str, build, "{str}<td align=center>{d.hidden}</td>\n";
                    exp = str, build, "{str}<td align=center>{d.readonly}</td>\n</tr>\n";
                    exp = d.name, moveind, 1;
                }
            }
            Eval { exp = str, join, "</table>"; }
            Exit {}
        }
    }
}

Hierbei handelt es sich um eine modifizierte Version des Dir-Beispiels. Die numerische Sortierung nach der Dateigrösse erfolgt absteigend.

VisibilityEvaluator -> FunctionEvaluator -> Evaluator[Evaluator, Operator]

Eigenschaften:

boolean global = false

Ist diese Eigenschaft true wirkt sich der VisibilityEvaluatory auf die gesamte Seite aus.

Hide -> VisibilityEvaluator -> FunctionEvaluator -> Evaluator[Evaluator, Operator]

Show -> VisibilityEvaluator -> FunctionEvaluator -> Evaluator[Evaluator, Operator]

Beispiel:

Layout quiz
{   Text
    {   text = "Durch welches Verfahren schickte man im alten Athen";
        text = "seine Mitbürger in die Verbannung?";
        Error
        {   exp = athen, empty;
            msg = "Antwort erforderlich!";
        }
    }
    Radio
    {   var = athen;
        label = "Götterspeise", "Henkersmahlzeit";
        label = "Scherbengericht", "Grillteller";
        vertical;
    }
    Submit
    {   var = ok;
        label = "OK";
        Skip
        {   skip = 1;
        }
    }
}
Layout aufloesung
{   Frame
    {   Text
        {   backColor = red;
            foreColor = white;
            text = "Das war die falsche Antwort.";
            Utilize
            {   Exit {}
                Hide {}
                Eval { exp = athen, ne, 3; }
                Show {}
                Hide { global; }
            }
        }
    }
    Frame
    {   Text { text = "Sie haben gewonnen!"; }
    }
}

SystemEvaluator -> FunctionEvaluator -> Evaluator[Evaluator, Operator]

Reset -> SystemEvaluator -> FunctionEvaluator -> Evaluator[Evaluator, Operator]

Exit -> SystemEvaluator -> FunctionEvaluator -> Evaluator[Evaluator, Operator]

Eigenschaften:

{string} url

Diese Eigenschaft definiert eine Internetadresse (URL), die nach dem Schließen der Session durch Exit angesprungen wird. Damit kann z.B. wieder zur Seite gesprungen werden, die den Link auf das Formular enthält.

int pause = 0

Mit pause wird die Zeitverzögerung in Sekunden angegeben, bis die mit url definierte Adresse aufgerufen wird. Eine kleine Abschiedsseite könnte so dem Anwender für seine Mühen danken und nach 5 Sekunden verschwinden.

Beispiel:

Frame
{   Text
    {   text = "Vielen Dank, dass Sie mich besucht haben.";
        Utilize
        {   Exit
            {   url = "{formicula.link}";
                pause = 5;
            }
        }
    }
}

Transfer -> SystemEvaluator -> FunctionEvaluator -> Evaluator[Evaluator, Operator]

Eigenschaften:

{string} url

Diese Eigenschaft definiert den Dateinamen eines Formicula-Skriptes. Bei relativen Pfadangaben ist das Standardverzeichnis des Servers zu berücksichtigen. Diese Eigenschaft ist eine Pflichtangabe.

Beispiel:

Row
{   width = "";
    Input
    {   var = login;
        label = "Login: ";
    }
    Submit
    {   var = ok;
        label = "ok","exit";
        Eval
        {   or;
            Transfer
            {   exp = ok, eq, "ok";
                url = "ant/show.ant";
            }
            Exit { url = "{formicula.link}"; }
        }
    }
}

Row
{   width = "";
    Text { text = "Ihr Login war: {login}"; }
    Submit
    {   var = ok;
        label = "ok";
        Transfer { url = "ant/login.ant"; }
    }
}

In dem oberen Skript erfolgt die Eingabe eines Logins. Ein Passwort ist aufgrund der wirklich extrem eingeschränkten Funktionalität dieser Anwendung nicht erforderlich. Der Transfer zum "show"-Skript im Unterverzeichnis "ant" erfolgt nach der Bestätigung der Eingabe mit "ok". Das "show"-Skript wird geladen und das Anwenderobjekt mit dem neuen Formularobjekt verknüpft. Als Beweis für die gelungene Aktion, wird das Login angezeigt. Auch in diesem Formular gibt es eine "ok"-Taste mit der das Anwenderobjekt wieder zum "Login"-Formular zurücktransferiert werden kann.

Log -> SystemEvaluator -> FunctionEvaluator -> Evaluator[Evaluator, Operator]

Eigenschaften:

{stringlist} log

Diese Eigenschaft enthält die Meldung an die Standard-Ausgabe.

Exec -> SystemEvaluator -> FunctionEvaluator -> Evaluator[Evaluator, Operator]

Eigenschaften:

{stringlist} exec

Das erste Element der Eigenschaft exec definiert den Aufruf des Programms. Alle folgenden Elemente der Stringliste werden als Parameter weitergeleitet.

boolean wait = false

Wenn diese Eigenschaft true ist wartet der Evaluator auf die Beendigung des Programms. Standardmässig läuft der exec-Prozess parallel.

MessageEvaluator -> FunctionEvaluator -> Evaluator[Evaluator, Operator]

Eigenschaften:

{htmllist} msg

Die Eigenschaft msg enthält die Nachricht. Substitutionen werden direkt bei der Auswertung ausgeführt. Diese Eigenschaft ist eine Pflichtangabe.

Error -> MessageEvaluator -> FunctionEvaluator -> Evaluator[Evaluator, Operator]

Valid -> MessageEvaluator -> FunctionEvaluator -> Evaluator[Evaluator, Operator]

Beispiel:

[msgSpacing] = 2;
Frame
{   border = 1 ;
    Input
    {   var = c;
        label = "Wieviel ist {a} + {b}:";
        Utilize
        {   Eval
            {   exp = a, free;
                exp = a, rand, a, mul, 10, a, add, 1, a, trunc;
                exp = b, rand, b, mul, 10, b, add, 1, b, trunc;
                exp = x, set, a, x, add, b;
            }
        }
        Valid
        {   exp = c, isnum;
            msg = "Nur numerische Eingaben erlaubt.";
        }
        Eval
        {   or;
            Eval { exp = x, eq, c; }
            Error
            {   msg = "Falsche Antwort. Die Summe ist {x}.";
            }
        }
    }
    Submit
    {   var = ok;
        label = "OK";
        Exit {}
    }
}

In diesem Beispiel wird eine kleine Rechenaufgabe gestellt. Im Utilize-Evaluator werden die Datenfelder "a" und "b" mit zufälligen Zahlenwerten zwischen 1 und 10 initialisiert. Der Operator rand liefert eine Zufallszahl zwischen 0 (einschliesslich) und 1 (ausschliesslich). Der Operator mul führt eine Multiplikation durch, add eine Addition und trunc schneidet die Kommastellen ab. Das Feld "x" enthält die Summe. Mit dem Operator free wird die Existenz des Datenfeldes "a" geprüft, damit die Felder nur einmal initialisiert werden.
Der Valid-Evaluator prüft, ob die Eingabe von "c" numerisch ist. Wenn das nicht der Fall ist, wird eine Fehlernachricht gemeldet. Der Error-Evaluator wird nur aufgerufen, wenn "c" ungleich der wahren Summe "x" ist. Diese Konstruktion hätte einfacher durch einen Valid-Evaluator realisiert werden können.

DataEvaluator -> FunctionEvaluator -> Evaluator[Evaluator, Operator]

Eigenschaften:

string handle

Da mehrere Verbindungen zu Datenbanken parallel aufgebaut werden können muss über diese Eigenschaft zwischen den unterschiedlichen Verbindungen differenziert werden. Das handle ist ein Bezeichner für die Verbindung. Er muss bei jedem DataEvaluator angegeben werden, es sei denn es wird nur eine Verbindung benötigt. Als Standard wird ein leerer Bezeichner verwendet.

Connect -> DataEvaluator -> FunctionEvaluator -> Evaluator[Evaluator, Operator]

Eigenschaften:

{string} driver

Hier muss der Name des JDBC-Treibers für die Datenbank angegeben werden. Solche Treiber werden bei den meisten Datenbanken mitgeliefert. Er muss über die CLASSPATH Systemvariable lokalisierbar sein. In der Regel bietet der Web-Server auch ein spezielles Verzeichnis an, in das die Klassenverzeichnisse aller Hilfsklassen kopiert werden können. Dieses Verzeichnis wird automatisch im CLASSPATH registriert. Auch das Formicula-Klassenverzeichnis befindet sich normalerweise darin.
Ein Treiber wird immer nur einmal geladen und muss nicht bei jedem Aufruf von Connect spezifiziert werden. Es ist möglich Treiber von verschiedenen Datenbanken zu laden.

{string} connection

Mit connection wird die Verbindung zur Datenbank hergestellt. Die Angabe enthält die Kennung des zu verwendeten Treibers und die Adresse der Datenbank. In Zusammenspiel mit dem Treiber ermöglicht er den Verbindungsaufbau mit der Datenbank. Wenn diese Angabe fehlt wird nur der Treiber geladen. Der Aufbau des Connection-Strings ist der Dokumentation für die JDBC-Komponenten der Datenbank zu entnehmen.

{string} user

Der user einer Datenbank bezeichnet das Login für einen bestimmten Datenbankbereich. Mit dem user sind die Zugriffsrechte auf die Datenbank verknüpft. In der Regel versteht man unter einem user eine ganze Gruppe von Anwendern. Nicht alle Datenbanken verlangen die Angabe von user oder password.

{string} password

Mit dem password muss sich der user bei der Datenbank authentisieren. Nicht alle Datenbanken verlangen die Angabe von user oder password.

Beispiel:

Layout
{   Dummy
    {   Connect
        {   driver = "JData2_0.sql.$Driver";
            connection = "jdbc:JDataConnect://127.0.0.1/test";
        }
        Disconnect {}
        Exit {}
    }
}

Disconnect -> DataEvaluator -> FunctionEvaluator -> Evaluator[Evaluator, Operator]

Select -> DataEvaluator -> FunctionEvaluator -> Evaluator[Evaluator, Operator]

Eigenschaften:

{string} table

Mit table muss ein Tabellenname der Datenbank spezifiziert werden.

string alias

Die Ergebnisdatenfelder werden unter dieser Aliasgruppe gespeichert. Wenn die Angabe fehlt oder leer ist, wird table als Aliasname verwendet.

stringlist field

Diese Liste enthält die Namen der Tabellenfelder, die selektiert und in die Ergebnisdatenfelder übernommen werden sollen. Wenn diese Angabe fehlt oder leer ist, werden alle Tabellenfelder übernommen.

{stringlist} sql

Diese Eigenschaft definiert die SQL-Klauseln nach der "from"-Klausel. Datenfelder können integriert werden, in dem sie in eckige Klammern gesetzt werden. Dabei ist zu beachten, dass sie die gleichen Namen wie Felder der Tabelle haben. Der Typ des Tabellenfeldes bestimmt dann die Umformung des typenlosen Datenfeldes. Nur so kann die korrekte Generierung der SQL-Anweisung gewährleistet werden. Der Aliasname des Datenfeldes spielt dabei keine Rolle. Grundsätzlich sollten alle typenspezifischen Merkmale wie z.B. Anführungszeichen bei Zeichenketten bei der Integration von Datenfeldern vermieden werden. Zusätzlich unterstützt die SQL-Eigenschaft die Standardsubstitution, die vor der Integration durchgeführt wird.

boolean save = false

Wenn diese Eigenschaft true ist, wird das Ergebnis der Abfrage intern unter dem in alias definierten Namen gesichert. Dieser Name dient als Referenz für andere DataEvaluator-Objekte, die sich die Ergebnisse von Abfragen beziehen (siehe Next-Evaluator).

Beispiel:

Frame
{   border = 1;
    Text
    {   text = "<b>Mitarbeiter mit hohem Gehalt:\n{liste}";
        subHtml;
        Utilize
        {   Eval
            {   exp = sql.gehalt, set, 4000;
                exp = where, set, "gehalt >= [sql.gehalt]";
                exp = order, set, "order by gehalt";
                exp = liste, set, "<table cellspacing=4>\n";
                exp = liste, join, "<tr><th align=left>ID</th>";
                exp = liste, join, "<th align=left>Name</th>";
                exp = liste, join, "<th align=right>Gehalt</th></tr>\n";
            }
            Connect
            {   driver = "JData2_0.sql.$Driver";
                connection = "jdbc:JDataConnect://127.0.0.1/test";
            }
            Select
            {   sql = "where {where} {order}";
                table = mitarbeiter;
                alias = ma;
                save;
            }
            Eval
            {   exp = liste, build, "{liste}<tr><td>{ma.id}</td>";
                exp = liste, build, "{liste}<td>{ma.vorname} {ma.name}</td>";
                exp = liste, build, "{liste}<td align=right>{ma.gehalt}</td>";
                exp = liste, build, "{liste}</tr>\n";
            }
            Loop
            {   Next { alias = ma; }
                Eval
                { exp = liste, build, "{liste}<tr><td>{ma.id}</td>";
                  exp = liste, build, "{liste}<td>{ma.vorname} {ma.name}</td>";
                  exp = liste, build, "{liste}<td align=right>{ma.gehalt}</td>";
                  exp = liste, build, "{liste}</tr>\n";
                }
            }
            Eval { exp = liste, join, "</table>"; }
        }
        Utilize
        {   Disconnect {}
            Exit {}
        }
    }
}

In diesem Beispiel erfolgt ein Zugriff auf die lokale Beispieldatenbank "test". Der Select-Evaluator selektiert alle Datensätze aus der Mitarbeiter-Tabelle mit einem Gehalt größer gleich 4000. Die SQL-Klausel wird über die Substitution der Felder "where" und "order" gebildet. Das Datenfeld "sql.gehalt" hat den gleichen Namen wie das Bezugsfeld in der Tabelle, damit es typenspezifisch integriert werden kann. Nach der Selektion werden die Ergebnisfelder des Alias "ma" in Form einer Html-Tabelle in das Datenfeld "liste" transferiert. Der Loop-Evaluator arbeitet das Ergebnis Datensatz für Datensatz ab. Mit Next wird jeweils der nächste Ergebnissatz in die Datenfelder des Alias "ma" geladen. Sind keine Ergebnisse mehr vorhanden, gibt Next den Wert false zurück, womit die Loop-Schleife beendet wird. Im zweiten Utilize-Evaluator wird die Verbindung explizit geschlossen.

Update -> DataEvaluator -> FunctionEvaluator -> Evaluator[Evaluator, Operator]

Eigenschaften:

{string} table

Mit table muss ein Tabellenname der Datenbank spezifiziert werden.

string alias

Diese Eigenschaft enthält den Aliasnamen der Datenfelder, die für die Aktualisierung der gleichnamigen Tabellenfelder verwendet werden. Wenn die Angabe fehlt oder leer ist, wird table als Aliasname verwendet.

stringlist field

Diese Liste enthält die Namen der Tabellenfelder, die aktualisiert werden sollen. Wenn die Angabe fehlt oder leer ist, versucht der Update-Evaluator alle Tabellenfelder mit den gleichnamigen Datenfelder der Aliasgruppe alias zu aktualisieren. Die in field definierten Felder sind eine Teilmenge der Aliasgruppe.

{stringlist} sql

Diese Eigenschaft definiert die SQL-Klauseln nach der "from"-Klausel. Datenfelder können integriert werden, indem sie in eckige Klammern gesetzt werden. Dabei ist zu beachten, dass sie die gleichen Namen wie Felder der Tabelle haben. Der Typ des Tabellenfeldes bestimmt dann die Umformung des typenlosen Datenfeldes. Nur so kann die korrekte Generierung der SQL-Anweisung gewährleistet werden. Der Aliasname des Datenfeldes spielt dabei keine Rolle. Grundsätzlich sollten alle typenspezifischen Merkmale wie z.B. Anführungszeichen bei Zeichenketten bei der Integration von Datenfeldern vermieden werden. Zusätzlich unterstützt die SQL-Eigenschaft die Standardsubstitution, die vor der Integration durchgeführt wird.

Beispiel:

Frame
{   border = 1;
    Text
    {   text = "<b>Mitarbeiter mit hohem Gehalt:\n{liste}";
        subHtml;
        Utilize
        {   Eval
            {   exp = liste, set, "<table cellspacing=4>\n";
                exp = liste, join, "<tr><th align=left>ID</th>";
                exp = liste, join, "<th align=left>Name</th>";
                exp = liste, join, "<th align=right>Gehalt</th></tr>\n";
            }
            Connect
            {   driver = "JData2_0.sql.$Driver";
                connection = "jdbc:JDataConnect://127.0.0.1/test";
            }
            Update
            {   exp = new.gehalt, set, 7000;
                sql = "where id = 5";
                table = mitarbeiter;
                alias = new;
                field = gehalt;
            }
            Select
            {   sql = "where gehalt >= 4000 order by gehalt";
                table = mitarbeiter;
                alias = ma;
                save;
            }
            Eval
            {   exp = liste, build, "{liste}<tr><td>{ma.id}</td>";
                exp = liste, build, "{liste}<td>{ma.vorname} {ma.name}</td>";
                exp = liste, build, "{liste}<td align=right>{ma.gehalt}</td>";
                exp = liste, build, "{liste}</tr>\n";
            }
            Loop
            {   Next
                {   alias = ma;
                }
                Eval
                { exp = liste, build, "{liste}<tr><td>{ma.id}</td>";
                  exp = liste, build, "{liste}<td>{ma.vorname} {ma.name}</td>";
                  exp = liste, build, "{liste}<td align=right>{ma.gehalt}</td>";
                  exp = liste, build, "{liste}</tr>\n";
                }
            }
            Eval
            {   exp = liste, join, "</table>";
            }
        }
        Utilize
        {   Disconnect {}
            Exit {}
        }
    }
}

Der Mitarbeiter, dessen Feld "ID" gleich 5 ist, erhält eine Gehaltserhöung auf 7000. Für die Aktualisierung von Tabellenfeldern mit dem Update-Evaluator dürfen nur Datenfelder, die einer Aliasgruppe angehören, verwendet werden. Das Datenfeld "new.gehalt" aktualisiert das Tabellenfeld "gehalt" der "Mitarbeiter"-Tabelle. In diesem Fall ist die Angabe der field-Eigenschaft überflüssig, da die Aliasgruppe "new" keine Felder enthält, die nicht zur Aktualisierung herangezogen werden sollen. Trotzdem ist es sinnvoll field anzugeben, damit die Intention des Updates deutlich wird.

Delete -> DataEvaluator -> FunctionEvaluator -> Evaluator[Evaluator, Operator]

Eigenschaften:

{string} table

Mit table muss ein Tabellenname der Datenbank spezifiziert werden.

{stringlist} sql

Diese Eigenschaft definiert die SQL-Klauseln nach der "from"-Klausel. Datenfelder können integriert werden, indem sie in eckige Klammern gesetzt werden. Dabei ist zu beachten, dass sie die gleichen Namen wie Felder der Tabelle haben. Der Typ des Tabellenfeldes bestimmt dann die Umformung des typenlosen Datenfeldes. Nur so kann die korrekte Generierung der SQL-Anweisung gewährleistet werden. Der Aliasname des Datenfeldes spielt dabei keine Rolle. Grundsätzlich sollten alle typenspezifischen Merkmale wie z.B. Anführungszeichen bei Zeichenketten bei der Integration von Datenfeldern vermieden werden. Zusätzlich unterstützt die SQL-Eigenschaft die Standardsubstitution, die vor der Integration durchgeführt wird.

Beispiel:

Frame
{   border = 1;
    Text
    {   text = "<b>Mitarbeiter:\n{liste}";
        subHtml;
        Utilize
        {   Eval
            {   exp = liste, set, "<table cellspacing=4>\n";
                exp = liste, join, "<tr><th align=left>ID</th>";
                exp = liste, join, "<th align=left>Name</th>";
                exp = liste, join, "<th align=right>Gehalt</th></tr>\n";
            }
            Connect
            {   driver = "JData2_0.sql.$Driver";
                connection = "jdbc:JDataConnect://127.0.0.1/test";
            }
            Delete
            {   sql = "where id = 5";
                table = mitarbeiter;
            }
            Select
            {   sql = "order by id";
                table = mitarbeiter;
                alias = ma;
                save;
            }
            Eval
            {   exp = liste, build, "{liste}<tr><td>{ma.id}</td>";
                exp = liste, build, "{liste}<td>{ma.vorname} {ma.name}</td>";
                exp = liste, build, "{liste}<td align=right>{ma.gehalt}</td>";
                exp = liste, build, "{liste}</tr>\n";
            }
            Loop
            {   Next { alias = ma; }
                Eval
                { exp = liste, build, "{liste}<tr><td>{ma.id}</td>";
                  exp = liste, build, "{liste}<td>{ma.vorname} {ma.name}</td>";
                  exp = liste, build, "{liste}<td align=right>{ma.gehalt}</td>";
                  exp = liste, build, "{liste}</tr>\n";
                }
            }
            Eval { exp = liste, join, "</table>"; }
        }
        Utilize
        {   Disconnect {}
            Exit {}
        }
    }
}

Dieses Beispiel entspricht bis auf ein paar kleine Änderungen dem Update-Beispiel. Statt einem Update wird ein Delete ausgeführt. Die Liste umfasst nun alle Mitarbeiter, allerdings ohne den Mitarbeiter mit der Nummer 5.

Insert -> DataEvaluator -> FunctionEvaluator -> Evaluator[Evaluator, Operator]

Eigenschaften:

{string} table

Mit table muss ein Tabellenname der Datenbank spezifiziert werden.

string alias

Diese Eigenschaft enthält den Aliasnamen der Datenfelder, die für die Initialisierung der gleichnamigen Tabellenfelder verwendet werden. Wenn die Angabe fehlt oder leer ist, wird table als Aliasname verwendet.

stringlist field

Diese Liste enthält die Namen der Tabellenfelder, die im neuen Datensatz initialisiert werden sollen. Wenn die Angabe fehlt oder leer ist, initialisiert der Update-Evaluator alle Tabellenfelder mit den gleichnamigen Datenfelder der Aliasgruppe alias. Die in field definierten Felder sind eine Teilmenge der Aliasgruppe.

Beispiel:

Frame
{   border = 1;
    Text
    {   text = "<b>Mitarbeiter:\n{liste}";
        subHtml;
        Utilize
        {   Eval
            {   exp = m.id, set, 13;
                exp = m.name, set, "Knopf";
                exp = m.vorname, set, "Jim";
                exp = liste, set, "<table cellspacing=4>\n";
                exp = liste, join, "<tr><th align=left>ID</th>";
                exp = liste, join, "<th align=left>Name</th>";
                exp = liste, join, "<th align=right>Gehalt</th></tr>\n";
            }
            Connect
            {   driver = "JData2_0.sql.$Driver";
                connection = "jdbc:JDataConnect://127.0.0.1/test";
            }
            Eval
            {   or;
                Select
                {   sql = "where id = [m.id]";
                    table = mitarbeiter;
                }
                Insert
                {   table = mitarbeiter;
                    alias = m;
                }
            }
            Select
            {   sql = "order by id";
                table = mitarbeiter;
                alias = ma;
                save;
            }
            Eval
            {   exp = liste, build, "{liste}<tr><td>{ma.id}</td>";
                exp = liste, build, "{liste}<td>{ma.vorname} {ma.name}</td>";
                exp = liste, build, "{liste}<td align=right>{ma.gehalt}</td>";
                exp = liste, build, "{liste}</tr>\n";
            }
            Loop
            {   Next
                {   alias = ma;
                }
                Eval
                { exp = liste, build, "{liste}<tr><td>{ma.id}</td>";
                  exp = liste, build, "{liste}<td>{ma.vorname} {ma.name}</td>";
                  exp = liste, build, "{liste}<td align=right>{ma.gehalt}</td>";
                  exp = liste, build, "{liste}</tr>\n";
                }
            }
            Eval
            {   exp = liste, join, "</table>";
            }
        }
        Utilize
        {   Disconnect {}
            Exit {}
        }
    }
}

Der Mitarbeiter "Jim Knopf" mit der Nummer "13", wird nur dann hinzugefügt, wenn die Nummer nicht bereits existiert.

SQL -> DataEvaluator -> FunctionEvaluator -> Evaluator[Evaluator, Operator]

Eigenschaften:

string alias

Wenn die sql-Eigenschaft eine "select"-Anweisung ist, werden die Ergebnisdatenfelder unter dieser Aliasgruppe gespeichert. Diese Angabe darf nicht leer sein oder fehlen.

{stringlist} sql

Diese Eigenschaft definiert die komplette SQL-Anweisung. Datenfelder können integriert werden, indem sie in eckige Klammern gesetzt werden. Dabei ist zu beachten, dass sie die gleichen Namen wie Felder der Tabelle haben. Der Typ des Tabellenfeldes bestimmt dann die Umformung des typenlosen Datenfeldes. Nur so kann die korrekte Generierung der SQL-Anweisung gewährleistet werden. Der Aliasname des Datenfeldes spielt dabei keine Rolle. Grundsätzlich sollten alle typenspezifischen Merkmale wie z.B. Anführungszeichen bei Zeichenketten bei der Integration von Datenfeldern vermieden werden. Zusätzlich unterstützt die SQL-Eigenschaft die Standardsubstitution, die vor der Integration durchgeführt wird.

boolean save = false

Wenn diese Eigenschaft true und die sql-Eigenschaft eine "select"-Anweisung ist, wird das Ergebnis der Abfrage intern unter dem in alias definierten Namen gesichert. Dieser Name dient als Referenz für andere DataEvaluator-Objekte, die sich die Ergebnisse von Abfragen beziehen (siehe Next-Evaluator).

Beispiel:

Frame
{   border = 1;
    Text
    {   text = "<b>Abteilungen:</b>\n{liste}";
        subHtml;
        Utilize
        {   Eval
            {   exp = liste, set, "<dl>\n";
                exp = oldabt, set, 0;
            }
            Connect
            {   driver = "JData2_0.sql.$Driver";
                connection = "jdbc:JDataConnect://127.0.0.1/test";
            }
            SQL
            {   sql = "select a.id, a.vorname, a.name, a.abtnr, b.abteilung";
                sql = "from mitarbeiter a, abteilung b";
                sql = "where a.abtnr = b.abtnr order by a.abtnr, a.name";
                alias = ma;
                save;
            }
            Loop
            {   True
                { exp = oldabt, ne, ma.abtnr;
                  exp = oldabt, set, ma.abtnr;
                  exp = liste, build, "{liste}<dt><b>{ma.abteilung}</b></dt>\n";
                }
                Eval
                { exp = liste, build, "{liste}<dd>{ma.vorname} {ma.name}</dd>\n";
                }
                Next
                {   alias = ma;
                }
            }
            Eval
            {   exp = liste, join, "</dl>";
            }
        }
        Utilize
        {   Disconnect {}
            Exit {}
        }
    }
}

Die Definitionsliste ordnet jeder Abteilung die dazugehörigen Mitarbeiter zu. Die SQL-Abfrage verknüpft die "Mitarbeiter"-Tabelle mit der Tabelle "Abteilung" über die Abteilungsnummer "abtnr". Das Ergebnis ist nach der Abteilungsnummer sortiert. Die Sortierung ermöglicht eine Darstellung mit Gruppenwechsel auf Abteilungsebene.

Next -> DataEvaluator -> FunctionEvaluator -> Evaluator[Evaluator, Operator]

Eigenschaften:

string alias

Mit dieser Eigenschaft wird zum einen die Ergebnistabelle und zum anderen die dazugehörige Aliasgruppe referenziert. Die entsprechenden Felder in der Aliasgruppe werden mit den Inhalten der Ergebnisfelder überschrieben.

Commit -> DataEvaluator -> FunctionEvaluator -> Evaluator[Evaluator, Operator]

Eigenschaften:

boolean auto = false

Die Verbindung wird nach dem Commit in den automatischen Commit-Modus versetzt, wenn diese Eigenschaft true ist. Alle Vorgänge werden automatisch bestätigt. Dies ist auch die Voreinstellung für neu geöffnete Datenbankverbindungen. Wenn auto nicht true ist, beginnt die nächste Transaktion mit der Bestätigung der aktuellen Transaktion.

Rollback -> DataEvaluator -> FunctionEvaluator -> Evaluator[Evaluator, Operator]

Eigenschaften:

boolean auto = false

Die Verbindung wird nach dem Rollback in den automatischen Commit-Modus versetzt, wenn diese Eigenschaft true ist. Alle Vorgänge werden automatisch bestätigt. Dies ist auch die Voreinstellung für neu geöffnete Datenbankverbindungen. Wenn auto nicht true ist, beginnt die nächste Transaktion mit dem Abbruch der aktuellen Transaktion.

Touch -> DataEvaluator -> FunctionEvaluator -> Evaluator[Evaluator, Operator]

Eigenschaften:

{string} table

Der Touch-Evaluator prüft die Existenz dieser Tabelle. Fehlt diese Angabe, wird nur die Datenbankverbindung getestet.

{stringlist} field

Der Touch-Evaluator prüft die Existenz dieser Tabellenfelder in der Tabelle table. Wenn ein Feld nicht existiert gibt der Evaluator false zurück.

Meta -> DataEvaluator -> FunctionEvaluator -> Evaluator[Evaluator, Operator]

Eigenschaften:

{String} table

Gibt den Namen der Tabelle an, deren Meta-Informationen extrahiert werden.

String alias

Gibt die Aliasgruppe an, unter deren Namen die Meta-Informationen gespeichert werden. Fehlt diese Angabe oder ist sie leer, wird der Tabellenname als Aliasname verwendet.

Beispiel:

Frame
{   border = 1;
    Text
    {   text = "<b>Tabellenstruktur: Mitarbeiter</b><br>\n{str}";
        subHtml;
        Utilize
        {   Connect
            {   driver = "JData2_0.sql.$Driver";
                connection = "jdbc:JDataConnect://127.0.0.1/test";
            }
            Eval
            {   exp = str, set, "<table width=100%>\n<tr>\n";
                exp = str, join, "<th align=left>name</th>";
                exp = str, join, "<th align=right>type</th>";
                exp = str, join, "<th align=right>length</th>";
                exp = str, join, "<th align=right>scale</th>";
                exp = str, join, "<th>nullable</th>";
                exp = str, join, "<th>compatible</th>\n</tr>\n";
            }
            Meta
            {   table = mitarbeiter;
                alias = ma;
            }
            Loop
            { Level
              { alias = ma;
                name = name;
                exp = str, build, "{str}<tr>\n<td>{ma.name}</td>";
                exp = str, build, "{str}<td align=right>{ma.type}</td>";
                exp = str, build, "{str}<td align=right>{ma.length}</td>";
                exp = str, build, "{str}<td align=right>{ma.scale}</td>";
                exp = str, build, "{str}<td align=center>{ma.nullable }</td>";
                exp = str, build, "{str}<td align=center>{ma.compatible}</td>";
                exp = str, join, "\n</tr>\n";
                exp = ma.name, moveind, 1;
              }
            }
            Eval
            {   exp = str, join, "</table>";
            }
        }
        Utilize
        {   Disconnect {}
            Exit {}
        }
    }
}

Die Meta-Informationen der Tabelle "Mitarbeiter" werden in die Aliasgruppe "ma" geladen. Die Typen der Tabellenfelder sind numerisch codiert. Der Code 1 steht für Textfelder, der Code 2 für Zahlenfelder. Die weiteren Codes können mit einer Variante dieses Beispiels ermittelt werden. Das Tabellenfeld "gehalt" ist ein Zahlenfeld, es hat die Länge 10 mit 2 Nachkommastellen, kann Nullwerte speichern und ist kompatibel mit Formicula. Die letzte Angabe bedeutet, dass eine Umwandlungsroutine für diesen Tabellenfeldtyp existiert.

Catalog -> DataEvaluator -> FunctionEvaluator -> Evaluator[Evaluator, Operator]

Eigenschaften:

string alias

Gibt die Aliasgruppe an, unter deren Namen die Katalog-Informationen einer Tabelle gespeichert werden. Diese Angabe darf nicht leer sein oder fehlen.

{string} filter = *

Mit filter wird ein Selektionskriterium definiert. Ein "*" bzw. "_" steht für beliebig viele Zeichen, während ein "?" bzw. "%" genau ein Zeichen repräsentiert. Alle anderen Zeichen im Filter müssen übereinstimmen. So lässt der Filter "*?Fil?er*" z.B. die Begriffe "XFilter", "Der Filzer filzt" durch, verweigert aber den Begriffen "Filter", "Der Filtser Hannes" oder "XFiler" den Durchgang. Gross- und Kleinschreibung wird nicht beachtet. Dieser Filter wirkt sich auf die Tabellennamen aus.

{stringliste} type

Diese Eigenschaft definiert eine Liste von Tabellentypen, die selektiert werden sollen. Typische Typen sind TABLE, VIEW, SYSTEM TABLE, GLOBAL TEMPORARY, LOCAL TEMPORARY, ALIAS oder SYNONYM.
Fehlt diese Angabe oder ist sie leer werden alle Typen selektiert.

boolean save = false

Wenn diese Eigenschaft true ist, wird das Ergebnis der Katalog-Abfrage intern unter dem in alias definierten Namen gesichert. Dieser Name dient als Referenz für andere DataEvaluator-Objekte, die sich die Ergebnisse von Abfragen beziehen (siehe Next-Evaluator).

Beispiel:

Frame
{   border=1;
    Text
    {   text = "<b>Catalog<b><br>\n{str}";
        subHtml;
        Utilize
        {   Catch
            {   Connect
                {   driver = "sun.jdbc.odbc.JdbcOdbcDriver";
                    connection = "jdbc:odbc:test";
                }
            }
            Eval
            {   exp = str, set, "<table width=100%>\n<tr>\n";
            }
            Catalog
            {   alias = db;
                save;
            }
            Gather
            {   alias = db;
                name = dbname;
            }
            Loop
            {   exp = str, build, "{str}<th align=left>{dbname}</th>\n";
                exp = dbname, moveind, 1;
            }
            Eval
            {   exp = str, join, "</tr>\n";
            }
            Loop
            {   Eval
                {   exp = dbname, setind, 1;
                    exp = str, join, "<tr>\n";
                }
                Loop
                {   exp = data, set, *dbname;
                    exp = str, build, "{str}<td>{data}</td>\n";
                    exp = dbname, moveind, 1;
                }
                Eval
                {   exp = str, join, "</tr>\n";
                }
                Next { alias = db; }
            }
            Eval
            {   exp = str, join, "</table>\n";
            }
            Disconnect {}
            Exit {}
        }
    }
}

In diesem Beispiel wird nicht wie bisher der "JDataConnect"-Treiber sondern die Standard-JDBC-ODBC-Bridge von SUN verwendet. Der ODBC- Treiber muss auf dem Server installiert sein. Der Katalog der JDBC-ODBC- Bridge verwendet allerdings andere Feldnamen als die JDBC-Dokumentation vorgibt. Offensichtlich legt SUN die eigenen Vorgaben sehr liberal aus. Andere Treiberanbieter wie z.B. NetDirekt (JDataConnect-Treiber) nehmen es glücklicherweise etwas genauer.
Da die Feldnamen des Kataloges nicht bei jedem Treiber den Regeln entsprechen, wird in diesem Beispiel ein voll dynamischer Seitenaufbau demonstriert. Mittels Gather werden die Namen der Ergebnistabelle aus Catalog in den Vektor "dbname" geladen. Dieser wird verwendet um auf die einzelnen Felder des Ergebnisalias "db" zuzugreifen. Dabei ist es nicht notwendig zu wissen wie die Felder heissen. Der Ausdruck "data, set, *dbname" verwendet den Inhalt des Datenfeldes "dbname" als Referenz für den eigentlichen Feldnamen. Die Syntax mit dem "*" definiert eine sogenannte Datenfeldreferenz (siehe Klassenbeschreibung: Operator). In der ersten Loop-Schleife wird die Überschrift der Tabelle generiert. Die folgende Schleife läuft über alle Ergebnissätze, während die innere Schleife über die Spaltennamen läuft.

IOEvaluator -> FunctionEvaluator -> Evaluator[Evaluator, Operator]

Eigenschaften:

string handle

Da mehrere Dateien parallel geöffnet sein können, muss über diese Eigenschaft zwischen den unterschiedlichen Dateien differenziert werden. Das handle ist ein Bezeichner für die geöffnete Datei. Er muss bei jedem IOEvaluator angegeben werden, es sei denn es wird nur eine Datei benötigt. Als Standard wird ein leerer Bezeichner verwendet.

Open -> IOEvaluator -> FunctionEvaluator -> Evaluator[Evaluator, Operator]

Eigenschaften:

{string} file

Mit dieser Eigenschaft wird der Dateinamen der zu öffnenden Datei spezifiziert. Bei Pfadangaben ist zu beachten, dass ein einfacher Backslash ("\") immer durch zwei aufeinanderfolgende Backslashs dargestellt werden muß. Deshalb ist es einfacher Slashs ("/") zu verwenden.

boolean replace = false

Standardmässig werden Dateien so geöffnet, dass sie durch Schreiben ergänzt werden. Ist diese Eigenschaft true wird ihr bisheriger Inhalt gelöscht. Die Datei wird dann überschrieben.

boolean erase = false

Ist diese Eigenschaft true, wird die Datei beim Schliessen gelöscht unabhängig davon ob sie automatisch oder explizit geschlossen wurde. Diese Eigenschaft eignet sich zur Deklaration von temporären Dateien. Bei der Namensgebung von temporären Dateien kann die Session-ID, die im Datenfeld "Formicula.SessionID" gespeichert ist, verwendet werden. Wenn sie als Bestandteil des Dateinamens vorkommt, ist die Eindeutigkeit der Datei gewährleistet. Da die ID keine feste Länge hat, sollten zusätzliche Bezeichner durch nicht alphanumerische Zeichen von ihr getrennt sein, damit nicht durch Zufall eine bereits existierende ID generiert wird (was zugegebenermassen sehr unwahrscheinlich ist).
Eine Datei kann nicht gelöscht werden, wenn eine weitere Session auf sie zugreift.

Close -> IOEvaluator -> FunctionEvaluator -> Evaluator[Evaluator, Operator]

Eigenschaften:

boolean erase = false

Ist diese Eigenschaft true, wird die Datei beim Schliessen entfernt.

Read -> IOEvaluator -> FunctionEvaluator -> Evaluator[Evaluator, Operator]

Eigenschaften:

string var

In dieses Datenfeld werden die Textzeilen des aktuellen Lesevorgangs als Vektor gespeichert.

int line = 0

Diese Eigenschaft bestimmt wieviele Zeilen gelesen werden sollen. Ist der Wert kleiner gleich null, werden alle verbleibenden Zeilen gelesen.

Write -> IOEvaluator -> FunctionEvaluator -> Evaluator[Evaluator, Operator]

Eigenschaften:

string var

Diese Eigenschaft definiert den Datenvektor, der komplett zeilenweise in die Datei geschrieben wird.

Beispiel:

Frame
{   border = 1;
    Text
    {   text = "<b>Nachrichten</b><br>";
        text = "<pre>{msg}</pre><hr>Neue Nachricht:";
        Utilize
        {   Open
            {   file = "messageboard/msg.txt";
            }
            Eval
            {   exp = msg, set, "";
            }
            Loop
            {   Read
                {   var = txt;
                    line = 1;
                }
                Eval
                {   exp = msg, join, txt, msg, join, "\n";
                }
            }
        }
    }
    Area
    {   var = newmsg;
        col = 40;
        Utilize
        {   exp = newmsg, used, newmsg, clean;
        }
        Eval
        {   exp = newmsg, trim;
            exp = newmsg, full;
            exp = msg, full;
            exp = newmsg, ins, "-----------------------";
        }
    }
    Submit
    {   var = sub;
        label = "Add","Exit";
        Eval
        {   or;
            Exit
            {   exp = sub, eq, "Exit";
                url = "{formicula.link}";
            }
            Write
            {   exp = newmsg, full;
                var = newmsg;
            }
        }
    }
}

Nachricht Nr. 1
-----------------------
Nachricht Nr. 2
-----------------------
Nachricht Nr. 3

Dieses primitive Messageboard zeigt die Datei "msg.txt" an. Das Verzeichnis "messageboard" wird bei Bedarf generiert. Mit "Add" können neue Nachrichten hinzugefügt werden. Die Datei wird nach jeder hinzugefügten Nachricht geschlossen und neu geöffnet damit der Lesezeiger wieder am Anfang steht. Da das Messageboard beliebig groß werden kann, ist es besser die Datei Zeile für Zeile in das Datenfeld "msg" zu übertragen und nicht komplett (line = 0), da sonst der doppelte Speicher benötigt würde (für "msg" und "txt").

Operator

Numerische Konstante

Hierbei handelt es sich um eine beliebige Zahl. Es gibt keine Unterscheidung zwischen Integer- und Float-Zahlen. Überflüssige Nachkommastellen werden einfach abgeschnitten. Dieser Parametertyp produziert einen Fehler, wenn er anstelle einer String-Konstante verwendet wird.

String-Konstante

Eine String-Konstante steht immer in Anführungszeichen. Fehlen diese, wird der Parameter als Datenfeld bzw. Referenz interpretiert. Dieser Parametertyp produziert einen Fehler, wenn er anstelle einer numerischen Konstante verwendet wird.

Datenfeld-Parameter

Ein Datenfeld-Parameter steht nicht in Anführungszeichen und ist keine Zahl. Ausserdem darf kein Stern "*" direkt davor stehen, da er sonst als Referenz-Parameter interpretiert wird. Dieser Parameter-Typ ist dynamisch, das heisst er kann immer verwendet werden. Der Operator versucht den Inhalt des Datenfeldes entsprechend den Erfordernissen umzuwandeln. Gelingt das nicht, wird die Operation nicht ausgeführt und der Operator gibt false zurück.

Referenz-Parameter

Ein Referenz-Parameter steht nicht in Anführungszeichen und ist keine Zahl. Ausserdem muß ein Stern "*" direkt davor stehen, da er sonst als Datenfeld-Parameter interpretiert wird. Dieser Parameter-Typ ist dynamisch, das heisst er kann immer verwendet werden. Der Operator versucht den Inhalt des referenzierten Datenfeldes entsprechend den Erfordernissen umzuwandeln. Gelingt das nicht, wird die Operation nicht ausgeführt und der Operator gibt false zurück.

Dynamischer Parameter

Ein dynamischer Parameter kann eine beliebige Konstante, ein Datenfeldname oder eine Referenz sein. Der Operator passt seine Funktionalität dem verwendeten Parameter-Typ an. Sollte er dazu nicht in der Lage sein, gibt er false zurück;

app -> Operator -> Operator

Parameter

dynamisch

Funktion

Der Datenfeldvektor wird um ein weiteres Element erweitert. Dieses Element wird zum aktiven Element. Skalare Datenfelder werden zu Vektoren. Das Datenfeld muß existieren.

Rückgabe

true

at -> Operator

Parameter

string, string, numerisch

Funktion

Der erste String wird im zweiten String von links nach recht gesucht. Der numerische Parameter gibt die Startposition an, ab der gesucht werden soll. Gespeichert wird die Position des gefundenen Strings oder 0 bei erfolgloser Suche.

Rückgabe

true

build -> Operator

Parameter

string

Funktion

Der String wird substituiert und im Datenfeld gespeichert. Es handelt sich dabei um eine einfache Substitution ohne Maskierung von Html-Steuerzeichen.

Rückgabe

true

def -> Operator

Parameter

dynamisch

Funktion

Wenn das Datenfeld leer bzw. noch nicht definiert ist, wird ihm der Inhalt des Parameters zugewiesen. Dieser Operator eignet sich zum ersetzen von Leerfeldern mit bestimmten Werten (z.B. mit dem Ausdruck "keine Angabe").

Rückgabe

true

gen -> Operator

Parameter

dynamisch

Funktion

Wenn das Datenfeld noch nicht definiert ist, wird ihm der Inhalt des Parameters zugewiesen. Existiert es bereits, bleibt es unverändert.

Rückgabe

true

ins -> Operator -> Operator

Parameter

dynamisch

Funktion

An der aktuellen Position im Datenfeldvektor wird ein Element eingefügt. Skalare Datenfelder werden zu Vektoren. Das Datenfeld muß existieren.

Rückgabe

true

join -> Operator

Parameter

string

Funktion

Der String wird an den Inhalt des Datenfeldes angehängt. Das Datenfeld muß existieren.

Rückgabe

true

len -> Operator

Parameter

string

Funktion

Die Länge des Strings wird dem Datenfeld zugewiesen.

Rückgabe

true

lex -> Operator

Parameter

string, string, numerisch

Funktion

Der erste String besteht aus Teilstrings, welche sich durch ein bestimmtes Trennzeichen abgrenzen. Der zweite String definiert das Trennzeichen. Der numerische Parameter gibt an, welcher Teilstring dem Datenfeld zugewiesen wird.

Rückgabe

true, wenn der Teilstring existiert
false, sonst

lexcnt -> Operator

Parameter

string, string

Funktion

Der erste String besteht aus Teilstrings, welche sich durch ein bestimmtes Trennzeichen abgrenzen. Der zweite String definiert das Trennzeichen. Dem Datenfeld wird die Anzahl der Teilstrings zugewiesen.

Rückgabe

true

match -> Operator

Parameter

string

Funktion

Der String definiert einen Filterausdruck. Es wird geprüft ob das Datenfeld dem Filter entspricht. Ein "*" steht für beliebig viele Zeichen, während ein "?" genau ein Zeichen repräsentiert. Alle anderen Zeichen im Filter müssen übereinstimmen. So lässt der Filter "*?Fil?er*" z.B. die Begriffe "XFilter", "Der Filzer filzt" durch, verweigert aber den Begriffen "Filter", "Der Filtser Hannes" oder "XFiler" den Durchgang.

Rückgabe

true, wenn das Datenfeld dem Filter entspricht
false, sonst

padl -> Operator

Parameter

string, numerisch

Funktion

Das Datenfeld wird nach links mit einem Zeichen aufgefüllt. Der String definiert das Zeichen und der numerische Parameter die Länge bis zu der aufgefüllt wird. Das Datenfeld muß existieren.

Rückgabe

true

padr -> Operator

Parameter

string, numerisch

Funktion

Das Datenfeld wird nach rechts mit einem Zeichen aufgefüllt. Der String definiert das Zeichen und der numerische Parameter die Länge bis zu der aufgefüllt wird. Das Datenfeld muß existieren.

Rückgabe

true

rat -> Operator

Parameter

string, string, numerisch

Funktion

Der erste String wird im zweiten String von rechts nach links gesucht. Der numerische Parameter gibt die Startposition an, ab der gesucht werden soll. Gespeichert wird die Position des gefundenen Strings oder 0 bei erfolgloser Suche. Wenn die Startposition 0 oder kleiner ist, wird von Ende des Strings gesucht.

Rückgabe

true

replace -> Operator

Parameter

string, string

Funktion

Im Datenfeld werden alle Vorkommen des ersten Strings durch den zweiten String ersetzt.

Rückgabe

true

set -> Operator

Parameter

dynamisch

Funktion

Dem Datenfeld wird der Inhalt des Parameters unbedingt zugewiesen.

Rückgabe

true

UnaryOperator -> Operator

ceil -> UnaryOperator -> Operator

Parameter

keine

Funktion

Der Inhalt des Datenfeldes wird als Zahl interpretiert. Es erhält den kleinsten Wert, der nicht kleiner ist als der ursprüngliche Wert und eine Integerzahl darstellt (z.B.: -5.23 wird zu -5, 12.01 wird zu 13). Das Datenfeld muß existieren.

Rückgabe

true

clean -> UnaryOperator -> Operator

Parameter

keine

Funktion

Der Inhalt des Datenfeldes wird gelöscht. Aus Vekoren wird ein leerer Skalar. Das Datenfeld muß existieren.

Rückgabe

true

date -> UnaryOperator -> Operator

Parameter

keine

Funktion

Das aktuelle Systemdatum mit Zeitangabe wird dem Datenfeld zugewiesen.
Die Angabe hat folgendes Format: yyyy.MM.dd hh.mm.ss.SSS
y : Jahr
M : Monat
d : Tag
h : Stunde
m : Minute
s : Sekunde
S : Tausendstel Sekunde
Beispiel: 2001.05.23 15.58.05.372

Rückgabe

true

empty -> UnaryOperator -> Operator

Parameter

keine

Funktion

Der Operator prüft, ob das Datenfeld leer ist. Das Datenfeld muß existieren.

Rückgabe

true, wenn das Datenfeld leer ist oder nur Leerzeichen enthält
false, sonst

errcnt -> UnaryOperator -> Operator

Parameter

keine

Funktion

Die Anzahl der Fehlermeldungen der MessageEvaluator-Objekte wird dem Datenfeld zugewiesen. Dabei werden auch mehrfache Meldungen pro Content-Objekt mitgezählt.

Rückgabe

true

floor -> UnaryOperator -> Operator

Parameter

keine

Funktion

Der Inhalt des Datenfeldes wird als Zahl interpretiert. Es erhält den grössten Wert, der nicht grösser ist als der ursprüngliche Wert und eine Integerzahl darstellt (z.B.: -5.23 wird zu -6, 12.01 wird zu 12). Das Datenfeld muß existieren.

Rückgabe

true

free -> UnaryOperator -> Operator

Parameter

keine

Funktion

Der Operator prüft, ob das Datenfeld existiert oder nicht.

Rückgabe

true, wenn das Datenfeld existiert
false, sonst

full -> UnaryOperator -> Operator

Parameter

keine

Funktion

Der Operator prüft, ob das Datenfeld gefüllt ist. Das Datenfeld muß existieren.

Rückgabe

false, wenn das Datenfeld leer ist oder nur Leerzeichen enthält
true, sonst

isdate -> UnaryOperator -> Operator

Parameter

keine

Funktion

Der Operator prüft, ob das Datenfeld eine korrekte Datumsangabe darstellt.
Ein korrektes Datum kann folgende Formate haben: yyyy.MM.dd hh.mm.ss.SSS, yyyy.MM.dd hh.mm.ss, yyyy.MM.dd hh.mm, yyyy.MM.dd
y : Jahr
M : Monat
d : Tag
h : Stunde
m : Minute
s : Sekunde
S : Millisekunde
Beispiel: 2001.5.23
Das Datenfeld muß existieren.

Rückgabe

true, wenn der Datenfeldinhalt eine korrekte Datumsangabe darstellt
false, sonst

isbool -> UnaryOperator -> Operator

Parameter

keine

Funktion

Der Operator prüft, ob das Datenfeld den boolschen Werten "true" bzw. "false" entspricht. Das Datenfeld muß existieren.

Rückgabe

true, wenn der Datenfeldinhalt "true" oder "false" ist
false, sonst

isint -> UnaryOperator -> Operator

Parameter

keine

Funktion

Der Operator prüft, ob das Datenfeld in seiner Darstellung einer Integerzahl entspricht. Das Datenfeld muß existieren.

Rückgabe

true, wenn das Datenfeld eine Integerzahl darstellt
false, sonst

isnum -> UnaryOperator -> Operator

Parameter

keine

Funktion

Der Operator prüft, ob das Datenfeld in seiner Darstellung einer beliebigen Zahl entspricht. Das Datenfeld muß existieren.

Rückgabe

true, wenn das Datenfeld eine Zahl darstellt
false, sonst

istime -> UnaryOperator -> Operator

Parameter

keine

Funktion

Der Operator prüft, ob das Datenfeld der internen Zeitdarstellung entspricht. Die interne Zeit wird in Millisekunden seit dem 1. Januar 1970 gemessen. Das Datenfeld muß existieren.

Rückgabe

true, wenn das Datenfeld der internen Zeitdarstellung entspricht
false, sonst

lower -> UnaryOperator -> Operator

Parameter

keine

Funktion

Der Operator wandelt alle Großbuchstaben des Datenfeldes in Kleinbuchstaben um. Das Datenfeld muß existieren.

Rückgabe

true

msgcnt -> UnaryOperator -> Operator

Parameter

keine

Funktion

Dem Datenfeld wird die Anzahl der Content-Objekte mit Fehlermeldungen zugewiesen.

Rückgabe

true

off -> UnaryOperator -> Operator

Parameter

keine

Funktion

Der Operator prüft, ob das Datenfeld dem boolschen Wert "false" entspricht. Das Datenfeld muß existieren.

Rückgabe

true, wenn das Datenfeld "false" ist
false, sonst

on -> UnaryOperator -> Operator

Parameter

keine

Funktion

Der Operator prüft, ob das Datenfeld dem boolschen Wert "true" entspricht. Das Datenfeld muß existieren.

Rückgabe

true, wenn das Datenfeld "true" ist
false, sonst

rand -> UnaryOperator -> Operator

Parameter

keine

Funktion

Eine Zufallszahl größr gleich 0 und kleiner als 1 wird dem Datenfeld zugewiesen.

Rückgabe

true

remove -> UnaryOperator -> Operator

Parameter

keine

Funktion

Das aktuelle Element des Datenfeldvektors wird entfernt. Bei einem Skalar wird der Inhalt gelöscht. Der Index des aktuellen Objektes bleibt erhalten. Wenn das gelöschte Element den höchsten Index hatte, wird er an die neue Vektorgrösse angepasst.

Rückgabe

false, wenn ein Skalar gelöscht wurde
true, sonst

round -> UnaryOperator -> Operator

Parameter

keine

Funktion

Das Datenfeld wird als Zahl interpretiert und auf den näher liegenden Integerwert gerundet. Das Datenfeld muß existieren.

Rückgabe

true

todate -> UnaryOperator -> Operator

Parameter

keine

Funktion

Das Datenfeld wird als interne Zeitdarstellung interpretiert und in das entsprechende Datum umgewandelt. Die interne Zeit wird in Millisekunden seit dem 1. Januar 1970 gemessen. Das Datum hat folgendes Format: yyyy.MM.dd hh.mm.ss.SSS
y : Jahr
M : Monat
d : Tag
h : Stunde
m : Minute
s : Sekunde
S : Millisekunde
Das Datenfeld muß existieren.

Rückgabe

false, wenn das Datenfeld keine gültige Zeit ist
true, sonst

tohtml -> UnaryOperator -> Operator

Parameter

keine

Funktion

Alle Html-Sonderzeichen und Tags des Datenfeldes werden maskiert. Wenn das Datenfeld in einer Html-Seite substituiert wird (siehe Text mit Eigenschaft subHtml = true), wird der Inhalt unverändert dargestellt.

Rückgabe

true

topath -> UnaryOperator -> Operator

Parameter

keine

Funktion

Die relative Pfadangabe im Datenfeld wird in eine absolute Pfadangabe umgewandelt.

Rückgabe

true

totime -> UnaryOperator -> Operator

Parameter

keine

Funktion

Das Datenfeld wird als Datum interpretiert und in die entsprechende interne Zeitdarstellung umgewandelt. Die interne Zeit wird in Millisekunden seit dem 1. Januar 1970 gemessen. Das Datum hat folgendes Format: yyyy.MM.dd hh.mm.ss.SSS
y : Jahr
M : Monat
d : Tag
h : Stunde
m : Minute
s : Sekunde
S : Millisekunde
Das Datenfeld muß existieren.

Rückgabe

false, wenn der Datenfeldinhalt kein gütiges Datum ist
true, sonst

trim -> UnaryOperator -> Operator

Parameter

keine

Funktion

Alle führenden und folgenden Leerzeichen des Datenfeldes werden entfernt. Das Datenfeld muß existieren.

Rückgabe

true

trunc -> UnaryOperator -> Operator

Parameter

keine

Funktion

Das Datenfeld wird als Zahl interpretiert und die Nachkommastellen abgeschnitten. Das Datenfeld muß existieren.

Rückgabe

true

upper -> UnaryOperator -> Operator

Parameter

keine

Funktion

Der Operator wandelt alle Kleinbuchstaben des Datenfeldes in Großbuchstaben um. Das Datenfeld muß existieren.

Rückgabe

true

used -> UnaryOperator -> Operator

Parameter

keine

Funktion

Der Operator prüft, ob das Datenfeld bereits existiert.

Rückgabe

true, wenn das Datenfeld existiert
false, sonst

NumericOperator -> Operator

add -> NumericOperator -> Operator

Parameter

numerisch

Funktion

Der Parameter wird zum Datenfeld addiert. Das Datenfeld muss existieren.

Rückgabe

true

div -> NumericOperator -> Operator

Parameter

numerisch

Funktion

Der Datenfeld wird durch den Parameter dividiert. Das Datenfeld muss existieren.

Rückgabe

true

isfix -> NumericOperator -> Operator

Parameter

numerisch, numerisch

Funktion

Es wird geprüft ob das Datenfeld dem fixen numerischen Format entspricht, welches durch die Parameter vorgegeben wird. Der erste Parameter gibt die maximale Länge des Formates an. Der zweite Parameter gibt die Anzahl der Nachkommastellen an. Das Komma selbst zählt als Stelle ebenso wie das Minuszeichen bei negativen Zahlen. Punkte und Kommas werden gleich behandelt. Die Zahl entspricht dem Format, wenn sie ohne Änderung ihres Wertes angepasst werden könnte. Das Datenfeld muß existieren.

Rückgabe

false, wenn eine Anpassung an das fixe Format die Zahl verändern würde
true, sonst

left -> NumericOperator -> Operator

Parameter

numerisch

Funktion

Alles was rechts von der Positionsangabe (Parameter) steht wird vom Datenfeld abgeschnitten. Das erste Zeichen hat Position 1. Das Datenfeld muß existieren.

Rückgabe

true

max -> NumericOperator -> Operator

Parameter

numerisch, numerisch

Funktion

Der größere der beiden Parameter wird dem Datenfeld zugewiesen.

Rückgabe

true

min -> NumericOperator -> Operator

Parameter

numerisch, numerisch

Funktion

Der kleinere der beiden Parameter wird dem Datenfeld zugewiesen.

Rückgabe

true

moveind -> NumericOperator -> Operator

Parameter

numerisch

Funktion

Der interne Index des Datenfeldvektors wird entsprechend des Parameters verschoben. Durch die Angabe eines negativen Parameters wird der Index nach hinten verschoben. Bei Verletzung einer Indexgrenze des Vektors, wird er auf diese Grenze gesetzt (1 bzw. Vektorlänge). Das Datenfeld muß existieren.

Rückgabe

false, bei potenzieller Verletzung einer Indexgrenze
true, sonst

mul -> NumericOperator -> Operator

Parameter

numerisch

Funktion

Das Datenfeld wird mit dem Parameter multipliziert. Das Datenfeld muss existieren.

Rückgabe

true

right -> NumericOperator -> Operator

Parameter

numerisch

Funktion

Alles was links von der Positionsangabe (Parameter) steht wird vom Datenfeld abgeschnitten. Das erste Zeichen hat Position 1. Das Datenfeld muß existieren.

Rückgabe

true

setind -> NumericOperator -> Operator

Parameter

numerisch

Funktion

Der interne Index des Datenfeldvektors wird auf den Wert des Parameters gesetzt. Würde eine Verletzung der Indexgrenzen stattfinden, wird der Index auf die verletzte Grenze gesetzt (1 bzw. Vektorglänge). Das Datenfeld muß existieren.

Rückgabe

false, bei potenzieller Verletzung einer Indexgrenze
true, sonst

sub -> NumericOperator -> Operator

Parameter

numerisch

Funktion

Der Parameter wird vom Datenfeld subtrahiert. Das Datenfeld muss existieren.

Rückgabe

true

substr -> NumericOperator -> Operator

Parameter

numerisch, numerisch

Funktion

Der erste Parameter definieren die Position (bei 1 beginnend), der zweite Parameter die Länge des Teilstrings, der aus dem Datenfeld kopiert wird.

Rückgabe

true

tofix -> NumericOperator -> Operator

Parameter

numerisch, numerisch

Funktion

Das Datenfeld wird entsprechend dem fixen numerischen Format, welches durch die Parameter vorgegeben wird, umgewandelt. Der erste Parameter gibt die maximale Länge des Formates an. Der zweite Parameter gibt die Anzahl der Nachkommastellen an. Das Komma selbst zählt als Stelle ebenso wie das Minuszeichen bei negativen Zahlen. Punkte und Kommas werden gleich behandelt. Die Umwandlung findet nicht statt, wenn sich der Wert der Zahl ändern würde.

Rückgabe

false, wenn eine Anpassung an das fixe Format die Zahl verändern würde
true, sonst

ValueOperator -> Operator

getind -> ValueOperator -> Operator

Parameter

Datenfeld/Referenz

Funktion

Dem Datenfeld wird der aktuelle Index des Datenfeldparameters als Zahl zugewiesen.

Rückgabe

true

size -> ValueOperator -> Operator

Parameter

Datenfeld/Referenz

Funktion

Dem Datenfeld wird die Vektorlänge des Datenfeldparameters zugewiesen.

Rückgabe

true

CompareOperator -> Operator

DynamicCompareOperator -> CompareOperator -> Operator

rec -> DynamicCompareOperator -> CompareOperator -> Operator

Parameter

dynamisch, dynamisch

Funktion

Wenn das Datenfeld gleich dem Inhalt des ersten Parameters ist, wird ihm der Inhalt des zweiten Parameters zugewiesen. Die Art des Vergleichs wird dynamisch bestimmt. Dieser Operator eignet sich zum Umkodieren (recode) von Datenfeldern. Im Gegensatz zu den anderen CompareOperator-Objekten gibt rec immer true zurück.

Rückgabe

true

NumericCompareOperator -> CompareOperator -> Operator

StringCompareOperator -> CompareOperator -> Operator

Anhang

Systemfelder

Formicula.	Intern	Aktualisierung	Beschreibung
SessionID	ja	Client-Generierung	Über die "SessionID" identifiziert das Formicula-Servlet den Client. Sie wird als verstecktes Formularfeld mitgesendet. Sie ist eindeutig für den Server und kann deshalb als Bestandteil für Namen temporärer Dateien verwendet werden. "SessionIDs" haben eine feste Länge von 16 Zeichen.
FormID	ja	Servlet-Aufruf	Gibt die Nummer der aktuellen Formularseite an. Diese ID wird bei jedem Formular als verstecktes Formularfeld integriert. Sie wird benötigt um Browser-Navigation festzustellen und entsprechend darauf zu reagieren (siehe Eigenschaft navigationLock des Form-Objektes).
Visited	ja	Servlet-Aufruf	Über diesen Datenvektor wird das Backtracking gesteuert (siehe Back-Evaluator). Er enthält die Nummern der bisher aufgerufenen Formulare ohne Schleifen. Der aktuellste Eintrag hat den höchsten Index. Nach dem Servlet-Aufruf steht der Index auf dem aktuellen Eintrag. Es ist möglich den Datenvektor zu manipulieren um eine andere Backtrack-Reihenfolge zu erhalten.
File	ja	Client-Generierung	Spezifiziert den Skript-File des Formulars. Das Formular enthält diese Angabe als verstecktes Formularfeld. Es wird verwendet, wenn der Client das maximale Antwortzeit-Intervall überschritten hat und die Session gelöscht wurde. Das Servlet erkennt anhand dieses Formularfeldes das Skript und erzeugt eine neue Session dafür. Dieses Feld kann geändert werden, wenn stattdessen ein spezielles Skript ausgeführt werden soll.
Running	nein	Servlet-Aufruf	Gibt die Anzahl der aktiven Sessions an.
Client	nein	Client-Generierung	Enthält die Anzahl der vom Servlet verwalteten Sessions zum Zeitpunkt der Client-Anmeldung. Mit dieser Angabe können Mengenrestriktionen für den Zugang realisiert werden.
Select	nein	Select/SQL	Gibt an, ob die letzte Select-Abfrage (Select- oder SQL-Evaluator) ein Ergebnis lieferte ("true") oder nicht ("false").
Insert	nein	Insert/SQL	Gibt die Anzahl der durch den letzten Insert- bzw. SQL-Evaluator eingefügten Datensätze an.
Update	nein	Update/SQL	Gibt die Anzahl der durch den letzten Update- bzw. SQL-Evaluator geänderten Datensätze an.
Delete	nein	Delete/SQL	Gibt die Anzahl der durch den letzten Delete- bzw. SQL-Evaluator gelöschten Datensätze an.
Catch	nein	Catch	Enthält die Fehlermeldung des zuletzt mit dem Catch-Evaluators aufgefangenen Fehlers.
Host	nein	Servlet-Aufruf	Dieses Feld spezifiziert den Namen des Host-Servers über den sich der Client eingewählt hat. Diese Angabe wird bei jedem Aufruf aktualisiert, da es theoretisch möglich ist, dass der Host-Server während der Session wechselt.
Address	nein	Servlet-Aufruf	Gibt den die IP-Adresse des Clients an. Diese kann von Aufruf zu Aufruf wechseln, wenn spezielle Einwahlverfahren zur IP-Verschleierung verwendet wurden.
UserID	nein	Client-Generierung	Gibt die Login-Kennung des Users auf dem Web-Server an, wenn das Formicula-Servlet in einem Password-geschützten Bereich liegt. Dieser Schutz ist unabhängig von Password-Abfragen durch das Formicula-Skript.
Authorization	nein	Client-Generierung	Gibt das Autorisationsschema des Server an. Wenn es sich z.B. um das Verschlüsselungsschema SSL (Secure Socket Layer) handelt, enthält dieses Feld die Angabe "SSL".
Agent	nein	Client-Generierung	Gibt die Kennung des vom Client verwendet Browsers an.
Link	nein	Client-Generierung	Dieses Feld enthält den sogennanten "Referrer"-Link. Dabei handelt es sich um die Adresse der Seite von der aus das Servlet aufgerufen wurde. Es eignet sich besonders für den Exit-Evaluator.
Created	nein	Client-Generierung	Gibt das Datum und die Zeit der Client-Generierung im Standardformat an (siehe date-Operator).
Accessed	nein	Servlet-Aufruf	Gibt das Datum und die Zeit des letzten Servlet-Aufrufs für diese Session im Standardformat an (siehe date-Operator).

Farben

Farbname	Hexadezimal	Beispiel-Tabellenzelle mit dieser Farbe
aliceblue	#F0F8FF
antiquewhite	#FAEBD7
aquamarine	#7FFFD4
azure	#F0FFFF
beige	#F5F5DC
blueviolet	#8A2BE2
brown	#A52A2A
burlywood	#DEB887
cadetblue	#5F9EA0
chartreuse	#7FFF00
chocolate	#D2691E
coral	#FF7F50
cornflowerblue	#6495ED
cornsilk	#FFF8DC
crimson	#DC143C
darkblue	#00008B
darkcyan	#008B8B
darkgoldenrod	#B8860B
darkgray	#A9A9A9
darkgreen	#006400
darkkhaki	#BDB76B
darkmagenta	#8B008B
darkolivegreen	#556B2F
darkorange	#FF8C00
darkorchid	#9932CC
darkred	#8B0000
darksalmon	#E9967A
darkseagreen	#8FBC8F
darkslateblue	#483D8B
darkslategray	#2F4F4F
darkturquoise	#00CED1
darkviolet	#9400D3
deeppink	#FF1493
deepskyblue	#00BFFF
dimgray	#696969
dodgerblue	#1E90FF
firebrick	#B22222
floralwhite	#FFFAF0
forestgreen	#228B22
gainsboro	#DCDCDC
ghostwhite	#F8F8FF
gold	#FFD700
goldenrod	#DAA520
greenyellow	#ADFF2F
honeydew	#F0FFF0
hotpink	#FF69B4
indianred	#CD5C5C
indigo	#4B0082
ivory	#FFFFF0
khaki	#F0E68C
lavender	#E6E6FA
lavenderblush	#FFF0F5
lawngreen	#7CFC00
lemonchiffon	#FFFACD
lightblue	#ADD8E6
lightcoral	#F08080
lightcyan	#E0FFFF
lightgoldenrodyellow	#FAFAD2
lightgreen	#90EE90
lightgrey	#D3D3D3
lightpink	#FFB6C1
lightsalmon	#FFA07A
lightseagreen	#20B2AA
lightskyblue	#87CEFA
lightslategray	#778899
lightsteelblue	#B0C4DE
lightyellow	#FFFFE0
limegreen	#32CD32
linen	#FAF0E6
mediumaquamarine	#66CDAA
mediumblue	#0000CD
mediumorchid	#BA55D3
mediumpurple	#9370D
mediumseagreen	#3CB371
mediumslateblue	#7B68EE
mediumspringgreen	#00FA9A
mediumturquoise	#48D1CC
mediumvioletred	#C71585
midnightblue	#191970
mintcream	#F5FFFA
mistyrose	#FFE4E1
moccasin	#FFE4B5
navajowhite	#FFDEAD
oldlace	#FDF5E6
olivedrab	#6B8E23
orange	#FFA500
orangered	#FF4500
orchid	#DA70D6
palegoldenrod	#EEE8AA
palegreen	#98FB98
paleturquoise	#AFEEEE
palevioletred	#DB7093
papayawhip	#FFEFD5
peachpuff	#FFDAB9
peru	#CD853F
pink	#FFC0CB
plum	#DDA0DD
powderblue	#B0E0E6
rosybrown	#BC8F8F
royalblue	#4169E1
saddlebrown	#8B4513
salmon	#FA8072
sandybrown	#F4A460
seagreen	#2E8B57
seashell	#FFF5EE
sienna	#A0522D
skyblue	#87CEEB
slateblue	#6A5ACD
slategray	#708090
snow	#FFFAFA
springgreen	#00FF7F
steelblue	#4682B4
tan	#D2B48C
thistle	#D8BFD8
tomato	#FF6347
turquoise	#40E0D0
violet	#EE82EE
wheat	#F5DEB3
whitesmoke	#F5F5F5
yellowgreen	#9ACD32

Links

• www.sun.com - Sun Microsystems Homepage
• java.sun.com - "The Source for Java(TM) Technology"
• www.j-netdirect.com - Java Database Connectivity
• www.netzwelt.com/selfhtml - gute HTML-Dokumentation