Antwortdokumente im Workplace Designer

Komponenten im- und exportieren

Bevor wir unser Beispiel mit Antwortdokumenten erweitern, betrachten wir die Möglichkeit zum Import und Export von Komponenten. Wollen Sie eine Komponente des Workplace Designer an einen anderen Entwickler weitergeben, so nutzen Sie die Funktion File/Export/Component. Im Fenster Export <Komponentenname> to File System bestimmen Sie den Dateinamen und die zu exportierenden Gestaltungselemente. Des Weiteren können Sie die Komprimierung und das automatische Überschreiben vorhandener Dateien aktivieren (Abbildung 1). Der Import der.jar-Datei erfolgt über den Menüpunkt File/Import/ Component. Ist bereits eine Komponente mit dem gleichen Namen in Navigator des Workplace Designer vorhanden, benennen Sie die neu einzufügende Komponente beim Importvorgang um. In unserem Beispiel bietet es sich an, die vorhandene Komponente Bibliothek zu ex- und hinterher wieder zu importieren. Dadurch steht Ihnen die erste Version immer zur Verfügung. Mit der erstellten Kopie arbeiten Sie weiter.

Bild 1: Die Einstellungen für den Export von Bibliotheken.
Bild 1: Die Einstellungen für den Export von Bibliotheken.

Neben dem Export in eine .jar-Datei stehen Ihnen zwei weitere Möglichkeiten offen. Wollen Sie den Deploymentprozess nicht mit dem Workplace Designer, sondern mit Standardmethoden wie zum Beispiel den Administratorfunktionen des Portalservers ausführen, nutzen Sie File/Export/. war file. Über File/Export/.ddl file erzeugen Sie .dll-Dateien, die Skripts zur Datenerstellung der Komponentendaten in einer Datenbank enthalten.

Antwortdokumente einrichten

Als ersten Schritt können Sie aus der Maske Buch das Label lblAnmerkung und die Editbox Anmerkung entfernen. Löschen Sie im Schema Schema_Buch das Element Anmerkung.

Als Nächstes erstellen Sie ein Schema Anmerkungen in der Komponente. Dieses Schema soll die vier Elemente ErstelltVon, ErstelltAm, Kurzeinschaetzung und Kommentar enthalten. Alle vier Elemente sind vom Typ String.

Über den Menüpunkt File/New/Form erzeugen Sie eine neue Maske für die Anmerkungsdokumente. Vergeben Sie einen Namen (Anmerkung). Ordnen Sie der Maske das neue Schema Anmerkungen zu. Wählen Sie dazu im Fenster New Form unter Data die Option Use an existing
schema.

Erstellen Sie in der Maske entsprechend den im Schema Anmerkungen definierten Elementen mit dem UI-Control-Typ Edit Box vier Felder und die zugehörigen Bezeichner vom Typ Label. Ordnen Sie den Feldern die jeweiligen Schemaelemente zu. Für die Felder ErstelltAmund Erstellt- Von können Sie die aus Notes bekannten und auch im Workplace Designer verfügbaren @Funktionen @Usernames() und @Created() nutzen. Einen möglichen Aufbau der Maske sehen Sie in Bild 2.

Bild 2: Die Maske für die Eingabe von Anmerkungen.
Bild 2: Die Maske für die Eingabe von Anmerkungen.

Um eine erstellte Anmerkung – das Antwortdokument – zu speichern oder den Vorgang abzubrechen, benötigen wir zwei Schaltflächen. In beiden Fällen soll nach der Aktion das zugehörige Buchdokument – das Hauptdokument – wieder angezeigt werden. Für die Umsetzung dieser Anforderung nutzen wir die JavaScript-Klasse XSPUrl. Ein Objekt dieser Klasse ermöglicht in Verbindung mit den notwendigen Parametern die Anzeige der gewünschten Seite. Wir benötigen drei Parameter der Klasse:

  • Action: Der Parameter bestimmt, ob ein vorhandenes Dokument geöffnet (opendocument) oder ein neues erstellt wird (newdocument).

  • Id: Soll ein vorhandenes Dokument geöffnet werden, ist die Angabe von dessen Dokument- ID notwendig. In unserem Fall ist dies die ID des Hauptdokuments.

  • Autoedit: Der Parameter bestimmt den Bearbeitungsmodus beim Öffnen. Er kann die Werte true oder false annehmen.