Connector business object structure

After installing the connector, you must create business objects. 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 Express. For more on naming conventions see Naming IBM WebSphere InterChange Server Express 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 text. 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 a connector with a Name-Value data handler.

[ReposCopy]
   Version = 3.0.0
   [End]
   [BusinessObjectDefinition]
   Name = Sample_JMS_LegacyContact
   Version = 1.0.0
    
   [Attribute]
   Name = ContactId
   Type = String
   MaxLength = 255
   IsKey = true
   IsForeignKey = false
   IsRequired = true
   DefaultValue = 1001
   IsRequiredServerBound = false
   [End]
   [Attribute]
   Name = FirstName
   Type = String
   MaxLength = 255
   IsKey = false
   IsForeignKey = false
   IsRequired = false
   DefaultValue = Jim
   IsRequiredServerBound = false
   [End]
   [Attribute]
   Name = LastName
   Type = String
   MaxLength = 255
   IsKey = false
   IsForeignKey = false
   IsRequired = false
   DefaultValue = Smith
   IsRequiredServerBound = false
   [End]
   [Attribute]
   Name = OfficePhoneArea
   Type = String
   MaxLength = 255
   IsKey = false
   IsForeignKey = false
   IsRequired = false
   DefaultValue = 650
   IsRequiredServerBound = false
   [End]
   [Attribute]
   Name = OfficePhone
   Type = String
   MaxLength = 255
   IsKey = false
   IsForeignKey = false
   IsRequired = false
   DefaultValue = 555-1234
   IsRequiredServerBound = false
   [End]
   [Attribute]
   Name = OfficePhoneExt
   Type = String
   MaxLength = 255
   IsKey = false
   IsForeignKey = false
   IsRequired = false
   DefaultValue = x100
   IsRequiredServerBound = false
   [End]
   [Attribute]
   Name = FaxArea
   Type = String
   MaxLength = 255
   IsKey = false
   IsForeignKey = false
   IsRequired = false
   DefaultValue = 650
   IsRequiredServerBound = false
   [End]
   [Attribute]
   Name = FaxPhone
   Type = String
   MaxLength = 255
   IsKey = false
   IsForeignKey = false
   IsRequired = false
   DefaultValue = 555-1235
   IsRequiredServerBound = false
   [End]
   [Attribute]
   Name = Department
   Type = String
   MaxLength = 255
   IsKey = false
   IsForeignKey = false
   IsRequired = false
   DefaultValue = Engineering
   IsRequiredServerBound = false
   [End]
   [Attribute]
   Name = Title
   Type = String
   MaxLength = 255
   IsKey = false
   IsForeignKey = false
   IsRequired = false
   DefaultValue = Software Engineer
   IsRequiredServerBound = false
   [End]
   [Attribute]
   Name = EmailAddr
   Type = String
   MaxLength = 255
   IsKey = false
   IsForeignKey = false
   IsRequired = false
   DefaultValue = jim.smith@ibm.com
   IsRequiredServerBound = false
   [End]
   [Attribute]
   Name = ObjectEventId
   Type = String
   MaxLength = 0
   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