{"id":25,"date":"2023-03-21T03:29:20","date_gmt":"2023-03-21T03:29:20","guid":{"rendered":"https:\/\/brunocm.azurewebsites.net\/?page_id=25"},"modified":"2023-03-21T05:07:03","modified_gmt":"2023-03-21T04:07:03","slug":"part-7-add-our-property-page-to-msi","status":"publish","type":"page","link":"https:\/\/brunocm.azurewebsites.net\/?page_id=25","title":{"rendered":"Part 7 – Add our property page to MSI"},"content":{"rendered":"

Place our propertyPage into our MSI<\/h1>\n

In part 3, we created an MSI, you thought it was complex? This was just the beginning!<\/p>\n

As explained before, the complexity resides here in finding the base file location and its modification. Moreover, we will have to handle the cleanup of this file in case of removal.<\/p>\n

To achieve this, we will use the \u201cdirectorysearch\u201d feature of WIX to locate the file then some functions of the Wix utils toolbox to alter the XML file inline.<\/p>\n

We already locate the XmlStorage folder with:<\/p>\n

<Property <\/span>Id<\/span>=\"XMLSTORAGE\"<\/span> Secure<\/span>=\"yes\"<\/span>><\/span>\n     <DirectorySearch<\/span> Id<\/span>=\"CheckSubDir\"<\/span> Path<\/span>=\"[UIFOLDER]\"<\/span> Depth<\/span>=\"0\"<\/span>><\/span>\n       <DirectorySearch<\/span> Id<\/span>=\"xml_storage_search\"<\/span> Path<\/span>=\"XmlStorage\"<\/span> Depth<\/span>=\"5\"<\/span> \/><\/span>\n     <\/DirectorySearch><\/span>\n<\/Property><\/span><\/pre>\n
Now, we\u2019ll add the following lines to locate the \u201cextensions\/forms\u201d subfolder with the \u201cCollectionResource.xml\u201d file within if it exists.<\/p>\n
<Property<\/span> Id=\"EXTFORMFLD\"><\/span>\n   <DirectorySearchRef<\/span> Id<\/span>=\"xml_storage_search\"<\/span> Parent<\/span>=\"CheckSubDir\"<\/span> Path<\/span>=\"XmlStorage\"<\/span> ><\/span>\n      <DirectorySearch<\/span> Id<\/span>=\"extensions_fld_search\"<\/span> Path<\/span>=\"Extensions\"<\/span> Depth<\/span>=\"0\"<\/span> ><\/span>\n         <DirectorySearch<\/span> Id<\/span>=\"extforms_fld_search\"<\/span> Path<\/span>=\"Forms\"<\/span> Depth<\/span>=\"0\"<\/span> \/><\/span>\n      <\/DirectorySearch><\/span>\n   <\/DirectorySearchRef><\/span>\n<\/Property><\/span>\n<Property<\/span> Id<\/span>=\"FRMCOLLRESS\"<\/span>><\/span>\n   <DirectorySearchRef<\/span> Id<\/span>=\"extforms_fld_search\"<\/span> Parent<\/span>=\"extensions_fld_search\"<\/span> Path<\/span>=\"Forms\"<\/span> ><\/span>\n      <FileSearch<\/span> Id<\/span>=\"frmCollRess\"<\/span> Name<\/span>=\"CollectionResource.xml\"<\/span> \/><\/span>\n   <\/DirectorySearchRef><\/span>\n<\/Property><\/span><\/pre>\n
The result will be the creation of 2 properties containing respectively the path and the file name or false if the file is not found.<\/p>\n
Let\u2019s do this a second time to keep a reference to the original file.<\/p>\n
<Property<\/span> Id<\/span>=\"FORMFLD\"<\/span>><\/span>\n   <DirectorySearchRef<\/span> Id<\/span>=\"xml_storage_search\"<\/span> Parent<\/span>=\"CheckSubDir\"<\/span> Path<\/span>=\"XmlStorage\"<\/span> ><\/span>\n      <DirectorySearch<\/span> Id<\/span>=\"forms_fld_search\"<\/span> Path<\/span>=\"Forms\"<\/span> Depth<\/span>=\"0\"<\/span> \/><\/span>\n   <\/DirectorySearchRef><\/span>\n<\/Property><\/span>\n<Property<\/span> Id<\/span>=\"FRMCOLLRESSORIG\"<\/span>><\/span>\n   <DirectorySearchRef<\/span> Id<\/span>=\"forms_fld_search\"<\/span> Parent<\/span>=\"xml_storage_search\"<\/span> Path<\/span>=\"Forms\"<\/span> ><\/span>\n      <FileSearch<\/span> Id<\/span>=\"frmCollRessOrig\"<\/span> Name<\/span>=\"CollectionResource.xml\"<\/span> \/><\/span>\n    <\/DirectorySearchRef><\/span>\n <\/Property><\/span><\/pre>\n
You may have noticed that we used directorysearch only once for xmlstorage search. All other occurrences are replaced with directorysearchref tags having the same id. This is to reuse the search already done instead of processing it several times for nothing. We use the same behavior when searching for files within folders.<\/p>\n
Now, go ahead to the directory tree definition and add references to these folders<\/p>\n
<Directory<\/span> Id<\/span>=\"XMLSTORAGE\" Name<\/span>=\"XMLSTORAGE\"><\/span>\n   <Directory<\/span> Id<\/span>=\"EXTENSIONS\" Name<\/span>=\"Extensions\">\n<\/span>\u2026\u2026\n\u2026\u2026\n      <Directory<\/span> Id<\/span>=\"FORMS\" Name<\/span>=\"Forms\"\/><\/span>\n   <\/Directory><\/span>\n   <Directory<\/span> Id<\/span>=\"FORMSORIG\" Name<\/span>=\"Forms\"\/><\/span>\n<\/Directory><\/span><\/pre>\n
\n
As explained earlier, we need to rely on the Wix utils toolbox. So, in the project references add a new reference to the \u201cWixUtilExtension.dll\u201d file usually located in the \u201cbin\u201d subfolder of Wix installation path, then add the declaration of the specific namespace in the \u201cwix\u201d tag at beginning of the WXS file.<\/p>\n
Like this:<\/p>\n
<Wix xmlns=\"http:\/\/schemas.microsoft.com\/wix\/2006\/wi\" xmlns:util=\"http:\/\/schemas.microsoft.com\/wix\/UtilExtension\" <\/strong><\/span>xmlns:SystemTools=\"http:\/\/schemas.....<\/pre>\n
Wix Utils are ready to be used!<\/p>\n
Add your page project in the \u201csetup\u201d project references to make built files available.<\/p>\n
In the components section, we can now add a new component that will set the XML form file.<\/p>\n
<ComponentGroup<\/span> Id<\/span>=\"devicecollmembershipcomp\"<\/strong> Directory<\/span>=\"INSTALLDIR\"<\/strong>><\/span>\n   <Component<\/span> Id<\/span>=\"devicecollmembershipdllcomp\"<\/strong>><\/span>\n      <File<\/span> Id<\/span>=\"devicecollmembershipdll\"<\/strong> Source<\/span>=\"$(var.deviceCollMembershipProp.TargetPath)\"<\/strong> DiskId<\/span>=\"1\"<\/strong> KeyPath<\/span>=\"yes\"<\/strong> \/><\/span>\n   <\/Component><\/span>\n   <Component<\/span> Id<\/span>=\"formCollRessXml\"<\/strong> Guid<\/span>=\"GUID_AA\"<\/strong> KeyPath<\/span>=\"yes\"<\/strong>><\/span>\n      <CopyFile<\/span> Id<\/span>=\"formcolressxmlcpy\"<\/strong> SourceProperty<\/span>=\"FRMCOLLRESSORIG\"<\/strong> DestinationProperty<\/span>=\"EXTFORMFLD\"<\/strong>\/><\/span>\n      <Condition><\/span>NOT Installed AND NOT PATCH AND NOT FRMCOLLRESS<\/strong><\/Condition><\/span>\n   <\/Component><\/span>\n   <Component<\/span> Id<\/span>=\"colressformregistration\"<\/strong> Guid<\/span>=\"GUID_BB\"<\/strong> KeyPath<\/span>=\"yes\"<\/strong>><\/span>\n      <util:XmlConfig<\/span> Id<\/span>='mypage1delinst'<\/strong> On<\/span>=\"install\"<\/strong> Action<\/span>=\"delete\"<\/strong> Node<\/span>=\"element\"<\/strong> File<\/span>=\"[EXTFORMFLD]CollectionResource.xml\"<\/strong> ElementPath<\/span>=\"\/SmsFormData\/Form\/Pages\"<\/strong> VerifyPath<\/span>=\"\/SmsFormData\/Form\/Pages\/Page[\\[]@Id='{GUID-TARGET}'[\\]]\"<\/strong> Sequence<\/span>=\"1001\"<\/strong>\/><\/span>\n      <util:XmlConfig<\/span> Id<\/span>='mypage1'<\/strong> On<\/span>=\"install\"<\/strong> Action<\/span>=\"create\"<\/strong> Node<\/span>=\"element\"<\/strong> File<\/span>=\"[EXTFORMFLD]CollectionResource.xml\"<\/strong> ElementPath<\/span>=\"\/\/SmsFormData\/\/Form\/\/Pages\"<\/strong> Sequence<\/span>=\"1002\"<\/strong> Name<\/span>=\"Page\"<\/strong>><\/span>\n         <util:XmlConfig<\/span> Id<\/span>=\"mypage1xmlns\"<\/strong> ElementId<\/span>=\"mypage1\"<\/strong> Name<\/span>=\"xmlns\"<\/strong> Value<\/span>=\"http:\/\/schemas.microsoft.com\/SystemsManagementServer\/2005\/03\/ConsoleFramework\"<\/strong> File<\/span>=\"[EXTFORMFLD]CollectionResource.xml\"<\/strong>\/><\/span>\n         <util:XmlConfig<\/span> Id<\/span>=\"mypage1vendor\"<\/strong> ElementId<\/span>=\"mypage1\"<\/strong> Name<\/span>=\"VendorId\"<\/strong> Value<\/span>=\"me\"<\/strong> File<\/span>=\"[EXTFORMFLD]CollectionResource.xml\"<\/strong>\/><\/span>\n         <util:XmlConfig<\/span> Id<\/span>=\"mypage1id\"<\/strong> ElementId<\/span>=\"mypage1\"<\/strong> Name<\/span>=\"Id\"<\/strong> Value<\/span>=\"{GUID-TARGET}\"<\/strong> File<\/span>=\"[EXTFORMFLD]CollectionResource.xml\"<\/strong>\/><\/span>\n         <util:XmlConfig<\/span> Id<\/span>=\"mypage1Assembly\"<\/strong> ElementId<\/span>=\"mypage1\"<\/strong> Name<\/span>=\"Assembly\"<\/strong> Value<\/span>=\"$(var.dcmptargetDir)$(var.deviceCollMembershipProp.TargetFileName)\"<\/strong> File<\/span>=\"[EXTFORMFLD]CollectionResource.xml\"<\/strong>\/><\/span>\n         <util:XmlConfig<\/span> Id<\/span>=\"mypage1Namespace\"<\/strong> ElementId<\/span>=\"mypage1\"<\/strong> Name<\/span>=\"Namespace\"<\/strong> Value<\/span>=\"Microsoft.ConfigurationManagement.AdminConsole.DeviceCollMembership\"<\/strong> File<\/span>=\"[EXTFORMFLD]CollectionResource.xml\"<\/strong>\/><\/span>\n         <util:XmlConfig<\/span> Id<\/span>=\"mypage1Type\" <\/strong>ElementId<\/span>=\"mypage1\"<\/strong> Name<\/span>=\"Type\"<\/strong> Value<\/span>=\"DeviceCollMembershipPage\"<\/strong> File<\/span>=\"[EXTFORMFLD]CollectionResource.xml\"<\/strong>\/><\/span>\n         <util:XmlConfig<\/span> Id<\/span>=\"mypage1ReadOnly\"<\/strong> ElementId<\/span>=\"mypage1\" <\/strong>Name<\/span>=\"ReadOnly\"<\/strong> Value<\/span>=\"false\"<\/strong> File<\/span>=\"[EXTFORMFLD]CollectionResource.xml\"<\/strong>\/><\/span>\n         <util:XmlConfig<\/span> Id<\/span>=\"mypage1MultiSelection\"<\/strong> ElementId<\/span>=\"mypage1\"<\/strong> Name<\/span>=\"MultiSelection\"<\/strong> Value<\/span>=\"false\"<\/strong> File<\/span>=\"[EXTFORMFLD]CollectionResource.xml\"<\/strong>\/><\/span>\n         <util:XmlConfig<\/span> Id<\/span>=\"mypage1Visible\"<\/strong> ElementId<\/span>=\"mypage1\"<\/strong> Name<\/span>=\"Visible\"<\/strong> Value<\/span>=\"false\"<\/strong> File<\/span>=\"[EXTFORMFLD]CollectionResource.xml\"<\/strong>\/><\/span>\n      <\/util:XmlConfig><\/span>\n      <util:XmlConfig<\/span> Id<\/span>='mypage1del'<\/strong> On<\/span>=\"uninstall\"<\/strong> Action<\/span>=\"delete\"<\/strong> Node<\/span>=\"element\"<\/strong> File<\/span>=\"[EXTFORMFLD]CollectionResource.xml\"<\/strong> ElementPath<\/span>=\"\/SmsFormData\/Form\/Pages\" <\/strong>VerifyPath<\/span>=\"\/SmsFormData\/Form\/Pages\/Page[\\[]@Id='{GUID-TARGET}'[\\]]\"<\/strong> Sequence<\/span>=\"1003\"<\/strong>\/><\/span>\n   <\/Component><\/span>\n<\/ComponentGroup><\/span><\/pre>\n
Some people may find this obvious but some will not, so, here is a line by line explanation.<\/p>\n
<Component<\/span> Id<\/span>=\"devicecollmembershipdllcomp\"<\/strong>><\/span>\n      <File<\/span> Id<\/span>=\"devicecollmembershipdll\"<\/strong> Source<\/span>=\"$(var.deviceCollMembershipProp.TargetPath)\"<\/strong> DiskId<\/span>=\"1\"<\/strong> KeyPath<\/span>=\"yes\"<\/strong> \/><\/span>\n   <\/Component><\/span><\/pre>\n
nothing difficult there, we just add our brand new dll to the MSI.<\/p>\n
<Component<\/span> Id<\/span>=\"formCollRessXml\"<\/strong> Guid<\/span>=\"GUID_AA\"<\/strong> KeyPath<\/span>=\"yes\"<\/strong>><\/span>\n      <CopyFile<\/span> Id<\/span>=\"formcolressxmlcpy\"<\/strong> SourceProperty<\/span>=\"FRMCOLLRESSORIG\"<\/strong> DestinationProperty<\/span>=\"EXTFORMFLD\"<\/strong>\/><\/span>\n      <Condition><\/span>NOT Installed AND NOT PATCH AND NOT FRMCOLLRESS<\/strong><\/Condition><\/span>\n   <\/Component><\/span><\/pre>\n
This has to bee explained:
\nthe CollectionResource.xml file has to be copied from xmlstorage\\form to the xmlstorage\\extensions\\forms to be modified. this must only occur once at the first installation time. if the file is already present ( i.e. another 3rd party tools already use it), the target file should be overwritten. That is the purpose of the condition
\nNot Installed => almost clear: this tool should not be already present on this computer
\nNot patch => we don’t copy the file if we just update the tool
\nNot FRMCOLLRES => this is the result of our file search. this will be only positive if the target file has not been found<\/p>\n
If these 3 conditions are met, then we can copy the original to the extensions folder. ( don’t forget to place your own generated GUID in the dedicated property.<\/p>\n
The last component is nothing more than the inline edition of the XML file.<\/p>\n
The first element (id=mypage1delinst) can look like a bit strange as this is a deletion. I have to explain why it exists.
\n“util:XmlConfig” can be conditionnally used depending on the value of its “ON” property. the problem is that this property only allows two values: install or uninstall.
\nBut how do we manage an update? An update is also a kind of installation so the added line will be duplicated.
\nThis is why I’ve added the same deletion task on installation and uninstallation (last XmlConfig element of the component). With this workaround, I ensure that the line is removed before recreating it. ( no more duplicate )<\/p>\n
For people who don’t understand this, ‘ VerifyPath=”\/SmsFormData\/Form\/Pages\/Page[\\[]@Id='{GUID-TARGET}'[\\]]”<\/em> ‘ is an XPath definition. Look around on the internet and you surely will find interting readings about this way of targeting XML elements.<\/p>\n
The next lines define the creation of the new xml element ( surrounding XmlConfig ) with several nested XmlConfig to define all it’s properties.<\/p>\n
XmlConfig Id=’mypage1’ On=”install” Action=”create” Node=”element” File=”[EXTFORMFLD]CollectionResource.xml” ElementPath=”\/\/SmsFormData\/\/Form\/\/Pages” Sequence=”1002″ Name=”Page”
\n->We create a new element during installation the file specified under the SmsFormData\\Form\\Pages element.<\/span><\/p>\n
Here is the definition of the first properties. As they’re all constructed the same way, I will explain only this one.<\/p>\n
util:XmlConfig Id=”mypage1vendor” ElementId=”mypage1″ Name=”VendorId” Value=”me” File=”[EXTFORMFLD]CollectionResource.xml”<\/p>\n
ElementId=”mypage1″ => even if this element is surrounded by the Xmlconfig element that creates the XML object, we must declare a reference to it ( I don’t understand why but this is mandatory. other users over internet complain about this behavior)<\/p>\n
Name=”VendorId” => easy ! this is the name of the new property
\nValue=”me” => and then it’s value ^^<\/p>\n
File=”[EXTFORMFLD]CollectionResource.xml” => there again something I don’t understand. Why do we need to redefine the target file when we already have a reference to an existing Xml object in a specific file.<\/p>\n
Attention: You may have noticed that the first element redefine the xmlns property. Skilled people may wonder why I did that instead of relying on the default namespace. Answer: This extension will redefine it anyway. if you don’t redefine it, you will end with an xmlns=”” <\/em>entry making your new element ‘invisible’ for the SCCM console.<\/p>\n
That’s all!<\/p>\n
The last XmlConfig item should be quite easy to understand now that you already read all this!<\/p>\n","protected":false},"excerpt":{"rendered":"
Place our propertyPage into our MSI In part 3, we created an MSI, you thought it was complex? This was just the beginning! As explained before, the complexity resides here in finding the base file location and its modification. Moreover, we will have to handle the cleanup of this file in case of removal. To … Continue reading “Part 7 – Add our property page to MSI”<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"_sitemap_exclude":false,"_sitemap_priority":"","_sitemap_frequency":""},"_links":{"self":[{"href":"https:\/\/brunocm.azurewebsites.net\/index.php?rest_route=\/wp\/v2\/pages\/25"}],"collection":[{"href":"https:\/\/brunocm.azurewebsites.net\/index.php?rest_route=\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/brunocm.azurewebsites.net\/index.php?rest_route=\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/brunocm.azurewebsites.net\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/brunocm.azurewebsites.net\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=25"}],"version-history":[{"count":0,"href":"https:\/\/brunocm.azurewebsites.net\/index.php?rest_route=\/wp\/v2\/pages\/25\/revisions"}],"wp:attachment":[{"href":"https:\/\/brunocm.azurewebsites.net\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=25"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}