Mit HATS können Sie den Zugriff auf Ihre vorhandenen Hostanwendungen durch den Einsatz von Rich-Client-Anwendungen mit grafischer Benutzerschnittstelle (GUI) umsetzen, die in Umgebungen mit Eclipse Rich Client Platform (Eclipse RCP), Lotus Notes oder Lotus Expeditor Client ausgeführt werden.
Eclipse RCP ist eine Untergruppe der Plug-ins, die durch die Eclipse-Plattform - einer bekannten Open-Source-Plattform für Tools - bereitgestellt werden. Dank der Einführung von Eclipse RCP können Sie die von Eclipse gebotene Kernfunktionalität zur Erstellung von nativen Clientanwendungen verwenden, die für den Desktop eines Benutzers bestimmt sind. Weitere Informationen zu Eclipse RCP finden Sie unter der Adresse http://www.eclipse.org/home/categories/rcp.php.
Lotus Notes ist eine leistungsfähige, vielseitige Software, mit deren Hilfe Sie schnell auf alle für Sie wichtigen Informationen zugreifen können. Mit Lotus Notes können Sie E-Mails senden und empfangen, Termine planen, im Web surfen, Beiträge zu Internet-Newsgroups verfassen und über die Homepage stets alle für Sie wichtigen Informationen verfolgen. Weitere Informationen enthält das Information Center von Lotus Notes unter der Adresse http://publib.boulder.ibm.com/infocenter/domhelp/v8r0/index.jsp.
Lotus Expeditor Client bietet eine Rich-Client-Laufzeitumgebung und integrierte Middlewarekomponenten, mit denen viele Unternehmensanwendungen auf serververwaltete Laptop- und Desktopsysteme erweitert werden können. Weitere Informationen zur Entwicklung und Implementierung von Anwendungen für Lotus Expeditor Client enthält das Information Center von Lotus Expeditor unter der Adresse http://publib.boulder.ibm.com/infocenter/ledoc/v6r2/index.jsp.
Sofern nicht anderweitig angegeben, gelten die hier dokumentierten Informationen für die Entwicklung und Implementierung von HATS-Rich-Client-Anwendungen in Umgebungen mit Eclipse RCP Version 3.4, Lotus Notes V8.5.1 und Lotus Expeditor Client Version 6.2. Anweisungen, die für frühere Versionen von Eclipse RCP und Lotus Expeditor Client gelten, finden Sie in den früheren Versionen des jeweiligen Information Center.
Eine Rich-Client-Umgebung bietet Funktionen, die in einer konventionellen Webumgebung nicht verfügbar sind. Hierzu gehören unter anderem die folgenden Leistungsmerkmale:
Zusätzliche Informationen und Hilfetexte für die Entwicklung von Rich-Client-Anwendungen finden Sie im Hilfeverzeichnis von Rational SDP. Wählen Sie dort in der Menüleiste die Optionen für Hilfe > Hilfeverzeichnis aus und geben Sie den Suchausdruck Rich Client ein.
Bei der Erstellung von HATS-Rich-Client-Anwendungen sind die Unterschiede zwischen Umgebungen mit Eclipse RCP, Lotus Notes und Lotus Expeditor Client minimal. Die Abweichungen werden im vorliegenden Kapitel dokumentiert.
Hinsichtlich der Architektur besteht der Hauptunterschied zwischen einer HATS-Rich-Client-Anwendung und einer HATS-Webanwendung darin, an welcher Stelle die Telnet-Socketverbindung initialisiert wird. Bei einer Rich-Client-Anwendung wird die Socketverbindung von der Workstation eines Benutzers initialisiert und - anders als bei einer konventionellen HATS-Webanwendung - nicht von WebSphere Application Server. Da Rich-Client-Anwendungen einen Client auf der Workstation des Benutzers benötigen, sind diese Anwendungen primär für interne Benutzer geeignet, die mit der Verwendung eines konventionellen Fat-Client-Terminalemulators vertraut sind.
Die Schritte für die Erstellung und den Test einer HATS-Rich-Client-Anwendung sind im Wesentlichen mit denen zur Erstellung einer HATS-Webanwendung identisch. Unter Verwendung von HATS Toolkit entwickeln Sie mit den in der HATS-Perspektive bereitgestellten Tools ein HATS-Rich-Client-Projekt, aus dem eine HATS-Rich-Client-Anwendung generiert wird. Zur Unterstützung der verschiedenen Aktivitäten, die während der Entwicklung erforderlich sind, werden dieselben Assistenten, Editoren und Sichten bereitgestellt. Beim Erstellen vom Anwendungen, die für Lotus Notes oder Lotus Expeditor Client bestimmt sind, muss Lotus Expeditor Toolkit installiert werden und kann als Hilfe verwendet werden.
Wie bei HATS für die Webumgebung entwickeln Sie die Darstellung und Funktionsweise der Anwendung. Hierzu gehört auch die Anpassung der Einstellungen für die Standardwiedergabe, die Anzeigennavigation (durch Makros zum Überspringen von Anzeigen) sowie die Schriftarten und Farben für die Wiedergabe von Anzeigen.
Die meisten Features, die in einer HATS-Webanwendung verfügbar sind, stehen auch in einer HATS-Rich-Client-Anwendung zur Verfügung. Hierzu gehören unter anderem die folgenden Features:
Die folgenden Features aus HATS-Webanwendungen sind unter anderem in HATS-Rich-Client-Anwendungen nicht verfügbar:
Ein HATS-Rich-Client-Projekt ist ein Eclipse-Plug-in-Projekt. Als Projekt ist es im Arbeitsbereich vorhanden und wird durch einen Entwickler von HATS-Anwendungen entwickelt. Nach der Entwicklung und dem Test wird das Projekt als HATS-Rich-Client-Anwendung exportiert, also in Form eines Eclipse-Plug-ins, das in einer Eclipse-Umgebung installiert werden kann. Ein Eclipse-Plug-in ist eine Komponente, die im Kontext einer Eclipse-Umgebung einen bestimmten Service zur Verfügung stellt. Bei HATS bietet das Plug-in den Service, der für die Umsetzung einer Hostanwendung erforderlich ist.
Jedes Plug-in für HATS-Rich-Client -Anwendungen ist von mehreren Laufzeit-Plug-ins abhängig. Die Abhängigkeiten sind in der Manifestdatei MANIFEST.MF des Rich-Client-Projekts angegeben. Sie müssen sicherstellen, dass diese erforderlichen Plug-ins in der lokalen Testumgebung sowie in der implementierten Produktionsumgebung vorhanden sind, damit das HATS-Rich-Client -Plug-in ordnungsgemäß ausgeführt wird. Weitere Informationen finden Sie unter Projekt für HATS-RCP-Laufzeiterweiterung, HATS-Rich-Client-Anwendungen testen und HATS-Rich-Client-Anwendungen implementieren.
Bei der Erstellung eines HATS-Rich-Client-Projekts müssen Sie eine Zielplattform auswählen. Diese Auswahl gibt an, wo die Anwendung implementiert werden soll. Die Unterschiede zwischen einem Projekt, das für die Implementierung in Eclipse RCP, Lotus Notes oder Lotus Expeditor Client bestimmt ist, sind nur gering. Die folgenden Kenndaten gelten für alle HATS-Rich-Client-Projekte:
Projekte, die für die Implementierung in Eclipse RCP bestimmt sind, enthalten zusätzlich Folgendes:
Projekte, die für die Implementierung in Lotus Notes und Lotus Expeditor Client bestimmt sind, enthalten zusätzlich Folgendes:
Für Ihren Rational SDP-Arbeitsbereich und die geplante Laufzeitumgebung muss dieselbe Java-Laufzeitumgebung (JRE, Java Runtime Environment) verwendet werden. Wenn Sie beispielsweise ein HATS-Rich-Client-Plug-in für die Ausführung auf einer Eclipse-Umgebung entwickeln, in der eine 1.6 Java-Laufzeitumgebung der Stufe 1.6 ausgeführt wird, müssen Sie die Konformitätsstufe des Compilers in Ihrem Arbeitsbereich auf 1.6 setzen. Hierzu wählen Sie in der Menüleiste von Rational SDP die Optionen Fenster > Benutzervorgaben > Java > Compiler aus und legen für die Konformitätsstufe des Compilers den Wert 1.6 fest.
Falls Ihr Arbeitsbereich andere Java- oder Plug-in-Projekte enthält, die andere Konformitätsstufen erfordern, können Sie die Konformitätsstufe des Compilers für einzelne Java- oder Plug-in-Projekte festlegen. Klicken Sie hierzu mit der rechten Maustaste auf das Projekt und wählen Sie die Option Eigenschaften aus. Wählen Sie in der Anzeige "Eigenschaften" auf der linken Seite den Java-Compiler aus. Wählen Sie anschließend das Feld Projektspezifische Einstellungen aktivieren aus, und legen Sie dann die Konformitätsstufe des Compilers auf den geeigneten Wert fest.
Wenn Sie ein HATS-Rich-Client-Projekt erstellen, wird automatisch ein Plug-in-Projekt für die HATS RCP Runtime Extension (im Folgenden als Plug-in für die Laufzeiterweiterung bezeichnet) erstellt, wenn der Arbeitsbereich noch kein solches Projekt enthält. Das Plug-in für die Laufzeiterweiterung hat den Namen und die Plug-in-ID "com.ibm.hats.rcp.runtime.extension" und die Anfangsversion 1.0.0.
Das Plug-in für die Laufzeiterweiterung ist eine Erweiterung des Plug-ins für die HATS RCP Runtime (com.ibm.hats.rcp.runtime). Das Plug-in für die HATS RCP Runtime enthält die HATS-Laufzeitklassen und muss in der Umgebung vorhanden sein, damit HATS-Rich-Client-Anwendungen einwandfrei funktionieren. Mit dem Plug-in für die Laufzeiterweiterung können Sie Einstellungen hinsichtlich der Laufzeitumgebung konfigurieren.
Dieses Plug-in-Projekt enthält die folgenden konfigurierbaren Artefakte:
Das Projekt hat Ähnlichkeit mit einem HATS-EAR-Projekt in einer Webumgebung. Es gibt jedoch pro Laufzeitumgebung nur ein einziges dieser Plug-ins. Dies bedeutet, dass in der Umgebung des Benutzers nur ein einziges Plug-in für die Laufzeiterweiterung ausgeführt wird. Jede Datei "plugin.xml" eines HATS-Rich-Client-Projekts deklariert eine Abhängigkeit von diesem Plug-in. Das Plug-in für die Laufzeiterweiterung verweist nicht auf einzelne HATS-Anwendungs-Plug-ins.
Da in der Laufzeitumgebung nur eine einzige Kopie des Plug-ins für die Laufzeiterweiterung ausgeführt werden kann, müssen Sie sicherstellen, dass die Umgebung eines Benutzers nur eine einzige Kopie des Plug-ins enthält. Falls in der Umgebung mehrere Plug-ins für die Laufzeiterweiterung vorhanden sind, wird von der Umgebung das Plug-in mit der höchsten Versionsnummer verwendet. Dies stellt sicher, dass immer der neueste Code verwendet wird.
Das Projekt für die Laufzeiterweiterung ist in der Sicht HATS-Projekte nicht sichtbar, jedoch in der Navigatorsicht. Es ist Bestandteil des Featureprojekts, das zum Zeitpunkt des Exports generiert wird. Weitere Informationen können Sie unter HATS-Rich-Client-Anwendungen implementieren nachlesen.
Wie bei einem HATS-Webprojekt wird bei der Erstellung eines neuen HATS-Rich-Client-Projekts eine Reihe von Ordnern erstellt, in denen die HATS-Dateien verwaltet werden. Die folgende Abbildung zeigt ein Beispiel für ein Standardprojekt. Der Ordner der höchsten Ebene trägt den Namen, den Sie bei der Erstellung des Projekts für das Projekt vergeben haben. In diesem Ordner sind andere allgemeine Ordner enthalten. In diesen Ordnern befinden sich die Objekte, die Sie im HATS-Projekt definiert haben. Einige Ordner werden erst dann angezeigt, wenn Sie bestimmte Objekte erstellt haben.

