> JavaScout ProjectAssist - Inhalt


Inhalt dieses Dokuments: 
 Generelle Beschreibung und Eingabemöglichkeiten :: Anwendungsbeispiele :: Verwandte Dokumentation 

Weitere Dokumente: 
 
Fehler und Warnungen :: Schaltflächen (Buttons) - Generelle Beschreibung :: Rand-Farben - Bedeutung bei Eingabefeldern und Schaltflächen  

Frame (Fenster) verwalten :: ProjectAssist für das JavaScout Fat-Client-Framework

* Bitte beachten Sie die Hinweise und Bestimmungen bezüglich Urheberrecht, Haftungsausschluss und geschützte Marken oder Warenzeichen die für dieses Web-Dokument und möglicherweise auch für 'verlinkte' Dokumente gelten.  

Dieses Dokument drucken.
 Letzte Bearbeitung dieses  Dokuments: 2011-05-18

Die in diesem Teilprogramm verwalteten Einstellungen sind Teil der Festlegung der Graphischen Benutzeroberfläche (GUI / Graphic User Interface) eines Anwendungsprogramms.
Eine zusammenhängende Erklärung aller für die GUI möglichen Einstellungen finden Sie in den Dokumenten
Leitfaden – Start-Frame (CommandCenter); Importieren und Festlegen von Layout, Textbausteinen, Funktionstasten-Zuordnungen und Fehlermeldungen und Leitfaden – Task-Frame (Teilprogramm für einen Geschäftsfall); Importieren und Festlegen von Textbausteinen, Funktionstasten-Zuordnungen und Fehlermeldungen .
Dieses Hilfe-Dokument erklärt nur jene Einstellungen, die in diesem Teilprogramm verwaltet werden.

Bitte klicken Sie auf das entsprechende Eingabefeld oder Schaltfläche um zur Beschreibung zu kommen.
Eine Überblicks-Beschreibung dieser Geschäftsanwendung finden Sie nach dem Bild der Eingabemaske.

Task-Frame für die Verwaltung eines Fensters (Frame)

zum Inhaltsverzeichnis

Generelle Beschreibung und Eingabemöglichkeiten

In diesem Teilprogramm werden die einzelnen Fenster für die Teilprogramme einer Anwendung festgelegt.
Den hier festgelegten Fenstern kann in den Teilprogrammen
Texte und Layout für ein einzelnes GUI-Element verwalten und Text und Eigenschaften für die Spalte eines JTable GUI-Elements verwalten die Beschreibung für individuelle GUI-Elemente zugeordnet werden.

Weiters werden einem Fenster folgende Eigenschaften zugeordnet:

Die in diesem Teilprogramm erfassten Definitionen können durch das Teilprogramm XML-Datei für sprach-abhängige Texte generieren als XML-Struktur in eine Datei (Beschreibung im Dokument Datei 'DisplayStrings.xml' mit sprachabhängigen Texten für die Anzeige auf der GUI) exportiert werden und diese Datei kann innerhalb des JavaScout Fat-Client-Frameworks (JS-FCF) für die Entwicklung von Anwendungsprogrammen verwendet werden.

Projekt-Code 

In diesem Eingabe-Feld werden die Daten für das Fenster (Frame) einem Projekt zugeordnet.
Der Projekt-Code für das Projekt muss zuvor im Teilprogramm
Projekt und Sprache verwalten erfasst worden sein.

zum Inhaltsverzeichnis

ISO-Sprach-Code 

In diesem Eingabe-Feld wird der Code der Sprache ausgewählt.
Durch die weitere Unterteilung nach der Sprache ist es möglich, für verschiedene Sprachversionen des Anwendungsprogramms passende Texte für das Fenster zu definieren.
Der ISO-Sprach-Code für das gewählte Projekt muss zuvor im Teilprogramm
Projekt und Sprache verwalten erfasst worden sein.

zum Inhaltsverzeichnis

Name der (Java-)Klasse inkl. 'package' 

Dieser Wert ist die (Java-)Klasse die das Fenster (Frame) aufbaut und auf der Benutzeroberfläche anzeigt,

Innerhalb des JavaScout Fat-Client-Framework (JS-FCF) wird über das JavaScout Basis-System (JSBS) der Name der (Java-)Klasse ermittelt und über die Basisklasse JSBS_GUIServices (und darin verwendeten Methoden) die Eigenschaften für das Fenster aus der Datei 'DisplayStrings.xml' ausgelesen und das Fenster angepasst.

zum Inhaltsverzeichnis

Text für die 'Title-Bar' des Frames 

Dieser Wert wird im oberen, breiten, Rahmen des Fensters (Frame) angezeigt.
Der erfasste Text führt zu diesem Ergebnis:

zum Inhaltsverzeichnis

Name der Datei (ohne Verzeichnis-Teil) mit der Grafik für das Icon in der Title-Bar 

Dieser Wert ist der Name jener Datei, die das Symbol enthält das in der 'Titlebar' (das ist der obere Balken eines Frames) angezeigt wird.
Abhängig vom Betriebssystem wird dieses Symbol auch in der Übersichtliste der aktiven Programme angezeigt.

Dieses XML-Element enthält nur den Namen der Datei – nicht das Unterverzeichnis.
Innerhalb des
JavaScout Fat-Client-Framework (JS-FCF) wird über das JavaScout Basis-Systems (JSBS) der Name der (Java-)Klasse ermittelt und über die Basisklasse JSBS_GUIServices (und darin verwendeten Klassen) der Name dieser Datei aus der Datei 'DisplayStrings.xml' ausgelesen und die Grafik eingefügt.

Das Symbol in der gewählten Datei wird so angezeigt:
     

Innerhalb des JavaScout Fat-Client-Framework (JS-FCF) und des JavaScout Basis-Systems (JSBS) wird die im Dokument Verzeichnisstruktur für die Entwicklung von Heavyweight-Clients mit dem JS-FCF beschriebene Struktur verwendet; die Dateien mit den Symbolen werden im Unterverzeichnis 'GRAPHICS' erwartet.
Wenn Sie mit der Datei-Struktur für das
JavaScout Fat-Client-Framework (JS-FCF) nicht vertraut sind, finden Sie eine detaillierte Anleitung zur Auswahl der Datei unter Anwendungsbeispiele > Auswahl der Datei mit dem graphischen Symbol.

Der Name der Datei kann direkt als Text im Eingabefeld erfasst werden oder über die Schaltfläche [ Datei mit Icon-Grafik auswählen ] ausgewählt und in dieses Eingabefeld übernommen werden.

zum Inhaltsverzeichnis

Name der Datei (mit Teil-Verzeichnis) mit dem Hilfe-Dokument 

Dieser Wert ist ein Teil-Verzeichnis und der Name der Datei mit dem Hilfe-Dokument.
Das in der angegebenen Datei enthaltene Dokument wird aufgerufen wenn die Schaltfläche
[ Hilfe ] mit der linken Maustaste angeklickt wird.

Innerhalb des
JavaScout Fat-Client-Framework (JS-FCF) wird über das JavaScout Basis-Systems (JSBS) der Name der (Java-)Klasse ermittelt und über die Basisklasse JSBS_StartFrame (und darin verwendeten Klassen) der Name dieser Datei aus der Datei 'DisplayStrings.xml' ausgelesen und der Inhalt der Datei angezeigt.

Innerhalb des JavaScout Fat-Client-Framework (JS-FCF) und des JavaScout Basis-Systems (JSBS) wird die im Dokument Verzeichnisstruktur für die Entwicklung von Heavyweight-Clients mit dem JS-FCF beschriebene Struktur verwendet; die Dateien mit den Hilfe-Texten werden im Unterverzeichnis 'HELP' erwartet.
Unterhalb des Verzeichnisses 'HELP' kann das in diesem Eingabefeld erfasste Verzeichnis vorhanden sein.
Wenn Sie mit der Datei-Struktur für das
JavaScout Fat-Client-Framework (JS-FCF) nicht vertraut sind finden Sie eine detaillierte Anleitung zur Auswahl der Datei unter Anwendungsbeispiele > Auswahl der Datei mit dem Hilfe-Dokument.

Der Name der Datei (und ein eventuell erforderliches Unterverzeichnis) kann direkt als Text im Eingabefeld erfasst werden oder über die Schaltfläche [ Datei mit Hilfe-Dokument auswählen ] ausgewählt und in dieses Eingabefeld übernommen werden.

zum Inhaltsverzeichnis

Filter für Projekt-Code 

In diesem Eingabe-Feld wird der Code des Projektes ausgewählt für das (gemeinsam mit dem gewählten Filter für Sprach-Code) die bereits erfassten Zuordnungen in der Auswahl-Liste angezeigt werden sollen.
Der Projekt-Code muss zuvor im Teilprogramm
Projekt und Sprache verwalten erfasst worden sein.

zum Inhaltsverzeichnis

Filter für Sprach-Code 

In diesem Eingabe-Feld wird der Code der Sprache ausgewählt für die (gemeinsam mit dem gewählten Filter für Projekt-Code) die bereits erfassten Zuordnungen in der Auswahl-Liste angezeigt werden sollen.
Der ISO-Sprach-Code für das gewählte Projekt muss zuvor im Teilprogramm
Projekt und Sprache verwalten erfasst worden sein.

