本文へジャンプ

Lotus > Lotus Developer Domain > 
   
 

IBM Workplace Managed Client Developer Toolkitを使用したアプリケーションの作成

 
   
 
コンテンツ
必要条件
IBM Workplace Managed Client Developer Toolkitのインストール
単純なアプリケーションの作成
アプリケーションのテスト
アプリケーションのデプロイ
Workplace Managed Client の起動
まとめ
リソース
筆者について(原文のまま)

Richard Holland, Software Development Engineer, IBM

レベル:上級
原文の掲載:2005年10月18日
更新日:2006年07月07日更新
原文はこちら (US)


この記事では、IBM Workplace Managed Client Developer Toolkitを使用して基本的なアプリケーションを作成するプロセスを解説します。


Workplace Managed Client Developer Toolkitは、Eclipse 3.01以降用のプラグインのセットです。IBM Workplace Managed Client用のアプリケーションを開発、テスト、デプロイする開発者のために、ウィザード、ナビゲーター、ビルダー、およびその他のツールが含まれています。

この記事では、Workplace Managed Client Developer Toolkitを使用して基本的なアプリケーションを構築する際の手順について説明します。ツールキットのウィザードを使用し、デフォルト値をそのまま受け入れることで、コードを1行も書かずに、単純なアプリケーションを作成していきます。

この記事には、Workplace Managed Client Toolkitを使用するときの主な手順として、次の内容が含まれています。

  1. [Application Wizard] および [Page Project Wizard] を使用してWorkplace Managed Clientアプリケーションを作成する。
  2. Eclipseから起動したWorkplace Managed ClientでWorkplace Managed Clientアプリケーションを直接起動し、テストする。
  3. [Export Wizard] を使用してデプロイ・セットを作成することにより、Workplace Managed ClientアプリケーションをWorkplace Collaboration Servicesサーバーにデプロイする。

この記事は、WindowsでEclipseが使用されていることを前提として書かれています。また、以下の手順を開始する前に「必要条件」セクションを参照し、ツールキットが正しくインストールおよびセットアップされていることを確認してください。


必要条件

IBM Workplace Managed Client Toolkitは、Eclipse 3.0.1以降、IBM Rational Application Developer、またはIBM Rational Software Architect 6.0以降と共に使用できます。ベースとなるEclipse Integrated Development Environment (IDE) と共にツールキットを使用するには、最初に次のフィーチャーをEclipse IDEに追加する必要があります。

  • Eclipse Modeling Framework Software Development Kit (SDK)
  • Graphical Editing Framework SDK
  • Visual Editor SDK

これらのフィーチャーはEclipse.orgの更新サイト (US)から入手できます。フィーチャーをインストールするには、次のように操作します。

  1. Eclipse Workbenchで [Help] - [Software Updates] - [Find and Install] を選択します。
  2. [Search for new features to install] ラジオボタンを選択し、[Next] をクリックします。
  3. [Eclipse.org update site] を選択し、[Next] をクリックします。
  4. 表示されたリストで必要なフィーチャーを選択します。
  5. 画面の説明に従って、フィーチャーのインストールを完了させます。

Eclipse IDEの設定が完了すると、Workplace Managed Client Toolkitをインストールする準備が整います。


上に戻る

IBM Workplace Managed Client Developer Toolkitのインストール

Workplace Managed Client ToolkitはEclipse更新サイトとして提供されます。Workplace Managed Client Toolkitをインストールするには、次の手順に従ってください。

  1. システム上の適切な場所 (例: C:\WMCToolkit) にサイトをunzipします。
  2. EclipseまたはIBM Rational Application Developer IDEを開始します。
  3. [Help] - [Software Updates] - [Find and Install] を選択します。
  4. [Search for new features to install] ラジオボタンを選択し、[Next] をクリックします。
  5. [New Local Site] ボタンをクリックします。
  6. 手順1でツールキット更新サイトをunzipした場所へ移動します。[Sites to Search] リストボックスでサイトが選択されていることを確認し、[Next] をクリックします。
  7. [Workplace Managed Client Toolkit] を選択し、[Next] をクリックします。
  8. 画面に表示された説明に従って、インストールを完了させます。

メモ:この記事で説明する例では、アプリケーションを作成および実行するために、Workplace Managed Client ToolkitにWorkplace Collaboration Servicesサーバーは必要ありません。しかし、Workplace Managed Clientは、実行前に少なくとも1回、サーバーによって認証される必要があります。ユーザーは、最初にクライアントをインストールするため、およびデプロイメント手順を完了させるために、Workplace Collaboration Servicesサーバーへアクセスしなければなりません。


上に戻る

単純なアプリケーションの作成