Abhängig davon, wie Sie Ihr Projekt konfigurieren, werden einige oder alle dieser Ordner in der Sicht HATS-Projekte angezeigt. Sie können außerdem angeben, welche Ordner in der Sicht HATS-Projekte angezeigt werden sollen, und auch Dateierweiterungen ausblenden lassen. Weitere Informationen finden Sie unter HATS-Benutzervorgaben verwenden.
In diesen allgemeinen Ordnern können Sie Unterordner erstellen, um Ihr Projekt zu organisieren. Sobald Sie Anzeigenerfassungen für Ihr Projekt erstellen, kann es beispielsweise sinnvoll sein, Unterordner im Ordner Anzeigenerfassungen zu erstellen, um die erfassten Anzeigen zu verwalten und zu gruppieren. Zum Erstellen eines Ordners klicken Sie in der Verzeichnisstruktur mit der rechten Maustaste auf einen allgemeinen Ordner, und klicken Sie dann auf HATS - neu > Ordner. Um eine Datei in einen anderen Ordner zu verschieben, klicken Sie mit der rechten Maustaste auf die Datei, und wählen Sie die Option Verschieben aus. Hierzu können Sie aber auch das Drag-and-drop-Verfahren verwenden.
HATS-Projekte können in einer Teamumgebung gemeinsam genutzt werden. Hierzu wird die Navigatorsicht der HATS-Perspektive verwendet. Klicken Sie mit der rechten Maustaste auf das entsprechende Projekt, und wählen Sie die Optionen Team > Projekt gemeinsam nutzen aus. Wählen Sie in der Liste den Repository-Typ aus, und klicken Sie auf Weiter. Rational SDP unterstützt verschiedene Repositorys. Weitere Informationen finden Sie in der Dokumentation von Rational SDP, wenn Sie dort nach dem Begriff Repository suchen.
Sie können Rich-Client-Ressourcen über das Popup-Menü in der Sicht "HATS-Projekte" kopieren, einfügen, löschen, verschieben und umbenennen. Die folgenden Ressourcen können zwischen HATS-Webprojekten und HATS-Rich-Client-Projekten kopiert werden:
Bei einigen Ressourcen, die aus Projekten anderen Typs kopiert wurden, sind Änderungen erforderlich. Beispielsweise muss ein Makro, das aus einem HATS-Webprojekt in ein HATS-Rich-Client-Projekt kopiert wurde, so aktualisiert werden, dass es auf eine gültige SWT-Java-Makrosteuerroutine verweist (bei HATS-Webprojekten verweisen Makros auf eine JSP-Makrosteuerroutine). Anzeigenanpassungen müssen ebenfalls aktualisiert werden, weil sie Verweise auf JSP-Umsetzungen enthalten, die in der Aktion "apply" (= anwenden) angegeben sind, und weil in der Aktion "forward" (= weiterleiten) URL-Adressen angegeben sind. In der Fehlersicht wird eine Warnung ausgegeben, damit Sie diese Fehler finden und beheben können. Die folgenden Szenarien werden gekennzeichnet:
Für die Migration einer HATS-Webanwendung auf eine HATS-RCP-Anwendung gibt es keine integrierte Funktion. Einige Artefakte wie beispielsweise Anzeigenanpassungen, Makros, Verbindungen, Anzeigenerfassungen, Bilder, Quellendateien für Geschäftslogik und Quellendateien für angepasste Komponenten können - mit minimalen Änderungen - manuell von einem Projekttyp auf einen anderen Typ migriert werden. Andere Artefakte (z. B. Umsetzungen, angepasste Fensterobjekte, Schablonen und angepasste Makrosteuerroutinen) erfordern umfangreichere Änderungen, damit sie in einem anderen Projekttyp verwendet werden können.
Um ein HATS-Rich-Client-Projekt auf ein anderes System zu verschieben, auf dem Rational SDP installiert ist, oder um ein Projekt aus einem anderen Grund zu sichern und wiederherzustellen, können Sie die Export- und Importfunktion von Rational SDP verwenden.
Exportieren Sie ein Projekt und seine abhängigen Projekte mit der Projektaustauschfunktion von Rational SDP als komprimierte Datei. Diese Funktion hat mehrere Vorteile. Sie ermöglicht es, mehrere Projekte und das erforderliche Projekt für die Laufzeiterweiterung (com.ibm.hats.rcp.runtime.extension) auf einmal zu exportieren. Außerdem müssen Sie in der Zielinstanz von HATS Toolkit vor dem Import der Projektaustauschdatei kein Projekt erstellen. So exportieren Sie eines oder mehrere Projekte als Projektaustauschdatei aus HATS Toolkit:
So importieren Sie eine komprimierte Datei für den Projektaustausch in HATS Toolkit:
Zum Testen eines Plug-ins mit einer HATS-Rich-Client-Anwendung in einer lokalen Testumgebung starten Sie das Plug-in und die erforderlichen Laufzeit-Plug-ins in einer Instanz der Zielplattform. Die Zielplattform bezieht sich auf das Eclipse-Produkt (zum Beispiel Eclipse RCP, Lotus Notes oder Lotus Expeditor Client), für das das Plug-in, das Sie gerade entwickeln, kompiliert und getestet wird. Zur Konfiguration der Zielplattform verwenden Sie den Dialog, den Sie über die Optionen Fenster > Benutzervorgaben > Plug-in-Entwicklung > Zielplattform in Rational SDP öffnen.
Zum Konfigurieren einer Lotus Notes-Zielplattform für das Testen müssen sowohl Lotus Expeditor Toolkit Version 6.2.1 ode höher als auch Lotus Notes Version 8.5.1 oder höher installiert sein. Wenn Lotus Expeditor Toolkit und das Feature für die Konfiguration der Lotus Expeditor-Testumgebung installiert sind, wird der unten abgebildetete Konfigurationsdialog beim erstmaligen Öffnen eines Arbeitsbereichs angezeigt. Wenn er angezeigt wird, können Sie die Konfiguration unter Verwendung der Benutzervorgaben für die Konfiguration der Testumgebung vornehmen. Die Zielposition ist in der Standardinstallationsposition von Lotus Notes enthalten. Achten Sie darauf, dass Sie VM-Name und Konformitätsstufe des Compilers wie unten gezeigt festlegen. Wenn Sie die Option Nie anzeigen auswählen, können Sie die Option zurücksetzen, damit dieser Konfigurationsdialog angezeigt wird. Wählen Sie dazu in der Menüleiste von Rational SDP die Optionen Fenster > Benutzervorgabe > Client-Services aus.

