この記事では、Lotus Notes/DominoアプリケーションをJavaアプリケーションに変換する方法を記載しています。実際例として、個人ジャーナルアプリケーションを扱いますが、このテクニックを応用して、他のLotus Notes/Dominoのテンプレートを変換してLotus Notes 8のPIM (Personal Information Management: メール、カレンダー、連絡先)と同じようなルック&フィールを持たせられるようになります。

関連記事として、"Advanced Java View features"がdeveloperWorks® Lotus上で追って公開される予定です。

今回紹介する手順は、ナビゲータ(アウトライン)やリストビューやプリビューのレイアウトを持つシンプルなアプリケーションでのみ有効です。以下に注意点を示します。

1. ビューでの多段階層のカテゴリー表示が正常に行われない可能性がある。
2. 複数階層化されたビューでの、列の総計が正常に動作しない可能性がある。
3. カテゴリー表示で使われる、カスタムの折りたたみアイコンが動作しない可能性がある。
4. ナビゲータペインでは、カスタムアクションが表示されない。
5. ナビゲータタイトルバーのプルダウンメニューで、カスタムアクションが表示されない。

変換のプロセスについて

Lotus Notes 8以降のクライアントで、Lotus NotesアプリケーションをJavaビューでレンダリングするためには、アプリケーションはコンポジット・アプリケーションになっている必要があります。そのため、まず最初に、Composite Application Editor (CAE)を使ってコンポジットアプリケーションを作成することから始まります。そして、Lotus Domino Designerでテンプレートに変更を加えて、さらにCAEを使って変更を行います。

個人ジャーナルのアプリケーションを例として扱う理由は、ナビゲータやリストビューやプリビューペインの形式においてシンプルであるとともに、上記の条件を満たしているためです。

実際に始める前に、Lotus Notes 8.5と、オプションでインストールされるCAEがインストールされていること、それからLotus Domino Designerがインストールされていることを確認してください。また、16 x 16のPNGファイルが「ページアイコン」用に必要となりますので用意してください。「ページアイコン」とは、アプリケーションのタブに表示されるものです。

図1は、元からある個人ジャーナルのアプリケーションで変換前のものです。図2は、この記事の手順に沿って変換した後の状態です。

上に戻る

空の個人ジャーナルアプリケーションから作業開始

Lotus Notesクライアントを使って、以下の手順で進めてください。

1. Lotus Notesアプリケーションの新規作成画面を出し、journal6.ntfを選択する。
2. 「テンプレートを引き継いで設計」オプションのチェックが外れていることを確認してください。
3. 作成したアプリケーションを開きます。
4. タブ上で右クリックして、Lotus Domino Designerで開きます。

上に戻る

Lotus Domino Designerを使用してコンポジットアプリケーションを新規に作成する

Lotus Domino Designerを使って、以下の手順で進めてください。

1. ナビゲータで、Composite Applicationsをクリックして、Applicationsをクリックします。
2. 設計ペインにあるNewCompAppボタンをクリックします。
3. Notes Journal Application.xmlという新規アプリケーションファイル名をつけ、OKをクリックします。(図3参照)
   
   
   
   図3. CAE: Lotus Domino Designerで新規コンポジットアプリケーションを作成
   
   
   
4. Lotus Domino Designerで、フレームセットを選択し、BorderFrameをダブルクリックして編集します(図4を参照)。
5. メニューから「ファイル」-「プロパティ」を選択してプロパティ画面を表示させ、「フレームセット」プロパティを選択します。
6. プロパティ画面下部の「アプリケーション名」で、Notes Journal Application.xmlを選択します。
7. ページ名で、「空白ページ」を選択します。
   
   
   
   図4 Lotus Domino Designer: フレームセットプロパティでの設定
   
   
   
8. メニューから「ファイル」-「保存」を選択します。
9. メニューから「ファイル」-「終了」を選択します。

上に戻る

メールコンポーネントをベースにして新規アプリケーションを作成する

コンポジットアプリケーションのフレームワークでは、Lotus Notesのメールコンポーネントを使用します。具体的にはナビゲータとリストビューのコンポーネントです。これらを使ってコンポジットアプリケーションのページを作成していきます。Lotus Notesのメールコンポーネント群は既に、リストビューやプリビューを実行するようにワイヤリングされていますので、今回はメールコンポーネントから個人ジャーナルアプリケーションのフレームセットへワイヤリングを再設定することを行います。

Lotus Notesクライアントを使って、以下の手順で進めてください。

1. Lotus Notesクライアントを起動します。
2. 先ほど作成した個人ジャーナルのアプリケーションを開きます。
3. メニューから「アクション」-「アプリケーションの編集」を選択すると、コンポジットアプリケーションの編集画面(Composite Application Editor)が開きます。
4. 画面右側にある矢印(図5を参照)をクリックして、コンポーネントパレットを引き出します。

コンポーネントの追加

ここでは、2つのコンポーネントを追加する必要があります。

Composite Application Editorを使って、以下の手順で進めてください。

