CAST AIP Technologies
Page tree

Versions Compared

Old Version 10

changes.mady.by.user James Hurrell

Saved on

compared with

New Version Current

changes.mady.by.user James Hurrell

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Info
Summary: this pages describes all analysis configuration options that are available for the ASP technology.

Using AIP Console

AIP Console exposes the Technology configuration options once a version has been accepted/imported, or an analysis has been run. Click ASP Technology to display the available options:

...

  • Settings specific to the technology for the entire Application
  • List of Analysis Units (a set of source code files to analyze) created for the Application
    • Settings specific to each Analysis Unit (typically the settings are the same as at Application level) that allow you to make fine-grained configuration changes.

Settings are initially set according the information discovered during the source code discovery process when creating a version. You should check that these auto-determined settings are as required and that at least one Analysis Unit exists for the specific technology.

...

Files to AnalyzeThis section displays a list of the file extensions for both web server and client, that are included in the current file filter for your source code analysis. Only files that match these file extensions will be included in the analysis.
Default ScriptingThese options enable you to select the Default Scripting Language for your client-side and server-side files. Use the drop down list box to choose between:
  • VBScript
  • JavaScript

It is possible to identify the default client scripting language by finding a ASP or HTML file with a SCRIPT tag that does not have a language definition (do a search for "<SCRIPT>") and examine the language to determine if it is JavaScript or VBScript.

For an application that mixes both languages, you will need to find a file with <SCRIPT> tags that DO NOT have a language specified and <SCRIPT> tags that DO have a language specified. You then need to select the language NOT specified in the <SCRIPT> tag as the default language.

DependenciesDependencies are configured at Application level for each technology and are configured between individual Analysis Units/groups of Analysis Units (dependencies between technologies are not available as is the case in the CAST Management Studio). You can find out more detailed information about how to ensure dependencies are set up correctly, in Advanced onboarding - review analysis configuration and execution for AIP ConsoleValidate dependency configuration.
Analysis Units

Lists all Analysis Units created. You can configure the same technology settings at Analysis Unit level if required - click the Analysis Unit to view it's its technology settings (by default they match the default settings application wide technology settings):

Analyze a specific Analysis Unit (and all Analysis Unit on its ownUnits within the Execution Unit), specifically for testing purposes.

Disable or enable the analysis of a specific Analysis Unit, when the next Application level analysis/snapshot is run. By default all Analysis Units are always set to enable. When an Analysis Unit is set to disable, this is usually a temporary action to prevent an Analysis Unit from being analyzed.


Using CAST Management Studio

Expand

Introduction to analysis configuration options

Include Page
Introduction to analysis configuration options
Introduction to analysis configuration options

Auto-configuration validation

Technology / Application level

Using the Technology level or Application level options, validate the settings for ASP packages. Make any update as required. These settings apply to the Technology or Application as a whole (i.e. all Analysis Units):

Image Modified

Image Modified

Analysis Unit level

To inspect the auto-generated analysis configuration, you should review the settings in each Analysis Unit - they can be accessed through the Application editor:

Image Modified

Technology options

The available options for configuring an analysis are described below. Note that some options are not available at specific levels (Technology/Application/Analysis Unit):

Source Settings

This tab shows the location of each type of source code in the ASP Analysis Unit - this is determined automatically by the CAST Delivery Manager Tool. You should, however, review the configuration and make any changes you need:

Image Modified

Project pathThe file based location of the corresponding project. This field is read-only. When the field contains User defined, this indicates that the Analysis Unit has been defined manually instead of automatically following the use of the CAST Delivery Manager Tool.
Application Root Path

Indicates the folder that is defined as the root folder for the Analysis Unit for analysis purposes. The Application Root Path is the path to the folder that contains WEB-INF directory. If this Analysis Unit is automatically defined, then this field will already be populated. You can choose a different source code location (use Browse) - or use the Reset button to re-populate the field with the information from the parent Application.

Web Server

Web Server File ExtensionsThis section displays a list of the file extensions that are included in the current file filter for your source code analysis. Only files that match these file extensions will be included in the analysis.
Also use Application Root Path for Web Server FilesIf you select this option, the Application Root Path defined in the General tab will be used as a source for the web server files. If you wish to add additional source files use the option described below.
Files

