December 16 2016

Invoking Oracle ACM from a web service call is not difficult but unfortunately is also not well documented.  I know … you’re shocked. 

To explain this as simply as possible, let’s use a Loan Origination process as a prototypical ACM example to review the high-level steps.

In this 11g process example, we’re invoking ACM from a CRM system via a web service call.  The web service will invoke a BPEL process which does the following:

  • Creates the initial record in the application database
  • Creates the ACM payload object
  • Invokes the ACM startCase service

a prototypical ACM example to review the high-level steps

 

When you first see the request schema for the ACM startCase service, it can be intimidating because of its size.  The good news is that the vast majority of this schema is entirely optional. 

vast majority of this schema is entirely optional

 

The unfortunate thing is that a few of the optional elements actually are NOT optional.  The following is what you really need:

The caseHeader element only requires one child element, the ecmFolder, which must as least be present -- even if it is empty (as shown in this example).

ecmFolder

 

In the data element, the name sub element MUST be the exact name you gave the object in the case definition.

name sub element

 

Specifically, in the ACM Case Management object, go to the “Data & Documents” tab and use what is set up under the “Name” column for the ACM Data object:

“Name” column for the ACM Data object

 

In the data element, the data sub element should contain a copy of the ACM payload data.  I know … the name of this sub element demonstrates an incredible lack of imagination and, at least to me, was a bit confusing since it mirrors the name of its parent element. 

data sub element

 

In xslt, you should use the XSLT “copy-of” Construct shown here:

the XSLT “copy-of” Construct

 

The startCase response contains the caseId element which is required for any subsequent case operations you will need to make later in the process. 

startCase response

 

That’s all folks.  It literally is just this easy to invoke an ACM process from a web service call.  In upcoming blogs, I’ll discuss other considerations that come into play in real life ACM projects as well as BPM and SOA process patterns, software development best practices and development methodologies.

Thats All Folks

 

 

About the Author

Aaron Dolan

Aaron has more than seventeen years of experience in all phases of design, development, and implementation of software applications.  He has developed and architected SOA/BPM technologies for more than twelve of those years from Fuego BPM to BEA AquaLogic BPM to Oracle SOA/BPM 11g / 12c.

Join the Conversation

aimee
May 18, 2017

Since I am a project based on oracle, this piece of information is very useful to me. From this., I got some tips to invoke Oracle ACM from a web service. Thank you for explaining it with a pictorial representation so that the concept will be clear to all. best internet provider

Enter your first name. It will only be used to display with your comment.
Enter your email. This will be used to validate you as a real user but will NOT be displayed with the comment.
By submitting this form, you accept the Mollom privacy policy.