Connector business object structure

After installing the connector, you must create business objects for MQ Integrator Broker. There are no requirements regarding the structure of the business objects other than those imposed by the configured data handler. The business objects that the connector processes can have any name allowed by InterChange Server. For more on naming conventions see Naming IBM WebSphere InterChange Server Components.

The connector retrieves messages from a queue and attempts to populate a business object (defined by the meta-object) with the message contents. Strictly speaking, the connector neither controls nor influences business object structure. Those are functions of meta-object definitions as well as the connector's data handler requirements. In fact, there is no business-object level application information. Rather, the connector's main role when retrieving and passing business objects is to monitor the message-to-business-object (and vice versa) process for errors.

Sample Business Object Properties

This section describes sample business object properties for an connector with a Name-Value data handler.

[ReposCopy]
Version = 3.0.0
[End]
[BusinessObjectDefinition]
Name = Example_SimpleOrder
Version = 1.0.0
AppSpecificInfo = m_SimpleOrder
 
[Attribute]
Name = ProductCode
Type = String
Cardinality = 1
MaxLength = 3
IsKey = true
IsForeignKey = false
IsRequired = true
AppSpecificInfo = e_ProductCode;type=pcdata;
DefaultValue = W02
IsRequiredServerBound = false
[End]
 
[Attribute]
Name = ProductDescription
Type = String
Cardinality = 1
MaxLength = 20
IsKey = false
IsForeignKey = false
IsRequired = false
AppSpecificInfo = e_ProductDescription;type=pcdata;
DefaultValue = Deluxe Widget
IsRequiredServerBound = false
[End]
[Attribute]
Name = ProductQuantity
Type = Integer
Cardinality = 1
MaxLength = 1
IsKey = false
IsForeignKey = false
IsRequired = true
AppSpecificInfo = e_ProductQuantity;type=pcdata;
DefaultValue = 1
IsRequiredServerBound = false
[End]
 
[Attribute]
Name = ObjectEventId
Type = String
MaxLength = 255
IsKey = false
IsForeignKey = false
IsRequired = false
IsRequiredServerBound = false
[End]
 
[Verb]
Name = Create
[End]
 
[Verb]
Name = Delete
[End]
 
[Verb]
Name = Retrieve
[End]
 
[Verb]
Name = Update
[End]
[End]
 
[BusinessObjectDefinition]
Name = Example_SimpleOrder_MRM
Version = 1.0.0
AppSpecificInfo = MRM
 
[Attribute]
Name = xmlns
Type = String
Cardinality = 1
MaxLength = 255
IsKey = false
IsForeignKey = false
IsRequired = false
AppSpecificInfo = xmlns;type=attribute
DefaultValue = www.mrmnames.net/DIN94VC078001
IsRequiredServerBound = false
[End]
[Attribute]
Name = SimpleOrder
Type = Example_SimpleOrder
ContainedObjectVersion = 1.0.0
Relationship = Containment
Cardinality = 1
MaxLength = 1
IsKey = true
IsForeignKey = false
IsRequired = false
AppSpecificInfo = m_SimpleOrder
IsRequiredServerBound = false
[End]
[Attribute]
Name = ObjectEventId
Type = String
MaxLength = 255
IsKey = false
IsForeignKey = false
IsRequired = false
IsRequiredServerBound = false
[End]
 
[Verb]
Name = Create
[End]
 
[Verb]
Name = Delete
[End]
 
[Verb]
Name = Retrieve
[End]
 
[Verb]
Name = Update
[End]
[End]
 
[BusinessObjectDefinition]
Name = Example_SimpleOrder_XMLDoc
Version = 1.0.0
 
[Attribute]
Name = XMLDeclaration
Type = String
MaxLength = 255
IsKey = true
IsForeignKey = false
IsRequired = false
AppSpecificInfo = type=pi;
DefaultValue = xml version="1.0"
IsRequiredServerBound = false
[End]
[Attribute]
Name = Doctype
Type = String
MaxLength = 255
IsKey = true
IsForeignKey = false
IsRequired = false
AppSpecificInfo = type=doctype;
DefaultValue = DOCTYPE MRM PUBLIC "www.mrmnames.net/DIN94VC078001" "DIN94VC078001"
IsRequiredServerBound = false
[End]
 
[Attribute]
Name = MRM_Wrapper
Type = Example_SimpleOrder_MRM
ContainedObjectVersion = 1.0.0
Relationship = Containment
Cardinality = 1
MaxLength = 1
IsKey = true
IsForeignKey = false
IsRequired = true
AppSpecificInfo = MRM
IsRequiredServerBound = false
[End]
 
[Attribute]
Name = ObjectEventId
Type = String
MaxLength = 255
IsKey = false
IsForeignKey = false
IsRequired = false
IsRequiredServerBound = false
[End]
 
[Verb]
Name = Create
[End]
 
[Verb]
Name = Delete
[End]
 
[Verb]
Name = Retrieve
[End]
 
[Verb]
Name = Update
[End]
[End]

Copyright IBM Corp. 1997, 2003