SOA Suite 12c: Using Domain Value Map (DVM) in Service Bus projects

Read Time:2 Minute, 26 Second

Domain Value Maps are still DVMs in SOA Suite 12c. Create them in JDeveloper, use them in Transformations and Assignments in Mediator and BPEL. Inspect them and edit them at run time using SOA Composer. Nothing really new there.

What is new:

In 12c, we can use XQuery in BPEL and Mediator – and in these XQuery functions we can use Domain Value Map as well.
In 12c, we can use both XQuery and XSL Map in Service Bus – and here we can use Domain Value Maps as well
In 12c, we can inspect and edit Domain Value Maps also at runtime in the Service Bus Design Composer/Console
In 12c, we can create Domain Value Maps in Service Bus projects, publish them to the MDS Design Time Repository as well as import them into Service Bus projects from that repository

So as of now, in SOA Suite 12c we can leverage Domain Value Map from Service Bus components.

Let’s see what this all looks like:

Create a new resource in a Service Bus project, of type Domain Value Map:

Define the name, the domains (columns) and a first sample of domain/column values:

Press OK and the Domain Value Map editor is opened:

When the DVM is defined, it can be used – in XSLT Map, in XQuery – as shown here –

and in expressions, configured using this XQuery expression editor:

Publishing to and Importing from the SOA Design MDS Repository

The DVM can also be published to the Designtime MDS Repository:

Let’s create a new directory in the MDS repository:

and call it DomainValueMaps:

Press OK, press Next:

Press Finish

And after refreshing the MDS connection

The new resource is visible and available:

When you want to make use of the DVM in another Service Bus project, you use the context menu option Import Resource.

Run time inspecting and editing of the Domain Value Map in the Service Bus Console

Note: when the Service Bus project has been deployed, the Domain Value Map is deployed as part of the Service Bus project. It is accessible through the Service Bus Design Composer tool – for inspection and even for run time editing:

Sharing the Domain Value Map with other projects through the Design Time MDS Repository

The Domain Value Map can also be published to the Designtime MDS Repository, to make it available to other projects – both Service Bus and SOA composite:

Let’s create a new directory in the MDS repository:

and call it DomainValueMaps:

Press OK, press Next:

Press Finish

And after refreshing the MDS connection

The new resource is visible and available:

When you want to make use of the DVM in another Service Bus project, you use the context menu option Import Resource.

If you want to refer to a resource in the MDS repository from a SOA composite application, you can browse for the resource in the standard browse dialog:

About Post Author

Lucas Jellema

Lucas Jellema, active in IT (and with Oracle) since 1994. Oracle ACE Director and Oracle Developer Champion. Solution architect and developer on diverse areas including SQL, JavaScript, Kubernetes & Docker, Machine Learning, Java, SOA and microservices, events in various shapes and forms and many other things. Author of the Oracle Press book Oracle SOA Suite 12c Handbook. Frequent presenter on user groups and community events and conferences such as JavaOne, Oracle Code, CodeOne, NLJUG JFall and Oracle OpenWorld.

lucas.jellema@amis.nl

https://www.amis.nl/