Base class for MFT Adapters EnsLib.LDAP.Adapter.Inbound
parameter DOMAIN = "Ensemble";
as %String(MAXLEN="") [ Transient ];
Internal use to limit event log warnings
as %String(MAXLEN=1000) [ Transient ];
Class Name of MFT API for the Service.
This is calculated from the connection.
MFT Connection instance
Name of Managed File Transfer Connection to the file management service.
The list of available Connection definitions will only be shown to users with
appropriate privilege (SQL select on table %SYS_MFT_Connection.Base).
method DeleteFile(pFileId As %String, pPermanent As %Boolean = 0)
Call to MFT DeleteFile using current connection
method DownloadStream(pFileId As %String, ByRef pItemStream As %BinaryStream)
Call to MFT Download Stream using current connection
method GetFolderContents(pFolder As %String, pIncludeSubFolders As %Boolean = 0, Output pFolderContents As %MFT.FolderContents, ByRef pFolderId As %String)
Call to MFT GetFolderContents using current connection
method GetFolderInfo(pFolder As %String, Output pItemInfo As %MFT.ItemInfo)
If pFolderId is not defined then pFolder is used for the target folder specification.
If pFolderId is defined and not empty then it is used for the target folder specification.
If pFolderId is defined as empty then API calls will be made to find the ID of pFolder and
pFolderId will be updated, used as the target folder specification and passed back by reference to the caller.
If pIncludeSubFolders is true and pFolderId is used then it is possible that the Container property for
file items found will be empty and it is recommended to call this method with pFolderId undefined if Container property is required.
Call to MFT GetFolderInfo using current connection
Obtains the MFT Connection and executes a test GetUser() call.
method GetRequestId(pItemInfo As %MFT.ItemInfo)
Call to MFT GetRequestId using current connection
method GetUsername(pModifiedBy As %String, Output pMFTUsername As %String = "")
Call to MFT GetUsername using current connection
method HandleMFTError(pMFTStatus As %Status, Output pTriedReconnecting As %Boolean = 0, Output pReconnectedOnError As %Boolean = 0)
This method is used to identify if the MFT method error was a connection issue that
can be recovered by reconnecting and tries the reconnection.
The first parameter is the MFT Status to be examined.
The second parameter indicates if tried reconnecting.
The third parameter is output indicating if it recovered the connection.
This user callback method is called just after %OnNew()
method UploadStream(pStream As %Stream.Object, pFilename As %String, pUploadIfSameFileOnServer As %Boolean = 0, Output pResponse As %MFT.ItemInfo, Output pTriedReconnecting As %Boolean = 0, Output pReconnectedOnError)
This method wraps the MFT system method UploadStream.
The first parameter is the stream object to upload.
The second parameter is the filename to write the stream to on the target.
The third parameter indicates if the target filename ought to be overwritten.
(An MFT server may not overwrite but create multiple versions)
The method returns the status from the MFT call.
The method also returns in parameter pResponse the %MFT.ItemInfo response.
Parameter pTriedReconnecting indicates if there was an error whether the error was a connection type error
Parameter pReconnectedOnError indicates if it was a connection error if it was able to recover
If there was a connection error and there was an error trying to reconnect both errors are included in the return status.