com.ibm.bpe.api
Interface ProcessTemplateData

All Superinterfaces:
java.io.Serializable
All Known Implementing Classes:
ProcessTemplateBean

public interface ProcessTemplateData
extends java.io.Serializable

Accesses the properties of a process template.

A process template is a versioned, deployed, and installed process model that contains the specification of a business process. It can be instantiated and started by issuing appropriate requests, for example, initiate or sendMessage. The execution of the process instance is driven automatically by the process engine.

Since:
6.0.2 - introduced in 5.0

Field Summary
static int AUTO_DELETE_NO
          States that the process instance is not deleted when it reaches an end execution state.
static int AUTO_DELETE_ON_SUCCESSFUL_COMPLETION
          States that the process instance is only deleted when it reaches the FINISHED state.
static int AUTO_DELETE_YES
          States that the process instance is deleted when it reaches any execution end state.
static int AUTONOMY_CHILD
          States that the process runs dependent of a potential parent process.
static int AUTONOMY_NOT_APPLICABLE
          States that the process is a microflow where the autonomy flag is not applicable.
static int AUTONOMY_PEER
          States that the process runs independently of a potential parent process.
static java.lang.String COPYRIGHT
           
static int EXECUTION_MODE_LONG_RUNNING
          States that the process is a macroflow.
static int EXECUTION_MODE_MICROFLOW
          States that the process is a microflow.
static int KIND_BLOCK
          States that the process template describes a block construct.
static int KIND_PROCESS
          States that the process template describes a business process.
static int SCHEMA_5_1
          Do not use - internal only.
static int SCHEMA_5_1_1
          Do not use - internal only.
static int SCHEMA_6_0
          Do not use - internal only.
static int SCHEMA_6_0_2
          Do not use - internal only.
static int SCHEMA_6_1
          Do not use - internal only.
static int SCHEMA_6_1_2
          Do not use - internal only.
static int SCHEMA_6_2
          Do not use - internal only.
static int SCHEMA_7_0
          Do not use - internal only.
static int STATE_STARTED
          States that the process template is available for process instance creation.
static int STATE_STOPPED
          States that the process template has been stopped.
 
Method Summary
 TKTID getAdminTaskTemplateID()
          Returns the ID of the associated administration task template.
 java.lang.String getApplicationName()
          Returns the name of the application the process template is part of.
 boolean getAutoDelete()
          Deprecated. As of version 6.1, replaced by getAutoDeletionMode.
 int getAutoDeletionMode()
          Returns whether an instance of the process template is automatically or conditionally deleted when it reaches an end execution state.
 int getAutonomy()
          States whether an instance of the process template runs dependently of a potential parent or not.
 int[] getAvailableActions()
          Returns the actions that can be called for the current process template.
 java.util.Calendar getCreationTime()
          Returns the creation time of the process template.
 java.lang.String getDescription()
          Returns the description of the process template.
 java.lang.String getDisplayName()
          Returns the display name of the process template.
 java.lang.String getDocumentation()
          Returns the documentation of the process template.
 int getExecutionMode()
          States whether the process template can be executed as a microflow or as a macroflow.
 PTID getID()
          Returns the object identifier.
 java.lang.String getInputMessageTypeName()
          Returns the name of the input message type.
 java.lang.String getInputMessageTypeTypeSystemName()
          Deprecated. As of version 6.0, no replacement.
 java.util.Calendar getLastModificationTime()
          Returns the last time a property of the process template changed.
 java.lang.String getName()
          Returns the name of the process template.
 java.lang.String getOutputMessageTypeName()
          Returns the name of the output message type.
 java.lang.String getOutputMessageTypeTypeSystemName()
          Deprecated. As of version 6.0, no replacement.
 StaffResultSet getProcessAdministrators()
          Deprecated. As of version 6.0.2, replaced by HumanTaskManager.getUsersInRole(getAdminTaskTemplateID(), WorkItem.REASON_ADMINISTRATOR).
 int getSchemaVersion()
          Returns the version of the XML schema that describes the process template.
 int getState()
          States whether the process template is started or stopped.
 java.lang.String getTargetNamespace()
          Returns the target namespace of the process template.
 java.util.Calendar getValidFromTime()
          Returns the time the process template became or becomes valid.
 java.lang.String getVersion()
          Returns a user-specified version of the process template.
 boolean isBusinessRelevant()
          States whether a process instance derived from this template is a business relevant or an "auxiliary" step.
 boolean isCompensationDefined()
          For a BPEL process, states whether an instance of the process template can be compensated.
 boolean isContinueOnError()
          States whether process instances derived from this template stop in case of an unhandled error or not.
 

