org.pentaho.platform.engine.services.actionsequence
Class ActionSequence

java.lang.Object
  extended by org.pentaho.platform.engine.services.actionsequence.ActionSequence
All Implemented Interfaces:
IActionSequence, ISequenceDefinition

public class ActionSequence
extends Object
implements IActionSequence


Field Summary
 
Fields inherited from interface org.pentaho.platform.api.engine.ISequenceDefinition
ACTION_SEQUENCE_DEFINITION_INVALID_ACTION_DOC, ACTION_SEQUENCE_DEFINITION_INVALID_XML, ACTION_SEQUENCE_DEFINITION_OK, RESULT_TYPE_NONE, RESULT_TYPE_PROCESS, RESULT_TYPE_REPORT, RESULT_TYPE_RULE
 
Method Summary
 List getActionDefinitions()
           
 List getActionDefinitionsAndSequences()
          Returns the list of ActionDefinition objects retrieved from the SequenceDefinition.
 String getAuthor()
          Returns the author of the SequenceDefinition, if defined, or null otherwise.
 IConditionalExecution getConditionalExecution()
           
 String getDescription()
          Returns the description of this SequenceDefinition, if defined, or null otherwise.
 String getHelp()
          Returns the URL to the Help page for this definition.
 String getIcon()
          Returns the path to the icon for this SequenceDefinition.
 Map getInputDefinitions()
          Returns a Map of the input parameters that are defined to this SequenceDefinition.
 Map getInputDefinitionsForParameterProvider(String parameterProviderName)
          Returns a Map of the input parameters that are defined to this SequenceDefinition for a specific parameter provider.
 int getLoggingLevel()
          Get the logging level for this SequenceDefinition.
 String getLoopParameter()
          If the ActionSequence contains a loop, returns the parameter that the execution should loop on.
 Map getOutputDefinitions()
          Returns a Map of the output parameters that are defined to this SequenceDefinition.
 Map getResourceDefinitions()
          Returns the sequence's resource definitions as a Map.
 String getResultType()
          Returns the type of the overall result of executing the action sequence document that this SequenceDefinition came from.
 String getSequenceName()
          Returns the document name of the action sequence document that this SequenceDefinition came from.
 String getSolutionName()
          Returns the solution name, which is the name at the root level of the solution path.
 String getSolutionPath()
          Returns the path relative to the solution name that will lead to this definition
 String getTitle()
          Returns the title of this SequenceDefinition, if defined, or null otherwise.
 boolean hasLoop()
          Returns whether the ActionSequence has a loop in its definition.
 void setConditionalExecution(IConditionalExecution value)
          Sets the ConditionalExecution object that determines whether a set of actions will be executed.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

getActionDefinitions

public List getActionDefinitions()

getLoopParameter

public String getLoopParameter()
Description copied from interface: IActionSequence
If the ActionSequence contains a loop, returns the parameter that the execution should loop on.

Specified by:
getLoopParameter in interface IActionSequence
Returns:
the parameter to loop on, if looping is defined, otherwise null

getConditionalExecution

public IConditionalExecution getConditionalExecution()
Specified by:
getConditionalExecution in interface IActionSequence
Returns:
The conditional execution object that determines whether a set of actions will be executed.

setConditionalExecution

public void setConditionalExecution(IConditionalExecution value)
Description copied from interface: IActionSequence
Sets the ConditionalExecution object that determines whether a set of actions will be executed.

Specified by:
setConditionalExecution in interface IActionSequence
Parameters:
value - The ConditionalExecution object

hasLoop

public boolean hasLoop()
Description copied from interface: IActionSequence
Returns whether the ActionSequence has a loop in its definition.

Specified by:
hasLoop in interface IActionSequence
Returns:
true if looping is defined, otherwise false

getResultType

public String getResultType()
Description copied from interface: ISequenceDefinition
Returns the type of the overall result of executing the action sequence document that this SequenceDefinition came from. For example if the sequence results in the generation of a report the result type for the sequence should be RESULT_TYPE_REPORT. This property is used to select icons to show next to the sequence name when users navigate the available actions. Tif this returns RESULT_TYPE_NONE, empty string or null, the action sequence will not be visible to users as they navigate

Specified by:
getResultType in interface ISequenceDefinition
Returns:
the action sequence result type

getSequenceName

public String getSequenceName()
Description copied from interface: ISequenceDefinition
Returns the document name of the action sequence document that this SequenceDefinition came from.

