How to Import Bindings for an EDI-AS2 Solution

This topic describes how to import the configuration of an EDI and/or AS2 solution onto another computer. Deployment of an EDI/AS2 solution is integrated with BizTalk application deployment. It is available through the BizTalk Server Administration Console and the BTSTask command-line tool.

You can import the configuration of a BizTalk Server by using a binding file that you created on the source computer by exporting the appropriate bindings. For information about exporting a configuration into a binding file, see How to Export Bindings for an EDI-AS2 Solution. For information about a binding file created from a configuration, see Structure of a Binding File.

You can also import bindings as part of importing an application using an .msi file. For more information, see the How to Import a BizTalk Application. Or you can use the BTSTask command to export and import bindings. For more information about BTSTask, see the BTSTask Command-Line Reference topic in BizTalk Server help.


Importing Bindings

When you import a configuration, existing EDI Properties will be overwritten. If you are importing properties for a party that has the same name as an existing party, BizTalk Server will override the EDI properties (or any bindings) for the existing party. In addition, if you are importing EDI global properties, BizTalk Server will overwrite existing EDI global properties.

After importing a configuration, you must reconfigure passwords. For security reasons, when you export a binding file, BizTalk Server removes the passwords for the bindings from the file. BizTalk Server removes UNB6.1 and UNB6.2 fields from EDIFACT Properties, and ISA1, ISA2, ISA3, and ISA4 fields from X12 Properties. After importing the bindings, you must reconfigure these sensitive fields before processing EDI messages.

If BizTalk Server fails to import a set of bindings, the reason could be that the Host Trusted property in the binding file is different from the Authentication Trusted property for the host. You can resolve this issue by changing the Host Trusted property in the binding file.


Importing a binding file from previous releases of BizTalk Server into BizTalk Server may fail. Because the partner management model has changed considerably for BizTalk Server, importing a binding file from previous BizTalk Server versions may not create the entities in BizTalk Server in accordance to the new model. For more information, see How do Party Definitions in Previous BizTalk Server Versions Translate into the new TPM Entities?.

Import the configuration from a binding file

  1. On the computer that you want to import the configuration to, open the BizTalk Server Administration Console.

  2. Right-click the BizTalk Application that you want to import the EDI/AS2 configuration into, point to Import, and then click Bindings.

  3. In the Import Bindings dialog box, move to the location that contains your binding file, and then click Open.

  4. After importing the bindings, open the BizTalk Server Administration Console. Manually set all the EDI password fields to the appropriate values.

How do Party Definitions in Previous BizTalk Server Versions Translate into the new TPM Entities?

In BizTalk Server, a party definition is essentially an agreement that defines how messages are exchanged between two trading partners. In BizTalk Server, EDI and AS2 messaging has undergone a lot of change and the new Trading Partner Management (TPM) model now requires agreements to be created between two trading business profiles. So, essentially, for an agreement to exist, you first need to have defined the two trading partners, profiles for both the trading partners, and the protocol settings for both the trading business profiles. Once you have defined these entities, you can create a trading partner agreement.


For more information related to TPM enhancements in BizTalk Server, see Building Blocks of a Trading Partner Management Solution.

Given the new TPM object model, does this mean that the EDI applications that you created in BizTalk Server cannot be migrated to BizTalk Server? The answer is no. You can reuse the existing applications from BizTalk Server 2006 R2 or BizTalk Server 2009 in BizTalk Server by using the Party Migration Tool to migrate the party data from previous BizTalk Server versions. For more information about the tool, see EDI Migration Utilities.

See Also

Importing Bindings