Powy\u017cszy kod definiuje polityk\u0119, kt\u00f3ra uruchomi si\u0119 36 dni po utworzeniu elementu i wykona akcj\u0119 polegaj\u0105c\u0105 na przeniesieniu elementu do kosza. Ca\u0142o\u015b\u0107 kodu tworz\u0105ca now\u0105 polityk\u0119 zosta\u0142a zebrana poni\u017cej.<\/p>\n\n\n
\nusing Microsoft.SharePoint;\nusing Microsoft.SharePoint.Administration;\nusing Microsoft.Office.RecordsManagement.InformationPolicy;\n...\n using (SPSite site = new SPSite("http:\/\/siteUrl"))\n {\n using (SPWeb web = site.OpenWeb(""))\n {\n SPContentType ct = web.ContentTypes["ContentName"];\n Policy policy = Policy.GetPolicy(ct);\n if (policy==null)\n {\n Policy.CreatePolicy(ct,null);\n ct.Update();\n policy = Policy.GetPolicy(ct);\n policy.Statement = "to jest opis";\n policy.Update();\n }\n string policyCustomData= "<Schedules nextStageId \\"2\\">\n <Schedule type=\\"Default\\">\n <stages>\n <data stageId=\\"1\\">\n <formula id=\\"Microsoft.Office.RecordsManagement.PolicyFeatures.Expiration.Formula.BuiltIn\\">\n <number>36<\/number>\n <property>Created<\/property>\n <propertyId>8c06beca-0777-48f7-91c7-6da68bc07b69<\/propertyId>\n <period>days<\/period>\n <\/formula>\n <action type=\\"action\\" id=\\"Microsoft.Office.RecordsManagement.PolicyFeatures.Expiration.Action.MoveToRecycleBin\\" \/>\n <\/data>\n <\/stages>\n <\/Schedule>\n <\/Schedules>";\n policy.Items.Add("Microsoft.Office.RecordsManagement.PolicyFeatures.Expiration", policyCustomData);\n policy.Update(); }\n }\n<\/pre><\/div>\n\n\nUtworzenie w\u0142asnego zdarzenia polityki (API serwera SharePoint)<\/h2>\n\n\n\n
W celu utworzenia w\u0142asnego zdarzenia polityki nale\u017cy z pomoc\u0105 Visual Studio utworzy\u0107 nowy pusty projekt SharePointowy, w kt\u00f3rym \u201eTrust Level\u201d zosta\u0142 ustawiony jako \u201eDeploy as a farm solution\u201d. Do projektu nale\u017cy doda\u0107 referencje „Microsoft.Office.Policy”.
W projekcie nale\u017cy utworzy\u0107 klas\u0119, kt\u00f3ra b\u0119dzie odpowiedzialna za implementacje metody sprawdzenia i wywo\u0142ania zdarzenia, w naszym przyk\u0142adzie b\u0119dzie to klasa o nazwie \u201eCustomExpiration\u201d. Do klasy nale\u017cy doda\u0107 przestrze\u0144 nazw Microsoft.Office.RecordsManagement.PolicyFeatures<\/em>. Klasa musi implementowa\u0107 interfejs IExpirationFormula, kt\u00f3ry wymusza implementacje metody ComputeExpireDate. Metoda ComputeExpireDate powinna zwraca\u0107 dat\u0119 w przypadku gdy zdarzenie ma zosta\u0107 wygenerowane, w przeciwnym przypadku powinna zwraca\u0107 null. W poni\u017cszym kodzie zosta\u0142a zaimplementowana logika, kt\u00f3ry sprawdza czy pole o nazwie \u201eStatus\u201d ma warto\u015b\u0107 \u201eDelete\u201d, je\u015bli tak to zdarzenie jest generowane. Poni\u017cej kod klasy wraz z metod\u0105 ComputeExpireDate.<\/p>\n\n\n\nnamespace CustomExpiration\n{\n class MyCustomExpiration: IExpirationFormula\n {\n public Nullable<DateTime> ComputeExpireDate(SPListItem item, System.Xml.XmlNode parametersData)\n {\n DateTime? expirationStatus = null;\n if (item["Status"] != null && (!string.IsNullOrEmpty(item["Status"].ToString())))\n {\n if (item["Status"].ToString() == "Delete")\n expirationStatus = DateTime.Now;\n }\n return expirationStatus;\n }\n }\n}\n<\/pre><\/div>\n\n\nPo utworzeniu klasy implementuj\u0105cej interfejs IExpirationFormula nale\u017cy zarejestrowa\u0107 nowe zdarzenie w PolicyResourceCollection. Do tego celu, mo\u017cemy wykorzysta\u0107 Feature ze Scope ustawionym na poziomie farmy. W feature tym nale\u017cy zdefiniowa\u0107 Event Receiver, kt\u00f3ry powinien implementowa\u0107 zdarzenie FeatureActivated tak jak w poni\u017cszym kodzie.<\/p>\n\n\n
\npublic override void FeatureActivated(SPFeatureReceiverProperties properties)\n{\n string expirationFormulaID = "CustomExpirationFormula";\n string expirationFormulaName = "Moja formula wygasania";\n string expirationFormulaDesc = "Moja formula wygasania";\n string xmlExpirationFormula = "<PolicyResource xmlns=\\"urn:schemas-microsoft-com:office:server:policy\\"" + " id = \\"" + expirationFormulaID + "\\"" + " featureId=\\"Microsoft.Office.RecordsManagement.PolicyFeatures.Expiration\\"" + " type = \\"DateCalculator\\">\n "<Name>" + (expirationFormulaName) + "<\/Name>" +\n "<Description>" + (expirationFormulaDesc) + "<\/Description>" +\n "<AssemblyName>CustomExpiration, Version=1.0.0.0, Culture=neutral, PublicKeyToken=88bf3ea84224a2b8<\/AssemblyName>" +\n "<ClassName>CustomExpiration.MyCustomExpiration<\/ClassName>" +\n "<\/PolicyResource>";\n try\n {\n PolicyResourceCollection.Delete(expirationFormulaID);\n }\n catch (Exception ex)\n {\n }\n PolicyResource.ValidateManifest(xmlExpirationFormula);\n PolicyResourceCollection.Add(xmlExpirationFormula);\n}\n<\/pre><\/div>\n\n\nNale\u017cy zwr\u00f3ci\u0107 uwag\u0119 na prawid\u0142ow\u0105 warto\u015b\u0107 tag\u00f3w AssemblyName oraz ClassName, kt\u00f3re b\u0119d\u0105 inne ni\u017c w przyk\u0142adowym kodzie.
Po skompilowaniu projektu i jego wdro\u017ceniu powinni\u015bmy mie\u0107 mo\u017cliwo\u015b\u0107 skorzystania z nowego zdarzenia. Zdarzenie b\u0119dzie si\u0119 uruchamia\u0142o, gdy element na kt\u00f3rym jest zdefiniowana polityka b\u0119dzie posiada\u0142 pole o nazwie \u201eStatus\u201d i to pole b\u0119dzie mia\u0142o przypisan\u0105 warto\u015b\u0107 \u201eDelete\u201d.<\/p>\n\n\n\n
Utworzenie w\u0142asnej akcji polityki (API serwera SharePoint)<\/h2>\n\n\n\n
W celu utworzenia w\u0142asnej akcji polityki wykorzystamy utworzony w poprzednim punkcie projekt SharePointowy. Do projektu nale\u017cy doda\u0107 klas\u0119, kt\u00f3ra w naszym przyk\u0142adzie b\u0119dzie mia\u0142a nazw\u0119 CustomExpirationAction. Klasa powinna implementowa\u0107 interfejs IExpirationAction, kt\u00f3ry posiada metod\u0119 OnExpiration. W naszym przyk\u0142adzie utworzymy prost\u0105 akcj\u0119, kt\u00f3ra b\u0119dzie przypisywa\u0142a do pola \u201eTitle\u201d dat\u0119 wyst\u0105pienia zdarzenia. Metoda powinna mie\u0107 wi\u0119c nast\u0119puj\u0105c\u0105 tre\u015b\u0107:<\/p>\n\n\n
\npublic void OnExpiration(SPListItem item, XmlNode parametersData, DateTime expiredDate)\n{\n item[\"Title\"] = expiredDate.ToString();\n item.Update();\n}\n<\/pre><\/div>\n\n\nGdy mamy ju\u017c utworzon\u0105 klas\u0119, odpowiedzialn\u0105 za wykonanie akcji, nale\u017cy akcj\u0119 doda\u0107 do kolekcji PolicyResourceCollection, w kt\u00f3rej s\u0105 przechowywane zdarzenia i akcje.
Czynno\u015b\u0107 t\u0119 mo\u017cna wykona\u0107 w analogiczny spos\u00f3b jak w przypadku rejestracji zdarzenia. Kod rejestracji akcji nale\u017cy wi\u0119c doda\u0107 do Event Receiver Featura (po kodzie rejestruj\u0105cym zdarzenie).<\/p>\n\n\n
\nstring expirationActionFormulaID = "CustomExpirationAction";\nstring expirationActionFormulaName = "Moja akcja name";\nstring expirationActionFormulaDesc = "Moja akcja desc";\nstring xmlManifestAction = "<PolicyResource xmlns='urn:schemas-microsoft-com:office:server:policy'" + " id = \\"" + expirationActionFormulaID + "\\"" + " featureId='Microsoft.Office.RecordsManagement.PolicyFeatures.Expiration'" + " type='Action'>" +\n "<Name>" + (expirationActionFormulaName) + "<\/Name>" +\n "<Description>" + (expirationActionFormulaDesc) + "<\/Description>" +\n "<AssemblyName>CustomExpiration, Version=1.0.0.0, Culture=neutral, PublicKeyToken=88bf3ea84224a2b8<\/AssemblyName>" +\n "<ClassName>CustomExpiration.CustomExpirationAction<\/ClassName>" +\n "<\/PolicyResource>";\ntry\n{\n PolicyResourceCollection.Delete(expirationActionFormulaID);\n}\ncatch (Exception ex)\n{\n}\nPolicyResource.ValidateManifest(xmlManifestAction);\nPolicyResourceCollection.Add(xmlManifestAction);\n<\/pre><\/div>\n\n\nNale\u017cy zwr\u00f3ci\u0107 uwag\u0119 na prawid\u0142ow\u0105 warto\u015b\u0107 tag\u00f3w AssemblyName oraz ClassName, kt\u00f3re b\u0119d\u0105 inne ni\u017c w przyk\u0142adowym kodzie.
Po skompilowaniu projektu i wdro\u017ceniu rozwi\u0105zania mo\u017cna ju\u017c korzysta\u0107 z nowo dodanej akcji.<\/p>\n\n\n\n
Podsumowanie<\/h2>\n\n\n\n
Mechanizm \u201eSharePoint Retention Policies\u201d jest elastycznym rozwi\u0105zaniem umo\u017cliwiaj\u0105cym egzekwowanie regu\u0142 dotycz\u0105cych przechowywanych informacji w SharePoint. Wbudowane zdarzenia i akcje umo\u017cliwiaj\u0105 tworzenie polityk, kt\u00f3re powinny sprosta\u0107 wi\u0119kszo\u015bci wymaga\u0144. Jednak w przypadku potrzeb, kt\u00f3re wykraczaj\u0105 poza wbudowane elementy, istniej prosta mo\u017cliwo\u015b\u0107 tworzenia nowych zdarze\u0144 (wyzwalaczy) i akcji.<\/p>\n\n\n
\n \n
\n \n
\n
\n \n\n
<\/div>\n <\/div>\n
\n \n\n
<\/div>\n <\/div>\n
\n \n\n
<\/div>\n <\/div>\n
\n \n\n
<\/div>\n <\/div>\n
\n \n\n
<\/div>\n <\/div>\n <\/div>\n \n
\n
\n \n\n
<\/div>\n <\/div>\n
\n \n\n
<\/div>\n <\/div>\n
\n \n\n
<\/div>\n <\/div>\n
\n \n\n
<\/div>\n <\/div>\n
\n \n\n
<\/div>\n <\/div>\n <\/div>\n<\/div>\n \n\n
\n 4.5\/5 ( votes: 2) <\/div>\n <\/div>\n","protected":false},"excerpt":{"rendered":"
W rozwi\u0105zaniach SharePoint zosta\u0142o wbudowanych wiele mechanizm\u00f3w, kt\u00f3re z za\u0142o\u017cenia maj\u0105 u\u0142atwia\u0107 zarz\u0105dzanie informacj\u0105. Jednym z tych mechanizm\u00f3w jest \u201eSharePoint … Continued<\/a><\/p>\n","protected":false},"author":150,"featured_media":5138,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"_editorskit_title_hidden":false,"_editorskit_reading_time":0,"_editorskit_is_block_options_detached":false,"_editorskit_block_options_position":"{}","inline_featured_image":false,"footnotes":""},"categories":[1314],"tags":[56],"class_list":["post-5096","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-development-na-twardo","tag-sharepoint"],"acf":[],"aioseo_notices":[],"republish_history":[],"featured_media_url":"https:\/\/sii.pl\/blog\/wp-content\/uploads\/2018\/02\/Rules.png","category_names":["Development na twardo"],"_links":{"self":[{"href":"https:\/\/sii.pl\/blog\/wp-json\/wp\/v2\/posts\/5096"}],"collection":[{"href":"https:\/\/sii.pl\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/sii.pl\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/sii.pl\/blog\/wp-json\/wp\/v2\/users\/150"}],"replies":[{"embeddable":true,"href":"https:\/\/sii.pl\/blog\/wp-json\/wp\/v2\/comments?post=5096"}],"version-history":[{"count":2,"href":"https:\/\/sii.pl\/blog\/wp-json\/wp\/v2\/posts\/5096\/revisions"}],"predecessor-version":[{"id":23990,"href":"https:\/\/sii.pl\/blog\/wp-json\/wp\/v2\/posts\/5096\/revisions\/23990"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/sii.pl\/blog\/wp-json\/wp\/v2\/media\/5138"}],"wp:attachment":[{"href":"https:\/\/sii.pl\/blog\/wp-json\/wp\/v2\/media?parent=5096"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/sii.pl\/blog\/wp-json\/wp\/v2\/categories?post=5096"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/sii.pl\/blog\/wp-json\/wp\/v2\/tags?post=5096"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
![\"Policies\"](\"https:\/\/sii.pl\/blog\/wp-content\/uploads\/2023\/09\/Polices.png\")
<\/a><\/figure>\n\n\n\n![\"Information](\"https:\/\/sii.pl\/blog\/wp-content\/uploads\/2023\/09\/PolicySettings.png\")
<\/a><\/figure>\n\n\n\n