Specified by:
getSequenceName in interface ISequenceDefinition
Returns:
the action sequence document name

getAuthor

public String getAuthor()
Description copied from interface: ISequenceDefinition
Returns the author of the SequenceDefinition, if defined, or null otherwise.

Specified by:
getAuthor in interface ISequenceDefinition
Returns:
this definition's author, or null if not defined.

getDescription

public String getDescription()
Description copied from interface: ISequenceDefinition
Returns the description of this SequenceDefinition, if defined, or null otherwise.

Specified by:
getDescription in interface ISequenceDefinition
Returns:
this definition's description, or null if not defined.

getHelp

public String getHelp()
Description copied from interface: ISequenceDefinition
Returns the URL to the Help page for this definition.

Specified by:
getHelp in interface ISequenceDefinition
Returns:
the definition's Help URL

getInputDefinitions

public Map getInputDefinitions()
Description copied from interface: ISequenceDefinition
Returns a Map of the input parameters that are defined to this SequenceDefinition. These inputs are part of the contract between this sequence definition and the platform subsystems, ie., the runtime context.

Specified by:
getInputDefinitions in interface ISequenceDefinition
Returns:
Map of input parameters. Parameters take the name-value form.

getInputDefinitionsForParameterProvider

public Map getInputDefinitionsForParameterProvider(String parameterProviderName)
Description copied from interface: ISequenceDefinition
Returns a Map of the input parameters that are defined to this SequenceDefinition for a specific parameter provider. For example the input named "REGION" may come from a request parameter named "regn" Calling this method passing in "request" for the parameterproviderName will return a map that includes an entry with the key "regn" mapped to the "REGION" IActionParameter.

Specified by:
getInputDefinitionsForParameterProvider in interface ISequenceDefinition
Parameters:
parameterProviderName - The name of the parameter provider e.g. "request", "session", "global"...
Returns:
Map of input parameters. Parameters take the name-value form.

getOutputDefinitions

public Map getOutputDefinitions()
Description copied from interface: ISequenceDefinition
Returns a Map of the output parameters that are defined to this SequenceDefinition. These outputs are part of the contract between this sequence definition and the platform subsystems, ie., the runtime context.

Specified by:
getOutputDefinitions in interface ISequenceDefinition
Returns:
Map of output parameters. Parameters take the name-value form.

getResourceDefinitions

public Map getResourceDefinitions()
Description copied from interface: ISequenceDefinition
Returns the sequence's resource definitions as a Map. Resources are elements that exist outside of the action sequence document, such as images, icons, additional definition documents, etc.

Specified by:
getResourceDefinitions in interface ISequenceDefinition
Returns:
Map of resource parameters. Parameters take the name-value form.

getSolutionName

public String getSolutionName()
Description copied from interface: ISequenceDefinition
Returns the solution name, which is the name at the root level of the solution path.

Specified by:
getSolutionName in interface ISequenceDefinition
Returns:
the name of the root level of this definition's solution

getSolutionPath

public String getSolutionPath()
Description copied from interface: ISequenceDefinition
Returns the path relative to the solution name that will lead to this definition

Specified by:
getSolutionPath in interface ISequenceDefinition
Returns:
the solution path to this definition

getLoggingLevel

public int getLoggingLevel()
Description copied from interface: ISequenceDefinition
Get the logging level for this SequenceDefinition. The logging level may be set independently or may be inherited from a parent object's logging level.

Specified by:
getLoggingLevel in interface ISequenceDefinition
Returns:
this SequenceDefinition's logging level
See Also:
ILogger

getTitle

public String getTitle()
Description copied from interface: ISequenceDefinition
Returns the title of this SequenceDefinition, if defined, or null otherwise.

Specified by:
getTitle in interface ISequenceDefinition
Returns:
this definition's title, or null if not defined.

getIcon

public String getIcon()
Description copied from interface: ISequenceDefinition
Returns the path to the icon for this SequenceDefinition. The path can be relative or absolute In the pre-configured install these paths are URLs of the form /style/icons/iconname.png This path is used by the navigation XSL to generate the navigation user interface. If this property is not set a generic icon is used.

Specified by:
getIcon in interface ISequenceDefinition
Returns:
the url to the icon

getActionDefinitionsAndSequences

public List getActionDefinitionsAndSequences()
Description copied from interface: IActionSequence
Returns the list of ActionDefinition objects retrieved from the SequenceDefinition.

Specified by:
getActionDefinitionsAndSequences in interface IActionSequence
Returns:
list of ActionDefinitions