{"id":2017,"date":"2012-05-16T08:22:03","date_gmt":"2012-05-16T08:22:03","guid":{"rendered":"https:\/\/www.wapshere.com\/missmiis\/?p=2017"},"modified":"2022-08-21T16:39:44","modified_gmt":"2022-08-21T16:39:44","slug":"a-script-to-make-fim-policy-self-documenting","status":"publish","type":"post","link":"https:\/\/www.wapshere.com\/missmiis\/a-script-to-make-fim-policy-self-documenting","title":{"rendered":"A Script to make FIM Policy “Self-Documenting”"},"content":{"rendered":"

There’s an ongoing problem with maintaining a system that has all the configuration possibilities of FIM. Documentation is usually out of date the moment it’s written and it’s a cumbersome way to try and understand a system anyway. One thing that can at least make your Policy configuration a bit easier to understand is to be able to see which MPRs use which Sets and Workflows. Now I know you can see this info if you look at the MPR object – but what if I’m looking at a Set or Workflow? How do I quickly see which MPRs are using that object, and thereby assess its purpose?<\/p>\n

<\/p>\n

Searching is cumbersome and I’ll have to specify multiple possible MPR attributes. It’s also no good if I want to review a number of Sets or Workflows at once.<\/p>\n

So what I decided to do was write a script which updates Set and Workflow objects with a list of the MPRs using them. I started out with the Description field but quickly ran up against the length limit, so instead I created a new unindexed string<\/em> attribute called “ReferringMPRs”, which I bound to both the Set and WorkflowDefinition object types. I’ve added this attribute to the Search Scope definitions so it’s easy to see:<\/p>\n

\"\"<\/a><\/p>\n

\u00a0<\/p>\n

Next I wrote a script which I schedule to run once a week. It updates the ReferringMPRs attribute on each Set and WorkflowDefinition with the list of MPRs referencing it. Note I don’t differentiate on where the MPR is using the object – ie I don’t care which phase the Workflow runs in, or which role the Set is performing. When trying to figure out what a Set or Workflow is used for I often won’t need this level of detail – it’s enough to know that the MPR is using it somehow. You are of course welcome to take the script and modify it if you think it should do more.<\/p>\n

On a suggestion from my colleague Pete Wass I added an extra function to the script. If you feed it a folder name it will create a datestamped report in that folder if it finds differences in the list of referring MPRs.<\/p>\n

You can grab a copy of the script from the FIM Team Scripts site<\/a>.<\/p>\n

\u00a0<\/p>\n\n\n

<\/p>\n","protected":false},"excerpt":{"rendered":"

There’s an ongoing problem with maintaining a system that has all the configuration possibilities of FIM. Documentation is usually out of date the moment it’s written and it’s a cumbersome way to try and understand a system anyway. One thing that can at least make your Policy configuration a bit easier to understand is to…<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"jetpack_post_was_ever_published":false,"footnotes":"","jetpack_publicize_message":"","jetpack_is_tweetstorm":false,"jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":false,"jetpack_social_options":[]},"categories":[55,42,62,23,54,45],"tags":[],"class_list":["post-2017","post","type-post","status-publish","format-standard","hentry","category-best-practice","category-fim-2010","category-mpr","category-powershell","category-sets","category-workflow"],"jetpack_publicize_connections":[],"jetpack_featured_media_url":"","jetpack_shortlink":"https:\/\/wp.me\/pkp1o-wx","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/www.wapshere.com\/missmiis\/wp-json\/wp\/v2\/posts\/2017","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.wapshere.com\/missmiis\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.wapshere.com\/missmiis\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.wapshere.com\/missmiis\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.wapshere.com\/missmiis\/wp-json\/wp\/v2\/comments?post=2017"}],"version-history":[{"count":10,"href":"https:\/\/www.wapshere.com\/missmiis\/wp-json\/wp\/v2\/posts\/2017\/revisions"}],"predecessor-version":[{"id":3295,"href":"https:\/\/www.wapshere.com\/missmiis\/wp-json\/wp\/v2\/posts\/2017\/revisions\/3295"}],"wp:attachment":[{"href":"https:\/\/www.wapshere.com\/missmiis\/wp-json\/wp\/v2\/media?parent=2017"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.wapshere.com\/missmiis\/wp-json\/wp\/v2\/categories?post=2017"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.wapshere.com\/missmiis\/wp-json\/wp\/v2\/tags?post=2017"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}