VERBUNDANWENDUNGEN - GESTALTUNG UND VERWALTUNG

Funktionen zur Konfiguration von Komponenten im Composite Application Editor verwenden
Sie können Entwicklern von Verbundanwendungen das Anzeigen und Einstellen von Vorgaben für Komponenten im Composite Application Editor ermöglichen. Definieren Sie dazu bearbeitbare Eigenschaften mit Erweiterungspunkten, fügen Sie Register zum Dialogfeld "Komponenteneigenschaften bearbeiten" sowie Steuerelemente für Eigenschaften hinzu, die beim Bearbeiten direkt in Ihrer Komponenten-Benutzeroberfläche angezeigt werden.

Hinweis Die nachfolgend beschriebenen Prozeduren und Beispiele treten im Lotus Expeditor und im Composite Application Editor auf. Beide Anwendungen sind wertvolle zusätzliche Werkzeuge für Entwickler von Verbundanwendungen und Komponenten in Domino Designer.

Definieren von Eigenschaften durch einen Erweiterungspunkt

Sie können Komponenteneigenschaften durch einen Erweiterungspunkt definieren. Die Eigenschaften und Ihre Vorgabewerte werden zur Komponente hinzugefügt, wenn die Komponente zu einer Anwendung hinzugefügt wird. Das Dialogfeld "Komponenteneigenschaften bearbeiten" im Composite Application Editor zeigt auf dem Register "Komponenteneinstellungen" die Eigenschaften an und ermöglicht Benutzern, sie zu bearbeiten.

Führen Sie zur Verwendung eines Erweiterungspunkts zum Definieren einer Komponenteneigenschaft Folgendes aus:

1. Erstellen Sie eine neue Erweiterung "com.ibm.rcp.ca.utils.properties".

2. Klicken Sie mit der rechten Maustaste auf die Erweiterung und klicken Sie auf "Neu > Eigenschaften".

3. Geben Sie im ID-Feld für das neue Element "Eigenschaften" eine ID an.

4. Geben Sie im Feld "referenceID" eine Ansichts- oder Komponenten-ID an (wie in der Erweiterung "com.ibm.rcp.aaf.paletteEntries" definiert). Nachfolgend bezieht sich der Wert "referenceID" auf die ID der Test View-Ansicht "com.ibm.rcp.test.view".

Hinweis Wenn es zwei Eigenschaften mit demselben Namen gibt und eine einer Ansichts-ID und die andere der Komponenten-ID zugeordnet ist, wird die Eigenschaft im Register "Komponenteneinstellungen" angezeigt, die der Komponenten-ID zugeordnet ist. Dadurch können Sie die Eigenschaften und Werte für jede Komponente präziser einstellen. Eine einer Ansichts-ID zugeordnete Eigenschaft wird auf alle Komponenten angewendet, die diese Ansichts-ID verwenden (beispielsweise mehrere Managed Browser-Komponenten, die alle eine URL-Eigenschaft benötigen). Eine einer Komponenten-ID zugeordnete Eigenschaft wird nur auf die Komponente mit dieser ID angewendet. Das Zuordnen einer Eigenschaft mit einer Komponenten-ID ermöglicht Ihnen das Definieren der Eigenschaft für eine bestimmte Komponente, ohne dass sie auf andere Komponenten mit derselben Ansichts-ID angewendet wird.

5. Geben Sie im Feld "typeID" einen der vordefinierten Eigenschaftstypen an: "String", "Boolean", "Zahl", "Auswahl", "Datei", "Farbe", "nsfPicker" (für Notes-Datenbanken), "Verzeichnis" oder "Liste" (für Eigenschaften mit mehreren Werten). Sie können auch einen benutzerdefinierten Typ angeben. Weitere Informationen finden Sie nachfolgend unter "Definieren benutzerdefinierter Eigenschaftstypen".

6. Geben Sie den lokalisierbaren Eigenschaftsnamen im Namensfeld an.

