Where a node in the MacroView tree has a large number of sub-nodes (site, libraries, folders etc.) navigation is made easier by the way MacroView allows you to filter the sub-nodes so that only those whose titles contain some nominated text are displayed. To apply the filter you right-click a node (either a Site Collection, Site or a Library) and choose Filter Hubs and Sites or Filter Sites and Libraries from the menu, depending on which type of node is selected.
Filter Hubs and Sites
When selecting Filter Hubs and Sites from the menu on a server, hub or site node, the Filter Hubs and Sites dialog will appear (see below). Type in the text to be used for filtering and then click Filter. The Filter button will only be enabled once a minimum of 2 characters (by default) have been entered for the filter text.
In DMS 9.3 and later, you can filter on multiple terms. After entering a term hit enter, it will be added to the filter. Multi-term filtering will return results matching any term ([Term A] OR [Term B] OR [Term C], etc).
The filtered results will be displayed and the Filter icon will be displayed in front of the Site or Library that has been filtered.
If there are no sites or libraries matching the entered filter text a message will be displayed advising that no matches were found and no sub-node will be displayed.
If a manually applied filter is already present on the selected node the previous filter text will be pre-populated by default.
Filter Sites and Libraries
When the user select Filter Sites and Libraries from the right-click menu on a site collection or site, the filter dialog is displayed. In MacroView 8.6.82 or later the filter dialog includes additional options to restrict the nodes returned by the filter to only show sites or only show libraries.
The filtered results will be displayed and a ‘Filter’ icon will be displayed adjacent to the Site or Library that has been filtered.
Note: When either the Sites only or Libraries only options is selected the Show All button is always enabled, even if there are more of sub nodes of that type than has been defined as the as the Nodes to Block "Show All" option in under MacroView Options (see below).
Filtering Site Collections
When you right-click on a Server or SharePoint Online tenant node in the MacroView tree-view, the right-click menu contains a Filter Site Collections option. The usage is identical to Filter Sites and Libraries above but without the options to filter only on sites and libraries individually.
This command is subject to the Nodes to Trigger Filter and Nodes to Block ‘Show All’ configuration settings described below.
Timeout when expanding a node
If expanding a node takes longer than the currently specified connection timeout limit MacroView will display the loading icon in the tree-view and if appropriate the filter dialog.
Change or remove filtering
To change or remove the filter for the node enter a new filter or choose Show All to remove the filter from the node. If no matches are found no site or libraries are added to the tree-view.
You can also remove a filter using the Clear Filter right click option.
If there are more child nodes than defined by the Nodes to Trigger Filter setting, the filter dialog is re-displayed, so a new filter can be entered.
Automatic filtering of the tree view
MacroView provides an intuitive tree-view display, but it is designed to avoid retrieving too much site and library information in one round trip to the SharePoint server. The advantage is that MacroView performance when rendering the SharePoint tree is consistently good and bandwidth usage is efficient.
MacroView provides two configuration settings in Options > Appearance to control the operation of automatic filtering:
- Nodes to Trigger Filter
- Nodes to Block ‘Show All’
The Nodes to Trigger Filter setting specifies the maximum number of nodes that MacroView will retrieve without first displaying the filtering prompt. The default value for this configuration is 200 nodes, which has been shown to provide acceptable performance in most environments. Users with a low bandwidth connection and / or a slow or heavily loaded SharePoint server might want to specify a lower limit.
The Nodes to Block ‘Show All’ setting controls whether the ‘Show All’ button is displayed in the Filter dialog. The default value for this configuration is 500 nodes. If the number of sub-nodes is greater than the value of this setting, the Show All button will not be displayed. This is to prevent accidental retrieval of an excessive number of nodes, which wastes machine resources and can cause a timeout.
These configuration settings can be viewed and adjusted using the File, Options dialog and choosing the Appearance tab.
When you right click on a Library node you can choose Filter Folders from the right-click menu. The usage is identical to Filter Sites Collections above. Note that if the Library has Metadata Navigation defined, you will need to click on the Folders heading.
For more information on filtering in MacroView see Filtering in the MacroView tree-view