com.saperion.connector.rmi

Class AbstractDocRMIClientCommand

java.lang.Object

com.saperion.connector.rmi.AbstractRMIClientCommand

com.saperion.connector.rmi.AbstractFolderRMIClientCommand

com.saperion.connector.rmi.AbstractDocRMIClientCommand

All Implemented Interfaces:

SaRMIClientCommand

Direct Known Subclasses:

AbstractQueryRMIClientCommand

public abstract class AbstractDocRMIClientCommand
extends AbstractFolderRMIClientCommand

Class representing the methods used for manipulating documents.

Field Summary

Fields inherited from class com.saperion.connector.rmi.AbstractRMIClientCommand

APPEND_CONTENT, appl, credentials, LOGGER, props, session, sysConnector, writeBufferSize

Constructor Summary

Constructors

Constructor and Description
AbstractDocRMIClientCommand()

Method Summary

Modifier and Type	Method and Description
SaSaveInfo	cacheDocument(boolean isNew, int commitMode, String versionComment, String xhDoc, String dbName, String acls) Stores the actual document to the backend.
void	checkoutDocument(String hDoc) Checkout the given document.
SapDocInfo	checkSapUrl(String url) Checks the given SAP URL on the R/Link server and returns, if successfull, the HDOC and the DDC.
void	clearContent() Clears all content of the opened document.
void	closeDocument(com.saperion.jni.SaJNIDocHandle handle) Manually closing of a open document.
SaSaveInfo	createDocument(String dbName, List<SaPropertyValue> values) Creates a new document with the given parameters.
SaSaveInfo	createLink(LinkInfo link) Creates a SAPERION Link into one Archive for an existing Document.
SaSaveInfo	deleteDocument(int mode, String hDoc) Delete a document.
void	discardDocument() Discards the document identified by the tokens handle.
void	dsicardCheckout(String hDoc) Discards the checkout of the given document.
void	finishTransaction(boolean commit) Finish the transaction in the backend system.
String	getACLNames(String hDoc) Reads the ACL's for the given document.
SaACLRights	getACLRights(String[] acls) Reads the rights for the given acl's.
List<SaAcl>	getAcls() Reads all existing ACLs.
List<String>	getAllACLs() Deprecated.
String	getAnnotations(String hDoc, int indexOfContentElement, boolean currentRevision) Reads the annotations from the given document.
List<String>	getInvolvedUsers(String hDoc) Reads all users involved in the set of ACL's.
SaLockInfo	getLockInfo(String sysRowId) Gets the lock info for a given node.
List<String>	getLocks(String ddcName) Reads all locks from the given DDC.
List<String>	getLocks(String ddcName, String mandant) Reads all locks from the given DDC.
com.saperion.jni.SaJNIDocAccessData	getNodeAccessData(String hDoc) Opens the document identified by hdoc and returns an object containing all access right data information for the session user.
byte[]	getThumbnail(String hDoc, int widthX, int widthY, boolean color) Reads the thumbnail of the given document.
boolean	lockNode(String sysRowId, String ddcName, int lockType, boolean sessionScoped) Locks a node.
void	logClientEvent(String hdoc, SaConstants.ProtoEvents event, String remark) Adds an audit log event.
com.saperion.jni.SaJNIReadBuffer	readDocumentFirst(String hdoc, boolean currentRevision, int element) Opens an existing document with the given hdoc and returns a document handle for the specified element (= sub-document) as well as the buffer containing the content data of the element.
com.saperion.jni.SaJNIReadBuffer	readDocumentNext(com.saperion.jni.SaJNIDocHandle handle) Reads the next bytes from the open document, described in the handle.
SaVersionData	readVersionMetadata(String versionID) Reads the version meta data of the document with the given ID.
SaVersionData	readVersionMetadata(String versionID, boolean resolveLinks) Reads the version meta data of the document with the given ID.
void	releaseDocument(String hDoc, String comment) Release the given document.
void	removeElement(int element) Removes a existing content element.
void	removeElement(Integer[] elements) Removes a series of existing content elements.
SaSaveInfo	restoreVersion(String versionID) Restores the given version to the actual version.
SaSaveInfo	saveDocument(String hexUID, String dbName, List<SaPropertyValue> metadata) Saves the document paramaters to the document.
SaSaveInfo	saveDocument(String hexUID, String dbName, List<SaPropertyValue> metadata, boolean resolveLinks) Saves the document paramaters to the document.
SaSaveInfo	setACLName(String ddcname, String hDoc, String acl, int commitMode, String versionComment) Sets the given ACL to the node.
void	setAnnotations(String hDoc, int indexOfContentElement, String annotations) Sets the given annotations to the document.
void	setElementMark(int element) Mark the content element.
void	setVariables(int element, Map<String,String> variables) Method to set the Variables for an Content-Object or the Structure itself.
void	startTransaction() Starts a transaction in the backend system.
SaSaveInfo	storeDocument(boolean isNew, int commitMode, String versionComment, String dbName, String acls) Stores the actual document to the backend.
SaSaveInfo	storeDocument(boolean isNew, int commitMode, String versionComment, String dbName, String acls, boolean checkout) Stores the actual document to the backend.
boolean	unlockNode(String sysRowId, String ddcName) Unlocks a node.
long	writeContent(ContentStream content) Writes the content of the document.
long	writeContent(InputStream stream) Writes the content of the document.
long	writeContent(InputStream stream, String fileName, int element)
long	writeContent(InputStream stream, String fileName, int element, boolean doStreaming) Writes the content of the document. If the document size is less than SaConstants.JNI_BUFFER_SIZE than the default buffer size will be reduced and only one JNI call is initiated.

