Interface FilesAndFoldersInterface

  • All Known Implementing Classes:
    FilesAndFoldersClient

    public interface FilesAndFoldersInterface
    FilesAndFoldersInterface is the interface used to record metadata about files and folders. It can be used to create metadata both on behalf of a file system or a file manager application. If this is being used for files and folders in a file system, leave the fileManagerCapabilityGUID and fileManagerCapabilityName parameters as null. If the files and folders are owned by a file manager application and you want the corresponding assets in the catalog to be locked read only to all but the integration technology managing the metadata then set fileManagerCapabilityGUID and fileManagerCapabilityName to the GUId and qualified name of a software server capability that represents the file manager.
    • Method Summary

      All Methods Instance Methods Abstract Methods 
      Modifier and Type Method Description
      java.util.List<java.lang.String> addDataFileToCatalog​(java.lang.String userId, java.lang.String fileManagerCapabilityGUID, java.lang.String fileManagerCapabilityName, DataFileProperties dataFileProperties, java.lang.String connectorProviderName)
      Creates a new file asset and links it to the folder structure implied in the path name.
      java.util.List<java.lang.String> addDataFileToCatalogFromTemplate​(java.lang.String userId, java.lang.String fileManagerCapabilityGUID, java.lang.String fileManagerCapabilityName, java.lang.String templateGUID, TemplateProperties templateProperties)
      Add an asset description a file based on the content of a template object.
      java.util.List<java.lang.String> addDataFolderToCatalog​(java.lang.String userId, java.lang.String fileManagerCapabilityGUID, java.lang.String fileManagerCapabilityName, FileFolderProperties fileFolderProperties, java.lang.String connectorProviderName)
      Creates a new folder asset that is identified as a data asset.
      java.util.List<java.lang.String> addDataFolderToCatalogFromTemplate​(java.lang.String userId, java.lang.String fileManagerCapabilityGUID, java.lang.String fileManagerCapabilityName, java.lang.String templateGUID, TemplateProperties templateProperties)
      Creates a new folder asset that is identified as a data asset using a template.
      void archiveDataFileInCatalog​(java.lang.String userId, java.lang.String fileManagerCapabilityGUID, java.lang.String fileManagerCapabilityName, java.lang.String dataFileGUID, ArchiveProperties archiveProperties)
      Remove the file asset description from the catalog.
      void archiveDataFolderInCatalog​(java.lang.String userId, java.lang.String fileManagerCapabilityGUID, java.lang.String fileManagerCapabilityName, java.lang.String dataFolderGUID, ArchiveProperties archiveProperties)
      Mark the data folder asset description in the catalog as archived.
      void attachDataFileAssetToFolder​(java.lang.String userId, java.lang.String fileManagerCapabilityGUID, java.lang.String fileManagerCapabilityName, java.lang.String folderGUID, java.lang.String fileGUID)
      Link an existing file asset to a folder.
      void attachTopLevelFolder​(java.lang.String userId, java.lang.String fileManagerCapabilityGUID, java.lang.String fileManagerCapabilityName, java.lang.String fileSystemGUID, java.lang.String folderGUID)
      Links a folder to a file system.
      java.util.List<java.lang.String> createNestedFolders​(java.lang.String userId, java.lang.String fileManagerCapabilityGUID, java.lang.String fileManagerCapabilityName, java.lang.String parentGUID, java.lang.String pathName)
      Creates a new folder asset for each element in the pathName that is linked from the parent entity.
      void deleteDataFileFromCatalog​(java.lang.String userId, java.lang.String fileManagerCapabilityGUID, java.lang.String fileManagerCapabilityName, java.lang.String dataFileGUID, java.lang.String fullPathname)
      Remove the file asset description from the catalog.
      void deleteDataFolderFromCatalog​(java.lang.String userId, java.lang.String fileManagerCapabilityGUID, java.lang.String fileManagerCapabilityName, java.lang.String dataFolderGUID, java.lang.String fullPathname)
      Remove the data folder asset description from the catalog.
      void detachDataFileAssetFromFolder​(java.lang.String userId, java.lang.String fileManagerCapabilityGUID, java.lang.String fileManagerCapabilityName, java.lang.String folderGUID, java.lang.String fileGUID)
      Remove a link between a file asset and a folder.
      void detachTopLevelFolder​(java.lang.String userId, java.lang.String fileManagerCapabilityGUID, java.lang.String fileManagerCapabilityName, java.lang.String fileSystemGUID, java.lang.String folderGUID)
      Removed the link between a folder and a file system.
      java.util.List<DataFileElement> findFilesByPathName​(java.lang.String userId, java.lang.String pathName, int startFrom, int pageSize)
      Retrieve data files by the supplied wildcard name.
      DataFileElement getFileByGUID​(java.lang.String userId, java.lang.String fileGUID)
      Retrieve a FolderProperties asset by its unique identifier (GUID).
      DataFileElement getFileByPathName​(java.lang.String userId, java.lang.String pathName)
      Retrieve a folder by its fully qualified path name.
      FileFolderElement getFolderByGUID​(java.lang.String userId, java.lang.String folderGUID)
      Retrieve a FolderProperties asset by its unique identifier (GUID).
      FileFolderElement getFolderByPathName​(java.lang.String userId, java.lang.String pathName)
      Retrieve a folder by its fully qualified path name.
      java.util.List<DataFileElement> getFolderFiles​(java.lang.String userId, java.lang.String folderGUID, int startFrom, int pageSize)
      Get the data files inside a folder - both those that are nested and those that are linked.
      java.util.List<FileFolderElement> getNestedFolders​(java.lang.String userId, java.lang.String parentFolderGUID, int startFrom, int pageSize)
      Return the list of folders nested inside a folder.
      java.util.List<DataFileElement> getTopLevelDataFiles​(java.lang.String userId, java.lang.String fileSystemGUID, int startFrom, int pageSize)
      Return the list of folders nested inside a folder.
      java.util.List<FileFolderElement> getTopLevelFolders​(java.lang.String userId, java.lang.String fileSystemGUID, int startFrom, int pageSize)
      Return the list of folders linked to the file server capability.
      void moveDataFileInCatalog​(java.lang.String userId, java.lang.String fileManagerCapabilityGUID, java.lang.String fileManagerCapabilityName, java.lang.String folderGUID, java.lang.String fileGUID)
      Move a data file from its current parent folder to a new parent folder - this changes the file's qualified name but not its unique identifier (guid).
      void moveDataFolderInCatalog​(java.lang.String userId, java.lang.String fileManagerCapabilityGUID, java.lang.String fileManagerCapabilityName, java.lang.String folderGUID, java.lang.String dataFolderGUID)
      Move a data folder from its current parent folder to a new parent folder - this changes the folder's qualified name but not its unique identifier (guid).
      void updateDataFileInCatalog​(java.lang.String userId, java.lang.String fileManagerCapabilityGUID, java.lang.String fileManagerCapabilityName, java.lang.String dataFileGUID, boolean isMergeUpdate, DataFileProperties dataFileProperties)
      Update the file asset description in the catalog.
      void updateDataFolderInCatalog​(java.lang.String userId, java.lang.String fileManagerCapabilityGUID, java.lang.String fileManagerCapabilityName, java.lang.String dataFolderGUID, boolean isMergeUpdate, FileFolderProperties fileFolderProperties)
      Update the data folder asset description in the catalog.
    • Method Detail

      • createNestedFolders

        java.util.List<java.lang.String> createNestedFolders​(java.lang.String userId,
                                                             java.lang.String fileManagerCapabilityGUID,
                                                             java.lang.String fileManagerCapabilityName,
                                                             java.lang.String parentGUID,
                                                             java.lang.String pathName)
                                                      throws InvalidParameterException,
                                                             UserNotAuthorizedException,
                                                             PropertyServerException
        Creates a new folder asset for each element in the pathName that is linked from the parent entity. For example, a pathName of "one/two/three" creates 3 new folder assets, one called "one", the next called "one/two" and the last one called "one/two/three".
        Parameters:
        userId - calling user
        fileManagerCapabilityGUID - unique identifier of the software server capability representing an owning external file manager or null
        fileManagerCapabilityName - unique name of the software server capability representing an owning external file manager or null
        parentGUID - unique identifier of root object to connect the folder to (fileSystemGUID or folderGUID)
        pathName - pathname of the folder (or folders)
        Returns:
        list of GUIDs from the top level to the leaf of the supplied pathname
        Throws:
        InvalidParameterException - one of the parameters is null or invalid
        PropertyServerException - problem accessing property server
        UserNotAuthorizedException - security access problem
      • attachTopLevelFolder

        void attachTopLevelFolder​(java.lang.String userId,
                                  java.lang.String fileManagerCapabilityGUID,
                                  java.lang.String fileManagerCapabilityName,
                                  java.lang.String fileSystemGUID,
                                  java.lang.String folderGUID)
                           throws InvalidParameterException,
                                  UserNotAuthorizedException,
                                  PropertyServerException
        Links a folder to a file system. The folder is not changed.
        Parameters:
        userId - calling user
        fileManagerCapabilityGUID - unique identifier of the software server capability representing an owning external file manager or null
        fileManagerCapabilityName - unique name of the software server capability representing an owning external file manager or null
        fileSystemGUID - unique identifier of the file system to connect folder to
        folderGUID - unique identifier of the folder in the catalog
        Throws:
        InvalidParameterException - one of the parameters is null or invalid
        PropertyServerException - problem accessing property server
        UserNotAuthorizedException - security access problem
      • detachTopLevelFolder

        void detachTopLevelFolder​(java.lang.String userId,
                                  java.lang.String fileManagerCapabilityGUID,
                                  java.lang.String fileManagerCapabilityName,
                                  java.lang.String fileSystemGUID,
                                  java.lang.String folderGUID)
                           throws InvalidParameterException,
                                  UserNotAuthorizedException,
                                  PropertyServerException
        Removed the link between a folder and a file system.
        Parameters:
        userId - calling user
        fileManagerCapabilityGUID - unique identifier of the software server capability representing an owning external file manager or null
        fileManagerCapabilityName - unique name of the software server capability representing an owning external file manager or null
        fileSystemGUID - unique identifier of the file system to disconnect folder from
        folderGUID - unique identifier of the folder in the catalog
        Throws:
        InvalidParameterException - one of the parameters is null or invalid
        PropertyServerException - problem accessing property server
        UserNotAuthorizedException - security access problem
      • addDataFileToCatalog

        java.util.List<java.lang.String> addDataFileToCatalog​(java.lang.String userId,
                                                              java.lang.String fileManagerCapabilityGUID,
                                                              java.lang.String fileManagerCapabilityName,
                                                              DataFileProperties dataFileProperties,
                                                              java.lang.String connectorProviderName)
                                                       throws InvalidParameterException,
                                                              UserNotAuthorizedException,
                                                              PropertyServerException
        Creates a new file asset and links it to the folder structure implied in the path name. If the folder structure is not catalogued already, this is created automatically using the createFolderStructureInCatalog() method. For example, a pathName of "one/two/three/MyFile.txt" potentially creates 3 new folder assets, one called "one", the next called "one/two" and the last one called "one/two/three" plus a file asset called "one/two/three/MyFile.txt".
        Parameters:
        userId - calling user
        fileManagerCapabilityGUID - unique identifier of the software server capability representing an owning external file manager or null
        fileManagerCapabilityName - unique name of the software server capability representing an owning external file manager or null
        dataFileProperties - details of the data file to add to the catalog as an asset
        connectorProviderName - class name of connector provider for connector to access this asset
        Returns:
        list of asset GUIDs from the top level to the root of the pathname
        Throws:
        InvalidParameterException - one of the parameters is null or invalid
        PropertyServerException - problem accessing property server
        UserNotAuthorizedException - security access problem
      • addDataFileToCatalogFromTemplate

        java.util.List<java.lang.String> addDataFileToCatalogFromTemplate​(java.lang.String userId,
                                                                          java.lang.String fileManagerCapabilityGUID,
                                                                          java.lang.String fileManagerCapabilityName,
                                                                          java.lang.String templateGUID,
                                                                          TemplateProperties templateProperties)
                                                                   throws InvalidParameterException,
                                                                          UserNotAuthorizedException,
                                                                          PropertyServerException
        Add an asset description a file based on the content of a template object. Link this new asset to the folder structure implied in the path name. If the folder structure is not catalogued already, this is created automatically using the createFolderStructureInCatalog() method. For example, a pathName of "one/two/three/MyFile.txt" potentially creates 3 new folder assets, one called "one", the next called "one/two" and the last one called "one/two/three" plus a file asset called "one/two/three/MyFile.txt".
        Parameters:
        userId - calling user
        fileManagerCapabilityGUID - unique identifier of the software server capability representing an owning external file manager or null
        fileManagerCapabilityName - unique name of the software server capability representing an owning external file manager or null
        templateGUID - unique identifier of the file asset to copy
        templateProperties - override properties for the asset
        Returns:
        list of GUIDs from the top level to the root of the pathname
        Throws:
        InvalidParameterException - one of the parameters is null or invalid
        PropertyServerException - problem accessing property server
        UserNotAuthorizedException - security access problem
      • updateDataFileInCatalog

        void updateDataFileInCatalog​(java.lang.String userId,
                                     java.lang.String fileManagerCapabilityGUID,
                                     java.lang.String fileManagerCapabilityName,
                                     java.lang.String dataFileGUID,
                                     boolean isMergeUpdate,
                                     DataFileProperties dataFileProperties)
                              throws InvalidParameterException,
                                     UserNotAuthorizedException,
                                     PropertyServerException
        Update the file asset description in the catalog.
        Parameters:
        userId - calling user (assumed to be the owner)
        fileManagerCapabilityGUID - unique identifier of the software server capability representing an owning external file manager or null
        fileManagerCapabilityName - unique name of the software server capability representing an owning external file manager or null
        dataFileGUID - unique identifier of the data file asset
        isMergeUpdate - should the supplied properties completely override the existing properties or augment them?
        dataFileProperties - properties for the asset
        Throws:
        InvalidParameterException - one of the parameters is null or invalid
        PropertyServerException - problem accessing property server
        UserNotAuthorizedException - security access problem
      • archiveDataFileInCatalog

        void archiveDataFileInCatalog​(java.lang.String userId,
                                      java.lang.String fileManagerCapabilityGUID,
                                      java.lang.String fileManagerCapabilityName,
                                      java.lang.String dataFileGUID,
                                      ArchiveProperties archiveProperties)
                               throws InvalidParameterException,
                                      UserNotAuthorizedException,
                                      PropertyServerException
        Remove the file asset description from the catalog.
        Parameters:
        userId - calling user (assumed to be the owner)
        fileManagerCapabilityGUID - unique identifier of the software server capability representing an owning external file manager or null
        fileManagerCapabilityName - unique name of the software server capability representing an owning external file manager or null
        dataFileGUID - unique identifier of the data file asset
        archiveProperties - properties to help locate the archive copy
        Throws:
        InvalidParameterException - one of the parameters is null or invalid
        PropertyServerException - problem accessing property server
        UserNotAuthorizedException - security access problem
      • deleteDataFileFromCatalog

        void deleteDataFileFromCatalog​(java.lang.String userId,
                                       java.lang.String fileManagerCapabilityGUID,
                                       java.lang.String fileManagerCapabilityName,
                                       java.lang.String dataFileGUID,
                                       java.lang.String fullPathname)
                                throws InvalidParameterException,
                                       UserNotAuthorizedException,
                                       PropertyServerException
        Remove the file asset description from the catalog.
        Parameters:
        userId - calling user (assumed to be the owner)
        fileManagerCapabilityGUID - unique identifier of the software server capability representing an owning external file manager or null
        fileManagerCapabilityName - unique name of the software server capability representing an owning external file manager or null
        dataFileGUID - unique identifier of the data file asset
        fullPathname - unique path and file name for file
        Throws:
        InvalidParameterException - one of the parameters is null or invalid
        PropertyServerException - problem accessing property server
        UserNotAuthorizedException - security access problem
      • addDataFolderToCatalog

        java.util.List<java.lang.String> addDataFolderToCatalog​(java.lang.String userId,
                                                                java.lang.String fileManagerCapabilityGUID,
                                                                java.lang.String fileManagerCapabilityName,
                                                                FileFolderProperties fileFolderProperties,
                                                                java.lang.String connectorProviderName)
                                                         throws InvalidParameterException,
                                                                UserNotAuthorizedException,
                                                                PropertyServerException
        Creates a new folder asset that is identified as a data asset. This means the files and sub-folders within it collectively make up the contents of the data asset. As with other types of file-based asset, links are made to the folder structure implied in the path name. If the folder structure is not catalogued already, this is created automatically using the createFolderStructureInCatalog() method. For example, a pathName of "one/two/three/MyDataFolder" potentially creates 3 new folder assets, one called "one", the next called "one/two" and the last one called "one/two/three" plus a DataFolder asset called "one/two/three/MyDataFolder".
        Parameters:
        userId - calling user
        fileManagerCapabilityGUID - unique identifier of the software server capability representing an owning external file manager or null
        fileManagerCapabilityName - unique name of the software server capability representing an owning external file manager or null
        fileFolderProperties - properties to describe the folder properties
        connectorProviderName - class name of connector provider for connector to access this asset
        Returns:
        list of GUIDs from the top level to the root of the pathname
        Throws:
        InvalidParameterException - one of the parameters is null or invalid
        PropertyServerException - problem accessing property server
        UserNotAuthorizedException - security access problem
      • addDataFolderToCatalogFromTemplate

        java.util.List<java.lang.String> addDataFolderToCatalogFromTemplate​(java.lang.String userId,
                                                                            java.lang.String fileManagerCapabilityGUID,
                                                                            java.lang.String fileManagerCapabilityName,
                                                                            java.lang.String templateGUID,
                                                                            TemplateProperties templateProperties)
                                                                     throws InvalidParameterException,
                                                                            UserNotAuthorizedException,
                                                                            PropertyServerException
        Creates a new folder asset that is identified as a data asset using a template. This means the files and sub-folders within it collectively make up the contents of the data asset. As with other types of file-based asset, links are made to the folder structure implied in the path name. If the folder structure is not catalogued already, this is created automatically using the createFolderStructureInCatalog() method. For example, a pathName of "one/two/three/MyDataFolder" potentially creates 3 new folder assets, one called "one", the next called "one/two" and the last one called "one/two/three" plus a DataFolder asset called "one/two/three/MyDataFolder".
        Parameters:
        userId - calling user
        fileManagerCapabilityGUID - unique identifier of the software server capability representing an owning external file manager or null
        fileManagerCapabilityName - unique name of the software server capability representing an owning external file manager or null
        templateGUID - unique identifier of the file asset to copy
        templateProperties - override properties for the asset
        Returns:
        list of GUIDs from the top level to the root of the pathname
        Throws:
        InvalidParameterException - one of the parameters is null or invalid
        PropertyServerException - problem accessing property server
        UserNotAuthorizedException - security access problem
      • updateDataFolderInCatalog

        void updateDataFolderInCatalog​(java.lang.String userId,
                                       java.lang.String fileManagerCapabilityGUID,
                                       java.lang.String fileManagerCapabilityName,
                                       java.lang.String dataFolderGUID,
                                       boolean isMergeUpdate,
                                       FileFolderProperties fileFolderProperties)
                                throws InvalidParameterException,
                                       UserNotAuthorizedException,
                                       PropertyServerException
        Update the data folder asset description in the catalog.
        Parameters:
        userId - calling user (assumed to be the owner)
        fileManagerCapabilityGUID - unique identifier of the software server capability representing an owning external file manager or null
        fileManagerCapabilityName - unique name of the software server capability representing an owning external file manager or null
        dataFolderGUID - unique identifier of the data folder asset
        isMergeUpdate - should the supplied properties completely override the existing properties or augment them?
        fileFolderProperties - properties for the asset
        Throws:
        InvalidParameterException - one of the parameters is null or invalid
        PropertyServerException - problem accessing property server
        UserNotAuthorizedException - security access problem
      • archiveDataFolderInCatalog

        void archiveDataFolderInCatalog​(java.lang.String userId,
                                        java.lang.String fileManagerCapabilityGUID,
                                        java.lang.String fileManagerCapabilityName,
                                        java.lang.String dataFolderGUID,
                                        ArchiveProperties archiveProperties)
                                 throws InvalidParameterException,
                                        UserNotAuthorizedException,
                                        PropertyServerException
        Mark the data folder asset description in the catalog as archived.
        Parameters:
        userId - calling user (assumed to be the owner)
        fileManagerCapabilityGUID - unique identifier of the software server capability representing an owning external file manager or null
        fileManagerCapabilityName - unique name of the software server capability representing an owning external file manager or null
        dataFolderGUID - unique identifier of the data folder asset
        archiveProperties - properties to help locate the archive copy
        Throws:
        InvalidParameterException - one of the parameters is null or invalid
        PropertyServerException - problem accessing property server
        UserNotAuthorizedException - security access problem
      • deleteDataFolderFromCatalog

        void deleteDataFolderFromCatalog​(java.lang.String userId,
                                         java.lang.String fileManagerCapabilityGUID,
                                         java.lang.String fileManagerCapabilityName,
                                         java.lang.String dataFolderGUID,
                                         java.lang.String fullPathname)
                                  throws InvalidParameterException,
                                         UserNotAuthorizedException,
                                         PropertyServerException
        Remove the data folder asset description from the catalog.
        Parameters:
        userId - calling user (assumed to be the owner)
        fileManagerCapabilityGUID - unique identifier of the software server capability representing an owning external file manager or null
        fileManagerCapabilityName - unique name of the software server capability representing an owning external file manager or null
        dataFolderGUID - unique identifier of the data folder asset
        fullPathname - unique path and file name for file
        Throws:
        InvalidParameterException - one of the parameters is null or invalid
        PropertyServerException - problem accessing property server
        UserNotAuthorizedException - security access problem
      • attachDataFileAssetToFolder

        void attachDataFileAssetToFolder​(java.lang.String userId,
                                         java.lang.String fileManagerCapabilityGUID,
                                         java.lang.String fileManagerCapabilityName,
                                         java.lang.String folderGUID,
                                         java.lang.String fileGUID)
                                  throws InvalidParameterException,
                                         UserNotAuthorizedException,
                                         PropertyServerException
        Link an existing file asset to a folder. The file is not changed as this is used to create a logical link to the folder.
        Parameters:
        userId - calling user
        fileManagerCapabilityGUID - unique identifier of the software server capability representing an owning external file manager or null
        fileManagerCapabilityName - unique name of the software server capability representing an owning external file manager or null
        folderGUID - unique identifier of the folder
        fileGUID - unique identifier of the file
        Throws:
        InvalidParameterException - one of the parameters is null or invalid
        PropertyServerException - problem accessing property server
        UserNotAuthorizedException - security access problem
      • detachDataFileAssetFromFolder

        void detachDataFileAssetFromFolder​(java.lang.String userId,
                                           java.lang.String fileManagerCapabilityGUID,
                                           java.lang.String fileManagerCapabilityName,
                                           java.lang.String folderGUID,
                                           java.lang.String fileGUID)
                                    throws InvalidParameterException,
                                           UserNotAuthorizedException,
                                           PropertyServerException
        Remove a link between a file asset and a folder. The file is not changed. Use moveDataFileInCatalog to record the fact that the physical file has moved. Use attachDataFileAssetToFolder to create logical link to a new folder.
        Parameters:
        userId - calling user
        fileManagerCapabilityGUID - unique identifier of the software server capability representing an owning external file manager or null
        fileManagerCapabilityName - unique name of the software server capability representing an owning external file manager or null
        folderGUID - unique identifier of the folder
        fileGUID - unique identifier of the file
        Throws:
        InvalidParameterException - one of the parameters is null or invalid
        PropertyServerException - problem accessing property server
        UserNotAuthorizedException - security access problem
      • moveDataFileInCatalog

        void moveDataFileInCatalog​(java.lang.String userId,
                                   java.lang.String fileManagerCapabilityGUID,
                                   java.lang.String fileManagerCapabilityName,
                                   java.lang.String folderGUID,
                                   java.lang.String fileGUID)
                            throws InvalidParameterException,
                                   UserNotAuthorizedException,
                                   PropertyServerException
        Move a data file from its current parent folder to a new parent folder - this changes the file's qualified name but not its unique identifier (guid). Similarly to the endpoint in the connection object.
        Parameters:
        userId - calling user
        fileManagerCapabilityGUID - unique identifier of the software server capability representing an owning external file manager or null
        fileManagerCapabilityName - unique name of the software server capability representing an owning external file manager or null
        folderGUID - unique identifier of the folder
        fileGUID - unique identifier of the file
        Throws:
        InvalidParameterException - one of the parameters is null or invalid
        PropertyServerException - problem accessing property server
        UserNotAuthorizedException - security access problem
      • moveDataFolderInCatalog

        void moveDataFolderInCatalog​(java.lang.String userId,
                                     java.lang.String fileManagerCapabilityGUID,
                                     java.lang.String fileManagerCapabilityName,
                                     java.lang.String folderGUID,
                                     java.lang.String dataFolderGUID)
                              throws InvalidParameterException,
                                     UserNotAuthorizedException,
                                     PropertyServerException
        Move a data folder from its current parent folder to a new parent folder - this changes the folder's qualified name but not its unique identifier (guid). Similarly to the endpoint in the connection object.
        Parameters:
        userId - calling user
        fileManagerCapabilityGUID - unique identifier of the software server capability representing an owning external file manager or null
        fileManagerCapabilityName - unique name of the software server capability representing an owning external file manager or null
        folderGUID - unique identifier of the folder
        dataFolderGUID - unique identifier of the data folder to move
        Throws:
        InvalidParameterException - one of the parameters is null or invalid
        PropertyServerException - problem accessing property server
        UserNotAuthorizedException - security access problem