Bookshelf Home | Contents | Index | PDF |
Siebel Business Process Framework: Workflow Guide > About Workflow Process Steps and Connectors > About Workflow Process Step Types > About the Stop StepThe Stop step is used to raise an error to the user and terminate the workflow process instance. The main parts of creating a Stop step for a workflow process are: NOTE: When using a Stop step in a subprocess within a workflow process, the Stop step stops the subprocess and it also stops the parent, invoking process. It is not necessary for you to configure a Stop step within the parent process to stop subprocess logic from executing. Table 20 describes the way the Stop step is handled, depending on how it is called and in which object manager it is running.
Defining a Stop StepThis topic describes how to define a stop step. Perform the procedure described in Adding a Step to a Workflow Process with the following modifications:
Invoking the Stop StepIt is recommended that the Stop step be used only in a workflow process invoked from a script. For example, consider a workflow process that displays a custom error message in a stop step. When the workflow is run, the custom error message is displayed that includes stack information that you need to suppress. It is not possible to suppress stack information with a stop step. However, a workflow process invoked from a script can have an end step that defines the error message in a process property. When the workflow encounters the required condition, the process property that contains the error message is sent. Since the subsequent step is an end step that does not display any messages, control is returned to the calling script that checks for the value set in the process property, then uses RaiseErrorText() to display the message. The error dialog displays the error text but does not display workflow or stack trace information. Defining a Custom Error Message with the Stop StepIf none of the predefined error messages provided in the Error Code property on the Stop Step meet your requirements, you can define a custom error message on the Stop step. To define a custom error message on the Stop step
Defining Multiple Custom Error MessagesSeveral customizable codes are available in the Error Code property on the stop step. These are indicated by WF_ERR_CUSTOM_x. Since each WF_ERR_CUSTOM_x is unique, it can only be used once. If you need to display multiple custom error messages, use WF_ERR_CUSTOM_2, WF_ERR_CUSTOM_3, and so forth, instead of using %1, %2 for the same WF_ERR_CUSTOM_x. |
Siebel Business Process Framework: Workflow Guide | Copyright © 2008, Oracle. All rights reserved. | |