|
Oracle BPEL Process Manager Client Java API Reference 10g Release 3 (10.1.3.1.0) B28986-01 |
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface IInstanceHandle
The IInstanceHandle
interface allows the user to perform operations on an active instance. An instance in the process domain represents a long-running, multi-step business transaction that may involve orchestration (or conversations) between multiple performers or service components (represented as activities).
Instances, once started by the process domain, may be administered (for example, an instance may be suspended, resumed or aborted) via this interface. In addition, this interface allows developers to access run-time attributes of the instance (for instance, the current title value of the instance, or even a data field value).
Field Summary |
---|
Fields inherited from interface com.oracle.bpel.client.IInstanceConstants |
---|
PRIORITY_NORMAL, STATE_CLOSED_ABORTED, STATE_CLOSED_CANCELLED, STATE_CLOSED_COMPLETED, STATE_CLOSED_FAULTED, STATE_CLOSED_PENDING_CANCEL, STATE_CLOSED_STALE, STATE_INITIATED, STATE_OPEN_FAULTED, STATE_OPEN_RUNNING, STATE_OPEN_SUSPENDED |
Method Summary | |
---|---|
void |
abort() Aborts the instance. |
void |
cancel() Cancels the instance. |
void |
delete() Delete the instance from the process domain. |
java.lang.String |
getAuditDetails(int detailId) Returns the details for a single audit trail entry. |
java.lang.String |
getAuditTrail() Returns the XML representation of the audit trail of this instance. |
java.lang.String |
getConversationId() Returns the converationId of this instance. |
java.util.Date |
getCreationDate() Retrieves the creation date of this instance. |
java.lang.String |
getCreator() Retrieves the creator of this instance. |
java.lang.String |
getDebugTrace() Returns an XML dump of the instance. |
java.lang.Object |
getField(java.lang.String name) Retrieves the value of a data field from within this process instance. |
java.lang.String |
getIndex(int i) Returns the specified index value for this instance. |
java.lang.String |
getInstanceTrace() Returns an XML dump of the instance. |
java.lang.String |
getMetadata() Returns the user specified metadata of this instance. |
java.util.Date |
getModifyDate() Retrieves the date this instance was last modified on. |
java.lang.String |
getParentId() Returns the parent identifier of this instance. |
int |
getPriority() Retrieves the current priority of this instance. |
IBPELProcessHandle |
getProcess() Returns a handle to the BPEL process that this instance belongs to. |
ReferenceId |
getReferenceId() Retrieves the reference identifier of this instance. |
java.lang.Object |
getResult() Retrieves the return value of the instance. |
java.lang.String |
getRootId() Returns the root identifier of this instance. |
java.lang.String |
getStage() Retrieves the current stage of this instance. |
int |
getState() Retrieves the current state of this instance. |
java.lang.String |
getStatus() Retrieves the current status of this instance. |
ITestCaseInfo |
getTestCaseInfo() Returns the test case information. |
java.lang.String |
getTitle() Retrieves the current title of this instance. |
boolean |
isCancelled() Returns true if this instance has been cancelled. |
boolean |
isClosed() Returns true if the state of this instance is either one of: closed.pending.cancel closed.completed closed.faulted closed.cancelled closed.aborted closed.stale |
boolean |
isComplete() Returns true if this instance is complete. |
boolean |
isFaulted() Returns true if this instance has completed abnormally (that is, due to a fault/exception). |
boolean |
isOpen() Returns true if the state of this instance is either one of: open.running open.suspended open.faulted |
boolean |
isStale() Returns true if this instance has been marked as stale. |
boolean |
isTestCase() Indicates if this instance is a test case. |
IActivityHandle[] |
listActivities() Returns the handles for all the activities that belong to this instance. |
Method Detail |
---|
ReferenceId getReferenceId()
java.util.Date getCreationDate() throws ServerException
ServerException
- if there is a problem in fetching the meta data of this instance from the process domain.java.lang.String getCreator() throws ServerException
ServerException
- if there is a problem in fetching the meta data of this instance from the process domain.java.util.Date getModifyDate() throws ServerException
ServerException
- if there is a problem in fetching the meta data of this instance from the process domain.int getState() throws ServerException
int
ServerException
- if there is a problem in fetching the meta data of this instance from the process domain.IInstanceConstants
boolean isOpen() throws ServerException
true
if the state of this instance is either one of:
ServerException
- if there is a problem in fetching the meta data of this instance from the process domain.IInstanceConstants
boolean isClosed() throws ServerException
true
if the state of this instance is either one of:
ServerException
- if there is a problem in fetching the meta data of this instance from the process domain.IInstanceConstants
boolean isComplete() throws ServerException
true
if this instance is complete. An instance is complete if it does not contain any active activities.ServerException
- if there is a problem in fetching the meta data of this instance from the process domain.IInstanceConstants
boolean isFaulted() throws ServerException
true
if this instance has completed abnormally (that is, due to a fault/exception).ServerException
- if there is a problem in fetching the meta data of this instance from the process domain.IInstanceConstants
boolean isCancelled() throws ServerException
true
if this instance has been cancelled. Instances that terminate due to a fault condition while executing are considered faulted. Instances that are cancelled have had administrative action taken upon them.ServerException
- if there is a problem in fetching the meta data of this instance from the process domain.IInstanceConstants
boolean isStale() throws ServerException
true
if this instance has been marked as stale. When a BPEL process is deployed on top of an existing (that is, deployed) BPEL process with the same process identifier and revision tag, all instances created from the old BPEL process are marked as stale and cannot be acted upon any longer.
Instances belonging to undeployed processes are also marked as stale.
ServerException
- if there is a problem in fetching the meta data of this instance from the process domain.IInstanceConstants
int getPriority() throws ServerException
setPriority()
method from a BPELX java exec tag.
The semantics attached to the priority value are the sole domain and responsibility of the developer.
ServerException
- if there is a problem in fetching the meta data of this instance from the process domain.java.lang.String getTitle() throws ServerException
setTitle()
method from a BPELX java exec tag.ServerException
- if there is a problem in fetching the meta data of this instance from the process domain.java.lang.String getStatus() throws ServerException
setStatus()
method from a BPELX java exec tag.
The semantics attached to the status value are the sole domain and responsibility of the developer.
ServerException
- if there is a problem in fetching the meta data of this instance from the process domain.java.lang.String getStage() throws ServerException
setStage()
method from a BPELX java exec tag.
The semantics attached to the stage value are the sole domain and responsibility of the developer.
ServerException
- if there is a problem in fetching the meta data of this instance from the process domain.java.lang.String getConversationId() throws ServerException
The semantics attached to the value of the key are the sole domain and responsibility of the developer.
ServerException
- if there is a problem in fetching the meta data of this instance from the process domain.java.lang.String getParentId() throws ServerException
The semantics attached to the status value are the sole domain and responsibility of the user.
ServerException
java.lang.String getRootId() throws ServerException
The semantics attached to the status value are the sole domain and responsibility of the user.
ServerException
java.lang.String getMetadata() throws ServerException
The semantics attached to the value of the key are the sole domain and responsibility of the developer.
ServerException
- if there is a problem in fetching the meta data of this instance from the process domain.java.lang.String getIndex(int i) throws ServerException
i
- the index number, starting from 1.ServerException
- if there is a problem fetching the meta data of this instance from the process domain.java.lang.Object getField(java.lang.String name) throws ServerException
name
- the name of the data field.ServerException
- if there is a problem in fetching the meta data of this instance from the process domain or if a data member called name
has not been declared in the instance.java.lang.Object getResult() throws ServerException
ServerException
- if there is a problem in fetching the meta data of this instance from the process domain or if the instance is not complete yet.java.lang.String getInstanceTrace() throws ServerException
ServerException
- if there is a problem in fetching the meta data of this instance from the process domain.java.lang.String getDebugTrace() throws ServerException
ServerException
- if there is a problem in fetching the meta data of this instance from the process domain.java.lang.String getAuditTrail() throws ServerException
ServerException
- if there is a problem in fetching the meta data of this instance from the process domain.java.lang.String getAuditDetails(int detailId) throws ServerException
Large audit trail documents stored in the details field of any entry are persisted to a separate table than the rest of the audit trail. By doing this, the overall size of the audit trail is kept small and as a result, faster to load.
The id for a detail entry is found as an attribute on the details
tag.
If no details entry can be found with the specified identifier, an empty string will be returned.
detailId
- the identifier for the details entryServerException
- if there is a problem in fetching the meta data of this instance from the process domain.IActivityHandle[] listActivities() throws ServerException
ServerException
- if there is a problem in fetching the activities for this instance.IBPELProcessHandle getProcess() throws ServerException
ServerException
- if there is a problem in fetching the process for this instance.void cancel() throws ServerException
When an activity is cancelled, the performer of the activity is notified of the cancellation and is given an opportunity to rollback or cancel any work that has already been done on behalf of the activity. Since this clean-up procedure can take an indeterminate amount of time, cancelling an instance may not be instaneous and could result in new activities being activated.
ServerException
- if there is a problem in locating the instance in the process domain or if the requested action is not permitted (the instance this handle is referring to may have been changed in the meantime).void abort() throws ServerException
ServerException
- if there is a problem in locating the instance in the process domain or if the requested action is not permitted (the instance this handle is referring to may have been changed in the meantime).void delete() throws ServerException
ServerException
- if there is a problem in locating the instance in the process domain or if there is a problem deleting the instance from the domain.boolean isTestCase() throws ServerException
ServerException
- if there is a problem fetching the information.ITestCaseInfo getTestCaseInfo() throws ServerException
null
if the instance is not a test case.ServerException
- if there is a problem locating the test information.
|
Oracle BPEL Process Manager Client Java API Reference 10g Release 3 (10.1.3.1.0) B28986-01 |
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |