IBM Lotus Notes 8 メール機能を Eclipse により拡張する

コンテンツ プラグインの作成 CSI Viewsの拡張 Javaバックエンド・クラスへの記述 Lotus Notes 8クライアントへのプラグインのデプロイ 新規コントリビューションの実行 まとめ ダウンロード リソース 筆者について ご意見ご要望をお寄せ下さい

Bob Balfe (balfe@us.ibm.com), Senior Software Engineer, IBM

[編集者のメモ: この記事で取り上げたLotus Notes 8の機能および環境は、ベータ・ソフトウェアに基づいています。記事の内容およびスクリーン・ショットは、製品版と異なる場合があります。]

Eclipseを使用してJavaコードを書き、IBM Lotus Notes 8クライアントを拡張しましょう。IBM Lotus Notesを自宅での個人の電子メールに使用して、また、メールを拡張してクライアントでもメール・ルールを手動で実行できるように新しいMail Rule Runner (メール・ルール実行機能)を追加しましょう。
この記事は、Eclipse PDE (プラグイン開発環境)を使用してJavaコードを書くことにより、IBM Lotus Notes 8クライアントを拡張する方法に焦点を当てます。特に、自宅で個人の電子メール用にIBM Lotus Notesを使用する方法について解説します。

プラグインの作成

他のプラグインと同様に、Eclipseプラグイン・ウィザードを使用した作成手順は簡単です。Eclipseは開発者のために多くの作業を行いますが、それはソフトウェア開発における一般的なことであり、ほんのスタート段階に過ぎません。このサンプルでは、私たちはEclipse 3.2.2を使用して、インストール済みのLotus Notes 8ベータ・クライアントをターゲット・プラットフォームとして指定しました。Lotus Notesは、すべてのマシンで常に同じ場所(c:\notes)にインストールすることをお勧めします。Eclipseでターゲット・プラットフォームを選択するには、「Window」-「Preferences」を選択します。次に、「Plug-in Development」->「Target Platform」を選択し、ターゲット・プラットフォームを指定します。Lotus Notesをターゲット・プラットフォームとして選択するようすを図3に示します。重要なのは、\framework\eclipseディレクトリーを選択することです。これはEclipseランタイムのルート・ディレクトリーです。この場合、ディレクトリーはc:\notes\framework\eclipseとなります。

図3. ターゲット・プラットフォームの指定


これで、Lotus Notesランタイムをプラットフォームとして選択したので、新しいプラグインを作成し、依存関係を設定し、コードを書くことができます。Lotus Notesをターゲット・プラットフォームにすることにより、Eclipse、Lotus Expeditor、Lotus Notes APIおよび拡張をすべて利用できるようになります。パッケージ・エクスプローラーで、右クリックし、「New」->「Project」を選択します。ここで、Eclipseプラグイン・プロジェクトを選択します。表示される「New Project」ウィザードの画面を図4に示します。

図4. 「New Project」ウィザード


「Next」をクリックし、プロジェクトに「com.ibm.notes.mail.utils」という名前を付けます。これが、後で作成するすべてのメール・ユーティリティー用の主な場所となります。ウィザードの残りの部分では、提示されたデフォルト値をそのまま選択できます。このプラグインに基づく既存のテンプレートを指定する画面が表示されたときは、テンプレート・オプションの選択を解除します。テンプレートは使用しないでください。

新規作成したプロジェクトをパッケージ・エクスプローラーで展開し、META-INFフォルダー内のMANIFEST.MFをダブルクリックします。

「Dependencies」タブに移動し(図5参照)、com.ibm.notes.java.java.apiバンドルを依存関係に追加します。これにより、すべてのLotus Domino Javaバックエンド・クラスにアクセスできるようになります。

図5. 「Dependencies」タブ


通常は、「インポートされたパッケージ」による方法で依存関係を定義します。インポートを使用することは、ここで行ったように開発者が特定のバンドルを指定するのではなく、OSGIフレームワークがパッケージのインポートと要求されたクラスを解決することを意味します。もし、指定されたバンドルがリネームまたは削除されると、依存関係が壊れ、実行時にクラスが解決されないでしょう。これに対し、使用する予定のすべてのパッケージをインポートすると、どのプラグインもこれらのパッケージを公開できます。プラグインのコードを記述した後、この依存関係を削除し、必要なパッケージだけを同じ画面でインポートできます。これで依存関係を指定したので、コーディングを開始できます。

上に戻る

CSI Viewsの拡張

<extension
     point="org.eclipse.ui.actionSets">
  <actionSet
        id="com.ibm.notes.mail.utils.actionSet"
        label="Mail Tools">
     <menu
           id="RunMailRules"
           label="Run Mail Rules">
     </menu>
     <action
           class="com.ibm.notes.mail.utils.actions.RunMailRules"
           icon="icons/mailrules.gif"
           id="com.ibm.notes.mail.utils.actions.RunMailRules"
           label="&Run Mail Rules"
           toolbarPath="actions/additions"
           tooltip="Run Mail Rules"/>
  </actionSet>
</extension>
   
<extension point="org.eclipse.ui.actionSetPartAssociations">
    <actionSetPartAssociation                
        targetID="com.ibm.notes.mail.utils.actionSet">
        <part id="com.ibm.rcp.csiviews.CSIViewPart" />      
    </actionSetPartAssociation>
