Page tree
Skip to end of metadata
Go to start of metadata

Packaging and delivery

Note that the HTML5/JavaScript extension does not contain any discoverers or extractors, however, the Web Files Discoverer extension will be automatically installed (it is a "shipped" extension which means it is delivered with AIP Core) and will automatically detect projects as HTML5 if specific files are delivered, therefore ensuring that Analysis Units are created for your source code.

Using CAST Console

Using CAST Management Studio

 Click here to expand...
  • create a new Version
  • create a new Package for your HTML5/JavaScript source code using the Files on your file system option:

  • Define the root folder of your Application source code:

  • Run the Package action
  • Before delivering the source code, check the packaging results:
Without the Web Files Discover

If you are not using the Web Files Discoverer, the following will occur:

  • the CAST Delivery Manager Tool will not find any "projects" related to the HTML5/JavaScript application source code - this is the expected behaviour. However, if your HTML5/JavaScript related source code is part of a larger application (for example a JEE application), then other projects may be found during the package action (click to enlarge):

With the Web Files Discoverer

If you are using the Web Files Discoverer, the following will occur:

  • the CAST Delivery Manager Tool will automatically detect "HTML5 file projects" (see Web Files Discoverer for more technical information about how the discoverer works) related to the HTML5/JavaScript application source code. In addition, if your HTML5/JavaScript related source code is part of a larger application (for example a JEE application), then other projects may also be found during the package action (click to enlarge):

  • Deliver the Version

Analyzing

Using CAST Console

AIP Console exposes the technology configuration options once a version has been accepted/imported, or an analysis has been run. Click Universal Technology (3) in the Config (1) > Analysis (2) tab to display the available options for your HTML5 source code:

Then choose the relevant Analysis Unit (1) to view the configuration:

Using the CAST Management Studio

 Click here to expand...


  • Accept and deploy the Version in the CAST Management Studio.
Without the Web Files Discover

If you are not using the Web Files Discoverer, the following will occur:

  • No Analysis Units will be created automatically relating to the HTML5/JavaScript source code - this is the expected behaviour. However, if your HTML5/JavaScript related source code is part of a larger application (for example a JEE application), then other Analysis Units may be created automatically:

  • In the Current Version tab, add a new Analysis Unit specifically for your HTML5/JavaScript source code, selecting the Add new Universal Analysis Unit option:

  • Edit the new Analysis Unit and configure in the Source Settings tab:
    • a name for the Analysis Unit
    • ensure you tick the HTML5/JavaScript option
    • define the location of the deployed HTML5/JavaScript source code (the CAST Management Studio will locate this automatically in the Deployment folder):

Do not add a dependency from this Analysis Unit to another client Analysis Unit.

  • Run a test analysis on the Analysis Unit before you generate a new snapshot.
With the Web Files Discoverer

If you are using the Web Files Discoverer, the following will occur:

  • "HTML5" Analysis Units will be created automatically (see Web Files Discoverer for more technical information about how the discoverer works) related to the HTML5/JavaScript application source code. In addition, if your HTML5/JavaScript related source code is part of a larger application (for example a JEE application), then other Analysis Units may also be created:

Do not add a dependency from this Analysis Unit to another client Analysis Unit.

  • There is nothing further to do, you can now run a test analysis on the Analysis Unit before you generate a new snapshot.

Using the filters.json file

The HTML5 and JavaScript extension is provided with a file called filters.json at the root of the extension folder. This file lists all items that will be ignored during an analysis. The file is pre-populated with items, but it is also possible to modify the file manually and add your own custom filters. See HTML5 and JavaScript - using the filters.json file.

Analysis warning and error messages

The following warnings and error messages may be displayed in the analysis log:

 Click here to expand...

Message IDMessage Type

Logged during

ImpactRemediationAction
HTML5-001WarningAnalysisA jsp file has not been entirely analyzed because an internal issue.

 

if the jsp file is important for you, contact CAST Technical Support
HTML5-002WarningAnalysisAn asp/aspx/htc/cshtml file has not been entirely analyzed because an internal issue.

 

if the file is important for you, contact CAST Technical Support
HTML5-003WarningAnalysisA file has not been opened/analyzed.See if you have access rights to this file. 
HTML5-004WarningAnalysisAn HTTP request has not been created, a transaction link could be missing between a client and a server. if the file is important for you, contact CAST Technical Support
HTML5-005WarningAnalysisOne statement of a file has not been correctly parsed. if the file is important for you and/or many objects/links have not been created about this file, contact CAST Technical Support
HTML5-006WarningPost analysesAn important sql query has failed when removing files skipped by analysis. Impact is that lines of code (LOC) will be higher than expected. contact CAST Technical Support
HTML5-007WarningPost analysesAn important sql query has failed when removing bad links created by UA through grep (internal). Impact is that transactions will be badly altered by these bad links. contact CAST Technical Support
HTML5-008WarningPost analysesMetrics of a file have not been reported (code lines, comment lines). LOC could be wrong for this file. contact CAST Technical Support
HTML5-009WarningPost analysesA link useful for transactions has not been created between a file created by JEE analyzer and an object representing the same file created by HTML5/Javascript analyzer. contact CAST Technical Support
HTML5-010WarningPost analysesObjects corresponding to jsp files could be counted twice because they were not set external in JEE project. contact CAST Technical Support
HTML5-011WarningPost analysesObjects corresponding to asp files could be counted twice because they were not set external in DOTNET project. contact CAST Technical Support
HTML5-012WarningPost analysesObjects corresponding to aspx files could be counted twice because they were not set external in DOTNET project. contact CAST Technical Support
HTML-013WarningPost analysesObjects corresponding to htc files could be counted twice because they were not set external in DOTNET project. contact CAST Technical Support

 

 

Message IDMessage Type

Logged during

ImpactRemediationAction
EXTDOTNET-001WarningAnalysisAn ASP DOTNET operation has not been created correctly.

 

Contact CAST Technical Support
EXTDOTNET-002WarningAnalysisA file has not been opened/analyzed.See if you have access rights to this file. 

End of comment and File skipped messages for .js files

You may find that the analysis log contains the following messages for .js files:

Warning MODULMSG ; Job execution end of comment '\*\/' not found 0 ; 0 0 0 [Module name] 0 0 
Warning MODULMSG ; Job execution File skipped : K:\CAST\Ref\auto-refi2-staticresources\testing\inflow.js

These messages occur when the underlying Universal Analyzer raises a warning whenever it encounters what it considers a syntax error. The "End of comment" message is logged and then a following message is logged stating that the file has been "skipped". These warnings should be ignored as they have no impact: the HTML5/JavaScript extension will analyze the file and raise the following message in the analysis log:

Information MODULMSG ; Job execution [com.castsoftware.html5] Light parsing of file K:\CAST\CASTMS\Deploy\Test_source\Ref\auto-refi2-staticresources\testing\inflow.js
  • No labels