Creating the BizTalk Messaging Port
Let's recap what we have accomplished before we go on to build a messaging port in the BizTalk Server Messaging Manager. First, we renamed the home organization, added two applications, and created a sending member bank organization. Next, we designed both the inbound and outbound specifications to meet the criteria required by the application and then created documents in the BizTalk Messaging Manager to reference them. Then we created a map to transform the inbound document into the outbound document format.
Note
It might be confusing to think about creating the messaging port first and the channel last because the channel is the first component referenced by BizTalk. However, as you will see, when we are building the messaging port, the wizard asks whether we want to create a channel for this messaging port. We will reply “yes” to this and generate a channel at that time. Remember, a port describes the destination and must have at least one channel. It may also be referenced by many channels.
Now we are ready to create a messaging port to manage the delivery of data to the waiting application. Before we begin, we must set up the applications and directories required for this example. There are three ASP files that you will need to use for this sample application. To configure your machine, follow these steps:
1. |
Create a folder called BigBank_Co under drive:inetpubwwwroot. |
2. |
Add two subfolders to BigBank_Co called application and documents. |
3. |
Create another folder called SunsetBank_Inc under drive:inetpubwwwroot. |
4. |
Add two subfolders to SunsetBank_Inc called application and documents. |
5. |
In the next section, “Creating the BizTalk Channel,” you will see code for the three files that are necessary for running the example. The ASP files will be added to their respective application folders, and the output of the application, which in this case is the XML documents, will be sent to the document folders (no need to do anything to this folder).
For the purposes of this example, it is important to make certain directories write-enabled. Using Windows Security, right-click on the document folders and choose Properties. On the Security tab, add the Internet Guest Account (for example, WebServerNameIUSR_ WebServerName) to the list of names and give this account Write access, in addition to its current defaults.
We are now ready to create the new port. To accomplish this, follow these steps:
1. |
Click on the Messaging Ports link in the left pane and then click on the Search Now button. |
2. |
From the menu, choose File, New, Messaging Port, To an Application. Notice that we have a choice between building a port that goes To an Organization and one that goes To an Application. In this case, the document is coming from an organization, one of the member banks, and then being submitted to an internal application inside the BigBank organization. Therefore, as you will see, one of our choices in the wizard is to send this document to an application that we defined earlier in this chapter (see “Creating the Organizations and Applications”). After we have chosen to create a messaging port, the New Messaging Port dialog opens (see Figure 7.9). Figure 7.9. The New Messaging Port dialog.
|
3. |
Name the port SunsetBank_Inc to BigBank_Co via HTTP and click Next. The Destination Application section allows you to define either an XLANG schedule to run against or a waiting application. Choose the default, which is an Application. |
4. |
Click the Application radio button (which should be the default) and select getTrans from the choice of applications. This is the BizTalk application that BizTalk will submit the document to after it has finished processing it. |
5. |
Choose a primary transport for the output document. |
6. |
Click on Browse, within the context of the Primary Transport section and select HTTP as the transport type. Submit an Address for the application, which will be an ASP file—for example, http://localhost/BigBank_Co/application/getTrans.asp as displayed in Figure 7.10. Figure 7.10. Selecting the port transport properties.
|
7. |
After you enter the address for getTrans.asp—for example, http://localhost/BigBank_Co/application/getTrans.asp—click Next. In the Envelope Information section, make sure that the default home organization identifier is selected and click Next. |
8. |
In the Security Information section, make sure that the Create a Channel for this Messaging Port check box is checked and choose From an Organization as the Channel Type. |
9. |
Click Finish, and you are transferred to a new wizard that allows you to create a new channel. |
