2014-09-02 182 views
1

我想更新Sharepoint中ListItem的某些字段。我如何通过REST API实现这一目标?通过Sharepoint REST API更新列表项

有没有关于此的任何文档?

编辑1

考虑以下JSON,我收到请求列表项(GET)

{ 
"d": { 
    "__metadata": { 
     "id": "8b3d2196-ad3e-4766-a23e-7e6a89153965", 
     "uri": "https://abc-my.sharepoint.com/personal/nn_abc_co/_api/Web/Lists(guid'd02a8c5b-cd69-4aa8-b7fb-9d539733f285')/Items(383)", 
     "etag": "\"2\"", 
     "type": "SP.Data.DocumentsItem" 
    }, 
    "FirstUniqueAncestorSecurableObject": { 
     "__deferred": { 
      "uri": ".../FirstUniqueAncestorSecurableObject" 
     } 
    }, 
    "RoleAssignments": { 
     "__deferred": { 
      "uri": ".../RoleAssignments" 
     } 
    }, 
    "AttachmentFiles": { 
     "__deferred": { 
      "uri": ".../AttachmentFiles" 
     } 
    }, 
    "ContentType": { 
     "__deferred": { 
      "uri": ".../ContentType" 
     } 
    }, 
    "FieldValuesAsHtml": { 
     "__deferred": { 
      "uri": ".../FieldValuesAsHtml" 
     } 
    }, 
    "FieldValuesAsText": { 
     "__metadata": { 
      "id": ".../FieldValuesAsText", 
      "uri": ".../_api/Web/Lists(guid'd02a8c5b-cd69-4aa8-b7fb-9d539733f285')/Items(383)/FieldValuesAsText", 
      "type": "SP.FieldStringValues" 
     }, 
     "ContentTypeId": "0x0120000E7EB3018A9074468823208C432BDCA5", 
     "Title": "", 
     "IsMyDocuments": "", 
     "SharedWithInternal": "", 
     "SharedWithUsers": "", 
     "ID": "383", 
     "Created": "7/29/2014 11:28 PM", 
     "Author": "3", 
     "Modified": "7/29/2014 11:28 PM", 
     "Editor": "3", 
     "OData__x005f_CopySource": "", 
     "CheckoutUser": "", 
     "OData__x005f_UIVersionString": "1.0", 
     "GUID": "da1e223b-1335-49e8-a544-b2cbebd4064f", 
     "OData__x005f_ModerationStatus": "Approved", 
     "OData__x005f_Level": "1", 
     "UniqueId": "3dba6291-92c7-458f-9a28-e0a91696d9ca", 
     "FSObjType": "1", 
     ... 
     }, 
    "FileSystemObjectType": 1, 
    "Id": 383, 
    "ContentTypeId": "0x0120000E7EB3018A9074468823208C432BDCA5", 
    "Title": null, 
    "IsMyDocuments": null, 
    "SharedWithInternalId": null, 
    "SharedWithUsersId": { 
     "__metadata": { 
      "type": "Collection(Edm.Int32)" 
     }, 
     "results": [5] 
     }, 
... } 
} 

从上面的JSON(我已经ofcourse改变,但它是一个真正的响应) ,我需要在“FieldValuesAsText”对象下更改“SharedWithUsers”的值。

这可能吗?我一直在尝试,甚至是调用返回成功响应代码,但它不会改变任何东西。

另一方面,如果我在第一级更改字段,那么我的意思是像“标题”这样的字段,它会成功更改。

然而(不是我的理解),像第一级中的“SharedWithUsersId”这样的值也不会改变。尽管我也获得了相同的成功响应代码。

我创建POST数据如下,

对于标题(就像一个魅力!我已经阅读每一个博客,是指这个例子!)

{ 
    "__metadata": { 
    "type": "SP.Data.DocumentsItem" 
}, 
    "Title":"Blabla" 
} 

对于SharedWithUsers场FieldValuesForEdit下OR FieldValuesAsText

{ 
"__metadata": { 
    "type": "SP.Data.DocumentsItem" 
}, 
"FieldValuesForEdit": { 
    "__metadata": { 
     "type": "SP.FieldStringValues" 
    }, 
    "SharedWithUsers": "" 
} 
} 

我已验证SharedWithUsers的值为“”时,它不包含任何数据(样本JSON我已经发布证实了这一点),但使用此类数据的POST调用不会更新它。

对于SharedWithUsersId

