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:
For more information about domain value maps, see Chapter 47, "Working with Domain Value Maps."
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.
Access Oracle SOA Composer at the following location:
The Oracle SOA Composer Login page appears, as shown in Figure 48-2.
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.
After you log in to Oracle SOA Composer, you see the Oracle SOA Composer home page, as shown in Figure 48-3:
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.
You can view domain value maps at runtime. Perform the following steps to open and view a domain value map.
From the Open menu, select Open DVM.
The Select a DVM to open dialog appears, as shown in Figure 48-4:
You can also select a document from the My Edits option that displays recently opened documents.
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.
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.
You can edit domain value maps while the applications using the domain value map are running.
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."
Open the domain value map for viewing, as described in Section 48.2.1, "How To View Domain Value Maps at Runtime."
In the SOA Composer menu, click Edit.
The domain value map opens in edit mode.
You can add rows by performing the following steps:
Click Add Domain Values.
The Add Domain Values dialog appears.
Enter values and click OK.
The entered values are added to the domain value map.
You can edit rows by performing the following steps:
Select the row to edit.
Click Edit Domain Values.
The Edit Domain Values dialog appears.
Edit the values as required and click OK.
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.
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.
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.
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.
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.