Celigo has updated and enhanced the original Java sample applications available from NetSuite. The updated versions include the following functionality:

• Supports versions 2.5 and 2.6 of the WSDL
• Supports Java version 5.x
• Supports Axis version 1.4
• A single installation that includes all required Java libraries, including the Axis libraries and the patched Axis jar file from NetSuite
• Additional functionality that demonstrates some of the new Web services functionality

Downloads

• CRM Sample Application (Version 2.6) for Java with Celigo Service Manager : Supports NetSuite WSDL 2.6 and Axis 1.4
  
  


• CRM Sample Application (Version 2.6) for Java: Supports NetSuite WSDL 2.6 and Axis 1.4
  
  


• CRM Sample Application (Version 2.5) for Java: Supports NetSuite WSDL 2.5 and Axis 1.4
  
  

Documentation

This archive contains the files necessary to install and run the Apache Axis based Java sample application. It assumes that the application will be run on a Windows platform that has an available Java Runtime environment.

Please visit the NetSuite Web Services portal to learn more about the NetSuite Web Services platform including detailed documentation, FAQs, and latest updates.

Prerequisites

In order to compile and run this sample application, you will need to install and configure the following software:

• Java 2 Platform : Standard Edition, version 1.5: Available at http://java.sun.com/j2se/ .
• Apache Ant: version 1.5 or higher: Available at http://ant.apache.org/ .

Setup Environment

Setup the following environment variables. In Windows XP, you can do this in Control Panel > System > Advanced > Environment Variables.

• Update your system path variable with the following:
  • Add the complete path to the bin directory of your Java SDK installation
  • Add the complete path to the bin directory of your Ant installation


• Set the JAVA_HOME environment variable to your Java SDK installation root directory.
  • Example: set JAVA_HOME= C:\Program Files\Java\jdk1.5.0_07

Build the Application

The sample application comes with an Apache Ant build script named build.xml located in the bin directory. NetSuite strongly recommends that you use this script for compiling this application. Note that this script will automatically create any required directories.

The sample application can be built as follows:

1. Open a command prompt
2. Change the directory to the bin directory of the sample application
3. Type the following at the prompt:
   • ant deploy

Following is a listing of all available targets within the Ant script:

• deploy : Performs a new build from scratch including regenerating the source for the proxy classes from the WSDL
• compile : Compiles all java classes, including the generated proxy classes. This target should be used to compile any changes made to the sample application, but not have to generate the source for the proxy classes from the WSDL every time.
• generate.proxy : Generates the source for the client proxy classes from the WSDL using Axis WSDL2Java. Please note that this source has already been generated in this project, so there is no need to do it again.
• clean : Cleans the current build

Any of the above targets can be run by entering ant <target> at a command prompt from the bin directory.

Configuration

Set the applicable configuration parameters in the nsclient.properties file in the root directory of the sample application installation. At a minimum, you must provide your NetSuite login information.

Run the Application

After the application has been compiled successfully, use the nsclient.bat file located in the bin directory to run the application as follows:

1. Open a command prompt
2. Change the directory to the bin directory of the sample application
3. Type the following at the prompt:
   • nsclient

This batch file will automatically set the class path to locate the appropriate libraries required to run this application.