|
Inhalt dieses
Dokuments: |
|
|
Weitere
Dokumente: |
|
|
Dieses
Dokument drucken. |
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.
In diesem Teilprogramm werden sprachabhängige Texte, Layout und Eingabebeschränkungen, die für ein genau bestimmtes einzelnes GUI-Element in einem Teilprogramm gelten sollen, festgelegt.
Werden keine abweichenden Werte für das Layout (Font-Name, Font-Größe, Font-Farbe oder Font-Stil) festgelegt, werden die im Teilprogramm Layout-Eigenschaften der GUI verwalten erfassten Werte für die Anzeige im jeweiligen Anwendungsprogramm verwendet.
Festlegungen
für sprachabhängige Texte (Sprachabhängiger Text für
das GUI-Element, Sprachabhängiger Text für den 'ToolTip'
und Sprachabhängiger Text für die Message-Zeile) und
Eingabebeschränkungen (Mindest-Wert in einem numerischen Feld,
Höchst-Wert in einem numerischen Feld, Maximale Zahl der
Kommastellen, Geringste Länge bei alphanumerischer Eingabe,
Größte Länge bei alphanumerischer Eingabe und Eingabe
erforderlich) können von einer allgemein gültigen
Definition (erfolgt im Teilprogramm Allgemein
gültige Text-Elemente für die GUI verwalten)
übernommen werden.
Die Referenz auf ein allgemein gültiges
Text-Element ('Common-Element') erfolgt durch die Auswahl in der
Combobox Referenz auf ein 'Common Element'.
Festlegungen aus dem
allgemein gültigen Text-Element werden übernommen wenn das
entsprechende Eingabefeld in diesem Teilprogramm leer gelassen
wird.
Wird im entsprechenden Eingabefeld dieses Teilprogramms ein
Wert erfasst dann gilt dieser Wert für das in diesem
Teilprogramm verwaltete GUI-Element.
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.
In
diesem Eingabe-Feld wird das GUI-Element einem Projekt
zugeordnet.
Der Projekt-Code für das Projekt muss zuvor im
Teilprogramm Projekt
und Sprache verwalten erfasst
worden sein.
Gemeinsam mit dem ISO-Sprach-Code
und dem Frame-Name wird das
verwaltete GUI-Element eindeutig einem Teilprogramm des gesamten
Anwendungsprogramms zugeordnet.
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.
Gemeinsam mit dem Projekt-Code
und dem Frame-Name wird das
verwaltete GUI-Element eindeutig einem Teilprogramm des gesamten
Anwendungsprogramms zugeordnet.
In
diesem Eingabe-Feld wird der Name der (Java-) Klasse des
Teilprogramms, in dem das verwaltete GUI-Element platziert ist,
ausgewählt.
Genau genommen ist es jene Klasse des
Teilprogramms, die den Programm-Code für die Anzeige des
Fensters mit der Grafischen Benutzeroberfläche (GUI / Graphic
User Interface) enthält.
In der Programmiersprache Java wird
das Fenster als 'Frame' bezeichnet – deswegen wurde diese
Bezeichnung gewählt.
Der Frame-Name für die gewählte
Kombination aus Projekt und Sprache muss zuvor im Teilprogramm Frame
(Fenster) verwalten erfasst
worden sein.
Gemeinsam mit dem Projekt-Code
und ISO-Sprach-Code wird das
verwaltete GUI-Element eindeutig einem Teilprogramm des gesamten
Anwendungsprogramms zugeordnet.
In diesem Feld wird jener Name erfasst, der innerhalb des Teilprogramms (ausgewählt unter Frame-Name) 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.
Referenz
auf ein 'Common-Element' 
In
diesem Auswahl-Feld können – wenn gewünscht - die
Eigenschaften eines allgemein gültigen Text-Elements übernommen
werden.
Dieses kann mit dem Teilprogramm Allgemein
gültige Text-Elemente für die GUI verwalten
festgelegt
werden.
Im
oben abgebildeten Beispiel werden keine Eigenschaften
übernommen.
Durch das 'Aufklappen' der Combobox werden alle
allgemein gültigen Text-Elemente, die für die bereits
gewählte Kombination aus Projekt-Code
und ISO-Sprach-Code existieren,
angezeigt und es kann eines ausgewählt werden:
Sprachabhängiger
Text für das GUI-Element 
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>.
Im
oben abgebildeten Beispiel werden die Eigenschaften eines
Eingabefeldes definiert – deswegen ist der Sprachabhängige
Text für das GUI-Element nicht von Bedeutung.
In dazu
gehörenden 'Label' (für die Bezeichnung des Eingabefeldes
im Beispiel) ist folgender Text erfasst:
Wird dieses Eingabefeld leer gelassen und wurde unter Referenz auf ein 'Common-Element' ein allgemein gültiges Text-Element ausgewählt, dann wird der beim allgemein gültigen Text-Element festgelegte Text im Teilprogramm verwendet.
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.
Wird
dieses Eingabefeld leer gelassen und wurde unter Referenz
auf ein 'Common-Element' ein allgemein gültiges Text-Element
ausgewählt, dann wird der beim allgemein gültigen
Text-Element festgelegte Text für den 'ToolTip' im Teilprogramm
verwendet.
Sprachabhängiger
Text für die Message-Zeile 
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>.
Wird
dieses Eingabefeld leer gelassen und wurde unter Referenz
auf ein 'Common-Element' ein allgemein gültiges Text-Element
ausgewählt, dann wird der beim allgemein gültigen
Text-Element festgelegte Text für die Message-Zeile im
Teilprogramm verwendet.
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>.
Wird dieses Eingabefeld leer gelassen und wurde unter Referenz auf ein 'Common-Element' ein allgemein gültiges Text-Element ausgewählt, dann wird der beim allgemein gültigen Text-Element festgelegte Mindest-Wert im Teilprogramm verwendet.
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>.
Wird
dieses Eingabefeld leer gelassen und wurde unter Referenz
auf ein 'Common-Element' ein allgemein gültiges Text-Element
ausgewählt, dann wird der beim allgemein gültigen
Text-Element festgelegte Höchst-Wert im Teilprogramm verwendet.
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>.
Wird
dieses Eingabefeld leer gelassen und wurde unter Referenz
auf ein 'Common-Element' ein allgemein gültiges Text-Element
ausgewählt, dann wird der beim allgemein gültigen
Text-Element festgelegte Mindest-Wert im Teilprogramm verwendet.
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>.
Wird
dieses Eingabefeld leer gelassen und wurde unter Referenz
auf ein 'Common-Element' ein allgemein gültiges Text-Element
ausgewählt, dann wird die beim allgemein gültigen
Text-Element festgelegte Mindest-Länge im Teilprogramm
verwendet.
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>.
Wird
dieses Eingabefeld leer gelassen und wurde unter Referenz
auf ein 'Common-Element' ein allgemein gültiges Text-Element
ausgewählt, dann wird die beim allgemein gültigen
Text-Element festgelegte Maximal-Länge im Teilprogramm
verwendet.
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>.
In diesem Auswahl-Feld kann die Schriftart für das einzelne GUI-Element festgelegt werden oder die im Teilprogramm Layout-Eigenschaften der GUI verwalten definierte, für das gesamte Anwendungsprogramm gültige, Auswahl übernommen werden.
Durch
die Auswahl '- Standard -' (wie auf dem Beispiel-Bild) wird der für
das gesamte Anwendungsprogramm gültige Wert übernommen.
Durch
Aufklappen der Combobox kann eine, nur für dieses GUI-Element
gültige, andere Einstellung festgelegt werden:
In diesem Auswahl-Feld kann die Schriftfarbe für das einzelne GUI-Element festgelegt werden oder die im Teilprogramm Layout-Eigenschaften der GUI verwalten definierte, für das gesamte Anwendungsprogramm gültige, Auswahl übernommen werden.
Durch
die Auswahl '- Standard -' (wie auf dem Beispiel-Bild) wird der für
das gesamte Anwendungsprogramm gültige Wert übernommen.
Durch
Aufklappen der Combobox kann eine, nur für dieses GUI-Element
gültige, andere Einstellung festgelegt werden:
In diesem Auswahl-Feld kann die Schriftgröße (in Punkten) für das einzelne GUI-Element festgelegt werden oder die im Teilprogramm Layout-Eigenschaften der GUI verwalten definierte, für das gesamte Anwendungsprogramm gültige, Auswahl übernommen werden.
Durch
die Auswahl '- Standard -' (wie auf dem Beispiel-Bild) wird der für
das gesamte Anwendungsprogramm gültige Wert übernommen.
Durch
Aufklappen der Combobox kann eine, nur für dieses GUI-Element
gültige, andere Einstellung festgelegt werden:
In diesem Auswahl-Feld kann der Schriftstil (normal, fett, kursiv) für das einzelne GUI-Element festgelegt werden oder die im Teilprogramm Layout-Eigenschaften der GUI verwalten definierte, für das gesamte Anwendungsprogramm gültige, Auswahl übernommen werden.
Durch
die Auswahl '- Standard -' (wie auf dem Beispiel-Bild) wird der für
das gesamte Anwendungsprogramm gültige Wert übernommen.
Durch
Aufklappen der Combobox kann eine, nur für dieses GUI-Element
gültige, andere Einstellung festgelegt werden:
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
Individuell
gültige Text-Elemente für ein Frame (Fenster) der GUI
importieren wieder
eingelesen werden.
In
diesem Eingabe-Feld wird der Code des Projektes ausgewählt für
das (gemeinsam mit dem gewählten Filter
für Sprach-Code und dem gewählten Filter
für Frame-Klasse) die bereits erfassten individuellen
GUI-Elemente in der Auswahl-Liste angezeigt werden sollen.
Der
Projekt-Code muss zuvor im Teilprogramm Projekt
und Sprache verwalten erfasst
worden sein.
In
diesem Eingabe-Feld wird der Code der Sprache ausgewählt für
die (gemeinsam mit dem gewählten Filter
für Projekt-Code und dem gewählten Filter
für Frame-Klasse) die bereits erfassten individuellen
GUI-Elemente 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.
In
diesem Eingabe-Feld wird der Name der (Java-) Klasse des
Teilprogramms ausgewählt für die (gemeinsam mit dem
gewählten Filter für
Projekt-Code und dem gewählten Filter
für Sprach-Code) die bereits erfassten individuellen
GUI-Elemente in der Auswahl-Liste angezeigt werden sollen.
Die
Frame-Klasse für die gewählte Kombination Projekt/Sprache
muss zuvor im Teilprogramm Frame
(Fenster) verwalten erfasst
worden sein.
In diesem Eingabefeld wird jener Datensatz ausgewählt, dessen Detail-Daten angezeigt werden sollen oder der gelöscht werden soll.
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.
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. |
|
|
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. |
|
|
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. |
Die Verwaltung in diesem Teilprogramm ist zur Unterstützung bei der Entwicklung von Anwendungsprogrammen mit dem JavaScout BaseSystem (JSBS).
Die
Nutzung der mit diesem Teilprogramm verwalteten Werte in
Anwendungsprogrammen erfolgt implizit durch die Methoden in der
Klasse JSBS_GUIServices.
Für
die 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.
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
Im Teilprogramm Individuell gültige Text-Elemente für ein Frames (Fenster) der GUI importieren können die Werte der XML-Struktur einer bestehenden Datei in die Datenbank importiert werden.
Im Teilprogramm XML-Datei für sprach-abhängige Texte generieren wird eine Datei mit der gewünschten XML-Struktur erstellt.
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.
