Contents

About this document
Audience
Prerequisites for this document
How to use this manual
Related documents
Typographic conventions
New in this release
New in release 4.4
New in release 4.3.1
Getting started
Introduction to the Server Access Interface
Call-triggered flow
The role of IBM WebSphere Business Integration Server Express Data Handlers
Call-triggered flow example
Overview of access-client development procedure
Tools for access-client development
Server Access Development Kit
Sample access client
IBM WebSphere Server Access Interface API
IBM WebSphere Data Handler API
IBM WebSphere Java Connector Development Kit
Setting up the access-client environments
Setting up the development environment
Installing IBM WebSphere Server Access interface
Compiling the access client
Setting up the run-time environment
Generating a persistent .ior file
Locating the .ior file
Toggling event sequencing for access requests
Configuring collaborations for call-triggered flows
Using System Manager to implement a call-triggered flow option
Designating collaboration ports for call-triggered flows
Associating business objects and maps
Flow direction: Into the collaboration
Flow direction: Out of the collaboration
Configuring collaboration object properties
Implementing an access client
Creating an access session
Issuing the access request
Sending a business object
Sending serialized data
Obtaining the access response
Closing the access session
An example of implementing a call-triggering flow
Example
A sample servlet with HTML data-handling capabilities
The scenario
Running the sample on a web server
Sample HTML data handler
Data-handler meta-object
Sample code for HTML data handler
Sample Java code--ATP servlet
Server Access Interface API reference
IAccessEngine interface
IgetInterchangeAccessSession()
IcloseSession()
login()
logout()
securelogin()
encryptedlogin()
IInterchangeAccessSession interface
IcreateBusinessObject()
IcreateBusinessObjectArray()
IcreateBusinessObjectFrom()
IcreateBusinessObjectWithVerb()
IexecuteCollaboration()
IexecuteCollaborationExtFmt()
IreleaseBusinessObject()
IreleaseBusinessObjectArray()
setLocale(String)
login()
logout()
IBusinessObject interface
Iduplicate()
Iequals()
IequalsKeys()
IgetAppSpecificInfo()
IgetAttributeCount()
IgetAttributeName()
IgetAttributeType()
IgetAttributeTypeAtIndex()
IgetBooleanAttribute()
IgetBOAppSpecification()
IgetBusinessObjectArrayAttribute()
IgetBusinessObjectAttribute()
IgetDateAttribute()
IgetDefaultValue()
IgetDoubleAttribute()
IgetFloatAttribute()
IgetICSVersion()
IgetIntAttribute()
IgetLongTextAttribute()
IgetName()
IgetStringAttribute()
IgetVerb()
IisAttributeMultipleCardinality()
IisBlankValue()
IisIgnoreValue()
IisKey()
IisRequired()
Iserialize()
IsetAttributes()
IsetAttributeToBlank()
IsetAttributeToIgnore()
IsetBooleanAttribute()
IsetBusinessObjectArrayAttribute()
IsetBusinessObjectAttribute()
IsetDateAttribute()
IsetDoubleAttribute()
IsetFloatAttribute()
IsetIntAttribute()
IsetLongTextAttribute()
IsetStringAttribute()
IsetVerb()
ItoExternalForm()
ItoString()
Server Access Interface exceptions
IAttributeBlankException
IAttributeNotSetException
ICxAccessError
IExecuteCollaborationError
IInvalidAttributeNameException
IInvalidAttributeTypeException
IInvalidBusinessObjectTypeException
IInvalidIndexException
IInvalidVerbException
IMalFormedDataException
IValueNotSetException
IVerbNotSetException
IBusinessObjectArray interface
Iduplicate()
IdeleteBusinessObjectAtIndex()
IgetBusinessObjectAtIndex()
IgetSize()
IremoveAllElements()
IsetBusinessObject()
IsetBusinessObjectAtIndex()
Appendixes
Appendix. Internationalization considerations
What Is a locale?
Designing an Access client for internationalization
Locale considerations
Character-Encoding
Support for languages with bidirectional script
Index
Notices
Programming interface information
Trademarks and service marks

Copyright IBM Corp. 2004, 2005