Configuring File system settings
Two file system behavior settings, related to how a user interacts with documents on the file system using Discovery Search, can be modified by administrators under the Application settings menu:
permissions
links (located in the Customization section)
Permissions
Each file path of a search result is permission checked at the time of execution. When this feature is enabled, Discovery Search impersonates the user to perform the Windows permission check on the full file path of each search result. Items the user does not have permission for are not displayed in the search result.
Administrators can:
modify the number of items simultaneously permission checked while results are being fetched
enable or disable the directory permission check optimization
Concurrent permission checks
The default is eight (8). We recommend this as the most performant number of concurrent checks. Greatly increasing this value may result in disruptive latency during the permission-check process before search results are displayed to the user. Conversely, there may not be a noticeable increase in performance if this value is increased marginally.
Directory permission check optimizations
This setting is enabled by default. It discards irrelevant search results based on directory mappings, to improve search result performance.
Before Discovery Search runs a permission check, the path to each result is deconstructed; each path component is checked for read access permissions and those rights are cached. This cache of permissions is created per user. Subsequent permission checks for files with the same path are first checked against the directory cache. Files elsewhere in that hierarchy are compared against the directory cache only, so no direct file access occurs. Only the immediate parent is checked for permissions, reducing the search process overhead.
Customization
Discovery Search supports four types of actions when a user clicks the title of a search result and that result is located on a file share.
File system setting | User experience |
---|---|
copy-to-clipboard (default) | Copy link to clipboard |
download | Download file |
open-browser | Open file in a web browser |
open-protocol | Open file from the file system location |
For the open-browser option, certain file types cannot be opened in modern browsers and may result in the file downloading instead.
The open-protocol option is available if the Shinydocs Protocol has been installed on user machines.