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.
Creating projects
The ounceCreateProject task generates AppScan® Source projects.

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.
  - Creating projects
    The ounceCreateProject task generates AppScan® Source projects.
    - ounceCreateProject
    - ounceSourceRoot
    - ounceWeb
    - ounceExclude
    - Naming projects
      You can name a project using the default naming convention or by creating a project name manually.
  - 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.

Creating projects

The ounceCreateProject task generates AppScan® Source projects.

Use ounceCreateProject explicitly or implicitly:

Explicitly call ounceCreateProject in an Ant build file.
Implicitly call ounceCreateProject every time the javac task is called by overriding the build.compiler property.

Projects can be grouped into applications. You can use the optional application attribute or the appropriate Ounce/Ant properties to place the created project into an application.

Projects can also be augmented using Ounce/Ant. Project attributes from multiple projects can be merged into one AppScan® Source project. If more than one javac or ounceCreateProject is to augment the same project, retain the same name and directory.

Note: If you override build.compiler to create projects, run ant clean first.

Refer to ounceCreateProject task example for usage of properties and their nested attributes.