- What is MacroView DMF Search?
- Can I create custom search panels?
- Where are the Search Mask XML definitions located?
- How do I create a custom search panel?
- How do I upload and install a custom search panel?
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 metadata properties listed below.
Before you can start using the search panels, you must ensure that the search managed properties have been defined and mapped to correspond with the panels shown above. 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 the MacroView DMF Search feature under 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.
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 so 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.
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, unless you have a Client Side Search Mask Location set under DMF Options, the default search panel definition can be found at the following location on the client machine:
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.
There are two steps to getting your custom search panel up and running:
- 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.
- 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 requirements.
See the following knowledge base article for detailed steps: Installing a custom search panel.