Using the Siebel Workflow Development Environment

This chapter describes how to use the Siebel Workflow development environment. It includes the following topics:

Preparing Siebel Tools to Develop a Workflow Process

To develop a workflow process, you begin by preparing Siebel Tools.

To prepare Siebel Tools to develop a workflow process

Set the following parameter in the Workflow section of the configuration file of the Siebel application:
```
VerCheckTime = -1
```
Setting VerCheckTime to -1 allows you to use the Publish/Activate button. Siebel CRM typically locates the configuration file in the language directory in the client. For example:
```
Siebel\81\21031\MWC\BIN\ENU\uagent.cfg
```
where:
- ENU is the language directory
- uagent.cfg is the configuration file
For more information, see Buttons You Can Use on the Workflow Task Editor Toolbar.
Log in to Siebel Tools.
Choose the View menu, Toolbars, and then the WF/Task Editor Toolbar menu item.
Choose the View menu, Toolbars, and then the Simulate menu item.
Display the object types that you use to develop a workflow process.
For more information, see Displaying Object Types You Use to Develop a Workflow Process.
If necessary, display business service objects.
For more information, see Making a Business Service Visible to a Workflow Process.

Displaying Object Types You Use to Develop a Workflow Process

This topic describes how to display the object types in the Object Explorer that you use to develop a workflow process.

To display object types that you use to develop a workflow process

Log in to Siebel Tools.
Choose the View menu, and then the Options menu item.
Click the Object Explorer tab.
Scroll down through the Object Explorer Hierarchy window to locate the Workflow Process object type, and then display it by making sure the Workflow Process object and all child objects for it contain a check mark.
Optional. Repeat Displaying Object Types You Use to Develop a Workflow Process for each of the following object types that you might use to develop a workflow process:
- Business Object
- Command
- Toolbars
- Workflow Policy Column
- Workflow Policy Object
- Workflow Policy Program
Click OK.

Locating a Workflow Process in the Workflow Processes List

This topic describes how to locate the object definition for a workflow process.

To locate a workflow process in the Workflow Processes list

Open Siebel Tools.
If necessary, display the workflow process object hierarchy.
For more information, see Preparing Siebel Tools to Develop a Workflow Process.
In the Object Explorer, click Workflow Process.
In the Workflow Processes list, query the Process Name property for the workflow process you must modify.
If the workflow process exists, then Siebel Tools displays the object definition of the workflow process in the Workflow Processes list. Querying for the workflow process in this way results in Siebel Tools displaying a single, isolated record. This configuration helps to make sure that you choose the correct workflow process in the list. It helps to make sure you modify the child objects for this workflow process rather than some other workflow process, or if you do other work, such as publishing or revising.

Displaying Properties of a Workflow Process

You can define some of properties of a workflow process, but not every property, in the Workflow Processes list, or the Properties window in the Process Designer. The Properties window in the Process Designer displays properties depending on context.

To display properties of a workflow process

Locate the workflow process you must modify.
For more information, see Locating a Workflow Process in the Workflow Processes List.
Right-click the workflow process, and then choose Edit Workflow Process.
Click the canvas, making sure no workflow process step or connector is chosen.
Choose the View menu, Windows, and then the Properties Window menu item.

Using the Process Designer

This topic describes how to use the Process Designer to define a workflow process in Siebel Tools.

The following image includes the elements of the Process Designer.

Explanation of Callouts

The Process Designer includes the following items:

Process Designer Canvas. A work area where you create the workflow process. You right-click the canvas to access a context-sensitive menu that allows you modify the workflow process that Siebel Tools displays on the canvas.
Workflow Designer Palette. A window that contains icons that represent the various step types you can add to a workflow process. To add a step, you drag, and then drop an icon from the palette to the canvas.
Multi Value Property Window (MVPW). A window that allows you to define properties for a workflow process and arguments for a workflow process step. For more information, see Using the Multi Value Property Window.
Properties Window. A window that allows you to define properties for an individual workflow process step or for the overall workflow process. The window is context-sensitive:
- If you choose a step or connector, then Siebel Tools displays properties for this step or connector in the Properties window.
- If no step or connector is chosen, then Siebel Tools displays properties for the workflow process in the Properties window.
For more information, see Overview of Workflow Process Steps.

Functionality of the Process Designer

You can do the following work in the Process Designer:

Copy and paste. Copy and paste objects in the canvas.
Edit shape properties and layout. Define shape colors and other attributes, such as the look of the line, the fill pattern, and the font for labels. You can align shapes and make shapes the same size and color as other shapes in the workflow process.
Zoom. Zoom in and out on the canvas to view the workflow process at various magnifications.
Copy drawings. Copy a workflow process into another application, such as a Microsoft Word document. You can right-click the canvas, and then click Copy Drawing.
Print. Print the workflow process.
Hide connector names. You can hide the names of connectors and error exception connectors. Hiding a connector name can be helpful to clarify the meaning of the conditional branching that emanates from a start step or a decision point.