Methods inherited from class com.saperion.connector.rmi.AbstractFolderRMIClientCommand

addToFolder, copyFolder, createFolder, deleteFolder, getDocumentFolderCount, getDocumentFolders, getFolderChildren, getFolderClass, getFolderFromPath, getFolderInfo, getFolderParent, getFolderRights, getFolderUpdateInfo, moveFolder, moveToFolder, removeFromFolder, searchFolderClass, searchFolderDocuments, setFolderAcl, updateFolder

Methods inherited from class com.saperion.connector.rmi.AbstractRMIClientCommand

getRemoteCommand, init, reLogon, reLogonAfterConnectionFailure

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.saperion.connector.rmi.SaRMIClientCommand

addComment, addHistory, changePassword, createLookupEntry, deleteLookupEntry, deleteSetting, executeCommand, finishSQLTransaction, getArchivedSize, getAuthorizedUsers, getBoxCount, getBoxDefinitions, getCommandInfos, getCommandInfos, getCommentInfos, getCommitMode, getCompleteHistoryInfos, getDDC, getDeleteMode, getEventsEnabled, getFeatures, getFieldDescriptions, getFieldDescriptions, getFulltext, getFullTextFields, getHDocForSysRowId, getHistoryInfos, getIdsFromQuery, getLicenseCount, getMandant, getMember, getMembers, getOutOfOffice, getParentTask, getRealDBName, getRMIVersion, getServerInfos, getSession, getSetting, getStringQueryResult, getSubstitute, getSystemConnector, getSystemFiles, getSystemInfo, getSystemSetting, getTask, getTaskAuditList, getTaskList, getToken, getUserIdsForQuery, getUsers, getUserSetting, getVersionList, getWorkflowDefinitions, invoke, isAlive, isRevisionEnabled, loadDDCNames, loadFolderDDCNames, loadSettings, loadSystemFile, loadWorkflowDDCName, logoff, logon, readDocumentMetadata, resolveLatestHdoc, searchSettings, sendBarcode, setEventsEnabled, setLocale, setOutOfOffice, setSetting, setSubstitute, setUsedLicense, setUserSetting, startSQLTransaction, storeBpmn, storeSystemFile, updateLookupEntry

Constructor Detail

AbstractDocRMIClientCommand

public AbstractDocRMIClientCommand()

Method Detail

discardDocument

public void discardDocument()
                     throws SaSystemException

Description copied from interface: SaRMIClientCommand

Discards the document identified by the tokens handle. Cleans up temporary document resources and handles.

Throws:

SaSystemException

setVariables

public void setVariables(int element,
                         Map<String,String> variables)
                  throws SaAuthenticationException,
                         SaSystemException

Description copied from interface: SaRMIClientCommand

Method to set the Variables for an Content-Object or the Structure itself.

Parameters:

element - Element Number where the Variables should be set to. (0 = Structure)

