To complete this walkthrough, you will need:

• Microsoft Dynamics NAV 2009 with a developer license.

• Microsoft Dynamics NAV Business Web Services service running. For information on Windows services, see How to: Configure Windows Services.

• Visual Studio 2005, Visual Studio 2008, Visual C# 2008 Express Edition, or any version of Visual Studio that supports adding Web references. You can also use service references instead of Web references or the Web service proxy generating tools (svcutil.exe or wsdl.exe) that are supplied in the Microsoft .NET Framework SDK.

1. Open the Classic client.

2. On the Tools menu, click Object Designer.

3. In Object Designer, click Codeunit, and then click New.

4. On the View menu, click C/AL Globals.

5. In the C/AL Globals window, click the Functions tab, and then enter Capitalize as the function name.

6. In the C/AL Globals window, click the Locals button.

7. On the Parameters tab, enter inputstring in the Name field, and then select Text in the DataType field. Set the length to 250.

8. On the Return Value tab, enter outputstring in the Name field, and then select Text in the Return Type field. Set the length to 250.

9. Close the Locals window, and then close the C/AL Globals window.

10. In the Capitalize method, insert the following line of code:

    outputstring := UPPERCASE(inputstring);

11. Save and close the C/AL Editor window.

12. When prompted, give the codeunit the name Letters and the ID 50000.

1. Open the Classic client.

2. On the Tools menu, click Object Designer.

3. Click Form, and then find the Web Services form with ID 810.

4. Click Run.

5. In the Web Services form, create a new entry.

6. In the Object Type field, select Codeunit, and then enter Letters as the service name and 50000 as the object ID.

7. Select the Published check box to publish the codeunit as a Web service.

8. Close the form.

1. Click Start on the computer, point to All Programs, point to Administrative Tools, and then click Services.

2. Right-click Microsoft Dynamics NAV Business Web Services, and then click Start on the shortcut menu.

3. Close the window.

1. Start Internet Explorer.

2. In the Address field, enter the following address where the keys are replaced with the values that are specified in the CustomSettings.config file: http://<Server>:<WebServicePort>/<ServerInstance>/WS/<CompanyName>/services. An example WSDL URL is:

   http://localhost:7047/DynamicsNAV/WS/CRONUS%20International%20Ltd./services

   Note
   The company name is optional and case-sensitive.

   The page should list the Web service that you just published.

3. Close the browser.

1. In Visual Studio, on the File menu, point to New, and then click Project.

2. Expand the Visual C# node, and then select Console Application. Enter the name UsingLettersService for the application.

3. In Solution Explorer, right-click the References node in the project, and then click Add Web Reference.

   Note
   If you are using Visual Studio 2008, then click Add Service Reference instead.

4. In the Add Web Reference window, type the URL that you used when checking the WSDL, such as http://localhost:7047/DynamicsNAV/WS/services, and then click Go.

   Note
   In Visual Studio 2008, click the Advanced button, click the Add Web Reference button, type the URL, and then click Go.

5. When the Letters service is displayed, click View Service, and then click Add Reference. Rename localhost to WebService.

6. On the Program.cs tab, enter the following code:

   C#

   using System;
   using System.Collections.Generic;
   using System.Text;
   
   namespace UsingLettersService
   {
       // Import newly generated Web service proxy.
       using WebService;
   
       class Program
       {
           static void Main(string[] args)
           {
               // Create a new instance of the service.
               Letters ws = new Letters();           
               
               // Use default credentials for authenticating 
               // against Microsoft Dynamics NAV.
               ws.UseDefaultCredentials = true;
               ws.Url = "http://localhost:7047/DynamicsNAV/WS/CRONUS%20International%20Ltd./Codeunit/Letters";    
   
               // Declare variables to work with.
               string inputstring, outputstring;   
               inputstring = "microsoft dynamics nav web services!";
               
               // Call the Microsoft Dynamics NAV codeunit Web service.
               outputstring = ws.Capitalize(inputstring);  
   
               // Write output to the screen.
               Console.WriteLine("Result: {0}", outputstring);  
   
               // Keep the console window open until you press ENTER.
               Console.ReadLine();     
           }
       }
   }

7. Press F5 to run the application in debug mode. You should see a console window that prints the text 'MICROSOFT DYNAMICS NAV WEB SERVICES' in uppercase letters.

8. Press Enter to exit.