Copy and paste functionality in the Process Designer works the same as it does in a typical Windows application. For example, you can use the CTRL+C and CTRL+V keyboard combinations.

Making a Workflow Process Editable

The canvas color in the Process Designer indicates that the workflow process is editable:

A white canvas with a grid indicates that you can edit the workflow process
A yellow canvas indicates that you cannot edit the workflow process

If a workflow process is editable, then you can modify it in a variety of ways, such as adding and removing steps and connectors, or changing step and connector properties. For more information, see Using the Process Designer.

To make a workflow process editable

Make sure the workflow process is checked out or is locked by the developer who is currently attempting to edit the workflow process.
Make sure the project that is defined in the Project property for the workflow process is locked.
If the workflow process is a seed workflow process, then make a copy of this seed workflow process, and then edit the copy.
For more information, see Examining Seed Workflow Processes.
If you still cannot edit an existing workflow process, then export the workflow process to your desktop, and then import it.
Siebel CRM increments the Version property for the editable version by 1. For more information, see Importing and Exporting a Workflow Process.

Data That a Workflow Process Can Access During Configuration

The data objects that are available for use as you design your workflow process originate in the Siebel repository. A change in the repository data is immediately available for you to use in a workflow process. You can use configuration data, such as a business component field or other repository information, while you create your workflow process. Consider the following examples:

Assume a List of Values (LOV), such as Account Status, contains values of Gold, Silver, and Bronze. You can use a newly added LOV in a decision condition of your workflow process while you define it.
If you add a new field to a business component, then this new field is immediately available in the Process Designer.

Run-time data is not available for you to use while you define a workflow process, such as an account name, ZIP code, or other transactional data. To use run-time data when you define a workflow process, you can make the data available through a process property. If necessary, you can use an unbounded drop-down list to hard code run-time data into your workflow process. For more information, see Using Process Properties.

Using the Workflow Task Editor Toolbar

You can use the WF/Task Editor Toolbar to deploy a workflow process. The following include this toolbar.

For information about publishing and activating a workflow process, see Process of Deploying a Workflow Process.

Buttons You Can Use on the Workflow Task Editor Toolbar

The following table describes buttons that you can use on the WF/Task Editor Toolbar. If you hover the mouse over a toolbar icon, then Siebel Tools displays a small pop-up message that identifies the button.

Table Buttons on the WF/Task Editor Toolbar

Button Name	Description
Publish	Moves the definition of a workflow process from the repository tables into the run-time tables of the Siebel client. If you click Publish, then Siebel Tools changes the status of the workflow process from In Progress to Completed, and then makes it available in the following situations: If you are connected to the Siebel Server data source, then you can activate this workflow process at run time. If you are connected to the local data source, then you must check in this workflow process, and then activate it at run time.
Publish/Activate	Publishes and activates the workflow process while in local mode. If you use Publish/Activate instead of Publish, then it is not necessary to separately activate this workflow process in the client. To use this feature, you must set the VerCheckTime parameter to -1 (negative 1). This parameter resides in the Workflow section of the configuration file. For more information, see Preparing Siebel Tools to Develop a Workflow Process. For more information, see Activating a Workflow Process.
Revise	Creates a new version of the workflow process for editing. Siebel Tools displays this new version in the Workflow Processes list with the version property incremented by 1. For more information, see Revising a Workflow Process.
Expire	Sets the status for the workflow process to Not In Use. If you expire a workflow process, then you can no longer edit, publish, or activate it. You can revise it.

Displaying the Workflow Task Editor Toolbar

You must display the WF/Task Editor Toolbar the first time you use it. For more information, see Preparing Siebel Tools to Develop a Workflow Process.

Validating a Workflow Process

If you click Publish or Publish/Activate in the WF/Task Editor toolbar, then Siebel Tools validates the workflow process before it publishes this workflow process. For more information, see Validate Tool.

Deploying a Workflow Process Beginning with Siebel CRM Version 8.0

Beginning with Siebel CRM version 8.0, if you set the VerCheckTime parameter in the Workflow section of the .cfg file to -1 ([Workflow] VerCheckTime = -1), then you can activate a workflow in Siebel Tools. For more information, see Preparing Siebel Tools to Develop a Workflow Process.

Beginning with Siebel CRM version 8.0, you can use the you can use the Publish and Publish/Activate buttons to deploy a workflow process. The following occurs in releases prior to Siebel CRM Version 8.0:

You must use the Deploy button in Siebel Tools and you must activate the workflow process in the Siebel client.
If no validation errors occur, then Siebel Tools does not display the Validate dialog box or the message that states the validation was successful. If no error occurs, then the validation runs implicitly without visibility to you.

Copying Instead of Revising a Workflow Process

In some situations, you can copy an existing workflow process rather than revising it. The copy feature allows you to continue to work on the original workflow. For an example, see Modifying the Existing Workflow Process.