Error :
Error occurred during initialization of VM Could not reserve enough space for object heap . Could not create the Java virtual machine.
Solution:
Go to setSOADomainEnv.cmd and change the following phrase as :
set JAVA_OPTIONS=%JAVA_OPTIONS%
set DEFAULT_MEM_ARGS=-Xms512m -Xmx768m
set PORT_MEM_ARGS=-Xms768m -Xmx1536m
Approval Management..
With the evolve of business processes and compliance, companies are emphasising on documents and approvals. Many applications use Approval Management extension (AMX) for approvals. With Oracle BPM Approval Management extension, you can define approval rules based on your business processes and decisions, such as whether to route documents to approvers in series or parallel, whether approvals should be based on employee supervisory hierarchy, position hierarchy, job levels or approval groups. You would define approval tasks in Oracle JDeveloper’s Human task editor and approvals are managed in BPM Worklist applications or BPM Workspace applications. You have used BPM workspace in the book and would be using the same application for AMX too.
INTRODUCTION
Following are the key elements that are involved in understanding and setting up approval routing rules.
An approval rule within a participant is composed of rule name, condition, list builder, list builder attributes, response type and auto actions. Rule name will identify the approval rule. Condition would indicate when the approval rule will be applied. A condition is defined based on the attributes seeded in a collection. Once the condition is satisfied, list builder would identify the type of users needed to approve or receive notification. There are many list builders supported like – Approval Group , Job level, position, supervisory and resource. Each list builder have set of properties that define it. Response type indicates if the participant are required to approve the task. If not they are FYI participants. Auto action specifies if the list builder will automatically act on tasks. The auto action value specifies the outcome to be set such as – Approve or Reject.
Say you business requirement is to generate approvers list dynamically. They have basic business fulfilment to be taken care based on Industry type and then as per business defined logics, list of approvers would be generated. Business needs to incorporate the following logic to derive approvers dynamically:
To generate list dynamically, process need to interact with enterprise database. Enterprise database would have a procedure defined to take care of the logic and to return approvers list.
To fulfil the requirement, you have to follow the following steps :
Ensure that following user are created in security realm in Oracle SOA or are available in your identity management solution :Salesbusinessanalyst1,Salesbusinessanalyst2,ITbusinessanalyst1,ITbusinessanalyst2,businessanalyst and businessanalystmanager.
Task have task metadata and assignment section of task have stages defined. There can be many participants in a stage. You can set properties on the participant to determine the routing(serial or parallel) of the task. There are two kind of participants – value based and rule based.
You have created rule based participant in Chapter 5 – Defining Assignments – Sequential Stage and Serial Participant. Rule based participants are also called Rule sets and approval routing rules are authored inside a rule set. It’s the rule sets which you would view in Oracle BPM workspace and BPM Worklist applications.
You will modify the BusinessAnalystReview task so that it would be based on Business Rules.
Enter name of list rule set as ‘DynamicApprovalGroup’
This would create Decision Service components and a rule set in it.
As it’s a Approvers list and not a FYI list, we would use the ResponseType required.
How it works.. When the process token reaches the approvals, it would be routed to the stages defined in task metadata and inside stage there are participants. You have defined participant as rule based and hence approval rule gets executed. Rule name will identify the rule and when condition gets satisfied, rule gets executed. Rule will build the participant based on list builder – Approval Group.
Approval group will be defined in the Oracle BPM workspace and it would invoke a Java class which in turns calls the PL/SQL procedure to dynamically build the list of participant. These participants will be returned to the rule and task gets assigned to these participant and based on response type it’s decided if participant will act on the task or it’s a FYI participant.
Verify Configured task..
To verify configured task you have to login to Oracle BPM workspace application with admin role. You can even change task configuration from here.
This is the task which you have modified to include the business rule for dynamic approval. Task is here as a part of process being deployed which have BusinessAnalystReview.task
To implement dynamic approval mechanism, you would follow steps –
You will create a PL/SQL procedure in enterprise database and a java class in JDeveloper or any other java editor. You have to place the java class at a globally know location specifying in SOA class path. Then you can create a Approval group and in this case you will create a dynamic approval group.
1. Create a PL/SQL procedure(named GetApprovers) in SOAINFRA schema which accepts Industry as argument and returns Approvers list
CREATE OR REPLACE
PROCEDURE GetApprovers(
INDUSTRY IN VARCHAR2,
APPROVERS OUT VARCHAR2 ) AUTHID CURRENT_USER
AS
BEGIN
IF INDUSTRY LIKE ‘SALES’ THEN
APPROVERS := ‘Salesbusinessanalyst1,Salesbusinessanalyst2’;
END IF;
IF INDUSTRY LIKE ‘IT’ THEN
APPROVERS := ‘ITbusinessanalyst1,ITbusinessanalyst2’;
ELSE
APPROVERS := ‘businessanalyst,businessanalystmanager’;
END IF;
END GetApprovers;
COMMIT;
2. Create a java class
Create a Java Class(named XXDynamicAG) which accepts Task as parameters and invokes this PL/SQL procedure – GetApprovers by passing ‘Industry’ as argument and receiving Approvers list.
For custom classes and jar ,oracle offers oracle.soa.ext_11.1.1 dir to place custom components like classes and jar files. Place your custom class @ $BEAHOME/Oracle_SOA/soa/modules/oracle.soa.ext_11.1.1/classes/XXDynamicAG.class
You would define an implementation class using the interface file IDynamicApprovalGroup.java defined in the package oracle.bpel.services.workflow.task. which contains only one public method that gets the approval group members and task object is the only input parameter.
public class XXDynamicAG implements IDynamicApprovalGroup {
public XXDynamicAG() super() }
public List getMembers(Task task) {
Element payloadElem = task.getPayloadAsElement();
String IndustryName = null;
IndustryName = getElementValue(payloadElem, “Industry”);
Register the Dynamic approval group using the BPM workspace applications
Create a Dynamic Approval Group in BPM Workspace with name – DynamicAG based on the Java Class – XXDynamicAG
Testing the Process..
When the process token reaches the BusinessAnalystReview approval task, list of approvers is build through a call to dynamic approval group which would invoke a Java class which in turns calls the PL/SQL procedure to dynamically build the list of participant. These participants will be returned to the rule and task gets assigned to these participant. As the Industry type entered in quote was ‘IT’, PL/SQL would return ITbusinessanalyst1 and ITbusinessanalyst2 users and you can verify the task assignment to these users from Oracle BPM workspace.
You can use Oracle BPM Worklist application to perform similar operations you have performed using Oracle BPM workspace applications.
Write me on continuumtransfunctioner81@gmail.com for codes.
Welcome to WordPress.com. After you read this, you should delete and write your own post, with a new title above. Or hit Add New on the left (of the admin dashboard) to start a fresh post.
Here are some suggestions for your first post.
Experimenting with Cloud, Blockchain and SOA/BPM 