Zum Konfigurieren einer Lotus Expeditor-Zielplattform für das Testen müssen sowohl Lotus Expeditor Toolkit als auch Lotus Expeditor Client for Desktop installiert sein. Das Toolkit und der Client müssen dieselbe Version haben. Bei Verwendung von Lotus Expeditor Client for Desktop Version 6.2.0 oder älter muss auch Device Runtime Environment installiert sein.
Für Lotus Expeditor Client müssen die folgenden Features zur Standardinstallation hinzugefügt werden:
Wählen Sie in Lotus Expeditor Client die Optionen Datei > Anwendung > Installieren > Neu zu installierende Features suchen > Ordnerposition hinzufügen aus. Wechseln Sie in den Lotus Expeditor Client-Produktdateien zum Ordner "desktop\updates\platform" und wählen Sie die Option Fertig stellen aus. Erweitern Sie updates/platform und Entwicklung. Markieren Sie den Eintrag für Lotus Expeditor Desktop Development Utilities mit einem Häkchen. Erweitern Sie außerdem Laufzeitkomponenten und markieren Sie den Eintrag für SDO-Komponenten (Service Data Objects) mit einem Häkchen. Klicken Sie auf Weiter und schließen Sie den Assistenten ab.
Installieren Sie "Kern-JVM-Feature - J2SE" für Lotus Expeditor Client Version 6.2.0 und älter, indem Sie in Lotus Expeditor Client die Optionen Datei > Anwendung > Installieren > Neu zu installierende Features suchen > Ordnerposition hinzufügen auswählen. Navigieren Sie zur Position mit der Desktoplaufzeitumgebung, also dem Verzeichnis "update.site.dre.client", und wählen Sie OK aus. Übernehmen Sie den Standardsitenamen und wählen Sie dann OK und Fertig stellen aus. Erweitern Sie die Site und den Eintrag Laufzeitkomponenten. Markieren Sie den Eintrag für Kern-JVM-Feature - J2SE. Klicken Sie auf Weiter und schließen Sie den Assistenten ab.
Wenn Lotus Expeditor Toolkit und das Feature für die Konfiguration der Lotus Expeditor-Testumgebung installiert sind, wird der unten abgebildetete Konfigurationsdialog beim erstmaligen Öffnen eines Arbeitsbereichs angezeigt. Wenn er angezeigt wird, können Sie die Konfiguration unter Verwendung der Benutzervorgaben für die Konfiguration der Testumgebung vornehmen. Die Zielposition ist in der Standardinstallationsposition von Lotus Expeditor Client for Desktop enthalten. Achten Sie darauf, dass Sie VM-Name und Konformitätsstufe des Compilers wie unten gezeigt festlegen. Wenn Sie die Option Nie anzeigen auswählen, können Sie die Option zurücksetzen, damit dieser Konfigurationsdialog angezeigt wird. Wählen Sie dazu in der Menüleiste von Rational SDP die Optionen Fenster > Benutzervorgabe > Client-Services aus.