</extension>

上に戻る

Javaバックエンド・クラスへの記述

Session session = null;
try{
	NotesThread.sinitThread();
		
	session = NotesFactory.createSessionWithFullAccess();
					
	DbDirectory dbdir = session.getDbDirectory(null);
					
	Database mail = dbdir.openMailDatabase();
					
	Vector views = mail.getViews();
	Enumeration vEnum = views.elements();
…

	View rules = mail.getView("(Rules)");
…
					
}finally{
	NotesThread.stermThread();

上に戻る

Lotus Notes 8クライアントへのプラグインのデプロイ

<?xml version="1.0" encoding="UTF-8"?>
<site>
   <feature url="features/com.ibm.notes.mail.utils.feature_1.0.0.jar" 
   id="com.ibm.notes.mail.utils.feature" version="1.0.0"/>
</site>

上に戻る

新規コントリビューションの実行

Lotus Notes 8ベータでは、新規フィーチャーをインストールするEclipseメニュー・オプションがクライアントにありません。システム管理者がこのプリファレンスを無効にしていない限り、<notes directory>/framework/rcpディレクトリーでplugin_customization.iniを編集することにより、このオプションをオンにできます。

<notes directory>/framework/rcp/plugin_customization.iniファイルに、次の行を追加してください。

com.ibm.notes.branding/enable.update.ui=true
Lotus Notesクライアントを再起動すると、新規メニュー・オプションが表示されます。「ファイル」->「アプリケーション」->「インストール」を選択します。これは、フィーチャーをインストールするための標準Eclipseインターフェースです。ウィザードの最初のウィンドウで、2番目のオプション(「インストールする新規フィーチャーを検索」)を選択します。「次へ」をクリックします。作成したEclipse更新サイトのロケーションを指定するウィンドウが表示されます。「フォルダー・ロケーションの追加」ボタンをクリックし、前に作成したsite.xmlファイルが含まれるディレクトリーに移動します。図9のようなウィンドウが表示されます。

図9. フィーチャーのインストール


「終了」をクリックし、残りのプロンプトをすべて受け入れます。プラグインが署名されていないにもかかわらず、それをインストールするかどうかを確認されます。これは、Lotus Notesが署名を検証する機能を持ち、外部からのプラグインをインストールするときに署名をチェックするためです。プラグインには署名しなかったので、プラグインは署名を持っていません。新規フィーチャーがインストールされると、Lotus Notesの再起動を求められます。再起動後、すべてのメール・ビューに新規ボタンが表示されます。

別の方法として、私たちはLotus Notes 8ユーザー用にNSFベースの更新サイトを用意しました。この記事の『ダウンロード』セクションに示されているNSFファイルをLotus Notesデータ・ディレクトリーにコピーするだけで準備できます。このデータベースを開くと、「メール・ツール」フィーチャーがインストールされるようすが標準Eclipse進行状況ダイアログ・ボックスに表示されます。インストールが完了し、Lotus Notesを再起動すると、アクションが利用可能になります。

上に戻る

まとめ

この記事では、Eclipseを使用してIBM Lotus Notesクライアントを拡張する方法を説明しました。基本のEclipse SWTユーザー・インターフェース・ウィジェットを使用し、問題に対するクロスプラットフォームの完全なソリューションを作成しました。この方法により、Lotus Notes NSFおよびNTFからコントリビューションを分離できるだけでなく、IBM Lotus Notes 8へのアップグレードの際にコードへの影響も回避できます。最後に、新しいプラグイン・モデルで既存のLotus Domino Java APIスキルを活用する方法を説明しました。JavaバックエンドAPIを使用すると、IBM Lotus Notes/Dominoアーキテクチャーへの接続を容易に得られます。この記事では、Eclipseフレームワークの柔軟性とLotus Notesアプリケーションの実証済みの手法により、カスタム・コードおよびプラグインを用いて簡単に拡張する方法を解説しました。

ダウンロード

	ダウンロード方法について (US）

参考文献

学ぶために

• developerWorksの記事「IBM Lotus Notes 8 のサイドバーおよびツールバーに Lotus Notes データを統合する」をお読みください。
• developerWorksの記事「IBM Lotus Notes 8 のサイドバーとツールバーの拡張」をお読みください。
• developerWorksの記事「IBM Lotus Notes/Domino 8の新機能」をお読みください。
• developerWorksの記事「IBM Lotus Notes 8 の新しい不在通知機能」をお読みください。
• developerWorksの記事「IBM Lotus Expeditorでの簡単な Web Services Resourceの構築とデプロイ」をお読みください。
• developerWorksの記事「Creating a Notes/Domino plug-in with Eclipse」(US)をお読みください。
• 「IBM Lotus Notes/Domino 8 機能評価ガイド」をお読みください。

製品や技術を入手するために

• Eclipseをダウンロードできます。
  

  Eclipse (US)

議論するために

• ディスカッション・フォーラム (US) にご参加ください。
• Bob Balfeのブログにご参加ください。
  

  Bob Balfeのブログ (US)

• developerWorks Lotusチーム・ブログ (US) にご参加ください。

上に戻る