CES Centricity Gateway business object mappings

The adapter for CES Centricity Gateway provides translation between the broker data model and the CES Centricity data model. Actions taken depend on the direction of the interaction and the specific business objects involved.

The following are the business objects coming from the CES Centricity Gateway and sent to the WebSphere integration broker. The names of these business objects match the names used by the gateway:

The following business objects come from the broker:

Table 7 and Table 8 present a summary of the business object mappings and supported verbs. The remainder of this section gives a more detailed description of the business objects. Refer to the CES Centricity MQ gateway documentation for additional details.

Table 7. The CES Centricity business object mappings -- Centricity -> broker

CES Centricity WBI broker Verbs
CustomerData_001 wbieuConsumer CREATE, DELETE, REPLY, DELETECREATE
PostError_001 CentricityError POST
PostSrsOutput_001 wbieuOutage REPLY, value of SrsOutputMsgType1
PostSrsOutputStatus_001 wbieuOutage REPLY, value of SrsOutputMsgType1
ReplyCustomerStatus_001 wbieuOutageCustomer REPLY
UpdateCrew_001 wbieuCrewList REPLY

Notes:

  1. Values from SrsOutputMsgType: 1=CREATE 2=DELETE 3=UPDATE
  2. UPDATE is the default verb.


Table 8. The CES Centricity business object mappings -- broker -> Centricity

WBI broker CES Centricity Verbs
wbieuConsumer CustomerData_001 Create, Delete, Retrieve1, Update
wbieuCrew UpdateCrew_001 Activate, Arrived, Assign, Available, Create, Deactivate, Delete, Dispatch, Suspend, Unassign, Unavailable, Undispatch, Update, Retrieve2
wbieuCrewList UpdateCrew_001 Create, Delete, Retrieve, Update3
wbieuOutageCustomer GetCustomerStatus_001 Retrieve4
wbieuServiceEvent DisconnectReconnectCustomer_001 Update5
wbieuTroubleTicket CreateIncident_001 Create, Delete6, Update6

Notes:

  1. If verb is Retrieve, this is by content on the custld field of the Customer sub-object.
  2. If verb is Retrieve, this is by content on the crewld field of the Customer sub-object.
  3. If verb is Update, the following wbieuCrew sub-verbs are valid: Available, Unavailable, Activate, Deactivate, Dispatch, Undispatch, Assign, Unassign, Arrived, Suspend.

    Retrieve is by content on the crewld field of the Customer sub-object. If the object is blank and a Retrieve is issued, this results in a GETALLCREW message being issued.

  4. This is a Retrieve by content on one of the following: CustomerId, CustomerNumber, servLocId, xfmrId, meterId.
  5. Centricity verbs DISCONNECT and RECONNECT are decided by looking at the content of the loadActionCode field and checking whether it equals Disconnect or Reconnect.
  6. Delete and Update are only valid on certain versions of the Centricity MQ gateway.

CreateIncident_001

The CreateIncident_001 business object contains incident information or a trouble ticket identifying an outage condition. The incident might be generated by a customer call or other activity.

Centricity Verbs
CREATE
Flow
Broker -> Centricity

Mapping

CreateIncident_001 -> wbieuTroubleTicket

Broker Verbs

CustomerData_001

The CustomerData_001 business object contains incident information or a trouble ticket identifying an outage condition. The incident might be generated by a customer call or other activity.

Centricity Verbs
Flow
Centricity -> Broker

Mapping

CustomerData_001 -> wbieuCustomer

Broker Verbs

DisconnectReconnectCustomer_001

The DisconnectReconnectCustomer_001 business object is used by a remote application to tell Centricity that a customer has been purposely disconnected or reconnected. This action might be initiated, for example, if a customer has moved.

Centricity Verbs
Flow
Broker -> Centricity

Mapping

DisconnectReconnectCustomer_001 -> wbieuServiceEvent

Broker Verbs

The verb Update is supported. The value of the loadActionCode attribute determines whether a customer gets disconnected (value = "Disconnect" or "Reconnect").

GetCustomerStatus_001

The GetCustomerStatus_001 business object is used to retrieve status about a customer.

Centricity Verbs
GET
Flow
Broker -> Centricity

Mapping

GetCustomerStatus_001 and ReplyCustomerStatus_001 -> wbieuOutageCustomer

Broker Verbs

The verb Retrieve is supported. This is a Retrieve by content. One of the following fields must be filled in:

PostError_001

The PostError_001 business object indicates that an error occurred while the gateway was processing a message or while accessing some function within Centricity.

Centricity Verbs
POST
Flow
Broker -> Centricity

PostSrsOutput_001 and PostSrsOutputStatus_001

PostSrsOutput_001 and PostSrsOutputStatus_001 business objects contain information about an outage, including creation, status updates, and outage cancellation and resolution.

Centricity Verbs
POST
Flow
Centricity -> Broker

Mapping

PostSrsOutput_001 and PostSRSOutputStatus_001 -> wbieuOutage

Broker Verbs

ReplyCustomerStatus_001

The GetCustomerStatus_001 business object is used to retrieve status about a customer.

Centricity Verbs
GET
Flow
Broker -> Centricity

UpdateCrew_001

The UpdateCrew_001 business object synchronizes crew assignments and dispatch information with external systems.

Centricity Verbs
Flow
Centricity &lrarrow. Broker

Mapping

UpdateCrew_001 -> wbieuCrewList and UpdateCrew_001 -> wbieuCrew. (wbieuCrew is from the broker only.)

Objects supplied from the MQSeries gateway always arrive at the broker as a wbieuCrewList. Set the verb for each sub-object within a wbieuCrewList to indicate which action to apply to the child crew object. The adapter can accept either a crew list or a singular crew from the broker with the same semantics.

Broker Verbs

Copyright IBM Corp. 1997, 2003