Leitfaden für die Entwicklung von Heavyweight-Clients mit dem JS-FCF – Alle Schritte zur Entwicklung des Task-Frames

Inhaltsverzeichnis

Vorbedingungen 
Leitfaden – Alle Schritte 
Weitere Schritte und verwandte Dokumentation 

Vorbedingungen

Die Anleitungen in diesem Dokument werden Sie nur verstehen, wenn Sie bereits Kenntnisse über die Entwicklung von Heavyweight-Clients mit dem JavaScout-Fat-Client-Framework (JS-FCF) besitzen.

Wenn Sie zufällig auf dieses Dokument gestoßen sind und mehr über das JS-FCF wissen wollen, empfehle ich, mit dem Dokument Vorstellung des JavaScout-Fat-Client-Framework (JS-FCF) zu beginnen und – abhängig von Ihrer verfügbaren Zeit – das dort enthaltene Tutorial durchzuarbeiten.

▲ zum Inhaltsverzeichnis

Leitfaden – Alle Schritte

Wenn Sie mit dem JS-FCF Erfahrung haben, ist diese Übersicht als 'To Do Liste' zum 'Abhaken' der Tätigkeiten gedacht.
Bei jeder Tätigkeit ist in der Spalte in Stichworten ein 'Link' ([mehr...]) zu finden, der Sie zu einer detaillierteren Beschreibung der Tätigkeit führt.
In der Spalte Tutorial finden Sie den 'Link' zum entsprechenden Dokument im Tutorial für die Entwicklung von Fat-Clients mit Java.

Entgegen ursprünglichen Plänen ist dieser Leitfaden nicht in 'Notwendige Schritte' und 'Abschließende Schritte' geteilt – auch wenn Sie möglicherweise in anderen Dokumenten noch Hinweise darauf finden.

Durch die Verwendung von Muster-Codes für die drei 'beteiligten' Klassen und die Verwendung der 'Find/Replace...' Funktion des Editors ist es schneller möglich, die Klassen komplett zu adaptieren. Eine Teilung in 'Notwendige Schritte' und 'Abschließende Schritte' wäre ein zusätzlicher Arbeitsaufwand der nicht mehr gerechtfertigt ist.

▲ zum Inhaltsverzeichnis

Klasse für das Task-Frame und zugehörigen 'ActionHandler' und 'DocumentListener' eröffnen

• * 'Package' mit der Namenskonvention projektname.client.
  * Klassen mit der Namenskonvention ProjektName_TaskName, ProjektName_TaskName__ActionHandler und ProjektName_TaskName__DocumentListener.
  * Folgende Auswahlmöglichkeiten markieren bzw. nicht markieren:
    [  ] public static void main(String[]args)
    [  ] Constructors from superclass
    [  ] Inherit abstract methods

• Muster-Code kopieren und anpassen.
  Die Schritte zur Anpassung sind im Dokument mit dem Muster-Code beschrieben.

▲ zum Inhaltsverzeichnis

Task-Frame im CommandCenter aufrufen

• Vorbedingung für das Funktionieren des folgenden Codes ist, dass interner und angezeigter Aufruf-Code in der Datei 'Tasks.xml' erfasst wurden.
  Die Beschreibung dafür finden Sie unter Datei 'Tasks.xml' mit der Liste der wählbaren Geschäftsanwendungen > Muster einer Datei und > Detailbeschreibung eines <Task>.

• In der Methode openBusinessTask(...) in der Klasse ProjektName_CommandCenter_ActionHandler wird dem zugehörigen internen Code das 'Konstruieren' des Task-Frames zugeordnet:
  if (strInternalCode.equals("X")) {
  /* Ein Objekt der enbtsprechenden Klasse 'konstruieren' und
   * die vom Anwender erfaßten Parameter mitgeben. */
    application_task
      frm_application_task =
        new application_task(parmCC);
    frm_application_task.setVisible(true);
  }

▲ zum Inhaltsverzeichnis

Sprachabhängigen Text für die GUI-Elemente erfassen

Wenn Ihr Anwendungsprogramm mehr als ein Testprojekt ist, empfehle ich stark, für das Verwalten der Texte und das Generieren der Datei JavaScout ProjectAssist zu verwenden.
Im Leitfaden – Task-Frame (Teilprogramm für einen Geschäftsfall); Importieren von Textbausteinen, Funktionstasten-Zuordnungen und Fehlermeldungen finden Sie eine Schritt für Schritt Anleitung, welche Daten aus einer Muster-Datei importiert werden können, wie die importierten Daten an Ihr spezielles Anwendungsprogramm angepasst werden und wie Sie die Daten für weitere GUI-Elemente erfassen.

Wenn Sie die Datei händisch verändern wollen finden Sie eine detaillierte Anleitung, mit einem auf die GUI-Elemente der Basisklasse JSBS_TaskFrame abgestimmten Muster-Inhalt für die Datei 'DisplayStrings.xml', unter JavaScout ProjectAssist, Start-Frame Grundlagen (Java_Fatclient_01) – Text für die GUI-Elemente von XML-Datei einlesen > Verzeichnis und Datei mit der XML-Struktur mit den sprachabhängigen Texten erstellen.