Sie sollten Ihr Projekt nicht nur in der lokalen Testumgebung testen, sondern auch als Anwendung exportieren und in einer Laufzeitumgebung implementieren, um den Implementierungsprozess zu überprüfen. Weitere Informationen können Sie unter HATS-Rich-Client-Anwendungen implementieren nachlesen.
Damit ein Plug-in mit einer HATS-Rich-Client-Anwendung in der lokalen Testumgebung der Zielplattform ausgeführt werden kann, müssen die erforderlichen Laufzeit-Plug-ins auf der Zielplattform installiert sein. Wenn Sie ein neues Projekt erstellen und dabei die Zielplattform auswählen oder die Zielplattform zu einem späteren Zeitpunkt ändern, stellt das HATS Toolkit fest, ob die erforderlichen Laufzeit-Plug-ins auf der ausgewählten Zielplattform installiert sind und den neuesten Stand aufweisen. Wenn dies nicht der Fall ist, werden Sie vom Toolkit aufgefordert, die neuesten Laufzeit-Plug-ins zu installieren. Diese Aufforderung können Sie in den HATS-Benutzervorgaben aktivieren bzw. inaktivieren. Weitere Informationen finden Sie unter HATS-Benutzervorgaben verwenden. Die folgenden Laufzeit-Plug-ins müssen installiert sein:
Die folgenden Eclipse-Plug-ins werden ebenfalls bei einer Lotus Notes-Zielplattform installiert:
Nachdem Sie die neuesten HATS-Laufzeit-Plug-ins auf der Zielplattform installiert haben, müssen Sie die neuen Plug-ins erneut laden. Hierzu verwenden Sie den Dialog, den Sie über die Optionen Fenster > Benutzervorgaben > Plug-in-Entwicklung > Zielplattform in Rational SDP öffnen. Klicken Sie dort auf die Option Erneut laden.
Neben der Konfiguration der Zielplattform und der Installation der Laufzeit-Plug-ins müssen Sie möglicherweise die Standard-JRE (Java Runtime Environment) für Ihren Arbeitsbereich in Rational SDP festlegen.
Beim Testen auf einer Zielplattform mit Eclipse RCP müssen Sie für die Standard-JRE den Wert jdk festlegen. So gehen Sie hierzu vor:
Stellen Sie sicher, dass die JREs (Java Runtime Environment) übereinstimmen. Beim Testen in einer Eclipse-Umgebung, in der Java 1.6 ausgeführt wird, sollten Sie die JRE des Arbeitsbereichs aktualisieren, damit sie mit der JRE der Laufzeitumgebung übereinstimmt.
Beim Testen auf einer Lotus Notes-Zielplattform haben Sie die Standard-JRE für den Arbeitsbereich möglicherweise bereits im Konfigurationsdialog von Lotus Expeditor Toolkit festgelegt (siehe Abb. 7). Wenn nicht, führen Sie folgende Schritte aus:
Beim Testen auf einer Lotus Expeditor-Zielplattform haben Sie die Standard-JRE für den Arbeitsbereich möglicherweise bereits im Konfigurationsdialog von Lotus Expeditor Toolkit festgelegt (siehe Abb. 8). Wenn nicht, führen Sie folgende Schritte aus:
Zum Starten des Projekts wird eine Startkonfiguration benötigt. HATS erstellt automatisch eine Standardstartkonfiguration, wenn Sie für Ihr Projekt entweder auf Ausführen oder auf Debug klicken (entsprechende Anweisungen enthalten die folgenden Abschnitte). Falls Sie den Dialog "Ausführen" bzw. "Debug" aus einer anderen Sicht (z. B. der Sicht "Paketexplorer") heraus öffnen, wird keine Startkonfiguration erstellt. Die Standardstartkonfiguration basiert auf der Zielplattform des Projekts, die im Assistenten "Neues Projekt" oder im Editor "Projekteinstellungen" festgelegt wird. Falls Sie die Standardstartkonfiguration so ändern, dass sie keine Laufzeitworkbench mehr starten kann, können Sie die Startkonfiguration löschen. HATS erstellt dann eine neue Startkonfiguration, wenn Sie erneut auf Ausführen oder Debug klicken. Um das Projekt zu starten, befolgen Sie die Anweisungen in den folgenden Abschnitten für Ihre Zielplattform.
So starten Sie Ihr Projekt in der lokalen Testumgebung für Eclipse RCP:
Lotus Expeditor Toolkit und Lotus Notes müssen auf derselben Entwicklungsworkstation wie Rational SDP installiert sein, damit ein für Lotus Notes bestimmtes HATS-Plug-in lokal getestet werden kann. Lotus Notes darf bei dem Versuch, das Projekt zu testen, noch nicht aktiv sein, da stets nur eine einzige Instanz von Lotus Notes aktiv sein darf. Siehe Zielplattform konfigurieren.
So starten Sie Ihr Projekt in der lokalen Testumgebung für Lotus Notes:
Lotus Expeditor Toolkit und Lotus Expeditor Client for Desktop müssen auf derselben Entwicklungsworkstation wie Rational SDP installiert sein, damit ein für Lotus Expeditor bestimmtes HATS-Plug-in lokal getestet werden kann. Siehe Zielplattform konfigurieren.
So starten Sie Ihr Projekt in der lokalen Testumgebung für Lotus Expeditor Client:
Unabhängig davon, in welcher Form Sie das HATS-Paket erhalten (HATS-CD, Web oder im Lieferumfang eines anderen Produkts), installieren Sie dieselbe Version von HATS Toolkit. Dabei handelt es sich um eine Version mit Nutzungsbegrenzung, mit der Sie HATS testen können. Zur vollständigen Aktivierung der Laufzeiten für die Produktion entsprechend dem lizenzierten Berechtigungsnachweis müssen Sie die Lizenzeinstellungen mit dem Assistenten "Lizenzeinstellungen" angeben, der im Lieferumfang von HATS Toolkit enthalten ist. Weitere Informationen finden Sie in den Abschnitten Testen von HATS und Aktivieren von HATS-Laufzeiteinstellungen und HATS-Lizenzeinstellungen im Handbuch HATS Erste Schritte.
Dieser Abschnitt beschreibt zwei verschiedene Verfahren für die Implementierung von HATS-Rich-Client-Anwendungen. Mit der ersten Methode kann eine vollständige Eclipse-Clientumgebung als Paket für die Verteilung erstellt werden, das alles enthält, was für die Ausführung der HATS-Rich-Client-Anwendung erforderlich ist. Mit der zweiten Methode kann die HATS-Rich-Client-Anwendung für Clients gepackt werden, für die bereits eine Eclipse-Umgebung installiert ist.
IBM Eclipse SDK, auf dem Rational SDP basiert, bietet die Möglichkeit, einen vollständigen Eclipse-Client zu generieren, der die Plug-ins mit der HATS-Anwendung und alle anderen erforderlichen Plug-ins enthält. Dieser Client kann an einzelne Clientsysteme verteilt und als eigenständige Anwendung ausgeführt werden.
So erstellen Sie das Clientpaket:
Nun wird eine vollständige Eclipse-Clientumgebung erstellt. Zum Testen der Anwendung navigieren Sie im Windows®-Explorer zum Verzeichnis "c:\hostaccess". Doppelklicken Sie im Ordner "eclipse" auf die Datei eclipse.exe. Dieses Verzeichnis kann komprimiert und auf einzelne Clientsysteme heruntergeladen werden. Auf dem Clientsystem ist lediglich eine kompatible JRE (Java Runtime Environment) erforderlich.
Zur Implementierung Ihrer HATS-Rich-Client-Anwendung in einer vorhandenen Eclipse-Clientlaufzeitumgebung müssen Sie Folgendes ausführen:
Die folgenden Abschnitte beschreiben, wie Sie diese Aufgaben ausführen.
Um das Plug-in mit Ihrer HATS-Rich-Client-Anwendung in einer Laufzeitumgebung zu implementieren, müssen Sie es zunächst als Paket mit einem Eclipse-Feature erstellen. Ein Eclipse-Feature ist ein Implementierungsartefakt, mit dem ein Paket aus zusammengehörenden Plug-ins erstellt wird. Führen Sie die folgenden Schritte aus, um Ihr Plug-in in ein Eclipse-Feature zu packen:
Falls Sie die Lizenzeinstellungen nicht angegeben haben, wird die Nachricht ausgegeben, dass diese Anwendung nicht für die Laufzeit aktiviert ist und in einer Produktionsumgebung nicht ausgeführt werden kann. HATS-Rich-Client-Anwendungen können in einer lokalen Testumgebung (Eclipse, Lotus Notes oder Lotus Expeditor Client) getestet werden; sie können in einer Laufzeitumgebung (also einer Umgebung, die keine Entwicklungsumgebung ist) jedoch erst nach der Angabe von Lizenzeinstellungen ausgeführt werden. Dies bedeutet, dass Sie eine Anwendung in der Entwicklungsumgebung von HATS Toolkit erstellen und vollständig testen können. Sie können außerdem die Anwendung exportieren, die dann von einem Benutzer installiert werden kann. Der Benutzer kann jedoch keine Verbindung zur Anwendung herstellen. Die Laufzeit ist in diesem Fall gesperrt und lässt keine Verbindungen zu. Informationen zur Angabe der Lizenzeinstellungen finden Sie unter Aktivierung der HATS-Laufzeit und Lizenzeinstellung im Handbuch HATS Erste Schritte. Falls Sie Lizenzen erworben haben, klicken Sie auf Runtime aktivieren, um Ihre Anwendung für die Laufzeit zu aktivieren. Klicken Sie andernfalls auf Weiter, um den Exportprozess fortzusetzen.
Ihr exportiertes HATS-Rich-Client-Anwendungsfeature enthält automatisch das Plug-in für die Laufzeiterweiterung und schließt automatisch eine Abhängigkeit von den HATS-Laufzeitfeatures ein. Das Feature-Projekt wird in der Sicht "HATS-Projekte" nicht angezeigt, jedoch in der Navigatorsicht.
Wenn Sie eine erweiterte Konfiguration für das HATS-Rich-Client-Anwendungsfeature vornehmen wollen, können Sie anstelle des Assistenten "HATS-Feature-Projekt erstellen" auch den Eclipse-Standardassistenten für neue Features verwenden, der von Eclipse bereitgestellt wird. Wählen Sie zum Starten dieses Assistenten in der Symbolleiste von Rational SDP die Optionen Datei > Neu > Andere > Plug-in-Entwicklung > Featureprojekt aus. Dieser Assistent führt im Wesentlichen dieselben Funktionen wie der Assistent "HATS-Feature-Projekt erstellen" aus, nimmt jedoch weder das Plug-in für die Laufzeiterweiterung noch die erforderlichen Abhängigkeiten von den HATS-Laufzeitfeatures automatisch in das Projekt auf.
In einer Produktionsumgebung ist ein HATS-Rich-Client-Anwendungsfeature davon abhängig, dass die HATS-Laufzeitfeatures auf dem Client installiert sind. Wenn Sie zur Erstellung eines HATS-Rich-Client-Anwendungsfeatures den Assistenten "HATS-Feature-Projekt erstellen" verwenden, wird automatisch eine Abhängigkeit von den HATS-Laufzeitfeatures aufgenommen. Diese Abhängigkeit bewirkt, dass der Installations- und Aktualisierungsprozess des Features automatisch die HATS-Laufzeitfeatures von der Update-Site herunterlädt, wenn ein HATS-Rich-Client-Anwendungsfeature installiert oder aktualisiert wird. Zu den HATS-Laufzeitfeatures gehören die folgenden Features und Plug-ins:
Bei der Angabe einer Lotus Notes-Zielplattform ist auch das folgende Eclipse-Feature eingeschlossen:
So exportieren Sie die HATS-Laufzeitfeatures:
Nach dem Export des HATS-Anwendungsfeatures und der HATS-Laufzeitfeatures müssen Sie eine Update-Site erstellen, die vom Installations- und Aktualisierungsprozess für das Feature verwendet werden kann, um die Anwendung zu implementieren. So erstellen Sie eine Update-Site:
Wenn Lotus Notes als Zielplattform angegeben wird, müssen Sie auch das folgende Feature hinzufügen:
Nun haben Sie eine Update-Site (im Beispiel "c:\myHATS") inklusive der Datei "site.xml" erstellt, die angibt, welche Features und welche Versionen dieser Features auf der Site von einem Client heruntergeladen werden können. Jetzt können Sie dieses Update-Site-Verzeichnis in einen Web-Server versetzen, auf den Clients zugreifen können. Anweisungen zur Definition einer Update-Site auf dem Clientsystem und zur Installation der HATS-Rich-Client-Anwendungen in einer Laufzeitumgebung können Sie unter Anwendung in einer Laufzeitumgebung installieren nachlesen.
HATS-Rich-Client-Anwendungen können in Umgebungen mit Eclipse RCP, Lotus Notes und Lotus Expeditor Client ausgeführt werden. Die folgenden Abschnitte beschreiben, wie Sie die HATS-Rich-Client-Anwendung in diesen Umgebungen installieren.
Um die HATS-Rich-Client-Anwendung herunterzuladen und in einer Eclipse-Rich-Client-Umgebung zu installieren, muss die Clientumgebung das Feature "EMF Service Data Objects (SDO)" von Eclipse enthalten und für den Zugriff auf die Update-Site mit der Anwendung konfiguriert sein. Da die automatische Installation und Aktualisierung inaktiviert ist, muss der Benutzer oder Administrator standardmäßig die neuen Features oder Aktualisierungen mit den Standardfunktionen für Eclipse-Software-Updates manuell installieren. Hierzu führen Sie die folgenden Schritte auf dem Clientsystem aus:
Weitere Informationen zur Eclipse RCP-Umgebung finden Sie unter der Adresse http://www.eclipse.org/home/categories/rcp.php.
In der Lotus Notes-Umgebung wird ein Fensterobjekt zum Installieren von Anwendungen verwendet, die als Features und Plug-ins bereitgestellt werden. Das Fensterobjekt kann später in einem Fensterobjektkatalog veröffentlicht werden, damit es auch andere Benutzer verwenden können. Weitere Informationen zu Fensterobjekten finden Sie im Information Center von Lotus Notes Information Center unter der Adresse http://publib.boulder.ibm.com/infocenter/domhelp/v8r0/index.jsp?topic=/com.ibm.notes85.help.doc/wid_app_overview_c.html im Abschnitt "Widgets und Livetext".
Führen Sie auf dem Clientsystem folgende Schritte aus, um die HATS-Rich-Client-Anwendung herunterzuladen und in einer Lotus Notes-Umgebung zu installieren:


Die Seitenleiste "Eigene Fensterobjekte" sieht in etwa wie folgt aus:

Sie können Ihre Anwendung ausführen, indem Sie Öffnen > Host Access auswählen. Die HATS-Anwendung ist in der Sicht Anwendungen aufgeführt. Um die Anwendung zu starten, müssen Sie entweder auf die Anwendung doppelklicken oder mit der rechten Maustaste auf die Anwendung klicken und dann die Option Öffnen auswählen.
Zum Deinstallieren der HATS-Anwendung müssen Sie mit der rechten Maustaste auf das Fensterobjekt "HATS-Bereitstellung" (bzw. auf den Namen, den Sie dem Fensterobjekt gegeben haben) klicken und Entfernen auswählen. Führen Sie einen Neustart von Lotus Notes aus, wenn Sie dazu aufgefordert werden.
In der Umgebung von Lotus Expeditor Client kann die Verwaltung und Implementierung einer Anwendung auf unterschiedlichen Wegen gesteuert werden:
Für Lotus Expeditor Client müssen die folgenden Features zur Standardinstallation hinzugefügt werden:
Wählen Sie in Lotus Expeditor Client die Optionen Datei > Anwendung > Installieren > Neu zu installierende Features suchen > Ordnerposition hinzufügen aus. Wechseln Sie in den Lotus Expeditor Client-Produktdateien zum Ordner "desktop\updates\platform" und wählen Sie die Option Fertig stellen aus. Erweitern Sie updates/platform und Entwicklung. Markieren Sie den Eintrag für Lotus Expeditor Desktop Development Utilities mit einem Häkchen. Erweitern Sie außerdem Laufzeitkomponenten und markieren Sie den Eintrag für SDO-Komponenten (Service Data Objects) mit einem Häkchen. Klicken Sie auf Weiter und schließen Sie den Assistenten ab.
Installieren Sie "Kern-JVM-Feature - J2SE" für Lotus Expeditor Client Version 6.2.0 und älter, indem Sie in Lotus Expeditor Client die Optionen Datei > Anwendung > Installieren > Neu zu installierende Features suchen > Ordnerposition hinzufügen auswählen. Navigieren Sie zur Position mit der Desktoplaufzeitumgebung, also dem Verzeichnis "update.site.dre.client", und wählen Sie OK aus. Übernehmen Sie den Standardsitenamen und wählen Sie dann OK und Fertig stellen aus. Erweitern Sie die Site und den Eintrag Laufzeitkomponenten. Markieren Sie den Eintrag für Kern-JVM-Feature - J2SE. Klicken Sie auf Weiter und schließen Sie den Assistenten ab.
Weitere Informationen finden Sie im Information Center von Lotus Expeditor unter http://publib.boulder.ibm.com/infocenter/ledoc/v6r2/index.jsp im Abschnitt "Assemblierung und Implementierung von Lotus Expeditor-Anwendungen".
Um die HATS-Rich-Client-Anwendung herunterzuladen und in einer Lotus Expeditor Client-Umgebung zu installieren, muss der Client für den Zugriff auf die Update-Site mit der Anwendung konfiguriert sein. Hierzu führen Sie die folgenden Schritte auf dem Clientsystem aus:
Die Rich-Client-Umgebung ermöglicht die automatische Aktualisierung von installierten Anwendungen. Mit Benutzervorgaben können Sie steuern, wie häufig der Server auf Aktualisierungen überprüft wird. Sobald Sie eine Aktualisierung für eine Anwendung hochgeladen haben, lädt der Rich Client die Aktualisierung herunter und installiert sie. Durch eine Versionsprüfung wird sichergestellt, dass nur neue Aktualisierungen heruntergeladen und installiert werden. In den meisten Fällen muss der Benutzer die Umgebung erneut starten, um die aktualisierte Anwendung zu aktivieren. Weitere Informationen finden Sie in der entsprechenden Dokumentation für Eclipse RCP, Lotus Notes oder Lotus Expeditor.
Bevor Sie ein bereits installiertes Plug-in aktualisieren können, müssen Sie die Version des Plug-ins aktualisieren, weil Eclipse anhand der Version ermittelt, ob ein Plug-in geändert wurde. Wenn Sie beispielsweise in Ihrem Projekt eine Anzeigenanpassung hinzufügen oder ein Makro ändern, müssen Sie die Version des Plug-ins aktualisieren, bevor Sie es erneut exportieren.
Um die Version des Plug-ins zu aktualisieren, klicken Sie im Editor "Projekteinstellungen" auf der Registerkarte Übersicht auf den Link Öffnen Sie das Plug-in-Manifest. Aktualisieren Sie die Version auf der Registerkarte Übersicht im Abschnitt "Allgemeine Informationen". Eine Eclipse-Version hat das Format übergeordnete_version.untergeordnete_version.wartung. Bei einer geringen Änderung am Projekt aktualisieren Sie das Segment wartung der Version. Bevor Sie ein Plug-in zum zweiten Mal exportieren, legen Sie beispielsweise die Plug-in-Version mit 1.0.1 fest.
Da der Assistent "Lizenzeinstellungen" das Projekt für die Laufzeiterweiterung (com.ibm.hats.rcp.runtime.extension) aktualisiert, müssen Sie nach der Ausführung des Assistenten die Version dieses Plug-ins aktualisieren. Hierzu öffnen Sie die Datei "plugin.xml" in der Navigatorsicht. Sie befindet sich im Stammverzeichnis des Projekts. Aktualisieren Sie die Version auf der Registerkarte Übersicht im Abschnitt "Allgemeine Informationen".
Da Features aus Plug-ins bestehen (und auch Features mit Versionen versehen sind), müssen Sie auch die Version eines Features aktualisieren, wenn Sie die Version eines der enthaltenen Plug-ins aktualisiert haben. Hierzu wechseln Sie in die Navigatorsicht, und öffnen Sie die Datei "feature.xml", die sich in Ihrem Featureprojekt befindet. Der Name des Featureprojekts lautet standardmäßig hostaccess. Aktualisieren Sie die Version auf der Registerkarte Übersicht im Abschnitt "Allgemeine Informationen". Außerdem müssen Sie sicherstellen, dass die neuen Versionen der Plug-ins im Feature korrekt aufgeführt sind. Hierzu klicken Sie auf den Knopf Versionen der Registerkarte Plug-ins, und wählen Sie die Option Versionen aus Plug-in- und Fragmentmanifesten kopieren aus.
Nachdem die Version des Features aktualisiert wurde, müssen Sie ggfs. die Datei "site.xml" aktualisieren, damit diese die neue Version des Features enthält.
Laufzeiteinstellungen für HATS-Rich-Client-Anwendungen (z. B. Protokoll- und Traceeinstellungen) werden in zwei Dateien des Plug-ins für die Laufzeiterweiterung (com.ibm.hats.rcp.runtime.extension) angegeben:
Weitere Informationen zur Ausführung in den unterschiedlichen Testmodi enthält der Abschnitt "Testmodi für Rich-Client-Projekte" im Handbuch HATS Erste Schritte.
In HATS Toolkit können Sie diese Dateien bearbeiten, um Einstellungen (z. B. für Traces und Tracestufen) zu ändern. Die Dateien befinden sich im Stammverzeichnis des Plug-in-Projekts für die Laufzeiterweiterung. Bitte beachten Sie, dass alle Änderungen, die Sie in HATS Toolkit an der Datei "runtime.properties" vornehmen, erhalten bleiben und bei der Implementierung der HATS-Anwendung in einer Laufzeitumgebung wirksam werden. In der Laufzeitumgebung befindet sich die Datei "runtime.properties" im Verzeichnis des Plug-ins für die Laufzeiterweiterung (z. B. "<eclipse-installationsverzeichnis>/eclipse/plugins/com.ibm.hats.rcp.runtime.extension_1.0.0"). Die Datei "runtime-debug.properties" wird in der Laufzeitumgebung ignoriert. Weitere Informationen zu Protokoll- und Traceeinstellungen in diesen Dateien finden Sie in Anhang A. Eigenschaftendateien für die Laufzeit.
Angaben dazu, wie der Benutzer in der Laufzeitumgebung die Protokoll- und Traceeinstellungen konfigurieren sowie Daten zur Fehlerermittlung erfassen kann, können Sie unter Benutzervorgaben nachlesen.
Der Arbeitsbereich enthält nur ein einziges Plug-in-Projekt für die Laufzeiterweiterung und in Laufzeitumgebung gibt es nur eine einzige Version des Plug-ins. Daher sind die Protokoll- und Traceeinstellungen in einer bestimmten HATS-Rich-Client-Laufzeitumgebung für alle HATS-Rich-Client-Anwendungen identisch.
Lizenzeinstellungen werden ebenfalls in der Datei "runtime.properties" des Plug-ins für die Laufzeiterweiterung (com.ibm.hats.rcp.runtime.extension) gespeichert. Die Lizenzüberwachung wird daher auf der Ebene der Rich-Client-Umgebung und nicht auf der Ebene einer einzelnen HATS-Rich-Client-Anwendung vorgenommen. Falls der Benutzer die Anzahl der erworbenen Lizenzen überschreitet, wird im Protokoll eine Warnung ausgegeben. Informationen zur Angabe der Lizenzeinstellungen finden Sie unter Aktivieren von HATS-Laufzeiteinstellungen und HATS-Lizenzeinstellungen im Handbuch HATS Erste Schritte.
Die Sicht "Anwendungen" zeigt dem Benutzer alle aktiven HATS-Rich-Client-Anwendungen an, die in der Laufzeitumgebung installiert sind. Die Sicht ist nach den Anzeigenamen der Anwendungen sortiert. Sie wird standardmäßig angezeigt, wenn der Benutzer die Perspektive "Host Access" zum ersten Mal öffnet. Zum Starten einer neuen Instanz einer HATS-Anwendung muss der Benutzer in der Sicht "Anwendungen" auf die Anwendung doppelklicken oder mit der rechten Maustaste auf den Anwendungsnamen klicken und die Option Öffnen auswählen.
Nachdem eine neue Instanz einer HATS-Anwendung gestartet wurde, wird ihre Umsetzungssicht angezeigt. Weitere Informationen finden Sie unter Umsetzungssicht. Der Name der neu geöffneten Umsetzungssicht ist standardmäßig der Name der Anwendung. Falls mehrere Instanzen der Anwendung gestartet wurde, besteht der Name der Umsetzungssicht aus einer Kombination des Anwendungsnamens mit einer Zahl, die die Instanz der Sitzung angibt. Der Titel der zweiten Instanz der Anwendung namens XYZ lautet beispielsweise XYZ : 2.
Der Benutzer kann standardmäßig mehrere Instanzen derselben Anwendung starten. Sie können die Datei "plugin.xml" jedoch so ändern, dass das Starten mehrerer Instanzen nicht zulässig ist. Außerdem können Sie festlegen, dass die Sicht "Anwendungen" nicht ausgegeben werden soll, sondern die Sichten steuern, die dem Benutzer zur Verfügung stehen. Dies kann auch die Anzahl der Instanzen einer Anwendung beschränken. Weitere Informationen enthält das Handbuch HATS Rich Client Platform Programmer's Guide.
Falls die Anwendung in der lokalen Testumgebung ausgeführt wird und Sie ausgewählt haben, dass das Anzeigeterminal angezeigt werden soll, wird ein Fenster mit dem Anzeigeterminal aufgerufen, wenn die Verbindung zum System hergestellt wird. Das Fenster wird geschlossen, sobald die Sitzung beendet oder der Client heruntergefahren wird.
Über ein Popup-Menü kann der Benutzer Aktionen für eine oder mehrere Anwendungen in der Sicht ausführen. Wählen Sie einen oder mehrere Anwendungsnamen aus und klicken Sie auf die rechte Maustaste, damit das Menü angezeigt wird. Das Menü enthält die folgenden Optionen:
Wenn Sie Überschreibungen zulassen, kann der Benutzer auf dieser Seite die Verbindungsparameter überschreiben. Diese Funktion ist äquivalent zur HATS-Funktion bei Webanwendungen, mit der ein Benutzer die Verbindungsparameter unter Verwendung der URL-Adresse überschreiben kann, wenn zum ersten Mal auf die Anwendung zugegriffen wird. Das Überschreiben der Verbindungsparameter kann beispielsweise erforderlich sein, wenn der Benutzer eine Workstation-ID oder einen LU-Namen überschreiben muss.
Der Benutzer legt eine Überschreibung fest, indem er auf den Knopf Hinzufügen klickt, einen Parameter in der Dropdown-Liste für das Feld Name auswählt und einen Wert im Feld Wert festlegt. Im Dialog wird keine Prüfung vorgenommen, die den Benutzer darüber informiert, ob der Name des bereitgestellten Verbindungsparameters überschrieben werden kann. Die Einstellung für Überschreibungen ist beim erstmaligen Hinzufügen standardmäßig aktiviert. Sie kann inaktiviert werden, indem das Markierungsfeld neben dem Parameternamen abgewählt wird.
Wenn der Benutzer einen Verbindungsparameter überschreibt, werden die Einstellungen im lokalen Arbeitsbereich gespeichert. Überschriebene Parameterwerte werden beim Starten einer Instanz für die Sitzung verwendet.
Informationen zum programmgesteuerten Start einer Rich-Client-Anwendungsinstanz mit Überschreibungen von Verbindungsparametern enthält das Handbuch HATS Rich Client Platform Programmer's Guide.
Wenn Sie Überschreibungen zulassen, kann der Benutzer auf dieser Seite globale Variablen überschreiben. Diese Funktion ist äquivalent zur HATS-Funktion bei Webanwendungen, mit der ein Benutzer globale und gemeinsame globale Variablen unter Verwendung der URL-Adresse überschreiben kann, wenn zum ersten Mal auf die Anwendung zugegriffen wird.
Diese Funktion ermöglicht die Verwendung von benutzerspezifischen Variablendaten in der Anwendung. Beispielsweise können Sie ein Makro aufzeichnen, das einen Benutzernamen und ein Kennwort anfordert, die über die Werte von globalen Variablen bereitgestellt werden. Der Benutzer kann diese Werte auf der Seite für die Überschreibung von Variablen angeben. Die Werte werden dann verwendet, wenn das Makro bei Erkennung der Anmeldeanzeige ausgeführt wird.
Zum Festlegen einer Überschreibung muss der Benutzer auf den Knopf Hinzufügen klicken, einen Variablennamen in der Dropdown-Liste für das Feld Name auswählen, einen Wert im Feld Wert festlegen und angeben, ob die globale Variable gemeinsam genutzt werden soll. Im Dialog wird keine Prüfung vorgenommen, die den Benutzer darüber informiert, ob der Name der bereitgestellten globalen Variablen überschrieben werden kann. Die Einstellung für Überschreibungen ist beim erstmaligen Hinzufügen standardmäßig aktiviert. Sie kann inaktiviert werden, indem das Markierungsfeld neben dem Variablennamen abgewählt wird.
Sobald der Benutzer eine globale Variable überschreibt, werden die Einstellungen im Datenverzeichnis der Umgebung gespeichert. Überschriebene Werte von globalen Variablen werden beim Starten einer Instanz für die Sitzung verwendet.
Informationen zum programmgesteuerten Start einer Rich-Client-Anwendungsinstanz mit Überschreibungen für globale Variablen enthält das Handbuch HATS Rich Client Platform Programmer's Guide.
In der Rich-Client-Umgebung hat der Benutzer die Möglichkeit, die aktuelle Anzeigenumsetzung durch Auswahl der Option Drucken im Menü Datei zu drucken. Eclipse ruft standardmäßig den Dialog "Drucken" auf, in dem der Benutzer den Drucker auswählen und auch andere Optionen konfigurieren kann. Nachdem der Benutzer auf OK geklickt hat, wird der Umsetzungsbereich der Umsetzungssicht an den ausgewählten Drucker gesendet.
Die Umsetzungssicht ist der Hauptbereich für die Umsetzung in der Rich-Client-Umgebung. Jedem HATS-Rich-Client-Projekt ist eine bestimmte Umsetzungssicht zugeordnet. Die Sicht wird bei der Erstellung des Projekts in der Datei "plugin.xml" des Projekts gespeichert. Sie besteht aus vier Bereichen:
Die Symbolleiste der Umsetzungssicht enthält Knöpfe für Aktionen auf Anwendungsebene sowie Knöpfe für Aktionen, die während der Anzeigenwiedergabe durch das Fensterobjekt "Symbolleiste" beigesteuert werden. Die Symbolleiste wird standardmäßig angezeigt. Die Beschriftungen auf den Knöpfen bestehen nur aus Text. Diese Einstellungen können Sie in den Projekteinstellungen ändern. Weitere Informationen finden Sie unter Symbolleiste Nur RCP .
Die Symbolleiste ist in zwei Teile gegliedert. Die rechte Seite der Symbolleiste entspricht dem Anwendungstastenblock in einer HATS-Webanwendung und enthält die Knöpfe des Anwendungstastenblocks. Anhand der Beschreibung im Abschnitt Anwendungstastenblock können Sie konfigurieren, welche Knöpfe angezeigt werden. Auf der linken Seite werden Knöpfe angezeigt, die durch das Fensterobjekt "Symbolleiste" beigesteuert werden. Weitere Informationen finden Sie unter Symbolleiste Nur RCP .
Für alle Knöpfe des Anwendungstastenblocks ist ein QuickInfo-Text verfügbar, in dem die Funktion des Knopfes beschrieben wird. Sie können QuickInfo-Text für Knöpfe festlegen, die Sie mit dem Fensterobjekt "Symbolleiste" hinzufügen.
Über den Knöpfen des Anwendungstastenblocks befindet sich in der Symbolleiste neben den Symbolen für maximale Größe und Symbolgröße ein Menüsymbol. Wenn Sie auf dieses Symbol klicken, wird ein Menü aufgerufen, das die folgenden Optionen enthält:
Der Schablonen- und Umsetzungsbereich ist der Hauptteil der Umsetzungssicht. Hier werden alle Anzeigenumsetzungen angezeigt. Außerdem werden in diesem Bereich Fehlernachrichten, Nachrichten zum Trennen der Verbindung sowie Anzeigen der Makrosteuerroutine ausgegeben.
Auf dem Hosttastenblock werden die Hosttasten angezeigt, die Sie zum Anzeigen in den Projekteinstellungen ausgewählt haben. Angaben zur Konfiguration des Hosttastenblocks finden Sie unter Hosttastenblock. Standardmäßig wird kein Hosttastenblock angezeigt.
Der OIA-Statusbereich zeigt die Informationen zum Status der Sitzung an, die Sie in den Projekteinstellungen konfiguriert haben. Angaben zur Konfiguration des OIA-Statusbereichs finden Sie unter Operatorinformationsbereich (OIA).
Die Verbindung zum Hostsystem wird beim Schließen der Sicht beendet. Hierzu kann der Benutzer entweder die Sicht explizit schließen oder aber die Rich-Client-Umgebung schließen. Beim Schließen wird die Gruppe der Aktionen verarbeitet, die im Ereignis "Trennen" und im Ereignis "Stoppen" definiert sind.
Wenn Sie eine Hostverbindung erstellen oder bearbeiten, können Sie angeben, dass vom Benutzer die Eingabe einer Workstation-ID für die Verbindung zu einem 5250-Host angefordert werden soll. Weitere Informationen finden Sie unter Verbindung erstellen. Falls Sie die Anforderung der Workstation-ID festlegen, wird für den Benutzer ein Dialog mit einer Bedienerführung angezeigt, wenn er zum ersten Mal eine Verbindung zum Host herstellen will. Der Benutzer kann dann eine Workstation-ID im Feld Workstation-ID eingeben.
Durch die Auswahl eines bereitgestellten Markierungsfelds kann die Workstation-ID gespeichert werden, was nachfolgende Anforderungen verhindert. Bei Auswahl des Markierungsfelds kann die Anforderung später wiederhergestellt werden, indem die Überschreibung des Verbindungsparameters "workstationID" in den Eigenschaften der Anwendung inaktiviert wird. Weitere Informationen finden Sie unter Verbindungsparameter.
Wenn Sie eine Hostverbindung erstellen oder bearbeiten, können Sie angeben, dass vom Benutzer die Eingabe eines LU-Namens für die Verbindung zu einem 3270E-Host angefordert werden soll. Weitere Informationen finden Sie unter Verbindung erstellen. Falls Sie die Anforderung des LU-Namens festlegen, wird für den Benutzer ein Dialog mit einer Bedienerführung angezeigt, wenn er zum ersten Mal eine Verbindung zum Host herstellen will. Der Benutzer muss einen LU-Namen im Feld LU-Name eingeben.
Durch die Auswahl eines bereitgestellten Markierungsfelds kann der LU-Name gespeichert werden, was nachfolgende Anforderungen verhindert. Bei Auswahl des Markierungsfelds kann die Anforderung später wiederhergestellt werden, indem die Überschreibung des Verbindungsparameters "LUName" in den Eigenschaften der Anwendung inaktiviert wird. Weitere Informationen finden Sie unter Verbindungsparameter.
Benutzer können standardmäßig auf die Benutzervorgaben zugreifen, indem sie in der Menüleiste der Laufzeitplattform die Optionen Datei > Benutzervorgaben > Host Access auswählen. Die angezeigten Seiten sind im Plug-in für die Laufzeiterweiterung registriert. Wenn dem Benutzer diese Funktionen nicht zur Verfügung stehen sollen, können Sie die anwendbaren Deklarationen aus der Datei "plugin.xml" des Plug-ins für die Laufzeiterweiterung entfernen. Weitere Informationen zu diesem Aspekt enthält die Beschreibung der Erweiterungspunkt-ID "org.eclipse.ui.preferencePages" im Abschnitt "HATS runtime extension plug-in" des Handbuchs HATS Rich Client Platform Programmer's Guide. Die folgenden Einstellungen können für die Benutzervorgaben ausgewählt werden:
Durch den Benutzer können die folgenden Benutzervorgaben für die Druckausgabe bei Anwendungen festgelegt werden, die die 3270-Druckausgabe unterstützen:
Es wird für den Benutzer die Nachricht ausgegeben, dass ein Druckjob gestartet wurde.
Die Nachricht Der Druckjob {0} wurde beendet wird ausgegeben. Hierbei steht {0} für den Namen des Druckjobs.
Die Nachricht Bei Druckjob {0} wurde ein Fehler festgestellt wird ausgegeben. Hierbei steht {0} für den Namen des Druckjobs.
Durch den Benutzer können die folgenden Benutzervorgaben für die Fehlerbehebung festgelegt werden. Weitere Informationen zu Protokoll- und Traceeinstellungen finden Sie unter HATS-Rich-Client-Anwendungen verwalten.
Die Tracedatei wird in der Rich-Client-Umgebung im Ordner für Hostsimulationen gespeichert. Beispiel: In der Eclipse RCP-Umgebung unter Windows wird die Datei unter "<eclipse-installationsverzeichnis>\plugins\<anwendungsname_version>\profiles\hostsimulations\" gespeichert. In der Lotus Notes-Umgebung unter Windows wird sie unter "<Lotus Notes-installationsverzeichnis>\Data\workspace\applications\eclipse\plugins\<anwendungsname_version>\profiles\hostsimulations\" gespeichert. In der Lotus Expeditor Client-Umgebung unter Windows wird sie unter "<Lotus Expeditor Client-installationsverzeichnis>\shared\eclipse\plugins\<anwendungsname_version>\profiles\hostsimulations\" gespeichert. In der Lotus Expeditor Client-Umgebung unter Linux wird sie unter "/opt/IBM/Lotus/Expeditor/shared/eclipse/plugins/<anwendungsname_version>/profiles/hostsimulations/" gespeichert.
Tracedateien werden unter Verwendung der folgenden Schablone benannt: anwendungsname_verbindungsname_datum(jjjjmmtt)_zeit(hhmmss)_nummer. Beispiel: "meineanwendung_hauptverbindung_20060101_134543_1".
Die folgende Liste gibt Aufschluss über Einschränkungen und spezielle Hinweise für die Verwendung von HATS-Rich-Client-Anwendungen:
Dies ist ein bekanntes Problem, das in Bug 100144: Need a pattern for cleaning up font/image/color resources unter der Adresse https://bugs.eclipse.org/bugs/show_bug.cgi?id=100144 dokumentiert ist. Aufgrund dieses Problems müssen Sie Bereinigungslogik manuell hinzufügen, wenn Sie Schriftart-, Bild- oder Farbressourcen zu Schablonen oder Umsetzungen für HATS-Rich-Client-Anwendungen hinzufügen. Das Hinzufügen von Bereinigungslogik ist nicht erforderlich, wenn Sie eine Systemfarbe hinzufügen, da diese vom System zugeordnet wird.
Beispiel: Sie fügen unter Verwendung des visuellen Editors eine neue Farbressource hinzu, und der folgende Code wird generiert:
sideBarArea.setBackground(new Color(Display.getCurrent(), 221, 228, 255));
In diesem Fall müssen Sie die folgenden Codezeilen manuell hinzufügen, damit die Farbe beim Verwerfen des Fensterobjekts bereinigt wird:
sideBarArea.addDisposeListener(new DisposeListener(){
public void widgetDisposed(DisposeEvent e){
Color background = sideBarArea.getBackground();
if (background != null && !background.isDisposed()) {
background.dispose();
}
}
});
Wenn Sie die von HATS bereitgestellte Klasse "ColorManager" verwenden, müssen Sie die Farbressourcen nicht bereinigen. Sie müssen jedoch den Code unter Verwendung des Java-Editors anstelle des Eigenschafteneditors schreiben, der vom visuellen Editor bereitgestellt wird. Der folgende Code ist ein Beispiel für die Verwendung der Klasse "ColorManager":
sideBarArea.setBackground(com.ibm.hats.rcp.ui.misc.ColorManager.
getInstance(Display.getCurrent()).getColor(221, 228, 255));
Falls Sie beispielsweise ein Bild mit dem visuellen Editor manuell zu einer Schablone hinzufügen, könnte der Code zum Hinzufügen des Bildes und zum Bereinigen der Bildressource folgendermaßen aussehen:
label = new Label(bannerArea, SWT.RIGHT);
gridData = new GridData(SWT.END, SWT.CENTER, true, true);
label.setImage(new Image(Display.getCurrent(),
getClass().getResourceAsStream("/images/myimage.gif")));
label.setLayoutData(gridData);
label.addDisposeListener(new DisposeListener() {
public void widgetDisposed(DisposeEvent e){
Image image = label.getImage();
if (image != null && !image.isDisposed()) {
image.dispose();
}
}
});