zum Inhaltsverzeichnis

Auswahl 

In diesem Eingabefeld wird jener Datensatz ausgewählt, dessen Detail-Daten angezeigt werden sollen oder der gelöscht werden soll.

zum Inhaltsverzeichnis

Informationen zu einzelnen Feldern, Warnungen und Fehlern

Informationszeile am unteren Rand des Fensters 

In diesem Bereich werden kurze Erklärungen zur Bedeutung des ausgewählten Feldes angezeigt.


Anzeige durch Bewegen des Mauszeigers über das Feld 

Wenn der Mauszeiger über einem Eingabefeld positioniert wird, wird für einige Sekunden ein Hinweis über die Bedeutung des ausgewählten Feldes angezeigt.

Detaillierte Warnungen und Informationen über aufgetretene Fehler 

Die möglichen Warnungen (deren Ursachen durch den Benutzer korrigiert werden können) und Fehler (deren Ursachen Fehler innerhalb des Anwendungsprogramms oder technische Gebrechen sein können – und damit nicht durch den Benutzer korrigiert werden können) sind nicht im einzelnen in dieser Dokumentation aufgelistet.

Bei Warnungen und Fehlern wird ein eigenes Fenster geöffnet, das einen Code für die Ursache und einen Text mit der Beschreibung der Ursache und Vorschlägen zur Beseitigung der Ursache enthält.
Die Varianten dieses Fensters sind im Dokument
Fehler und Warnungen - Generelle Beschreibung beschrieben.

zum Inhaltsverzeichnis

Schaltflächen

[Datei mit Icon-Grafik auswählen] 

Diese Schaltfläche kann verwendet werden um einen Wert für das Eingabefeld Name der Datei (ohne Verzeichnis-Teil) mit der Grafik für das Icon in der Title-Bar auswählen zu können.
Nach dem Anklicken dieser Schaltfläche öffnet sich ein Fenster mit dem ein Verzeichnis und eine Datei ausgewählt werden kann.

[Datei mit Hilfe-Dokument auswählen] 

Diese Schaltfläche kann verwendet werden um einen Wert für das Eingabefeld Name der Datei (mit Teil-Verzeichnis) mit dem Hilfe-Dokument auswählen zu können.
Nach dem Anklicken dieser Schaltfläche öffnet sich ein Fenster mit dem ein Verzeichnis und eine Datei ausgewählt werden kann.

Allgemein vorhandene Schaltflächen

Eine detaillierte Beschreibung dieser Schaltflächen mit Anwendungsbeispielen finden Sie im Dokument Schaltflächen (Buttons) – Generelle Beschreibung.

Hier die Kurzbeschreibung:

Durch Anklicken dieser Schaltfläche wird die Hilfe zur Geschäftsanwendung (also dieses Dokument) aufgerufen.

Durch Anklicken dieser Schaltfläche wird das Fenster 'CommandCenter' mit den Möglichkeiten zum Aufrufen von Geschäftsanwendungen aufgerufen.

Durch Anklicken dieser Schaltfläche wird eine Auswahl der Möglichkeiten zum Drucken von Dokumenten aufgerufen.
In dieser Geschäftsanwendung gibt es keine Möglichkeit, Daten auszudrucken – deswegen ist diese Schaltfläche permanent deaktiviert.

Durch Anklicken dieser Schaltfläche werden neu erfasste oder geänderte Daten gespeichert.

Durch Anklicken dieser Schaltfläche werden die angezeigten Daten auf einen neuen Datensatz kopiert.
Anschließend muß die Kombination aus Projekt-Code und Sprach-Code auf einen noch nicht vorhandenen Wert geändert werden.

Durch Anklicken dieser Schaltfläche werden die Daten für jene Kombination aus Projekt-Code und Sprach-Code, die in der Sortierreihenfolgen vor dem gerade angezeigten Datensatz kommt, angezeigt.

Durch Anklicken dieser Schaltfläche werden die Daten für jene Kombination aus Projekt-Code und Sprach-Code, die in der Sortierreihenfolgen nach dem gerade angezeigten Datensatz kommt, angezeigt.

Durch Anklicken dieser Schaltfläche werden die Daten des ausgewählten Datensatzes im Detail angezeigt und können anschließend geändert oder kopiert werden.

Durch Anklicken dieser Schaltfläche wird der ausgewählte Datensatz gelöscht.

zum Inhaltsverzeichnis

Anwendungsbeispiele

