ECO Workflow Approval Process Setup and Use
ECO Workflow Approval Process Setup and Use
PURPOSE
-------
This document is intended as a technical paper on ECO Workflow setup and use.
1. Section 1 Introduction
2. Section 2 Setting Up Workflow
3. Section 3 Setting Up the ECO
4. Section 4 Standard Approval Process Flow
5. Section 5 ECO Voting Activity Setup
6. Section 6 ECO Multiple Approval List Setup
7. Section 7 Alerts
8. Section 8 Release 11i(11.5.0) Notes
Engineering has an embedded standard Workflow process for ECO approvals that
does not require the installation of the full Oracle Workflow product. Workflow
Builder is required, however, because there is NO seeded default performer for
the ECO standard approval process. The standard Workflow process for ECO
approvals also allows the use of the [Submit] button on the Define ECO Form and
the use of the ECO Notifications "Inbox" Form. This Workflow process allows the
ECO to be sent to an approval list. The approvers have the option to approve or
reject the ECO before implementation.
Please reference the Workflow 2.0.3 User's Guide Part No: A56104-01 for
more detailed instructions.
a. Order the CD, Oracle Workflow Embedded Version 2.0.3 for Oracle
Applications, for Windows 95/Windows NT (Part No. A60742-01 or A34760).
b. You can order this through support on a shipping tar.
c. The Workflow development team will ONLY support version 2.0.3 for
Rel.11.0. and Rel.10.7.16.1
d. Workflow 2.5 is used for Release 11i(11.5.0)
e. The installation instructions are included on the CD readme file.
f. Follow all the installation instructions provided for Workflow.
g. Patch 1036678 is a complete synchronization patch of all Workflow 'C'
code for embedded applications workflow.
2. Setup an e-mail account for the user "Workflow". You can do this in
Unix Sendmail, Oracle Messaging, Oracle InterOffice or a Mapi-compliant
e-mail system. Use the documentation provided with the email system you
are using.
a. CONNECT username/password@<database_connect_string>
b. ACCOUNT - use the following:
1) For MAPI system: username/password
2) For Oracle InterOffice: username/password@<database_connect_string>
3) For Unix Sendmail full path to the OUTGOING mail spool file usually
located in <root> var/mail directory
� Account corresponds to the account from which the Notification Mailer
is started.
� If using Embedded version, this is the account from which you start
the concurrent manager (program).
c. NODE - The computer name from which the Notification Mailer is started.
� If you intend to use the Web part of Notifications, you must also
configure the following in the wfmail.cfg file.
a. Embedded Workflow.
� WFMAIL
� Is used on Unix platforms.
� Is used for the Embedded versions
� Is submitted using the Concurrent Request Submit Form in Sysadmin.
� Command line syntax: WFMAIL apps/pwd 0 Y <config_file> &
� wfmlr20.exe
� This program is for WINDOWS NT Server Platforms.
� It can be installed from the CD above.
� You can register this program in Oracle Apps.
� This Program must be installed and started from the MAPI
E-mail server.
� Command line syntax: wfmlr20.exe -f <config_file>
� You can start this from an icon with properties set to find the
right wfmail.cfg file.
b. Standalone Workflow.
� wfmail.snd
� This program is for standalone version using Unix Sendmail
� wfmail.ofc
� This program is for standalone version of Workflow using Oracle
InterOffice.
� The syntax for submitting the programs from the command line is:
� <xxx> where xxx is snd or ofc respectively
� wfmail.<xxx> -f <config_file>
5. Setup the concurrent programs if you are NOT using the MAPI version.
http://<server.com:port_id/<plsql_agent_virtual_path>
� Any user associated with the Admin Role will have Workflow Admin
Privileges.
� If you want all users to have Administrator Privileges, the '*' can be
used as a wildcard to enable all users.
� Edit the file as follows:
WFTKN WF_ADMIN_ROLE 0 *
@<application_short_name:[<dir>/.../]file.ext
7. Submit the concurrent programs only if NOT using the MAPI e-mail system.
2. Create the APPROVAL LIST to include the people in the list or roles for
the standard approval process. This can be any name but must also be
set as the default perfomer in the Workflow Process using Workflow Builder.
If notifications are not sent to the people in the approval lists, you need
Patch 676283 or Patch 866202, both are available for 10.7 and 11.0.
Patch 1036678 (for Release 11) is newer and contains the changes in both
676283 and 866202.
3. Create an ECO TYPE that includes the Standard Approval Process as its process.
Attach the Standard Approval Process for each priority you want to use.
a. Pick the ECO TYPE that includes the Standard Approval Process.
b. Pick the Priority attached to the Standard Approval Process when ECO TYPE
was defined.
6. If all the tables include at least one user and role, the ECO Type is setup
correctly and the ECO uses the ECO Type above, the SUBMIT button will be
"Active".
7. Click the SUBMIT button to submit the ECO to the Standard Approval Process.
� It could also be that the process is actually "Not Runnable", but this
typically is not the case.
The package ENG_WORKFLOW_API_PKG contains the procedures and functions for the
ECO Approval Workflow and is created by file engwkfwb.pls. The ECO Approval
Workflow Notification Process that is seeded in Release 11 Embedded Oracle
Applications does the following:
Function Description
--------------------------------------------------------------------------
Start * Mark start of process.
Get ECO Attributes * This activity sets pre-defined ECO attributes that
can be used by this item type. This activity is
seeded by the Oracle Engineering product.
* Gets the data from Eng_Engineering_Changes for the
ECO Number(Change_Notice), Organization Id(Org_id).
If Rejected,
* Set MRP to Inactive * This function sets MRP Active to "No" for all "Open"
or "Scheduled" revised items belonging to the ECO.
* Updates Mrp_Active to 2 (No) in Eng_Revised_Items
for Change_Notice, Org_Id and having a status_type
of 1 (Open) or 4 (Scheduled).
* Reject ECO * This function sets the ECO's Approval Status
to "Rejected" and clears out the Approval Date.
* Updates Approval_Status_Type to 4 (Rejected) and
Approval_Date to NULL in Eng_Engineering_Changes
for Change_Notice, Org_Id.
End * Marks the end of the process.
1. The default setup of the ECO Notification and Approval Process, when
setup properly, allows the first of the approvers who sends a response
to approve or reject the ECO. All other responses are ignored.
3. The voting activity can be setup using any of six different or customized
voting methods as described in the On-Line Help in Workflow Builder. Search
a. Simple Majority:
Vote Approve: 50%
Vote Reject: 50%
� If either Approve or Reject get more than 50% of the vote,
then it is the result.
c. Popularity:
Both Vote Approve and Vote Reject are NULL<blank>.
� The response with the most votes is the result.
d. Black Ball:
Vote Approve: 100%
Vote Reject: <blank>
� Any Vote for Reject is a result of Reject.
e. Jury:
Vote Approve: 100%
Vote Reject: 100%
� All must vote the same to get that result.
a. Lookup Types
b. Messages
c. Notification
d. Workflow Process
When you connect and load your ECO Approval Process in Workflow Builder,
save that definition to a file on your PC before you start to edit the
process. You then have a backup if it is ruined in testing. It can be
reloaded from a CD but why go to that trouble.
a) Lookup Types.
1) Create or review Lookup Types.
2) Review Seeded Approvals Lookup Types.
� ECO Approval (This is the seeded lookup type)
� Internal Name: ECO_Approval
� Add the following attributes.
� Percent Approve
� Internal Name: 5
� Percent Reject
� Internal Name: 4
3) Create New Voting Options Lookup Type.
� ECO Voting Options (Create New)
� Internal Name: WFECO_VOTING_OPTION
� Add the following Lookup Codes.
� Require All Votes
� Internal Name: REQUIRE_ALL_VOTES
� Tally On Every Vote
� Internal Name: TALLY_ON_EVERY_VOTE
� Wait For All Votes
� Internal Name: WAIT_FOR_ALL_VOTES
b) Messages.
1) Use the Seeded Default STANDARD_APPROVAL_MESSAGE
� Do not create a new message
� Use the seeded message
� It works with the Voting Activity.
c) Notification.
1) Create a New Notification.
� Voting Approval Notification
� Internal Name: VOTEFORRESULTTYPE
� Display Name: Vote Approve/Reject
� Description: Vote for Approve/Reject Result Type
� Function: WF_STANDARD.VOTEFORRESULTTYPE
* Voting Option
� Internal Name: VOTING_OPTION
� Type: Lookup
� Lookup Type: ECO Voting Options
� Default Value: Constant - Require All Votes
After completing testing with the above setup, if you get the
errors listed below, then you have incorrectly specified the
lookup codes and the voting activity attributes' internal names.
3109: Attribute '4' does not exist for activity '119' in
item 'ECO_APP/EC68044-511-1'.
[Error Process Error: 3116: Activity 'WFERROR/
ENG_ERROR_PROCESS' is not a runnable process.]
d) Workflow Process.
1) Copy the Standard Approval Process and name it Voting Approval
Process.
2) In the Voting Approval Process Graphics Window:
� Replace the Standard Approval Notification with the newly
created Vote Approve/Reject Notification.
� Navigate to ECO Approval Processes in the Navigator.
� Double click on Voting Approval Process. This should pop up
the Workflow Process Graphic Display window. In that window:
� Delete the ICON in the middle with the 2 arrows Marked
Approve and Reject (it looks like an envelope).
� Navigate back to the ECO Approval- Notifications.
� Expand the Notifications icon.
� Drag and drop the Vote Approve/Reject Notification icon into
the graphic window where the old one used to be: CONSTANT
� Constant as "Performer" resolves to WF_ROLES.DISPLAY_NAME
� Performer: <Your Approval List or Role> (i.e., XX-ECOList1
or Standard, etc.).
� To setup the Black Ball Voting Method mentioned above, on the
Attribute Values Tab:
� Select Vote Approve
� Enter: 100
� Select Voting Option
� Select Require All Votes in the Drop-down List
� Select Vote Reject
� leave <blank>
� Right Click and drag from the starting icon to the Vote
Approve/Reject icon. This creates the transition link.
� Right Click and drag from the Vote Approve/Reject icon to the
top right icon (the set MRP to Active function).
� When you release the mouse button, it allows you to select
Approve or
Reject.
� Select Approve.
� Right Click and drag from the Vote Approve/Reject icon to the
bottom right icon (the set MRP to inactive function).
� Select Reject.
� Save your changes to a File on your Client PC.
� Save your changes to the Database.
� Start Your new ECO Approval Process from the applications.
A user asked how to use more than one approval list for the ECO Approval
Standard Approval Process Embedded for use with Oracle Engineering if they seed
the default performer to the ONE performer (i.e., go to Workflow builder, open
the process, and set the default performer to your approval list name).
This only allows that ECO Approval Standard Approval Process to send
Notifications to ONE list as described earlier in this document. The basics of
that
process are documented below.
Where wf_roles.orig_system='ENG_LIST'
i. SAVE.
j. Close all windows back to the first flexfield window.
k. Check the checkbox for Freeze Flexfield Definition
l. Click the Compile Button.
m. Close the Form.
n. Create an ECO selecting all necessary data to submit to ECO approval
as described earlier.
o. Select the descriptive flexfield.
p. Select the Approval List you want to use and save your ECO.
q. Submit. The Workflow process should find the value in the column
ATTRIBUTE1, resolve the value to what is in the WF_ROLES.NAME field, and
use it for the default Performer.
The above Multi-Approval List flexfield setup works. There is at least one
other method available to use multiple approval list.
1. Copy the Standard Approval Process as many times as you have lists to use.
a. Seed the Approval lists, one to each copy.
b. Save the ECO Approval back to the database.
c. Create an ECO Change Type for each of those newly added processes and
attach the new process using the [Process] button.
d. When you create an ECO and want to use a different approval process,
select that ECO Change Type that is using the process in which you
seeded the Performers.
2. This method is currently untested and requires more maintenance when list
names change.
Alerts can be used as an alternate form of notification and are setup as shown
below. Alternately, the following Alerts can be setup in Alert Manager to
receive e-mail notifications:
ERROR: The approval status type 3 is invalid for ECO (the ECO you
created)since it has a workflow process associated with it.
RELATED DOCUMENTS
-----------------
� Reference Article-ID: Note 62094.1 Workflow Description, Installation, and
Configuration.
� This article has very good information related to Workflow Specific
Setup issues. It is specific