NSF コンポーネントは、複合アプリケーション内の Lotus Notes アプリケーションの構成要素です。Composite Application Editor フィーチャーを使用すると、既存の Lotus Notes アプリケーションを修正することなく、Lotus Notes アプリケーションのビューやフォームや文書などの要素を単純にコンポーネントとして処理することができます。

メモ この場合、必要な WSDL とプロパティブローカーのサポートが有効になっている必要があります。詳しくは、「Lotus Domino Designer で Property Broker Editor フィーチャーを使用する」を参照してください。

コンポーネント間の通信をサポートするには、IBM(R) Lotus Domino(TM) Designer の新機能を使用して、コンポーネントとして処理される NSF と要素を修正します。IBM(R) Lotus Notes(R) に用意されているプロパティブローカー機能により、コンポーネント間の通信をサポートする実行時環境が提供されます。

複合アプリケーション内で NSF コンポーネントを構築するには、Lotus Domino Designer を使用します。この文書は、Lotus Notes クライアントでの Lotus Notes データベースの新規作成に慣れているユーザーを想定して書かれています。また、前バージョンの Lotus Domino Designer での Notes ビューの変更、シンプルな Lotus Notes フォームの作成、プログラムペインを使用しての Lotus Notes 式と LotusScript コードの入力に慣れていることも想定されています。

Lotus Notes コンポーネントを構築するには、次の手順を実行します。

• コンポーネントによって発行されるプロパティを指定します。
• コンポーネントが別のコンポーネントのプロパティにワイヤリングされたときに実行するアクションを指定します。
• コンポーネントのアクションとプロパティをリストする WSDL ファイルを作成します。この処理は、Property Broker Editor フィーチャーを使用して行います。
• 特定の設計要素や文書が NSF コンポーネントとして処理される NSF に WSDL を呼び出します。この処理は、Lotus Domino Designer から行います。
• NSF の設計要素を修正し、新しい LotusScript のクラス、メソッド、プロパティなど、Lotus Domino Designer の機能を使用する定義済みのプロパティやアクションへのリンクを設定します。

メモ WebShere Portal 上でホストされる複合アプリケーションのコンポーネントとして NSF を使用する場合、ポートレットの .WAR ファイル (Web モジュール) を作成する必要があります。ポートレットを生成するには、Composite Application Editor を使用します。作成したファイルは、WebSphere Portal の管理者ユーザーインターフェースまたは xmlaccess スクリプトを使用して、WebSphere Portal 上に展開したりインストールすることができます。

Lotus Notes コンポーネントの基本

Lotus Notes コンポーネントは、Lotus Notes データベース内の特定のビューやフレームセットや文書などの設計要素に接続するためのリンクです。同じ Lotus Notes データベースに複数のコンポーネントを格納することができ、これらのコンポーネントは複数の複合アプリケーションで使用することができます。

1 つの Lotus Notes データベース内のすべてのコンポーネントは、1 つ以上の複合アプリケーションのワイヤリングプロパティとアプリケーションの設計要素内に定義されている型、プロパティ、アクションの同じセットを共有します。複合アプリケーションプロパティ WSDL ファイルに定義されているすべての出力プロパティがコンポーネントによって発行されるわけではなく、すべてのアクションが実装されるわけでもありません。詳しくは、Property Broker Editor に関する項目を参照してください。

コンポーネントを複合アプリケーション内に追加するには、複合アプリケーションプロパティ WSDL ファイル内のプロパティやアクションへの参照を設定する必要があります。コンポーネントにより、プロパティの発行やコンシュームを行うことができます。コンポーネントによるプロパティの発行には、次の 2 つの方法があります。

1. 下で説明する LotusScript API を使用します。エージェントを含む LotusScript が実行されていれば、どこでも使用できます。

2. コンポーネントがフォルダのビューである場合、WSDL ファイル内に定義されている出力プロパティに列を関連付けることができます。このオプションは、[列のプロパティ] インフォボックスの [詳細] タブにあります。1 つの列に指定できるのは 1 つの値だけであるため、列に関連付けることができるのは型が「シンプル」であるプロパティだけです。

メモ 通常、「アクション」という用語は、プロパティ値をコンシュームするコンポーネント内の「プラグ」について説明する場合に使用されます。この意味合いで使用される「アクション」と、Lotus Notes のビューやフォームで使用されるアクションボタンとを混同しないでください。Lotus Notes アプリケーションのコンポーネントかそれ以外のアプリケーションのコンポーネントかに関わらず、すべてのコンポーネントに WSDL アクションを設定することができます。

Lotus Notes コンポーネントが別のコンポーネントのプロパティをコンシュームする方法は 1 つしかありません。それは、プロパティを受信するようにワイヤリングされた WSDL アクションを参照する Lotus Notes アクションを Lotus Notes コンポーネントに格納する方法です。Lotus Notes アクションと WSDL アクションとを関連付けるには、[アクション] インフォボックスの [詳細] タブを使用します。

