public final class SaClassicConnectorImpl extends Object implements SaClassicConnector
SaClassicConnector
Constructor and Description |
---|
SaClassicConnectorImpl()
Constructs the
SaClassicConnectorImpl instance which provides DMS
functionality. |
SaClassicConnectorImpl(Properties configuration)
Constructs the
SaClassicConnectorImpl instance which provides DMS
functionality. |
SaClassicConnectorImpl(Properties configuration,
com.saperion.cache.CacheManager cacheManager)
Constructs the
SaClassicConnectorImpl instance which provides DMS
functionality. |
SaClassicConnectorImpl(String configPath)
Constructs the
SaClassicConnectorImpl instance which provides DMS
functionality. |
Modifier and Type | Method and Description |
---|---|
void |
addComment(String comment,
String taskUID,
int level)
Adds a comment to the task.
|
void |
addHistory(String description,
String taskUID)
Adds a history entry to the task.
|
void |
addListener(SaEventListener listener)
Deprecated.
|
void |
addListener(SaStatusEventListener listener)
Deprecated.
|
void |
addToFolder(String folderTableDDC,
String documentId,
String documentDDC,
String folderId)
Adds the document with given documentId to a given folder with given folderId.
|
SaSaveInfo |
cacheDocument(String xhDoc,
DocumentInfo document)
Caches a new document in the backend system with the given metadata and content.
|
SaSaveInfo |
cacheDocument(String xhDoc,
String ddcName,
Properties namevaluePairs,
InputStream[] content,
String versionComment,
String strAcl)
Caches a new document in the backend system with the given metadata and content.
|
void |
changePassword(String user,
String oldPassword,
String tenant,
String newPassword)
Changes the password of an existing user.
|
void |
checkoutDocument(String hDoc)
Checks out a document for the given document id (hdoc).
|
SapDocInfo |
checkSapUrl(String url)
Checks the given SAP URL on the R/Link server and returns, if successfull, the HDOC and the
DDC.
|
boolean |
closeSession(com.saperion.connector.authentication.Session session)
Close the given
Session of logged in user |
String |
copyFolder(String folderTableDDC,
String folderId,
String destinationId,
String beforeChild,
boolean withDocuments)
Copies the given folder and all it's children to the destination.
|
SaSaveInfo |
createDocument(DocumentInfo document)
Creates a new document on the backend system with the given
DocumentInfo . |
SaSaveInfo |
createDocument(String ddcName,
Properties namevaluePairs,
InputStream[] content,
String versionComment)
Deprecated.
|
SaSaveInfo |
createDocument(String ddcName,
Properties namevaluePairs,
InputStream[] content,
String versionComment,
String acls)
Deprecated.
|
String |
createFolder(SaFolderSaveInfo info,
Properties namevaluePairs)
Creates a new folder below a given folder.
|
String |
createFolder(String folderTableDDC,
String parentId,
String beforeChild,
String folderName,
SaFolderConstants.FOLDER_TYPE folderType,
Properties namevaluePairs)
Deprecated.
|
SaSaveInfo |
createLink(LinkInfo link)
Creates a link to a document for given
LinkInfo . |
void |
deleteDocument(String documentHDOC,
int deleteType)
Deletes a document from the backend system with the given delete type strategy.
|
void |
deleteFolder(String folderTableDDC,
String folderId)
Deletes an existing folder.
|
boolean |
deleteSetting(String name,
String section,
boolean isLong)
This method deletes a setting in the database.
|
void |
discardCheckout(String hDoc)
Discards a checkout of a document which was performed via the method
SaClassicConnector.checkoutDocument(String) . |
String |
executeCommand(ContextInfo contextInfo)
Performs the given command.
|
String |
getACLNames(String documentHDOC)
This method returns the names of the Access Control Lists that are assigned to this document.
|
SaACLRights |
getACLRights(String[] acls)
This method returns the access rights the current user has when in the context of the Access Controll Lists
given by name.
|
List<SaAcl> |
getAcls()
This method returns all Access Control Lists in the current tenant.
|
List<String> |
getAllACLs()
Deprecated.
|
String |
getAnnotations(String hDoc,
int indexOfContentElement)
Deprecated.
|
String |
getAnnotations(String hDoc,
int indexOfContentElement,
boolean currentRevision)
Reads the annotations of the document with the specified ID.
|
int |
getArchivedSize(String hDoc)
Returns the total document size in the archive in bytes.
|
List<UsersRights> |
getAuthorizedUsers(String hDoc,
String rights,
MatchKind match)
This method returns the users that have specific rights on a document.
|
Long |
getBoxCount(int boxId)
Reads the count (number of workflow item) of the inbox identified by the given id.
|
List<BoxDefinition> |
getBoxDefinitions()
Reads the box definitions.
|
SaRMIClientCommand |
getClientConnector() |
Collection<CommandInfo> |
getCommandInfos(String docUID)
Reads all possible transitions for this task.
|
Collection<CommandInfo> |
getCommandInfos(String docUID,
boolean transitionsOnly)
Reads all possible transitions and optional other possible commands for this task.
|
List<CommentInfo> |
getCommentInfos(String taskId)
Reads the comments for the given task.
|
List<List<HistoryInfo>> |
getCompleteHistoryInfos(String docId)
Reads the history and comments for the given document.
|
Properties |
getConfiguration(String section)
This method reads the application configuration properties from the backend system.
|
SaUserInfo |
getCurrentUserInfo()
This method returns detailed info about the current user.
|
String |
getCurrentUserName()
This method returns the name of teh user currently logged in.
|
SaFieldDescription[] |
getDBDefinition(String name)
This method reads the field definitions of the database definition (DDC) with the given name.
|
DDC |
getDDC(String ddcName)
This method returns a document definition given by its name.
|
String[] |
getDefinitions()
This method returns the names of all DDCs registered in the Saperion system.
|
SaDocAccessData |
getDocumentAccessData(String documentHDOC)
This method reads the access rights the current user has on a given document.
|
long |
getDocumentFolderCount(String folderTableDDC,
String documentDDC,
String sysRowId)
Returns the total count over all folders from all users in which the specified document is
contained in.
|
List<SaDocumentInfo> |
getDocumentFolders(String folderTableDDC,
String documentDDC,
String sysRowId)
Returns a list of folder properties which contains all folders the document is contained in.
|
SaDocInfo |
getDocumentInfo(String hDoc,
boolean currentRevision,
boolean resolveLinks)
Reads information like the document-structure and variables for the given document.
|
SaDocInfo |
getDocumentInfo(String hDoc,
boolean currentRevision,
boolean resolveLinks,
boolean forceSizeDetermination)
Reads information like the document-structure and variables for the given document.
|
boolean |
getEventsEnabled()
This method returns whether events (e.g.
|
SaFeature |
getFeatures()
This method returns the features enabled in the Saperion system.
|
SaDocumentInfo |
getFolderByPath(String folderTableDDC,
String startFolderId,
String folderPath)
Returns the folder which matches to the given path.
|
List<SaDocumentInfo> |
getFolderChildren(String folderTableDDC,
String folderId,
int depth,
SaQueryInfo filter,
int allowedMaxNrOfChildFolders)
Returns a list with the children of the given node.
|
SaFolderClass |
getFolderClass(String className)
Reads the folder class with the given name.
|
String[] |
getFolderDefinitions()
Reads the registered folder DDC names from the repository.
|
List<SaDocumentInfo> |
getFolderFromPath(String folderTableDDC,
String startNodeId,
String folderPath)
Returns the folders which match to the given path.
|
SaDocumentInfo |
getFolderInfo(String folderTableDDC,
String folderId)
Deprecated.
|
SaDocumentInfo |
getFolderInfo(String folderTableDDC,
String folderId,
boolean forceLoadVariables)
Returns the folder information object for the given folder.
|
SaDocumentInfo |
getFolderParent(String folderTableDDC,
String folderId)
Returns the parent of the given folder.
|
SaDocAccessData |
getFolderRights(String folderTableDDC,
String folderId)
Returns the rights mask for the given folder and user.
|
Set<FolderUpdateInfo> |
getFolderUpdateInfo(Map<String,Long> folderIds)
Deprecated.
|
String |
getFulltext(String ddcName,
String sysRowId)
Deprecated.
|
String |
getFulltext(String ddcName,
String hdoc,
String fieldName,
long length)
Reads the fulltext information for the given document with the given HDOC in the given
DDC from the specified field.
|
Set<Map.Entry<String,String>> |
getFullTextFields(String ddcName,
List<String> fullTextFields,
String hdoc)
|
List<HistoryInfo> |
getHistoryInfos(String taskId)
Reads the history for the given task.
|
List<String> |
getInvolvedUsers(String documentHDOC)
Lists the names of all users that are contained in all Access Control Lists set on the given document.
|
int |
getLicenseCount(int type)
This method returns the overall count of Licenses of the given type in the system.
|
SaLockInfo |
getLockInfo(String sysRowId)
This method returns the locking information for a given document.
|
WorkflowMember |
getMember(WorkflowMember member,
int depth,
String filter)
Returns the workflow members by the given parameters.
This method is considered as a search-method. |
WorkflowMember |
getMembers()
Reads the workflow members in a full structured tree.
|
boolean |
getOutOfOffice()
Get the substitute for the logged on user.
|
TaskInfo |
getParentTask(String taskID)
Reads the parent task info for the given ID.
|
String |
getReleaseAclName()
Gets the release ACL name, configured in the program.ini in section [Release].
|
String |
getReleasedHdoc(String oldHdoc)
Gets the released hdoc for given hdoc if release feature is on and release tag is set,
otherwise returns the given hDoc.
|
List<com.saperion.connector.renditions.Rendition> |
getRendition(Element element,
com.saperion.connector.options.Options options)
Returns the rendition object from a rendered document.
|
List<SaRMIServerInfo> |
getServerInfos() |
ServerSideClientConfiguration |
getServerSideClientConfiguration()
This method returns the configuration concerning the classic connector that is set on the server side.
|
com.saperion.connector.authentication.Session |
getSession()
Returns the session of the logged in user.
|
Setting |
getSetting(String name,
String section,
boolean isLong)
This method retrieves a
Setting identified by it's key and section from the database. |
String |
getSubstitute()
Get the substitute for the logged on user.
|
Set<com.saperion.connector.formats.SourceFormat> |
getSupportedRenderSourceFormats()
Gets the supported source formats from the render engine.
|
Set<com.saperion.connector.formats.TargetFormat> |
getSupportedRenderTargetFormats()
Gets the supported target formats from the render engine.
|
List<String> |
getSystemFiles(SystemFileKind kind,
String filter)
This method returns the names of all system files of a specific kind.
|
SaSystemInfo |
getSystemInfo()
This method returns general information about the connected system.
|
SaSystemSetting |
getSystemSetting(String accessKey)
Retrieves a system setting object.
|
TaskInfo |
getTask(String taskID)
Reads the task info for the given ID.
|
List<TaskAuditInfo> |
getTaskAuditList(int[] ids,
String filter,
Map<String,Object> parameter)
Reads the task audits for this user.
|
List<TaskInfo> |
getTaskList(int[] ids,
String filter,
Map<String,Object> parameter)
Reads the tasks for this user.
|
byte[] |
getThumbnail(String hDoc,
int widthX,
int widthY,
boolean color)
Reads the thumbnail of the given document.
|
int |
getToken() |
List<String> |
getUsers(String filter)
Reads a list of filtered users.
|
SaUserSetting |
getUserSetting(String accessKey)
Retrieves a user-specific setting object.
|
List<String> |
getVersionIDs(String ddcName,
String sysrowID)
Reads the version IDs of the given document.
|
SaWFConnector |
getWorkflowConnector()
Returns a workflow connector based on this classic connector.
|
String |
getWorkflowDdcName()
Gets the workflow ddc name.
|
List<String> |
getWorkflowDefinitions()
Reads all available workflow definitions.
|
List<ProcessDefinitionDescriptor> |
getWorkflowDefinitions(String ddcName)
Returns the workflow definitions that are allowed to be used for documents contained
in the specified DDC.
|
int |
hashCode() |
boolean |
hasRenderEngine()
Checks wether this classic connector has a render engine.
|
<T extends Serializable> |
invoke(LegacyOperation<T> operation)
Invokes the given
Operation on the server side. |
boolean |
isActive()
Checks, if the connector is logged on.
|
boolean |
isAlive()
Tests the lifetime of this connector.
|
boolean |
isReleaseActive()
Checks if is release feature in the program.ini in section [Release] is active.
|
List<com.saperion.connector.authentication.Session> |
listActiveSessions()
List active sessions of the logged in user
|
Map<String,String> |
loadLocalize(String language)
Load localize.
|
InputStream |
loadSystemFile(SystemFileKind kind,
String name)
This method loads a system file of a specific kind.
|
boolean |
lockDocument(String sysRowId,
String ddcName)
Locks a document.
|
void |
logClientEvent(String hdoc,
SaConstants.ProtoEvents event,
String remark)
Adds an audit log event.
|
boolean |
logoff()
This method logs the current user off from the system.
|
int |
logon(byte[] token,
int type,
String client)
Deprecated.
|
com.saperion.connector.authentication.Session |
logon(com.lexmark.saperion.remote.common.authentication.Credentials credentials)
This method authenticates the given
Credentials and returns the information about the open
session. |
com.saperion.connector.authentication.Session |
logon(com.lexmark.saperion.remote.common.authentication.Credentials credentials,
com.saperion.connector.authentication.SessionInfo sessionInfo)
This method authenticates the given
Credentials , associate the given SessionInfo
and returns the information about the open session. |
int |
logon(jcifs.smb.NtlmPasswordAuthentication auth,
int type,
String client)
Deprecated.
|
int |
logon(String username,
String password,
int type,
String client)
This method authenticates the given user and returns the token of the newly created session.
|
void |
moveFolder(String folderTableDDC,
String folderId,
String destinationId,
String beforeChild)
Moves the given folder to a new destination.
|
void |
moveToFolder(String folderTableDDC,
String documentId,
String documentDDC,
String folderId,
String destinationId)
Removes the document from the source folder and adds it to the source folder.
|
InputStream |
readDocument(String docHdoc,
boolean currentRevision,
int elementNumber)
Loads a document's content from the backend system.
|
InputStream |
readDocument(String docHdoc,
boolean currentRevision,
int elementNumber,
boolean withAnnotations)
Loads a document's content from the backend system.
|
String |
readDocumentFilename(String docHdoc,
boolean currentRevision,
int elementNumber)
Reads the filenames of the application data of the document with the given ID.
|
SaPropertyValue[] |
readDocumentMetadata(String documentSysRowID,
String ddcName,
String[] fields)
Reads the metadata of the document with the given ID.
|
InputStream |
readReleasedDocument(String docHdoc,
boolean currentRevision,
int elementNumber)
Read released document if the release feature is
active.
|
InputStream |
readVersionDocument(String docHdoc,
int elementNumber)
Loads a document version from the backend system.
|
String |
readVersionDocumentFilename(String docHdoc,
int elementNumber)
Reads the filenames of the application data of the document with the given ID.
|
SaVersionData |
readVersionMetadata(String versionID)
Reads the version metadata of the document with the given ID.
|
SaVersionData |
readVersionMetadata(String versionID,
boolean resolveLinks)
Reads the version metadata of the document with the given ID.
|
void |
releaseDocument(String ddcName,
String hDoc,
String versionComment)
Release the given document.
|
boolean |
removeEvent(SaEvent event)
Deprecated.
|
void |
removeFromFolder(String folderTableDDC,
String documentSysRowId,
String documentDDC,
String folderId)
Removes the document from the given folder.
|
void |
removeListener(SaEventListener listener)
Deprecated.
|
void |
removeListener(SaStatusEventListener listener)
Deprecated.
|
String |
resolveLatestHDoc(String oldHdoc)
Resolves and returns the XHDOC of the latest version of the document identified by the given
HDOC.
|
SaSaveInfo |
restoreVersion(String versionID)
Restores the version with the given HDOC.
|
List<SaPropertyValue[]> |
search(String hqlQuery)
Deprecated.
|
Set<SaFolderClass> |
searchFolderClass(SaFolderClassSearchInfo searchInfo)
Searches for folder classes that match the specified propertied.
|
List<SaDocumentInfo> |
searchFolderDocuments(String folderTableDDC,
String folderId,
SaQueryInfo hqlFilter)
HQL search extended with additional folder informations and depth.
|
List<SaDocumentInfo> |
searchHQL(SaQueryInfo hqlQuery)
Performs a search with the given hql query (hibernate query language).
|
SettingSearchResult |
searchSettings(SettingSearchInfo searchInfo)
This method searches settings in the database.
|
void |
sendBarcode(String indexMask,
String docUid,
String contentRep,
String sid,
String docType,
String value,
int mandant)
Sends the Document UID with the barcode to SAP R/3.
|
SaSaveInfo |
setACLName(String ddcname,
String documentHDOC,
String acl,
String versionComment)
This method specifies the Access Control Lists that secure the document given by its id.
|
void |
setAnnotations(String hDoc,
int indexOfContentElement,
String annotations)
Sets the given annotations to the document.
|
void |
setCurrentUserPresent(boolean present)
Sets whether the current user is present.
|
void |
setEventsEnabled(boolean enabled)
This method sets whether events (e.g.
|
void |
setFolderAcl(String folderTableDDC,
String folderId,
String aclName)
Sets an ACL for the given folder.
|
void |
setLocale(Locale locale)
This methods sets the localization information for the current user.
|
void |
setOutOfOffice(boolean isOutOfOffice)
set the out of office status for the logged on user.
|
void |
setSetting(Setting setting)
This method stores a
Setting in the database. |
void |
setSubstitute(String name)
Set the substitute for the logged on user.
|
boolean |
setUsedLicense(int type,
int count)
Set the count of used licenses.
|
void |
setUserSetting(SaUserSetting setting)
Persists a user-specific setting object.
|
void |
stopServer()
Deprecated.
|
void |
storeSystemFile(SystemFileKind kind,
String name,
InputStream data)
This method stores a system file of a specific kind.
|
String |
toString() |
boolean |
unlockDocument(String sysRowId,
String ddcName)
Unlocks a document.
|
void |
updateCurrentUserInformation(MutableUserInformation user)
Changes information about the current user.
|
SaSaveInfo |
updateDocument(String ddcName,
String documentHDOC,
Properties namevaluePairs,
InputStream[] content,
String versionComment)
Deprecated.
|
SaSaveInfo |
updateDocument(String ddcName,
String documentHDOC,
Properties namevaluePairs,
InputStream[] content,
String versionComment,
String acls)
Deprecated.
|
SaSaveInfo |
updateDocument(String ddcName,
String documentHDOC,
Properties namevaluePairs,
InputStream[] content,
String versionComment,
String acls,
boolean resolveLinks)
Deprecated.
|
SaSaveInfo |
updateDocument(String ddcName,
String documentHDOC,
Properties namevaluePairs,
InputStream[] content,
String versionComment,
String acls,
boolean resolveLinks,
boolean checkin)
Deprecated.
|
SaSaveInfo |
updateDocument(UpdateDocumentInfo updateInfo)
Updates a document in the backend system with the given metadata, acls and content.
|
void |
updateFolder(String folderTableDDC,
String folderId,
Properties namevaluePairs)
Updates an existing folder with the given properties.
|
clone, equals, finalize, getClass, notify, notifyAll, wait, wait, wait
logon
public SaClassicConnectorImpl()
SaClassicConnectorImpl
instance which provides DMS
functionality.public SaClassicConnectorImpl(String configPath)
SaClassicConnectorImpl
instance which provides DMS
functionality.configPath
- Configuration pathpublic SaClassicConnectorImpl(Properties configuration)
SaClassicConnectorImpl
instance which provides DMS
functionality.configuration
- Configuration propertiespublic SaClassicConnectorImpl(Properties configuration, com.saperion.cache.CacheManager cacheManager)
SaClassicConnectorImpl
instance which provides DMS
functionality.configuration
- Configuration propertiescacheManager
- an instance of CacheManager
public Properties getConfiguration(String section) throws SaSystemException, SaAuthenticationException
SaClassicConnector
getConfiguration
in interface SaClassicConnector
section
- the name of the section in the archief.ini to load configuration properties fromSaSystemException
- SaSystemExceptionSaAuthenticationException
- SaAuthenticationException@Deprecated public void stopServer() throws SaSystemException, SaAuthenticationException
SaClassicConnector
stopServer
in interface SaClassicConnector
SaSystemException
- SaSystemExceptionSaAuthenticationException
- SaAuthenticationExceptionpublic String[] getDefinitions() throws SaSystemException, SaAuthenticationException
SaClassicConnector
getDefinitions
in interface SaClassicConnector
SaSystemException
- on general system failuresSaAuthenticationException
- when the classic connector is not authenticated or the current user has not the required rights for
the operationpublic String[] getFolderDefinitions() throws SaSystemException, SaAuthenticationException
SaClassicConnector
getFolderDefinitions
in interface SaClassicConnector
SaSystemException
- SaSystemExceptionSaAuthenticationException
- SaAuthenticationExceptionpublic SaFieldDescription[] getDBDefinition(String name) throws SaSystemException, SaAuthenticationException
SaClassicConnector
getDBDefinition
in interface SaClassicConnector
name
- the name of the database definition (DDC) to get the fields ofSaFieldDescription
in the definitionSaSystemException
- on general system failuresSaAuthenticationException
- when the classic connector is not authenticated or the current user has not the required rights for
the operationpublic int logon(String username, String password, int type, String client) throws SaAuthenticationException, SaSystemException
SaClassicConnector
logon
in interface SaClassicConnector
username
- User's full namepassword
- Passwordtype
- User type that means client license type. There are possible the following integer
values:
client
- client/mandant name, used in multi-client systemsSaAuthenticationException
- when the user is not logged in or has insufficient rightsSaSystemException
- SaSystemException@Deprecated public int logon(jcifs.smb.NtlmPasswordAuthentication auth, int type, String client) throws SaAuthenticationException, SaSystemException
SaClassicConnector
logon
in interface SaClassicConnector
auth
- Ntlm authentication objecttype
- User type that means client license type. There are possible the following integer
values:
client
- client/mandant name, used in multi-client systemsSaAuthenticationException
- when the user is not logged in or has insufficient rightsSaSystemException
- SaSystemException@Deprecated public int logon(byte[] token, int type, String client) throws SaAuthenticationException, SaSystemException
logon
in interface SaClassicConnector
SaSystemException
- because it is not supported anymore.SaAuthenticationException
public com.saperion.connector.authentication.Session logon(com.lexmark.saperion.remote.common.authentication.Credentials credentials) throws SaAuthenticationException, SaSystemException
Credentials
and returns the information about the open
session.logon
in interface SaClassicConnector
credentials
- credentials that authorize and authenticate the session returnedSaAuthenticationException
- thrown if logon was not possible with the given credentialsSaSystemException
- thrown if the system is not reachableSaClassicConnector.logon(Credentials)
public com.saperion.connector.authentication.Session logon(com.lexmark.saperion.remote.common.authentication.Credentials credentials, com.saperion.connector.authentication.SessionInfo sessionInfo) throws SaAuthenticationException, SaSystemException
Credentials
, associate the given SessionInfo
and returns the information about the open session.logon
in interface SaClassicConnector
credentials
- credentials that authorize and authenticate the session returnedsessionInfo
- The session information like user agent, remote address etc.SaAuthenticationException
- thrown if logon was not possible with the given credentialsSaSystemException
- thrown if the system is not reachableSaClassicConnector.logon(Credentials, SessionInfo)
public List<com.saperion.connector.authentication.Session> listActiveSessions() throws SaAuthenticationException, SaSystemException
listActiveSessions
in interface SaClassicConnector
Session
SaSystemException
SaAuthenticationException
SaClassicConnector.listActiveSessions()
public boolean closeSession(com.saperion.connector.authentication.Session session) throws SaAuthenticationException, SaSystemException
Session
of logged in usercloseSession
in interface SaClassicConnector
SaAuthenticationException
SaSystemException
SaClassicConnector.closeSession(Session)
public boolean logoff() throws SaAuthenticationException, SaSystemException
SaClassicConnector
SaClassicConnector.logon(Credentials)
.logoff
in interface SaClassicConnector
SaAuthenticationException
- user was not logged inSaSystemException
- remote exceptionpublic InputStream readReleasedDocument(String docHdoc, boolean currentRevision, int elementNumber) throws SaSystemException, SaAuthenticationException
SaClassicConnector
readReleasedDocument
in interface SaClassicConnector
docHdoc
- the doc hdoccurrentRevision
- the current revisionelementNumber
- the element numberSaSystemException
- the sa system exceptionSaAuthenticationException
- when the user is not logged in or has insufficient rightspublic InputStream readDocument(String docHdoc, boolean currentRevision, int elementNumber) throws SaSystemException, SaAuthenticationException
SaClassicConnector
InputStream
instance from the appropriate
document in the backend system. This document is specified by its UID (XHDOC).InputStream.read()
readDocument
in interface SaClassicConnector
docHdoc
- The ID of the document (XHDOC)currentRevision
- flag indicating that the current revision of the document should be retrieved by
resolving the XHDOC.elementNumber
- position in the document structure; 0 if the document is unstructured, -1 returns
a single multi-page tif containing all content elements, but only for COLD and
multi-page tif documentsInputStream
containing the document contentSaSystemException
- if a backend system error occursSaAuthenticationException
- if the user is not logged in or has insufficient rightspublic InputStream readDocument(String docHdoc, boolean currentRevision, int elementNumber, boolean withAnnotations) throws SaSystemException, SaAuthenticationException
SaClassicConnector
InputStream
instance from the appropriate
document in the backend system. This document is specified by its UID (XHDOC).InputStream.read()
readDocument
in interface SaClassicConnector
docHdoc
- The ID of the document (XHDOC)currentRevision
- flag indicating that the current revision of the document should be retrieved by
resolving the XHDOC.elementNumber
- position in the document structure; 0 if the document is unstructured, -1 returns
a single multi-page tif containing all content elements, but only for COLD and
multi-page tif documentswithAnnotations
- if true, annotations will be saved on the document streamSaSystemException
- if a backend system error occursSaAuthenticationException
- if the user is not logged in or has insufficient rightspublic SaPropertyValue[] readDocumentMetadata(String documentSysRowID, String ddcName, String[] fields) throws SaSystemException, SaAuthenticationException
SaClassicConnector
The returned metadata fields depend on the corresponding document definition table (DDC).
readDocumentMetadata
in interface SaClassicConnector
documentSysRowID
- The ID of the document (SYSROWID)ddcName
- The name of the database definitionfields
- Fieldnames to be read. If empty or null, all fields will be read.SaPropertyValue
instances.SaSystemException
- if a backend system error occurs during the document creationSaAuthenticationException
- if the user is not logged in or has insufficient rights@Deprecated public String getFulltext(String ddcName, String sysRowId) throws SaSystemException, SaAuthenticationException
SaClassicConnector
getFulltext
in interface SaClassicConnector
ddcName
- DDC name of the documentsysRowId
- SYSROWID of the documentSaSystemException
- if a backend system error occurs during the fulltext get operationSaAuthenticationException
- if the user is not logged in or has insufficient rightspublic String getFulltext(String ddcName, String hdoc, String fieldName, long length) throws SaSystemException, SaAuthenticationException
SaClassicConnector
getFulltext
in interface SaClassicConnector
ddcName
- DDC name of the documenthdoc
- HDOC of the documentfieldName
- name of the fulltext field to read fromlength
- length of the content to return. If -1, the complete content will be returned.SaSystemException
- if a backend system error occurs during the fulltext get operationSaAuthenticationException
- if the user is not logged in or has insufficient rightspublic byte[] getThumbnail(String hDoc, int widthX, int widthY, boolean color) throws SaSystemException, SaAuthenticationException
SaClassicConnector
getThumbnail
in interface SaClassicConnector
hDoc
- HDoc for the document.widthX
- Width X or -1 to auto-calculatewidthY
- Width Y or -1 to auto-calculatecolor
- True for coloredSaSystemException
- System exceptionSaAuthenticationException
- when the user is not logged in or has insufficient rights@Deprecated public SaSaveInfo createDocument(String ddcName, Properties namevaluePairs, InputStream[] content, String versionComment) throws SaSystemException, SaAuthenticationException, SaDDCException
SaClassicConnector
createDocument
in interface SaClassicConnector
ddcName
- The name of the database definitionnamevaluePairs
- A properties object containing the metadata of the document (e.g index fields and
their values)content
- Multiple content data (an array of InputStream
instances)versionComment
- The comment for the versionSaSaveInfo
object describing the documentSaSystemException
- SaSystemExceptionSaAuthenticationException
- if the user is not logged in or has insufficient rightsSaDDCException
- if a DDC related error occurs@Deprecated public SaSaveInfo createDocument(String ddcName, Properties namevaluePairs, InputStream[] content, String versionComment, String acls) throws SaSystemException, SaAuthenticationException, SaDDCException
SaClassicConnector
createDocument
in interface SaClassicConnector
ddcName
- The name of the database definitionnamevaluePairs
- A properties object containing the metadata of the document (e.g index fields and
their values)content
- Multiple content data (an array of InputStream
instances)versionComment
- The comment for the versionacls
- ACL name string (semicolon separated)SaSystemException
- if a backend system error occurs during the document creationSaAuthenticationException
- if the user is not logged in or has insufficient rightsSaDDCException
- if a DDC related error occurspublic SaSaveInfo createDocument(DocumentInfo document) throws SaSystemException, SaAuthenticationException, SaDDCException
SaClassicConnector
DocumentInfo
.
The document with indexes, contents, variables etc. given in the DocumentInfo
will be stored
in the backend repository.
createDocument
in interface SaClassicConnector
document
- the DocumentInfo
object containing the document data to createSaSaveInfo
object describing the new created documentSaSystemException
- if a backend system error occurs during the document creationSaAuthenticationException
- if the user is not logged in or has insufficient rightsSaDDCException
- if a DDC related error occurspublic SaSaveInfo createLink(LinkInfo link) throws SaSystemException, SaAuthenticationException, SaDDCException
SaClassicConnector
LinkInfo
.
createLink
in interface SaClassicConnector
link
- info LinkInfo
to create a linkSaSaveInfo
of new created linkSaSystemException
- if a backend system error occurs during the link creationSaAuthenticationException
- if the user is not logged in or has insufficient rightsSaDDCException
- if a DDC related error occurs@Deprecated public SaSaveInfo updateDocument(String ddcName, String documentHDOC, Properties namevaluePairs, InputStream[] content, String versionComment) throws SaSystemException, SaAuthenticationException, SaDDCException
SaClassicConnector
updateDocument
in interface SaClassicConnector
ddcName
- The name of the database definitiondocumentHDOC
- The ID of the document (HDOC)namevaluePairs
- A properties object containing the metadatacontent
- Multiple content dataversionComment
- The comment for the versionSaSystemException
- if a backend system error occursSaAuthenticationException
- if the user is not logged in or has insufficient rightsSaDDCException
- if a DDC related error occurspublic boolean lockDocument(String sysRowId, String ddcName) throws SaSystemException, SaAuthenticationException, SaLockException
SaClassicConnector
To ensure that the user has exclusive access to the document, the methods SaClassicConnector.lockDocument(String, String)
and
SaClassicConnector.unlockDocument(String, String)
for the document object must be used.
All locked documents with a reference to the locking user are listed in the XLOCKS system table.
lockDocument
in interface SaClassicConnector
sysRowId
- SysRowId of document to lockddcName
- DDC nameSaSystemException
- if a backend system error occursSaAuthenticationException
- if when the user is not logged in or has insufficient rightsSaLockException
- if a lock operation related error occorspublic boolean unlockDocument(String sysRowId, String ddcName) throws SaSystemException, SaAuthenticationException, SaLockException
SaClassicConnector
Releases the lock that was created by the SaClassicConnector.lockDocument(String, String)
method.
unlockDocument
in interface SaClassicConnector
sysRowId
- SysRowId of document to unlockddcName
- DDC nameSaSystemException
- if a backend system error occursSaAuthenticationException
- if the user is not logged in or has insufficient rightsSaLockException
- if a lock operation related error occorspublic SaDocInfo getDocumentInfo(String hDoc, boolean currentRevision, boolean resolveLinks) throws SaSystemException, SaAuthenticationException
SaClassicConnector
SaClassicConnector.readDocumentMetadata(String, String, String[])
or
SaClassicConnector.searchHQL(SaQueryInfo)
to load metadata from the database.
getDocumentInfo
in interface SaClassicConnector
hDoc
- Document HDOCcurrentRevision
- True for current revisionresolveLinks
- True for resolve linksSaDocInfo
object containing the requested document informationSaSystemException
- if a backend system error occurs during the get operationSaAuthenticationException
- if the user is not logged in or has insufficient rightsSaClassicConnector.getDocumentInfo(String, boolean, boolean, boolean)
public SaDocInfo getDocumentInfo(String hDoc, boolean currentRevision, boolean resolveLinks, boolean forceSizeDetermination) throws SaSystemException, SaAuthenticationException
SaClassicConnector
SaClassicConnector.readDocumentMetadata(String, String, String[])
or
SaClassicConnector.searchHQL(SaQueryInfo)
to load metadata from the database.getDocumentInfo
in interface SaClassicConnector
hDoc
- Document HDOCcurrentRevision
- True for current revisionresolveLinks
- True for resolve linksforceSizeDetermination
- Forces the backend to determine the size of each element, even if it is not
already available. Reqiures loading the document, so use only if really required.SaSystemException
- if a backend system error occurs during the discard operationSaAuthenticationException
- if the user is not logged in or has insufficient rights@Deprecated public SaSaveInfo updateDocument(String ddcName, String documentHDOC, Properties namevaluePairs, InputStream[] content, String versionComment, String acls) throws SaSystemException, SaAuthenticationException, SaDDCException
SaClassicConnector
SaClassicConnector.searchHQL(SaQueryInfo)
, SaDocumentInfo.isCheckedout()
and SaDocumentInfo.isLocked()
.updateDocument
in interface SaClassicConnector
ddcName
- The name of the database definitiondocumentHDOC
- The ID of the document (HDOC)namevaluePairs
- A properties object containing the metadatacontent
- Multiple content dataversionComment
- The comment for the versionacls
- ACL name string, if null
it will be ignored, to delete existing ACLs
set an empty stringSaSystemException
- if a backend system error occursSaAuthenticationException
- if the user is not logged in or has insufficient rightsSaDDCException
- if a DDC related error occurs@Deprecated public SaSaveInfo updateDocument(String ddcName, String documentHDOC, Properties namevaluePairs, InputStream[] content, String versionComment, String acls, boolean resolveLinks) throws SaSystemException, SaAuthenticationException, SaDDCException
SaClassicConnector
SaClassicConnector.searchHQL(SaQueryInfo)
, SaDocumentInfo.isCheckedout()
and SaDocumentInfo.isLocked()
.updateDocument
in interface SaClassicConnector
ddcName
- The name of the database definitiondocumentHDOC
- The ID of the document (HDOC)namevaluePairs
- A properties object containing the metadatacontent
- Multiple content dataversionComment
- The comment for the versionacls
- ACL name string, if null
it will be ignored, to delete existing ACLs
set an empty stringresolveLinks
- Resolve linksSaSystemException
- if a backend system error occursSaAuthenticationException
- if the user is not logged in or has insufficient rightsSaDDCException
- if a DDC related error occurs@Deprecated public SaSaveInfo updateDocument(String ddcName, String documentHDOC, Properties namevaluePairs, InputStream[] content, String versionComment, String acls, boolean resolveLinks, boolean checkin) throws SaSystemException, SaAuthenticationException, SaDDCException
SaClassicConnector
SaClassicConnector.searchHQL(SaQueryInfo)
, SaDocumentInfo.isCheckedout()
and SaDocumentInfo.isLocked()
.updateDocument
in interface SaClassicConnector
ddcName
- The name of the database definitiondocumentHDOC
- The ID of the document (HDOC)namevaluePairs
- A properties object containing the metadatacontent
- Multiple content dataversionComment
- The comment for the versionacls
- ACL name string, if null
it will be ignored, to delete existing ACLs
set an empty stringresolveLinks
- Resolve linkscheckin
- Checkin documentSaSystemException
- if a system error occuredSaAuthenticationException
- if the user is not logged in or has insufficient rightsSaDDCException
- if a database definition was invalid or not foundpublic SaSaveInfo updateDocument(UpdateDocumentInfo updateInfo) throws SaSystemException, SaAuthenticationException, SaDDCException
SaClassicConnector
If the document was checked out, this method can be used to checkin the document. Set
UpdateDocumentInfo.setCheckin(Boolean)
to true to checkin the document when updating.
If only metadata should be modified, the ContentStream[] in the UpdateDocumentInfo
should be set to null when updating.
To control the update/remove behavior of the content streams during this update operation,
please take a look into the ContentStream.ContentStream(Integer)
documentation.
NOTE: With this method it is possible to update documents that are locked or checked out by other users. If
this behaviour is not desired one has to implement the according checks oneself using
SaClassicConnector.searchHQL(SaQueryInfo)
, SaDocumentInfo.isCheckedout()
and SaDocumentInfo.isLocked()
.
updateDocument
in interface SaClassicConnector
updateInfo
- UpdateDocumentInfo
object containing the data to changeSaSaveInfo
information about the saved documentSaSystemException
- if a system error occuredSaAuthenticationException
- if the user is not logged in or has insufficient rightsSaDDCException
- if a database definition was invalid or not foundpublic void checkoutDocument(String hDoc) throws SaSystemException, SaAuthenticationException, SaGetNodeException
SaClassicConnector
This call should be performed before a document is edited to protect the document from conflicting changes.
The checkin-operation is performed when the document is saved using SaClassicConnector.updateDocument(UpdateDocumentInfo)
.
Note:
While the document is checked out, other users are able to access a read-only version of the latest revision,
but they are not able to modify the document until the check out is discarded via
SaClassicConnector.discardCheckout(String)
or persisted via SaClassicConnector.updateDocument(UpdateDocumentInfo)
.
checkoutDocument
in interface SaClassicConnector
hDoc
- id (HDOC) of document to checkoutSaSystemException
- if a backend system error occurs during the check out operationSaAuthenticationException
- if the user is not logged in or has insufficient rightsSaGetNodeException
- if an error occurs while getting the document node or contentpublic void discardCheckout(String hDoc) throws SaSystemException, SaAuthenticationException, SaGetNodeException
SaClassicConnector
SaClassicConnector.checkoutDocument(String)
.
After discarding the checkout, other users a able to modify the document again.discardCheckout
in interface SaClassicConnector
hDoc
- id (HDOC) of document to discard a checkout forSaSystemException
- if a backend system error occurs during the discard operationSaAuthenticationException
- if the user is not logged in or has insufficient rightsSaGetNodeException
- if an error occurs while getting the document node or contentpublic void releaseDocument(String ddcName, String hDoc, String versionComment) throws SaSystemException, SaAuthenticationException, SaGetNodeException, SaSetNodeException, SaDDCException
SaClassicConnector
releaseDocument
in interface SaClassicConnector
ddcName
- the ddc namehDoc
- Document HDOCversionComment
- the version commentSaSystemException
- SaRMICommandExceptionSaAuthenticationException
- when the user is not logged in or has insufficient rightsSaGetNodeException
- SaGetNodeExceptionSaSetNodeException
- the sa set node exceptionSaDDCException
- the sa ddc exceptionpublic boolean isReleaseActive() throws SaAuthenticationException, SaSystemException
SaClassicConnector
isReleaseActive
in interface SaClassicConnector
SaAuthenticationException
- when the user is not logged in or has insufficient rightsSaSystemException
- the sa system exceptionpublic String getReleasedHdoc(String oldHdoc) throws SaAuthenticationException, SaSystemException
SaClassicConnector
getReleasedHdoc
in interface SaClassicConnector
oldHdoc
- the hdoc to lookup released hdocSaAuthenticationException
- if authentication failsSaSystemException
- the sa system exceptionpublic String getReleaseAclName() throws SaSystemException, SaAuthenticationException
SaSystemException
- the sa system exceptionSaAuthenticationException
- the sa authentication exceptionpublic SaSaveInfo restoreVersion(String versionID) throws SaSystemException, SaAuthenticationException, SaDDCException
SaClassicConnector
restoreVersion
in interface SaClassicConnector
versionID
- Version HDOCSaSystemException
- SaSystemExceptionSaAuthenticationException
- when the user is not logged in or has insufficient rightsSaDDCException
- SaDDCExceptionpublic void deleteDocument(String documentHDOC, int deleteType) throws SaSystemException, SaAuthenticationException, SaDDCException
SaClassicConnector
deleteDocument
in interface SaClassicConnector
documentHDOC
- The HDoc of the document to delete.deleteType
- Deletion strategy. Possible values are:
SaConstants.JNI_DELETECONTENT_MODE_DBSIMPLE
(0):
mark the document as deleted on the database
SaConstants.JNI_DELETECONTENT_MODE_DBCOMPLETE
(1):
delete the document from the database
SaConstants.JNI_DELETECONTENT_MODE_PURGEDOCUMENT
(2):
delete the document from the database and from the medium. Note: Some storage-systems do not
support deletion.
SaSystemException
- if a backend system error occurs during the document deletionSaAuthenticationException
- if the user is not logged in or has insufficient rightsSaDDCException
- if a DDC related error occurspublic List<String> getVersionIDs(String ddcName, String sysrowID) throws SaSystemException, SaAuthenticationException
SaClassicConnector
getVersionIDs
in interface SaClassicConnector
ddcName
- The name of the database definitionsysrowID
- The ID of the documentSaSystemException
- if a backend system error occursSaAuthenticationException
- when the user is not logged in or has insufficient rightspublic InputStream readVersionDocument(String docHdoc, int elementNumber) throws SaSystemException, SaAuthenticationException
SaClassicConnector
readVersionDocument
in interface SaClassicConnector
docHdoc
- Version ID (XHDOC is the revision number of the document)elementNumber
- Element numberSaSystemException
- if a backend system error occurs during the document creationSaAuthenticationException
- when the user of this session is not logged in (anymore) or has insufficient rightspublic SaVersionData readVersionMetadata(String versionID) throws SaSystemException, SaAuthenticationException, SaDDCException
SaClassicConnector
readVersionMetadata
in interface SaClassicConnector
versionID
- Version ID (XHDOC is the revision number of the document)SaSystemException
- if a backend system error occurs during the read operationSaAuthenticationException
- SaAuthenticationExceptionSaDDCException
- SaDDCExceptionpublic SaVersionData readVersionMetadata(String versionID, boolean resolveLinks) throws SaSystemException, SaAuthenticationException, SaDDCException
SaClassicConnector
readVersionMetadata
in interface SaClassicConnector
versionID
- Version ID (XHDOC is the revision number of the document)resolveLinks
- If false will not resolve the link and show the metadata associated with the link itself.SaSystemException
- if a backend system error occurs during the read operationSaAuthenticationException
- SaAuthenticationExceptionSaDDCException
- SaDDCExceptionpublic String readVersionDocumentFilename(String docHdoc, int elementNumber) throws SaSystemException, SaAuthenticationException, SaDDCException
SaClassicConnector
readVersionDocumentFilename
in interface SaClassicConnector
docHdoc
- The ID of the document (XHDOC)elementNumber
- position in the document structure; 0 if the document is unstructured.SaSystemException
- SaSystemExceptionSaAuthenticationException
- SaAuthenticationExceptionSaDDCException
- SaDDCException@Deprecated public List<SaPropertyValue[]> search(String hqlQuery) throws SaSystemException, SaAuthenticationException, SaDBException
SaClassicConnector
search
in interface SaClassicConnector
hqlQuery
- the Hibernate query - hql.SaPropertyValue
object.SaSystemException
- SaSystemExceptionSaAuthenticationException
- when the user is not logged in or has insufficient rightsSaDBException
- exception thrown during query executionpublic List<SaDocumentInfo> searchHQL(SaQueryInfo hqlQuery) throws SaSystemException, SaAuthenticationException, SaDBException
SaClassicConnector
searchHQL
in interface SaClassicConnector
hqlQuery
- the Hibernate query info.SaSystemException
- SaSystemExceptionSaAuthenticationException
- when the user is not logged in or has insufficient rightsSaDBException
- exception thrown during query execution@Deprecated public boolean removeEvent(SaEvent event) throws SaSystemException
SaClassicConnector
removeEvent
in interface SaClassicConnector
event
- Event objectSaSystemException
- if a backend system error occurs@Deprecated public void addListener(SaEventListener listener) throws SaSystemException, SaAuthenticationException
SaClassicConnector
addListener
in interface SaClassicConnector
listener
- Event listenerSaSystemException
- SaSystemExceptionSaAuthenticationException
- SaAuthenticationException@Deprecated public void removeListener(SaEventListener listener) throws SaSystemException
SaClassicConnector
removeListener
in interface SaClassicConnector
listener
- Event listenerSaSystemException
- SaSystemException@Deprecated public void addListener(SaStatusEventListener listener) throws SaAuthenticationException, SaSystemException
SaClassicConnector
addListener
in interface SaClassicConnector
listener
- Event listenerSaAuthenticationException
- SaAuthenticationExceptionSaSystemException
- SaSystemException@Deprecated public void removeListener(SaStatusEventListener listener) throws SaSystemException
SaClassicConnector
removeListener
in interface SaClassicConnector
listener
- Event listenerSaSystemException
- SaSystemExceptionpublic String readDocumentFilename(String docHdoc, boolean currentRevision, int elementNumber) throws SaSystemException, SaAuthenticationException, SaDDCException
SaClassicConnector
readDocumentFilename
in interface SaClassicConnector
docHdoc
- The ID of the document (XHDOC)currentRevision
- flag indicating that the current revision of the document should be retrieved by
resolving the HDoc.elementNumber
- position in the document structure; 0 if the document is unstructured.SaSystemException
- SaSystemExceptionSaAuthenticationException
- SaAuthenticationExceptionSaDDCException
- SaDDCExceptionpublic String getACLNames(String documentHDOC) throws SaSystemException, SaAuthenticationException, SaDDCException
SaClassicConnector
SaClassicConnector.getACLRights(String[])
to evaluate the rights of the current user on the given ACLs.getACLNames
in interface SaClassicConnector
documentHDOC
- The ID of the document revision (XHDOC)SaSystemException
- on general system failuresSaAuthenticationException
- when the classic connector is not authenticated or the current user has not the required rights for
the operationSaDDCException
- on functional failures concerning the given document@Deprecated public List<String> getAllACLs() throws SaSystemException, SaAuthenticationException
SaClassicConnector
getAllACLs
in interface SaClassicConnector
SaSystemException
- Remote exceptionSaAuthenticationException
- SaAuthenticationExceptionpublic List<String> getInvolvedUsers(String documentHDOC) throws SaSystemException, SaAuthenticationException, SaDDCException
SaClassicConnector
getInvolvedUsers
in interface SaClassicConnector
documentHDOC
- The ID of the document (XHDOC)SaSystemException
- on general system failuresSaAuthenticationException
- when the classic connector is not authenticated or the current user has not the required rights for
the operationSaDDCException
public SaSaveInfo setACLName(String ddcname, String documentHDOC, String acl, String versionComment) throws SaSystemException, SaAuthenticationException, SaDDCException, SaSetACLException
SaClassicConnector
setACLName
in interface SaClassicConnector
ddcname
- the name of the ddc in saperiondocumentHDOC
- The ID of the document (XHDOC)acl
- a ';' separated String of acl names that identify the Access Control Lists are requested to secure
the given documentversionComment
- since changing a documents security creates a new revision, a revision comment must be given.SaSystemException
- on general system failuresSaAuthenticationException
- when the classic connector is not authenticated or the current user has not the required rights for
the operationSaDDCException
- when the definition name given was invalidSaSetACLException
- on functional failures concerning the given document or aclspublic SaDocAccessData getDocumentAccessData(String documentHDOC) throws SaSystemException, SaAuthenticationException
SaClassicConnector
getDocumentAccessData
in interface SaClassicConnector
documentHDOC
- The ID of the document (XHDOC)SaSystemException
- on general system failuresSaAuthenticationException
- when the classic connector is not authenticated or the current user has not the required rights for
the operationpublic SaLockInfo getLockInfo(String sysRowId) throws SaSystemException, SaAuthenticationException, SaLockException
SaClassicConnector
getLockInfo
in interface SaClassicConnector
sysRowId
- Document SysRowIdSaSystemException
- on general system failuresSaAuthenticationException
- when the classic connector is not authenticated or the current user has not the required rights for
the operationSaLockException
- Locking errorpublic boolean isActive()
public String getCurrentUserName()
SaClassicConnector
getCurrentUserName
in interface SaClassicConnector
public SaWFConnector getWorkflowConnector() throws SaAuthenticationException, SaSystemException
SaClassicConnector
getWorkflowConnector
in interface SaClassicConnector
SaAuthenticationException
- Authentification errorSaSystemException
- Remote exceptionpublic List<TaskInfo> getTaskList(int[] ids, String filter, Map<String,Object> parameter) throws SaAuthenticationException, SaSystemException
ids
- Box ID'sfilter
- HQL filterparameter
- Filter parameterSaAuthenticationException
- SaAuthenticationExceptionSaSystemException
- SaSystemExceptionpublic List<TaskAuditInfo> getTaskAuditList(int[] ids, String filter, Map<String,Object> parameter) throws SaAuthenticationException, SaSystemException
ids
- Box ID'sfilter
- HQL filterparameter
- Filter parameterSaAuthenticationException
- SaAuthenticationExceptionSaSystemException
- SaSystemExceptionpublic TaskInfo getTask(String taskID) throws SaAuthenticationException, SaSystemException
taskID
- Task IDSaAuthenticationException
- SaAuthenticationExceptionSaSystemException
- SaSystemExceptionpublic TaskInfo getParentTask(String taskID) throws SaAuthenticationException, SaSystemException
taskID
- Task IDSaAuthenticationException
- SaAuthenticationExceptionSaSystemException
- SaSystemExceptionpublic Collection<CommandInfo> getCommandInfos(String docUID) throws SaAuthenticationException, SaSystemException
docUID
- Document UID of taskSaAuthenticationException
- SaAuthenticationExceptionSaSystemException
- SaSystemExceptionpublic Collection<CommandInfo> getCommandInfos(String docUID, boolean transitionsOnly) throws SaAuthenticationException, SaSystemException
docUID
- Document UID of tasktransitionsOnly
- if true, only transition commands will be returnedSaAuthenticationException
- SaAuthenticationExceptionSaSystemException
- SaSystemExceptionpublic List<BoxDefinition> getBoxDefinitions() throws SaAuthenticationException, SaSystemException
SaAuthenticationException
- SaAuthenticationExceptionSaSystemException
- SaSystemExceptionpublic Long getBoxCount(int boxId) throws SaAuthenticationException, SaSystemException
boxId
- the workflow box idSaAuthenticationException
- if an error occurs.SaSystemException
- if an error occurs.public String executeCommand(ContextInfo contextInfo) throws SaAuthenticationException, SaSystemException, SaWorkflowException
contextInfo
- Context infoSaAuthenticationException
- SaAuthenticationExceptionSaSystemException
- SaSystemExceptionSaWorkflowException
- Workflow exceptionpublic List<CommentInfo> getCommentInfos(String taskId) throws SaAuthenticationException, SaSystemException, SaWorkflowException
taskId
- Task IDSaAuthenticationException
- SaAuthenticationExceptionSaSystemException
- SaSystemExceptionSaWorkflowException
- Workflow exceptionpublic List<HistoryInfo> getHistoryInfos(String taskId) throws SaAuthenticationException, SaSystemException, SaWorkflowException
taskId
- Task IDSaAuthenticationException
- SaAuthenticationExceptionSaSystemException
- SaSystemExceptionSaWorkflowException
- Workflow exceptionpublic List<List<HistoryInfo>> getCompleteHistoryInfos(String docId) throws SaAuthenticationException, SaSystemException, SaWorkflowException
docId
- Document IDSaAuthenticationException
- SaAuthenticationExceptionSaSystemException
- SaSystemExceptionSaWorkflowException
- Workflow exceptionpublic List<String> getWorkflowDefinitions() throws SaAuthenticationException, SaSystemException, SaWorkflowException
SaAuthenticationException
- SaAuthenticationExceptionSaSystemException
- SaSystemExceptionSaWorkflowException
- Workflow exceptionpublic List<ProcessDefinitionDescriptor> getWorkflowDefinitions(String ddcName) throws SaAuthenticationException, SaSystemException, SaWorkflowException
ddcName
- name of the DDCSaAuthenticationException
- authentication error when loading definitionsSaSystemException
- system error when loading definitionsSaWorkflowException
- workflow error when loading definitionspublic String getWorkflowDdcName() throws SaSystemException
SaSystemException
- SaSystemExceptionpublic void addComment(String comment, String taskUID, int level) throws SaAuthenticationException, SaSystemException, SaWorkflowException
comment
- CommenttaskUID
- Task UIDlevel
- LevelSaAuthenticationException
- SaAuthenticationExceptionSaSystemException
- SaSystemExceptionSaWorkflowException
- Workflow exceptionpublic void addHistory(String description, String taskUID) throws SaAuthenticationException, SaSystemException, SaWorkflowException
description
- CommenttaskUID
- Task UIDSaAuthenticationException
- SaAuthenticationExceptionSaSystemException
- SaSystemExceptionSaWorkflowException
- Workflow exceptionpublic boolean getOutOfOffice() throws SaAuthenticationException, SaSystemException
SaAuthenticationException
- SaAuthenticationExceptionSaSystemException
- SaSystemExceptionpublic String getSubstitute() throws SaAuthenticationException, SaSystemException
SaAuthenticationException
- SaAuthenticationExceptionSaSystemException
- SaSystemExceptionpublic void setOutOfOffice(boolean isOutOfOffice) throws SaAuthenticationException, SaSystemException
isOutOfOffice
- is OutOfOfficeSaAuthenticationException
- SaAuthenticationExceptionSaSystemException
- SaSystemExceptionpublic void setSubstitute(String name) throws SaAuthenticationException, SaSystemException
name
- Substitute nameSaAuthenticationException
- SaAuthenticationExceptionSaSystemException
- SaSystemExceptionpublic WorkflowMember getMembers() throws SaAuthenticationException, SaSystemException
SaAuthenticationException
- SaAuthenticationExceptionSaSystemException
- SaSystemExceptionpublic WorkflowMember getMember(WorkflowMember member, int depth, String filter) throws SaAuthenticationException, SaSystemException
member
- Starting memberdepth
- Depth to readfilter
- filter stringSaAuthenticationException
- SaAuthenticationExceptionSaSystemException
- SaSystemExceptionpublic boolean isAlive() throws SaSystemException
SaClassicConnector
isAlive
in interface SaClassicConnector
SaSystemException
- System exceptionpublic List<String> getUsers(String filter) throws SaSystemException, SaAuthenticationException
filter
- FilterSaSystemException
- SaSystemExceptionSaAuthenticationException
- SaAuthenticationException@Deprecated public String getAnnotations(String hDoc, int indexOfContentElement) throws SaAuthenticationException, SaSystemException
SaClassicConnector
getAnnotations
in interface SaClassicConnector
hDoc
- Document HDOCindexOfContentElement
- the index of the chosen context elementSaAuthenticationException
- if the user is not logged in or has insufficient rightsSaSystemException
- if a backend system error occurspublic String getAnnotations(String hDoc, int indexOfContentElement, boolean currentRevision) throws SaAuthenticationException, SaSystemException
SaClassicConnector
The returned annotation string contains a list of annotation using an INI format. 5 diffrent annotations types are available. Each annotation starts with its type description and a list of properties describing the annotation format.
Annotation types:
Example for a text marker:
[HIGHLIGHT] X = <x> Y = <y> WIDTH = <width> HEIGHT = <height> LINEWIDTH = 0 FILLCOLOR = 255, 128, 0 TRANSPARENT = 1 PAGE =EDIT = 1 LABEL = Highlight1 BORDER = 1 SEMITRANSPARENT = 1
Example for a sticky node:
[TEXT] X = <x> Y = <y> WIDTH = <width> HEIGHT = <height> PAGE = <page> EDIT = 1 LABEL = text1 TEXT = <text> FONT_HEIGHT = 67 BORDER = 1 COLOR = 255, 0, 0 FILLCOLOR = 255, 255, 255 TRANSPARENT = 0 SEMITRANSPARENT = 0 FONT_NAME = Arial FONT_BOLD = 0 FONT_ITALIC = 0 FONT_UNDERLINE = 0 FONT_STRIKETHROUGH = 0 BORDER = 1 SEMITRANSPARENT = 1
Example for a black marker:
[BLACKMARKER] X = <x> Y = <y> WIDTH = <width> HEIGHT = <height> LINEWIDTH = 0 FILLCOLOR = 0, 0, 0 TRANSPARENT = 0 PAGE = <page> EDIT = 1 LABEL = Highlight1 BORDER = 1 SEMITRANSPARENT = 1
Example for a arrow annotation:
[ARROW] X1 = <x1> Y1 = <y1> X2 = <x2> Y2 = <y2> PAGE = <page> EDIT = 1 LABEL = Arrow1 COLOR = 255, 0, 0 LINEWIDTH = 10A custom-section is contained in the INI that contains information for the client about how to handle annotations. See online documentation for more information about the custom-section.
getAnnotations
in interface SaClassicConnector
hDoc
- Document HDOCindexOfContentElement
- the index of the chosen context elementcurrentRevision
- true to get current revisionSaAuthenticationException
- if the user is not logged in or has insufficient rightsSaSystemException
- if a backend system error occurspublic void setAnnotations(String hDoc, int indexOfContentElement, String annotations) throws SaAuthenticationException, SaSystemException
SaClassicConnector
For the annotation string definition to set,
please take a look into the SaClassicConnector.getAnnotations(String, int, boolean)
documentation and the
online documentation
for more information about the custom-section.
setAnnotations
in interface SaClassicConnector
hDoc
- Document HDOCindexOfContentElement
- the index of the chosen context elementannotations
- Annotation string, definition described here SaClassicConnector.getAnnotations(String, int, boolean)
SaAuthenticationException
- Authentication errorSaSystemException
- Remote exceptionpublic SaSystemSetting getSystemSetting(String accessKey) throws SaSystemException, SaAuthenticationException
SaClassicConnector
getSystemSetting
in interface SaClassicConnector
accessKey
- key to get associated system settingSaSystemSetting
SaSystemException
- System exceptionSaAuthenticationException
- when the user is not logged in or has insufficient rightspublic SaSystemInfo getSystemInfo() throws SaSystemException
SaClassicConnector
getSystemInfo
in interface SaClassicConnector
SaSystemException
- on general system failurespublic SaFeature getFeatures() throws SaSystemException
SaClassicConnector
getFeatures
in interface SaClassicConnector
SaSystemException
- on general system failurespublic SaUserSetting getUserSetting(String accessKey) throws SaSystemException, SaAuthenticationException
SaClassicConnector
getUserSetting
in interface SaClassicConnector
accessKey
- The key to get associated user setting. The key consists of the type of the
setting and a key to identify the setting separated by '|'.PROPERTIES|TheNameOfTheSection
$my_tenant$
, which will be replaced by the current
tenant's ID and $all_tenants$
, which will be replaced by the ID
representing all tenants.SaUserSetting
SaSystemException
- System exceptionSaAuthenticationException
- when the user is not logged in or has insufficient rightspublic void setUserSetting(SaUserSetting setting) throws SaSystemException, SaAuthenticationException
SaClassicConnector
setUserSetting
in interface SaClassicConnector
setting
- the SaUserSetting
object to be storedSaSystemException
- System exceptionSaAuthenticationException
- when the user is not logged in or has insufficient rightspublic Setting getSetting(String name, String section, boolean isLong) throws SaSystemException, SaAuthenticationException
SaClassicConnector
Setting
identified by it's key and section from the database.getSetting
in interface SaClassicConnector
name
- the setting's namesection
- the setting's sectionisLong
- whether this is a setting with a long (>2KB) value or notSaSystemException
- system error when retrieving the settingSaAuthenticationException
- authentication error when retrieving the settingpublic SettingSearchResult searchSettings(SettingSearchInfo searchInfo) throws SaSystemException, SaAuthenticationException
SaClassicConnector
searchSettings
in interface SaClassicConnector
searchInfo
- SettingSearchInfo
containing information about what to searchSettingSearchResult
SaSystemException
- system error when searchingSaAuthenticationException
- authentication errorpublic void setSetting(Setting setting) throws SaSystemException, SaAuthenticationException
SaClassicConnector
Setting
in the database.setSetting
in interface SaClassicConnector
setting
- the setting to storeSaSystemException
- system error when storing the settingSaAuthenticationException
- authentication error when storing the settingpublic boolean deleteSetting(String name, String section, boolean isLong) throws SaSystemException, SaAuthenticationException
SaClassicConnector
deleteSetting
in interface SaClassicConnector
name
- the name of the setting to deletesection
- the section of the setting to deleteisLong
- whether this is a setting with a long (>2KB) value or notSaSystemException
- system exception when deleting the settingSaAuthenticationException
- when the user is not logged in or has insufficient rights when deleting the settingpublic Map<String,String> loadLocalize(String language) throws SaWorkflowException
language
- LangageSaWorkflowException
- Workflow exceptionpublic void setLocale(Locale locale) throws SaAuthenticationException, SaSystemException
SaClassicConnector
setLocale
in interface SaClassicConnector
locale
- Localization informationSaAuthenticationException
- when the user is not logged in or has insufficient rightsSaSystemException
- SaSystemExceptionpublic void addToFolder(String folderTableDDC, String documentId, String documentDDC, String folderId) throws SaSystemException, SaAuthenticationException, SaDDCException, SaSetNodeException
SaClassicConnector
addToFolder
in interface SaClassicConnector
folderTableDDC
- name of the folder table to add documentdocumentId
- SysRowId of the document to add to folderdocumentDDC
- DDC name of the document located infolderId
- destination folder IDSaSystemException
- Remote exceptionSaAuthenticationException
- Authentication errorSaDDCException
- Database exceptionSaSetNodeException
- DDC not fileablepublic String copyFolder(String folderTableDDC, String folderId, String destinationId, String beforeChild, boolean withDocuments) throws SaSystemException, SaAuthenticationException, SaDDCException
SaClassicConnector
copyFolder
in interface SaClassicConnector
folderTableDDC
- folder table namefolderId
- tolder ID to copydestinationId
- destination folder IDbeforeChild
- ID of the child to insert the folder before or empty for appendwithDocuments
- True, if documents should be copiedSaSystemException
- Remote exceptionSaAuthenticationException
- Authentication errorSaDDCException
- Database exception@Deprecated public String createFolder(String folderTableDDC, String parentId, String beforeChild, String folderName, SaFolderConstants.FOLDER_TYPE folderType, Properties namevaluePairs) throws SaSystemException, SaAuthenticationException, SaDDCException, SaFolderNameException
SaClassicConnector
createFolder
in interface SaClassicConnector
folderTableDDC
- Folder tableparentId
- Parent folder ID or emptybeforeChild
- ID of the child to add the new folder before or empty for appendfolderName
- Folder namefolderType
- Type of the foldernamevaluePairs
- Folder propertiesSaSystemException
- Remote exceptionSaFolderNameException
- when the folder name contained an invalid characterSaAuthenticationException
- Authentication errorSaDDCException
- Database exceptionpublic String createFolder(SaFolderSaveInfo info, Properties namevaluePairs) throws SaSystemException, SaAuthenticationException, SaDDCException, SaFolderNameException
SaClassicConnector
createFolder
in interface SaClassicConnector
info
- SaFolderSaveInfo
of folder to createnamevaluePairs
- Folder properties (Attention: These properties will replace the property values in
the SaFolderSaveInfo
info above!)SaSystemException
- Remote exceptionSaFolderNameException
- when the folder name contained an invalid characterSaAuthenticationException
- Authentication errorSaDDCException
- Database exceptionpublic void deleteFolder(String folderTableDDC, String folderId) throws SaSystemException, SaAuthenticationException, SaDDCException
SaClassicConnector
deleteFolder
in interface SaClassicConnector
folderTableDDC
- Folder tablefolderId
- Folder ID to deleteSaSystemException
- Remote exceptionSaAuthenticationException
- Authentication errorSaDDCException
- Database exceptionpublic List<SaDocumentInfo> getDocumentFolders(String folderTableDDC, String documentDDC, String sysRowId) throws SaSystemException, SaAuthenticationException, SaDDCException, SaSetNodeException
SaClassicConnector
getDocumentFolders
in interface SaClassicConnector
folderTableDDC
- Folder tabledocumentDDC
- Document DDCsysRowId
- Document SysRowIdSaSystemException
- Remote exceptionSaAuthenticationException
- Authentication errorSaDDCException
- Database exceptionSaSetNodeException
- DDC not fileablepublic long getDocumentFolderCount(String folderTableDDC, String documentDDC, String sysRowId) throws SaAuthenticationException, SaSetNodeException, SaSystemException, SaDDCException
SaClassicConnector
getDocumentFolderCount
in interface SaClassicConnector
folderTableDDC
- Folder tabledocumentDDC
- Document DDCsysRowId
- Document SysRowIdSaAuthenticationException
- Authentication errorSaSetNodeException
- DDC not fileableSaSystemException
- Remote exceptionSaDDCException
- Database exceptionpublic List<SaDocumentInfo> getFolderChildren(String folderTableDDC, String folderId, int depth, SaQueryInfo filter, int allowedMaxNrOfChildFolders) throws SaSystemException, SaAuthenticationException, SaDBException, SaFolderException
SaClassicConnector
getFolderChildren
in interface SaClassicConnector
folderTableDDC
- Folder tablefolderId
- Folder IDdepth
- Depth to get children for. Needs to be gte 1.filter
- Additional HQL filter criteriaallowedMaxNrOfChildFolders
- allowed maximum number of child folders per level or -1 for no limitSaSystemException
- Remote exceptionSaAuthenticationException
- Authentication errorSaDBException
- Database exceptionSaFolderException
- Folder exception@Deprecated public SaDocumentInfo getFolderInfo(String folderTableDDC, String folderId) throws SaSystemException, SaAuthenticationException, SaDBException, SaFolderException
SaClassicConnector
getFolderInfo
in interface SaClassicConnector
folderTableDDC
- Folder tablefolderId
- Folder IDSaSystemException
- Remote exceptionSaAuthenticationException
- Authentication errorSaDBException
- Database exceptionSaFolderException
- Folder exceptionpublic SaDocumentInfo getFolderInfo(String folderTableDDC, String folderId, boolean forceLoadVariables) throws SaSystemException, SaAuthenticationException, SaDBException, SaFolderException
SaClassicConnector
getFolderInfo
in interface SaClassicConnector
folderTableDDC
- Folder tablefolderId
- Folder IDforceLoadVariables
- if true, variables will be loaded from medium if the DDC does not contain the
SYSPROPERTIES field.SaSystemException
- Remote exceptionSaAuthenticationException
- Authentication errorSaDBException
- Database exceptionSaFolderException
- Folder exceptionpublic List<SaDocumentInfo> getFolderFromPath(String folderTableDDC, String startNodeId, String folderPath) throws SaSystemException, SaAuthenticationException, SaDBException
SaClassicConnector
SaClassicConnector.getFolderByPath(String, String, String)
to retrieve a single folder.getFolderFromPath
in interface SaClassicConnector
folderTableDDC
- Folder tablestartNodeId
- ID of folder to start with or null/empty if no relative search is requiredfolderPath
- Search pathSaSystemException
- Remote exceptionSaAuthenticationException
- Authentication errorSaDBException
- Database exceptionpublic SaDocumentInfo getFolderByPath(String folderTableDDC, String startFolderId, String folderPath) throws SaSystemException, SaAuthenticationException, SaDBException
SaClassicConnector
getFolderByPath
in interface SaClassicConnector
folderTableDDC
- Folder tablestartFolderId
- ID of folder to start with or null/empty if no relative search is requiredfolderPath
- Search pathSaSystemException
- Remote exceptionSaAuthenticationException
- Authentication errorSaDBException
- Database exceptionpublic SaDocumentInfo getFolderParent(String folderTableDDC, String folderId) throws SaSystemException, SaAuthenticationException, SaDBException
SaClassicConnector
getFolderParent
in interface SaClassicConnector
folderTableDDC
- Folder tablefolderId
- Folder IDSaSystemException
- Remote exceptionSaAuthenticationException
- Authentication errorSaDBException
- Database exceptionpublic SaDocAccessData getFolderRights(String folderTableDDC, String folderId) throws SaSystemException, SaAuthenticationException, SaDDCException
SaClassicConnector
getFolderRights
in interface SaClassicConnector
folderTableDDC
- Folder tablefolderId
- Folder IDSaSystemException
- Remote exceptionSaAuthenticationException
- Authentication errorSaDDCException
- Database exceptionpublic void moveFolder(String folderTableDDC, String folderId, String destinationId, String beforeChild) throws SaSystemException, SaAuthenticationException, SaDDCException
SaClassicConnector
moveFolder
in interface SaClassicConnector
folderTableDDC
- Folder tablefolderId
- Folder IDdestinationId
- Destination folder IDbeforeChild
- Child ID or empty for appendSaSystemException
- Remote exceptionSaAuthenticationException
- Authentication errorSaDDCException
- Database exceptionpublic void moveToFolder(String folderTableDDC, String documentId, String documentDDC, String folderId, String destinationId) throws SaSystemException, SaAuthenticationException, SaDDCException
SaClassicConnector
moveToFolder
in interface SaClassicConnector
folderTableDDC
- Folder tabledocumentId
- Document SysRowIddocumentDDC
- Document DDC namefolderId
- Source folder IDdestinationId
- Destination folder IDSaSystemException
- Remote exceptionSaAuthenticationException
- Authentication errorSaDDCException
- Database exceptionpublic void removeFromFolder(String folderTableDDC, String documentSysRowId, String documentDDC, String folderId) throws SaSystemException, SaAuthenticationException, SaDDCException
SaClassicConnector
removeFromFolder
in interface SaClassicConnector
folderTableDDC
- Folder tabledocumentSysRowId
- Document SysRowIddocumentDDC
- Document DDC namefolderId
- Folder IDSaSystemException
- Remote exceptionSaAuthenticationException
- Authentication errorSaDDCException
- Database exceptionpublic List<SaDocumentInfo> searchFolderDocuments(String folderTableDDC, String folderId, SaQueryInfo hqlFilter) throws SaSystemException, SaAuthenticationException, SaDDCException
SaClassicConnector
searchFolderDocuments
in interface SaClassicConnector
folderTableDDC
- Folder tablefolderId
- Folder IDhqlFilter
- HQL query for document tables. The query text must be only the "where" filter. The
main DDC is defined as "d".SaSystemException
- Remote exceptionSaAuthenticationException
- Authentication errorSaDDCException
- Database exceptionpublic void setFolderAcl(String folderTableDDC, String folderId, String aclName) throws SaSystemException, SaAuthenticationException, SaDDCException
SaClassicConnector
setFolderAcl
in interface SaClassicConnector
folderTableDDC
- Folder tablefolderId
- Folder IDaclName
- ACL nameSaSystemException
- Remote exceptionSaAuthenticationException
- Authentication errorSaDDCException
- Database exceptionpublic void updateFolder(String folderTableDDC, String folderId, Properties namevaluePairs) throws SaSystemException, SaAuthenticationException, SaDDCException, SaFolderNameException
SaClassicConnector
updateFolder
in interface SaClassicConnector
folderTableDDC
- name of folder table (DDC)folderId
- id of folder to updatenamevaluePairs
- Folder properties to updateSaSystemException
- Remote exceptionSaFolderNameException
- when the folder name contained an invalid characterSaAuthenticationException
- Authentication errorSaDDCException
- Database exceptionSaFolderConstants.FIELD_SYSNODETYPE
,
SaFolderConstants.FOLDER_TYPE
public SaFolderClass getFolderClass(String className) throws SaSystemException, SaAuthenticationException, SaDDCException
SaClassicConnector
getFolderClass
in interface SaClassicConnector
className
- Class name in dotted notationSaSystemException
- Remote exceptionSaAuthenticationException
- authentication errorSaDDCException
- Database exceptionpublic Set<SaFolderClass> searchFolderClass(SaFolderClassSearchInfo searchInfo) throws SaSystemException, SaAuthenticationException
SaClassicConnector
searchFolderClass
in interface SaClassicConnector
searchInfo
- bean that contains the properties to search forSaSystemException
- Remote exceptionSaAuthenticationException
- authentication errorpublic List<String> getSystemFiles(SystemFileKind kind, String filter) throws SaAuthenticationException, SaSystemException
SaClassicConnector
getSystemFiles
in interface SaClassicConnector
kind
- the kind of system files to read.filter
- A filter string. Only files will be returned, that match the filter. To get all
system files of a kind set filter to the empty string.SaAuthenticationException
- error on the authentification / insufficient rightsSaSystemException
- general errorpublic void logClientEvent(String hdoc, SaConstants.ProtoEvents event, String remark) throws SaSystemException, SaAuthenticationException
SaClassicConnector
logClientEvent
in interface SaClassicConnector
hdoc
- Document HDOCevent
- Event typeremark
- RemarkSaSystemException
- general errorSaAuthenticationException
- error on the authentification / insufficient rightspublic List<SaAcl> getAcls() throws SaSystemException, SaAuthenticationException
SaClassicConnector
getAcls
in interface SaClassicConnector
SaSystemException
- on general system failuresSaAuthenticationException
- when the classic connector is not authenticated or the current user has not the required rights for
the operationpublic SaACLRights getACLRights(String[] acls) throws SaSystemException, SaAuthenticationException
SaClassicConnector
getACLRights
in interface SaClassicConnector
acls
- an array of names referencing the ACLs to evaluateSaSystemException
- on general system failuresSaAuthenticationException
- when the classic connector is not authenticated or the current user has not the required rights for
the operationpublic void changePassword(String user, String oldPassword, String tenant, String newPassword) throws SaSystemException, SaAuthenticationException
SaClassicConnector
changePassword
in interface SaClassicConnector
user
- The login name of the existing user.oldPassword
- The old password. This parameter is required, since the password should only be
changed by the user himself.tenant
- The tenant the user is defined innewPassword
- The new passwordSaSystemException
- when a system error occurredSaAuthenticationException
- when the user is not logged in or has insufficient rights
SaClassicConnector.logon(String, String, int, String)
was successfully
invoked.public List<UsersRights> getAuthorizedUsers(String hDoc, String rights, MatchKind match) throws SaSystemException, SaAuthenticationException
SaClassicConnector
getAuthorizedUsers
in interface SaClassicConnector
hDoc
- The id of the document (XHDOC).rights
- The rights the requested users should have.match
- How the rights are matched: MKONEOF - find all users that have one of the
specified rights MKEXACT - find all users that have exactly the specified rights
MKATLEAST - find all users that have at least the specified rightsSaSystemException
- on general system failuresSaAuthenticationException
- when the classic connector is not authenticated or the current user has not the required rights for
the operationpublic int getArchivedSize(String hDoc) throws SaSystemException, SaAuthenticationException
SaClassicConnector
The actual size that the archived document takes up on the storage medium. It may be compressed, and include additional data such as fulltext and other metadata.
getArchivedSize
in interface SaClassicConnector
hDoc
- The document id whichs size is wanted.SaSystemException
- if a system error occuredSaAuthenticationException
- if the user is not logged in or has insufficient rightspublic void storeSystemFile(SystemFileKind kind, String name, InputStream data) throws SaAuthenticationException, SaSystemException
SaClassicConnector
storeSystemFile
in interface SaClassicConnector
kind
- The kind of systemfile to store.name
- The name of the file.data
- The content of the file to save.SaAuthenticationException
- error on the authentification / insufficient rightsSaSystemException
- general errorpublic InputStream loadSystemFile(SystemFileKind kind, String name) throws SaAuthenticationException, SaSystemException
SaClassicConnector
loadSystemFile
in interface SaClassicConnector
kind
- The kind of system file to loadname
- The name of the file to load.SaAuthenticationException
- error on the authentification / insufficient rightsSaSystemException
- general error@Deprecated public Set<FolderUpdateInfo> getFolderUpdateInfo(Map<String,Long> folderIds) throws SaAuthenticationException, SaSystemException
SaClassicConnector
getFolderUpdateInfo
in interface SaClassicConnector
folderIds
- Map of folderIds (simple, workflow, ..) with the time stamps of the last refresh
to build the cut set of.SaAuthenticationException
- when the user is not logged in or has insufficient rightsSaSystemException
- when a system error occuredpublic SapDocInfo checkSapUrl(String url) throws SaSystemException, SaSapUrlException, SaAuthenticationException
SaClassicConnector
checkSapUrl
in interface SaClassicConnector
url
- the SAP URL to checkSaSaveInfo
object with hdoc und ddc name describing the found documentSaSystemException
- if a system error occuredSaAuthenticationException
- if the user is not logged in or has insufficient rightsSaSapUrlException
public SaSaveInfo cacheDocument(String xhDoc, DocumentInfo document) throws SaSystemException, SaAuthenticationException, SaDDCException
SaClassicConnector
The document will not be persisted to a storage or medium.
To persist a document in the backend system please use the method SaClassicConnector.createDocument(DocumentInfo)
.
The given xhdoc should already exist on the named DDC.
This method should only used by cosolidation services like the IXOS connetor.
cacheDocument
in interface SaClassicConnector
xhDoc
- The xhdoc of the Document to cachedocument
- the DocumentInfo
about the document to cacheSaSaveInfo
of the cached documentSaSystemException
- if a backend system error occurrs during the cache operationSaAuthenticationException
- if the user is not logged in or has insufficient rightsSaDDCException
- if a DDC related error occurspublic String resolveLatestHDoc(String oldHdoc) throws SaSystemException, SaAuthenticationException
SaClassicConnector
resolveLatestHDoc
in interface SaClassicConnector
oldHdoc
- the HDOC to identify the documentSaSystemException
- if a backend system error occursSaAuthenticationException
- SaAuthenticationExceptionpublic SaSaveInfo cacheDocument(String xhDoc, String ddcName, Properties namevaluePairs, InputStream[] content, String versionComment, String strAcl) throws SaSystemException, SaAuthenticationException, SaDDCException
SaClassicConnector
The document will not be persisted to a storage or medium.
To persist a document in the backend system please use the method SaClassicConnector.createDocument(DocumentInfo)
.
The given xhdoc should already exist on the named DDC.
This method should only used by cosolidation services like the IXOS connetor.
cacheDocument
in interface SaClassicConnector
xhDoc
- The xhdoc of the document to cacheddcName
- The name of the database definition (DDC) to cache the documentnamevaluePairs
- A properties object containing the metadata of the document (e.g index fields and
their values)content
- Multiple content data (an array of InputStream
instances)versionComment
- The comment for the versionstrAcl
- the names of acls (comma sessparated list)SaSaveInfo
object describing the cached documentSaSystemException
- if a backend system error occurrs during the cache operationSaAuthenticationException
- if the user is not logged in or has insufficient rightsSaDDCException
- if a DDC related error orrurspublic SaUserInfo getCurrentUserInfo() throws SaAuthenticationException, SaSystemException
SaClassicConnector
getCurrentUserInfo
in interface SaClassicConnector
SaAuthenticationException
- when the classic connector is not authenticated or the current user has not the required rights for
the operationSaSystemException
- on general system failurespublic void setCurrentUserPresent(boolean present) throws SaAuthenticationException, SaSystemException
SaClassicConnector
setCurrentUserPresent
in interface SaClassicConnector
present
- whether the current user is presentSaAuthenticationException
- authentication errorSaSystemException
- system errorpublic void updateCurrentUserInformation(MutableUserInformation user) throws SaAuthenticationException, SaSystemException
SaClassicConnector
MutableUserInformation
instance instead of an SaUserInfo
instance as parameter.updateCurrentUserInformation
in interface SaClassicConnector
user
- - the information to changeSaAuthenticationException
- when the classic connector is not authenticated or the current user has not the required rights for
the operationSaSystemException
- on general system failurespublic <T extends Serializable> T invoke(LegacyOperation<T> operation) throws SaAuthenticationException, SaSystemException
LegacyConnection
Operation
on the server side.invoke
in interface LegacyConnection
T
- The return type of the given operationoperation
- The operation to invoke. After invocation calling operation.getResult() will
yield the same as the return of this call.SaAuthenticationException
- When the user is not correctly logged on, this may result from a session time outSaSystemException
- When an error occurred in the operation.public List<com.saperion.connector.renditions.Rendition> getRendition(Element element, com.saperion.connector.options.Options options) throws com.saperion.connector.renditions.exceptions.FormatNotSupportedException, com.saperion.connector.renditions.exceptions.PreconditionFailedException, TimeoutException, com.saperion.connector.renditions.exceptions.RenderingException, SaAuthenticationException, SaSystemException
SaClassicConnector
getRendition
in interface SaClassicConnector
element
- an Element
object that represents an object in the archived document.options
- an Options
object that defines the options required to generate the renditionRendition
instances.com.saperion.connector.renditions.exceptions.FormatNotSupportedException
- if the input or output format is not supportedcom.saperion.connector.renditions.exceptions.PreconditionFailedException
- if parts of the options are missingTimeoutException
- if a timeout was specified and it was reachedcom.saperion.connector.renditions.exceptions.RenderingException
- if engine is not available or internal initialization failuresSaAuthenticationException
- If not properly logged inSaSystemException
public void sendBarcode(String indexMask, String docUid, String contentRep, String sid, String docType, String value, int mandant) throws SaBarcodeException
SaClassicConnector
sendBarcode
in interface SaClassicConnector
indexMask
- Index mask namedocUid
- SAPERION Document UIDcontentRep
- SAP Content repositorysid
- SAP ID
It is possible to set this value to 0, then SAPERION will generate a SAP ID.docType
- Document typevalue
- barcode as stringmandant
- Mandant nameSaBarcodeException
- BarcodeExceptionpublic int getToken()
public com.saperion.connector.authentication.Session getSession() throws SaAuthenticationException
SaAuthenticationException
will be thrown;SaAuthenticationException
- if no successful login was donepublic List<SaRMIServerInfo> getServerInfos() throws SaAuthenticationException, SaSystemException
SaAuthenticationException
- user is not logged inSaSystemException
- system exceptionpublic int getLicenseCount(int type) throws SaSystemException
SaClassicConnector
getLicenseCount
in interface SaClassicConnector
type
- the license type see LicenseType
for valuesSaSystemException
- Error on the saperion systempublic boolean setUsedLicense(int type, int count) throws SaSystemException
SaClassicConnector
setUsedLicense
in interface SaClassicConnector
type
- Client typecount
- Number of licensesSaSystemException
- Error on the saperion systempublic boolean hasRenderEngine()
SaClassicConnector
hasRenderEngine
in interface SaClassicConnector
true
, otherwise false
public Set<com.saperion.connector.formats.SourceFormat> getSupportedRenderSourceFormats()
SaClassicConnector
getSupportedRenderSourceFormats
in interface SaClassicConnector
public Set<com.saperion.connector.formats.TargetFormat> getSupportedRenderTargetFormats()
SaClassicConnector
getSupportedRenderTargetFormats
in interface SaClassicConnector
public void setEventsEnabled(boolean enabled) throws SaSystemException, SaAuthenticationException
SaClassicConnector
setEventsEnabled
in interface SaClassicConnector
enabled
- true, to enable events, otherwise false.SaSystemException
- system errorSaAuthenticationException
- authentication errorpublic boolean getEventsEnabled() throws SaSystemException, SaAuthenticationException
SaClassicConnector
getEventsEnabled
in interface SaClassicConnector
SaSystemException
- on general system failuresSaAuthenticationException
- when the classic connector is not authenticated or the current user has not the required rights for
the operationpublic DDC getDDC(String ddcName) throws SaSystemException, SaAuthenticationException
SaClassicConnector
getDDC
in interface SaClassicConnector
ddcName
- name of the DDCDDC
.SaSystemException
- system error when retrieving information about the DDCSaAuthenticationException
- not logged inpublic SaRMIClientCommand getClientConnector()
public ServerSideClientConfiguration getServerSideClientConfiguration()
SaClassicConnector
getServerSideClientConfiguration
in interface SaClassicConnector
public Set<Map.Entry<String,String>> getFullTextFields(String ddcName, List<String> fullTextFields, String hdoc) throws SaSystemException
getFullTextFields
in interface SaClassicConnector
ddcName
- name of the DDCfullTextFields
- List of Fields which are of Text retrieval type.
Make sure to prefix SaConstants.FULL_TEXT_COLUMN_PREFIX
hdoc
- hdoc of the documentSaSystemException
Copyright © 2020 Hyland Software Germany GmbH. All rights reserved.