45 Using SOA Composer with Domain Value Maps

Domain value maps enable you to 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. The SOA Composer now offers support for editing domain value maps at runtime. The SOA Composer is an EAR file, which is installed as part of Oracle SOA Suite installation. It enables you to manage domain value maps at runtime.

This chapter includes the following sections:

Section 45.1, "Introduction to the SOA Composer"
Section 45.2, "Viewing Domain Value Maps at Runtime"
Section 45.3, "Editing Domain Value Maps at Runtime"
Section 45.4, "Saving Domain Value Maps at Runtime"
Section 45.5, "Committing Changes at Runtime"
Section 45.6, "Detecting Conflicts"

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

45.1 Introduction to the SOA Composer

The SOA Composer enables you to work with deployed 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 45-1 shows how the SOA Composer enables you to access a domain value map from the Metadata Service (MDS) repository.

Figure 45-1 SOA Composer High-Level Deployment Topology

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

45.1.1 How to Log in to the SOA Composer

To log in to the SOA Composer:

Access the SOA Composer at the following location:
```
http://hostname:port/soa/composer
```
The SOA Composer Login page is displayed, as shown in Figure 45-2.

Figure 45-2 SOA Composer Login Page

Description of "Figure 45-2 SOA Composer Login Page"

You must authenticate yourself by entering the login ID and password.
In the Username field, enter a user name.
In the Password field, enter a password.
Click Login.

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

Figure 45-3 SOA Composer Home Page

Description of "Figure 45-3 SOA Composer Home Page"

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

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

45.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.

45.2.1 How To View Domain Value Maps at Runtime

To view domain value maps at runtime:

From the Open menu, select Open DVM.

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

Figure 45-4 Select a DVM to Open Dialog

Description of "Figure 45-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 also 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.
Select a domain value map and click Open. You can also double-click a domain value map to open it.

The selected domain value map opens in view mode.

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

45.3 Editing Domain Value Maps at Runtime

You can edit domain value maps at runtime. By default, domain value maps open in view mode. To edit a domain value map, you must change the mode to an edit session by clicking the Edit menu item.

45.3.1 How to Edit Domain Value Maps at Runtime

The domain value map opens in an edit session.

45.3.1.1 Adding Rows

To add rows:

You can add rows by performing the following steps:

Click Add Domain Values.

The Add Domain Values dialog is displayed.
Enter values and click OK.

The entered values are added to the domain value map.

45.3.1.2 Editing Rows

To edit rows:

You can edit rows by performing the following steps:

Select the row that you want to edit.
Click Edit Domain Values.

The Edit Domain Values dialog is displayed.
Edit the values as required and click OK.

45.3.1.3 Deleting Rows

To delete rows:

You can delete rows by performing the following steps:

Select the rows that you want to delete.
Click Delete Domain Values.

45.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.

45.4.1 How to Save Domain Value Maps at Runtime

To save domain value maps at runtime:

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.
Click the Revert menu item. A confirmation dialog is displayed.
Click Yes to revert your changes.

45.5 Committing Changes at Runtime

You must commit the changes for saving them permanently. Once you commit the changes, runtime picks up the changes and saves them in 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.

45.5.1 How to Commit Changes at Runtime

To commit changes at runtime:

Click the Commit menu option. A confirmation dialog is displayed.
Click Yes to commit your changes.

45.6 Detecting Conflicts

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 45-5.

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

Confirm Dialog Box for Concurrent Users of a DVM

Description of "Figure 45-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.