> 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  

Allgemein gültige Text-Elemente für die GUI 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 von allgemein gültigen Definitionen für GUI-Elemente

zum Inhaltsverzeichnis

Generelle Beschreibung und Eingabemöglichkeiten

In diesem Teilprogramm werden sprachabhängige Texte und Eingabebeschränkungen, die für GUI-Elemente in mehreren Teilprogrammen gelten sollen, festgelegt.

Damit können Eingabefelder für ein Attribut, dass in mehreren Teilprogrammen vorkommen – z.B. ein Produkt-Code – einmal in diesem Teilprogramm zentral mit einer Bezeichnung, einem erklärenden Text und eventuell Prüfregeln für die Eingabe versehen werden.
Bei Bedarf können die hier festgelegten Eigenschaften mit dem Teilprogramm
Texte und Layout für einzelnes GUI-Element verwalten individuell geändert werden.
Erfolgt dort keine individuelle Festlegung werden die in diesem Teilprogramm festgelegten Einstellungen verwendet.

Der Unterschied zu den im Teilprogramm Universell verwendbare Text-Elemente verwalten festgelegten Definitionen ist, dass dort nur ein sprachspezifischer Text für eine Programm-interne Bezeichnung festgelegt werden kann;
im hier beschriebenen Teilprogramm aber auch:
* Text für den Tool-Tipp; d.h. jener Text der einige Sekunden lang angezeigt wird wenn der Mauszeiger über dem GUI-Element platziert wird.
* Text für den Hinweis der im unteren Bereich des Fensters angezeigt wird; siehe
Informationszeile am unteren Rand des Fensters.
* Prüfregeln für die Eingabe wie minimale und maximale Länge einer Zeichenkette oder Minimum und Maximum für einen numerischen Wert.

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 den allgemein gültigen Text für GUI-Elemente 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 für die jeweilige Sprache verständliche Texte für die Bezeichnung des Eingabefeldes, für Tool-Tip und Beschreibung festzulegen.
Der ISO-Sprach-Code für das gewählte Projekt muss zuvor im Teilprogramm
Projekt und Sprache verwalten erfasst worden sein.

zum Inhaltsverzeichnis

GUI-Element-Name 

In diesem Feld wird jener Name erfasst, der innerhalb des Teilprogramms als Variablenname für das GUI-Element verwendet wird.

Nachdem dieser Name innerhalb der Methode processLanguageDependantElements(...) bzw. von darin aufgerufen Methoden innerhalb der Basisklasse JSBS_GUIServices aus dem Aufbau der GUI (Graphic User Interface / Grafische Benutzeroberfläche) des Teilprogramms ermittelt wird, muss der hier erfasste Name zu 100 % mit dem im Teilprogramm verwendeten Variablennamen für das GUI-Element übereinstimmen.

zum Inhaltsverzeichnis

GUI-Element-Text 

In diesem Feld wird der sprachspezifische Text für die Bezeichnung eines GUI-Elements erfasst.
Innerhalb der Klasse
JSBS_GUIServices wird dieser Text aber nur für jene Java-Klassen, bei denen eine Eingabe von Text oder eine Auswahl von Werten nicht möglich ist, verwendet.
Eine weitere Beschreibung über die Verwendung dieses Wertes finden Sie unter
Datei 'DisplayStrings.xml' mit sprachabhängigen Texten für die Anzeige auf der GUI > <ElementText>.

zum Inhaltsverzeichnis

Sprachabhängiger Text für den 'ToolTip' 

In diesem Feld wird der sprachspezifische Text, der einige Sekunden lang angezeigt wird wenn der Mauszeiger über dem GUI-Element platziert ist, erfasst.
Ein Beispiel für den Effekt finden Sie in diesem Dokument unter
Anzeige durch Bewegen des Mauszeigers über das Feld.

zum Inhaltsverzeichnis

Text im Hinweis-Feld 

In diesem Feld wird der sprachspezifische Text, der Hinweise über den Zweck des Eingabefeldes enthält und am unteren Rand des Fensters angezeigt wird wenn das Eingabefelde den 'Focus' erhält, erfasst.
Ein Beispiel für den Effekt finden Sie in diesem Dokument unter
Informationszeile am unteren Rand des Fensters.
Innerhalb der Klasse
JSBS_GUIServices wird dieser Text aber nur für bestimmte Java-Klassen verwendet. Eine weitere Beschreibung über die Verwendung dieses Wertes finden Sie unter Datei 'DisplayStrings.xml' mit sprachabhängigen Texten für die Anzeige auf der GUI > <InfoMessage>.

zum Inhaltsverzeichnis

Mindest-Wert in einem numerischen Eingabefeld 