{ 
"__metadata": { 
    "type": "SP.Data.DocumentsItem" 
}, 
"SharedWithUsersId": { 
     "__metadata": { 
      "type": "Collection(Edm.Int32)" 
     }, 
     "results": [] 
    } 
} 

注意这里,在这种情况下>>>“SharedWithUsersId”:空也不起作用,即使我自己罪恶的眼睛已经看到了一些项目这样的反应! (所有冰雹微软!!!)

对于上述所有POST数据JSON对象,我得到一个204响应代码(我认为这是一个MERGE调用正确的代码)

我希望我已经解释我的问题不够好。任何或所有的帮助表示赞赏!

+0

你说的 “一定” 的意思,你可以请更新您的问题并指定,例如,字段类型? – 2014-09-02 13:28:41

+0

@VadimGremyachev我已更新的问题。我希望我说得很清楚。 – 2014-09-02 17:58:29

+0

看到我的最终目标是通过REST API更新项目的共享细节 – 2014-09-02 18:02:50

回答

1

阅读MSDN帖子:http://msdn.microsoft.com/en-us/library/office/dn292552%28v=office.15%29.aspx#ListItems

URL ==>应指向要更新的列表项。

方法==> POST,因为要更新一个ListItem

体==> JSON格式,包含要更新的字段。省略那些你不想改变的。

下方,例如:

url: http://site url/_api/web/lists/GetByTitle(‘Test')/items(item id) 
method: POST 
body: { '__metadata': { 'type': 'SP.Data.TestListItem' }, 'Title': 'TestUpdated'} 
headers: 
    Authorization: "Bearer " + accessToken 
    X-RequestDigest: form digest value 
    "IF-MATCH": etag or "*" 
    "X-HTTP-Method":"MERGE", 
    accept: "application/json;odata=verbose" 
    content-type: "application/json;odata=verbose" 
    content-length:length of post body 

获取的accessToken可能很难,从什么样的应用取决于(的SharePoint应用程序,控制台应用程序,在SharePoint)你做这个调用。

+0

是的!我经历了这个,但是我的问题有点棘手。对于Listitem,有一个名为“FieldValuesAsText”的字段,我想更新此对象的内部字段。 我创建JSON看起来像>>> { “__metadata”:{ “类型”: “SP.Data.DocumentsItem” }, “FieldValuesAsText”:{ “__metadata”:{ “类型”:“ SP.FieldStringValues“ }, ”SharedWithUsers“:”“ } } 但是我得到一个204表示无内容。我注意到的一件事是,当我每次执行我的呼叫时,ETag的值递增! – 2014-09-02 10:57:25

+0

尽管如此,如果你想改变一级字段的值,比如...说标题等,但我正在寻找一种方法来改变一个内部对象的值。 – 2014-09-02 11:29:55

+1

你尝试: { “__metadata”:{ “类型”: “SP.Data.DocumentsItem” }, “标题”: “布拉布拉”, “SharedWithUsers”:<一些用户ID(整数)的用户> } – 2014-09-03 09:03:35

0

如果您希望使用HttpClient执行此操作,您可以参考本文。我展示了如何获取摘要和上传文件并在事实之后更新列表项目。适用于Windows应用商店,控制台和表单应用。

实例从使用REST HttpClient的更新文件:

client = new HttpClient(new HttpClientHandler() { UseDefaultCredentials = true }); client.BaseAddress = new System.Uri(url); client.DefaultRequestHeaders.Clear(); client.DefaultRequestHeaders.Add("X-RequestDigest", digest); client.DefaultRequestHeaders.Add("X-HTTP-Method", "MERGE"); client.DefaultRequestHeaders.Add("IF-MATCH", "*"); HttpContent strContent = new StringContent(String.Concat("{ '__metadata': { 'type': 'SP.List' }, 'Title': '", filename, "' }")); strContent.Headers.ContentType = new MediaTypeHeaderValue("application/json"); strContent.Headers.ContentType.Parameters.Add(new NameValueHeaderValue("odata", "verbose")); HttpResponseMessage updateResponse = await client.PostAsync(String.Concat("_api/web/lists/GetByTitle('Project Photos')/Items(", id, ")"), strContent); updateResponse.EnsureSuccessStatusCode(); if (updateResponse.IsSuccessStatusCode) {}

https://arcandotnet.wordpress.com/2015/04/01/sharepoint-2013-rest-services-using-c-and-the-httpclient-for-windows-store-apps/

Arcan.NET