GISB Adapter

The GISB Adapter adds GISB send and receive capabilities to BizTalk Server.

Remarks

The GISB Adapter adds GISB send and receive capabilities to BizTalk Server. Built on top of the IP*Works! EDI / GISB Engine, the adapter allows you to easily incorporate secure EDI (EDI-INT) exchange into your current e-Business process architecture.

GISB Receive Adapter

The GISB Receive Adapter implements a fully-functional GISB server that can communicate with your BizTalk Server. In order to use the GISB Receiver, you must set the GISBSiteURL where your GISB server is hosted, as well as the TradingPartner and ReceivingPartner GISB identifiers. The GISB Receiver will read all incoming requests and check them against these values to ensure that the request comes from a known sender and is actually intended for the receiving entity.

If your messages require security, you must set the PGPProvider and PGPParams properties.

Once the incoming GISB request has been parsed and verified, the contents are submitted to your BizTalk Server to be processed. Upon successful submission, the adapter will generate and send a response to your trading partner.

The GISB Receiver is an isolated adapter, meaning that it is hosted by a separate application outside of the BizTalk Server. The adapter uses the incoming HTTP POST URL as the key for storing and retrieving its property set within BizTalk's database. Thus a single page can host multiple trading partner configurations.

GISB Send Adapter

The GISB Send Adapter adds a complete GISB client within your BizTalk Server. In order to use it, you must set a minimum of three required properties: DataTo, DataFrom and URL. It is also recommended that you set PGPProvider, PGPParams, EncryptData, and SignData in order to ensure security, reliability, and non-repudiation.

The GISB Send Adapter has support for SSL transport layer security. This may be enabled by setting the SSLCert and SSLAcceptServerCert to appropriate values.

Please refer to the section on adapter configuration for a description of how to configure receive locations and send ports for this adapter.

Receiver Property List

The following is the full list of the properties of the receiver adapter with short descriptions. Click on the links for further details.


ErrorThreshold	The maximum number of errors before the adapter shuts down.
GISBSiteURL	The path to the website hosting the GISB adapter.
LogDirectory	The path to a directory for logging.
MaxThreads	The maximum number of threads that the adapter may consume.
Other	Defines a set of configuration settings to be used by the adapter.
PGPParams	Sets the parameters in the OpenPGP provider.
PGPProvider	The OpenPGP provider provides an interface to the OpenPGP cryptography software.
ReceivingPartner	The identity of GISB receiving entity.
RequeueEndpoints	Whether to requeue receive endpoints if the polling interval has not been reached.
RuntimeLicense	Specifies the adapter runtime license key.
ServerId	The ID of your server.
Timeout	A timeout for the adapter.
TradingPartner	The trading partner that will be communicating with this receive location.
TransportLog	Tells the adapter where and how to report information about its operations.
URI	The Uniform Resource Identifier (URI) of the send port or receive location.

Sender Property List

The following is the full list of the properties of the sender adapter with short descriptions. Click on the links for further details.


DataFrom	The identity of the sending system.
DataTo	The identity of the receiving system.
EDIType	The type of the data to be sent.
EncryptData	Whether or not to encrypt the data.
Firewall	A set of properties related to firewall access.
GISBVersion	The version of GISB/NAESB being used.
HTTPPassword	A password if authentication is to be used.
HTTPProxy	A set of properties related to proxy access.
HTTPUser	A user name if authentication is to be used.
LocalHost	The name of the local host or user-assigned IP interface through which connections are initiated or accepted.
LogDirectory	The path to a directory for logging.
MaxThreads	The maximum number of threads that the adapter may consume.
MaxTransmissionBatchSize	The maximum number of messages that can be sent in a single batch.
Other	Defines a set of configuration settings to be used by the adapter.
PGPParams	Sets the parameters in the OpenPGP provider.
PGPProvider	The OpenPGP provider provides an interface to the OpenPGP cryptography software.
ReceiptSecurity	[1.6] Used to indicate the security options requested for the receipt.
ReceiptSigningProtocol	[1.6] Indicates the protocol used to sign the receipt.
ReceiptTo	[1.6] Used to request a receipt.
ReceiptType	[1.6] The type of receipt requested.
ReplyHeaders	The HTTP headers provided for the Response .
RequestStatus	The status of the request.
ResponseContent	The response returned from the server.
RuntimeLicense	Specifies the adapter runtime license key.
SignData	Whether or not to sign the data.
SSLAcceptServerCert	Instructs the adapter to unconditionally accept the server certificate that matches the supplied certificate.
SSLCert	The certificate to use for client authentication during the SSL handshake.
Subject	The subject of the message.
Timeout	A timeout for the adapter.
TransmitBatchMode	How the transmitter processes batches.
TransportLog	Tells the adapter where and how to report information about its operations.
URI	The Uniform Resource Identifier (URI) of the send port or receive location.
URL	The URL to post to.
UserAgent	Information about the user agent.

Configuration Settings

The following is a list of configuration settings for the adapter with short descriptions. Click on the links for further details.


AuthScheme	The authorization scheme to be used when server authorization is to be performed.
PGPProviderType	Which PGP implementation to use.
TransactionSet	The transaction-set to send in the request.
DataElementName[i]	The name of an additional data element.
DataElementValue[i]	The value of an additional data element.
SendResponseBeforeSubmit	Whether to send the response before submitting the message to BizTalk.
SSLEnabledProtocols	Used to enable/disable the supported security protocols.
AbsoluteTimeout	Determines whether timeouts are inactivity timeouts or absolute timeouts.
LocalHost	The name of the local host or user-assigned IP interface through which connections are initiated or accepted.
TcpNoDelay	Whether or not to delay when sending packets.
UseManagedSecurityAPI	Tells the adapter whether or not to use the system security libraries or a managed implementation.