This chapter tells you how to test your workflow definitions using the Developer Studio.
This chapter covers the following topics:
The Developer Studio lets you view workflow definitions stored in your database. If you have workflow administrator privileges, you can also run a test workflow process for a workflow definition. Workflow administrator privileges are assigned in the Workflow Configuration page. See: Setting Global User Preferences, Oracle Workflow Administrator's Guide.
Although you can run a test workflow process against any Oracle Workflow database, it is recommended that you create a separate environment for testing purposes. You should set up test users and roles in your test environment before you begin.
Note: If you plan to use email to view notifications, you can send all notifications to a single email address by setting an override address for a notification mailer in its Component Details page in Oracle Applications Manager. See: Reviewing Service Component Details, Oracle Workflow Administrator's Guide.
To Search for Workflow Definitions in the Developer Studio
Use a Web browser to navigate to the Developer Studio, using a responsibility and navigation path specified by your system administrator. See: Oracle Workflow Developer Navigation Paths.
Search for the workflow definitions you want to review. The search criteria are:
Workflow Type - Select the workflow item type you want to review. The display name for the workflow type you select populates the Workflow Type field, and the internal name for the workflow type you select populates the Type Internal Name field.
Type Internal Name - Enter the internal name of the workflow type you want to view, if you want to enter the internal name directly instead of selecting a value. You can enter a partial value to search for workflow types whose internal names begin with that value.
If you have workflow administrator privileges, you can run a test workflow process by selecting the run icon for that workflow definition. See: To Run a Test Workflow Process.
Note: If a workflow definition does not include any runnable processes, its run icon is disabled.
Additionally, if a workflow process begins with a Receive event activity, you cannot use the Developer Studio to test the process. Instead, you should raise a test event from the Event Manager to trigger an event subscription that launches the process. See: To Raise a Test Event.
To Run a Test Workflow Process
In the Workflow Identifier region, specify the identifying details for the workflow process you want to run.
Workflow Owner - Optionally specify an owner for the process. The default value is your user name.
Note: If an administrator has configured restrictions for the user list of values, then only the values to which you have access appear in the list. See: Configuring the Oracle Workflow User List of Values, Oracle Workflow Administrator's Guide.
Note: If the WF: Disable Reassign to Submitter profile option is set to Yes, then Oracle Workflow does not allow notifications within a process to be reassigned to the process owner.
Item Key - A unique item key to identify the process instance.
Note: The item key for a process instance can only contain single-byte characters. It cannot contain a multibyte value.
User Key - An optional user-friendly identifier that you can use to locate the workflow process in the Status Monitor and other Oracle Workflow user interface components.
Process - The name of the workflow process to test. If the workflow item type includes only one runnable process, Oracle Workflow automatically displays that process. If the workflow item type includes more than one runnable process, select the process that you want to test.
The Workflow Attributes region displays any item attributes associated with the workflow item type. Enter values for any item attributes that are required to initiate the process.
Select the Run Workflow button. To initiate the workflow process, the Run Workflow page calls the Workflow Engine CreateProcess() and StartProcess() APIs for the specified workflow item type and item key. It also calls the Workflow Engine SetItemOwner() and SetItemAttr() APIs to set the process owner and all the item type attributes to the specified values.
To view the status of the workflow process, select Status Monitor in the top level menu and search for the process in the Workflows search page. See: Accessing the Administrator Monitor, Oracle Workflow Administrator's Guide.
If the process you are testing includes notifications, select Notifications in the top level menu to view and respond to the notifications in the Worklist. See: To View Notifications from the Advanced Worklist, Oracle Workflow User's Guide.
Alternatively, if you have set the notification preference of the recipients to receive email notifications and the messages are eligible to be sent by email according to the settings in the Email Notification Preference field in the Workflow Configuration page, you can use an email reader to view and respond to the notifications. If you specified an override email address for the notification mailer, you can connect to that email account to access all notifications for the process. See: Reviewing Notifications via Electronic Mail, Oracle Workflow User's Guide and Setting Global User Preferences, Oracle Workflow Administrator's Guide.