Dabei ist der Wert der folgenden XML-Elemente
<CommonElement>
  <ElementName>lbl_ApplicationTitle1</ElementName>
  <ElementText>JavaScout ProjectAssist</ElementText>
  <ToolTipText>Projekt-Unterstützung für das JavaScout Fat-Client-Framework</ToolTipText>
</CommonElement>
und
<Frame>
  <FrameClass>js_projassist.client.JS_ProjAssist_CommandCenter</FrameClass>
  <FrameTitle>CommandCenter – ProjectAssist für das . . . . </FrameTitle>
durch jene Werte zu ersetzen, die für Ihr Anwendungsprogramm zutreffen.

Innerhalb des Verzeichnisses wird die Datei 'DisplayStrings.xml' mit der Struktur für die sprachabhängigen Texte für GUI-Elemente erstellt.
Eine Beschreibung der Wirkungsweise der einzelnen XML-Elemente finden Sie im Dokument Datei 'DisplayStrings.xml' mit sprachabhängigen Texten für die Anzeige auf der GUI.

▲ zum Inhaltsverzeichnis

Zuordnung der Funktionstasten zu Schaltflächen

Wenn Ihr Anwendungsprogramm mehr als ein Testprojekt ist, empfehle ich stark, für das Verwalten der Zuordnungen und das Generieren der Datei JavaScout ProjectAssist zu verwenden.
Im Leitfaden – Task-Frame (Teilprogramm für einen Geschäftsfall); Importieren von Textbausteinen, Funktionstasten-Zuordnungen und Fehlermeldungen finden Sie eine Schritt für Schritt Anleitung, welche Daten aus einer Muster-Datei importiert werden können, wie die importierten Daten an Ihr spezielles Anwendungsprogramm angepasst werden und wie Sie die Daten für weitere GUI-Elemente erfassen.

Wenn Sie die Datei händisch verändern wollen führen Sie bitte folgende Tätigkeiten aus:

• Innerhalb des Verzeichnisses 'TEXT.sprache' wird die Datei 'FunctionKeys.xml' mit der Zuordnung von Funktionstasten zu Schaltflächen erstellt.
  Eine Beschreibung der Wirkungsweise der einzelnen XML-Elemente finden Sie im Dokument Datei 'FunctionKeys.xml' mit Zuordnung von Funktionstasten zu Schaltflächen (Buttons).

• Ein Muster für die Datei finden Sie im Tutorial JavaScout ProjectAssist, Start-Frame Finalisierung (Java_Fatclient_01) – Einbindung von Funktionstasten > Datei mit der XML-Struktur mit der Funktionstasten-Zuordnung erstellen .

▲ zum Inhaltsverzeichnis

Warnungs- und Fehler-Meldungen erfassen

Wenn Ihr Anwendungsprogramm mehr als ein Testprojekt ist, empfehle ich stark, für das Verwalten der Texte und das Generieren der Datei JavaScout ProjectAssist zu verwenden.
Im Leitfaden – Task-Frame (Teilprogramm für einen Geschäftsfall); Importieren von Textbausteinen, Funktionstasten-Zuordnungen und Fehlermeldungen finden Sie eine Schritt für Schritt Anleitung, welche Daten aus einer Muster-Datei importiert werden können, wie die importierten Daten an Ihr spezielles Anwendungsprogramm angepasst werden und wie Sie die Daten für weitere GUI-Elemente erfassen.

Die Datei händisch zu verändern ist zeitaufwändig und birgt das Risiko von Fehlern.
Wenn Sie JavaScout ProjectAssist nicht installieren wollen – z.B. weil Sie erst ein Testprojekt durchführen – können Sie das erstellte Anwendungsprogramm trotzdem ausführen.
Es wird dann ein allgemeiner Fehlertext und die innerhalb des Codes verwendeten Werte für die Herkunft der Meldung angezeigt.

Die Referenzierung der Herkunfts-Codes im Muster-Code zu den (aus der Muster-Datei) importierten Herkunfts-Codes mit Standard-Texten für Warnungen und Fehler ist in der folgenden Tabelle beschrieben.

In der im Leitfaden – Task-Frame (Teilprogramm für einen Geschäftsfall); Importieren von Textbausteinen, Funktionstasten-Zuordnungen und Fehlermeldungen verwendeten Muster-Datei sind Standard-Meldungen für die im Muster-Code für ein Task-Frame verwendeten Herkunfts-Codes enthalten.
Diese müssen individuell referenziert werden.
Abhängig von der Funktionalität Ihres speziellen Task-Frames haben Sie möglicherweise auch eigene Punkte innerhalb des Codes, an denen Sie Warnungs- oder Fehlermeldungen ausgeben wollen. Diese Meldungen müssen über ProjectAssist :: Fehlermeldungen und Warnungen verwalten erfasst werden.

▲ zum Inhaltsverzeichnis

Weitere Schritte und verwandte Dokumentation

▲ zum Inhaltsverzeichnis