The Oracle Utilities Network Management System Switching Adapter provides the ability to request and receive switching sheet updates. The Oracle Utilities Network Management System Switching Adapter is implemented as a Java application, running on the Oracle WebLogic Server platform.

One of the primary functions of the adapter is to process switching sheet requests and updates from an external system. These updates are tied to an NMS switching sheet via an external switching sheet ID supplied to it by an external system.

A secondary function of the adapter is to submit requests out to an external system. So as to maintain a link between the two systems, the external system will be required to pass back an external sheet ID or use the switching sheet’s unique ID when submitting updates back to NMS.

All switching sheet lookups will be done using the switching sheet’s unique ID number or from an external sheet ID. Neither of these values can be null for the messages to be processed.

The adapter is also capable of passing a view-only version of a switching sheet out to an external system. This view-only version of the switching sheet is generated as part of a report request to BI Publisher. This same mechanism is used to generate switching sheet reports that are used for printing and emailing purposes within NMS. The generated report file type and report contents are configurable.s

In addition to the base product capabilities, the Switching Adapter is designed to be extended by projects. A buildable example extension is provided and can be used as a starting point for project-specific logic. The example is packaged at:

Projects can copy this example into their source tree, customize polling/listening behavior, add integration logic, and deploy directly to WebLogic using the provided Ant scripts. The example includes a REST servlet and a stub OAuth filter for securing endpoints during integration testing, along with a REST test utility that can simulate an external system.

No product database schema changes are required to use the example extension. The example demonstrates how to wrap the existing SWMAN_INTERFACE_UPDATES and SWMAN_INTERFACE_DOCUMENTS tables with project DAOs and how to integrate with the base services for polling and updates.