Eine einführende Anleitung, wie die Werte für ein Frame (Fenster) erfasst oder geändert werden können finden Sie im Dokument Leitfaden – Start-Frame (CommandCenter); Importieren und Festlegen von Layout, Textbausteinen, Funktionstasten-Zuordnungen und Fehlermeldungen > Eintrag für das CommandCenter-Frame (Fenster) anlegen .

Detaillierte Anleitungen:
Auswahl der Datei mit dem graphischen Symbol 
Auswahl der Datei mit dem Hilfe-Dokument 


Auswahl der Datei mit dem graphischen Symbol

Bei der Auswahl der Datei (über die Schaltfläche [ Datei mit Icon-Grafik auswählen ]) wird angenommen, dass die Verzeichnisstruktur so ist wie im Dokument Verzeichnisstruktur für die Entwicklung von Heavyweight-Clients mit dem JS-FCF beschrieben.
Damit kann aus dem Wert für
im Eingabefeld Ausgewähltes Verzeichnis des Teilprogramms Projekt und Sprache verwalten das Verzeichnis, das die Dateien für die Symbole (Icons) enthält, abgeleitet werden.
In diesem Fall wird nur der Name der Datei in das Eingabefeld
Name der Datei (ohne Verzeichnis-Teil) mit der Grafik für das Icon in der Title-Bar übernommen.

Selbstverständlich kann auch ein anderes als das vorgeschlagene Verzeichnis ausgewählt werden – in diesem Fall wird nicht nur der Name der Datei sondern das gesamte ausgewählte Verzeichnis in das Eingabefeld Name der Datei (ohne Verzeichnis-Teil) mit der Grafik für das Icon in der Title-Bar übernommen.

Klicken Sie mit der linken Maustaste auf die Schaltfläche [ Datei mit Icon-Grafik auswählen ] um das Fenster für die Auswahl der Datei zu öffnen.

Alternativ können Sie auch die zugeordnete Funktionstaste der Tastatur (im Beispiel: F10) verwenden.

Anschließend erscheint das Fenster zum Auswählen der Datei.
Sie sehen, dass bereits das zugehörige Unterverzeichnis ausgewählt wurde.
Die Auswahl des Unterverzeichnisses ist durch den Wert im Eingabefeld
Ausgewähltes Verzeichnis des Teilprogramms Projekt und Sprache verwalten vorgegeben.

Wenn Sie anschließend ein anderes Verzeichnis auswählen wollen finden Sie die Beschreibung für das weitere Vorgehen wenn Sie diesem Link folgen.

Wenn die Verzeichnisstruktur Ihres Projekts den Vorgaben im Dokument Verzeichnisstruktur für die Entwicklung von Heavyweight-Clients mit dem JS-FCF entspricht sehen Sie die Dateien mit den Symbolen (Icons) – wenn Sie diese bereits entworfen haben.

Wählen Sie die entsprechende Datei aus und bestätigen Sie durch Anklicken der Schaltfläche [ OK ] mit der linken Maustaste.
Damit wird auch das Fenster wieder geschlossen.

Nachdem das vorgegebene Verzeichnis nicht verändert wurde, wird nur der Dateiname – ohne Verzeichnisstruktur – im Eingabefeld angezeigt.



Alternativ können Sie auch ein anderes Verzeichnis wählen.

Das Auswählen eines anderen Verzeichnisses kann zum Beispiel notwendig sein, wenn Sie während der Software-Entwicklung eine andere als die von ProjectAssist erwartete Verzeichnisstruktur verwenden.

Wählen Sie das entsprechende Verzeichnis und die entsprechende Datei aus und bestätigen Sie durch Anklicken der Schaltfläche [ OK ] mit der linken Maustaste.
Damit wird auch das Fenster wieder geschlossen.

Als Hinweis, dass das gewählte Verzeichnis nicht den erwarteten Regeln entspricht und unter Umständen das Symbol nicht angezeigt werden kann erscheint die abgebildete Warnung.

Schließen Sie das Fenster durch Anklicken der Schaltfläche [ Weiter ] bzw. durch die zugeordnete Funktionstaste.

In diesem Fall wird die komplette Verzeichnisstruktur mit der Datei im Eingabefeld angezeigt.

Dieser Wert ist nicht geeignet für die Endversion des zu entwickelnden Anwendungsprogramms.
Korrigieren Sie bitte den Wert manuell entsprechend der in der Endversion gültigen Verzeichnisstruktur.

zum Inhaltsverzeichnis

Auswahl der Datei mit dem Hilfe-Dokument

