هنگامی که می خواهید اسناد را در یک کتابخانه خاص گروه بندی کنید، می توان از مجموعه های اسناد استفاده کرد. سند تنظیم شده به خودی خود یک نوع محتوا است که به عنوان یک پوشه در سطح بالایی عمل می کند. جدا از گروه بندی منطقی اسناد، ما همچنین می توانیم متادیتا را اختصاص دهیم و Workflow ها را برای اجرا روی گروهی از اسناد اختصاص دهیم. علاوه بر آن، میتوانیم محتوای پیشفرض را روی یک مجموعه اسناد قرار دهیم، به طوری که هر زمان یک مجموعه اسناد ایجاد شد، محتوای پیشفرض نیز به همراه آن ایجاد شود. این بسیار مفید است، زیرا یک نقطه شروع به تیم می دهد. مجموعه اسناد در نسخه شیرپوینت 2010 معرفی شد و تا پیش از آمدن شیرپوینت 2016 راه خود را طی کرد.
مجموعه اسناد بخشی از ویژگی مجموعه سایت است.
ما میتوانیم مجموعههای اسناد را خارج از جعبه و همچنین از طریق مدل برنامهنویسی شیرپوینت ایجاد کنیم. در این مقاله خواهیم دید که چگونه می توانیم با استفاده از مدل شی جاوا اسکریپت یک مجموعه اسناد ایجاد کنیم.
پیاده سازی داخلی
- اضافه کردن مرجع به فایل jQuery.
- <script language="javascript" type="text/javascript" src="//ajax.googleapis.com/ajax/libs/jquery/1.8.1/jquery.min.js"></script>
- <script language="javascript" type="text/javascript">
- در تابع Document ready، از تابع getScript استفاده کنید تا اسکریپت درخواستی SP.js و SP.DocumentManagement.js را بارگیری کنید. تابع نقطه شروع اصلی را فراخوانی کنید و بگویید: createDocumentSet.
- $.getScript(scriptbase + "SP.DocumentManagement.js",createDocumentSet);
- زمینه مشتری، نمونه وب و کتابخانه را نمونه سازی کنید.
- clientContext = new SP.ClientContext.get_current();
- oWeb = clientContext.get_web();
- var oList = oWeb.get_lists().getByTitle("Demo Library");
- نوع محتوا را برای مجموعه اسناد دریافت کنید.
- var documentSetContentTypeID = "0x0120D520";
- documentSetContentType = clientContext.get_site().get_rootWeb().get_contentTypes().getById(documentSetContentTypeID);
- متن کلاینت را بارگذاری کنید و دسته را اجرا کنید.
- clientContext.load(documentSetContentType);
- clientContext.executeQueryAsync(QuerySuccess, QueryFailure);
- در عملکرد بازگشت موفقیت آمیز، نام مجموعه سند را تنظیم کرده و مجموعه اسناد را ایجاد کنید.
- var documentSetName = "Long Term Execution Planning";
- SP.DocumentSet.DocumentSet.create(clientContext, oLibraryFolder, documentSetName, documentSetContentType.get_id());
- یک بار دیگر دسته را اجرا کنید.
- clientContext.executeQueryAsync(SecondQuerySuccess,SecondQueryFailure);
کد کامل
کد کامل برای ایجاد مجموعه اسناد با استفاده از JSOM در زیر آورده شده است-
- <script language="javascript" type="text/javascript" src="//ajax.googleapis.com/ajax/libs/jquery/1.8.1/jquery.min.js"></script>
- <script language="javascript" type="text/javascript">
- $(document).ready(function() {
- var scriptbase = _spPageContextInfo.webServerRelativeUrl + "/_layouts/15/";
- $.getScript(scriptbase + "SP.Runtime.js", function() {
- $.getScript(scriptbase + "SP.js", function() {
- $.getScript(scriptbase + "SP.DocumentManagement.js", createDocumentSet);
- });
- });
- });
- var oLibraryFolder, clientContext, docSetContentType;
- function createDocumentSet() {
- //Get the client context,web and library object.
- clientContext = new SP.ClientContext.get_current();
- oWeb = clientContext.get_web();
- var oList = oWeb.get_lists().getByTitle("Demo Library");
- //Load the library object
- clientContext.load(oList);
- //Get the root folder of the library and load it
- oLibraryFolder = oList.get_rootFolder();
- clientContext.load(oLibraryFolder);
- //Get the content type for the document set and load it
- var documentSetContentTypeID = "0x0120D520";
- documentSetContentType = clientContext.get_site().get_rootWeb().get_contentTypes().getById(documentSetContentTypeID);
- clientContext.load(documentSetContentType);
- //Execute the batch
- clientContext.executeQueryAsync(QuerySuccess, QueryFailure);
- }
- function QuerySuccess() {
- //Set the document set name
- var documentSetName = "Long Term Execution Planning";
- SP.DocumentSet.DocumentSet.create(clientContext, oLibraryFolder, documentSetName, documentSetContentType.get_id());
- clientContext.executeQueryAsync(SecondQuerySuccess, SecondQueryFailure);
- }
- function QueryFailure() {
- console.log('Request failed - ' + args.get_message());
- }
- function SecondQuerySuccess() {
- console.log('Document Set Created.');
- }
- function SecondQueryFailure(sender, args) {
- console.log('Request failed - ' + args.get_message());
- }
- </script>
بیایید ببینیم چگونه می توانیم آن را در شیرپوینت پیاده سازی کنیم. اسکریپت های داده شده در بالا را در یک فایل متنی ذخیره کنید و آن را در کتابخانه Site Assets آپلود کنید.
- به تنظیمات ویرایش صفحه شیرپوینت بروید و از تب Insert روی Web part کلیک کنید.
- بخش وب ویرایشگر محتوا را اضافه کنید.
- از قسمت Content Edit Web روی Edit Web part کلیک کنید. URL فایل متنی اسکریپت را اختصاص دهید و روی Apply کلیک کنید.
خروجی : مجموعه اسناد در کتابخانه ایجاد شده است.
خلاصه
بنابراین، نحوه ایجاد مجموعه اسناد را با استفاده از مدل شی جاوا اسکریپت دیدیم. این در شیرپوینت 2016 و آفیس 365 آزمایش و آزمایش شده است.