小組件型錄選項及存取權

型錄文件

在型錄中，每一個小組件都是以包含下列元素的 Notes® 文件來代表。

• 顯示在型錄文件的小組件圖形

  註： 您可以使用預設圖形，指定要在型錄文件中顯示的另一個圖形。不過，您針對型錄文件指定的圖形對「我的小組件」側邊工具列畫面中使用的小組件縮圖沒有效果。使用 imageUrl 變數來指定 .XML 檔案附件中的小組件縮圖。

• 標題、說明及詳細資料

  使用預設小組件名稱或指定不同的型錄文件標題。使用「說明」及「詳細資料」欄位來說明小組件。

• 種類

  根據小組件種類分組（例如小組名稱或工作）來控制小組件的使用者存取權。這是您指定哪些使用者有權存取哪些小組件的方式。「種類」原則或喜好設定容許其存取特定種類名稱之小組件的使用者，將自動隨著那些小組件一起供應。

• 平台

  選擇性地指定平台類型，例如 Sametime®_version 或 Notes®_version。

• 類型

  選擇性地指定小組件類型，例如僅限內容類型、僅限辨識器、元件、功能或外掛程式，或任何組合。您可以使用「類型」作為在型錄視圖中排序小組件顯示畫面的方式。

• XML 延伸附件檔

  這包含小組件 XML 本身，用來通知用戶端當小組件供應給使用者時要執行什麼作業，例如從具名的更新網站部署外掛程式，或安裝小工具。

如果您要使用型錄作為 XPage 應用程式，則已配置為執行此作業的使用者可以「分級」、「標記」或「加註」小組件文件。

型錄視圖

型錄是隨著下列視圖一起提供：

• 所有小組件
• 依作者
• 依種類
• 依類型

有數個其他「管理」型錄視圖選項可用。

如果您要使用型錄作為 XPage 應用程式，則型錄具有已展開的視圖及搜尋功能。您可以依作者、種類、類型來檢視小組件型錄中的項目，或就是檢視所有小組件。您可以顯示特定產品的小組件，例如 HCL Notes® 或 HCL Sametime®。瀏覽小組件型錄的同時，可以將註解、標記及分級新增至小組件。

型錄存取權

管理員可以使用 Notes® 應用程式 ACL 及原則或喜好設定的組合，根據使用者類型來指派型錄存取權。

• 使用型錄應用程式 ACL

  具有型錄的讀取權及寫入權並且已指派 [WidgetAuthor] 角色的使用者，可以建立及編輯型錄中的小組件。他們可以變更或新增小組件種類至型錄文件，這份文件與原則或喜好設定搭配使用時，可以強制部署至特定的使用者或群組。他們也可以建立、編輯或移除小組件，以及可以從「我的小組件」側邊工具列畫面發佈新的小組件至型錄。

  註： 對型錄具有「編輯者」存取層次或更高存取層次，並且已指派 [Admins] 及 [WidgetAuthor] 角色的使用者，可以建立、編輯及移除型錄中的小組件。
  註： 如果在型錄 ACL 中指派給您 [Admins] 角色，且未在本端抄本中提供您「管理員」功能，則可能需要在本端抄本的 ACL 中啟用「在抄本之間強制執行一致存取權」。
• 使用原則或 plugin_customization.ini 檔案喜好設定

  管理員可以使用原則來控制各種「小組件及即時文字」及型錄存取權設定。如果在伺服器所管理的環境外使用「小組件及即時文字」，則在 plugin_customization.ini 檔案中有相等的設定。例如，管理員可以根據種類來控制小組件部署。種類是建立在型錄中，但是藉由使用者原則或喜好設定來管理。特定小組件可以根據給定的小組件所在的種類及已指派給給定的使用者的種類，來部署至特定使用者。

型錄動作按鈕

型錄傳統視圖包含下列動作按鈕：