Bei der Auswahl der Datei (über die Schaltfläche [ Datei mit Hilfe-Dokument auswählen ]) wird angenommen, dass die Verzeichnisstruktur so ist wie im Dokument Verzeichnisstruktur für die Entwicklung von Heavyweight-Clients mit dem JS-FCF beschrieben.
Damit kann aus dem Wert für
im Eingabefeld Ausgewähltes Verzeichnis des Teilprogramms Projekt und Sprache verwalten das Verzeichnis, das die Dateien für die Symbole (Icons) enthält, abgeleitet werden.
In diesem Fall wird nur der Name der Datei in das Eingabefeld
Name der Datei (ohne Verzeichnis-Teil) mit der Grafik für das Icon in der Title-Bar übernommen.

Selbstverständlich kann auch ein anderes als das vorgeschlagene Verzeichnis ausgewählt werden – in diesem Fall wird nicht nur der Name der Datei (und der notwendige Teil des Unterverzeichnisses) sondern das gesamte ausgewählte Verzeichnis in das Eingabefeld Name der Datei (mit Teil-Verzeichnis) mit dem Hilfe-Dokument übernommen.

Klicken Sie mit der linken Maustaste auf die Schaltfläche [ Datei mit Hilfe-Dokument auswählen ] um das Fenster für die Auswahl der Datei zu öffnen.

Alternativ können Sie auch die zugeordnete Funktionstaste der Tastatur (im Beispiel: F11) verwenden.

Anschließend erscheint das Fenster zum Auswählen der Datei.
Sie sehen, dass bereits das zugehörige Unterverzeichnis ausgewählt wurde.
Die Auswahl des Unterverzeichnisses ist durch den Wert im Eingabefeld
Ausgewähltes Verzeichnis des Teilprogramms Projekt und Sprache verwalten vorgegeben.

Wenn Sie anschließend ein anderes Verzeichnis auswählen wollen finden Sie die Beschreibung für das weitere Vorgehen wenn Sie diesem Link folgen.

Wenn die Verzeichnisstruktur Ihres Projekts den Vorgaben im Dokument Verzeichnisstruktur für die Entwicklung von Heavyweight-Clients mit dem JS-FCF entspricht sehen Sie die Dateien mit den Hilfe-Dokumenten oder eine weitere Unterteilung in Verzeichnisse.

Wählen Sie die entsprechende Datei aus (bzw. manövrieren Sie vorher in das entsprechende Verzeichnis) und bestätigen Sie durch Anklicken der Schaltfläche [ OK ] mit der linken Maustaste.
Damit wird auch das Fenster wieder geschlossen.

Nachdem das vorgegebene Verzeichnis nicht verändert wurde, wird nur das Teil-Verzeichnis und der Dateiname im Eingabefeld angezeigt.



Alternativ können Sie auch ein anderes Verzeichnis wählen.

Das Auswählen eines anderen Verzeichnisses kann zum Beispiel notwendig sein, wenn Sie während der Software-Entwicklung eine andere als die von ProjectAssist erwartete Verzeichnisstruktur verwenden.

Wählen Sie das entsprechende Verzeichnis und die entsprechende Datei aus und bestätigen Sie durch Anklicken der Schaltfläche [ OK ] mit der linken Maustaste.
Damit wird auch das Fenster wieder geschlossen.

Als Hinweis, dass das gewählte Verzeichnis nicht den erwarteten Regeln entspricht und unter Umständen das Symbol nicht angezeigt werden kann erscheint die abgebildete Warnung.

Schließen Sie das Fenster durch Anklicken der Schaltfläche [ Weiter ] bzw. durch die zugeordnete Funktionstaste.

In diesem Fall wird die komplette Verzeichnisstruktur mit der Datei im Eingabefeld angezeigt.

Dieser Wert ist nicht geeignet für die Endversion des zu entwickelnden Anwendungsprogramms.
Korrigieren Sie bitte den Wert manuell entsprechend der in der Endversion gültigen Verzeichnisstruktur.

zum Inhaltsverzeichnis

Verwandte Dokumentation

Referenz auf das Datenmodell

In diesem Fenster erfasste Daten werden nur in einer einzigen Datenbank-Tabelle gespeichert.
Die Beschreibung der Attribute finden Sie im Dokument
LangDepElement (DB-Tabelle für sprachabhängige Eigenschaften von GUI-Elementen).

Weitere Teilprogramme

XML-Struktur der final erstellten Datei

Die in diesem Teilprogramm verwalteten Daten werden für den endgültigen Einsatz in eine Datei mit XML-Struktur geschrieben.
Unter
Datei 'DisplayStrings.xml' mit sprachabhängigen Texten für die Anzeige auf der GUI finden Sie die Beschreibung der XML-Struktur.

zum Inhaltsverzeichnis