Configuring irAdapter in BizTalk
irAdapter for BizTalk Server must first be added to the Adapters list in the BizTalk Server Administration tool.
- Launch BizTalk Server Administrator and navigate to the following node:
* BizTalk Server Administration
* BizTalk Group
* Platform Settings
- Right-click Adapters and select New > Adapter, then name it InRule and choose InRule from the dropdown list as shown here.
Using irAdapter - Creating and configuring a send port
- Launch the BizTalk Server Administrative Console.
- Right-click on the BizTalk application’s Send Ports node and select New, then “Static One-way Send Port” or “Static Solicit-Response Send Port”. The latter is required if a response is desired from the rule engine; however, scenarios do exist where a response is not required. Select Solicit-Response if you don’t know which to choose.
- Name the adapter and select InRule as the transport type:
- Next, click Configure:
- Specify the Root Entity Name. This is the entity that will be populated with the XML message sent to the adapter. For example, if a rule application contained the entities Invoice, LineItem and Customer, and Invoice was the “top level” entity, “Invoice” would be the correct value. (The Root Entity Name is typically the same as the root element name in the XML sent to the adapter.)
- Set Rule Source to CatalogServer if the rule application will be retrieved from a catalog server, or File if the rule application will be loaded from disk.
- If CatalogServer is selected:
- Set irCatalog Integrated Security to True if the identity of the process hosting the BizTalk instance should be used to authenticate against the catalog. Otherwise, set it to False and provide values for irCatalog User Name and irCatalog Password.
- Set Rule Application Name to the name of the rule application that will be retrieved.
- Optionally set Rule Application Label to the label of the rule application specified in Rule Application Name.
- Set irCatalog URI to the URI of the catalog server. (The URI can be found by running the Configuration Utility in the InRule start menu group.)
- Change the values of the irCatalog timeout and/or Cache Timeout. The former is the connection to the server and the latter specifies the interval at which the adapter will check for new versions of the rule application on the catalog server. Both of these numbers should be defined and set to values larger than zero.
- If File is selected, set Rule Application File Name.
- If the Rule Application End Points need to be overridden in the given environment, then an XML string can be provided to define the overrides. In the the case of Database Connections and Mail Servers, and single Value should be defined for the OverrideEntry. For Web Service End Points, at least two Values are required -- one for the service URI and one for the service WSDL. Web Service End Points also support an optional third Value for the location of the X509 certificate.
A sample Override Entry String XML that overrides a database and a web service end point:
<Value>My Connection String</Value>