Home
Reference
Review reference information for HCL® AppScan® Source, including using utilities, plug-ins, and APIs.
The Ounce/Ant build tool
This section describes how to use Ounce/Ant, an AppScan® Source build utility that integrates AppScan Source and Apache Ant. Integrating Ounce/Ant with your Ant environment helps you automate builds and code assessments.
Ounce/Ant and Apache/Ant integration
The steps outlined in this task topic are necessary to integrate Ounce/Ant into the Apache/Ant build environment.

Welcome
Welcome to the documentation for HCL® AppScan® Source.
What's New
Explore these new features that have been added to AppScan® Source - and note any features and capabilities that have been deprecated in this release.
Installing
Learn how to install, upgrade, and activate HCL® AppScan® Source.
Configuring
Learn how to configure applications, folders, and projects, and set attributes and properties in HCL® AppScan® Source.
Administering
Learn how to administer user accounts and permissions, audit user activity, and manage integrations in HCL® AppScan® Source.
Scanning
This section explains how to scan your source code and manage assessments in HCL® AppScan® Source.
Triage and analysis
Grouping similar findings allows security analysts or IT auditors to segment and triage source code problems. This section explains how to triage AppScan® Source assessments and analyze results.
Reporting
Security analysts and risk managers can access reports of select findings or a series of audit reports that measure compliance with software security best practices and regulatory requirements. This section explains how to create reports of aggregate finding data.
Extending product function
Learn how to extend the product to meet specific development requirements.
Reference
Review reference information for HCL® AppScan® Source, including using utilities, plug-ins, and APIs.
- The Ounce/Make build utility
  Ounce/Make is a tool that automates the importing of configuration information into AppScan® Source from build environments that use makefile. Ounce/Make eliminates the need to import configuration information from makefiles manually; this the recommended method of configuring these projects.
- AppScan® Source command line interface (CLI)
  The CLI is an interface to core AppScan® Source functionality.
- The Ounce/Ant build tool
  This section describes how to use Ounce/Ant, an AppScan® Source build utility that integrates AppScan Source and Apache Ant. Integrating Ounce/Ant with your Ant environment helps you automate builds and code assessments.
  - Ounce/Ant and Apache/Ant integration
    The steps outlined in this task topic are necessary to integrate Ounce/Ant into the Apache/Ant build environment.
    - Ounce/Ant properties
      The table in this topic describes the optional Ounce/Ant properties.
    - Setting properties
      You can use the var task to set properties any number of times. When invoked, either explicitly or implicitly, ounceCreateProject uses the current property values. You can set properties by one of the methods outlined in this task topic.
  - Creating projects
    The ounceCreateProject task generates AppScan® Source projects.
  - Creating and naming applications
    Ounce/Ant can create AppScan® Source applications during operation and group the created AppScan Source projects into the applications.
  - Build integration
    The ounceCli task allows access to the AppScan® Source command line interface (CLI) to scan during a build. The ounceCli task can invoke cli from Ant.
- AppScan® Source Data Access API
  The Data Access API provides access to AppScan® Source-generated assessment results, including findings and finding details. It also provides access to assessment metrics such as analysis date and time, lines of code, V-density, and number of findings.
- Glossary
  Learn common product terminology.
Troubleshooting and support
Self-help information, resources, and tools to help you troubleshoot issues while using HCL® AppScan® Source.

Ounce/Ant and Apache/Ant integration

The steps outlined in this task topic are necessary to integrate Ounce/Ant into the Apache/Ant build environment.

Procedure

Copy the ounceant.jar file and, optionally, ant-contrib-1.0b3.jar to the ant lib directory.
If Ant plug-in version is 1.8.1 or newer, copy xml-api.jar and xercesImpl.jar as well.
The AppScan® Source installation places ounceant.jar and ant-contrib-1.0b3.jar, xml-api.jar, and xercesImpl.jar in <install_dir>\lib (where <install_dir> is the location of your AppScan® Source installation).
Optional: Override the build.compiler property.
See Creating projects for more information about overriding build.compiler.)
Override this property using one of the following methods:
- Use a property tag in the build.xml file.
```
<property name="build.compiler"
value="com.ouncelabs.ounceant.OunceCompilerAdapter"/>
```
- Specify the value for build.compiler on the command line when invoking Ant using the -D option.
```
ant -Dbuild.compiler=
com.ouncelabs.ounceant.OunceCompilerAdapter
```
- Include the value for build.compiler in a text file and instruct Ant to load the properties in that file using the properties option as described in the Ant documentation.
Create taskdefs.
To use Ounce/Ant tasks, you must reference ounceant.jar in a taskdef task. For example,
```
<taskdef resource="com/ouncelabs/ounceant/task/ounce.xml"
classpath="ounceant.jar"/>
```
To use the var task, ant-contrib-1.0b3.jar must reference the taskdef task as follows:
```
<taskdef resource="net/sf/antcontrib/antlib.xml"/>
```