Before You Begin Using a .NET Client

Before you can access a Web Service, you need to make sure the Oracle ATG Web Commerce platform is ready for your call and .NET is configured:

  1. Confirm that the application that includes the Web Service is deployed on your application server and is running. For more information, see Deploying Web Services.

  2. Install Internet Information Service (IIS) and then Active Server Page.Net (ASP.NET) and VisualStudio.NET (VS.NET).

  3. Install ATGWS.dll so you can access the stub and API classes it contains.

Installing ATGWS.dll

ATGWS.dll is a library that includes a stub class for each Oracle ATG Web Commerce Web Service. It also provides the Atg.DotNet.WebService API used for serializing and deserializing RepositoryItems. All users who want to access Oracle ATG Web Commerce Web Services from a .NET client should install ATGWS.dll. You need two versions of ATGWS.dll on your system. One version lives in you Global Assembly Cache (GAC) so ASP.NET is able to access it when compiling the Web Service call. Another version should exist in a location that VS.NET recognizes.

The instructions provided here direct you to use GACutil, a utility provided by .NET, although you can use any utility that can install ATGWS.dll to the Assembly folder in your windows directory. While the library does not need to live on the same machine as .NET, .NET needs to be able to access it.

To install ATGWS.dll:

  1. Copy <ATG10dir>/DAS/os_specific_files/i486-unknown-
    win32/ATGWS.dll     to your Windows\Assembly folder.

  2. Open a command prompt and enter the following command:

    <DotNetdir>:\ gacutil/i <ATG10dir>/DAS/os_specific_files/i486-unknown-
    win32/ATGWS.dll

    In this example, <DotNetdir> represents the parent directory, such as c:\DotNet that holds your .NET software.

Keep in mind that each time you install a new version of ATGWS.dll, it coexists with older versions. The latest version of ATGWS.dll will instruct the .NET client to use it. There’s no need to uninstall ATGWS.dll when you want to install a new version. Remember when you do install new versions, you need to update references in VS.NET to the old version of ATGWS.dll. If you’d like to remove all versions of ATGWS.dll, use this command in a command prompt:

<DotNetdir> gacutil/u <ATG10dir>/DAS/os_specific_files/i486-unknown-
win32/ATGWS

Copyright © 1997, 2013 Oracle and/or its affiliates. All rights reserved. Legal Notices