关于 团队浏览器->文档 节点 排错的思路

  • Artigo

(English Version) 

 

用户可以通过 团队浏览器（以下简称TE）->TFS服务器名->团队项目名->文档 节点来读取和操作项目文档。这篇文章讨论1)项目文档树形结构是如何在TE中显示出来的，2)几种观察到的错误情形，以及 3)出现错误时如何排查的思路。

当用户登录到TE，或在团队项目节点上进行“刷新”操作时，TE做如下动作：

1． TE调用一个WSS web service https://<WSSServer:port>/sites/<project name>/_vti_bin/Lists.asmx, web method GetListItems。参数定义令WSS递归读取团队项目文档库根路径下所有文件/文件夹记录。调用方法使用的身份是当前使用TE的用户，而不是 TFS 服务用户。

2． WSS web service 返回的响应是一个XML字符串，主要部分就是一个数据集，每条记录对应文档库中的一个文件或文件夹。记录包括一些描述该文件/文件夹的WSS属性。

3． TE取XML数据集每条记录的ows_FileRef属性（文件/文件夹的路径）建立树形结构。对每个”\”结尾的记录，添加一个文件夹节点；对每个非”\”结尾的数据，按照路径添加到相应文件夹节点下。如路径为“\folderA\folderB\fileC.doc” 的项目，就添加到文件夹folderA 下的文件夹folderB下，命名为fileC.doc。这里的实现很直接。

现在来看几种出问题的情形。

l “文档”节点标了个红叉，下面没有数据. 因为从WSS web service取数据的请求是使用当前用户身份发出的，因此如果当前用户没有访问该WSS文档库的权限，就没有数据返回。 这是TFS新用户经常提出的问题。 TFS中的项目团队和权限定义仅覆盖版本控制和任务项管理。为了让团队成员能够访问团队项目站点及文档库，项目经理需要在WSS站点中额外定义用户的访问权限。同样的，为了让项目成员可以访问到各种报表，项目经理还需要在reporting service站点定义相应权限。 

另一个可能的原因是目标WSS服务当前（对本机）不可用。这两种情形使用web浏览器访问一下WSS站点就可以验证。

l 文档树出现错误。这种情况很少见。有一次用户报告说TE中的文档树是错误的。有一个文件夹丢失了，文件夹中的文档都被错误地放置在文档库根目录下面。检查WSS web method返回的数据，我们发现记录集中所有的文件\文件夹都在，唯独缺少丢失的文件夹对应的记录。这样TE在建立文档树的时候就没有生成该文件夹节点。文件夹下的文档无处可放，就直接放在了根路径下。最终原因是WSS数据库中该文件夹对应的记录不知何故丢失了。补足这一记录，问题就解决了。

顺便说一句，最初看起来确实像是TE出了问题。WSS数据库记录丢失的情况下，WSS自己的站点似乎知道如何处理。WSS站点中相应的文件和文件夹都显示在正确的位置。

l 一些文件 / 文件夹从文档树中丢失了. 您的WSS文档库是不是存放了超过一万条记录呢？TE向WSS请求数据时，参数“RowLimit” 设定为 10,000。因此文档树最多显示一万条记录（包括文件和文件夹）。TE2005和2008中这个数量无法通过配置进行修改，将来的版本或许会提高限额。如果您的文档库超过一万条记录，那么不要从TE看文档了，还是用WSS站点吧。

当到TE->文档 节点出现错误的时候， 建议按照如下顺序排错：

1. 在同一台计算机上，使用同一登录帐户，通过web浏览器打开项目portal站点，看是否能够正常浏览TE无法访问的内容。如果也出现了问题，就从WSS方面入手。否则继续往下；

2. 抓取TE与WSS之间的网络通讯包（是用MS network monitor,wireshark, fiddler等工具.）， 检查围绕/sites/<project name>/_vti_bin/Lists.asmx的请求和响应。请求是否发送向正确的server？参数是否正确？响应是否包含正确的数据集？

3. 如果步骤2中的WSS响应看起来没有问题，那多半就是TE出状况了。可以到MSDN论坛看看，或者联系微软技术支持。

Comments