To create a document set in a document library its necessary to add a Document Set content type to the library. After doing this a document set can be created using various techniques. In this post I’ll show you how to do so using JSOM or REST.<\/p>\n
To use JSOM the appropriate references have to be added to the HTML, but the most important one is SP.DocumentManagement.js. Of course a nice UI can be set up to pass in values for necessary input parameters, but for demo purposes filled in variables are used as shown below.<\/p>\n
\r\nvar url = "";\r\nvar listTitle = "";\r\nvar docSetContentTypeID = "";\r\nvar docSetName = "";\r\n\r\nvar context = new SP.ClientContext(url);\r\nvar web = context.get_web();\r\nvar list = web.get_lists().getByTitle(listTitle);\r\ncontext.load(list);\r\n\r\nvar parentFolder = list.get_rootFolder();\r\ncontext.load(parentFolder);\r\n\r\nvar docSetContentType = context.get_site().get_rootWeb().get_contentTypes().getById(docSetContentTypeID);\r\ncontext.load(docSetContentType);\r\n\r\ncontext.executeQueryAsync(\r\n function () {\r\n SP.DocumentSet.DocumentSet.create(context, parentFolder, docSetName, docSetContentType.get_id());\r\n context.executeQueryAsync(\r\n function () {\r\n logtoconsole("document set created");\r\n },\r\n function (sender, args) {\r\n logtoconsole("document set error");\r\n }\r\n );\r\n }\r\n);\r\n\r\n<\/pre>\nThat’s all there is!<\/p>\n
REST<\/h4>\n
I found it more of a challenge using REST to add a document set to a library, because I couldn’t find any appropriate SharePoint 2013 REST endpoint to use.<\/p>\n
I tried for example a POST to ‘\/_api\/web\/folders’ with { ‘__metadata’: { ‘type’: ‘SP.Folder’ }, ‘ServerRelativeUrl’: ‘Documents\/test1’ , ‘ContentTypeId’: ‘0x0120D520009403DDAFA2D9F54E885F81B4DA488BA00101’}
\nThe following message was returned as result:<\/p>\n
‘The property ‘ContentTypeId’ does not exist on type ‘SP.Folder’. Make sure to only use property names that are defined by the type.’<\/p><\/blockquote>\n
So I wasn’t able to specify a content type id when adding a folder, assuming a document set is a special type of folder.<\/p>\n
Another option could be trying to add an item using a POST method to ‘\/_api\/web\/lists\/getbytitle(‘” + listTitle + “‘)\/items with\u00a0 { ‘__metadata’: { ‘type’: ‘SP.Data.Gedeelde_x0020__x0020_documentenItem’ } , ‘ContentTypeId’: ‘0x0120D520009403DDAFA2D9F54E885F81B4DA488BA00101’ };
\nThe result was:<\/p>\n
‘To add an item to a document library, use SPFileCollection.Add()’<\/p><\/blockquote>\n
The only way I could find was to use the good old (SP2010) listdata service\u2026<\/p>\n
\r\n$http({\r\n\u00a0 method: "POST",\r\n\u00a0 url: url + "\/_vti_bin\/listdata.svc\/" + listTitle,\r\n\u00a0 data: JSON.stringify(docSetOptions),\r\n\u00a0 headers: {\r\n\u00a0 \u00a0 "Accept": "application\/json;odata=verbose",\r\n\u00a0 \u00a0 "content-type": "application\/json;odata=verbose",\r\n\u00a0 \u00a0 "X-RequestDigest": $('#__REQUESTDIGEST').val(),\r\n\u00a0 \u00a0 "Slug": _spPageContextInfo.siteServerRelativeUrl + "\/" + url + docSetOptions.Path + "\/" + docSetOptions.Title + "|" + docSetOptions.ContentTypeId,\r\n\u00a0 }\r\n}).success(function (data, status, headers, config) {\r\n\u00a0 logtoconsole("document set created");\r\n}).error(function (data, status, headers, config) {\r\n\u00a0 logtoconsole("document set error");\r\n});\r\n\r\n<\/pre>\n <\/p>\n
With docsetOptions declared like:
\nvar docSetOptions = {
\n‘Title’: myTitle,
\n‘Path’: ‘\/Documents’,
\n‘ContentTypeId’: contentTypeId,
\n‘ContentType’: contentType};<\/p>\n
Summary<\/h4>\n
Creating a document set using CSOM or REST can be done, sometimes with a nice challenge!<\/p>\n","protected":false},"excerpt":{"rendered":"
To create a document set in a document library its necessary to add a Document Set content type to the library. After doing this a document set can be created using various techniques. In this post I’ll show you how … Read More »<\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[39,35],"tags":[37,44],"class_list":["post-2131","post","type-post","status-publish","format-standard","hentry","category-office-365","category-sharepoint-2013","tag-office365","tag-sharepoint-2013"],"_links":{"self":[{"href":"https:\/\/www.itidea.nl\/index.php\/wp-json\/wp\/v2\/posts\/2131","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=2131"}],"version-history":[{"count":9,"href":"https:\/\/www.itidea.nl\/index.php\/wp-json\/wp\/v2\/posts\/2131\/revisions"}],"predecessor-version":[{"id":2140,"href":"https:\/\/www.itidea.nl\/index.php\/wp-json\/wp\/v2\/posts\/2131\/revisions\/2140"}],"wp:attachment":[{"href":"https:\/\/www.itidea.nl\/index.php\/wp-json\/wp\/v2\/media?parent=2131"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.itidea.nl\/index.php\/wp-json\/wp\/v2\/categories?post=2131"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.itidea.nl\/index.php\/wp-json\/wp\/v2\/tags?post=2131"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}