NSF-Komponenten sind Elemente einer Lotus Notes-Anwendung, die in einer Verbundanwendung eingesetzt werden. Mit der Funktion "Composite Application Editor" können Sie, ohne die vorhandene Notes-Anwendung ändern zu müssen, die Ansichten, Masken, Dokumente und andere Elemente der Notes-Anwendung als Komponenten einsetzen.

Hinweis Damit dies möglich ist, müssen für die Notes-Anwendung zuerst die erforderlichen WSDL-Teile verfügbar sein und die Unterstützung für den Eigenschaftsbroker muss aktiviert werden. Weitere Informationen hierzu finden Sie unter "Den Eigenschaftsbrokereditor in Domino Designer verwenden".

Zur Unterstützung der komponentenübergreifenden Kommunikation verwenden Sie die neuen Funktionen von IBM® Lotus® Domino(TM) Designer, um die NSF und die Elemente zu ändern, die als Komponenten eingesetzt werden. Die zum Lieferumfang von IBM® Lotus® Notes® gehörende Funktionalität des Eigenschaftsbrokers bietet die Laufzeitumgebung, die die komponentenübergreifende Kommunikation unterstützt.

Zum Generieren der NSF-Komponenten in der Verbundanwendung verwenden Sie Lotus Domino Designer. Es wird vorausgesetzt, dass Sie mit dem Erstellen neuer Notes-Datenbanken auf dem Lotus Notes-Client vertraut sind. Es wird außerdem vorausgesetzt, dass Sie mit früheren Versionen von Lotus Domino Designer vertraut sind und Notes-Ansichten ändern, einfache Notes-Masken erstellen und im Programmierfenster Notes-Formeln und LotusScript-Code eingeben können.

Das Generieren einer Notes-Komponente umfasst Folgendes:

• Legen Sie die von der Komponente zu veröffentlichenden Eigenschaften fest.
• Legen Sie die Aktionen fest, die diese Komponente ausführen soll, wenn sie mit der Eigenschaft einer anderen Komponente verbunden ist.
• Erstellen Sie die WSDL, in der die Aktionen und Eigenschaften für die Komponente aufgelistet sind. Dies wird mit der Funktion "Property Broker Editor" ausgeführt.
• Importieren Sie die WSDL in die NSF, in der bestimmte Gestaltungselemente oder Dokumente als NSF-Komponenten eingesetzt werden. Dies wird in Domino Designer ausgeführt.
• Verlinken Sie die NSF-Gestaltungselemente mit den zuvor definierten Eigenschaften und Aktionen mithilfe der Funktionen in Domino Designer, einschließlich LotusScript-Klassen, -Methoden und -Eigenschaften.

Hinweis Wenn die NSF als eine oder mehrere Komponenten in einer Verbundanwendung, die auf WebSphere Portal gehostet wird, generieren Sie eine .WAR-Datei für das Portlet (Web-Module). Zum Generieren der Portlets verwenden Sie den Composite Application Editor. Anschließend können Sie die Verbundanwendung über die Administratorbenutzeroberfläche von WebSphere Portal oder mit einem xmlaccess-Skript auf WebSphere Portal bereitstellen bzw. installieren.

Grundlegendes zu Notes-Komponenten

Eine Notes-Komponente ist ein Link auf eine bestimmte Ansicht, eine Rahmengruppe, ein Dokument oder eine andere Gestaltungskomponente in einer Notes-Datenbank. Dieselbe Notes-Datenbank kann mehrere Komponenten enthalten und diese Komponenten können in mehreren Verbundanwendungen verwendet werden.

Alle Komponenten in einer Notes-Datenbank verwenden denselben Satz Typen, Eigenschaften und Aktionen, die in einer oder mehreren Verbindungseigenschafts- und Verbundanwendungsgestaltungselementen definiert sind. Die Komponente muss nicht alle der Ausgabeeigenschaften veröffentlichen oder alle Aktionen implementieren, die in der WSDL-Eigenschaftsdatei der Verbundanwendung definiert sind. Weitere Informationen hierzu finden Sie in den Themen zum Property Broker Editor.