7. Geben Sie im Feld "Wert" den Vorgabewert der Eigenschaft an, z. B. einen Dateinamen oder eine Farbe.

8. Geben Sie in das Feld "Einschränkungen" eine durch Semikola getrennte Liste von Wertlimits oder Optionen ein, die dem Eigenschaftstyp entsprechen, wie im Folgenden gezeigt:


Alle Eigenschaften (und Ihre Vorgabewerte) werden zur Komponente hinzugefügt, wenn die Komponente zu einer Anwendung hinzugefügt wird. Der Composite Application Editor zeigt die Steuerelemente für Eigenschaften im Dialogfeld "Komponenteneigenschaften bearbeiten" auf dem Register "Komponenteneinstellungen" an.

Wenn Sie eine Eigenschaft mit einem benutzerdefinierten Typ erstellen, können Sie Benutzern auch ein Steuerelement zur Verfügung stellen, damit sie den Wert der Eigenschaft angeben können. Weitere Informationen finden Sie nachfolgend unter "Definieren benutzerdefinierter Eigenschaftstypen".

Sie können Gruppen auch Eigenschaften zuweisen, damit sie neben anderen verwandten Eigenschaften auf dem Register "Komponenteneinstellungen" angezeigt werden. Weitere Informationen finden Sie nachfolgend unter "Hinzufügen von Eigenschaften zu Gruppen".

Definieren benutzerdefinierter Eigenschaftstypen

Sie können Komponenteneigenschaften mit benutzerdefinierten Typen erstellen und Bearbeitungsfelder für diese Eigenschaften auf dem Register "Komponenteneigenschaften bearbeiten" des Composite Application Editors bereitstellen.

Der Erweiterungspunkt "com.ibm.rcp.ca.utils.properties" verfügt über ein Element "type", mit dem Sie einen benutzerdefinierten Typ für eine Komponenteneigenschaft erstellen können. Führen Sie zum Hinzufügen des Elements folgende Schritte aus.

1. Klicken Sie mit der rechten Maustaste auf die Erweiterung und klicken Sie auf "Neu > Typ".

2. Geben Sie im Element "type" eine Typ-ID und einen -Namen an und verweisen Sie auf die Java-Klasse für den Typ.

Die Java-Klasse muss "com.ibm.rcp.ca.utils.componentconfig.IComponentPreferenceType" implementieren. Sie definiert das Bearbeitungsfeld, das auf dem Register "Komponenteneigenschaften bearbeiten" angezeigt wird, und optional eine Schaltfläche, z. B. eine Schaltfläche "Durchsuchen" oder einen Farbwähler. Das Bearbeitungsfeld kann modular aufgebaut sein und mehrere Steuerelemente enthalten.

Wenn Sie eine Eigenschaft mit einem benutzerdefinierten Typ im Erweiterungspunkt "com.ibm.rcp.ca.utils.properties" definieren, muss das Attribut "typeId" die ID des benutzerdefinierten Typs referenzieren.

Hinzufügen von Eigenschaften zu Gruppen

Sie können zusammengehörige Steuerelemente für Komponenteneigenschaften auf dem Register "Komponenteneinstellungen" des Dialogfelds "Komponenteneigenschaften bearbeiten" gruppieren.

Sie können Gruppen auf zwei Arten Eigenschaften hinzufügen.


Der Gruppenname wird im Composite Application Editor im Dialogfeld "Komponenteneigenschaften bearbeiten" auf dem Register "Komponenteneinstellungen" vor den Eigenschaften angezeigt, die dieser Gruppe zugewiesen wurden. Alle Eigenschaften, die keiner Gruppe zugewiesen wurden, werden nach den gruppierten Eigenschaften angezeigt.

Hinzufügen von Registern zum Dialogfeld "Komponenteneinstellungen"