1. 右側のコンポーネントパレットのPIMセクションにある、「Notes メールビュー」を真ん中のペインにドラッグ&ドロップします。
   
   
   
   図6. メールビューのコンポーネントをドラッグ&ドロップする
   
   
   

   この操作の結果、画面は以下のよう(図7)になっているはずです。

   
   
   図7. CAE: Notesメールビューをドロップした後の状態
   
   
   
2. この前のステップで行った作業の結果、Lotus Notesクライアントへ画面のフォーカスが移動する場合があります。その場合は、タスクバーにあるLotus Notesをクリックして、「編集中: Blank Application」を再度開いてください。右側のコンポーネントパレットが閉じている場合には、再度開き直してください。
3. 今度は、「Notesメールナビゲータ」コンポーネントを中央のペインにドラッグ&ドロップします。これを行う際に、中央ペインの左側にドロップするようにします。マウスでドラッグすると、ドロップした際に左右上下のどの位置に配置されるかを示す、灰色の枠が表示されます(図8を参照)。
   
   
   
   図8. CAE: メールナビゲータをドラッグ&ドロップする
   
   
   

ドラッグ&ドロップした後の状態は次のようになっているはずです(図9を参照)。

個人ジャーナルアプリケーションから、境界用のフレームセット設定を引き継ぐ

ここで、メールコンポーネントを個人ジャーナルの要素で置きかえる必要があります。個人ジャーナルテンプレートから境界用のフレームセット設定を引き継いでいるアプリケーションを新規に作成します。

以下の手順で進めてください。

1. 左側のペイン内にある「Notesメールナビゲータ・コンポーネント」で右クリックを行い、「コンポーネントプロパティの編集」を選択します。
2. 「表示設定」タブで、「タイトルバー」を選択して、タイトルバーが表示されるようにします。
3. 「コンポーネント設定」タブをクリックします。
4. 「Notes URL」フィールドを選択します。
5. 文字列中のEを0で置きかえます。Eがなく、最初から0になっている場合もあります。MailFSをBorderFrameに置きかえます。結果的に、notes:///0000000000000000/BorderFrame?OpenFramesetとなります(図10を参照)。
   
   
   
   図10. CAE: Lotus Notes URLフィールドの更新
   
   
   
6. OKをクリックします。
7. 左側のペイン内の「Notesメールビュー」で右クリックを行い、「コンポーネントプロパティの編集」を選択します。
8. 「コンポーネント設定」タブをクリックします。
9. 「Notes URL」フィールドを選択します。
10. 文字列中のEを0で置きかえます。Eがなく、最初から0になっている場合もあります。MailFSをBorderFrameに置きかえます。結果的に、notes:///0000000000000000/BorderFrame?OpenFramesetとなります。
11. 「詳細」タブをクリックします。
12. com.ibm.rcp.csiviews.viewpart.threadurlを選択して、削除をクリックします。
13. com.ibm.rcp.csiviews.viewpart.folderaliasを選択して、削除をクリックします。
14. OKをクリックします。
15. ここまでの変更内容を保存するには、メニューから「ファイル」-「保存して閉じる」を選択します。

ページアイコンの設定とアプリケーション名のリネーム

Lotus Domino Designerを使って、以下の手順で進めてください。

1. 16 x 16ドットのPNG形式の画像ファイルを用意します。例えば、notesbook8.ntfのテンプレート内の画像であるtab_notebook_16.pngを参考にしてください。
2. Lotus Domino Designerを開きます。
3. 「リソース」-「イメージ」を選択します。
4. 「イメージリソースのインポート」をクリック(図11を参照)すると、ファイル選択のダイアログボックスが表示されます。ファイル名フィールドで*.pngを入力してOKをクリックすると、png形式の拡張子がついたファイルが表示されます(図12を参照)。このダイアログボックスの「ファイルの種類」では、PNG形式はありませんが、GIF形式の選択で正常にインポートが可能です。
   
   
   
   図11. Lotus Domino Designer: ページアイコンを共有リソースの画像ディレクトリーに追加する
   
   
   
   
   図12. Lotus Domino Designer: PNGファイルを表示させるためのファイル名フィールドの入力
   
   
   
5. Lotus NotesクライアントからComposite Application Editorを開きます。
6. ナビゲータ内の「空白ページ」で右クリックし、「ページプロパティの編集」を選択します。
7. 「ページの設定」タブ内の「ページアイコン」で選択ボタンを押し、先ほど追加したアイコンファイルを選択します(図13を参照)。
   
   
   
   図13. CAE: ページアイコンの編集
   
   
   
8. 次に、アプリケーションの名前を「ページタイトル」フィールドに入れます(図14)。
   
   
   
   図14. CAE: ページタイトルフィールドの編集
   
   
   
9. OKをクリックします。
10. メニューから「保存して閉じる」を選択します。
    

    Lotus Notesクライアントに戻り、個人ジャーナルアプリケーションを開きます。すると、図15のように表示されるはずです。設定したタブアイコンを表示させるには、Lotus Notesの再起動が必要な場合があります。

    
    
    図15. Lotus Notes: 更新したアプリケーションをLotus Notesクライアントで表示したところ
    
    
    

ページアイコンへの参照を設定する