プロパティの変更イベントが発生した場合、そのプロパティが Lotus Notes コンポーネントの WSDL アクションにワイヤリングされていて、その WSDL アクションと関連する Lotus Notes アクションが Lotus Notes コンポーネントに格納されていれば、この Lotus Notes アクションが実行されます。通常の場合、Lotus Notes アクションは、下で説明する LotusScript API を使用してどの値が発行されたかを判断し、その値を使用して処理を実行します。たとえば、この値をキーとして使用し、現在のビューを対応する文書に配置し直すなどの処理を実行します。

Lotus Notes アクションは、WSDL アクションがトリガーされた場合に反応して実行されます。ただし、このアクションを格納するフォーム、ビュー、またはページが、トリガーの時点でコンポーネントによって表示されている場合に限ります。Lotus Notes の共有アクションを WSDL アクションに関連付けることができますが、関連付けただけではアプリケーション経由で共有アクションを実行することはできません。アプリケーション経由で実行するには、実行するビューやフォームに共有アクションを挿入する必要があります。

Lotus Notes アクションの [非表示] 属性は、WSDL アクションに反応して Lotus Notes アクションを実行するかどうかを判断するために使用される属性ではありません。実際には、プロパティ変更イベントによって呼び出されたすべての Lotus Notes アクションは常に非表示になるのが通常です。通常、こうしたアクションは、LotusScript API を使用してプロパティブローカーから入力プロパティを読み込みますが、ユーザーによって入力プロパティがアクティブ状態にされている場合はエラーが発生します。これは、この時点では読み込む入力プロパティが存在しないためです。

次に示すように、複合アプリケーション内で使用する NSF コンポーネント (データベース、ビュー、フォームなど) を構築することができます。

• 標準的な Lotus Notes データベースは、Lotus Domino Designer を使用して設計します。
• プロパティやアクションは、WSDL ファイル内に定義されます。WSDL ファイルは、Lotus Domino Designer から Lotus Notes データベースに呼び出す必要があります。
• 新しい LotusScript API を使用すると、プロパティブローカーに対してプロパティを発行し、プロパティブローカーからプロパティを受け取ることができます。関連する情報については、「複合アプリケーション内で LotusScript クラスと API を使用する」を参照してください。たとえば、新しい複合アプリケーションを実装する場合、次の新しい LotusScript API を使用して、プロパティをプログラムによって発行することができます。
  • NotesSession.GetPropertyBroker
  • NotesPropertyBroker.SetPropertyValue
  • NotesPropertyBroker.Publish

このリリースには、さまざまな新しいプロパティ、メソッド、クラスが用意されています。このアプリケーションに含まれるものは次のとおりです。

NotesSession

• NotesSession.GetPropertyBroker( ) -- NotesPropertyBroker を返します。

• NotesPropertyBroker.InputPropertyContext (プロパティ) -- NotesProperties の入力配列を返します。現在のリリースでは、配列の最初のメンバーだけに値が設定されます。
• NotesPropertyBroker.Namespace (プロパティ) -- String 型。PropertyBroker に関する読み込みと書き込みのデフォルトのネームスペースを提供します。
• NotesPropertyBroker.HasProperty(名前) -- Boolean 型。新しいプロパティが存在するかどうかを示します。
• NotesPropertyBroker.GetProperty(名前) -- NotesProperty を返します。
• NotesPropertyBroker.GetPropertyValue(名前) --指定されたプロパティの値を返します。
• NotesPropertyBroker.SetPropertyValue(名前, 値) -- NotesProperty を返します。バックエンドオブジェクトを作成し、そのオブジェクトに値を設定します。プロパティ名が WSDL によって定義されていない場合、このメソッドによってエラーがスローされます。
• NotesPropertyBroker.ClearProperty -- 入力プロパティ以外の新しいプロパティや修正されたプロパティをパージするためのメソッドです。
• NotesPropertyBroker.Publish -- すべての新しいプロパティと修正されたプロパティを発行するためのメソッドです。

• NotesProperty.Values (プロパティ) - シンプルプロパティの読み込みや書き込みを行います。String 型の Variant 型配列を返します。単一値プロパティの場合、配列の最初の要素にデータが格納されます。入力として、String 型の Variant 型または String 型の Array 型を受け取ります。Array 型は、すべて同じに統一されている必要があります。この場合、Array 型に格納できるのは 1 つの String 型だけです。入力プロパティは設定できません。
• NotesProperty.Name (プロパティ) -- 読み込み専用。プロパティ名を文字列として返します。
• NotesProperty.TypeName (プロパティ) -- 読み込み専用。型名を文字列として返します。
• NotesProperty.NameSpace (プロパティ) -- 読み込み専用。ネームスペースを文字列として返します。
• NotesProperty.Title (プロパティ) -- 読み込み専用。タイトルを文字列として返します。
• NotesProperty.isInput (プロパティ) -- 読み込み専用。入力プロパティの場合は true を返し、それ以外の場合は false を返します。Boolean 値を返します。
• NotesProperty.Description (プロパティ) -- 読み込み専用。説明を文字列として返します。
• NotesProperty.Publish( ) -- 指定したプロパティが修正されている場合にこのプロパティを発行する新しいメソッドです。
• NotesProperty.Clear( ) -- 指定したプロパティが新規プロパティか修正されたプロパティの場合、このプロパティをパージする新しいメソッドです。

用語集