このセクションでは、Workplace Managed Clientの一部である [Application Wizard] と [Page Project Wizard] を使用して、単純なWorkplace Managed Clientアプリケーションを作成します。何回かのクリック操作と、ウィザードのデフォルト値を受け入れることで、単純なアプリケーションをどのように作成できるのかを理解します。

  1. Eclipseで [File] - [New] - [Project] を選択して開始します。[New Project Wizard] が表示されます (図1参照)。

    図1. [New Project Wizard]

  2. [IBM Workplace] - [Workplace Managed Client Application Project] を選択し、[Next] をクリックします。[New IBM Workplace Application Wizard] が表示されます (図2参照)。

    図2. [New IBM Workplace Application Wizard]

  3. [Project Name] フィールドに「com.foo.helloworld」と入力します。これは、アプリケーション・プロジェクトの名前です。この名前は [Display name] フィールドにも入力されますが、手順5で変更します。
  4. 場所は [Project Contents] 領域で自動的に指定されます。この記事の目的に合わせて、アプリケーションのデフォルトの場所、つまりEclipseワークスペースをそのまま使用することをお勧めします。
  5. [Display Name] フィールドに「My Hello World Application」と入力します。表示名はアプリケーションのタイトルとなります。この表示名は、IBM Workplace Managed Clientの切り替えバーとアプリケーション実行時のクライアントの最上部のバナーに表示されます。
  6. [Browse] ボタンをクリックします。[Select Icon] ダイアログが表示されます (図3参照)。

    図3. [Select Icon] ダイアログ

    [Select Icon] ダイアログには、Workplace Managed Client Toolkitに含まれる5つのデフォルト・アイコンが表示されます。アイコンは、クライアント切り替えバーでアプリケーションの表示名の上に表示されます。
  7. アプリケーションのアイコンとしてbook.pngを選択します。アイコンを選択せず、アイコン用のフィールドを空にすることもできます。この場合は、デフォルトのアイコン (generic.png) が使用されます。
  8. [Create Page Layout project] チェックボックスは選択した状態にしておきます。このチェックボックスはデフォルトで選択されていて、アプリケーションのページ・プロジェクトが自動的に作成されます。次に、[Feature properties] ボタンをクリックします。アプリケーション・ウィザードに [Feature properties] セクションが表示されます(図4参照)。

    図4. [Feature Properties]

    この例では、デフォルトのフィーチャー・プロパティーを受け入れ、[Feature properties] ボタンをもう一度クリックして [Feature properties] セクションを閉じます。
  9. [Next] をクリックします。[Page Layout Project Wizard] が表示されます (図5参照)。

    図5. [Page Layout Project Wizard]

    [Project Name] フィールドには、デフォルトで、アプリケーションとページ・プロジェクトの名前が含まれています。この例では、「com.foo.helloworld.MainPage」です。ページ・プロジェクトのこのデフォルトの名前を受け入れます。デフォルトの場所も自動的に指定されます。この例では、デフォルトの場所を受け入れます。
  10. グレー表示された [Application Project] フィールドには、アプリケーション・プロジェクトの名前が入力されています。このフィールドは無効になっていて、編集できません。[Application Project] フィールドの下には、ページ・レイアウトに関するボタンが並んでいます。対応するレイアウト・ボタンをクリックして、目的のレイアウトを選択します。ここで選択したレイアウトに応じて、クライアントで実行したときのアプリケーションの外観とビューの数が決められます。
  11. [Automatically create default views] チェックボックスは選択した状態にしておきます。これを選択すると、アプリケーション・ウィザードによってアプリケーションのビューが自動的に作成されます。作成されるビューの数は、選択したレイアウトによって決まります。
  12. [Finish] をクリックし、アプリケーションを作成してウィザードを閉じます。

完了すると、単純なWorkplace Managed Clientアプリケーションが作成され、Eclipseワークスペースで利用可能になります。アプリケーションをより簡単に表示するために、Workplace Managed Client Toolkitには [Workplace Managed Client Application Navigator] と呼ばれる新しいビューが用意されています。このビューには、[Application Wizard] を使用して作成したプロジェクトとWorkplace Client Applicationプロジェクトに含まれるファイルが表示されます。

[Application Navigator] にアプリケーションを表示するには、[Window] - [Show View] - [Other] を選択します。[Show View] ダイアログが表示されます (図6参照)。

図6. [Show View] ダイアログ

[WMC Tools] の [WMC Application Navigator] を開きます。[Application Navigator] がワークスペースに表示されます (図7参照)。

図7. [Application Navigator] に表示された単純なアプリケーション


図からわかるように、単純なWorkplaceアプリケーション・プロジェクトを構成するすべてのファイルが [Application Navigator] に表示されています。ページ・プロジェクトとビュー・プロジェクトは、整った階層で表示されます。


上に戻る

アプリケーションのテスト

