Defining a Button That Starts a Workflow Process

You can define a button on an applet that starts a Workflow Process.

To define a button that starts a Workflow Process

1. Define a Workflow Process.

2. Define a minibutton on an applet as follows:

   1. Set the Method Invoked property to a meaningful value, such as SendEmail.

   2. Define an applet user property that calls the method. Use values from the following table.

      Property	Value
      Name	Named Method n
      Value	'INVOKESVC', 'Workflow Process Manager', 'RunProcess', '"ProcessName"','"eAuction XML Bulk Upload 1"', '"RowId"', '[Id]'

   For example, the following code calls the eAuction XML Bulk Upload 1 Workflow Process and sends a pointer to the current record:

   'INVOKESVC', 'Workflow Process Manager', 'RunProcess', '"ProcessName"', 
   '"eAuction XML Bulk Upload 1"', '"RowId"', '[Id]'
   

   For more information, see the topic about the Named Method n applet user property in Siebel Developer's Reference.

3. (Optional) Use a runtime event to start this Workflow Process:

   1. Define a runtime event on the connector that emanates from the start step in the Workflow Process. Use values from the following table.

      Property	Value
      Event Object Type	Applet
      Event Object	Choose the applet where the button is defined.
      Subevent	Enter the same value that appears in the MethodInvoked property of the minibutton.
      Event Cancel Flag	TRUE

      If you use this configuration to call a Workflow Process, then it is not necessary to add the Named Method n applet user property.

   2. If you write a script for PreInvokeMethod to run on the applet or the business component, then do the following:

      • Set the event cancel flag to FALSE.

      • Write a script in the WebApplet_PreInvokeMethod event of the applet that returns CancelOperation.

      • Use the BusComp_PreInvokeMethod event of the business component that the applet references to return the CancelOperation.

4. (Optional) To resume this Workflow Process if the user pauses it, you must define the runtime event on the connector that emanates from a user interact step or from a wait step. This event is a synthetic event. For more information, see About the Synthetic Event.

   Define the runtime event using values from the following table.

   Property	Value
   Event	PreInvokeMethod
   Event Cancel Flag	True. If this flag is not checked, then an error results when the Workflow Process runs.
   Event Object	Name of the business component that the applet references. This applet contains the button.
   Event Object Type	BusComp
   Sub Event	Name of the method you set. The Sub Event name must be unique.
   Type	(Required) Condition

5. Deliver the Workflow Process.

   For more information, see Delivering a Workflow Process.

6. In the Siebel client, navigate to the Administration - Runtime Events screen, then the Events view.