Grooper Help - Version 25.0
25.0.0017 2,127
  • Overview
  • Help Status

NTFS

Custom Binding Grooper.CMIS

Defines a connection to the Microsoft Windows™ file system.

Remarks

WindowsFileSystem provides a CMIS-compatible binding for connecting Grooper to directories on the Microsoft Windows file system (NTFS).


Overview

This class enables Grooper to:

  • Mount one or more Windows file system directories as CMIS Repositories.
  • Expose each repository as a tree structure that mirrors the file system hierarchy (folders and files).
  • Perform CMIS operations (query, create, update, delete, move, etc.) on files and folders.
  • Optionally enable search functionality using Windows Search for full-text and metadata queries.

Repository Mapping

  • Each configured directory is imported as a separate CMIS Repository.
  • The repository exposes a hierarchical file system (folders and files) using standard CMIS types.
  • File and folder metadata are mapped to CMIS properties, including file attributes (e.g., Hidden, ReadOnly, System, Archive).

Search Capabilities

  • If enabled, repositories can be queried using CMISQL for both full-text and metadata searches.

  • Full-text search leverages the Windows Search service and supports the CONTAINS() predicate.

  • Example search expressions:

    Type Description Example CMISQL
    Word Single word computer CONTAINS('computer')
    Phrase Multiple words or spaces "computer software" CONTAINS('"computer software"')
    Wildcard Words/phrases with * at the end "compu*" CONTAINS('"compu*"')
    Boolean AND, OR, NOT operators "A" AND "B" NOT "C" CONTAINS('"A" AND "B" AND NOT "C"')
    Near NEAR operator "A" NEAR "B" CONTAINS('"A" NEAR "B"')
  • See Windows Search CONTAINS() Predicate for full syntax.


Usage Notes

  1. Configure Repositories
    • Define one or more directories to be exposed as repositories using the Repositories property.
    • Use UNC paths (e.g., \\Server\Share\Path) for maximum compatibility.
  2. Enable Search (Optional)
    • To enable search, ensure Windows Search is running and the directory is indexed.
    • Set the EnableSearch property in the repository configuration.
  3. Repository Operations
    • Browse, search, and manage files and folders using standard CMIS operations.

Security Considerations

  • Access permissions are determined by the Windows user context under which Grooper is running.
  • Setting a repository as ReadOnly prevents write operations through Grooper.
  • Avoid exposing sensitive directories unless necessary.

Limitations

  • Only NTFS file systems are supported.
  • Windows Search must be enabled and properly configured for search functionality.
  • Some advanced NTFS features (e.g., alternate data streams, extended attributes) are not exposed.
  • File system changes made outside Grooper may not be immediately reflected until the next refresh.

References


> Note: This class is intended for use within Grooper's CMIS infrastructure and is not a general-purpose file system client.

Properties

NameTypeDescription

See Also

Used By

Notification