HostDatastoreBrowserSearchSpec

HostDatastoreBrowserSearchSpec
HostDatastoreBrowserSearchSpec

The data object type describes a search for files in one or more datastores.

The properties do not include the starting datastore path because that path is a separate parameter to the search method.

A SearchSpec contains the query parameters and some global search modifiers.

AllOf
This class requires all of the following:
JSON Example
{
    "_typeName": "string",
    "query": [
        {
            "_typeName": "string"
        }
    ],
    "details": {
        "_typeName": "string",
        "fileType": false,
        "fileSize": false,
        "modification": false,
        "fileOwner": false
    },
    "searchCaseInsensitive": false,
    "matchPattern": [
        "string"
    ],
    "sortFoldersFirst": false
}
array of FileQuery
query
Optional

The set of file types to match, search criteria specific to the file type, and the amount of detail for a file.

These search parameters are specific to a file type, meaning that they can be specified only if the file type to which they are associated is in the set. A file type cannot appear more than once in the set.

If this query object is not present, then all files providing only file level details are matched.

details
Optional

The FileInfo.Details data object type is a set of flags for a search request.

This search request specifies which details to return for each matching file. This data object type is here to ensure that there is one flag corresponding to each FileInfo property other than the path name, which a search always returns.

boolean
searchCaseInsensitive
Optional

This flag indicates whether or not to search using a case insensitive match on type.

In general the algorithm used to match file types relies on file extensions. Although the specific file extensions used are encapsulated by this API, clients are still allowed to modify the filtering behavior.

By default, the DatastoreBrowser uses a platform-consistent algorithm to determine if a file is of a type. Specifically on Linux, where case is important, the search is case sensitive. On Windows, case is not important, so the search is case insensitive.

In an environment with heterogenous platforms, being platform-consistent may not be desirable. As a result, the default behavior can be overridden by setting this optional flag.

array of string
matchPattern
Optional

Specifies a list of file patterns that must match for a file to be returned.

This search property is a filter that applies globally so that only files matching the specified patterns are returned, regardless of the other search parameters.

boolean
sortFoldersFirst
Optional

By default, files are sorted in alphabetical order regardless of file type.

If this flag is set to "true", folders are placed at the start of the list of results in alphabetical order. The remaining files follow in alphabetical order.