In diesem Feld wird der kleinste erforderliche Eingabewert festgelegt wenn das Eingabefeld für einen numerischen Wert vorgesehen ist.
Die Prüfung dieses Wertes erfolgt durch die Methoden
getShort(...), getInteger(...) bzw. getBigDecimal(...) innerhalb der Klasse JSBS_GUIServices.
Eine weitere Beschreibung über die Verwendung dieses Wertes finden Sie unter
Datei 'DisplayStrings.xml' mit sprachabhängigen Texten für die Anzeige auf der GUI > <MinimumValue>.

zum Inhaltsverzeichnis

Höchst-Wert in einem numerischen Eingabefeld 

In diesem Feld wird der größte erlaubte Eingabewert festgelegt wenn das Eingabefeld für einen numerischen Wert vorgesehen ist.
Die Prüfung dieses Wertes erfolgt durch die Methoden
getShort(...), getInteger(...) bzw. getBigDecimal(...) innerhalb der Klasse JSBS_GUIServices.
Eine weitere Beschreibung über die Verwendung dieses Wertes finden Sie unter
Datei 'DisplayStrings.xml' mit sprachabhängigen Texten für die Anzeige auf der GUI > <MaximumValue>.

zum Inhaltsverzeichnis

Maximale Zahl der Kommastellen 

In diesem Feld wird die maximal erlaubte Anzahl der Stellen nach dem Komma festgelegt wenn das Eingabefeld für einen numerischen Wert vorgesehen ist.
Die Prüfung dieses Wertes erfolgt durch die Methode innerhalb der Klasse
JSBS_GUIServices.
Eine weitere Beschreibung über die Verwendung dieses Wertes finden Sie unter
Datei 'DisplayStrings.xml' mit sprachabhängigen Texten für die Anzeige auf der GUI > <NumberOfDecimals>.

zum Inhaltsverzeichnis

Geringste Länge bei alphanumerischer Eingabe 

In diesem Feld wird die minimale Anzahl von Zeichen, die bei einem Eingabefeld für einen alphanumerischen Wert (Text) erforderlich ist, festgelegt.
Die Prüfung dieses Wertes erfolgt durch die Methoden
getTextFromJTextField bzw. getTextFromJTextArea(...) innerhalb der Klasse JSBS_GUIServices.
Eine weitere Beschreibung über die Verwendung dieses Wertes finden Sie unter
Datei 'DisplayStrings.xml' mit sprachabhängigen Texten für die Anzeige auf der GUI > <MinimumLength>.

zum Inhaltsverzeichnis

Größte Länge bei alphanumerischer Eingabe 

In diesem Feld wird die maximale Anzahl von Zeichen, die bei einem Eingabefeld für einen alphanumerischen Wert (Text) erlaubt ist, festgelegt.
Die Prüfung dieses Wertes erfolgt durch die Methoden
getTextFromJTextField bzw. getTextFromJTextArea(...) innerhalb der Klasse JSBS_GUIServices.
Eine weitere Beschreibung über die Verwendung dieses Wertes finden Sie unter
Datei 'DisplayStrings.xml' mit sprachabhängigen Texten für die Anzeige auf der GUI > <MaximumLength>.

zum Inhaltsverzeichnis

Eingabe erforderlich 

Mit dieser Markierung wird festgelegt, dass eine Eingabe im betroffenen Feld verpflichtend ist.
Die Regeln zur Prüfung dieses Wertes müssen im Anwendungsprogramm direkt erfolgen.
Eine weitere Beschreibung über die Verwendung dieses Wertes finden Sie unter
Datei 'DisplayStrings.xml' mit sprachabhängigen Texten für die Anzeige auf der GUI > <Mandatory>.

zum Inhaltsverzeichnis

Erklärender Kommentar 

In diesem Feld kann eine detaillierte Beschreibung, wofür der Text vorgesehen ist, erfasst werden.
Damit kann bei nicht intuitiven Namen eine zusätzliche Beschreibung gespeichert werden.

Der in diesem Feld erfasste Text wird nicht auf die (vom Anwendungsprogramm verwendete) Datei 'DisplayStrings.xml' exportiert und kann daher nicht mehr durch das Teilprogramm Allgemein gültige Text-Elemente für die GUI importieren wieder eingelesen 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

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 ein allgemein verwendbares Text-Element für die GUI geändert werden kann finden Sie im Dokument Leitfaden – Start-Frame (CommandCenter); Importieren und Festlegen von Layout, Textbausteinen, Funktionstasten-Zuordnungen und Fehlermeldungen > Allgemein gültiges Text-Element für die Bezeichnung des Anwendungsprogramms adaptieren .

Für die Verwaltung der allgemein gültigen Text-Elemente für die GUI im Zuge der Entwicklung eines Anwendungsprogramms folgen Sie bitte dem Verzeichnis: Leitfaden für die Entwicklung von Heavyweight-Clients mit dem JS-FCF. Dort finden Sie die entsprechenden Anleitungen, zu welchem Zeitpunkt im Entwicklungsprozess die sprachabhängigen Texte für die GUI-Elemente festgelegt werden.

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