FAQ: MacroView DMF and MacroView Message search panels



What is MacroView DMF Search?

MacroView DMF Search allows you to search a SharePoint environment associated with MacroView DMF or MacroView Message for documents and emails based on a set of predefined search fields. 

MacroView DMF and Message ship with two default search panels: Email Search and Keyword Search. They are configured to search based on the terms pictured below. 



Both search panels work with a standard set of MacroView columns that are mapped to associated managed properties in search.

Note: Managed properties must be defined and mapped correctly for the search panels to work. To find out more, read an Overview of crawled and managed properties in SharePoint Server 2013 at Microsoft TechNet.

If you are using SharePoint Server (on-premises), the crawled properties and managed properties needed for Email Search and Keyword Search will be mapped automatically after enabling MacroView DMF Search on Web Application Features and running a full site crawl (see MacroView DMF Installation and Configuration Guide: Section 3.6).

If you are using SharePoint Online (Office 365), the crawled properties and managed properties needed for Email Search and Keyword Search must be mapped manually. Refer to Search configuration of SharePoint Online for a detailed walkthrough.

Back to top ↑


Can I create custom search panels?

Yes! You can add new controls to an existing search panel, or define additional new search panels by editing the Search Mask XML definition file (note: search masks use managed properties as their source). MacroView recommends creating new search panels rather than editing the ones provided since you can create search panels that reflect the metadata structure and requirements of your organisation.

Though the default search panels should not be edited, these panels can be used as examples for creating new tailored-search panels for your organisation.

To find out how to create your own custom search panels, read Defining custom search panels for DMF and Message.

For more information regarding how managed properties work with MacroView Search powered by SharePoint, refer to Defining managed properties for search panels.

Back to top ↑


Where are the Search Mask XML definition files located?

SharePoint Server (on-premises)

MacroView DMF search panels for SharePoint Server (on-premises) can be found on your server at the following location:

C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\XX\TEMPLATE\FEATURES\MacroViewDMFSearch\SearchMasks.xml

The Email Search and Keyword Search panels are available in MacroView DMF if the MacroView DMF Search feature is active on the content web-application.


SharePoint Online (Office 365) or Client-Side Only Mode

When using MacroView DMF with SharePoint Online (Office 365) or against an on-premises server using Client-Side Only mode, the search panel definition can be found at the following location on the client machine:

C:\Users\<USERNAME>\AppData\Roaming\MacroView DMF\Store\O365Mask.xml

If the O365Masks.xml file is invalid or not present, MacroView DMF will continue to provide the default set of search masks, alternatively you can download a new copy of the file from the MacroView DMF or MacroView Message downloads page.

Back to top ↑


How do I get started creating a custom search panel? 

There are two steps to getting your custom search panel up and running:

  1. Construct your own search panel by building a Search Mask XML definition. For everything you need to know about building your own Search Mask XML definition including how to define the name, source, controls and more, refer to Defining custom search panels for DMF and Message.
  2. Share your search mask with SharePoint by:
    • (On-premises) Uploading it to your SharePoint Server, or
    • (Online/Office 365 only) Linking the Search Mask XML definition with MacroView DMF

MacroView consultants are experts in SharePoint document management and can assist you in customising your search based on your organisation's unique requirements.

Back to top ↑


How do I upload and install a custom search panel?

See the following knowledge base article for detailed steps: Installing a custom search panel

Back to top ↑


Related Articles:

Have more questions? Submit a request


Article is closed for comments.