Most of what you do in the Oracle Service Bus Console is done within an open session. Once you make your changes to Service Bus components and projects, resolve any conflicts, and are ready to propagate the changes to the runtime, you can activate the session. Sessions allow team collaboration when services and metadata are being configured in Service Bus. Each team member works in a sandbox session until they are ready to check in the working configuration to the core configuration of the bus. Sessions provide multiple levels of undo, and visibility into conflicts, as multiple users work on the configuration.

The available options on each page vary depending on whether you are in a session. For example, you cannot edit resources outside of a session, and you can only test services when you are working outside of a session. Also, in a session, the Changes page that appears when you open the History tab lists all the changes you have made in that session; outside a session, the page lists no changes.

The Oracle Service Bus Console lists all projects, folders, and resources in the Project Navigator in a tree view. Selecting any component in the navigator displays its configuration in an editor. Most editors are divided into tabbed pages, each of which let you configure specific types of properties. Figure 2-1 shows an example of a proxy service displayed in the Proxy Service Definition Editor. The top toolbar provides links to Fusion Middleware Control, and online help topics. The editor toolbar lets you save changes, view information about the displayed component, launch the Test Console or Pipeline Editor, and export the WSDL file on which a service is based.

Figure 2-1 Proxy Service Configuration on the Oracle Service Bus Console

Description of "Figure 2-1 Proxy Service Configuration on the Oracle Service Bus Console"

By selecting any of the auxiliary tabs from the Tools icon, you can view conflicts and a history of changes and activations. Use these tabs to resolve conflicts before activating changes, and to undo actions or even session activations. Figure 2-2 shows the Tools menu expanded and Figure 2-3 shows the History tab with the Changes subtab selected.

Figure 2-2 Expanded Tools Menu

Description of "Figure 2-2 Expanded Tools Menu"

Figure 2-3 History Tab with Changes Subtab Selected

Description of "Figure 2-3 History Tab with Changes Subtab Selected"

The Project Navigator organizes configurations and resources into projects and folders. You can view all the projects in a domain on the All Projects Definition Editor; all the resources in a project on the Project Definition Editor; and all the resources in a folder on the Folder Definition Editors. On the Project and Folder Definition Editors, you can also take actions against resources, such as launching the Test Console or launching the Pipeline Editor. Click the name of a project, folder, or resource on any of these editors to display the editor for that component.

All Service Bus resources, such as services, WSDL files, and XQuery transformations, reside in only one project. Projects do not overlap. Resources can be created directly under a project, or they can be further organized into folders. However, you can reference any resource regardless of the project in which it resides.

When you create a domain in Service Bus, a default project is automatically created.

The components you create in Service Bus are known as resources. Resources can include proxy and business services that defines the endpoints of the service, and pipelines and split-joins that define the message processing logic for the service. Resources also include supporting resources, such as service accounts, WSDL documents, JNDI providers, MQ connections, and so on. Resources are stored in the projects and folders in which they are created. Some resources can be shared among different projects.

Each type of resource can be configured using an editor in the console that is specific to that type of resource. When you open a resource from the Project Navigator, that resource's definition editor appears, and you can configure the properties for the resource. The definition editors have a standard set of tools in the upper right toolbar, including Save, Save All, Help, Close, and Close All. In addition, each editor includes tools specific to the resource being configured. These tools allow you to perform additional tasks, like launch the Test Console, launch the Pipeline Editor, export a WSDL file, view references, and so on. The following figure shows the Proxy Service Definition Editor.

Figure 2-5 Proxy Service Definition Editor

Description of "Figure 2-5 Proxy Service Definition Editor"

1. Start the Service Bus domain.
2. When the server starts, enter one of the following URLs in your browser:

   http://hostname:port/servicebus
   

   or, for SSL:

   https://hostname:port/servicebus
   

   where hostname represents the name of the Service Bus Admin Server and port represents the port number on which it is listening.

   The login page appears.

3. Enter the user name and the password you specified during installation.
4. Click Login.

Before making any changes to your Service Bus projects in the Oracle Service Bus Console, you must start a new session or edit an existing session using the buttons in the Sessions toolbar. These buttons change depending on the state of the session. If there is no active session, the Edit button in the figure below is Create. If you are working in a session, the Edit button is Activate.

