12.4 Using the Services View to Review and Update ESB Services

The Services view of Oracle ESB Control enables you to view system and service definitions, update routing rules, define trackable fields, and view a schematic diagram of the services.

Figure 12-2 provides an example of the Diagram tab of the Services view in Oracle ESB Control.

Figure 12-2 Oracle ESB Control Services View - Diagram Tab

Description of "Figure 12-2 Oracle ESB Control Services View - Diagram Tab"

The Services view is divided into two main regions: a services panel on the right and tabbed pages on the left. The services panel provides a navigation tree of ESB systems and the service groups and services within each, and buttons to create, delete, and move objects within the navigation tree.

The services panel appears on the left side of Oracle ESB Control. It provides buttons for creating and deleting ESB systems, groups, and services and provides a navigation tree to present these items (and their current status) after they have been created.

The tabbed panel presents details about services selected in the navigation tree. For each service, you can do any of the following:

• On the Diagram tab, view the relationship of the selected service to other objects within the ESB system, as well as statistics (latency, throughput, instances, and faults).

  The selected service is represented in blue within the diagram, whereas the other services are represented in gray.

• On the Definition tab, view the definition of the selected service, enable it, disable it, or set validation of the payload at runtime. This page summarizes the contents of the WSDL file for the selected service. It consists of three regions for all services, except inbound adapter services. Inbound adapter services present the overall section only, and only a subset of the fields for that region.

  • The general region of information, which is not labeled, appears at the top of the page. The elements that are presented in this region of the page are Name, Type, Description, Invocable from an external service, Concrete WSDL, Port Type, Namespace, WSDL URL, and SOAP Endpoint URI. For inbound adapter services, only the following elements are presented: Name, Type, Description, and Inbound Adapter WSDL URL.

  • The Operations region of the page lists the names of the operations that the service WSDL describes and their types (one-way or request/response).

  • The Operation Details region of the page provides details on an operation selected in the Operations region, including validation of the payload at runtime, message payload element name, and location of the schema, if any. Which tabs are presented in this region depend on the operation definition, as follows:

    • One-way operations

      If the selected operation is defined as a one-way operation (only input elements are defined for the operation in the WSDL), then only the Request tab is active.

    • Request/response operation

      If the selected operation is defined as a request/response operation (both input and output elements are defined for the operation in the WSDL), then both the Request and Response tabs are active.

    • Faults

      If a fault is defined for the operation (fault elements are defined for the operation in the WSDL), then the fault tab is active.

• On the Routing Rules tab, view, update, delete, and set the priority of routing rules for the selected routing service. The process is similar to the actions in the routing rules panel in Oracle JDeveloper ESB Designer. See Section 6.10, "Specifying Routing Rules".

• On the Properties tab, add, view, update, and delete endpoint properties for the selected adapter or SOAP service. This process is similar to the actions in the endpoint properties panel in Oracle JDeveloper ESB Designer. See Section 6.6, "Adding Endpoint Properties for Adapter or SOAP Services".

  
  

  Note: Endpoint properties are not a production feature and are only available in Preview mode.

  
  

• On the Trackable Fields tab, define trackable fields for the selected service. See Section 12.8, "Managing Message Instance Tracking".

12.4.1 How to View and Modify Service Definitions

You can view the definition of an ESB service in the Services view of Oracle ESB Control. You can also update some of the configurations in the services Definition tab, such as enabling the validation of a payload at runtime or specifying that the service can be invoked from an external service.

To view and modify service definitions:

1. Click Services if the Services view is not currently displayed.

2. In the Services panel, navigate to the service of interest, and then select it.

3. Click the Definition tab.

4. Review the definitions and update one or more of the system definition fields if necessary.

   For example, in the Operation Details region, click in the box next to Validate Payload at Runtime to enable this functionality.

5. Click Apply to save your changes.

Figure 12-3 shows an example of the Services view with the Validate Payload at Runtime option on the Definition tab.

Figure 12-3 Services View – Definition Tab

Description of "Figure 12-3 Services View – Definition Tab"