建立小組件附件檔以呼叫功能的更新網站

小組件的 extension.xml 檔案會包含安裝資訊清單 installfeature Snippet、更新網站的指標,及如何安裝或更新功能的規格。您可以使用 Notes® 中的「功能及外掛程式」精靈,來簡化這裡所說明的程序。

執行這項作業的原因和時機

請執行這些步驟來建立小組件的 extension.xml 附件檔,您可利用此檔案來呼叫更新網站及供應功能給使用者。

註: 「開始配置小組件」工具列按鈕包含「功能及外掛程式選項」。此選項會啟動精靈順序,其設計來簡化 Notes® 用戶端外掛程式部署小組件的建立程序。此精靈會逐步引導您完成小組件定義及 extension.xml 建立程序。如需詳細資料,請參閱 Notes® 使用者說明中的「如何配置功能及外掛程式部署小組件?」。

下列為一些範例 XML 定義:

其中說明 extension.xml 檔案第一個區段中的項目。

本範例參照 NSF 型更新網站中的 site.xml 檔案。

依預設,僅不需要認證的公用更新網站可用來進行功能部署 (使用小組件) 不過,您可以使用帳戶來配置更新網站的存取權 (該網站需要使用者認證)

假設小組件的 .XML 的安裝資訊清單中已設定 shared="true",則外掛程式會安裝至 Notes_install_dir\framework\shared\eclipse。如果對該目錄沒有寫入權,外掛程式會安裝至 Notes_install_dir\data\workspace\applications

註: 您可以取得此範例所使用的範例 extension.xml 檔案;請參閱相關資訊鏈結。
  • xml 版本 = 內部設定,使用與範例中所指定相同的設定
  • encoding = 內部設定,使用與範例中所指定相同的設定
  • webcontextConfiguration version = 內部設定,使用與範例中所指定相同的設定
  • palleteItem id = 內部 ID 設定,此項目必須符合範例中指定的名稱空間/ID 格式 - 每一個 Pallette 項目的值必須是唯一的
  • imageURL =「我的小組件」側邊工具列中出現之小組件圖形所位於的 URL,如果未指定任何值,則會使用預設圖形
  • 提供者ID = 陳述小組件的目的,對於部署功能的小組件,您必須使用與範例中所指定相同的設定
  • tilte = 出現在「我的小組件」側邊工具列畫面中的小組件名稱
  • 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>