通过WebService操作SharePoint列表数据
通过Webservice add/update/delete SharePoint的列表数据,当然需要使用Lists.asmx 服务了,此服务为增删改只提供了一个方法UpdateListItems,此方法的声明非常简单:
public XmlNode UpdateListItems (
string listName,
XmlNode updates
)
对于此方法的说明可以参考MSDN:
http://msdn.microsoft.com/en-us/library/lists.lists.updatelistitems(v=office.14).aspx
方法简单不代表逻辑简单,增删改的操作逻辑都封装在Xml中,使用时千变万化的xml参数让人相当费解,经过这些天的不懈努力,终可窥得其中些许奥秘!根据可能操作的不同情况,可总结为以下表格,每一种情况可参考表后的示例。
|
Add |
Update |
Delete |
Generic list item |
1 |
3 |
4 |
Generic list item(in folder) |
2 |
||
Folder(Generic list) |
5 |
6 |
|
Folder(document library) |
7 |
||
Document |
Unsupported |
3 |
1) Add Generic list item
<Batch OnError="Continue">
<Method ID="1" Cmd="New">
<Field Name="ID">New</Field>
<Field Name="URL">http://192.168.1.1</Field>
<Field Name="Comments">Redmond</Field>
</Method>
</Batch>
注:这是最常见的格式了.
2) Generic list item(in folder)
<Batch OnError="Continue" RootFolder="/Lists/Links/folder">
<Method ID="1" Cmd="New">
<Field Name="ID">New</Field>
<Field Name="URL">http://192.168.1.1</Field>
<Field Name="Comments">Redmond</Field>
</Method>
</Batch>
注:这里的RootFolder格式必须为’/Lists/listName/folderpathOrName'(RootFolder属性在MSDN中未提到,但确实是有效的操作属性)
3) Update ListItem
<Batch OnError="Continue">
<Method ID="1" Cmd="Update">
<Field Name="ID">1</Field>
<Field Name="URL">http://192.168.1.1</Field>
<Field Name="Comments">Redmond</Field>
</Method>
</Batch>
4) Delete generic listitem or folder
<Batch OnError="Continue">
<Method ID="1" Cmd="Delete">
<Field Name="ID">1</Field>
</Method>
</Batch>
注:如果删除的是文件夹,则文件夹内的数据项也全部删除
5) Add folder
<Batch OnError="Continue">
<Method ID="1" Cmd="New">
<Field Name="ID">New</Field>
<Field Name="FSObjType">1</Field>
<Field Name="BaseName">folderName</Field>
</Method>
</Batch>
注:其中BaseName格式为:folderName 或者pFolderName/subFolderName,不得以’/’开头,支持文档库操作。
6) Update folder
<Batch OnError="Continue">
<Method ID="1" Cmd="Update">
<Field Name="ID">New</Field>
<Field Name="FSObjType">1</Field>
<Field Name="BaseName">newfolderName</Field>
</Method>
</Batch>
注:这里只能修改文件夹名称,其中BaseName格式为:folderName(与创建文件夹时指定路径不同),不得包含’/’等特殊字符,支持文档库操作。
7) Remove document library folder or document
<Batch OnError="Continue">
<Method ID="1" Cmd="Delete">
<Field Name="ID">New</Field>
<Field Name="FileRef">documentpath</Field>
</Method>
</Batch>
注:这里的FileRef的格式可以为全路径格式:
http://hostOrIP:port/siteName/documentLibraryName/documentNameORFolderName
也可以为相对路径:
/documentLibraryName/documentNameORFolderName
或者
documentLibraryName/documentNameORFolderName
名称大小写不敏感.
其它:不支持文档的上传添加操作,此部分可参考Copy.asmx服务的CopyIntoItems方法;不支持文档文件的更新操作,仅支持对文档属性字段的更新操作,此操作与generic list的更新相同。
真的是相当费解的设计,在使用之前最好针对不同的情况封装为方法,这样使用的时候就不用再费解了。