Calling an XML Web Service from an AIC

This section describes the steps required for an AIC to call an XML Web service.

Update the resource file

Create a C# class project in Microsoft Visual Studio .NET for the AIC that calls the XML Web service. View the Reference.cs file to ensure that the XMLRoot information contained in this class is correct, and that the structure matches the class in the original .cs file created for the XML Web service.

To view and update the Reference.cs file

In the Solution Explorer, click Show All Files.
Expand Web References, expand the name of the XML Web service host, expand Reference.map, and then double-click Reference.cs.
Every element in the XML file has been converted to a public class. Search for the root element in the XML file.
The root element appears as:
```
[System.Xml.Serialization.XmlAttribute( Namespace=http://tempuri.org )] public class RootElementName { 
```
Change this to the following:
```
[System.Xml.Serialization.XmlRoot( RootElementName )] public class RootElementName { 
```
Where RootElementName is the name of the document s root element.
Repeat steps 3 and 4 for every element in the document.

Add a reference to the XML Web service

The AIC project must contain a reference to access the XML Web service remotely. After this reference is made, the project acts as a client to that XML Web service. For example:

// Reference to the hub XML Web service using Supp_send_invoice.localhost;

Implement the IBTSAppIntegration.ProcessMessage method

To indicate that the project is an AIC, the code must implement the ProcessMessage method on the IBTSAppIntegration interface.

The following example is from the supplier's client code that sends an invoice to the hub XML Web service:

string IBTSAppIntegration.ProcessMessage(string strDocument) { // The incoming string is CommonInvoice, convert the // xml string into an object by deserializing it     CommonInvoice invoice;     XmlSerializer serializer = new XmlSerializer(typeof(CommonInvoice));     TextReader stringstream = new StringReader(strDocument);     invoice = ((CommonInvoice)serializer.Deserialize(stringstream)); // Open up the hub XML Web service     Hub_services web_service = new Hub_services(); // Process the order     string result = web_service.Process_invoice(invoice);     web_service = null;     return result; }

Register the AIC for use with COM

When creating your AIC project in Microsoft Visual Studio .NET, you might want to use a fixed GUID value to maintain binary compatibility. Otherwise, the GUID for the component changes every time you compile the code. In that case, any references to this component would have to be rebound in your XLANG schedules.

The following procedure assigns a static GUID value to the component and registers the AIC for COM interoperability:

Add the following reference to your project:
```
using System.Runtime.InteropServices; 
```
Just before the class declaration in your project, add the GUID declaration (shown in bold):
```
[Guid( )] public class AIC_name : IBTSAppIntegration 
```
Note The "Guid" literal string shown above is case-sensitive.
On the Tools menu, click Create GUID.
The Create GUID dialog box appears.
Select option 4, Registry Format, click Copy, and then click Exit.
Place your cursor between the quotes in the [Guid( )] declaration and paste in the GUID value.
In the Solution Explorer pane, right-click the project and then click Properties.
The project Property Pages dialog box appears.
Click the Configuration Properties folder in the left pane.
On the Configuration drop-down menu, click All Configurations.
Change the value of the Register for COM interop property to True.

Previous Next