Package com.uc4.communication.requests
Class GetObjectProperties
- java.lang.Object
-
- com.uc4.communication.requests.XMLRequest
-
- com.uc4.communication.requests.GetObjectProperties
-
public class GetObjectProperties extends XMLRequest
Returns information about an UC4 object. This request can also be used to test if an object exists. If the object does not exist in the currently connected client, client 0 will also be checked, when UC_SYSTEM_SETTINGS - OBJECT_ACCESS_CLIENT_ZERO is set to Y.
-
-
Constructor Summary
Constructors Constructor Description GetObjectProperties(int ohIdnr)
Creates a new Request to get information about an UC4 object.GetObjectProperties(UC4ObjectName name)
Creates a new Request to get information about an UC4 object.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description protected void
createRequest(com.uc4.util.XMLDocument doc, org.w3c.dom.Element request, ConnectionAttributes sessionInfo)
Creates the XML Document for the request.java.lang.String
getApplicationName()
Returns the name of the Application.java.lang.String
getArchiveKey1()
Returns the value of the first archive key.java.lang.String
getArchiveKey2()
Returns the value of the second archive key.java.lang.String
getComponentName()
Returns the name of the component.UC4UserName
getCreatedByUser()
Returns the name of the user who created the object.DateTime
getCreatedDate()
Returns the date and time when the object was created.int
getEstimatedRuntime()
Returns the estimated runtime in seconds.java.lang.String
getHomeFolder()
Returns the path to the folder where the Objects exists ornull
if the object does not exist or this request has not been sent.int
getHomeFolderId()
Returns the OH_IDNR of the objects home folder.java.lang.String
getID()
Get the internal object oh_idnrUC4UserName
getLastModifiedByUser()
Returns the name of the user that has done the last modification in the object.DateTime
getLastModifiedDate()
Returns the time stamp when the object was last modified.UC4UserName
getLastUsedByUser()
Returns the name of the user that has used the object at least.DateTime
getLastUsedDate()
Returns the time stamp when the object was last used.int
getModificationCount()
Returns the number of modifications on this object.UC4ObjectName
getName()
Returns the name of the Object.ObjectAuthorizations
getObjectAuthorizations()
Returns theObjectAuthorizations
for the UC4 Object.java.lang.String
getObjectType()
Returns the type of the UC4 Object or an empty String if the object does not exist.UC4UserName
getOpenByUser()
If the object is currently edited by a user this method will return the name of the User.DateTime
getOpenSince()
Returns aDateTime
instance that contains the time when the User started editing the object.java.lang.String
getPlatform()
Returns the platform of the object.protected java.lang.String
getSrc()
Returns the request source.java.lang.String
getSubType()
Returns the sub-type of the object.java.lang.String
getTitle()
Returns the title of the UC4 Object.int
getUsageCount()
Returns the number of usages on this object.java.lang.String
getWorkflowName()
Returns the name of the Workflow.protected void
handleContent(com.uc4.util.XMLDocument doc, ConnectionAttributes session)
Sub classes extract the values from the XML document and provide public getter methods.protected boolean
isAllowedInClientZero()
This method is used internally.boolean
isApplicationWorkflow()
Returnstrue
if the type of this deployment ProcessFlow is application workflow.boolean
isComponentWorkflow()
Returnstrue
if this workflow is a component workflow.boolean
isNormalWorkflow()
Returnstrue
if this is a normal workflow which is has not been enabled for deployment.-
Methods inherited from class com.uc4.communication.requests.XMLRequest
assertClientZero, assertServerVersion, checkClient, checkID, checkLnr, checkNull, checkSelStatisticsPrivilege, checkSystemOverviewPrivilege, checkUC4ObjectEmptyName, checkUC4ObjectName, createNATFor, createNATRequest, emptyAttributes, getAllMessageBoxes, getMessageBox, getRequestID, handleResponse, ignoreMessageBox, send, setMessageBox, showQuarantineNotification
-
-
-
-
Constructor Detail
-
GetObjectProperties
public GetObjectProperties(UC4ObjectName name)
Creates a new Request to get information about an UC4 object.- Parameters:
name
- Name of the UC4 Object
-
GetObjectProperties
public GetObjectProperties(int ohIdnr)
Creates a new Request to get information about an UC4 object.- Parameters:
ohIdnr
- OH_Idnr
-
-
Method Detail
-
getID
public java.lang.String getID()
Get the internal object oh_idnr- Returns:
- The object oh_idnr
-
createRequest
protected void createRequest(com.uc4.util.XMLDocument doc, org.w3c.dom.Element request, ConnectionAttributes sessionInfo)
Description copied from class:XMLRequest
Creates the XML Document for the request. This method is used internally.- Specified by:
createRequest
in classXMLRequest
- Parameters:
doc
- Document, used to create new Elementsrequest
- Request Element - classes append information to this request elementsessionInfo
- Information about the session
-
getSrc
protected java.lang.String getSrc()
Description copied from class:XMLRequest
Returns the request source. This method is used internally.- Specified by:
getSrc
in classXMLRequest
- Returns:
- Source
-
handleContent
protected void handleContent(com.uc4.util.XMLDocument doc, ConnectionAttributes session)
Description copied from class:XMLRequest
Sub classes extract the values from the XML document and provide public getter methods.- Overrides:
handleContent
in classXMLRequest
- Parameters:
doc
- XML Documentsession
- Info about the user session
-
getHomeFolder
public java.lang.String getHomeFolder()
Returns the path to the folder where the Objects exists ornull
if the object does not exist or this request has not been sent.- Returns:
- Folder
-
isComponentWorkflow
public boolean isComponentWorkflow()
Returnstrue
if this workflow is a component workflow.- Returns:
- Component Workflow?
-
getApplicationName
public java.lang.String getApplicationName()
Returns the name of the Application.- Returns:
- Application or
null
if this is not deployment ProcessFlow
-
getWorkflowName
public java.lang.String getWorkflowName()
Returns the name of the Workflow.- Returns:
- Workflow or
null
if this is not deployment ProcessFlow
-
isApplicationWorkflow
public boolean isApplicationWorkflow()
Returnstrue
if the type of this deployment ProcessFlow is application workflow. If this is a component workflow the return value isfalse
- Returns:
- Application Workflow?
-
getComponentName
public java.lang.String getComponentName()
Returns the name of the component.- Returns:
- Component name or
null
if this is not a component workflow
-
isNormalWorkflow
public boolean isNormalWorkflow()
Returnstrue
if this is a normal workflow which is has not been enabled for deployment. If the return value isfalse
the workflow is either an application workflow or a component workflow.- Returns:
- Normal Workflow?
-
getHomeFolderId
public int getHomeFolderId()
Returns the OH_IDNR of the objects home folder.- Returns:
- ID of the home folder
-
getEstimatedRuntime
public int getEstimatedRuntime()
Returns the estimated runtime in seconds. The estimated runtime (ERT) is the expected time for the next execution of a task. The ERT itself is calculated from the real runtime (RRT) of the last 25 properly executed task runs. It is the central value for dynamic runtime monitoring calculations, for making forecasts, and for calculating the most recent ending of a task.- Returns:
- Estimated runtime in seconds
-
getTitle
public java.lang.String getTitle()
Returns the title of the UC4 Object.- Returns:
- Title
-
getCreatedByUser
public UC4UserName getCreatedByUser()
Returns the name of the user who created the object.- Returns:
- Name of the creator
-
getName
public UC4ObjectName getName()
Returns the name of the Object.- Returns:
- Name
-
getLastModifiedByUser
public UC4UserName getLastModifiedByUser()
Returns the name of the user that has done the last modification in the object.- Returns:
- User that modified the object
-
getCreatedDate
public DateTime getCreatedDate()
Returns the date and time when the object was created.- Returns:
- Date and Time of object creation
-
getLastModifiedDate
public DateTime getLastModifiedDate()
Returns the time stamp when the object was last modified.- Returns:
- Date time of the last modification
-
getModificationCount
public int getModificationCount()
Returns the number of modifications on this object.- Returns:
- Number of modifications
-
getLastUsedByUser
public UC4UserName getLastUsedByUser()
Returns the name of the user that has used the object at least. (value only available for executable objects)- Returns:
- User that used the object
-
getLastUsedDate
public DateTime getLastUsedDate()
Returns the time stamp when the object was last used. (value only available for executable objects)- Returns:
- Date time of the last usage
-
getUsageCount
public int getUsageCount()
Returns the number of usages on this object. (value only available for executable objects)- Returns:
- Number of usages
-
getArchiveKey1
public java.lang.String getArchiveKey1()
Returns the value of the first archive key.- Returns:
- Archive Key 1
-
getArchiveKey2
public java.lang.String getArchiveKey2()
Returns the value of the second archive key.- Returns:
- Archive Key 2
-
getOpenByUser
public UC4UserName getOpenByUser()
If the object is currently edited by a user this method will return the name of the User. If the object is not open the return value isnull
.- Returns:
- User that is currently editing the object
-
getOpenSince
public DateTime getOpenSince()
Returns aDateTime
instance that contains the time when the User started editing the object. If the object is not open the return value isnull
.- Returns:
- Date and time since the object is beeing edited
-
getObjectType
public java.lang.String getObjectType()
Returns the type of the UC4 Object or an empty String if the object does not exist.- Returns:
- UC4 object type.
-
getObjectAuthorizations
public ObjectAuthorizations getObjectAuthorizations()
Returns theObjectAuthorizations
for the UC4 Object.- Returns:
- ObjectAuthorizations
-
getSubType
public java.lang.String getSubType()
Returns the sub-type of the object. If there is no sub-type specified the return value isnull
.- Returns:
- subtype or null
-
getPlatform
public java.lang.String getPlatform()
Returns the platform of the object. If there is no platform specified the return value isnull
.- Returns:
- platform or null
-
isAllowedInClientZero
protected boolean isAllowedInClientZero()
Description copied from class:XMLRequest
This method is used internally. Tests if thisXMLRequest
is allowed in client 0. The default implementation returnsfalse
, subclasses may override.- Overrides:
isAllowedInClientZero
in classXMLRequest
- Returns:
true
if this request is allowed in client 0,false
otherwise
-
-