Auswahl-Baum
nach dem Start des CommandCenters:
Auswahl-Baum
mit 'aufgeklappten' Unterverzeichnissen für
Teilprogramme:
|
> Verzeichnis der Dokumente mit den theoretischen Grundlagen |
|
Letzte
Bearbeitung dieses Dokuments: |
Voraussetzungen für das Verständnis dieses Dokuments:* Kenntnisse der
Programmierung von Heavyweight-Clients (Fat-Clients) in Java. |
Ungefährer Zeitbedarf zum Durcharbeiten dieses Dokuments:Das
ist ein Dokument zur Erklärung des theoretischen
Hintergrundes des JavaScout-Fat-Client-Frameworks (JS-FCF). |
Dieses
Dokument beschreibt die XML-Struktur in der Datei 'Tasks.xml'.
Diese
Datei ist Teil des JavaScout-Fat-Client-Frameworks und enthält
die Auswahl der einzelnen Teilprogramme eines Anwendungsprogramms.
Die Datei ist im Unterverzeichnis 'TEXT.ls' (dabei wird ls durch den ISO-Code der jeweiligen Sprache ersetzt) abgelegt; eine detaillierte Beschreibung zur Verzeichnisstruktur finden Sie im Dokument Verzeichnisstruktur für die Entwicklung von Heavyweight-Clients mit dem JS-FCF.
Die XML-Struktur wird in der Basisklasse JSBS_StartFrame ausgelesen und damit wird ein Auswahl-Baum für das Start-Frame (CommandCenter) eines Anwendungsprogramms gebildet.
|
Auswahl-Baum
nach dem Start des CommandCenters: |
Auswahl-Baum
mit 'aufgeklappten' Unterverzeichnissen für
Teilprogramme: |
Die
Reihenfolge in der Anzeige des Auswahl-Baums hängt von der
Reihenfolge des Eintrags einzelner <Task>
innerhalb
der Datei ab und kann je nach gewählter Sprache variiert werden.
Anleitungen für das Erstellen eines Start-Frames (CommandCenter) für Ihr individuelles Anwendungsprogramm finden Sie unter Leitfaden für die Entwicklung von Heavyweight-Clients mit dem JS-FCF – Alle Schritte zur Entwicklung des Start-Frames.
Vorbedingungen
Muster
einer Datei
Detailbeschreibung von
<UpperCase>
Detailbeschreibung
eines <Task>
* 'Überschrifts'-Eintrag
ohne Aufruf eines Teilprogramms
* Eintrag
zum Aufruf eines Teilprogramms
Weitere
Schritte und verwandte Dokumentation
Grundlegende Kenntnisse über XML-Strukturen.
Diese Muster-Datei enthält als Beispiel die Einträge für eine kleine Anwendung mit 3 Teilprogrammen.
Für eine detaillierte Beschreibung der einzelnen Elemente der XML-Struktur klicken Sie bitte auf die jeweilige Zeile.
<!--
Root-Element (Tasks); muss vorhanden sein sonst meldet der Parser
einen Fehler --><Tasks><!--
*********************************************
--><!--
********** Marker wenn eingegebene Codes auf Großbuchstaben
umgewandelt werden sollen ***********
-->
<UpperCase></UpperCase><!--
*********************************************
--><!--
********** Liste der auswählbaren Teilprogramme; Anzeige
Sortierung wie in der folgenden Reihenfolge ***********
-->
<Task> <DisplayedCode>G</DisplayedCode> <Description>Layout
und sprach-abhängige Text-Elemente für die
Benutzer-Oberfläche (GUI)
verwalten</Description> </Task>
<Task>
<DisplayedCode>GL</DisplayedCode>
<InternalCode>DL</InternalCode>
<Description>Layout
für GUI-Elemente verwalten – Sprach-abhängige
GUI-Elemente</Description>
<Parameter1Label>Projekt-Code</Parameter1Label>
<Parameter1ToolTipText>Projekt-Code
für die Weitergabe an das zu startende
Geschäftsfall-Fenster</Parameter1ToolTipText>
<Parameter1InfoMessage>Projekt-Code
für die Weitergabe an das zu startende
Geschäftsfall-Fenster</Parameter1InfoMessage>
<Parameter1CommonElementForVerification>txt_Project</Parameter1CommonElementForVerification>
<Parameter2Label>Sprach-Code</Parameter2Label>
<Parameter2ToolTipText>Sprach-Code
für die Weitergabe an das zu startende
Geschäftsfall-Fenster</Parameter2ToolTipText>
<Parameter2InfoMessage>Sprach-Code
für die Weitergabe an das zu startende
Geschäftsfall-Fenster</Parameter2InfoMessage>
<Parameter2CommonElementForVerification>txt_Language</Parameter2CommonElementForVerification>
</Task>
<Task>
<DisplayedCode>GU</DisplayedCode>
<InternalCode>DS</InternalCode>
<Description>Universell
verwendbare Text-Elemente verwalten – Sprach-abhängige
GUI-Elemente</Description>
<Parameter1Label>Projekt-Code</Parameter1Label>.
. . . . ..
. . . .
.
</Task>
<Task>
<DisplayedCode>GA</DisplayedCode>
<InternalCode>DC</InternalCode>
<Description>Allgemein
gültige Text-Elemente für die GUI verwalten –
Sprach-abhängige
GUI-Elemente</Description>
<Parameter1Label>Projekt-Code</Parameter1Label>.
. . . . ..
. . . .
.
</Task>
<Task>
<DisplayedCode>GF</DisplayedCode>
<InternalCode>DF</InternalCode>
<Description>Frame
(Fenster) verwalten – Sprach-abhängige
GUI-Elemente</Description>
<Parameter1Label>Projekt-Code</Parameter1Label>.
. . . . ..
. . . . .
</Task></Tasks>
<UpperCase>
ist
eine Anweisung, dass Kleinbuchstaben im EingabeFeld 'Auswahl' eines
CommandCenters als Großbuchstaben interpretiert
werden.
Beim
Suchen nach dem aufzurufenden Teilprogramm wird der eingegebene Code
in Großbuchstaben umgewandelt.
Dazu müssen aber alle
Werte in den XML-Elementen <DisplayedCodes>
in
Großbuchstaben erfasst sein.
Damit die Umwandlung in
Großbuchstaben erfolgt ist nur das XML-Element
(<UpperCase></UpperCase>)
ohne Wert ausreichend.
Die
XML-Elemente innerhalb eines <Task>
können zwei Arten der Auswahl bewirken; die detaillierte
Beschreibung finden Sie in den beiden folgenden Abschnitten.
In
diesem Fall sind nur zwei XML-Elemente unterhalb des XML-Elements
<Task>
vorhanden:
<Task> <DisplayedCode>G</DisplayedCode> <Description>Layout
und sprach-abhängige Text-Elemente für die
Benutzer-Oberfläche (GUI) verwalten</Description> </Task>
Entscheidend
ist das Fehlen des XML-Elements <InternalCode>;
damit kann kein Teilprogramm (Task) der Anwendung aufgerufen
werden.
Bei einem 'fertigen' CommandCenter is das daran erkennbar,
dass die Schaltfläche [ Weiter ]
nicht aktiviert wird:
Die Detailbeschreibung der enthaltenen XML-Elemente finden Sie im folgenden Abschnitt Eintrag zum Aufruf eines Teilprogramms.
<Task>
ist
die Zusammenfassung aller XML-Elemente die für den Aufruf eines
Teilprogramms notwendig sind oder zusätzliche Funktionalität
zur Verfügung stellen.
Unbedingt notwendig sind die
XML-Elemente <DisplayedCode>,
<InternalCode>
und
<Description>.
<DisplayedCode>
ist
jener Code, der im Auswahl-Baum für die Teilprogramme angezeigt
wird:
Der
Code soll eine leicht zu merkende Kurzform für das Teilprogramm
sein; z.B. BE
für
Bestellung
erfassen
und kann je nach gewählter Sprache unterschiedlich sein.
<InternalCode>
ist
jener Code mit dem innerhalb des Anwendungsprogramms der Aufruf des
dazu gehörenden Teilprogramms gesteuert wird.
Wie der Wert
des <InternalCode>
abgefragt
wird ist unter Leitfaden
für die Entwicklung von Heavyweight-Clients mit dem JS-FCF –
Alle Schritte zur Entwicklung des Task-Frames > TaskFrame im
CommandCenter aufrufen beschrieben.
<Description>
ist
der erklärende Text, der im Auswahl-Baum der Teilprogramme
angezeigt wird: 
Dieser
Text dient nur für die Anzeige im Auswahl-Baum und kann je nach
gewählter Sprache unterschiedlich sein.
<Parameter1Label>,
<Parameter2Label>
und
<Parameter3Label>
sind
die Texte, die über den optionalen Eingabefeldern angezeigt
werden.
Ist das jeweilige XML-Element vorhanden wird das
optionale Eingabefeld für eine Eingabe aktiviert – ist
das XML-Element nicht vorhanden wird das Feld deaktiviert
Im
folgenden Beispiel können das optionale Eingabefeld 1 und das
optionale Eingabefeld 2 verwendet werden:
<Parameter1ToolTipText>,
<Parameter2ToolTipText>
und
<Parameter3ToolTipText>
sind
jene Hilfetexte, die angezeigt werden wenn der Mauszeiger über
dem jeweiligen Feld platziert wird:
<Parameter1InfoMessage>,
<Parameter2InfoMessage>
und
<Parameter3InfoMessage>
sind
jene Hilfetexte, die im unteren Bereich des Fensters angezeigt
werden wenn der Positionszeiger im jeweiligen Feld platziert ist:
<Parameter1CommonElementForVerification>,
<Parameter2CommonElementForVerification>
und
<Parameter3CommonElementForVerification>
ist eine Referenz auf ein Allgemein gültiges GUI-Element
(CommonElement), dessen Prüfregeln für die minimale und
maximale Länge des eingegebenen Textes gültig sind.
Das
Allgemein gültige GUI-Element ist in der Datei
'DisplayStrings.xml'
im Abschnitt <CommonElements><ElementName>
definiert.
Auswirkungen einer verwendeten Prüfregel sind
der geänderte Hintergrund des Eingabefeldes wenn die Prüfregel
nicht erfüllt ist und ein Hinweis, der im unteren Bereich des
Fensters angezeigt wird:
Zum
Prüfen werden nur die XML-Elemente <MinimumLength>
und <MaximumLength>
herangezogen.
Es wird also nur die Länge eines eingegebenen
Textes geprüft – nicht die Ober- und Untergrenze von
numerischen Werten !
|
Dokument |
Inhalt |
|
JSBS_XML_Tasks – Basisklasse für das Verarbeiten der XML-Struktur mit der Liste der Task-Frames |
Klasse aus dem JavaScout-Basis-System (JSBS) in der diese Datei gelesen und die Parameter abgefragt werden. |