Class 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 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 class XMLRequest
        Parameters:
        doc - Document, used to create new Elements
        request - Request Element - classes append information to this request element
        sessionInfo - 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 class XMLRequest
        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 class XMLRequest
        Parameters:
        doc - XML Document
        session - Info about the user session
      • getHomeFolder

        public java.lang.String getHomeFolder()
        Returns the path to the folder where the Objects exists or null if the object does not exist or this request has not been sent.
        Returns:
        Folder
      • isComponentWorkflow

        public boolean isComponentWorkflow()
        Returns true 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()
        Returns true if the type of this deployment ProcessFlow is application workflow. If this is a component workflow the return value is false
        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()
        Returns true if this is a normal workflow which is has not been enabled for deployment. If the return value is false 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 is null.
        Returns:
        User that is currently editing the object
      • getOpenSince

        public DateTime getOpenSince()
        Returns a DateTime instance that contains the time when the User started editing the object. If the object is not open the return value is null.
        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 the ObjectAuthorizations 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 is null.
        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 is null.
        Returns:
        platform or null
      • isAllowedInClientZero

        protected boolean isAllowedInClientZero()
        Description copied from class: XMLRequest
        This method is used internally. Tests if this XMLRequest is allowed in client 0. The default implementation returns false, subclasses may override.
        Overrides:
        isAllowedInClientZero in class XMLRequest
        Returns:
        true if this request is allowed in client 0, false otherwise