このアプリケーションを他のワークステーションへ移動できるようにするには、ページアイコンへの参照をセットする必要があります。これは、ページアイコンの参照先を適切に解決できるようにする、という意味です。そうすることで、このテンプレートからアプリケーションを新規に作成できるようになります。

Lotus Domino Designerを使って、以下の手順で進めてください。

1. メニューから「アプリケーション」-「開く」を選択し、作成した個人ジャーナルアプリケーションを開きます。
2. 「複合アプリケーション」-「アプリケーション」を選択し、作成済みのNotes Journal Application.xmlファイルを開きます。
3. 中央ペインに「設計」と「ソース」を切り替えるタブがありますが、ここで「ソース」を選択します。
4. <preference name=”com.ibm.portal.PageIcon”> の文字列を探し出します
5. "base:value value"に、ページアイコンのPNGファイル名を、以下のようにセットします。
   <preference name=”com.ibm.portal.PageIcon”>
<base:value value=”Notebook_view16.png” xsi:type=”base:String”/>
</preference>
6. ファイルを保存して終了します。

アクションバーに分割型のアクションボタンを追加する

Lotus Notes 8では、アクションバーのボタンに分割型のアクションボタン機能が追加されました。この分割型のアクションボタンではワンクリックで、デフォルトで設定されたアクションが実行されるほか、ドロップダウンリストからアクションを選択できるようになっています。ひとつのボタンを2つに割って多機能化していることから、分割アクションボタン(分割ボタン)と呼んでいます。

この一例は、メールのボタンに見ることができます。メール画面で「新規」ボタンを押すと、新規メールが作成されますが、ドロップダウンリストをクリックすると、メール以外の新規作成も選択できるようになっています(図16を参照)。

この分岐型のアクションボタンを作成するには、Lotus Domino Designerで以下の手順で操作します。

1. 共有アクションプロパティウィンドウを開きます。
2. 共有アクションのプロパティボックス、あるいは「分割ボタンとして表示」を選択してください（図17を参照）。
   
   
   
   図17. split-アクションボタンの作成
   
   
   

ブックマークタイプの設定

アプリケーションタブからアプリケーションのブックマークを行うと、デフォルトでは、コンポジットアプリケーションXML設定を使った結果、Lotus Notesが、 Notes Remote Procedure Call (NRPC) URLを作成することになります。しかし、このURLへのアクセスは低速であり、かつ、もしURL先が存在しない場合はエラーが発生します。そのため、ブックマークを行うにあたって、Notes URL使うようにするのがよいでしょう。また、この手順を使えば、データベースアイコンがブックマークのアイコンとして確実に使われるようにもなります。

Notes URLへスイッチするためには、コンポジットアプリケーションXMLへプリファレンスを追加する必要があります。Lotus Notesアプリケーションを開き、「アクション」-「アプリケーションの編集」を選択すると、Composite Application Editorが開きますが、このCAEの中で設定ができます。ページ要素から「ページプロパティの編集」を選択します(図18)。

ページプロパティの編集画面の「詳細」タブを選択し、追加ボタンを押し名前としてcom.ibm.rcp.bookmark_level、その値としてselectionを設定します(図19を参照)。

ナビゲータスイッチャーの無効化

デフォルトでは、ナビゲータのタイトルバーにはカレンダーとタスクへの切り替え(スイッチャー)ができるようナビゲータが表示されます。他のコンポジットアプリケーションのXMLプリファレンスにより、これを非表示にすることもできます。

以下の手順で進めてください。

1. Composite Application Editorを起動し、「Notesメールナビゲータ」で右クリックを行い、「コンポーネントプロパティの編集」を選択します。
2. 編集画面の「詳細」タブを選択し、追加ボタンを押します。追加のプリファレンス名としてcom.ibm.rcp.showSwitch、その値としてfalseを選択します(図21を参照)。そして、CAEを保存して閉じます。
   
   
   
   図21. スイッチャーのプリファレンス表示の追加
   
   
   

上に戻る

まとめ

この記事では、今お持ちの既存アプリケーションをカスタマイズしてモダンにする手法をステップバイステップで解説してきました。これで、皆様は様々なアプリケーションをLotus Notes 8のPIMアプリケーション(メール、カレンダー、連絡先、タスク、ジャーナル)のようにする数多くの手段を手に入れたことになります。詳細については、Lotus Notes Composite Application EditorのヘルプやLotus Domino Designer 8.5のヘルプを参照してみてください。

参考文献

• ディスカッション・フォーラムに参加してください。
  
  
• Read the developerWorks article, "What's new in IBM Lotus Notes 8.5."
  
  
• Refer to the IBM Lotus Notes and Domino 8.5 product page.
  
  
• Refer to the IBM Lotus Domino Designer 8.5 Help.
  
  

著者について

この記事を評価する

コメント

上に戻る

目次

• 変換のプロセスについて
• 空の個人ジャーナルアプリケーションから作業開始
• Lotus Domino Designerを使用してコンポジットアプリケーションを新規に作成する
• メールコンポーネントをベースにして新規アプリケーションを作成する
• まとめ
• 参考文献
• 著者について
• コメント