This documentation is not maintained. Please refer to doc.castsoftware.com/technologies to find the latest updates.

On this page:

Target audience:

Users of the HTML5 and JavaScript extension, or any extension that reuses it (AngularJS, Node.js, jQuery etc.).

Summary: Information and Release Notes about the Web Files Discoverer for the CAST Delivery Manager Tool. This extension is a file system discoverer.

Description

This discoverer detects projects based on the presence of web technology files (for example .HTML, .JS etc.).

In what situation should you install this extension?

The HTML5 and JavaScript extension, or any extension that reuses it (AngularJS, Node.js, jQuery etc.) does not contain a file "discoverer". This means that when configuring the analysis in the CAST Management Studio after having delivered the source code, an Analysis Unit must be  created manually before the code can be analyzed. The Web Files Discoverer removes the need for this additional manual task.

Technically, how does the extension work?

The Web Files Discoverer will detect a project when any of the following files are detected in any of the scanned folders:

  • *.asp
  • *.aspx
  • *.cshtml
  • *.htc
  • *.html
  • *.js
  • *.jsp
  • *.xhtml

When a file with one of these extensions is discovered, then a project will be created by the CAST Delivery Manager Tool with a path pointing to the root folder declared in the package:

Root folder selection

Project discovered

Note that depending on the type of application you are packaging, a dot may also be used in the Path field:

CAST AIP compatibility

This extension is compatible with:

CAST AIP release
Supported
8.3.x(tick)
8.2.x(error)
8.1.x(error)
8.0.x(error)
7.3.x(error)

Supported DBMS servers

This extension is compatible with the following DBMS servers:

CAST AIP releaseCSS2OracleMicrosoft
All supported releases(tick)(tick)(error)

Prerequisites

(tick)An installation of any compatible release of CAST AIP (see table above)

Download and installation instructions

Please see:

  • This extension contains a File discoverer and you should take note of the specific instructions in the installation guide that explains how to package your source code with the CAST Delivery Manager Tool when you have an existing Version.
  • The latest release status of this extension can be seen when downloading it from the CAST Extend server.

Extension interface

The following screen shots show the differences in the product when the extension is installed:

  • In the CAST Delivery Manager Tool, a new tick box is added in the Package Configuration tab (click to enlarge):

  • In the CAST Delivery Manager Tool, in the Package content tab, when specific files (see Technically, how does the extension work?) are detected during packaging, the interface will display a new item in the list of Project types discovered (HTML5 project):

  • In the CAST Management Studio, when the delivery is accepted and set as current version, the package will contain "HTML5" Analysis Units corresponding to the projects discovered in the CAST Delivery Manager Tool:

Packaging, delivering and analyzing your source code

When you use the CAST Delivery Manager Tool to package the source code, please ensure that you tick the HTML5 project option in the CAST Delivery Manager Tool to activate the extension:

  • this option will be disabled (unticked) in all pre-existing packages - you need to check it before starting the packaging process otherwise it will be ignored.
  • for new packages created after the extension's installation, the option will be enabled by default

ASP classic
Note that when onboarding a new ASP classic application with the Web Files Discoverer installed, the CAST Delivery Manager Tool will detect two projects for the ASP source code:
  • One detected by the ASP discoverer embedded in the CAST Delivery Manager Tool
  • One detected by the Web Files Discoverer extension

When delivered, both projects will be transformed into Analysis Units, therefore when an analysis is run, you will receive two sets of results for the same source code. To mitigate this, you can either disable the ASP discovered embedded in the CAST Delivery Manager Tool, or the Web Files Discoverer, according to your requirements. Untick the discoverer you do not want to use: