通过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的更新相同。

     真的是相当费解的设计,在使用之前最好针对不同的情况封装为方法,这样使用的时候就不用再费解了。

posted @ 2012-09-18 10:04  Areas  阅读(377)  评论(0编辑  收藏  举报