variables - Map of Key-Value Pairs for setting Variables

Throws:

SaAuthenticationException - error on the authentification / insufficient rights

SaSystemException - general error

writeContent

public final long writeContent(InputStream stream,
                               String fileName,
                               int element)
                        throws SaSystemException,
                               SaAuthenticationException,
                               SaConnectException

Throws:

SaSystemException

SaAuthenticationException

SaConnectException

See Also:

SaRMIClientCommand.writeContent(java.io.InputStream, String, int)

writeContent

public final long writeContent(InputStream stream,
                               String fileName,
                               int element,
                               boolean doStreaming)
                        throws SaSystemException,
                               SaAuthenticationException,
                               SaConnectException

Writes the content of the document.
If the document size is less than SaConstants.JNI_BUFFER_SIZE than the default buffer size will be reduced and only one JNI call is initiated. Because of the C# web services only chunks byte arrays with the size of 8192 a special handling is required.

Parameters:

stream - content stream

fileName - the file name

element -

element = -2 : Deletes existing content, leaving an empty document structure

element = -1 : Deletes existing content, adding given content as first element

element = 0 : Given content is appended to the last existing content element in the document structure

element > 0 : Replace the numbered content element with the given content. The overall number of content elements remains the same.

doStreaming - set to true, if streaming option for the inputstream content should be activated.

Returns:

Actual element count

Throws:

SaSystemException - SaSystemException

SaAuthenticationException - SaAuthenticationException

SaConnectException - SaConnectException

See Also:

SaRMIClientCommand.writeContent(java.io.InputStream, String, int, boolean)

writeContent

public long writeContent(InputStream stream)
                  throws SaSystemException,
                         SaAuthenticationException,
                         SaConnectException

Description copied from interface: SaRMIClientCommand

Writes the content of the document.

Parameters:

stream - content stream

Returns:

Actual element count

Throws:

SaSystemException - SaSystemException

SaAuthenticationException - SaAuthenticationException

SaConnectException - SaConnectException

writeContent

public long writeContent(ContentStream content)
                  throws SaSystemException,
                         SaAuthenticationException,
                         SaConnectException,
                         StreamVerificationException

Writes the content of the document.

Parameters:

content - content stream

Returns:

Actual element count

Throws:

SaSystemException - SaSystemException

SaAuthenticationException - SaAuthenticationException

SaConnectException - SaConnectException

StreamVerificationException - if the content stream validation is enabled and the validation failed.

See Also:

SaRMIClientCommand.writeContent(com.saperion.bean.ContentStream)

closeDocument

public final void closeDocument(com.saperion.jni.SaJNIDocHandle handle)
                         throws SaSystemException,
                                SaAuthenticationException,
                                SaGetNodeException

Manually closing of a open document.

Parameters:

handle - Document handle for a document, opend by readDocumentFirst

Throws:

SaSystemException - SaRMICommandException

SaAuthenticationException - SaAuthenticationException

SaGetNodeException - SaGetNodeException

deleteDocument

public SaSaveInfo deleteDocument(int mode,
                                 String hDoc)
                          throws SaSystemException,
                                 SaAuthenticationException,
                                 SaGetNodeException,
                                 SaDDCException

Delete a document.

Parameters:

mode - Delete mode may be set to the following values:

SaConstant.JNI_DELETECONTENT_MODE_DBSIMPLE = 0 Set status to 65002

SaConstant.JNI_DELETECONTENT_MODE_DBCOMPLETE = 1 - remove from DB

SaConstant.JNI_DELETECONTENT_MODE_PURGEDOCUMENT = 2 -Final delete

SaConstant.DELETEMODE = "deletemode" -Deletemode entry in archief.ini;

hDoc - Document HDOC

Returns:

SaSaveInfo or null

Throws:

SaSystemException - Error on the saperion system

SaAuthenticationException - SaAuthenticationException

SaGetNodeException - SaGetNodeException

SaDDCException - SaDDCException

See Also:

SaRMIClientCommand.deleteDocument(int, String)

readDocumentFirst

public com.saperion.jni.SaJNIReadBuffer readDocumentFirst(String hdoc,
                                                          boolean currentRevision,
                                                          int element)
                                                   throws SaSystemException,
                                                          SaAuthenticationException,
                                                          SaGetNodeException

