AS1 Receiver

How to Configure a AS1 Receive Location with the BizTalk Server Administration Console

To configure the receive location by using the BizTalk Server Administration console, use the following procedure:

NOTE: Before completing the following procedure you must have already added a one-way receive port. For more information, see How to Create a Receive Port.

To configure receive location variables for a AS1 receive location:

1. In the BizTalk Server Administration console, expand BizTalk Server Administration, expand BizTalk Group, expand Applications, and then expand the application you want to create a receive location in.
2. In the left pane, click the Receive Port node. Then in the right pane, right-click the receive port that is associated with an existing receive location or that you want to associate with a new receive location, and then click Properties.
3. In the left pane of the Receive Port Properties dialog box, select Receive Locations, and in the right pane double-click an existing receive location or click New to create a new receive location.
4. In the Receive Location Properties dialog box, in the Transport section next to Type, select nsoftware.AS1 v4 from the drop-down list, and then click Configure to configure the transport properties for the receive location.
5. In the nsoftware.AS1 v4 Transport Properties dialog box, you will find the following properties:

   AS1MessageId	The Id of the message. Type: xs:string    Default Value: "@%MessageId%"
   DeleteMode	Controls if and when the remote messages are deleted after processing. Type: xs:int    Default Value: 0
   EDIFileName	The name to be used in the Content-Disposition MIME header of the outbound request. Type: xs:string    Default Value: "rfc1767.edi"
   EDIType	The MIME type of the data. Type: xs:string    Default Value: "application/edi-x12"
   EncryptionCert	The digital id to be used for decryption. Type: Certificate    Default Value: null NOTE: The digital id must have a private key associated with it.
   ErrorThreshold	The maximum number of errors before the adapter shuts down. Type: xs:int    Default Value: 5
   Firewall	A set of properties related to firewall access. Type: Firewall    Default Value: null
   LogDirectory	The path to a directory for logging. Type: xs:string    Default Value: ""
   MaxBatchSize	The maximum size, in MB, of the current batch (0 indicates no limit). Type: xs:int    Default Value: 0
   MaxFileCount	The maximum number of files in the current batch (0 indicates no limit). Type: xs:int    Default Value: 10
   MaxFileSize	The maximum size, in MB, of a file in the current batch (0 indicates no limit). Type: xs:int    Default Value: 0
   MaxThreads	The maximum number of threads that the adapter may consume. Type: xs:int    Default Value: 20
   MDNDisposition	The Disposition header in the MDN receipt. Type: xs:string    Default Value: ""
   MDNMICValue	The Message Integrity Check(s) (one-way hash) of the EDI payload. Type: xs:string    Default Value: ""
   MDNSignatureStatus	The validity of the signature in the MDN receipt. Type: xs:string    Default Value: "Valid"
   MDNSigningCert	The digital id to be used to sign the MDN (optional). Type: Certificate    Default Value: null NOTE: The digital id must have a private key associated with it.
   MDNTo	The address to which an MDN was requested. Type: xs:string    Default Value: ""
   MessageFilter	A message filter used to filter incoming messages for processing. Type: xs:string    Default Value: ""
   MyEmail	The local email address of the profile being configured. Type: xs:string    Default Value: ""
   Other	Defines a set of configuration settings to be used by the adapter. Type: xs:string    Default Value: ""
   PollingInterval	The amount of time, in seconds, between download attempts. Type: xs:int    Default Value: 60
   POPPassword	The password for your incoming (POP) mail server. Type: baf:Password    Default Value: "" NOTE: This property must have a value.
   POPPort	The port for the POP server (default is 110). Type: xs:int    Default Value: 110
   POPServer	The email server (POP) used to receive incoming messages. Type: xs:string    Default Value: "" NOTE: This property must have a value.
   POPSSLAcceptServerCert	If connecting to a secure POP server for message retrieval, a server certificate to unconditionally accept. Type: Certificate    Default Value: null
   POPSSLCert	The certificate to use for client authentication during the SSL handshake to the POP server, if required. Type: Certificate    Default Value: null NOTE: The digital id must have a private key associated with it.
   POPSSLStartMode	Determines how the adapter starts the SSL negotiation with the POP Server. Type: xs:int    Default Value: 3
   POPUser	The username for your incoming (POP) mail server. Type: xs:string    Default Value: "" NOTE: This property must have a value.
   ReceiveMode	Controls whether the adapter is configured to process AS1 messages or MDN receipts. Type: xs:int    Default Value: 0
   RequeueEndpoints	Whether to requeue receive endpoints if the polling interval has not been reached. Type: bool    Default Value: false
   RuntimeLicense	Specifies the adapter runtime license key. Type: xs:string    Default Value: ""
   SignerCert	The signing certificate of the trading partner. Type: Certificate    Default Value: null
   SMTPPort	The port for the SMTP server (default is 25). Type: xs:int    Default Value: 25
   SMTPServer	The email server used to deliver outgoing messages. Type: xs:string    Default Value: "" NOTE: This property must have a value.
   SMTPSSLAcceptServerCert	If connecting to a secure SMTP server for message delivery, a server certificate to unconditionally accept. Type: Certificate    Default Value: null
   SMTPSSLCert	The certificate to use for client authentication during the SSL handshake to the SMTP server, if required. Type: Certificate    Default Value: null NOTE: The digital id must have a private key associated with it.
   SMTPSSLStartMode	Determines how the adapter starts the SSL negotiation with the SMTP Server. Type: xs:int    Default Value: 3
   Timeout	A timeout for the adapter. Type: xs:int    Default Value: 60
   TransportLog	Tells the adapter where and how to report information about its operations. Type: Log    Default Value: null
   URI	The Uniform Resource Identifier (URI) of the send port or receive location. Type: xs:string    Default Value: ""

6. Click OK.
7. Enter the appropriate values in the Receive Location Properties dialog box to complete the configuration of the receive location and click OK to save settings. For information about the Receive Locations Properties dialog box, see How to Create a Receive Location.