Samples > Sample stores > Consumer direct sample store > IBM Gift Center for the Consumer direct sample store > IBM Gift Center message mapping


IBM Gift Center inbound messages

Inbound messages are messages from an external system entering the IBM Gift Center system. IBM Gift Center can accept a valid inbound message, turn that message into a corresponding service request, and perform the service accordingly. For example, an inbound message can ask for the creation of a gift registry by giving a service name, and required data. In the example below, the requested service is "updateGiftRegistry". The requested service is to be performed in store 10001, and the action, if not specified, is "add": 

<UpdateGiftRegistryBOD storeId="
10001" service="
updateGiftRegistry" 
lang="en-US" revision="1.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:noNamespaceSchemaLocation="../xsd/bods/UpdateGiftRegistryBOD.xsd">
<DataArea>    
<SyncVerb>        
<DefaultAction> add</DefaultAction>    
</SyncVerb>    
<Nouns>        
</GiftRegistryVO>        
<!-- Contents of gift registry that is to be created is
omitted -->        
</GiftRegistryVO>    
</Nouns>
</DataArea>
</UpdateGiftRegistryBOD>

For more details about inbound messages, refer to the inbound message schema located...

There are also a few sample inbound messages located in this directory:

Each inbound message mimics the structure of a Business Object Document (BOD). Each property in a BOD has a corresponding element in the message. For example, a BOD contains a DataArea property (it might have the methods getDataArea() and setDataArea()); likewise, the inbound message, mimicking the BOD structure, also has a <DataArea> element.

Here is a second example: the gift registry value object, GiftRegistryVO, has a property location. Within the element <GiftRegistryVO>, there will be an element <Location>. Based on the design, extending an inbound message is aligned with extending a gift registry service. Adding a new property into a value object will result in adding a new element in the corresponding message. For instance, if you add a newProperty property in the value object GiftRegistryVO, any message that wants to handle this property needs to have an element <NewProperty> within the element <GiftRegistryVO>.


Related concepts

IBM Gift Center for the Consumer direct sample store

IBM Gift Center architecture


Related tasks

Enable IBM Gift Center inbound messages

Related reference

IBM Gift Center outbound messages

IBM Gift Center message mapping


+

Search Tips   |   Advanced Search