Use this section to include or exclude specific source files for the Analysis Unit for analysis purposes - these are mainly to be used when you are manually creating your Analysis Unit but can also be used if you are modifying an automatically created Analysis Unit.

  • Use the Image Modified Image Modified Image Modified Image Modified buttons to include or exclude specific Source Files (in the case of files, only files matching the choices made in Web Server File Extensions above will be considered) or Source Folders (folders are searched recursively). By default CAST will automatically suggest the Deployment Folder set in the Current Version tab (Application editor) for your Package when adding new source code folders or files.
  • Use the Image Modified button to remove an existing entry
  • Use the Image Modified button to edit an existing entry
  • If this Analysis Unit is automatically defined use the Image Modifiedbutton to reset the list to the entries defined by the CAST Delivery Manager Tool

If this Analysis Unit is automatically defined, then any auto defined entries will be read only.

Web Client

Web Client File ExtensionsThis section displays a list of the file extensions that are included in the current file filter for your source code analysis. Only files that match these file extensions will be included in the analysis.
Also use Application Root Path for Web Client FilesIf you select this option, the Application Root Path defined in the General tab will be used as a source for the web client files. If you wish to add additional source files use the option described below.
Files

Use this section to include or exclude specific source files for the Analysis Unit for analysis purposes.

  • Use the Image Modified Image Modified Image Modified Image Modified buttons to include or exclude specific Source Files (in the case of files, only files matching the choices made in Web Server File Extensions above will be considered) or Source Folders (folders are searched recursively). By default CAST will automatically suggest the Deployment Folder set in the Current Version tab (Application editor) for your Package when adding new source code folders or files.
  • Use the Image Modified button to remove an existing entry
  • Use the Image Modified button to edit an existing entry
  • If this Analysis Unit is automatically defined use the Image Modified button to reset the list to the entries defined by the CAST Delivery Manager Tool

If this Analysis Unit is automatically defined, then any auto defined entries will be read only.

Analysis

The settings in this tab govern how the source code is handled by the analyzer:

Click to enlarge

Image Modified

Default Source Options/File Extensions - only visible at Technology and Application level.

Web Server File ExtensionsUse this option to specify the file extensions that will be considered as Web Server files for analysis purposes (typically .ASP files)
Web Server File ExtensionsUse this option to specify the file extensions that will be considered as Web Client files for analysis purposes (typically .html files)

Default Scripting

Default Scripting Language for the client side / Default Scripting Language for the server sideThese option enables you to select the Default Scripting Language for your client-side and server-side files. Use the drop down list box to choose between:
  • JavaScript
  • VBScript

It is possible to identify the default client scripting language by finding a ASP or HTML file with a SCRIPT tag that does not have a language definition (do a search for "<SCRIPT>") and examine the language to determine if it is JavaScript or VBScript.

For an application that mixes both languages, you will need to find a file with <SCRIPT> tags that DO NOT have a language specified and <SCRIPT> tags that DO have a language specified. You then need to select the language NOT specified in the <SCRIPT> tag as the default language.

Include Page
Text replacement
Text replacement

Production

Click to enlarge

Image Modified

The Production tab is only visible at Technology and Application level.

Data to generate - Parsing options

Add called files to selected files listSelecting this option will automatically add any files to the list of files selected for analysis that are called by files that you have already selected.
Add included files to selected files listSelecting this option will add any files to the analysis list that are included in files that you have already selected.
Maximal Complexity
This option enables you to manually enter a percentage which will refer to the m complexity of the analysis process.
  • A complexity percentage of 100 (default) corresponds to a maximum of 10,000 function analyses (function * context) for a given file.
  • A complexity percentage of 70 corresponds to a maximum of 7,000 function analyses (function * context) for a given file.
  • A complexity percentage of 0 corresponds to an unlimited analysis of all the called functions.

If the maximum number of function analyses is reached, this will be logged.

No Format
File analysis too complex. Next function calls will not be followed by a function analysis if the function has already been analyzed

When the limit is reached, links to the function will be created correctly, but links from the function will not be created.

You should alter the complexity percentage if your analyses are taking a long time to complete with the default setting of 100%. Changing the percentage to a lower figure will reduce the number of function analyses for a given file, thus improving performance. Remember though that doing will cause some links not to be created.