• 匯入
  此動作可讓管理員輕鬆地依據小組件 XML 檔案來建立小組件文件。如果小組件為 OpenSocial 小組件類型，則「匯入」動作可以匯入小組件的 Proxy 資料及 OAuth 資料。會使用個別檔案來儲存小組件定義、Proxy 規則及 OAuth 資訊，如下所示：

  • 小組件 XML 會併入名稱為 widget_name.extension.xml 的檔案中。
  • Proxy 規則會併入名稱為 widget_name.proxy.xml 的檔案中。
  • OAuth 資訊會併入名稱為 widget_name.oauth.xml 的檔案中。

  當選取「匯入」動作時，管理員需要瀏覽以取得要匯入的小組件 XML 檔案。「匯入」動作將自動在相同的目錄中尋找 Proxy 及 OAuth 檔案。

  下列是 Proxy 定義檔的範例。您可以指定小工具 Proxy 規則，以及內容 Proxy 規則。小工具元素的 ContentProxy 屬性是用來識別它是小工具 Proxy 規則，還是內容 Proxy 規則。

  <proxyrules>

  <gadget url="http://server.com/directory/GadgetFile.xml">

  <allow ip="9.6.1.0/255.255.255.0,9.6.1.1/255.255.255.0" /><!-- Multiple values are separated by comma -->

  <deny ip="9.6.0.0/255.255.0.0,9.6.1.4" /><!-- Multiple values are separated by comma -->

  <ProxyRule url="*" actions="GET,POST,PUT,HEAD,DELETE" headers="*" mime_types="" cookies=""></ProxyRule><!-- can be multiple-->

  </gadget>

  <gadget ContentProxy="true" url="http://server.com/directory/GadgetFile.xml">

  <allow ip="9.6.1.0/255.255.255.0,9.6.1.1/255.255.255.0" /><!-- Multiple values are separated by comma -->

  <deny ip="9.6.0.0/255.255.0.0,9.6.1.4" /><!-- Multiple values are separated by comma -->

  <ProxyRule url="*" actions="GET,POST,PUT,HEAD,DELETE" headers="*" mime_types="" cookies=""></ProxyRule><!-- can be multiple-->

  </gadget>

  </proxyrules>

  下列是 OAuth 定義檔的範例。所有 OAuth2 資訊都定義在 OAuth2 元素下。所有 OAuth1.0a 資訊都定義在 OAuth1a 元素下。多個 OAuth 服務可以定義在相同的 OAuth 定義檔中。

  <App ID="http://server.com/directory/GadgetFile.xml">

  <OAuth2 ServiceName="OAuth2ServiceName"

  AllowModuleOverides="false"

  OAuth_Authorization_URI="http://server.com/oauth2/endpoint/provider/authorize"

  OAuth_Access_Token_URI="http://server.com/oauth2/endpoint/provider/token"

  Consumer_Key="key"

  Consumer_Secret="secret"

  Client_Type="CONFIDENTIAL"

  Grant_Type="AUTHORIZATION_CODE"

  Client_Auth_Type="STANDARD"

  Use_Authorization_Header="false"

  Use_Url_Parameter="true"

  Shared="true"

  />

  <OAuth1a ServiceName="OAuthServiceName"

  OAuth_Request_Token_URI="request token"

  OAuth_Authorization_URI="http://server.com/oauth/endpoint/authorize"

  OAuth_Access_Token_URI="http://server.com/oauth/endpoint/token"

  Consumer_Key="key"

  Signature_Method="RSA-SHA1"

  Consumer_Secret="secret"

  Include_Body_Hash="true"

  />

  </App>

• 開啟

  此動作容許您開啟並檢視選取的型錄文件，好讓您檢視並選擇性地將它新增至「我的小組件」側邊工具列畫面。如果您具有該文件的編輯權限，則也可以開啟它進行編輯。

• 新增小組件至型錄

  使用此動作，可以將小組件、內容類型或辨識器新增至型錄。這個動作會開啟一個對話框，您可以在其中附加 .XML 檔案，以及新增標題、種類名稱 (選用)、類型指定、簡要說明，以及詳細說明。

  註： 對於 Notes® 用戶端，若要在「我的小組件」側邊工具列畫面的特定小組件型錄中自動建立新的文件（如果原則或喜好設定容許您執行此作業的話），您可以在「我的小組件」側邊工具列畫面中用滑鼠右鍵按一下小組件，然後選取「發佈至型錄」。

  當您將型錄當作 XPage 應用程式執行時，視圖會包含「新增小組件」動作按鈕。使用此動作，可以將小組件、內容類型或辨識器新增至型錄。