Sie können zum Hervorheben der spezifischen Eigenschaften einer ViewPart-Komponente diese auf einem Register anzeigen, das Sie zum Dialogfeld "Komponenteneinstellungen" im Composite Application Editor hinzufügen.

Ihre ViewPart-Komponente muss zum Hinzufügen eines Registers die Schnittstelle "com.ibm.rcp.ca.utils.componentconfig.IPropertyTabsProvider" implementieren.

Diese Schnittstelle bietet eine Methode "getTabs()" (com.ibm.rcp.ca.utils.componentconfig.IPropertyTab [] getTabs), die vom Composite Application Editor zum Hinzufügen Ihrer Register zum Dialogfeld "Komponenteneinstellungen" verwendet wird. Jedes Register kann auf die Methoden von "com.ibm.rcp.ca.utils.componentconfig.IPropertyManager" zugreifen und ist für Folgendes verantwortlich:


Stellen Sie sich eine Komponente vor, die durch Erweiterung der vorhandenen Managed Browser-Komponente und Implementierung der Schnittstelle "com.ibm.rcp.ca.utils.componentconfig.IPropertyTabsProvider" erstellt wurde, wie im folgenden Fragment gezeigt:

public class MyBrowserView

  extends PAABrowserView

  implements IPropertyTabsProvider { …

Die Komponente erstellt neue Register, indem sie die Schnittstelle "com.ibm.rcp.ca.utils.componentconfig.IPropertyTab" implementiert, um die Benutzeroberfläche des Registers zu definieren:

public class BrowserTab implements IPropertyTab { …

public class LayoutTab implements IPropertyTab { …

Hinweis Ihr benutzerdefiniertes Register kann auch "com.ibm.rcp.ca.utils.componentconfig.AbstractPropertyTab" erweitern, das Standard-Implementierungen einiger Methoden bereitstellt.

Der Code implementiert auch die Methode "getTabs()" in "MyBrowserView", um die Register zurückzugeben:

public IPropertyTab[] getTabs() {

IPropertyTab[] _tabs = new IPropertyTab[2];

_tabs[0] = new BrowserTab();

_tabs[1] = new LayoutTab();

return _tabs;

}

Im Composite Application Editor wird das neue Register "Browser" im Dialogfeld "Komponenteneinstellungen" angezeigt.

Steuerelemente zum Einstellen der Eigenschaften von Komponenten direkt hinzufügen

Sie können Steuerelemente zum Einstellen der Eigenschaften Ihrer Komponenten erstellen, damit Anwendungsassemblierer die Eigenschaften besser verstehen. Diese Steuerelemente dienen zum Einstellen der auf der Benutzeroberfläche der Komponente sichtbaren Eigenschaften, wenn der Anwendungsassemblierer sie im Composite Application Editor bearbeitet.

Führen Sie zum Hinzufügen dieser zusätzlichen Benutzeroberfläche Folgendes im Code für Ihre Komponentenklasse aus:


Hinweis Sie können in der Praxis eine Klassenvariable des Typs "ISaveablePropertyManager" in Ihre Klasse "ViewPart" einfügen und mittels der implementierten Methode "setSaveablePropertyManager" ihren Wert festlegen. Beachten Sie jedoch, dass die Variable bis zur Erstellung der "Benutzeroberfläche" der Ansicht den Wert null behält. Deshalb müssen Sie die Eigenschaft "editingApplication" wie oben beschrieben prüfen, um herauszufinden, ob Sie die zusätzliche Benutzeroberfläche anzeigen müssen.

Ausführliche Informationen zu den beschriebenen Aufgaben sowie zur Verwendung von Composite Application Editor und Lotus Expeditor finden Sie in der Produktdokumentation des jeweiligen Werkzeugs. Der Composite Application Editor wird als Option installiert, wenn Sie den IBM® Lotus® Notes® Standard-Client installieren.

Weitere Details finden Sie außerdem im Wiki zum Lotus Expeditor (http://www-10.lotus.com/ldd/lewiki.nsf)