XML —

Submitting and Receiving BizTalk Documents

Once a document has been placed into BizTalk Server 2000, BizTalk Server 2000 will route the message properly. You can use an application for the source or destination as long as the source or the destination is the default. You can also write an application that retrieves inbound BizTalk documents from the server and passes outbound documents to BizTalk Server 2000. BizTalk Server 2000 comes with the IInterchange interface, which can be used by the applications you write to communicate to BizTalk Server 2000.

When working with Visual Basic, you will need to get a reference to the Microsoft BizTalk Server Interchange 1.0 Type Library. You can then get a reference to an Interchange object. This object implements the BizTalk Server IInterchange interface that has the following methods:

Methods in the IInterchange Interface

Method Description
CheckSuspendedQueue ([DocName As String], [SourceName As String], [DestName As String]) Used to get a reference to a list of document handles for documents that are in the Suspended Queue.
DeleteFromSuspendedQueue (DocumentHandleList) Deletes all specified documents in the Suspended Queue.
GetSuspendedQueueItemDetails (ItemHandle As String, SourceName, DestName, DocName, ReasonCode, ItemData) Returns the details on a document in the Suspended Queue.
Submit (lOpenness As MODELDB_OPENNESS_TYPE, [Document As String], [DocName As String], [SourceQualifier As String], [SourceID As String], [DestQualifier As String], [DestID As String], [PipelineName As String], [FilePath As String], [EnvelopeName As String]) As String Submits a document as a string to BizTalk Server 2000 for a synchronous processing. The MODELDB_OPENNESS_TYPE is used to determine if the document is open and can be the following constants: MODELDB_OPENNESS_TYPE_DESTINATION, MODELDB_ OPENNESS_TYPE_NOTOPEN, and MODELDB_OPENNESS_TYPE_SOURCE.
SubmitSync (Openness As MODELDB_OPENNESS_TYPE, [Document As String], [DocName As String], [SourceQualifier As String], [SourceID As String], [DestQualifier As String], [DestID As String], [PipelineName As String], [FilePath As String], [EnvelopeName As String], SubmissionHandle, ResponseDocument) Submits a document as a string to BizTalk Server 2000 for synchronous processing and returns a response if one is provided.

The BizTalk SDK, which comes with BizTalk Server 2000 and is part of the BizTalk Server 2000 Help file, includes a complete tutorial and Visual Basic example that shows how to use this interface.