Transports and Interfaces: Siebel eBusiness Application Integration Volume III > Interfacing with Microsoft BizTalk Server > Connecting to BizTalk Using HTTP >
Siebel HTTP Outbound Transport
BizTalk Server uses the Microsoft Internet Information Server (IIS) and Active Server Pages (ASP) to receive documents over HTTP. The ASP file uses BizTalk Interchange Submit( ) and SubmitSync( ) methods to send documents to BizTalk Server.
Checklist
|
q |
HTTP Outbound Transport requires a virtual directory. This directory needs to reside on the IIS to which Siebel outbound XML documents will be sent. Typically, this is on the same machine as BizTalk Server. For details, see To create a virtual directory for HTTP Outbound. |
q |
Copy the sample ASP file to the virtual directory. You can modify the Active Server Page to meet your business requirements. This section provides you with a sample ASP file to serve as a general guideline. For details, see To copy the ASP files to the new HTTP Outbound directory. |
To create a virtual directory for HTTP Outbound
- Create a new directory for the ASP file.
The directory should be on the Web Server where you would be sending your outbound XML documents from the Siebel application. This is usually the BizTalk machine.
- Create a new virtual directory on IIS using the new directory you created. Name the directory, for example, BizTalkReceive.
NOTE: The virtual directory can be on either the Siebel Server or the BizTalk Server. If the Internet Information Server is on the Siebel Server machine, you need to register the BizTalk Server Interchange Application to the Siebel Server. If IIS is on the BizTalk Server, you do not need to register Interchange application, because it is already a part of the BizTalk Server installation. See your Microsoft Internet Information Server (IIS) documentation for details on setting up virtual directories.
To copy the ASP files to the new HTTP Outbound directory
Sending Messages to BizTalk Using the Siebel HTTP Outbound Transport
This section explains how to use the Siebel BizTalk interface to send an XML document to BizTalk Server over HTTP Outbound transport.
To set up BizTalk configuration objects for HTTP Outbound
- On the BizTalk Server machine, access the BizTalk Messaging Manager.
- Set up your home organization as Siebel and set up applications for the home organization.
NOTE: For each BizTalk-specific step, see Microsoft BizTalk Server documentation for the details.
- Create a new organization and name it as is appropriate. For example, if your trading partner is Oracle, enter Oracle.
- Create a document definition for previously-created document specification from WebDAV and name it, for example, Siebel Order. See To import schema into BizTalk Server to save it as a BizTalk document specification.
- Create a messaging port to your trading partner.
- In the Destination Organization window select the organization, such as Oracle. Click Browse under Primary Transport.
- Select the appropriate transport for your trading partner.
- Complete the remaining pages as needed and click Finish to complete.
- Create a new channel for the port created in Step 5.
- Create a new channel "From an Application" such as Siebel To Oracle Channel.Click Next.
- Select the appropriate inbound document definition, such as Siebel Order.
- Select appropriate outbound document definition for your trading partner, such as Oracle Order.
- Select an appropriate map, if necessary.
- Complete other pages as required and select Finish to complete.
- Modify
SiebelBizTalkOutHTTP.asp to specify the Channel name you configured in Step 6.
- Search for
sChannel in the file.
- Remove the comment designator from this statement:
sChannel = Channel Name you just created
To create the Siebel workflow for HTTP Outbound
- From the Site Map choose Administration - Business Process > Workflow Processes.
- Create a new workflow process as shown below to send a message to BizTalk.
NOTE: For information on how to set up Siebel Workflow, see Siebel Business Process Designer Administration Guide.
- Set up the process properties for your workflow as follows:
|
|
|
OrderMessage |
Hierarchy |
- |
<Value> |
String |
- |
Object Id |
String |
record # for an order
|
- Set up the first step after Start to use the EAI Siebel Adapter with the Query method to query the order from Siebel Database, using the following input and output arguments:
|
|
|
|
|
Output Integration Object Name |
Literal |
Sample Order |
- |
- |
Object Id |
Process Property |
- |
Object Id |
String |
|
|
|
|
OrderMessage |
Output Argument |
- |
Siebel Message |
- Set up the second step to use the EAI XML Converter with the Integration Object Hierarchy to XML Document method and the following input and output arguments to convert the order object to XML document:
|
|
|
|
|
Siebel Message |
Process Property |
- |
Order Message |
Hierarchy |
|
|
|
|
<Value> |
Output Argument |
- |
XML Document |
- Set up the last step to use the EAI HTTP Transport with the Send or the SendReceive method and the following input arguments.
|
|
|
|
|
Message Text |
Process Property |
- |
<Value> |
String |
Request Method |
Literal |
POST |
- |
- |
Request URL Template |
Literal |
The URL to which the document will be posted—for example, http:// WebServer/virtual directory name /SiebelBizTalkOutHTTP.asp where: WebServer is the name of your Web server and virtual directory name is the virtual directory you set up in To create a virtual directory for HTTP Outbound, such as BizTalkReceive.
|
- |
- |
NOTE: You may require asynchronous or synchronous communication, using Send and SendReceive respectively, depending on your unique situation.
- Save your workflow process and test it using the Workflow Process Simulator.
|