Opens an existing document with the given hdoc and returns a document handle for the specified element (= sub-document) as well as the buffer containing the content data of the element. If this was the last block, the document is automatically closed.

Parameters:

hdoc - Document HDOC

currentRevision - flag indicating that the current revision of the document should be retrieved by resolving hdoc

element - Element number, starting with 1

Returns:

The document handle and the buffer with the content

Throws:

SaSystemException - SaRMICommandException

SaAuthenticationException - SaAuthenticationException

SaGetNodeException - SaGetNodeException

See Also:

SaRMIClientCommand.readDocumentFirst(String, boolean, int)

readDocumentNext

public com.saperion.jni.SaJNIReadBuffer readDocumentNext(com.saperion.jni.SaJNIDocHandle handle)
                                                  throws SaSystemException,
                                                         SaAuthenticationException,
                                                         SaSetNodeException,
                                                         SaGetNodeException,
                                                         SaConnectException

Reads the next bytes from the open document, described in the handle. If this was the last block, the document is automatically closed.

Parameters:

handle - Document handle for a document, opend by readDocumentFirst

Returns:

The document handle and the buffer with the content

Throws:

SaSystemException - SaRMICommandException

SaAuthenticationException - SaAuthenticationException

SaSetNodeException - SaSetNodeException

SaGetNodeException - SaGetNodeException

SaConnectException - SaConnectException

See Also:

SaRMIClientCommand.readDocumentNext(com.saperion.jni.SaJNIDocHandle)

getThumbnail

public byte[] getThumbnail(String hDoc,
                           int widthX,
                           int widthY,
                           boolean color)
                    throws SaSystemException,
                           SaAuthenticationException

Reads the thumbnail of the given document.

Parameters:

hDoc - HDoc for the document.

widthX - Width X

widthY - Width Y

color - True for colored

Returns:

Thumbnail BMP as byte array

Throws:

SaSystemException - System exception

SaAuthenticationException - SaAuthenticationException

See Also:

SaRMIClientCommand.getThumbnail(java.lang.String, int, int, boolean)

readVersionMetadata

public SaVersionData readVersionMetadata(String versionID)
                                  throws SaSystemException,
                                         SaAuthenticationException,
                                         SaDDCException,
                                         SaGetNodeException

Reads the version meta data of the document with the given ID.

Parameters:

versionID - Version HDOC

Returns:

Document revision data

Throws:

SaSystemException - SaRMICommandException

SaAuthenticationException - SaAuthenticationException

SaDDCException - SaDDCException

SaGetNodeException - SaGetNodeException

See Also:

SaRMIClientCommand.readVersionMetadata(String)

createDocument

public SaSaveInfo createDocument(String dbName,
                                 List<SaPropertyValue> values)
                          throws SaSystemException,
                                 SaAuthenticationException,
                                 SaDDCException,
                                 SaGetNodeException

Creates a new document with the given parameters.

Parameters:

dbName - Node database table name

values - List of all values

Returns:

Node information object

Throws:

SaSystemException - Error on the saperion system

SaAuthenticationException - Error on the saperion system

SaDDCException - Error on the saperion system

SaGetNodeException - SaGetNodeException

See Also:

SaRMIClientCommand.createDocument(String, java.util.List)

readVersionMetadata

public SaVersionData readVersionMetadata(String versionID,
                                         boolean resolveLinks)
                                  throws SaSystemException,
                                         SaAuthenticationException,
                                         SaDDCException,
                                         SaGetNodeException

Description copied from interface: SaRMIClientCommand

Reads the version meta data of the document with the given ID.

Parameters:

versionID - Version HDOC

resolveLinks - If false will not resolve the link and show the metadata associated with the link itself.

Returns:

Document revision data

Throws:

SaSystemException - SaRMICommandException

SaAuthenticationException - SaAuthenticationException

SaDDCException - SaDDCException

SaGetNodeException - SaGetNodeException

cacheDocument

public SaSaveInfo cacheDocument(boolean isNew,
                                int commitMode,
                                String versionComment,
                                String xhDoc,
                                String dbName,
                                String acls)
                         throws SaSystemException,
                                SaAuthenticationException,
                                SaGetNodeException,
                                SaSetNodeException,
                                SaDDCException

Stores the actual document to the backend.

Parameters:

isNew - Is a new document

