Skip to content

Setup

As a first step in using the TaxControls component, we need to set up our development environment.

We’ll need the .NET component, which comes with the demo application. We’ll also need the .NET Framework SDK to be able to compile from the command line. If you prefer Mono, you can install and use that instead with ‘msc’ as the compiler command, and mono <filename> to run the compiled program.

  1. Download

    Download and install the .NET demo from here.

    This package contains the most recent .NET component, and a demo application. You’ll need Microsoft’s .NET Framework SDK in order to follow this tutorial, as we will use the command-line tools for compiling csharp code.

  2. Set Environment

    Locate the .NET Framework compiler, “csc.exe”. For this guide, we use

    ”C:\Windows\Microsoft.NET\Framework\v4.0.30319\csc.exe”,

    For brevity shown as \...\csc.exe. For convenience, we’ve included the ‘compile.bat’ batch file with the Demo, which assumes that the compiler is in the default location. If you’ve installed the SDK in a different location, you’ll need to adjust the path in the batch file.

    Open a command-line window by type ‘cmd’ in the Windows search textbox. The best match should say “Command Prompt”. Clicking on “Open” in the right panel should open a prompt window.

  3. Test

    Type the following line (replaceing ... with the full path location) to ensure that your environment is set up correctly (you should see help info for the C# compiler as output):

Terminal window
\...\csc.exe /?

For subsequent tutorial steps, you’ll need to copy the TaxControls.dll and demo.tax files into your source directory.

We’ll need the Java component, which comes with the demo application.

  1. Download

    Download and unzip the Java demo from here.

    This package contains the most recent TaxControls jar, and a demo Java application. You’ll need the Java SDK in order to follow this tutorial.

  2. Set the classpath

    To use the TaxControl component, your classpath must include both the ‘bigloo_u.zip’ and ‘TaxControls.jar’ files.

    • On Windows Set the classpath to ”.;bigloo_u.zip;TaxControls.jar”
    • On Unix/Linux/OSX Set the classpath to “.:bigloo_u .zip:TaxControls .jar”

    For example, these commands would compile and run the demo on Windows:

Terminal window
javac -classpath .;bigloo_u.zip;TaxControls.jar Demo.java
java -classpath .;bigloo_u.zip;TaxControls.jar Demo

For subsequent tutorial steps, you’ll need to copy the jar files and demo.tax into your source directory.

Note: If your IDE does not recognize bigloo_u.zip as a jar file, you can rename it to something like ‘bigloo_u.jar’ and adjust the classpath accordingly.