MacroView DMF and Message version 8.5.1097 and later has support for setting a central location to update the configuration files stored in your MacroView user settings* folder.
This is great news for system administrators, allowing them to deploy user settings to all members in their organisation with the click of a button.
How it works
You can store your configuration files such as 'TreeNodesToHide.xml', localisation files and other configuration files for DMF/Message plug-ins in a central (common) location in SharePoint and set up your user's DMF client to retrieve these files from that central location.
This will save you time from having to manually deploy common user settings to each individual machine or risk users making an error if installing it themselves.
The following are just a few of the configuration files currently supported.
- MacroView Case and Matter - Create Matter
- MacroView Project - Create Projects
- MacroView Solution Provisioning
- MacroView DMF and Message extension configurations
- Language resource files (rebranding)
- Default Person/Group
- Map Folder Name to field Value
- Create New Document
Creating a central configuration (resource) location
The central configuration location can be any library in SharePoint. Some configuration files are located directly in this location and others need to be located in a sub folder of the specified location.
You can create the central configuration location and folder structure and upload configuration files to it manually or use MacroView Solution Provisioning to create a sample resource library with sample content by selecting Provision > New Library > MacroView Resource Library.
Configuring DMF or Message to use the central configuration location
The Central Configuration Location (Resource Library) is set in the Store Folder Preferences section of the Support tab in MacroView Options:
The Central Configuration Location is specified in the Text field. Click the double dots on the right of the text field to browse your SharePoint environment and locate your desired central configuration location.
Once you've applied your settings in the MacroView Options menu, DMF/Message will check that location once every 24 hours for any required configuration files, or configuration file updates, and will automatically download them to your user's machine.
In MacroView DMF Client version 8.9.798 and later the configuration data is automatically refreshed periodically or immediately when selecting a new central configuration location and closing the options window.
Deploying to your users
To deploy these setting to your users, copy the resulting entries in the following registry branch and push them to your users via Group Policy:
* - User settings folder refers to %appdata%/MacroView DMF/Store
* - From 8.8.519 File shares are no longer available to be selected as a location
Manually updating and refreshing resource files
DMF Client 8.8.520 and newer includes a "Refresh Configuration Data" button that will check and replace any files that do not exist or that have been updated in the central configuration location (resource library).
DMF will also check periodically if the resource files have been updated.
Setting the configuration refresh interval via the registry
The refresh check interval can be controlled by the 2 registry settings below located under \HKEY_CURRENT_USER\SOFTWARE\MacroView\DMF\UserOptions
ConfigurationDataMaxItemCount = 2000
This is an integer value that specifies the maximum number of items in the central resources library. If the library item count exceeds this number, no configuration data is downloaded and an error message is logged.
ConfigurationDataRefreshCronInterval = * * * * *
By default this is set to check daily.
This is a cron expression that specifies how often the periodic refresh mechanism is triggered. (see https://en.wikipedia.org/wiki/Cron for more information about cron)
In MacroView DMF Client version 8.9.798 and late changes made to most configuration files in the central configuration location are updated automatically without having to restarting DMF.