processCommand Element

Top  Previous  Next

For each Process Command used in a page, a processCommand configuration element must be provided in the corresponding page configuration file.

  <processCommand name="ProductsForm.DeleteProductCommand">
    <processTemplate name="processTemplateName"/>
    <nextPage>nameOfTheNextPage</nextPage>
    <errorPage>nameOfTheErrorPage</errorPage>
    <continuePage>nameOfTheContinuePage</continuePage>
    <method>[Post|Get]</method>
    <debugLevel>[1|2|3]</debugLevel>
  </processCommand> 

The name attribute of the processCommand element should contain the name of the Process Form that this command is located in and the name of the command itself using the notation processFormName.processCommandName.

Nested Elements

processTemplate (Accepts MScript)

The name attribute of this element must specify the configuration name of the processTemplate element . See Addressing other configuration elements. MScript can be used in the name attribute. e.g. <processTemplate name="@vof(s:template)" />

nextPage (Accepts MScript)

The name of the page to be displayed if the execution of the process template is successful. If the maximum completion code (_maxcc)  is <= 4, then the Process Manager assumes that the overall execution is successful and displays the page specified in this element.

The value for this element can be a page name or an URL. If it is an URL and if the URL definition ends with string "_rand=" then a unique identity is appended at the end of URL before redirecting the response to it.

If MScript is used in the value, e.g. <nextPage>@vof(v:nextPage)</nextPage>, it is resolved after (not before) the execution of the process template.

The page name assigned with this element can be overridden by the processes using MScript. The following MScript code will override the current next page definition.

@set(_nextpage,'Products')

 

errorPage (Accepts MScript)

The name of the page to be displayed if the execution of the process template is not successful. If the maximum completion code (_maxcc) is > 8, then the Process Manager assumes that the overall execution was failed.

The value for this element can be a page name or an URL. If it is an URL and if the URL definition ends with string "_rand=" then a unique identity is appended at the end of URL before redirecting the response to it.

If MScript is used in the value it is resolved after (not before) the execution of the process template.

The page name assigned with this element can be overridden by the processes using MScript. The following MScript code will override the current next page definition.

@set(_errorpage,'ErrorPage1')
 

continuePage (Accepts MScript)

This element defines the name of the page to be displayed after the error page is displayed. This value is used as the hyperlink value of "Click here to continue" link on the error page. 

If MScript is used in the value it is resolved after (not before) the execution of the process template.

The page name assigned with this element can be overridden by the processes using MScript. The following MScript code will override the current next page definition.

@set(_continuepage,'index')

 

method (Accepts MScript)

The value of this element is used by the Process Manager to check the submit method of the process form for the security purpose. If value of this element is "Post" then the submit method of the process form must also be "Post". Otherwise the Process Manager stops the execution with a Service Exception.
 

debugLevel (Accepts MScript)

Assign a value between 1 and 3 to debug the execution flow of the Process Manager. The debug records printed by the Process Manager can be traced from the system console.

Note that debugging of the processes are requested individually in the processTemplate configuration.