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

java.lang.Object
  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.
boolean	getLoopUsingPeek() 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

getLoopUsingPeek

public boolean getLoopUsingPeek()

Description copied from interface: IActionSequence

If the ActionSequence contains a loop, returns the parameter that the execution should loop on.

Specified by:

getLoopUsingPeek in interface IActionSequence

Returns:

the parameter to loop on, if looping is defined, otherwise null