建立小組件附件檔以呼叫功能的更新網站
小組件的 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>