commitMode - Commit mode

versionComment - Version comment string

xhDoc - the xh doc

dbName - DDC name

acls - ACL name string

Returns:

Node information object

Throws:

SaSystemException - the system error exception

SaAuthenticationException - the authentication error exception

SaGetNodeException - the get node error exception

SaSetNodeException - the set node error exception

SaDDCException - the ddc error exception

See Also:

SaRMIClientCommand.storeDocument(boolean, int, java.lang.String, java.lang.String, java.lang.String, boolean)

createLink

public SaSaveInfo createLink(LinkInfo link)
                      throws SaSystemException,
                             SaAuthenticationException,
                             SaDDCException,
                             SaGetNodeException

Description copied from interface: SaRMIClientCommand

Creates a SAPERION Link into one Archive for an existing Document.

Parameters:

link - Link for the existing Document

Returns:

Save Info after the Link was created

Throws:

SaSystemException - SaRMICommandException

SaAuthenticationException - SaAuthenticationException

SaDDCException - SaDDCException

SaGetNodeException - SaGetNodeException

saveDocument

public SaSaveInfo saveDocument(String hexUID,
                               String dbName,
                               List<SaPropertyValue> metadata)
                        throws SaSystemException,
                               SaAuthenticationException,
                               SaGetNodeException,
                               SaDDCException

Saves the document paramaters to the document.

Parameters:

hexUID - Node HDOC

dbName - Database table name

metadata - List of all values

Returns:

written node informations

Throws:

SaSystemException - SaRMICommandException

SaAuthenticationException - SaAuthenticationException

SaGetNodeException - SaGetNodeException

SaDDCException - SaDDCException

See Also:

SaRMIClientCommand.saveDocument(String, String, java.util.List)

saveDocument

public SaSaveInfo saveDocument(String hexUID,
                               String dbName,
                               List<SaPropertyValue> metadata,
                               boolean resolveLinks)
                        throws SaSystemException,
                               SaAuthenticationException,
                               SaGetNodeException,
                               SaDDCException

Saves the document paramaters to the document.

Parameters:

hexUID - Node HDOC

dbName - Database table name

metadata - List of all values

resolveLinks - Resolve links

Returns:

written node informations

Throws:

SaSystemException - SaRMICommandException

SaAuthenticationException - SaAuthenticationException

SaGetNodeException - SaGetNodeException

SaDDCException - SaDDCException

See Also:

SaRMIClientCommand.saveDocument(String, String, java.util.List, boolean)

storeDocument

public SaSaveInfo storeDocument(boolean isNew,
                                int commitMode,
                                String versionComment,
                                String dbName,
                                String acls)
                         throws SaSystemException,
                                SaAuthenticationException,
                                SaGetNodeException,
                                SaSetNodeException,
                                SaDDCException

Stores the actual document to the backend.

Parameters:

isNew - Is a new document

commitMode - Commit mode

versionComment - Version comment string

dbName - DDC name

acls - ACL name string

Returns:

Node information object

Throws:

SaSystemException - SaRMICommandException

SaAuthenticationException - SaAuthenticationException

SaGetNodeException - SaGetNodeException

SaSetNodeException - SaSetNodeException

SaDDCException - SaDDCException

See Also:

SaRMIClientCommand.storeDocument(boolean, int, String, String, String)

storeDocument

public SaSaveInfo storeDocument(boolean isNew,
                                int commitMode,
                                String versionComment,
                                String dbName,
                                String acls,
                                boolean checkout)
                         throws SaSystemException,
                                SaAuthenticationException,
                                SaGetNodeException,
                                SaSetNodeException,
                                SaDDCException

Stores the actual document to the backend.

Parameters:

isNew - Is a new document

commitMode - Commit mode

versionComment - Version comment string

dbName - DDC name

acls - ACL name string (semicolon separated)

checkout - Checkin document

Returns:

Node information object

Throws:

SaSystemException - SaRMICommandException

SaAuthenticationException - SaAuthenticationException

SaGetNodeException - SaGetNodeException

SaSetNodeException - SaSetNodeException

SaDDCException - SaDDCException

See Also:

SaRMIClientCommand.storeDocument(boolean, int, java.lang.String, java.lang.String, java.lang.String, boolean)

checkoutDocument

