Oracle® Data Integrator Java API Reference
11g Release 1 (11.1.1.3.0)

E17060-01

oracle.odi.domain.runtime.session
Class OdiSessionStepLog

java.lang.Object
  extended by oracle.odi.domain.support.BusinessObject
      extended by oracle.odi.domain.support.AbstractRepositoryEntity
          extended by oracle.odi.domain.runtime.session.StepLog
              extended by 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

Oracle® Data Integrator Java API Reference
11g Release 1 (11.1.1.3.0)

E17060-01

Copyright © 2010, Oracle and/or its affiliates. All rights reserved.