Create envelopes

1. In BizTalk Messaging Manager, on the File menu, point to New and click Envelope.

   The New Envelope dialog box appears.

2. In the Envelope name box, type a unique name for the envelope.
   
   
3. In the Envelope format list, click one of the following envelope formats:
   • CUSTOM XML

     To enable Microsoft BizTalk Server 2002 to process inbound interchanges with a custom XML format, you must create an envelope with a custom XML format and a specification reference. However, when you submit custom XML interchanges, you do not need to specify the envelope name in the submit call parameters. BizTalk Server 2002 is able to locate the appropriate envelope without a name reference.

   • X12

     You do not need to create an envelope with an X12 format to enable BizTalk Server 2002 to process inbound interchanges with an X12 format, and you do not need to specify the envelope name in the submit call parameters.

   • EDIFACT

     You do not need to create an envelope with an EDIFACT format to enable BizTalk Server 2002 to process inbound interchanges with an EDIFACT format, and you do not need to specify the envelope name in the submit call parameters.

   • FLATFILE

     To enable BizTalk Server 2002 to process inbound interchanges with a flat-file format, you must create an envelope with a flat-file format. When you submit inbound flat-file documents, you must specify the envelope name in the submit call parameters. For more information, see Submitting.

   • CUSTOM

     To enable BizTalk Server 2002 to process inbound interchanges with a custom format, a format not supported directly by BizTalk Server, you must create a custom parser component. You need to create an envelope only if the custom parser requires one. For more information, see Parsers.

     To enable BizTalk Server to process outbound interchanges with a custom format, you must create an envelope with a custom format and select the envelope in a messaging port. You also must create and register a custom serializer component. For more information, see Serializers. You can configure the custom serializer in the channel on the Advanced Configuration page of the Channel Wizard. For more information, see Set advanced configuration properties.

   • RELIABLE

     You do not need to create an envelope with a reliable format to enable BizTalk Server 2002 to process inbound interchanges with a reliable format, and you do not need to specify the envelope name in the submit call parameters.

     The reliable format processes envelopes that are compliant with BizTalk Framework 2.0. For more information about BizTalk Framework 2.0, go to the Microsoft BizTalk Web site (www.microsoft.com/biztalk/).

     If you choose the reliable format, you also must configure the Reliable messaging reply-to URL address in the BizTalk Server Group Properties dialog box. For more information, see Configure general properties for a server group.

4. If you choose the custom XML, flat-file, or custom format, you can select a specification for the envelope. For more information, see Select an envelope specification.

Notes

• To enable BizTalk Server 2002 to process outbound interchanges in any format, you must create an envelope.
  
  
• If you choose the custom XML format and you do not select a specification, the envelope format defaults to the reliable format.
  
  
• When processing envelopes that are compliant with BizTalk Framework 2.0, BizTalk Server 2002 should be considered the endpoint with regard to the expiration time. When BizTalk Framework 2.0–compliant documents are submitted to BizTalk Server, either from an application or a trading partner, the following fields are overwritten if present, or created if absent:
  • In the properties subsection:

    <prop:identity>

    <prop:sentAt>

    <prop:expiresAt>

  • In the receipt information subsection:

    <sendTo>

    <address>

    <sendReceiptBy>

• If you change the envelope format and you have selected a specification, you also might need to select a different specification.
  
  
• When you save an envelope that references a specification that is outside your local domain, you might receive an error. If you receive an error, download and configure the WinHTTP proxy utility. To download the utility, go to the Microsoft MSDN Web site (msdn.microsoft.com/downloads/default.asp) and browse to the WinHTTP Proxy Configuration Utility page, which is located in the XML chapter of the Web Development book.

Related Topics

Delete envelopes

Edit envelopes

Search for envelopes

Understanding Envelopes

Did you find this information useful? Please send your suggestions and comments about the documentation to BizTalk Server Documentation Feedback@microsoft.com