Opening and Saving Item Types
All processes are associated with an item type. An item type can include one or more processes. You can save an item type to a database or to a flat file. When you save your work to a database, you actually save everything in the current data store that has been modified. When you save your work to a flat file, you actually save everything in the current data store to the file. You can also load an item type into Oracle Workflow Builder from a database or flat file. Opening an item type automatically retrieves all the attributes, messages, lookups, notifications, functions and processes associated with that item type.
Attention: Always save a copy of your workflow process definition as a flat file and check that file into a source control system to maintain a working version of your process definition. Avoid using the process definition stored in your database as your source controlled version, as others with access to the database can update the definition.
To Access Process Definitions in an Existing Data Store:
1. To start Oracle Workflow Builder, double-click on the Oracle Workflow Builder icon in the Oracle for Windows NT or Oracle for Windows 95 program group. If you are using Windows 95 or NT 4.0, you can also select the Oracle Workflow Builder icon from the appropriate program folder from the Start menu. In Oracle Workflow Builder, select Open... from the File menu.
2. Select database or file to connect to the source containing the item type that your process definition is associated with.
3. To open a File: Provide the complete file path and choose OK, or use Browse to locate and open the file (extension .wft).
Note: You can also drag and drop a .wft file from the Microsoft Windows 95 or Windows NT 4.0 Explorer or Microsoft Windows NT File Manager into the navigator tree to open that file in Oracle Workflow Builder.
4. To open a Database connection: Enter the username and password for the database. Enter the name of the database alias or connect string and choose OK.
6. If multiple item types exist in the data store, the Show Item Types window appears. Select from the Hidden list, the item type(s) you want to view, and choose <<Show to move it into the Visible list. Choose OK to load these item types into the navigator tree.
7. If at any time you want to view and modify item types that are hidden in the current data store, you can double-click on the Hidden Item Types branch in the navigator tree to display the Show Item Types window and select the item types you want to show. You can also choose Show/Hide Item Types from the File menu to display the Show Item Types window.
8. When you finish working, choose Save from the File menu to preserve your changes and make them effective immediately.
When you use the Save command, you save all modified objects in the currently selected data store (even those that are hidden) back to that data store. If you want to save only specific item types, then you must create a new data store, and copy the specific item types you want to save into the new store and save the new store.
Note: When you copy item types to the new store, you may get validation errors due to foreign key references. You should pay attention to these errors as they may indicate that you need to also copy other item types into the new store to resolve the foreign key references.
Attention: Oracle Workflow Builder can save your work to the database using one of two modes. In the "About Oracle Workflow Builder" dialog box from the Help menu, there is a check box called "Allow modifications of customized objects". If you check this check box, Oracle Workflow Builder saves your edits in 'upload' mode, overwriting any protected objects that you have access to modify and as well as any previously customized objects. If you uncheck this check box, Oracle Workflow Builder runs in 'upgrade' mode and will only save edits to protected objects that you have access to change and will not overwrite objects that have been previously customized. These two modes match the upgrade and upload behavior of the Workflow Definitions Loader program. See: To Set the Access Level for an Object and Using the Workflow Definitions Loader.
Note: If you save your work to a database with a future effective date, and then in the same Oracle Workflow Builder session, continue to modify your process and later choose Save from the File menu, you automatically save the process definition to the same database using the previously specified effective date.
10. Use Close Store from the File menu to close your connection to the current database or file data store. You are prompted to save your work.
11. Choose Exit from the File menu to exit Oracle Workflow Builder.
Attention: The Close Store and Exit options from the File menu are enabled only when the Navigator window is the current window.
To Start Oracle Workflow Builder from the MS-DOS Prompt:
Rather than starting Oracle Workflow Builder by double-clicking on its Windows icon, you can also type in a command at the MS-DOS prompt and specify the file or database to connect to.
1. In an MS-DOS prompt window, type the following command to start Oracle Workflow Builder with a specific workflow data file, where <filename.wft> represents the full path and name of the data file:
wfbldr20 <filename.wft>
2. To start Oracle Workflow Builder with a specific database connection, type the following command at the MS-DOS prompt, where <username/password@connect> represents the database account information to connect to:
wfbldr20 -c <username/password@connect>
Note: If you run Oracle Workflow Builder in Microsoft Windows 95 or Windows NT 4.0, you can also double-click on a workflow data file (.wft) from the Windows Explorer to automatically open that file and start Oracle Workflow Builder.
3. To start Oracle Workflow Builder and open a specified item type in a data store, append the following to the appropriate command shown in Step 1 or 2, where <item_type> represents the internal name of the item type you want to open:
-E <item_type>
wfbldr20 wfdemo.wft -E wfdemo
4. To start Oracle Workflow Builder and open a specified process diagram in a data store, append the following to the appropriate command shown in Step 1 or 2, where <item_type:process> represents the internal names of the item type and process you want to open:
-E <item_type:process>
wfbldr20 wfdemo.wft -E WFDEMO:NOTIFYAPPROVER
See Also
Using the Workflow Definitions Loader
Creating a Shortcut to a Workflow Process