Configuring for Internet Transmission
The following procedure can be used to configure GENTRAN: Server NT to transfer data to BizTalk Server, which in turn, then transmits the data over the Internet via HTTPS protocol. This procedure is very general and represents the major steps in the configuration process. Each of these steps may involve one or more detailed procedures. The detailed procedures can be found as part of the product documentation.
In order to send data via HTTPS, the receiving site must have a site certificate installed for their URL in order for HTTPS to function. Certificates can be obtained from commercial certificate authorities.
To configure GENTRAN: Server NT
- Configure your outbound trading partner relationship. This is a normal GENTRAN procedure.
- Create a mailbox using the GENTRAN file system gateway, which will be used to send data. The simplest way is to create one mailbox for each trading partner.
- Create a folder on your GENTRAN server named BIZTALK and share that folder so that the UNC path is \\GENTRANServerName\BIZTALK\.
- Create a subfolder to your BIZTALK share as follows: \\GENTRANServerName\ BIZTALK \HTTPS_out.
- Configure the mailbox to transfer the messages sent to the mailbox to the file share where your BizTalk Server will pick them up. (This file share will be configured in the BizTalk Server procedures below.) For this example, we will use the folder created in step 4:
\\GENTRANServerName\ BIZTALK \HTTPS_out.
- Configure the mailbox to either append all messages to a single file or keep each message as an individual file. This decision will depend upon how your trading partner expects to receive the data. For this example, append all messages to a single file and name it TP1outbound.tmp
- Using the GENTRAN Partner Editor, assign the trading partner to use this mailbox.
- Create a GENTRAN session & event for processing and sending the data. The session should have the following pseudo code. The actual import file name will depend upon your own installation and file naming conventions. Here we have used ImportFile.DAT.
Import \\GENTRANServerName\GENSRVNT\Imports\ImportFile.DAT File_Delete \\GENTRANServerName\GENSRVNT\Imports\ImportFile.DAT Send/Receive Partnerkey & Document If Documents Exist in Outbox File_Rename \\GENTRANServerName\GENSRVNT\BizTalk\HTTPS_out\TP1outbound.tmp to \\tkebisgnt31\BizTalk\HTTPS_out\TP1outbound.dat
- Notice the rename step in the pseudo code renaming TP1outbound.tmp to TP1outbound.dat. This step is important because you do not want BizTalk Server polling for a file as it is being created. By renaming the file, you guarantee that the file is complete before BizTalk Server retrieves it.
- Test the process by sending a sample message through GENTRAN for this trading partner and using your session to export it. It should end up in the shared folder \\GENTRANServerName\ BIZTALK \HTTPS_out.
The GENTRAN configuration is now complete.
To configure BizTalk Server
The following steps use BizTalk Messaging Manager:
- Create an Organization for the trading partner to whom you will be sending documents. For this example we will use TP1 (Trading Partner 1).
- Create an application under your default home organization for the source application (if one does not exist already). This is the application from which data is being sent.