Skip navigation links

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

E17060-04


oracle.odi.domain.runtime.scenario
Class OdiScenarioSchedule

java.lang.Object
  extended by oracle.odi.domain.support.BusinessObject
      extended by oracle.odi.domain.support.AbstractRepositoryEntity
          extended by oracle.odi.domain.support.AbstractOdiEntity
              extended by oracle.odi.domain.runtime.scheduling.OdiSchedule
                  extended by oracle.odi.domain.runtime.scenario.OdiScenarioSchedule

All Implemented Interfaces:
java.io.Serializable, java.lang.Cloneable, IOdiEntity, IRepositoryEntity, IWorkRuntimeOdiEntity

public final class OdiScenarioSchedule
extends OdiSchedule

OdiScenarioSchedule is an execution schedule attached to the concrete OdiScenario, specified on the object construction. Once created OdiScenarioSchedule cannot be reassigned to another OdiScenario. Much of API is defined in OdiSchedule class, which is the superclass for OdiScenarioSchedule. The main purpose of this concrete class is to include OdiScenario object to which the schedule applies, and provide creation of valid startup parameters for OdiSession.

OdiScenarioSchedule is the part of aggregation with some OdiScenario). It is important to understand that a OdiScenarioSchedule concerns only one scenario and once created it cannot be separated from that particular scenario, while the latest can have several schedules and can be scheduled in several ways. OdiScenarioSchedule life cycle begins when a user constructs a new instance specifying OdiScenario. It is then stored inside ODI run-time repository. Life cycle ends when a user deletes the concrete implementation or the related scenario from run-time repository (i.e. using IOdiEntityManager.remove()).

The main purpose of this class is to include OdiScenario object to which the schedule applies, and provide creation of valid startup parameters for OdiSession.

Since:
11.1.1.6.0
See Also:
OdiSchedule, OdiScenario, OdiJobStartupParam, Serialized Form

Field Summary

 

Fields inherited from class oracle.odi.domain.support.AbstractOdiEntity
STARTING_INTERNAL_VERSION

 

Constructor Summary
OdiScenarioSchedule(OdiScenario pScenario, java.lang.String pContextCode, java.lang.String pLogicalAgentName)
          Constructs the active schedule of ON_AGENT_STARTUP recurrence type for specified OdiScenario.
OdiScenarioSchedule(OdiScenario pScenario, java.lang.String pContextCode, java.lang.String pLogicalAgentName, Recurrence pRecurrence)
          Constructs the active Schedule with specified recurrence for specified OdiScenario.

 

Method Summary
 OdiJobStartupParam createJobStartupParam(OdiScenarioVariable pVariable, java.lang.Object pValue)
          Creates a new instance of OdiJobStartupParam and associate it with the schedule.
 OdiScenario getScenario()
          Returns the OdiScenario this schedule is associated with.
 IRepositoryEntity getSecurityContainer()
          Define a generic way to retrieve container for entities.
 void setExecutionMode(ExecutionMode pExecutionMode)
          Sets the execution mode for ODI session to be executed.

 

Methods inherited from class oracle.odi.domain.runtime.scheduling.OdiSchedule
getActiveFromDate, getActiveToDate, getAttemptNbOnFailure, getContextCode, getDailyActivationTimeRange, getExcludedMonthDaysPattern, getExcludedWeekDays, getExecutionMode, getInternalId, getJobStartupParams, getLogicalAgentName, getMaxRunDuration, getRecurrence, getRepetition, getScheduleId, getStatus, removeJobStartupParam, setActiveFromDate, setActiveToDate, setAttemptNbOnFailure, setContextCode, setDailyActivationTimeRange, setExcludedMonthDaysPattern, setExcludedWeekDays, setLogicalAgentName, setMaxRunDuration, setRecurrence, setRepetition, setStatus

 

Methods inherited from class oracle.odi.domain.support.AbstractOdiEntity
equals, getFirstDate, getFirstUser, getInternalVersion, getLastDate, getLastUser, getName, hashCode, isInstanceLevelSecurityNeeded, isNew, toString

 

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

 

Methods inherited from class java.lang.Object
getClass, notify, notifyAll, wait, wait, wait

 

Methods inherited from interface oracle.odi.domain.IOdiEntity
getFirstDate, getFirstUser, getLastDate, getLastUser, getName, isInstanceLevelSecurityNeeded

 

Constructor Detail

OdiScenarioSchedule

public OdiScenarioSchedule(OdiScenario pScenario,
                           java.lang.String pContextCode,
                           java.lang.String pLogicalAgentName)
Constructs the active schedule of ON_AGENT_STARTUP recurrence type for specified OdiScenario.
Parameters:
pScenario - scenario
pContextCode - context code
pLogicalAgentName - logical agent name
Throws:
DomainRuntimeException - if scenario is null; context code or logical agent name is null or empty
See Also:
Recurrence

OdiScenarioSchedule

public OdiScenarioSchedule(OdiScenario pScenario,
                           java.lang.String pContextCode,
                           java.lang.String pLogicalAgentName,
                           Recurrence pRecurrence)
Constructs the active Schedule with specified recurrence for specified OdiScenario.
Parameters:
pScenario - scenario
pContextCode - context code
pLogicalAgentName - logical agent name
pRecurrence - recurrence
Throws:
DomainRuntimeException - if scenario or recurrence is null; context code or logical agent name is null or empty
See Also:
Recurrence

Method Detail

getSecurityContainer

public IRepositoryEntity getSecurityContainer()
Description copied from interface: IRepositoryEntity
Define a generic way to retrieve container for entities.
Returns:
container entity

getScenario

public OdiScenario getScenario()
Returns the OdiScenario this schedule is associated with.
Returns:
scenario
See Also:
OdiScenario

setExecutionMode

public void setExecutionMode(ExecutionMode pExecutionMode)
Sets the execution mode for ODI session to be executed.

This method is overridden to prohibit nulls, because execution mode is mandatory attribute for scenario schedules.

Overrides:
setExecutionMode in class OdiSchedule
Parameters:
pExecutionMode - execution mode to set
Throws:
DomainRuntimeException - if specified execution mode is null
See Also:
ExecutionMode, OdiSchedule.getExecutionMode()

createJobStartupParam

public OdiJobStartupParam createJobStartupParam(OdiScenarioVariable pVariable,
                                                java.lang.Object pValue)
Creates a new instance of OdiJobStartupParam and associate it with the schedule. The latest value of the given OdiScenarioVariable will be overridden with the given value.
Parameters:
pVariable - scenario variable
pValue - value
Returns:
created startup parameter
Throws:
DomainRuntimeException - if variable is null or not related to the same scenario
See Also:
OdiJobStartupParam, OdiScenarioVariable, OdiSchedule.removeJobStartupParam(OdiJobStartupParam), OdiSchedule.getJobStartupParams()

Skip navigation links

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

E17060-04


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