Configuring Endpoint URIs

Part of the configuration process is configuring your BPEL composites to work with your head-end system by defining the appropriate Endpoint URIs for each of the commands. The default approach to defining Endpoints URIs is redeployment or reinstallation or the BPEL composites. For example, by default, changing an adapter from using the test harness to a production environment using the actual head-end system requires editing the appropriate installation menu options and redeploying the BPEL composites. The Endpoints URIs defined during installation and deployment for each adapter are listed in the Smart Grid Gateway Installation and Configuration Worksheets section of the Oracle Utilities Smart Grid Gateway Installation Guide.

You can also use an “Endpoint Override” Domain Value Map (DVM) to override Endpoint URIs defined during deployment and installation. This DVM allows defining specific keys that provide an alternate URL that will override the original installed value. Endpoint Override DVMs can be edited using the Oracle SOA Composer.

The NES endpoint override DVM (D4–EndpointOverrides.dvm) uses a specific set of keys, each used for one or more commands. The table below lists the DVM keys available for the NES adapter and the command used with each:

DVM Key

Commands

DeviceManager

Remote Connect

Remote Disconnect

Device Commissioning

Device Decommissioning

On-Demand Read (Scalar)

On-Demand Read (Interval)

EventManager

On-Demand Read (Scalar)

On-Demand Read (Interval)

GatewayManager

Remote Connect

Remote Disconnect

Device Commissioning

Device Decommissioning

On-Demand Read (Scalar)

On-Demand Read (Interval)

SettingManager

Remote Connect

Remote Disconnect

Device Commissioning

Device Decommissioning

On-Demand Read (Scalar)

On-Demand Read (Interval)

UserManager

Remote Connect

Remote Disconnect

Device Commissioning

Device Decommissioning

On-Demand Read (Scalar)

On-Demand Read (Interval)

ProcessCallout

User Exit Functions

To define an override Endpoint URI for the NES adapter, use the following procedure:

  1. Open the SOA Composer for your BPEL configuration.

    The URL for the SOA Composer is http://server:port/soa/composer.

  2. Select the D4–EndpointOverrides.dvm in the left panel.
    • In Fusion Middleware v12.2.1, this is located under Shared in the Deployment View, or under Domain Value Maps in the Types View.

    • In Fusion Middleware v12.2.2, this is located under Metadata in the Deployment View.

    The DVM will open in the right panel. The Description field lists the available keys for the DVM (only the first key is shown, but you can scroll through the contents to view the list. The panel also displays a list of previously defined keys.

  3. Click the Create Session button (above the left panel) to begin an editing session.

  4. Click the Add Domain Values icon (“+”) to add a new key.

    The Add Domain Values dialog opens.

  5. Enter the appropriate values in the Add Domain Values dialog as follows:

    • key: The DVM key for the Endpoint URI you wish to define (see the table above).

    • EndpointURI: The override Endpoint URI.

  6. Click OK.

    The new DVM value will appear in the list of keys.

  7. Click the Save icon to save the DVM values.

  8. Click the Publish button to activate all the changes in the editing session.

    Enter an optional note for the session in the Publish Session dialog.

    Changes take effect immediately upon publishing the session.

    Click Discard to discard your changes.

    Click Exit to exit your current session. Note that your session will still be open if you exit. Use Discard to end your session without making changes.