Bookshelf v7.5: Creating Buttons that Invoke Workflow Processes

Siebel Business Process Designer Administration Guide > Designing Workflow Processes > Using Runtime Events >

Creating Buttons that Invoke Workflow Processes

To create a button that invokes a workflow process

From Siebel Tools, configure a button on an applet and specify the MethodInvoked property. For more information, see Siebel Tools Reference.

To enable the button, override the PreCanInvokeMethod property. Next, edit the server script and compile your changes to the Siebel repository file. The following example is specific to Siebel VB:

Function WebApplet_PreCanInvokeMethod (MethodName As String, CanInvoke As String) As Integer

If MethodName = "<Name>" Then

CanInvoke = "True"

WebApplet_PreCanInvokeMethod = CancelOperation

Else

WebApplet_PreCanInvokeMethod = ContinueOperation

End If

End Function

Define a workflow process. To invoke this workflow process from a button click, specify a runtime event in one of the following ways:

To start this workflow process, specify the runtime event on the Start step on a Condition branch.

To resume this workflow process (if it has been paused) from a button click, specify the runtime event in a User Interact step or a Wait step on a Condition branch.

The fields values are described in Table 34.

Table 34. Runtime Event Field Values
Field	Value
Event Object Type	BusComp
Event	PreInvokeMethod
Event Object	Name of the business component on which the applet that contains the button is based.
Sub Event	Name of the method set in step one. The Sub Event name must be unique.
Event Cancel Flag	True. If this flag is not checked, the error "The specialized method <Method Name> is not supported on this business component" will result when running the workflow process.

NOTE: If users click the button when there are no workflow process instances waiting, they will receive the error message "Cannot resume process <Process ID> for object <Object ID>". You can prevent this error by requiring users to run a workflow process in order to access this view. For example, you can set up a workflow that includes the User Interact step. You can handle the error by defining an Error Exception branch or error process.

After you create the workflow process, activate the process and reload personalization. To reload personalization, navigate to Site Map > Runtime Events Administration > Events, and then select Reload Personalization from the applet menu. You must reload personalization after activating a workflow process that registers any runtime events in order for the process to take effect.