oracle.odi.domain.runtime.session
Class OdiSessionStepLog

java.lang.Object
  oracle.odi.domain.support.BusinessObject
      oracle.odi.domain.support.AbstractRepositoryEntity
          oracle.odi.domain.runtime.session.StepLog
              oracle.odi.domain.runtime.session.OdiSessionStepLog

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, IRepositoryEntity

public final class OdiSessionStepLog
extends oracle.odi.domain.runtime.session.StepLog

Execution log of an OdiSession's step. A step is the unit of execution found between a task and a session. It corresponds to a step in a package or in a scenario. When executing an interface or a single variable, for example, a session has only one session step. It is part of the OdiSession - OdiSessionVariable - OdiSessionStepLog aggregate. However, it is also root of the OdiSessionStepLog - OdiSessionTaskLog aggregate.

An OdiSessionStepLog life cycle begins when an ODI session step is runned by ODI Execution Engine. Its life cycle ends when enclosing @link OdiSession} is removed from runtime repository.

Since:

11.1.1.3.0

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class oracle.odi.domain.runtime.session.StepLog

StepLog.OdiStepLogId

Method Summary

java.lang.String	getContextCode() Returns the context code of the OdiSessionStepLog.
java.lang.Integer	getDeleteCount() Returns the number of processed deletes, or null if not applicable.
java.lang.Integer	getDuration() Returns the duration (in second) of this step's execution, or null if not yet defined.
java.util.Date	getEndTime() Returns the end time for this step, or null if not yet finished.
java.lang.Integer	getErrorCount() Obtains the number of errors for this step.
java.lang.String	getErrorMessage() Returns the error message for this step if any.
int	getExecutionCount() Returns the internal count of execution of this same OdiSessionStepLog within the session.
int	getFailureRetryDelay() Returns the retry interval in seconds.
int	getFailureRetryNumber() Returns the indicator for retrying the step execution if an error occurred: 0 = Do not retry 1 = Retry.
java.lang.Integer	getInsertCount() Returns the number of processed inserts, or null if not applicable.
java.io.Serializable	getInternalId() Provides a common getter for the persistence layer to obtain an identity, irrespective of the actual type of identity used.
java.lang.String	getKoExitCode() Returns the Exit Code on failure.
java.lang.Integer	getMaxErrorCount() Returns the maximum number of records allowed to be in error as specified within an interface.
java.lang.String	getName() Returns the name of this OdiSessionStepLog.
OdiSessionStepLog	getNextStepAfterFailure() Retrieves the execution log of the step that has to be executed after one related to this OdiSessionStepLog, if it failed.
OdiSessionStepLog	getNextStepAfterSuccess() Retrieves the execution log of the step that has to be executed after one related to this OdiSessionStepLog, if it succeeds.
java.lang.String	getOkExitCode() Returns the Exit Code on success.
java.lang.Integer	getRecordCount() Returns overall number of records processed by this step, or null if not applicable.
java.lang.String	getReturnCode() Obtains the return code for this step.
IRepositoryEntity	getSecurityContainer() Define a generic way to retrieve container for entities.
java.lang.Number	getSessionId() Returns the ID of OdiSession this OdiSessionStepLog is related to.
java.util.List<OdiSessionTaskLog>	getSessionTaskLogs() Obtains ordered unmodifiable list of task logs (OdiSessionTaskLog) that belong to this OdiSessionStepLog.
java.util.Date	getStartTime() Returns the start time for this step, or null if not yet started.
Status	getStatus() Obtains the status of this execution step.
int	getStepNumber() Returns the internally calculated sequence number of this OdiSessionStepLog within the initial package.
StepType	getStepType() Returns the type of this OdiSessionStepLog.
java.lang.String	getTargetLogicalSchemaName() Obtains target logical schema name on which this step's tasks are executed.
java.lang.String	getTargetModelCode() Obtains target model code on which this step's tasks are executed.
java.lang.String	getTargetResourceName() Obtains target resource name (i.e.
java.lang.String	getTargetTableName() Obtains target table name on which this step's tasks are executed.
java.lang.Integer	getUpdateCount() Returns overall number of updates processed by this step, or null if not applicable.
java.lang.Number	getVariableIncrement() Returns the variable increment.
java.lang.String	getVariableName() Returns the variable name.
VariableOperator	getVariableOperator() Returns the operator for variable evaluation.
java.lang.String	getVariableValue() Returns the value or list of value with separator.
boolean	isContextForced() Returns true if context was forced to a different context than the execution context, false otherwise.
boolean	isKoExit() Returns true if exit required on failure, false - otherwise.
boolean	isMaxErrorCountAsPercentage() Indicate whether the "maxErrorCount" property should be managed as a number of error or as a percentage of error.
boolean	isOkExit() Returns true if exit required on success, false - otherwise.

Methods inherited from class oracle.odi.domain.support.BusinessObject

clone

Methods inherited from class java.lang.Object

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

Method Detail

getContextCode

public java.lang.String getContextCode()

Returns the context code of the OdiSessionStepLog. Maybe the execution context, or a forced context for this step.

Overrides:

getContextCode in class oracle.odi.domain.runtime.session.StepLog

Returns:

context code

getDeleteCount

public java.lang.Integer getDeleteCount()

Returns the number of processed deletes, or null if not applicable.

Relevant for Interfaces and Procedures and any execution that manipulates data.

Overrides:

getDeleteCount in class oracle.odi.domain.runtime.session.StepLog

Returns:

the number of processed deletes

getDuration

public java.lang.Integer getDuration()

Returns the duration (in second) of this step's execution, or null if not yet defined.

Overrides:

getDuration in class oracle.odi.domain.runtime.session.StepLog

Returns:

the duration (in second) of this step's execution

getEndTime

public java.util.Date getEndTime()

Returns the end time for this step, or null if not yet finished.

Overrides:

getEndTime in class oracle.odi.domain.runtime.session.StepLog

Returns:

step end time

getErrorCount

public java.lang.Integer getErrorCount()

Obtains the number of errors for this step.

Overrides:

getErrorCount in class oracle.odi.domain.runtime.session.StepLog

Returns:

number of errors

getErrorMessage

public java.lang.String getErrorMessage()

Returns the error message for this step if any. Will always return null if not failed.

Overrides:

getErrorMessage in class oracle.odi.domain.runtime.session.StepLog

Returns:

error message

getExecutionCount

public int getExecutionCount()

Returns the internal count of execution of this same OdiSessionStepLog within the session.

Overrides:

getExecutionCount in class oracle.odi.domain.runtime.session.StepLog

Returns:

step execution count

getFailureRetryDelay

public int getFailureRetryDelay()

Returns the retry interval in seconds.

Returns:

the retry interval in seconds

getFailureRetryNumber

public int getFailureRetryNumber()

Returns the indicator for retrying the step execution if an error occurred: 0 = Do not retry 1 = Retry.

Returns:

the indicator for retrying the step execution if an error occurred

getInsertCount

public java.lang.Integer getInsertCount()

Returns the number of processed inserts, or null if not applicable.

Relevant for Interfaces and Procedures and any execution that manipulates data.

Overrides:

getInsertCount in class oracle.odi.domain.runtime.session.StepLog

Returns:

the number of processed inserts

getInternalId

public java.io.Serializable getInternalId()

Description copied from interface: IRepositoryEntity

Provides a common getter for the persistence layer to obtain an identity, irrespective of the actual type of identity used.

Typically a subclass will delegate to a public SomePrimitiveWrapper getId() method. The necessity for the getInternalId() abstract method is solely because the persistence layer needs a way of obtaining the identity irrespective of the actual identity implementation choice.

Returning null from this method will indicate the object has never been saved. This will likely be relied on by some DAO implementations.

Specified by:

getInternalId in interface IRepositoryEntity

Overrides:

getInternalId in class oracle.odi.domain.runtime.session.StepLog

Returns:

the persistence identity of this instance

getKoExitCode

public java.lang.String getKoExitCode()

Returns the Exit Code on failure.

Returns:

the Exit Code on failure

getMaxErrorCount

public java.lang.Integer getMaxErrorCount()

Returns the maximum number of records allowed to be in error as specified within an interface.

Overrides:

getMaxErrorCount in class oracle.odi.domain.runtime.session.StepLog

Returns:

the maximum number of records allowed to be in error

getName

public java.lang.String getName()

Returns the name of this OdiSessionStepLog. This name matches the name of the step as defined in the package that has generated the scenario otherwise it matches the name of the executed object such as OdiInterface, OdiVariable, OdiProcedure etc.

Overrides:

getName in class oracle.odi.domain.runtime.session.StepLog

Returns:

step name

getNextStepAfterFailure

public OdiSessionStepLog getNextStepAfterFailure()

Retrieves the execution log of the step that has to be executed after one related to this OdiSessionStepLog, if it failed.

If no next OdiSessionStepLog was defined (null is defined), the execution will stop after failure.

Returns:

the next step after failure or null is none

getNextStepAfterSuccess

public OdiSessionStepLog getNextStepAfterSuccess()

Retrieves the execution log of the step that has to be executed after one related to this OdiSessionStepLog, if it succeeds.

If no next OdiSessionStepLog was defined (null is defined), the execution will stop after success.

Returns:

the execution log of the next step after success or null if none

getOkExitCode

public java.lang.String getOkExitCode()

Returns the Exit Code on success.

Returns:

the Exit Code on success

getRecordCount

public java.lang.Integer getRecordCount()

Returns overall number of records processed by this step, or null if not applicable.

Relevant for Interfaces and Procedures and any execution that manipulates data.

Overrides:

getRecordCount in class oracle.odi.domain.runtime.session.StepLog

Returns:

overall number of records processed by this step

getReturnCode

public java.lang.String getReturnCode()

Obtains the return code for this step. The return code is obtained from the execution channel of the last task, e.g. operating system code, database error code, etc. It will be "0" (zero) in case of success.

Overrides:

getReturnCode in class oracle.odi.domain.runtime.session.StepLog

Returns:

step return code

getSecurityContainer

public IRepositoryEntity getSecurityContainer()

Description copied from interface: IRepositoryEntity

Define a generic way to retrieve container for entities.

Specified by:

getSecurityContainer in interface IRepositoryEntity

Overrides:

getSecurityContainer in class oracle.odi.domain.runtime.session.StepLog

Returns:

container entity

getSessionId

public java.lang.Number getSessionId()

Returns the ID of OdiSession this OdiSessionStepLog is related to.

Overrides:

getSessionId in class oracle.odi.domain.runtime.session.StepLog

Returns:

session ID

getSessionTaskLogs

public java.util.List<OdiSessionTaskLog> getSessionTaskLogs()

Obtains ordered unmodifiable list of task logs (OdiSessionTaskLog) that belong to this OdiSessionStepLog.

Returns:

list of session's task logs

getStartTime

public java.util.Date getStartTime()

Returns the start time for this step, or null if not yet started.

Overrides:

getStartTime in class oracle.odi.domain.runtime.session.StepLog

Returns:

start time

getStatus

public Status getStatus()

Obtains the status of this execution step.

Overrides:

getStatus in class oracle.odi.domain.runtime.session.StepLog

Returns:

step status

getStepNumber

public int getStepNumber()

Returns the internally calculated sequence number of this OdiSessionStepLog within the initial package.

Overrides:

getStepNumber in class oracle.odi.domain.runtime.session.StepLog

Returns:

sequence number of this OdiSessionStepLog within the initial package

getStepType

public StepType getStepType()

Returns the type of this OdiSessionStepLog.

Overrides:

getStepType in class oracle.odi.domain.runtime.session.StepLog

Returns:

step type

getTargetLogicalSchemaName

public java.lang.String getTargetLogicalSchemaName()

Obtains target logical schema name on which this step's tasks are executed.

Overrides:

getTargetLogicalSchemaName in class oracle.odi.domain.runtime.session.StepLog

Returns:

logical schema name

getTargetModelCode

public java.lang.String getTargetModelCode()

Obtains target model code on which this step's tasks are executed.

Overrides:

getTargetModelCode in class oracle.odi.domain.runtime.session.StepLog

Returns:

model code

getTargetResourceName

public java.lang.String getTargetResourceName()

Obtains target resource name (i.e. physical name of the table or underlying resource) on which this step's tasks are executed.

Overrides:

getTargetResourceName in class oracle.odi.domain.runtime.session.StepLog

Returns:

the resource name

getTargetTableName

public java.lang.String getTargetTableName()

Obtains target table name on which this step's tasks are executed.

Overrides:

getTargetTableName in class oracle.odi.domain.runtime.session.StepLog

Returns:

the table name

getUpdateCount

public java.lang.Integer getUpdateCount()

Returns overall number of updates processed by this step, or null if not applicable.

Relevant for Interfaces and Procedures and any execution that manipulates data.

Overrides:

getUpdateCount in class oracle.odi.domain.runtime.session.StepLog

Returns:

overall number of updates processed by this step

getVariableIncrement

public java.lang.Number getVariableIncrement()

Returns the variable increment.

Returns:

the variable increment

getVariableName

public java.lang.String getVariableName()

Returns the variable name.

Returns:

the variable name

getVariableOperator

public VariableOperator getVariableOperator()

Returns the operator for variable evaluation.

Returns:

the operator for variable evaluation

See Also:

link VariableOperator}

getVariableValue

public java.lang.String getVariableValue()

Returns the value or list of value with separator.

These values are evaluated before the execution of the step

.

Returns:

the value or list of value with separator

isContextForced

public boolean isContextForced()

Returns true if context was forced to a different context than the execution context, false otherwise.

Overrides:

isContextForced in class oracle.odi.domain.runtime.session.StepLog

Returns:

true if context was forced to a different context than the execution context, false otherwise

isKoExit

public boolean isKoExit()

Returns true if exit required on failure, false - otherwise.

Returns:

true if exit required on failure, false - otherwise

isMaxErrorCountAsPercentage

public boolean isMaxErrorCountAsPercentage()

Indicate whether the "maxErrorCount" property should be managed as a number of error or as a percentage of error.

Overrides:

isMaxErrorCountAsPercentage in class oracle.odi.domain.runtime.session.StepLog

Returns:

true if percentage, false otherwise.

isOkExit

public boolean isOkExit()

Returns true if exit required on success, false - otherwise.

Returns:

true if exit required on success, false - otherwise