*** This interface provides Binary Compatibility only, not Source Compatibility ***

Interface VirtualFolderInterface

All Superinterfaces:
FolderInterface, MetadataInterface, MutableContainerInterface, PublicObjectContainerInterface, PublicObjectInterface, Remote
All Known Implementing Classes:
ServerVirtualFolder, VirtualFolder

@SASScope("ALL") @BinaryCompatibilityOnly public interface VirtualFolderInterface extends FolderInterface
Interface used to model a virtual folder contained within the SAS Folders tree. A virtual folder looks just like a regular folder, and in fact this interface extends from FolderInterface. However, a virtual folder does not exist in metadata. These objects are actually generated dynamically by the client and are thought of as an "in-memory" object.

Because a virtual folder does not exist within metadata, there are many operations that cannot be performed that are typically used by other smart objects, including folders. This means that a virtual folder cannot have permissions set on it, it cannot be renamed, and it cannot be deleted.

A virtual folder will only exist within a repository's System folder. Each virtual folder in the repository can only contain either nested virtual folders or public objects that are not normally contained by other public objects, including a folder. An example of objects that can be found under a virtual folder includes Users and Server definitions.

Since:
9.3
  • Method Details

    • addSubfolder

      void addSubfolder(VirtualFolderInterface folder) throws ServiceException, RemoteException
      Adds a nested virtual folder.
      Parameters:
      folder - a sub or nested virtual folder
    • getSearchManager

      Search getSearchManager() throws ServiceException, RemoteException
      Returns the search manager that is used to populate the contents of a virtual folder.
      Returns:
      search manager