On my first ever MIIS project we were an OCG customer so were able to use their nice XML library. I can’t remember in great detail what it did, but I’ve always considered the concept a best practise: if there’s anything that you find yourself hard-coding as a constant value in extension code, then you should put it in a lookup file, where you can change the values later without having to recompile the code.
\n<\/p>\n
I’ve been working on a couple of projects this year which are big and complicated enough to warrant a proper lookup file, so I’ve finally had to get in and figure out how to parse XML in .NET. As usual this post is just about things I’ve been doing and I’m not trying to say this is the best way to go. You will have to adapt to your own requirements.\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0<\/p>\n
The general outline of my XML file is to have a section for Global settings, and then individual sections for each MA. Note the “tag” for each MA, which I’ll be using in the code.\u00c2\u00a0\u00c2\u00a0The specifc values you include for each MA are entirely up to your requirements.<\/p>\n
<SyncParams>\r\n <Global>\r\n <SyncService>\r\n <ServerName>mysyncserver.mydomain.com<\/ServerName>\r\n <IsDev>False<\/IsDev>\r\n <\/SyncService>\r\n <SQL>\r\n <Server>mysqlserver.mydomain.com<\/Server>\r\n <\/SQL>\r\n <\/Global>\r\n <ManagementAgents>\r\n <MA name='FIM Portal' tag='MAName_FIM'>\r\n <maType>FIM<\/maType>\r\n <MVobjectType>person<\/MVobjectType>\r\n <MVobjectType>group<\/MVobjectType>\r\n\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0 <MVobjectSource>group<\/MVobjectSource>\r\n <\/MA>\r\n <MA name='SQL HR Employees' tag='MAName_HR'>\r\n <maType>SQL<\/maType>\r\n <MVobjectType>person<\/MVobjectType>\r\n <MVobjectSource>person<\/MVobjectSource>\r\n <\/MA>\r\n <MA name='Notes' tag='MAName_Notes'>\r\n <maType>NOTES<\/maType>\r\n <MVobjectType>person<\/MVobjectType>\r\n <MVobjectSource>person<\/MVobjectSource>\r\n <\/MA>\r\n <MA name='AD mydomain' tag='MAName_AD'>\r\n <maType>AD<\/maType>\r\n\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0 <provEnabled>True<\/provEnabled>\r\n <MVobjectType>person<\/MVobjectType>\r\n <MVobjectType>group<\/MVobjectType>\r\n <OU_USERS_INTERNAL>OU=Internal,OU=Users,OU=MyOrg,DC=mydomain,DC=com<\/OU_USERS_INTERNAL>\r\n <OU_USERS_EXTERNAL>OU=External,OU=Users,OU=MyOrg,DC=mydomain,DC=com<\/OU_USERS_EXTERNAL>\r\n <OU_USERS_GENERIC>OU=Generic,OU=Users,OU=MyOrg,DC=mydomain,DC=com<\/OU_USERS_GENERIC>\r\n <OU_USERS_RESIGNED>OU=Resigned,OU=Users,OU=MyOrg,DC=mydomain,DC=com<\/OU_USERS_RESIGNED>\r\n <OU_GROUPS>OU=Groups,OU=MyOrg,DC=mydomain,DC=com<\/OU_GROUPS>\r\n <OU_CONTACTS>OU=Contacts,OU=MyOrg,DC=mydomain,DC=com<\/OU_CONTACTS>\r\n <\/MA>\r\n <\/ManagementAgents>\r\n<\/SyncParams><\/pre>\nInitialization<\/h3>\n
You can use the Initialization section of your extension code to open and load the XML lookup file. Note that you’ll have to do this in each extension project where you want to access parameters from the file. Your code will also need a reference to System.Xml<\/strong>.\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0<\/p>\n
Dim xmlParams As Xml.XmlDocument\r\n\r\n Public Sub Initialize() Implements IMVSynchronization.Initialize\r\n xmlParams = New Xml.XmlDocument\r\n Dim xmlPath As String = Utils.ExtensionsDirectory & \"\\SyncParams.xml\"\r\n\r\n Try\r\n xmlParams.Load(xmlPath)\r\n Catch ex As Exception\r\n Throw New ExtensionException(\"Failed while opening XML parameter file. \" & ex.Message)\r\n End Try\r\n End Sub\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0<\/pre>\nAccessing the Global parameters<\/h3>\n
TheGlobal parameters are easy to get to because there’s only one node for them. So to retrieve the server name from the XML file above I’d just do this:\u00c2\u00a0\u00c2\u00a0<\/p>\n
xmlParams.SelectSingleNode(\"\/\/Global\/SyncService\/ServerName\").InnerText\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0<\/pre>\nAccessing a specific MA’s Parameters<\/h3>\n
The next thing you will probably want to do is access the values for a specifc MA. I’m using the “tag” attribute as a way to identitfy the correct node. In this example I\u00c2\u00a0retrieve an OU name from\u00c2\u00a0the\u00c2\u00a0“AD mydomain” parameters.\u00c2\u00a0\u00c2\u00a0\u00c2\u00a0<\/p>\n
xmlParams.SelectSingleNode(\"\/\/ManagementAgents\/MA[@tag='MAName_AD']\/OU_USERS_EXTERNAL\").InnerText<\/pre>\nCreating a Hash Table of MA Names<\/h3>\n
The other thing that can be useful is to make a hash table of MA Names for easy reference. First you need to define a global variable:\u00c2\u00a0\u00c2\u00a0<\/p>\n
Dim MA_Names As New Collection<\/pre>\nThen you add something like this to the Initialization sub:\u00c2\u00a0\u00c2\u00a0<\/p>\n
For Each xmlNode In xmlParams.SelectNodes(\"\/\/ManagementAgents\/MA\")\r\n MA_Names.Add(xmlNode.Attributes(\"name\").Value, xmlNode.Attributes(\"tag\").Value)\r\n Next<\/pre>\nNow\u00c2\u00a0in the rest of the project, when you want to use an MA’s name, you only need refer to it using its tag:\u00c2\u00a0\u00c2\u00a0<\/p>\n
MA_Names.Item(\"MAName_AD\").ToString\u00c2\u00a0<\/pre>\nSelectively disabling provisioning<\/h3>\n
Another thing you might like to do, especially if you have a number of MAs that you are provisioning to, is to be able to selectively disable the provisioning code for one of them just by using the XML file.<\/p>\n
Obviously you’ll have to modify your provisioning code to check the value of the flag. In the example above I would need to\u00c2\u00a0test for the value of “provEnabled” before calling the provisioning code for the “AD mydomain” MA:<\/p>\n
\r\n If xmlParams.SelectSingleNode(\"\/\/ManagementAgents\/MA[@tag='MAName_AD']\/provEnabled\").InnerText = \"True\" then\r\n Provision_AD(mventry)\r\n End If<\/pre>\nConclusion<\/h3>\n
Of course all of this takes more effort in the coding\u00c2\u00a0but the code will be more robust if it avoids hard-coded values, and it will be easier for others to make simple changes.<\/p>\n","protected":false},"excerpt":{"rendered":"
On my first ever MIIS project we were an OCG customer so were able to use their nice XML library. I can’t remember in great detail what it did, but I’ve always considered the concept a best practise: if there’s anything that you find yourself hard-coding as a constant value in extension code, then you…<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","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":[42,34,28,30],"tags":[],"class_list":["post-1039","post","type-post","status-publish","format-standard","hentry","category-fim-2010","category-ilm2007","category-miis2003","category-vbnet"],"jetpack_publicize_connections":[],"jetpack_featured_media_url":"","jetpack_shortlink":"https:\/\/wp.me\/pkp1o-gL","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/www.wapshere.com\/missmiis\/wp-json\/wp\/v2\/posts\/1039","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=1039"}],"version-history":[{"count":10,"href":"https:\/\/www.wapshere.com\/missmiis\/wp-json\/wp\/v2\/posts\/1039\/revisions"}],"predecessor-version":[{"id":1050,"href":"https:\/\/www.wapshere.com\/missmiis\/wp-json\/wp\/v2\/posts\/1039\/revisions\/1050"}],"wp:attachment":[{"href":"https:\/\/www.wapshere.com\/missmiis\/wp-json\/wp\/v2\/media?parent=1039"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.wapshere.com\/missmiis\/wp-json\/wp\/v2\/categories?post=1039"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.wapshere.com\/missmiis\/wp-json\/wp\/v2\/tags?post=1039"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}