Field Detail

COPYRIGHT

static final java.lang.String COPYRIGHT
See Also:
Constant Field Values

STATE_STARTED

static final int STATE_STARTED
States that the process template is available for process instance creation.

See Also:
Constant Field Values

STATE_STOPPED

static final int STATE_STOPPED
States that the process template has been stopped. Process instances cannot be created from the process template.

See Also:
Constant Field Values

SCHEMA_6_0

static final int SCHEMA_6_0
Do not use - internal only.

See Also:
Constant Field Values

SCHEMA_5_1

static final int SCHEMA_5_1
Do not use - internal only.

See Also:
Constant Field Values

SCHEMA_7_0

static final int SCHEMA_7_0
Do not use - internal only.

See Also:
Constant Field Values

SCHEMA_6_1

static final int SCHEMA_6_1
Do not use - internal only.

See Also:
Constant Field Values

SCHEMA_6_2

static final int SCHEMA_6_2
Do not use - internal only.

See Also:
Constant Field Values

SCHEMA_5_1_1

static final int SCHEMA_5_1_1
Do not use - internal only.

See Also:
Constant Field Values

SCHEMA_6_0_2

static final int SCHEMA_6_0_2
Do not use - internal only.

See Also:
Constant Field Values

SCHEMA_6_1_2

static final int SCHEMA_6_1_2
Do not use - internal only.

See Also:
Constant Field Values

EXECUTION_MODE_LONG_RUNNING

static final int EXECUTION_MODE_LONG_RUNNING
States that the process is a macroflow.

See Also:
Constant Field Values

EXECUTION_MODE_MICROFLOW

static final int EXECUTION_MODE_MICROFLOW
States that the process is a microflow.

See Also:
Constant Field Values

AUTONOMY_PEER

static final int AUTONOMY_PEER
States that the process runs independently of a potential parent process.

See Also:
Constant Field Values

AUTONOMY_CHILD

static final int AUTONOMY_CHILD
States that the process runs dependent of a potential parent process.

See Also:
Constant Field Values

AUTONOMY_NOT_APPLICABLE

static final int AUTONOMY_NOT_APPLICABLE
States that the process is a microflow where the autonomy flag is not applicable.

See Also:
Constant Field Values

AUTO_DELETE_YES

static final int AUTO_DELETE_YES
States that the process instance is deleted when it reaches any execution end state.

See Also:
Constant Field Values

AUTO_DELETE_ON_SUCCESSFUL_COMPLETION

static final int AUTO_DELETE_ON_SUCCESSFUL_COMPLETION
States that the process instance is only deleted when it reaches the FINISHED state.

See Also:
Constant Field Values

AUTO_DELETE_NO

static final int AUTO_DELETE_NO
States that the process instance is not deleted when it reaches an end execution state.

See Also:
Constant Field Values

KIND_BLOCK

static final int KIND_BLOCK
States that the process template describes a block construct.

See Also:
Constant Field Values

KIND_PROCESS

static final int KIND_PROCESS
States that the process template describes a business process.

See Also:
Constant Field Values
Method Detail

getID

PTID getID()
Returns the object identifier.


getAutoDelete

boolean getAutoDelete()
Deprecated. As of version 6.1, replaced by getAutoDeletionMode.

Returns whether an instance of the process template is deleted when it reaches an end execution state. While being deprecated, this method returns true for processes that specify 'yes' or 'onSuccessfulCompletion' for the autoDelete attribute.

End execution states are STATE_FINISHED, STATE_COMPENSATED, STATE_TERMINATED, or STATE_FAILED. STATE_FAILED is only an end execution state if no compensation is defined.


getAvailableActions

int[] getAvailableActions()
Returns the actions that can be called for the current process template. Refer to ProcessTemplateActions for the set of possible actions.


getCreationTime

java.util.Calendar getCreationTime()
Returns the creation time of the process template.


getDescription

java.lang.String getDescription()
Returns the description of the process template. If there is no description, null is returned.


getDocumentation

java.lang.String getDocumentation()
Returns the documentation of the process template. If there is no documentation, a null string is returned.


getState

int getState()
States whether the process template is started or stopped.

Returns either STATE_STARTED or STATE_STOPPED.


getSchemaVersion

int getSchemaVersion()
Returns the version of the XML schema that describes the process template.


getLastModificationTime

java.util.Calendar getLastModificationTime()
Returns the last time a property of the process template changed.


getName

java.lang.String getName()
Returns the name of the process template.


getApplicationName

java.lang.String getApplicationName()
Returns the name of the application the process template is part of.


getDisplayName

java.lang.String getDisplayName()
Returns the display name of the process template. If there is no display name, null is returned.


getValidFromTime

java.util.Calendar getValidFromTime()
Returns the time the process template became or becomes valid.


getVersion

java.lang.String getVersion()
Returns a user-specified version of the process template. If there is no user-defined version, a null string is returned.


getExecutionMode

int getExecutionMode()
States whether the process template can be executed as a microflow or as a macroflow.

Returns either EXECUTION_MODE_MICROFLOW or EXECUTION_MODE_LONG_RUNNING.


getAutonomy

int getAutonomy()
States whether an instance of the process template runs dependently of a potential parent or not.

Returns either AUTONOMY_PEER or AUTONOMY_CHILD.


isCompensationDefined

boolean isCompensationDefined()
For a BPEL process, states whether an instance of the process template can be compensated.


getInputMessageTypeName

java.lang.String getInputMessageTypeName()
Returns the name of the input message type. A BPEL process returns a value when there is only a single receive or a single pick with a single on-message that creates the process instance.


getInputMessageTypeTypeSystemName

java.lang.String getInputMessageTypeTypeSystemName()
Deprecated. As of version 6.0, no replacement.

Returns the name of the type system of the input message. A BPEL process returns a value when there is only a single receive or a single pick with a single on-message that creates the process instance.


getOutputMessageTypeName

java.lang.String getOutputMessageTypeName()
Returns the name of the output message type. A BPEL process returns a value when there is only a single receive or a single pick with a single on-message that creates the process instance.


getOutputMessageTypeTypeSystemName

java.lang.String getOutputMessageTypeTypeSystemName()
Deprecated. As of version 6.0, no replacement.

Returns the name of the type system of the output message. A BPEL process returns a value when there is only a single receive or a single pick with a single on-message that creates the process instance.


getProcessAdministrators

StaffResultSet getProcessAdministrators()
                                        throws WorkItemManagerException,
                                               InvalidLengthException
Deprecated. As of version 6.0.2, replaced by HumanTaskManager.getUsersInRole(getAdminTaskTemplateID(), WorkItem.REASON_ADMINISTRATOR).

Returns the process administrators defined for instances of the process template.

Throws:
WorkItemManagerException
InvalidLengthException

getTargetNamespace

java.lang.String getTargetNamespace()
Returns the target namespace of the process template.


isBusinessRelevant

boolean isBusinessRelevant()
States whether a process instance derived from this template is a business relevant or an "auxiliary" step. A business relevant step can, for example, be logged into the audit trail.


getAdminTaskTemplateID

TKTID getAdminTaskTemplateID()
Returns the ID of the associated administration task template.


isContinueOnError

boolean isContinueOnError()
States whether process instances derived from this template stop in case of an unhandled error or not. True states that process instances continue navigation in case of an unhandled error. False states that process instances stop navigation in case of an unhandled error to allow for process repair.

Since:
6.1.2.

getAutoDeletionMode

int getAutoDeletionMode()
Returns whether an instance of the process template is automatically or conditionally deleted when it reaches an end execution state. Refer to AutoDeletionMode for the possible deletion modes.

End execution states are STATE_FINISHED, STATE_COMPENSATED, STATE_TERMINATED, or STATE_FAILED. STATE_FAILED is only an end execution state if no compensation is defined.

Since:
6.1.