48 Using Oracle SOA Composer with Domain Value Maps

This chapter describes how to modify domain value maps for an Oracle SOA Suite project at runtime using Oracle SOA Composer. Domain value maps let you map values from one vocabulary used in a given domain to another vocabulary used in a different domain.

In earlier releases, for editing a domain value map at runtime, you first had to make the changes in Oracle JDeveloper, and then redeploy the domain value map in the application server. Oracle SOA Composer now offers support for editing domain value maps at runtime.

This chapter includes the following sections:

• Section 48.1, "Introduction to Oracle SOA Composer"

• Section 48.2, "Viewing Domain Value Maps at Runtime"

• Section 48.3, "Editing Domain Value Maps at Runtime"

• Section 48.4, "Saving Domain Value Maps at Runtime"

• Section 48.5, "Committing Changes at Runtime"

• Section 48.6, "Detecting Conflicts"

For more information about domain value maps, see Chapter 47, "Working with Domain Value Maps."

48.1 Introduction to Oracle SOA Composer

Oracle SOA Composer is an EAR file that is installed as part of the Oracle SOA Suite installation. Oracle SOA Composer enables you to manage deployed domain value maps during runtime without needing to redeploy the project that uses the domain value maps. Domain value map metadata can be associated either with a SOA composite application, or it can be shared across different composite applications. Figure 48-1 shows how Oracle SOA Composer lets you access a domain value map from the Metadata Service (MDS) repository.

Figure 48-1 Oracle SOA Composer High-Level Deployment Topology

Description of "Figure 48-1 Oracle SOA Composer High-Level Deployment Topology"

48.1.1 How to Log in to Oracle SOA Composer

To log in to Oracle SOA Composer:

1. Access Oracle SOA Composer at the following location:

   http://hostname:port/soa/composer
   

   The Oracle SOA Composer Login page appears, as shown in Figure 48-2.

   Figure 48-2 Oracle SOA Composer Login Page

   
   Description of "Figure 48-2 Oracle SOA Composer Login Page"
   
   

   You must authenticate yourself by entering the login ID and password.

2. In the Username field, enter a user name.

3. In the Password field, enter a password.

4. Click Login.

After you log in to Oracle SOA Composer, you see the Oracle SOA Composer home page, as shown in Figure 48-3:

Figure 48-3 Oracle SOA Composer Home Page

Description of "Figure 48-3 Oracle SOA Composer Home Page"

You must have the SOADesigner application role to access Oracle SOA Composer metadata. By default, all the users with Oracle Enterprise Manager Fusion Middleware Control administrator privileges have this role. If you log in to Oracle SOA Composer without this role, you see the following message:

Currently logged in user is not authorized to modify SOA metadata.

For information about adding the SOADesigner application role to users without administrator privileges, see Oracle Fusion Middleware Administrator's Guide for Oracle SOA Suite and Oracle Business Process Management Suite.

48.2 Viewing Domain Value Maps at Runtime

You can view domain value maps at runtime. Perform the following steps to open and view a domain value map.

48.2.1 How To View Domain Value Maps at Runtime

To view domain value maps at runtime:

1. From the Open menu, select Open DVM.

   The Select a DVM to open dialog appears, as shown in Figure 48-4:

   Figure 48-4 Select a DVM to Open Dialog

   
   Description of "Figure 48-4 Select a DVM to Open Dialog"
   
   

   You can also select a document from the My Edits option that displays recently opened documents.

   Note:

   Alternatively, you can search for a domain value map by entering the name of the composite application containing the domain value map file in the Search composite field and then clicking the Search icon to the right of the field.

2. Select a domain value map and click Open, or just double-click a domain value map to open it.

   The selected domain value map opens in view mode.

To get a direct link to the selected domain value map, click Bookmarkable Link. The Info button provides more information on the selected domain value map.

48.3 Editing Domain Value Maps at Runtime

You can edit domain value maps while the applications using the domain value map are running.

48.3.1 How to Edit Domain Value Maps at Runtime

By default, domain value maps open in view mode. Once you change to edit mode, you can modify row information. When you finish making changes, be sure to save and commit them as described in Section 48.4.1, "How to Save Domain Value Maps at Runtime" and Section 48.5.1, "How to Commit Changes at Runtime."

48.3.1.1 Changing to Edit Mode

To change to edit mode:

1. Open the domain value map for viewing, as described in Section 48.2.1, "How To View Domain Value Maps at Runtime."

2. In the SOA Composer menu, click Edit.

   The domain value map opens in edit mode.

48.3.1.2 Adding Rows

To add rows: 

You can add rows by performing the following steps:

1. Click Add Domain Values.

   The Add Domain Values dialog appears.

2. Enter values and click OK.

   The entered values are added to the domain value map.

48.3.1.3 Editing Rows

To edit rows: 

You can edit rows by performing the following steps:

1. Select the row to edit.

2. Click Edit Domain Values.

   The Edit Domain Values dialog appears.

3. Edit the values as required and click OK.

48.3.1.4 Deleting Rows

To delete rows: 

You can delete rows by performing the following steps:

1. Select the rows to delete.

2. Click Delete Domain Values.

48.4 Saving Domain Value Maps at Runtime

Every time a domain value map is opened in an edit session, a sandbox is created per domain value map, per user. If you save your changes, then the changes are saved in your sandbox.

48.4.1 How to Save Domain Value Maps at Runtime

To save domain value maps at runtime:

1. Click the Save menu item to save your changes. If your changes are saved successfully, you receive a notification message.

   You can also revert a domain value map to the last saved state.

2. Click the Revert menu item. A confirmation dialog is displayed.

3. Click Yes to revert your changes.

48.5 Committing Changes at Runtime

You must commit the changes you make to domain value maps in order to save and have them picked up by the runtime and be saved permanently to the MDS repository. In a session, you can also save your changes without committing them. In such a case, the domain value map remains in the saved state. You can reopen the domain value map and commit the changes later.

48.5.1 How to Commit Changes at Runtime

To commit changes at runtime:

1. Click the Commit menu option. A confirmation dialog is displayed.

2. Click Yes to commit your changes.

48.6 Detecting Conflicts

Oracle SOA Composer detects conflicts that can occur among concurrent users. If you open a domain value map that is being edited by another user, then you see a warning, as shown in Figure 48-5.

Figure 48-5 Confirm Dialog for Concurrent Users of a Domain Value Map

Description of "Figure 48-5 Confirm Dialog for Concurrent Users of a Domain Value Map"

However, if you still want to edit the domain value map, you can click Yes and make the modifications.

If the other user makes changes to the domain value map and commits the changes, you receive a notification message while trying to commit your changes.

If you click Yes and commit your changes, then the changes made by the other user are overwritten by your changes.