Figure 2-6 Sessions Toolbar

Description of "Figure 2-6 Sessions Toolbar"

To create a session:

1. Do one of the following:

   • To begin a new session, click Create.

   • To modify an existing session, click Edit.

   The name of the session appears in the upper left corner of the screen.

2. Make your changes within the session.
3. For each component you change, click Save.
4. To discard the changes you made in the current session, click Discard.
5. When you are done making changes, activate the session as described in How to Activate a Session.

1. Once you finish making changes for a session, click Activate.
2. If there are no validation errors, skip to step 5.
3. If there are validation errors, an error message appears. View and fix configuration conflicts before you proceed.

   If new conflicts arise while you view the existing conflicts, a message appears informing you of the new conflicts.

4. Once all conflicts are resolved, click Activate again.
5. In the Description field, enter a brief description to identify the session. This is displayed in the Description column when you to view the history of configuration changes caused by session activations.
6. To complete the activation, click Activate. If no new conflicts have arisen in the interim, the session ends and the configuration is deployed to the runtime.

1. In the Search field next to the Designer tab, enter the name of the proxy service, business service, pipeline, or split-join you want to find, and then click the Search icon.

   The results of your search appear on the Search Results tab.

   Figure 2-7 Service Search Results Tab

   
   Description of "Figure 2-7 Service Search Results Tab"
2. To view the results in a full page, click Detach.
3. To change your view options, see How to Customize Table Views.

Use the Project and Folder Definition Editors to view information about the projects, folders, and resources in your Service Bus session and in the configuration framework. From these editors, you can view each project in the session, each folder and resource in a project, and each resource in a folder. You can also take actions against certain objects, such as testing a resource, launching the Pipeline Editor, and so on. The available actions depend on the type of resource you are viewing.

Resources in the console are grouped in projects. You must create a project before you can create Service Bus resources. You can create folders within projects and within other folders to organize the project components into logical groupings.

The Resource Gallery collects all of the resources that can be added to the Service Bus console. Use the Resource Gallery to create resources in this release of Oracle Service Bus.

1. From the Project Navigator, right-click the project or folder in which you want to add the resource, select Create > Resource
   The Resource Gallery is displayed.
2. Navigate through the Resource Gallery to find the type of resource you want to add. Select the resource, and then click OK.
   The creation dialog for the selected resource is displayed. Complete the required steps to finish creating the resource.

1. In the Project Navigator, navigate to the project, folder, or resource you want to clone and right-click it.
2. Click Clone.

   The Clone dialog appears.

3. Optionally, in the New <Resource> Name field, enter a new name for the component.
4. In the Destination section, select the project or folder to which you want to clone the selected component.
5. Click Clone.

   The cloned component appears in the location you selected. Any dependencies are retained.

1. In the Project Navigator, navigate to the component whose name you want to change.
2. Right-click the component and select Rename.
3. Select the text of the component's name, and enter the new name. For naming guidelines, see Projects and Folder Names.
4. Press Enter.

   The component is renamed.

1. In the Project Navigator, navigate to the project, folder, or resource you want to move and right-click it.
2. Click Move.

   The Move dialog appears.

3. In the Destination section, select the project or folder to which you want to move the selected component.
4. Click Move.

   The moved component appears in the location you selected. Any dependencies are retained.

   Note:

   You cannot move a component to a project or folder that already contains a component by the same name.

When you delete a project or folder, all resources under the folder are deleted. If any resources under this folder are referenced by resources under a different project or folder, you can still delete it but with a warning confirmation. This might result in conflicts due to unresolved references to the deleted resource.

You can delete Service Bus components from the Project Navigator or from the Project or Folder Definition Editor. When you delete from an editor, you can delete multiple components in the same container at once.

The Conflicts tab displays errors in your current Service Bus configuration and reflects any conflicts your changes have with other activations. You can view all conflicts, or just those for the resource displayed in the current resource editor. Click the Conflicts icon to display the Conflicts tab.

Figure 2-12 Conflicts Tab

Description of "Figure 2-12 Conflicts Tab"

You must resolve all error conflicts in a session before you can activate that session. To resolve a conflict, use the information provided in the Errors and Concurrent Updates tables on the Conflicts tab to understand the problem and then modify the component that is causing the conflict.