これまでに、単純なアプリケーションを作成して [Application Navigator] に表示しました。アプリケーションは、クライアントで直接起動し、テストできる状態になっているので、アプリケーションの外観を確認してみましょう。アプリケーションは、Eclipseワークベンチから起動されたIBM Workplace Managed Client上で直接実行することができます。これらの手順に進む前に、IBM Workplace Managed Clientのコピーがマシンにインストールされ、アプリケーションが作成されていることを確認してください。

IBM Workplace Managed Clientでアプリケーションを直接テストするには、最初にEclipseリッチクライアント・プラットフォーム(RCP) の正しいプラグインと正しいJava Runtime Environment (JRE)をワークベンチでセットする必要があります。これらは、Eclipse起動設定によって参照されます。また、クライアントで直接アプリケーションを表示および起動するために、これらを適切に設定する必要があります。

ターゲット・プラットフォームを設定するには:

  1. Eclipseで [Window] - [Preferences] を選択し、ワークベンチの設定を開きます。[Plug-in Development] オプションを選択し、左側のツリー・ペインで [Target Platform] オプションを選択します。デフォルトでは、これは [Eclipse plug-ins] に設定されています。[Browse] をクリックします。
  2. Workplace Managed Client Eclipseプラグインに移動します。デフォルトでは、C:\Program Files\IBM\Workplace rich client\eclipse にインストールされています。または、ご使用になっているWorkplace Managed Clientの場所に移動します。[Apply] をクリックします。

正しいJava Runtime Environmentを追加するには:

  1. 左側のツリー・ペインで [Java] - [Installed JREs] を選択します。[Add] をクリックします。
  2. [JRE Name] フィールドに、JREの名前を入力します (例: RCP JRE)。次に、JREのホームを指定するために [Browse] をクリックします。
  3. Workplace Managed Clientに含まれるEclipseフィーチャーに移動します。デフォルトでは、C:\ProgramFiles\IBM\Workplacerichclient\rcp\eclipse\features\com.ibm.rcp.eclipse.platform.win32.feature_3.0.0.2にインストールされています。または、ご使用になっているWorkplace Managed Clientの場所に移動します。[OK] をクリックします。

これで、ターゲット・プラットフォームとJREが正しく設定されました。クライアント上で直接Workplace Managed ClientアプリケーションをテストできるようEclipseがセットアップされ、準備が整いました。

Workplace Managed Clientアプリケーションを実行するには:

  1. Workplace Managed Clientの [Application Navigator] で [com.foo.helloworld] アプリケーション・プロジェクトを選択します。
  2. 右クリックして [Run] - [Run] を選択し、[Create, Manage, and Run Configurations] ダイアログボックスを開きます (図8参照)。

    図8. [Create, Manage, and Run Configurations] ダイアログ

  3. 左側のツリー・ペインで [IBM Workplace Managed Client] オプションを選択します。次に、[New] ボタンをクリックします。
  4. 図9 に示すように、アプリケーション用の [Create, Manage, and Run Configuration] ダイアログが表示されます。

    図9. [Run Configuration] ダイアログ

  5. [Name] フィールドに「HelloWorldRunConfig」と入力します。
  6. [Command Line Settings] セクションで、[JRE] フィールドのドロップダウンリストから [RCP JRE] を選択します。
  7. [VM Arguments] フィールドと [Program Arguments] フィールドでは、デフォルトの設定をそのまま使用します。これらのフィールドには、クライアントを起動するための正しいパスとフラグが入力されています。次に、[Apply] をクリックし、[Run] をクリックします。
  8. 少し経つと、IBM Workplace Managed Clientが開始され、ログイン・ダイアログボックスが表示されます。クライアントの起動に必要なログイン情報を入力します。

クライアントが起動すると、作成した単純な「Hello World」アプリケーションがクライアント上で直接実行されるようすを見ることができます (図10参照)。アプリケーションの表示名とアイコンが、切り替えバーに表示されています。

図10. クライアントで直接実行された「Hello World」アプリケーション



上に戻る

アプリケーションのデプロイ

単純なアプリケーションをローカルで作成し、テストした後は、最後の手順として、アプリケーションをIBM Workplace Collaboration Servicesサーバーにデプロイします。デプロイ・セットの作成には、Workplace Managed Client Toolkitの [Export Wizard] を使用します。デプロイ・セットには、アプリケーションをIBM Workplace Collaboration Servicesサーバーにプロビジョニングするために必要なすべてのファイルが含まれます。次の手順に進む前に、Workplace Collaboration ServicesサーバーとIBM HTTP Serverに対して管理者のアクセス権を持ち、プロビジョニング・コンポーネントがWorkplace Collaboration Servicesサーバーに正しくインストールされていることを確認してください。この詳細については、記事の最後にある関連トピックのセクションを参照してください。また、ご使用になるマシンにIBM Workplace Managed Clientがインストールされていることを確認してください。

