[转帖]构建联机 Web 部件库

zhuyiwen

<转自: http://www.microsoft.com/china/MSDN/library/Office/sharepoint/SpnorthwindWebparts.mspx>

构建联机 Web 部件库发布日期： 6/1/2004 | 更新日期： 6/1/2004

Nilly Banerjee

Microsoft Corporation

2003 年 8 月





适用于：

Microsoft Windows SharePoint Services

Microsoft Office SharePoint Portal Server 2003

摘要：了解如何创建 Web 部件库并将它作为一个中心区，用于将 Web 部件部署到多个运行 Microsoft Windows SharePoint Services 的服务器。

概述





Microsoft Windows SharePoint Services 提供四种不同类型的 Web 部件库，用于向最终用户提供 Web 部件：



• Web 部件页库 — 特定 Web 部件页上当前使用的所有 Web 部件的列表。 • 站点集合 Web 部件库 — 添加到特定站点集合中的 Web 部件的列表。

• 服务器 Web 部件库 — 添加到特定服务器中的 Web 部件的列表。

• 联机 Web 部件库 — 可从全局服务获得的现成 Web 部件的列表（如可从 Microsoft 网站上获得的联机 Web 部件库）。





当您连接到某个联机 Web 部件库时，Windows SharePoint Services 会向宿主该 Web 部件库的远程服务器发出一个 HTTP 请求。当远程服务器收到该 HTTP 请求时，会使用该请求中包含的标准来执行搜索操作，并发回一个响应。Windows SharePoint Services 随后在“添加 Web 部件”工具窗格中显示搜索结果。当您向页面中添加 Web 部件时，可能会被提示同意最终用户许可协议 (EULA)。当您接受 EULA 之后，Windows SharePoint Services 会从远程服务器检索用来描述 Web 部件的 .dwp 文件，并将 Web 部件添加到页面中。

要点 Windows SharePoint Services 要求联机库 Web 服务可匿名访问。因此，在宿主此服务的远程服务器上，必须在 Microsoft Internet 信息服务 (IIS) 中启用匿名访问。

如果贵组织在多台服务器上运行 Windows SharePoint Services，您可能希望创建一个联机 Web 部件库作为中心区，用于将 Web 部件部署到所有的 SharePoint 站点。将 Windows SharePoint Services 配置为使用其他联机库





要构建联机 Web 部件库，请将 Windows SharePoint Services 配置为指向宿主该库的服务器。为此，请使用 XML 编辑器或文本编辑器来修改位于本地驱动器:\inetpub\wwwroot 目录中的 Web.Config 文件。在 Web.Config 文件中，查找 OnlineLibrary 节点，其外观类似下面的示例：

<OnlineLibrary Url="http://Server/Page"/>

更改 OnlineLibrary 节点中 Url 属性的值，使其指向宿主该 Web 部件库的服务器。

[此贴子已经被作者于2004-7-9 20:50:36编辑过]

zhuyiwen

了解 Windows SharePoint Services 协议



要构建 Web 部件库，您必须了解 Windows SharePoint Services 如何与远程服务器通信。



第 1 步：返回搜索结果



Windows SharePoint Services 和远程服务器之间的第一次信息交换发生在 Windows SharePoint Services 向远程服务器发送搜索信息、之后远程服务器发回 Web 部件列表时。



Windows SharePoint Services 使用带有空 AssetID 查询参数的表单张贴 (form post)，向远程服务器发送搜索信息。远程服务器应配置为处理下表中描述的表单域。















表单域



说明







Keywords



Windows SharePoint Services 发送到远程服务器的搜索术语。对于浏览操作，此域为空。







LCID







当前页面或站点的区域设置 ID。











maxResults







一次返回的结果数量。











startAt







搜索结果中从其开始返回结果的索引。







当远程服务器收到此信息时，它使用自己的搜索逻辑返回 Web 部件：使用关键字按照从 startAt 到 (startAt + maxResults + 1) 的顺序对结果进行排序，并按照以下格式返回结果：<Results count=count>



       <Details xmlns="urn:schemas-microsoft-comffice:AWS">



                   <AssetID>AssetID</AssetID>



                   <Title>Title</Title>



                   <EulaUrl>EulaAssetID</EulaUrl>



                   <EulaVersion>EulaVersion</EulaVersion>



                   <AssetDescription>Description</AssetDescription>



       </Details>



<esults>







下表描述远程服务器返回的属性和元素。















属性或元素



说明











Results







Results 元素应包含一个用于每个 Web 部件的 Details 元素，可在给定的搜索标准下按照从 startAt 到 (startAt + maxResults + 1) 的顺序排序。











Count







远程服务器找到的符合搜索标准的结果总数。











Details







Details 元素描述单个搜索结果。











AssetID







这是所讨论的搜索结果在远程服务器上的唯一标识符。











Title







这是所讨论的搜索结果的标题，它出现在“添加 Web 部件”工具窗格中。











EulaUrl







这是与所讨论的搜索结果相关联的 EULA 在远程服务器上的唯一标识符。如果无需 EULA，则为空。











<FONT face=Verda

zhuyiwen

小结Windows SharePoint Services 提供四种不同类型的 Web 部件库，用于向最终用户提供 Web 部件。您可以根据自己的部署要求来创建自定义的 Web 部件库。您可以根据自己的要求，将 Web 部件库的范围限制在特定页面、站点集合或服务器上，也可以使其在整个部署过程中都可以访问。另外，您可以决定是否要求用户在向 Web 部件页中添加 Web 部件时接受 EULA。<全文完>