Damit die Komponente in eine Verbundanwendung integriert werden kann, muss sie auf Eigenschaften und Aktionen in der WSDL-Eigenschaftsdatei der Verbundanwendung verweisen. Eine Komponente kann Eigenschaften veröffentlichen oder konsumieren oder beides. Es gibt zwei Möglichkeiten für eine Komponente, eine Eigenschaft zu veröffentlichen:

1. Verwenden Sie die im Folgenden beschriebene LotusScript-API. Dies kann überall erfolgen, wo LotusScript ausgeführt wird, auch in einem Agenten.

2. Wenn es sich bei der Komponente um eine Ansicht oder einen Ordner handelt, können Sie einer in der WSDL-Datei definierten Ausgabeeigenschaft eine Spalte zuweisen. Diese Option finden Sie im Register "Erweitert" der Spalteneigenschaften. Da eine Spalte einen einzelnen Wert enthält, können einer Spalte nur Eigenschaften mit "einfachen" Typen zugeordnet werden.

Hinweis Der Begriff "Aktion" wird im Allgemeinen als Bezeichnung für die "Buchse" einer Komponente verwendet, die einen Eigenschaftswert konsumiert. Verwechseln Sie nicht den in diesem Zusammenhang verwendeten Begriff "Aktion" mit den in Notes-Ansichten und -Masken verwendeten Aktionsschaltflächen. Alle Komponenten können über "WSDL-Aktionen" verfügen, unabhängig davon, ob Sie Notes-Anwendungen sind oder nicht.

Für eine Notes-Komponente gibt es nur eine Möglichkeit, eine Eigenschaft einer anderen Komponente zu konsumieren. Die Notes-Komponente muss eine "Notes-Aktionen" enthalten, die auf eine "WSDL-Aktion" verweist, die für das Empfangen der Eigenschaft verbunden ist. Verwenden Sie zum Erstellen einer Verknüpfung zwischen einer Notes-Aktion und einer WSDL-Aktion das Register "Erweitert" der Infobox "Aktion".

Wenn ein Eigenschaftsänderungsereignis erfolgt und diese Eigenschaft mit einer WSDL-Aktion in Ihrer Notes-Komponente verbunden ist, und wenn die Notes-Komponente eine Notes-Aktion enthält, die mit dieser WSDL-Aktion verknüpft ist, dann wird die Notes-Aktion ausgeführt. Die Notes-Aktion verwendet in der Regel die im Folgenden beschriebenen LotusScript-APIs, um zu ermitteln, welcher Wert veröffentlicht wurde, und führt mit dem Wert eine Aktion aus (verwendet ihn beispielsweise als Schlüssel, um die aktuelle Ansicht auf ein übereinstimmendes Dokument zu positionieren).

Eine Notes-Aktion wird als Reaktion auf das Auslösen einer WSDL-Aktion nur dann ausgeführt, wenn die Maske, die Ansicht oder die Seite, die diese Aktion enthält, von der Komponente zu diesem Zeitpunkt angezeigt wird. Sie können eine gemeinsame Notes-Aktion mit einer WSDL-Aktion verknüpfen, dadurch wird sie jedoch nicht über die Anwendung ausgeführt. Vielmehr müssen Sie die gemeinsame Aktion in die Maske bzw. Ansicht stellen, in der sie ausgeführt werden soll.

Die Attribute "Verbergen" einer Notes-Aktion werden nicht verwendet, um zu ermitteln, ob die Aktion als Antwort auf eine WSDL-Aktion ausgeführt wird. Alle Notes-Aktionen, die durch Eigenschaftsänderungsereignisse aufgerufen werden, sollten in der Regel jederzeit verborgen sein. Derartige Aktionen verwenden in der Regel die LotusScript-API, um eine Eingabeeigenschaft vom Eigenschaftsbroker zu lesen. Dies würde, wenn durch einen Benutzer aktiviert, einen Fehler verursachen, da zu diesem Zeitpunkt keine zu lesende Eingabeeigenschaft vorhanden ist.

Sie können Lotus-NSF-Komponenten (Datenbanken, Ansichten, Masken usw.) für die Verwendung in einer Verbundanwendung wie folgt generieren:

• Die Gestaltung von Notes-Datenbanken erfolgt mit Domino Designer.
• Eigenschaften und Aktionen werden in einer WSDL-Datei definiert. Die WSDL-Datei muss mittels Domino Designer in die Notes-Datenbank importiert werden.
• Neue LotusScript-APIs ermöglichen das Veröffentlichen von Eigenschaften im und das Empfangen von Eigenschaften vom Eigenschaftsbroker. Weitere Informationen hierzu finden Sie unter "LotusScript-Klassen und -APIs in Verbundanwendungen verwenden". Wenn Sie beispielsweise eine neue Verbundanwendung implementieren möchten, können Sie zum Veröffentlichen einer Eigenschaft die folgenden neuen LotusScript-APIs verwenden:
  • NotesSession.GetPropertyBroker
  • NotesPropertyBroker.SetPropertyValue
  • NotesPropertyBroker.Publish

Diese Version enthält viele neue Eigenschaften, Methoden und Klassen in den LotusScript-APIs. Dazu gehören Folgende:

NotesSession

• NotesSession.GetPropertyBroker( ) - Gibt das NotesPropertyBroker-Objekt zurück.

• NotesPropertyBroker.InputPropertyContext (Eigenschaft) - Gibt ein Array der angegebenen NotesProperties zurück. Für aktuelle Versionen wird nur das erste Mitglied des Arrays ausgefüllt.
• NotesPropertyBroker.Namespace (Eigenschaft) - String. Stellt den relevanten Standard-Namespace für Lese-/Schreibvorgänge zur Verfügung.
• NotesPropertyBroker.HasProperty(Name) - Boolean. Gibt an, ob eine Eigenschaft vorhanden ist.
• NotesPropertyBroker.GetProperty(Name) - Gibt ein NotesProperty-Objekt zurück.
• NotesPropertyBroker.GetPropertyValue(Name) - Gibt den Wert für die angegebene Eigenschaft zurück.
• NotesPropertyBroker.SetPropertyValue(Name, Wert) - Gibt ein NotesProperty-Objekt zurück. Erstellt ein Back-End-Objekt und weist ihm diesen Wert zu. Diese Methode gibt einen Fehler zurück, wenn der Eigenschaftsname in der WSDL nicht definiert ist.
• NotesPropertyBroker.ClearProperty - Eine neue Methode, die, mit Ausnahme von Eingabeeigenschaften, alle neuen oder geänderten Eigenschaften bereinigt.
• NotesPropertyBroker.Publish - Eine neue Methode, die alle neuen und geänderten Eigenschaften veröffentlicht.

• NotesProperty.Values (Eigenschaft) - Lese-/Schreibzugriff für einfache Eigenschaften: Gibt ein Variant-Array vom Typ String zurück. Einzelwerteigenschaften enthalten Daten im ersten Arrayelement. Als Argument werden Varianten oder Arrays vom Typ String akzeptiert. Das Array muss homogen sein. Derzeit kann ein Array nur einen String enthalten. Eingabeeigenschaften können nicht festgelegt werden.
• NotesProperty.Name (Eigenschaft) - Nur lesen. Gibt den Eigenschaftsnamen als Zeichenfolge zurück.
• NotesProperty.TypeName (Eigenschaft) - Nur lesen. Gibt den Typnamen als Zeichenfolge zurück.
• NotesProperty.NameSpace (Eigenschaft) - Nur lesen. Gibt den Namespace als Zeichenfolge zurück.
• NotesProperty.Title (Eigenschaft) - Nur lesen. Gibt den Titel als Zeichenfolge zurück.
• NotesProperty.isInput (Eigenschaft) - Nur lesen. Gibt "true" zurück, wenn es sich um eine Eingabeeigenschaft handelt, anderenfalls "false". Gibt einen booleschen Wert zurück.
• NotesProperty.Description (Eigenschaft) - Nur lesen. Gibt die Beschreibung als Zeichenfolge zurück.
• NotesProperty.Publish( ) - Eine neue Methode, die diese Eigenschaft veröffentlicht, wenn sie geändert wurde.
• NotesProperty.Clear( ) - Eine neue Methode, die diese Eigenschaft bereinigt, wenn sie neu ist oder geändert wurde.

Glossar