デプロイ・セットの作成

デプロイ・セットを作成するには:

  1. Eclipseで [File] - [Export] を選択し、[Export Select] ダイアログボックスを開きます (図11参照)。

    図11. [Export Select] ダイアログボックス


  2. [IBM Workplace Managed Client Deployable Set] オプションを選択します。次に、[Next] をクリックします。[IBM Workplace Managed Client Deployable Set] ウィザードが表示されます (図12参照)。

    図12. [IBM Workplace Managed Client Deployable Set] ウィザード


  3. アプリケーションのフィールドで "com.foo.helloworld" アプリケーションを選択します。
  4. [Browse] をクリックし、デプロイ・セットを作成する場所を選択します (例: C:\myexportedapp)。次に、[Finish] をクリックします。
  5. デプロイ・セットの作成中は、エクスポートの進行状況を示すバーが表示されます (図13参照)。

図13. エクスポートの進行状況を示すバー


エクスポート・ウィザードによってデプロイ・セットが作成されると、デプロイメント手順が完了します。

Workplace Managed Clientアプリケーションのデプロイとプロビジョニング

前のセクションの手順4で指定した場所に移動します。この場所に、デプロイ・セットが作成されています。デプロイ・セットは次のファイルとディレクトリーで構成されています。

名前説明
DeployInstructions.txtデプロイメント・プロセスの詳細な指示と説明が含まれています。
DeployScript.xmlアプリケーションのPortal PageとPortletを作成するxmlaccessスクリプト。
Sitexmlfragment.xmlアプリケーションのフィーチャーの詳細が含まれています。この内容は、HTTPサーバー上のsite.xmlファイルを更新するために使用されます。
Features directoryアプリケーションのフィーチャーが格納されます。
Images directory アプリケーションのアイコンが格納されます。
Plugins directory アプリケーションのプラグインが格納されます。

エディターでDeployInstructions.txtファイルを開き、詳細説明に従ってデプロイメントを完了させます。

  1. デプロイ・セットで提供されたXMLAccessスクリプト (DeployScript.xml) を使用して、Workplace Managed Clientアプリケーションを表すPortal PageとPortletをWorkplace Collaboration Servicesで作成します。
  2. sitexmlfragment.xmlファイルの内容を使用して、HTTPサーバー上でsite.xmlファイルを更新し、アプリケーション・フィーチャーを追加します。
  3. アプリケーションのフィーチャー、プラグイン、アイコンをプロビジョニング・サーバーにコピーします。


上に戻る

Workplace Managed Client の起動

前述の手順を正しく実行すると、サーバーからWorkplace Managed Clientアプリケーションをプロビジョニングする準備が整います。

Workplace Managed Clientを開始すると、Workplace Managed Clientはサーバーからアプリケーションをダウンロードします。クライアントが起動されると、MessagingやLotus Notesなどのデフォルトのクライアント・アプリケーションと共に、「Hello World」アプリケーションが切り替えバーに表示されます。図14を参照してください。

図14. プロビジョニングされたアプリケーションのクライアントでの表示



上に戻る

まとめ

この記事では、Workplace Managed Client Toolkitを使用して、IBM Workplace Managed Client用アプリケーションの開発、テスト、およびデプロイを大幅に簡素化する方法を解説しました。開発者あるいはEclipseやJavaを初めて使用するユーザーは、ウィザードの簡単な手順に従い、ウィザードから提供されるデフォルトを受け入れるだけで、アプリケーションを迅速に作成し、テストおよびデプロイすることができます。この記事では、開始方法と各ウィザードの実行方法の基本手順を述べるにとどまりました。Workplace Managed Client Toolkitを使用して、より高度なアプリケーションを作成したり、複雑な処理を実行することが可能です。これらの機能については、Workplace Managed Client Toolkit関連の記事で解説されています。このToolkit以外にも、IBM Workplace Collaboration Services API Toolkitなど多数のAPIがあります。これらのAPIを使用してメールやInstant Messaging用などのパブリックなAPIおよびSPIを提供することで、アプリケーションをさらに拡張できます。


上に戻る

リソース


上に戻る

筆者について(原文のまま)

Dick McCarrick is a content developer for developerWorks Lotus (formerly the Lotus Developer Domain) and developerWorks Workplace. Previously he was a member of the Domino/Notes Documentation team for over 11 years, playing a variety of roles in documenting many major components of Domino and Notes. He also wrote the occasional article for Iris Today (including Ask Professor INI) before joining the Notes.net/Lotus Developer Domain team permanently in 2002. In his spare time, Dick's leisure activities include running, fishing, woodworking, and reading about the natural sciences. An avid astronomer, he's former director of the Bridgewater (Mass.) State College Observatory. Dick lives in Vermont.

上に戻る