public void checkoutDocument(String hDoc)
                      throws SaSystemException,
                             SaAuthenticationException,
                             SaGetNodeException

Checkout the given document.

Parameters:

hDoc - Document HDOC

Throws:

SaSystemException - SaRMICommandException

SaAuthenticationException - SaAuthenticationException

SaGetNodeException - SaGetNodeException

See Also:

SaRMIClientCommand.checkoutDocument(java.lang.String)

dsicardCheckout

public void dsicardCheckout(String hDoc)
                     throws SaSystemException,
                            SaAuthenticationException,
                            SaGetNodeException

Discards the checkout of the given document.

Parameters:

hDoc - Document HDOC

Throws:

SaSystemException - SaRMICommandException

SaAuthenticationException - SaAuthenticationException

SaGetNodeException - SaGetNodeException

See Also:

SaRMIClientCommand.dsicardCheckout(java.lang.String)

releaseDocument

public void releaseDocument(String hDoc,
                            String comment)
                     throws SaSystemException,
                            SaAuthenticationException,
                            SaGetNodeException

Release the given document.

Parameters:

hDoc - Document HDOC

comment - the revision comment

Throws:

SaSystemException - SaRMICommandException

SaAuthenticationException - SaAuthenticationException

SaGetNodeException - SaGetNodeException

See Also:

SaRMIClientCommand.releaseDocument(java.lang.String, java.lang.String)

restoreVersion

public SaSaveInfo restoreVersion(String versionID)
                          throws SaSystemException,
                                 SaAuthenticationException,
                                 SaDDCException,
                                 SaGetNodeException

Restores the given version to the actual version.

Parameters:

versionID - Version HDOC

Returns:

Document save info

Throws:

SaSystemException - SaRMICommandException

SaAuthenticationException - SaAuthenticationException

SaDDCException - SaDDCException

SaGetNodeException - SaGetNodeException

See Also:

SaRMIClientCommand.restoreVersion(String)

clearContent

public void clearContent()
                  throws SaSystemException,
                         SaAuthenticationException,
                         SaGetNodeException,
                         SaSetContentException,
                         SaConnectException

Clears all content of the opened document.

Throws:

SaSystemException - Error on the saperion system

SaAuthenticationException - SaAuthenticationException

SaGetNodeException - SaGetNodeException

SaSetContentException - SaSetContentException

SaConnectException - SaConnectException

See Also:

SaRMIClientCommand.clearContent()

setElementMark

public void setElementMark(int element)
                    throws SaSystemException,
                           SaAuthenticationException,
                           SaConnectException

Mark the content element.

Parameters:

element - Element number to mark

Throws:

SaSystemException - Error on the saperion system

SaAuthenticationException - SaAuthenticationException

SaConnectException - SaConnectException

See Also:

SaRMIClientCommand.setElementMark(int)

removeElement

public void removeElement(int element)
                   throws SaSystemException,
                          SaAuthenticationException,
                          SaGetNodeException,
                          SaSetContentException,
                          SaConnectException

Removes a existing content element.

Parameters:

element - Element number

Throws:

SaSystemException - Error on the saperion system

SaAuthenticationException - SaAuthenticationException

SaGetNodeException - SaGetNodeException

SaSetContentException - SaSetContentException

SaConnectException - SaConnectException

See Also:

SaRMIClientCommand.removeElement(int)

removeElement

public void removeElement(Integer[] elements)
                   throws SaSystemException,
                          SaAuthenticationException,
                          SaGetNodeException,
                          SaSetContentException,
                          SaConnectException

Removes a series of existing content elements.

Parameters:

elements - Array of element number

Throws:

SaSystemException - Error on the saperion system

SaAuthenticationException - SaAuthenticationException

SaGetNodeException - SaGetNodeException

SaSetContentException - SaSetContentException

SaConnectException - SaConnectException

See Also:

SaRMIClientCommand.removeElement(int)

getLockInfo

public SaLockInfo getLockInfo(String sysRowId)
                       throws SaSystemException,
                              SaAuthenticationException,
                              SaLockException,
                              SaGetNodeException

Gets the lock info for a given node.

Parameters:

sysRowId - SysRowId

Returns:

Lockinfo

Throws:

SaSystemException - Error on the saperion system

SaAuthenticationException - Error on the saperion system

