%MFT.API
abstract class %MFT.API extends %Library.RegisteredObject
The File Management API is an implementation of access to the REST APIS from Box, Dropbox and Accellion Kiteworks. The connection to the underlying service is defined by the connection object, a subclass of %SYS.MFT.Connection.Base. This connection is passed as the first argument to each of the API calls either as the name of a saved persistent object or as a oref of a connection object. The remote files and folders being operated upon will be specified as a Unix style path. If the remote path is relative then it will be relative to the current remote folder. The root remote folder will always be denoted as "/". The local files will be specified as usual by a file system based path. If the local path is relative it will be relative to the manager directory.The file management API will be implemented in subclasses of the %MFT.API class which are particular to the vendor service.
Method Inventory
- CreateFolder()
- CreateUser()
- DeleteFile()
- DeleteFolder()
- DeleteUser()
- DeleteUserById()
- DownloadFile()
- DownloadStream()
- GetConnection()
- GetCurrentFolder()
- GetFileInfo()
- GetFolderContents()
- GetFolderInfo()
- GetRequestId()
- GetUser()
- GetUserById()
- GetUserList()
- GetUsername()
- MountFolder()
- SetCurrentFolder()
- ShareFolder()
- UnmountFolder()
- UnshareFolder()
- UnshareFolderAll()
- UploadFile()
- UploadStream()
Methods
classmethod CreateFolder(connection As %SYS.MFT.Connection.Base, folderPath As %String, Output itemInfo As %MFT.ItemInfo) as %Status
Creates the remote folder at the specified folderPath.
Each level of the folder path should be created separately if it does not already exist.
An %MFT.ItemInfo object is returned for the new folder.
classmethod CreateUser(connection As %SYS.MFT.Connection.Base, userInfo As %MFT.UserInfo) as %Status
Create a new user.
The Userid and Detail properties are filled in by CreateUser if it is successful.
classmethod DeleteFile(connection As %SYS.MFT.Connection.Base, path As %String, permanent As %Boolean = 0) as %Status
Delete the remote file.
path may be a file path.
path may also be specified as an id of the form "id:" which was obtained from a %MFT.ItemInfo object.
If permanent is true, then the file will be permanently deleted. Otherwise the file will be moved to trash. If the remote file does not exist at the specified path, then $$$OK is returned as status.
If permanent is true, then the file will be permanently deleted. Otherwise the file will be moved to trash. If the remote file does not exist at the specified path, then $$$OK is returned as status.
classmethod DeleteFolder(connection As %SYS.MFT.Connection.Base, path As %String, permanent As %Boolean = 0) as %Status
Delete the remote folder.
path may be a folder path.
path may also be specified as an id of the form "id:" which was obtained from a %MFT.ItemInfo object.
If permanent is true, then the folder will be permanently deleted. Otherwise the folder will be moved to trash.
If the remote folder does not exist at the specified path, then $$$OK is returned as status.
If permanent is true, then the folder will be permanently deleted. Otherwise the folder will be moved to trash.
If the remote folder does not exist at the specified path, then $$$OK is returned as status.
classmethod DeleteUser(connection As %SYS.MFT.Connection.Base, username As %String) as %Status
Delete the user that is specified by the email address (i.e. username).
classmethod DeleteUserById(connection As %SYS.MFT.Connection.Base, userid As %String) as %Status
Delete the user that is specified by the id.
classmethod DownloadFile(connection As %SYS.MFT.Connection.Base, filePath As %String, localFilePath As %String) as %Status
Download the specified remote file and store at the location given by localFilePath.
filePath may be a file path.
filePath may also be specified as an id of the form "id:" which was obtained from a %MFT.ItemInfo object.
classmethod DownloadStream(connection As %SYS.MFT.Connection.Base, filePath As %String, ByRef stream As %BinaryStream) as %Status
Download the specified remote file and store in the specified stream which must be a %FileBinaryStream or a %GlobalBinaryStream.
If stream is not specified, then a %GlobalBinaryStream will be created.
filePath may be a file path.
filePath may also be specified as an id of the form "id:" which was obtained from a %MFT.ItemInfo object.
classmethod GetConnection(connectionName As %String, Output sc As %Status) as %SYS.MFT.Connection.Base
Get the connection object associated with the specified connection name.
classmethod GetCurrentFolder(connection As %SYS.MFT.Connection.Base, Output folderPath As %String) as %Status
Returns the current remote folder path.
classmethod GetFileInfo(connection As %SYS.MFT.Connection.Base, path As %String, Output itemInfo As %MFT.ItemInfo) as %Status
Return the item info object which describes the specified file.
path may be a file path.
path may also be specified as an id of the form "id:" which was obtained from a %MFT.ItemInfo object.
If a file does not exist at the specified path, then $$$OK is returned as status and itemInfo is returned as "".
classmethod GetFolderContents(connection As %SYS.MFT.Connection.Base, folderPath As %String, recursive As %Boolean = 0, Output folderContents As %MFT.FolderContents) as %Status
Return the folder contents object for the specified folder.
folderPath may be a folder path.
folderPath may also be specified as an id of the form "id:" which was obtained from a %MFT.ItemInfo object.
"" May be used as the folderPath to specify the current folder.
The FolderContents object will include a list of %MFT.ItemInfo objects which contain a file or folder name
and some additional simple information.
classmethod GetFolderInfo(connection As %SYS.MFT.Connection.Base, path As %String, Output itemInfo As %MFT.ItemInfo) as %Status
Return the item info object which describes the specified folder.
path may be a folder path.
path may also be specified as an id of the form "id:" which was obtained from a %MFT.ItemInfo object.
"" May be used as the path to specify the current folder.
If a folder does not exist at the specified path, then $$$OK is returned as status and itemInfo is returned as "".
classmethod GetRequestId(connection As %SYS.MFT.Connection.Base, itemInfo As %MFT.ItemInfo) as %String
Get the form of id for a file or folder that is most efficient for subsequent calls.
GetRequestId will return either an id of the form "id:" or a full path depending on which is more efficient.
This method is included to allow the id for future requests to be saved in the most efficient form.
classmethod GetUser(connection As %SYS.MFT.Connection.Base, username As %String, Output userInfo As %MFT.UserInfo) as %Status
Retrieve the %MFT.UserInfo specified by the username
which is the email address for all currently supported services.
GetUser is potentially less efficient than GetUserById.
If the user does not exist, then $$$OK is returned as status and userInfo is returned as "".
classmethod GetUserById(connection As %SYS.MFT.Connection.Base, userid As %String, Output userInfo As %MFT.UserInfo) as %Status
Retrieve the %MFT.UserInfo specified by the service defined Userid.
If the user does not exist, then $$$OK is returned as status and userInfo is returned as "".
classmethod GetUserList(connection As %SYS.MFT.Connection.Base, Output userList As %MFT.UserList) as %Status
Return the list of all currently defined users for this team or enterprise.
classmethod GetUsername(connection As %SYS.MFT.Connection.Base, internalId As %String, Output username As %String) as %Status
Get the external username that corresponds to the specified internal user id.
classmethod MountFolder(connection As %SYS.MFT.Connection.Base, folderName As %String) as %Status
MountFolder is a Dropbox specific method to mount a shared folder that was shared by a different user.
MountFolder is treated as a NOP for all other services.
classmethod SetCurrentFolder(connection As %SYS.MFT.Connection.Base, folderPath As %String) as %Status
Set the current remote folder path.
Share a folder with a list of users pass as a $list.
path may be a folder path.
path may also be specified as an id of the form "id:" which was obtained from a %MFT.ItemInfo object.
The "editor" and "viewer" access levels are supported for all vendors.
In addition, vendor specific access levels are supported.
classmethod UnmountFolder(connection As %SYS.MFT.Connection.Base, folderName As %String) as %Status
UnmountFolder is a Dropbox specific method to unmount a shared folder that was shared by a different user.
UnmountFolder is treated as a NOP for all other services.
Unshare a folder from a specified user.
path may be a folder path.
path may also be specified as an id of the form "id:" which was obtained from a %MFT.ItemInfo object.
Unshare a folder from all users.
path may be a folder path.
path may also be specified as an id of the form "id:" which was obtained from a %MFT.ItemInfo object.
classmethod UploadFile(connection As %SYS.MFT.Connection.Base, localFilePath As %String, filePath As %String, replace As %Boolean = 0, Output itemInfo As %MFT.ItemInfo) as %Status
Update the specified remote file with the contents of the specified local file.
filePath must be a file path. An id may not be specified.
If replace is true, then an existing file of the same name will be replaced.
The default is to return an error if a replacement is attempted.
classmethod UploadStream(connection As %SYS.MFT.Connection.Base, stream As %BinaryStream, filePath As %String, replace As %Boolean = 0, Output itemInfo As %MFT.ItemInfo) as %Status
Update the specified remote file with the contents of the specified stream.
filePath must be a file path. An id may not be specified.
If replace is true, then an existing file of the same name will be replaced.
The default is to return an error if a replacement is attempted.
Inherited Members
Inherited Methods
- %AddToSaveSet()
- %ClassIsLatestVersion()
- %ClassName()
- %ConstructClone()
- %DispatchClassMethod()
- %DispatchGetModified()
- %DispatchGetProperty()
- %DispatchMethod()
- %DispatchSetModified()
- %DispatchSetMultidimProperty()
- %DispatchSetProperty()
- %Extends()
- %GetParameter()
- %IsA()
- %IsModified()
- %New()
- %NormalizeObject()
- %ObjectModified()
- %OriginalNamespace()
- %PackageName()
- %RemoveFromSaveSet()
- %SerializeObject()
- %SetModified()
- %ValidateObject()