{"id":1265,"date":"2011-08-21T11:48:30","date_gmt":"2011-08-21T09:48:30","guid":{"rendered":"http:\/\/www.itidea.nl\/?p=1265"},"modified":"2015-09-08T20:37:09","modified_gmt":"2015-09-08T18:37:09","slug":"how-to-retrieve-document-set-version-history","status":"publish","type":"post","link":"https:\/\/www.itidea.nl\/index.php\/how-to-retrieve-document-set-version-history\/","title":{"rendered":"How to retrieve document set version history"},"content":{"rendered":"

Document set versions are slightly different than item versions. Document sets can be managed by a separate ribbon tab called Document Set and group called Manage.
\n\"\"<\/a><\/p>\n

To create a version of a document set the action Capture Version in this part of the ribbon has to be selected. When selecting the following screen will be shown:
\n\"\"<\/a><\/p>\n

To use versioning of a document set (and items) versioning has to be enabled on the library.\u00a0\u00a0\u00a0\u00a0<\/p>\n

After selecting a version option (when major\/minor enabled), adding some comment and selecting the Ok button a document set version is created. To view the versions of the document set the action Version History can be selected in the ribbon.
\n\"\"<\/a><\/p>\n

In this screen the first column displayed is No. This is not the regular version column of the library, but a totally different one. When creating a document set version the version column of the library doesn’t change, only the No value.\u00a0\u00a0\u00a0\u00a0<\/p>\n

That’s nice, but where is the version of the document set actually stored?\u00a0\u00a0\u00a0\u00a0<\/p>\n

The version(s) of a document set are stored in the propertybag of the item itself.\u00a0\u00a0\u00a0\u00a0<\/p>\n

To analyze settings I always start up PowerShell first to check on things. Just because it’s quick and easy. When I get what I want from PowerShell it’s easily turned into C# code. I followed the same procedure to get to the storage of document set versions. Since I couldn’t find the version anywhere in the UI, my first guess was checking the propertybag keys.\u00a0\u00a0\u00a0\u00a0<\/p>\n

\r\n$site=Get-SPSite "http:\/\/sp2010dev"\r\n$docList = $site.RootWeb.Lists.TryGetList("Documents");\r\n$item = $docList.Items.GetItemById(2)\r\n$prop = $item.Properties\r\n<\/pre>\n
Often I use PowerGui Script Editor which gives an excellent overview of variables:\u00a0\u00a0\u00a0\u00a0<\/p>\n
The keys:
\n\"\"<\/a><\/p>\n
And the values:
\n\"\"<\/a><\/p>\n
While scrolling through the property keys I noticed a key named snapshots. By checking out the value of that key I knew I found it!\u00a0\u00a0\u00a0\u00a0<\/p>\n
The following PowerShell command can be used to get the value of the snapshot key:\u00a0\u00a0\u00a0\u00a0<\/p>\n
\r\n$item.Properties.get_Item("snapshots")\r\n<\/pre>\n
The version history is stored in xml:\u00a0\u00a0\u00a0\u00a0<\/p>\n
\r\n<SnapshotCollection NextSnapshotNumber="3" NextInternalId="1">\r\n  <Items \/>\r\n  <Snapshots>\r\n    <Snapshot Label="2" Major="True" Created="08\/21\/2011 07:50:56" By="username">\r\n      <Comments>Another version of the document set.<\/Comments>\r\n      <Fields>\r\n        <Field Id="8553196d-ec8d-4564-9861-3dbe931050c8">Document set name<\/Field>\r\n        <Field Id="fa564e0f-0c70-4ab9-b863-0177e6ddd247">Document set name<\/Field>\r\n        <Field Id="cbb92da4-fd46-4c7d-af6c-3128c2a5576e">Add a description here.<\/Field>\r\n      <\/Fields>\r\n      <SnapshotItems \/>\r\n    <\/Snapshot>\r\n    <Snapshot Label="1" Major="True" Created="08\/21\/2011 07:50:20" By="username">\r\n      <Comments>This is the first version of this document set.<\/Comments>\r\n      <Fields>\r\n        <Field Id="8553196d-ec8d-4564-9861-3dbe931050c8">Document set name<\/Field>\r\n        <Field Id="fa564e0f-0c70-4ab9-b863-0177e6ddd247">Document set name<\/Field>\r\n        <Field Id="cbb92da4-fd46-4c7d-af6c-3128c2a5576e" \/>\r\n      <\/Fields>\r\n      <SnapshotItems \/>\r\n    <\/Snapshot>\r\n  <\/Snapshots>\r\n<\/SnapshotCollection>\r\n<\/pre>\n
\u00a0\u00a0\u00a0<\/p>\n
The Snapshot element with Label attribute 1 is the first version. The comment is displayed and the fields and values of the document set.\u00a0\u00a0\u00a0\u00a0<\/p>\n
The Snapshot element with Label attribute 2 is the second version. The same items are displayed with the addition of the value of the description \u2018Add a description here\u2019. That\u2019s what I changed before creating the second version.\u00a0\u00a0\u00a0\u00a0<\/p>\n
The attribute NextSnapshotNumber holds the value of the version number that will be created when creating another version, 3 in this case.\u00a0\u00a0\u00a0\u00a0<\/p>\n
Summary\u00a0\u00a0<\/h3>\n
Document set versions are different than regular item versions. The version history of a document set is stored in the propertybag of the document set itself as xml.<\/p>\n","protected":false},"excerpt":{"rendered":"
Document set versions are slightly different than item versions. Document sets can be managed by a separate ribbon tab called Document Set and group called Manage. To create a version of a document set the action Capture Version in this … Read More »<\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[8],"tags":[43,42],"class_list":["post-1265","post","type-post","status-publish","format-standard","hentry","category-sharepoint-2010","tag-powershell","tag-sharepoint-2010"],"_links":{"self":[{"href":"https:\/\/www.itidea.nl\/index.php\/wp-json\/wp\/v2\/posts\/1265","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.itidea.nl\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.itidea.nl\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.itidea.nl\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.itidea.nl\/index.php\/wp-json\/wp\/v2\/comments?post=1265"}],"version-history":[{"count":9,"href":"https:\/\/www.itidea.nl\/index.php\/wp-json\/wp\/v2\/posts\/1265\/revisions"}],"predecessor-version":[{"id":1279,"href":"https:\/\/www.itidea.nl\/index.php\/wp-json\/wp\/v2\/posts\/1265\/revisions\/1279"}],"wp:attachment":[{"href":"https:\/\/www.itidea.nl\/index.php\/wp-json\/wp\/v2\/media?parent=1265"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.itidea.nl\/index.php\/wp-json\/wp\/v2\/categories?post=1265"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.itidea.nl\/index.php\/wp-json\/wp\/v2\/tags?post=1265"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}