SaLockException - Error on the saperion system

SaGetNodeException - SaGetNodeException

See Also:

SaRMIClientCommand.getLockInfo(String)

lockNode

public boolean lockNode(String sysRowId,
                        String ddcName,
                        int lockType,
                        boolean sessionScoped)
                 throws SaSystemException,
                        SaAuthenticationException,
                        SaLockException,
                        SaGetNodeException,
                        SaPropertyException

Locks a node.

Parameters:

sysRowId - SysRowId

ddcName - DDC name

lockType - locking mode can be one of the following constants:

SaConstant.LOCKING_LOCKTYPE_DEFAULT = 0;

SaConstant.LOCKING_LOCKTYPE_JSRLOCK = 1;

SaConstant.LOCKING_LOCKTYPE_JSRCHECKOUT = 2;

sessionScoped - True, if session scoped

Returns:

True, if ok

Throws:

SaSystemException - Error on the saperion system

SaAuthenticationException - Error on the saperion system

SaLockException - Error on the saperion system

SaGetNodeException - SaGetNodeException

SaPropertyException - SaPropertyException

See Also:

SaRMIClientCommand.lockNode(String, String, int, boolean)

unlockNode

public boolean unlockNode(String sysRowId,
                          String ddcName)
                   throws SaSystemException,
                          SaAuthenticationException,
                          SaLockException,
                          SaGetNodeException

Unlocks a node.

Parameters:

sysRowId - SysRowId

ddcName - DDC name

Returns:

True, if ok

Throws:

SaSystemException - SaRMICommandException

SaAuthenticationException - SaAuthenticationException

SaLockException - SaLockException

SaGetNodeException - SaGetNodeException

See Also:

SaRMIClientCommand.unlockNode(String, String)

getNodeAccessData

public com.saperion.jni.SaJNIDocAccessData getNodeAccessData(String hDoc)
                                                      throws SaSystemException,
                                                             SaAuthenticationException,
                                                             SaGetNodeException

Opens the document identified by hdoc and returns an object containing all access right data information for the session user.

Parameters:

hDoc - Document HDOC

Returns:

SaJNIDocAccessData Document access data for session user

Throws:

SaSystemException - Error on the saperion system

SaAuthenticationException - Error on the saperion system

SaGetNodeException - SaGetNodeException

See Also:

SaRMIClientCommand.getNodeAccessData(java.lang.String)

finishTransaction

public void finishTransaction(boolean commit)
                       throws SaSystemException

Finish the transaction in the backend system.

Parameters:

commit - True, if commit this transaction, false to rollback

Throws:

SaSystemException - Error on the saperion system

See Also:

SaRMIClientCommand.finishTransaction(boolean)

startTransaction

public void startTransaction()
                      throws SaSystemException

Starts a transaction in the backend system.

Throws:

SaSystemException - SaRMICommandException

See Also:

SaRMIClientCommand.startTransaction()

getAnnotations

public final String getAnnotations(String hDoc,
                                   int indexOfContentElement,
                                   boolean currentRevision)
                            throws SaAuthenticationException,
                                   SaSystemException

Reads the annotations from the given document.

Parameters:

hDoc - Document HDOC

indexOfContentElement - the index of the chosen context element

currentRevision - true to get current revision

Returns:

Annotation string

Throws:

SaAuthenticationException - Authentication error

SaSystemException - Remote exception

setAnnotations

public final void setAnnotations(String hDoc,
                                 int indexOfContentElement,
                                 String annotations)
                          throws SaAuthenticationException,
                                 SaSystemException

Sets the given annotations to the document. This method creates a new revision.

Parameters:

hDoc - Document HDOC

indexOfContentElement - the index of the chosen context element

annotations - Annotation string

Throws:

SaAuthenticationException - Authentication error

SaSystemException - Remote exception

getLocks

public final List<String> getLocks(String ddcName)
                            throws SaSystemException

Reads all locks from the given DDC.

Parameters:

ddcName - DDC name

Returns:

Locks as list

Throws:

SaSystemException - Remote exception

getLocks

public List<String> getLocks(String ddcName,
                             String mandant)
                      throws SaSystemException

Reads all locks from the given DDC.

Parameters:

ddcName - DDC name

mandant - internal saperion name of the current mandant

Returns:

Locks as list

Throws:

