利用webservice(copy.asmx)为sharepoint上传文档要点

  SharePoint对于文档库的操作有很多,但如果需要从非.NET环境的第三方系统操作SharePoint文档,可选项就不多了,常规做法是使用SharePoint提供的Webservice来操作。

     虽然文档库也是列表,但webservice中的Lists.asmx主要用于操作普通数据列表,对于文档库中文档的操作则爱莫能助,这里可以使用Copy.asmx服务。Copy.asmx的设计功能是用来在不同的文档库之间拷贝文档文件,但这并不妨碍使用它来实现上传文档的功能。

     Copy.asmx中实现文档拷贝上传的方法是Copy.CopyIntoItems,其方法声明为:

public uint CopyIntoItems (
    string SourceUrl,
    string[] DestinationUrls,
    FieldInformation[] Fields,
    byte[] Stream,
    out CopyResult[] Results
)

      各项参数的详细说明可以参考MSDN文档:http://msdn.microsoft.com/en-us/library/copy.copy.copyintoitems(v=office.14).aspx

    

     使用此方法时,有一些要点需要注意:

1. SourceUrl与DestinationUrls的格式:

      这两个参数中的url都必须是以http://或者https:// 开头的完整路径,例如:http://127.0.0.1/Shared Documents/javaUpload.txt,其它相对于站点或者相对于文档库的相对路径都是不被支持的,但是url支持空格,Shared Document不必转换为Shared%20Document。

2. SourceUrl与DestinationUrls的值

     DestinationUrls是上传的目标地址数组,对于上传来讲,一般也就只有一个地址,不必上传到多个位置。

     SourceUrl参数是值拷贝的原地址,不得为null或空字符,SharePoint会跟踪这个地址,当查看文档属性的时候会出现拷贝源提示:

This item is a copy of http://127.0.0.1/Shared Documents/javaUpload.txt 
( Go To Source Item | Unlink )

     对于文档上传来讲,当然就没有拷贝源地址,这个时候SourceUrl可以设置为目标地址,也就是拷贝源与拷贝目标地址一致,不过这样会带来一个问题,就是无法通过此拷贝方法来上传并覆盖已经存在的文档,对于需要覆盖文档的情况,可以把SourceUrl设置为http://void(0)这样SharePoint就不会再跟踪拷贝源,查看的时候也不会提示拷贝源,而且可以上传并覆盖已存在的文档。

3. FieldInformation的值

     FieldInformation是文档属性的数组,也就是list的field数组,这里的FieldInformation对象包含5个属性,可以参考MSDN文档:http://msdn.microsoft.com/en-us/library/copy.fieldinformation_members(v=office.14).aspx

    这些参数其中最为重要的是参数为Id、DisplayName、Type、Value,value当然是需要设置的值了,而唯一确定一个字段的属性是Id和DisplayName,SharePoint会首先以Id进行确认,如果没有找到再以DisplayName查找,有的字段只能通过Id查找,因此保险的做法是给Id和DisplayName都赋值,而十分奇怪的是InternalName却似乎没有什么作用,此外Type也是必不可少的参数,如果Type参数设置错误,那么这个字段也是无效的(Note类型可以兼容Text类型)。关于SharePoint服务器端的逻辑可以用Reflector查看,代码位于C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\14\CONFIG\BIN\STSSOAP.DLL中的Microsoft.SharePoint.SoapServer. CopyImpl.此外,字段无法找到的错误既不会返回也不会抛出异常,字段值转换失败的错误则会返回失败代码和错误信息。如果一个字段触发操作失败,则所有的字段值都不会被提交。此时,文档可能已经上传成功,也可能上传失败,这取决于触发异常的位置。

4. CopyResult的值与输出

       当上传文件成功,CopyResult的ErrorCode会返回Success,而ErrorMessage属性会返回null,当目标地址DestinationUr不存在等原因导致上传失败的时候,ErrorMessage属性会返回具体的错误信息,但是,很重要的一点就是:当FieldInformation中的字段找不到的时候,是不会返回任何异常或错误的,ErrorCode返回Success,显示操作已成功。

5. 关于ContentType

      可能是由于ListItem的CopyFieldMask的影响(也可能是其它原因),上传的文档的ContentType总是文档库的默认ContentType,这一属性无法通过FieldInformation进行更改,关于这个问题只有在文档上传成功以后,通过Lists.asmx的UpdateListItem进行更改了,暂时没有找到其它解决办法。

6. 关于LinkToDocument内容类型

      在各种Document的内容类型中有一个特殊的内容类型——LinkToDocument,这个ContentType仅创建对文档的引用链接,而不会产生新的文档,算是各种文档类型的异类了,处理的时候需要多加小心。(Document的ContentTypeId为0x0101;LinkToDocument的ContentTypeId为0x01010A)

       毕竟Copy.CopyIntoItems是为拷贝而设计的,在上传文档的时候还是有诸多不便,使用起来也很是别扭,要想用的舒心,还是得自己动手了。


在 利用上述方法上传文档时遇到一个问题,若一个文档被user1 check out时,利用其它user无法上传,利用user1可以上传,这点是合理的,但是奇怪的是利用user1上传时虽然返回状态是对的,可是并没有真的覆盖文档,相当于上传是无效的,不知道为何,欢迎大家讨论

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值