How to Add a Web Reference to a CTAPI Web Service in Visual Studio

How to Add a Web Reference to a CTAPI Web Service in Visual Studio

Often, I get questions on how to start with the Catalina API for Dynamics SL.  We are going to be doing a series of posts that walk through how to use our API for Dynamics SL.

This post is focused on how to create a web reference in Visual Studio to consume our SOAP based web services.  This is pretty simple and we will build on it in posts to come.

Under Solution Explorer

  1. Right Click on “References”
  2. Select “Service References”

addawebreference1

On the “Add Service Reference” screen

  1. Click the “Advanced” button in the bottom left corner.

addawebreference2

On the “Service Reference Settings” screen

  1. Click the “Add Web Reference” button in the bottom left corner.

addawebreference3

On the “Add Web Reference” screen

  1. Enter the URL to the catalina SOAP service you want to call.
    eg: http://localhost/ctDynamicsSL/vendorMaintenance.asmx

    addawebreference4
  2. You can get a list of all service available on the index page via a web browser.

eg: http://localhost/ctDynamicsSL/

  1. Click the arrow button to the left of the URL to get the web service listing.
  2. After discovery, enter a name to refer to this web reference in your client in the “Web Reference name” textbox. In our example we will use directory.filename.

eg: ctDynamicsSL.vendorMaintenance

  1. Click the “Add Reference” button.
  2. The new reference will now show up under Web References listing in solution explorer.

addawebreference5

In your project code file, add the code to instantiate the service object

  1. Private variable to store our object reference:
private ctDynamicsSL.vendorMaintenance.vendorMaintenance myVendorsServiceValue = null;
  1. Add a property that will dynamically create the web service object with all required SOAP Header values:
    1. The SOAP Header (ctDynamicsSLHeader) is required for all CTAPI web services.
    2. In our example, we set the values from the app.config file using ConfigurationManager, but that is easily customizable.
        public ctDynamicsSL.vendorMaintenance.vendorMaintenance myVendorsService
        {
            get
            {
                if (myVendorsServiceValue == null)
                {
                    ctDynamicsSL.vendorMaintenance.ctDynamicsSLHeader Header = new ctDynamicsSL.vendorMaintenance.ctDynamicsSLHeader();
                    Header.siteID = System.Configuration.ConfigurationManager.AppSettings["SITEID"];
                    Header.cpnyID = System.Configuration.ConfigurationManager.AppSettings["CPNYID"];
                    Header.licenseKey = System.Configuration.ConfigurationManager.AppSettings["LICENSEKEY"];
                    Header.licenseName = System.Configuration.ConfigurationManager.AppSettings["LICENSENAME"];
                    Header.licenseExpiration = System.Configuration.ConfigurationManager.AppSettings["LICENSEEXPIRATION"];
                    Header.siteKey = System.Configuration.ConfigurationManager.AppSettings["SITEKEY"];
                    Header.softwareName = "CTAPI";
                    myVendorsServiceValue = new ctDynamicsSL.vendorMaintenance.vendorMaintenance();
                    myVendorsServiceValue.ctDynamicsSLHeaderValue = Header;
                    myVendorsServiceValue.Timeout = System.Threading.Timeout.Infinite;
                }
                return myVendorsServiceValue;
            }
            set
            {
                myVendorsServiceValue = value;
            }
        }

 

Screenshot of the Visual Studio IDE

addawebreference6
Example of how the code looks in the Visual Studio IDE

 

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s