SaSystemException - Remote exception

See Also:

SaRMIClientCommand.getLocks(java.lang.String, java.lang.String)

getACLNames

public String getACLNames(String hDoc)
                   throws SaSystemException,
                          SaAuthenticationException,
                          SaDDCException,
                          SaGetNodeException

Reads the ACL's for the given document.

Parameters:

hDoc - Document HDOC

Returns:

ACL name string

Throws:

SaSystemException - SaRMICommandException

SaAuthenticationException - SaAuthenticationException

SaDDCException - SaDDCException

SaGetNodeException - SaGetNodeException

See Also:

SaRMIClientCommand.getACLNames(String)

getInvolvedUsers

public List<String> getInvolvedUsers(String hDoc)
                              throws SaSystemException,
                                     SaAuthenticationException,
                                     SaDDCException,
                                     SaGetNodeException

Reads all users involved in the set of ACL's.

Parameters:

hDoc - Document HDOC

Returns:

List of user names

Throws:

SaSystemException - SaRMICommandException

SaAuthenticationException - SaAuthenticationException

SaDDCException - SaDDCException

SaGetNodeException - SaGetNodeException

See Also:

SaRMIClientCommand.getInvolvedUsers(String)

setACLName

public SaSaveInfo setACLName(String ddcname,
                             String hDoc,
                             String acl,
                             int commitMode,
                             String versionComment)
                      throws SaSystemException,
                             SaAuthenticationException,
                             SaDDCException,
                             SaGetNodeException,
                             SaSetNodeException,
                             SaSetACLException

Sets the given ACL to the node.

Parameters:

ddcname - implemented ddc in saperion

hDoc - Document HDOC

acl - ACL name string

commitMode - Commit mode

versionComment - Version comment string

Returns:

save info object

Throws:

SaSystemException - SaRMICommandException

SaAuthenticationException - SaAuthenticationException

SaDDCException - SaDDCException

SaGetNodeException - SaGetNodeException

SaSetNodeException - SaSetNodeException

SaSetACLException - SaSetACLException

See Also:

SaRMIClientCommand.setACLName(String, String, String, int, String)

getAcls

public List<SaAcl> getAcls()
                    throws SaSystemException,
                           SaAuthenticationException

Reads all existing ACLs.

Returns:

List of ACLs

Throws:

SaSystemException - SaRMICommandException

SaAuthenticationException - SaAuthenticationException

See Also:

SaRMIClientCommand.getAcls()

getACLRights

public SaACLRights getACLRights(String[] acls)
                         throws SaSystemException,
                                SaAuthenticationException

Reads the rights for the given acl's.

Parameters:

acls - ACL's

Returns:

Rights

Throws:

SaSystemException - System exception

SaAuthenticationException - Authentication exception

See Also:

SaRMIClientCommand.getACLRights(java.lang.String[])

getAllACLs

@Deprecated
public List<String> getAllACLs()
                                     throws SaSystemException,
                                            SaAuthenticationException

Deprecated.

Reads all existing ACL names.

Returns:

List of ACL names

Throws:

SaSystemException - SaRMICommandException

SaAuthenticationException - SaAuthenticationException

logClientEvent

public void logClientEvent(String hdoc,
                           SaConstants.ProtoEvents event,
                           String remark)
                    throws SaSystemException,
                           SaAuthenticationException

Adds an audit log event.

Parameters:

hdoc - Document HDOC

event - Event type

remark - Remark

Throws:

SaSystemException - general error

SaAuthenticationException - error on the authentification / insufficient rights

See Also:

SaRMIClientCommand.logClientEvent(java.lang.String, com.saperion.constants.SaConstants.ProtoEvents, java.lang.String)

checkSapUrl

public SapDocInfo checkSapUrl(String url)
                       throws SaSystemException,
                              SaSapUrlException,
                              SaAuthenticationException

Checks the given SAP URL on the R/Link server and returns, if successfull, the HDOC and the DDC. If not, null will be returned.

Parameters:

url - SAP URL

Returns:

Document Info

Throws:

SaSystemException - when a system error occured

SaSapUrlException - when checking the sap url failed in the RLINK server

SaAuthenticationException - when the user is not logged in or has insufficient rights

See Also:

SaRMIClientCommand.checkSapUrl(java.lang.String)