フィーチャーの更新サイトを呼び出すウィジェットの添付ファイルを作成する
ウィジェットの extension.xml ファイルには、更新サイトに対するポインタとフィーチャーのインストールまたは更新方法の指定が記載されたインストールマニフェスト installfeature スニペットが含まれます。ここで説明するプロセスは、Notes® の [フィーチャーとプラグイン] ウィザードを使用して簡素化することができます。
このタスクについて
更新サイトを呼び出してユーザーにフィーチャーをプロビジョニングする際に使用するウィジェットの extension.xml 添付ファイルを作成するには、次の手順を実行します。
注: [ウィジェットの構成を開始] ツールバーボタンには [フィーチャーとプラグイン] オプションが含まれています。このオプションでは、Notes® クライアントプラグイン導入ウィジェットの作成プロセスを簡便化するように設計されたウィザードが順番に開始されます。ウィザードに従ってウィジェット定義と extension.xml 作成プロセスを進めます。詳しくは、Notes® ユーザーヘルプの「How do I configure a Features and Plugins deployment widget?」を参照してください。
XML 定義のサンプルを以下に示します。
extension.xml ファイルの最初のセクションにある項目の説明です。この例では、NSF ベースの更新サイトの site.xml ファイルを参照します。
デフォルトで、ウィジェットによるフィーチャーの導入では、認証の必要がない一般向けの更新サイトのみが使用できます。ただし、ユーザーアカウントを使用して、ユーザー認証が必要な更新サイトへのアクセスを設定することもできます。
shared="true" がウィジェットの .XML のインストールマニフェストに設定されている場合、プラグインは Notes_install_dir\framework\shared\eclipse にインストールされます。そのディレクトリーへの書き込みアクセスがない場合、プラグインは Notes_install_dir\data\workspace\applications にインストールされます。
注: この例で使用されているサンプル extension.xml ファイルは入手できます。関連情報のリンクを参照してください。
- xml version = 内部設定 (サンプルの記述をそのまま使用します)
- encoding = 内部設定です (サンプルの記述をそのまま使用します)
- webcontextConfiguration version = 内部設定 (サンプルの記述をそのまま使用します)
- palleteItem id = 内部 ID の設定 (サンプルに記述されている名前空間/ID 形式に準拠する必要があります。この値はパレットアイテムごとに一意でなければなりません)
- imageURL = マイウィジェットサイドバーに表示されるウィジェットグラフィックが存在する URL (値を指定しない場合は、デフォルトのグラフィックが使用されます)
- providerID = ウィジェットの目的を表します (フィーチャーをデプロイするウィジェットの場合は、サンプルの記述をそのまま使用します)
- title = マイウィジェットサイドバーパネルに表示されるウィジェット名
- url = 更新サイトと site.xml の場所を示すポインタ。更新サイトが Domino® サーバー上の NSF ベースの更新サイト (updateSite.nsf など) に存在する場合は NRCP プロトコルを使用して URL を指定できます。更新サイトが HTTP サーバー上に存在する場合は、HTTP プロトコルを使用して URL を指定できます。
手順
extension.xml ファイルを作成します。以下の XML サンプルを参考にしてください。
サンプル XML
太字の項目は、使用するフィーチャーに応じてカスタマイズする必要のあるフィールドです。
<?xml version="1.0" encoding="UTF-8"?>
<webcontextConfiguration version="1.1">
<palleteItem id="com.mycompany.xyz.extensions.featureABX" imageUrl=""
providerId="com.ibm.rcp.toolbox.prov.provider.ToolboxProvisioning"
title="Comp XYZ Custom Plugin"
url="nrpc://WidgetCatalogServer.abx.com/updatesite.nsf/site.xml">
<preferences>
</preferences>
<data>
<installManifest>
<![CDATA[
<install>
<installfeature description="Comp XYZ Custom Plugin" id="Test_Feature_ABX" name="Test Feature ABX">
<requirements>
<feature download-size="10" id="Test_Feature_ABX" match="perfect" shared="true" size="10" version="1.0"/>
<requirements>
</installfeature>
</install>
]]>
</installManifest>
</data>
</palleteItem>
</webcontextConfiguration>