The Changes view of the History tab displays different information based on whether or not you are in a session. When you are in a session, the Changes view displays a list of configuration changes that you have made during the current session. When you are outside a session, the Changes view does not display any changes.

Figure 2-13 History Tab

Description of "Figure 2-13 History Tab"

To view the changes in the current session:

1. Click the Tools icon , and then click History, as shown in the following figure:
   
   Description of the illustration tools-history.png

   The History tab appears with the Changes view selected. The Changes table displays the type of change made, the time each change was made, the person who made each change, the status, and, if the change was reversed, the person who reversed it.

2. To undo any of the changes listed, see How to Undo Specific Changes in the Current Session.

1. From the top-left of the Service Bus Console, click the Tools icon , and then click History.

   The History tab appears with the Changes view selected.

2. Click Sessions above the table.

   The Sessions table appears with a list of sessions, the user who created each session, the date and time each session was created and modified, and the number of resources that were changed.

3. To switch to a session in the list, select that session and click the Switch to Session icon.

   Note:

   The same user logged in to multiple browsers is not supported. It causes unpredictable behavior in the console.

1. From the top-left of the Service Bus Console, click the Tools icon , and then click History.

   The History tab appears with the Changes view selected.

2. Click Activations above the table.

   The Activations table appears with a list of activations, their descriptions, the time each activation occurred, the user who activated each session, the status of the activation, and, if the activation was reversed, the user who reversed it.

3. To view information about each change in an activation, click that activation in the Activation column.

   The Task Details dialog appears with a list of each change made in the selected session.

4. To view any of the resources or locations (paths) listed in the task details, click the name of the resource or location.

   The resource or location opens in a Service Bus editor.

5. To undo activations or purge tasks for an activation, see the following topics:

   • How to Purge Activated Sessions

   • How to Undo a Session Activation

   • How to Undo Specific Changes in the Current Session

1. Make sure you are not in an active session.
2. From the top-left of the Service Bus Console, click the Tools icon , and then click History.

   The History tab appears with the Changes view selected.

3. Click Activations above the table.
4. Click the Purge Tasks icon above the table.

   The Purge Activation History dialog appears.

5. On the Purge Activation History dialog, do one of the following:

   • To purge all tasks for all sessions, select Purge All Tasks.

   • To purge tasks for a specific time period, select Purge Selected Tasks, and enter the beginning and ending dates and times for the period to purge.

6. Click Purge, and then click Yes to confirm the purge.

   The selected activations are removed from the list, and a new entry appears with a description of the purge.

1. From the top-left of the Service Bus Console, click the Tools icon , and then click History.

   The History tab appears with the Changes view selected.

2. Select the change you want to undo, and then click the Undo icon above the table.

   The change is reversed. If you reversed a Create task, the selected resource is removed from the session and no longer appears in the Project Navigator. If you reversed a Delete task, the selected resource is added back to the session and reappears in the Project Navigator.

1. From the top-left of the Service Bus Console, click the Tools icon , and then click History.

   The History tab appears with the Changes view selected.

2. Click Activations above the table.

   The Activation table displays the previous activations.

   Figure 2-14 Activations Tab

   
   Description of "Figure 2-14 Activations Tab"
3. To undo an activation, do the following:

   • Click the empty field to the right of the session you want to undo to select it.

   • Click the Undo icon above the table.

     The session activation is reversed.

4. To undo an activation into a session, do the following:

   • Click the empty field to the right of the session you want to undo to select it.

   • Click Undo in a Session.

     The session activation is reversed and a new session is created pre-populated with the tasks needed to undo the changes activated in the session.

1. Open a project, folder, or resource in its Service Bus editor.
2. Click the Tools icon in the upper right portion of the editor, and then select References.

   The References page appears, and shows the selected resource in bold. The Referenced By column lists any resources that reference the selected resource. The References column lists any resources that the selected resource references.

   Figure 2-15 References Tab

   
   Description of "Figure 2-15 References Tab"
3. Click the name of a resource to display it in its editor.
4. Click the left arrow next to a resource in the Referenced By column to view the references for that resource.
5. Click the right arrow next to a resource in the References column to view the references for that resource.

The menu bar above each table lets you specify which columns to display and in what order. You can also specify the sort order for the columns and view the table full-screen.